resolve-cloud-sdk
v0.34.3
Published
- Auth - [authAuthWhoAmI](#authauthwhoami) - [authLogin](#authlogin) - [authLogout](#authlogout) - [authRefreshToken](#authrefreshtoken) - Deployments - [bootstrapDeployment](#bootstrapdeployment) - [buildDeployment](#builddeployment) - [createDeployment]
Downloads
92
Maintainers
Readme
API
- Auth
- Deployments
- bootstrapDeployment
- buildDeployment
- createDeployment
- describeDeployment
- dropDeployment
- getDeploymentUploadSignedUrl
- listDeployments
- shutdownDeployment
- Sagas
- Logs
- Tracing
- Environment variables
- Read models
- Domains
- Event stores
- Domains
- System
- Certificates
authAuthWhoAmI
Get the current user's profile information.
Method
GET
Path
/v0/auth/whoami
Result
{
userId: string
userName: string
isAdmin: boolean
}
authLogin
Log in to reSolve Cloud.
Method
POST
Path
/v0/auth/login
Body
{
userName: string
password: string
}
Result
void
authLogout
Log out of reSolve Cloud.
Method
POST
Path
/v0/auth/logout
Result
void
authRefreshToken
Refresh your authentication token on reSolve Cloud.
Method
POST
Path
/v0/auth/refreshToken
Result
void
bootstrapDeployment
Run the specified deployment.
Method
PATCH
Path
/v0/deployments/:deploymentId/bootstrap
Params
{ deploymentId: string }
Result
void
buildDeployment
Build an uploaded application on the cloud.
Method
PATCH
Path
/v0/deployments/:deploymentId/upload
Params
{ deploymentId: string }
Body
Partial<{
npmRegistry: string
}>
Result
{
installLog: string
files: Array<string>
}
clearEventStore
Remove all events from an event store.
Method
PATCH
Path
/v0/event-stores/:eventStoreId/clear
Params
{ eventStoreId: string }
Result
void
cloneEventStore
Create a new event store based on the specified event store.
Method
PATCH
Path
/v0/event-stores/:eventStoreId/clone
Params
{ eventStoreId: string }
Result
{
eventStoreId: string
eventStoreDatabaseName: string
}
createDeployment
Create a new deployment.
Method
POST
Path
/v0/deployments
Body
{
applicationName: string
version: string
eventStoreId: string
} & Partial<{ domain: string }>
Result
{
deploymentId: string
applicationName: string
version: string
domains: Array<string>
} & Partial<{ eventStoreId: string }>
createDomain
Create a new domain with the specified certificate based on a list of aliases.
Method
POST
Path
/v0/domains
Body
{
certificateId: string
aliases: Array<string>
} & Partial<{ domainId: string }>
Result
{
domainId: string
domainType:
| "proxy"
| "static"
| "uploader"
domainName: string
resourceARN: string
aliases: Array<string>
verified: boolean
owner: string
users: "*" | Array<string>
verificationCode: string
certificateId: string
}
createEventStore
Create a new event store.
Method
POST
Path
/v0/event-stores
Body
{ version: string }
Result
{ eventStoreId: string }
deleteSagaProperty
Delete a saga property.
Method
DELETE
Path
/v0/deployments/:deploymentId/sagas/:sagaName/properties/:key
Params
{
deploymentId: string
sagaName: string
key: string
}
Result
void
describeDeployment
Obtain information about a deployment.
Method
GET
Path
/v0/deployments/:deploymentId
Params
{ deploymentId: string }
Result
{
deploymentId: string
applicationName: string
version: string
domains: Array<string>
} & Partial<{ eventStoreId: string }>
describeExecution
Get the status of a long-running operation specified by its ID.
Method
GET
Path
/v0/describe-execution/:executionId
Params
{ executionId: string }
Result
{
status:
| "RUNNING"
| "SUCCEEDED"
| "FAILED"
| "TIMED_OUT"
| "ABORTED"
output: any
}
disableLogs
Disable logs for a deployment.
Method
PATCH
Path
/v0/deployments/:deploymentId/logs/disable
Params
{ deploymentId: string }
Result
void
disableTracing
Disable performance tracing for a deployment.
Method
PATCH
Path
/v0/deployments/:deploymentId/tracing/disable
Params
{ deploymentId: string }
Result
void
dropCertificate
Remove the specified certificate.
Method
DELETE
Path
/v0/certificates/:certificateId
Params
{ certificateId: string }
Result
void
dropDeployment
Remove an existing deployment.
Method
DELETE
Path
/v0/deployments/:deploymentId
Params
{ deploymentId: string }
Body
Partial<{
withEventStore: boolean
}>
Result
void
dropDomain
Remove the specified domain.
Method
DELETE
Path
/v0/domains/:domainId
Params
{ domainId: string }
Result
void
dropEventStore
Remove an existing event store.
Method
DELETE
Path
/v0/event-stores/:eventStoreId
Params
{ eventStoreId: string }
Result
void
enableLogs
Enable logs for a deployment.
Method
PATCH
Path
/v0/deployments/:deploymentId/logs/enable
Params
{ deploymentId: string }
Body
Partial<{
logLevel:
| "log"
| "error"
| "warn"
| "debug"
| "info"
| "verbose"
scope: string
}>
Result
void
enableTracing
Enable performance tracing for a deployment.
Method
PATCH
Path
/v0/deployments/:deploymentId/tracing/enable
Params
{ deploymentId: string }
Result
void
ensureCertificate
Check an SSL certificate's validity.
Method
PUT
Path
/v0/certificates
Body
{
certificate: string
key: string
} & Partial<{
certificateId: string
chain: string
}>
Result
string
exportEventStore
Export events from the specified event store.
Method
PATCH
Path
/v0/event-stores/:eventStoreId/export
Params
{ eventStoreId: string }
Query
Partial<{
cursor: string
}>
Result
void
freezeEventStore
Disable event store updates.
Method
PATCH
Path
/v0/event-stores/:eventStoreId/freeze
Params
{ eventStoreId: string }
Result
void
getClientAppConfig
Get reSolve Cloud's app client ID and user pool ID on Amazon Cognito.
Method
GET
Path
/v0/client-app-config
Result
{
clientId: string
userPoolId: string
}
getDeploymentUploadSignedUrl
Get URLs used to upload an application's source code and static resources.
Method
GET
Path
/v0/deployments/:deploymentId/upload
Params
{ deploymentId: string }
Result
{
codeUploadUrl: string
staticUploadUrl: string
}
getEventStore
Get information about the specified event store.
Method
GET
Path
/v0/event-stores/:eventStoreId
Params
{ eventStoreId: string }
Result
{
eventStoreClusterArn: string
eventStoreSecretArn: string
eventStoreDatabaseName: string
version: string
eventStoreId: string
linkedDeployments: Array<string>
region: string
accessKeyId: string
secretAccessKey: string
sessionToken: string
}
getExportUrls
Get URLs used to download files that contain events and secrets to import as well as a file that contains information about the status of the export process.
Method
GET
Path
/v0/event-stores/:eventStoreId/export
Params
{ eventStoreId: string }
Result
{
eventsExportUrl: string
secretsExportUrl: string
statusFileUrl: string
}
getImportUrls
Get URLs used to upload files that contain events and secrets to import.
Method
GET
Path
/v0/event-stores/:eventStoreId/import
Params
{ eventStoreId: string }
Query
{
eventsPartCount: string
secretsPartCount: string
}
Result
{
eventsImportUrls: Array<string>
secretsImportUrls: Array<string>
}
getLogs
Get logs for a time interval.
Method
GET
Path
/v0/deployments/:deploymentId/logs
Params
{ deploymentId: string }
Query
Partial<{
startTime: string
endTime: string
filterPattern: string
streamLimit: string
}>
Result
string
getSagaProperty
Get a saga property's value.
Method
GET
Path
/v0/deployments/:deploymentId/sagas/:sagaName/properties/:key
Params
{
deploymentId: string
sagaName: string
key: string
}
Result
{ [K in string]: any }
getSummaries
Get the list of a deployment's performance tracing summaries for the specified time interval.
Method
GET
Path
/v0/deployments/:deploymentId/tracing/summary
Params
{ deploymentId: string }
Query
{
startTime: string
endTime: string
} & Partial<{
filterExpression: string
}>
Result
Array<
Partial<{
id: string
responseTime: number
http: Partial<{
httpURL: string
httpStatus: number
httpMethod: string
userAgent: string
clientIp: string
}>
}> & { [K in string]: any }
>
getTracingDetails
Get details on the specified performance trace.
Method
GET
Path
/v0/deployments/:deploymentId/tracing/details
Params
{ deploymentId: string }
Query
{
traceIds: Array<string>
}
Result
Array<{
[K in string]: any
}>
getTracingStatus
Check whether performance tracing is enabled for a deployment.
Method
GET
Path
/v0/deployments/:deploymentId/tracing/status
Params
{ deploymentId: string }
Result
"enabled" | "disabled"
getVerificationCode
Get a code to add to a verification record within your domain zone.
Method
GET
Path
/v0/domains/:domainId/verification-code
Params
{ domainId: string }
Result
{
verificationCode: string
}
heartbeat
Check if the service is available.
Method
HEAD
Path
/v0/
Result
void
importEventStore
Import events into the specified event store.
Method
PATCH
Path
/v0/event-stores/:eventStoreId/import
Params
{ eventStoreId: string }
Body
{ partIndex: number }
Result
void
linkDeployment
Connect an existing application deployment to the specified event store.
Method
PATCH
Path
/v0/event-stores/:eventStoreId/link
Params
{ eventStoreId: string }
Body
{ deploymentId: string }
Result
void
listCertificates
Get a list of the available SSL certificates.
Method
GET
Path
/v0/certificates
Result
Array<
{
certificateId: string
additionalNames: Array<string>
resourceARN: string
} & Partial<{
domainName: string
importedAt: string
issuer: string
notBefore: string
notAfter: string
}>
>
listDeployments
Get a list of existing deployments.
Method
GET
Path
/v0/deployments
Query
Partial<{
applicationName: string
}>
Result
Array<
{
deploymentId: string
applicationName: string
version: string
domains: Array<string>
} & Partial<{ eventStoreId: string }>
>
listDomains
Get a list of the available domains.
Method
GET
Path
/v0/domains
Result
Array<{
domainId: string
domainType:
| "proxy"
| "static"
| "uploader"
domainName: string
resourceARN: string
aliases: Array<string>
verified: boolean
owner: string
users: "*" | Array<string>
verificationCode: string
certificateId: string
}>
listEnvironmentVariables
Get a list of a deployment's environment variables.
Method
GET
Path
/v0/deployments/:deploymentId/environment
Params
{ deploymentId: string }
Result
{ [K in string]: string }
listEventStores
Get a list of objects that describe available event stores.
Method
GET
Path
/v0/event-stores
Result
Array<{
version: string
eventStoreId: string
linkedDeployments: Array<string>
eventStoreDatabaseName: string
events: number | null
secrets: number | null
modifiedAt: number | null
createdAt: number | null
isFrozen: boolean | null
}>
listReadModels
Obtain the list of a deployment's read models.
Method
GET
Path
/v0/deployments/:deploymentId/read-models
Params
{ deploymentId: string }
Result
Array<{
name: string
status: string | null
successEvent:
| { [K in string]: any }
| null
failedEvent:
| { [K in string]: any }
| null
errors: Array<{
name: string
message: string
stack: string
}>
}>
listSagaProperties
Get the list of assigned saga properties.
Method
GET
Path
/v0/deployments/:deploymentId/sagas/:sagaName/properties
Params
{
deploymentId: string
sagaName: string
}
Result
any
listSagas
Get the list of a deployment's sagas.
Method
GET
Path
/v0/deployments/:deploymentId/sagas
Params
{ deploymentId: string }
Result
Array<{
name: string
status: string | null
successEvent:
| { [K in string]: any }
| null
failedEvent:
| { [K in string]: any }
| null
errors: Array<{
name: string
message: string
stack: string
}>
}>
listVersions
Get a list of the available reSolve versions.
Method
GET
Path
/v0/runtimes
Result
Array<string>
pauseReadModel
Pause read model updates.
Method
PATCH
Path
/v0/deployments/:deploymentId/read-models/:readModelName/pause
Params
{
deploymentId: string
readModelName: string
}
Result
void
pauseSaga
Pause saga updates.
Method
PATCH
Path
/v0/deployments/:deploymentId/sagas/:sagaName/pause
Params
{
deploymentId: string
sagaName: string
}
Result
any
releaseDomain
Release a domain from the associated application deployments.
Method
DELETE
Path
/v0/domains
Body
{ domain: string }
Result
void
removeEnvironmentVariables
Remove environment variables.
Method
DELETE
Path
/v0/deployments/:deploymentId/environment
Params
{ deploymentId: string }
Body
{
variables: Array<string>
}
Result
void
removeLogs
Remove a deployment's logs.
Method
DELETE
Path
/v0/deployments/:deploymentId/logs
Params
{ deploymentId: string }
Result
void
resetReadModel
Reset a read model's persistent state.
Method
PATCH
Path
/v0/deployments/:deploymentId/read-models/:readModelName/reset
Params
{
deploymentId: string
readModelName: string
}
Result
void
resetSaga
Reset a saga's persistent state.
Method
PATCH
Path
/v0/deployments/:deploymentId/sagas/:sagaName/reset
Params
{
deploymentId: string
sagaName: string
}
Result
void
resumeReadModel
Resume read model updates.
Method
PATCH
Path
/v0/deployments/:deploymentId/read-models/:readModelName/resume
Params
{
deploymentId: string
readModelName: string
}
Result
void
resumeSaga
Resume saga updates.
Method
PATCH
Path
/v0/deployments/:deploymentId/sagas/:sagaName/resume
Params
{
deploymentId: string
sagaName: string
}
Result
void
setDeploymentDomain
Assigns a domain to a deployment.
Method
PUT
Path
/v0/deployments/:deploymentId/domain
Params
{ deploymentId: string }
Body
{ domain: string }
Result
void
setEnvironmentVariables
Set environment variables for a deployment.
Method
PUT
Path
/v0/deployments/:deploymentId/environment
Params
{ deploymentId: string }
Body
{
variables: { [K in string]: string }
}
Result
void
setSagaProperty
Assign a value to a saga property.
Method
PUT
Path
/v0/deployments/:deploymentId/sagas/:sagaName/properties
Params
{
deploymentId: string
sagaName: string
}
Body
{
key: string
value: string
}
Result
void
shutdownDeployment
Shut down a deployment.
Method
PATCH
Path
/v0/deployments/:deploymentId/shutdown
Params
{ deploymentId: string }
Result
void
unfreezeEventStore
Resume event store updates.
Method
PATCH
Path
/v0/event-stores/:eventStoreId/unfreeze
Params
{ eventStoreId: string }
Result
void
unlinkDeployment
Disconnect an application deployment from the specified event store.
Method
PATCH
Path
/v0/event-stores/:eventStoreId/unlink
Params
{ eventStoreId: string }
Body
{ deploymentId: string }
Result
void
unsetDeploymentDomain
Detach a domain from a deployment.
Method
DELETE
Path
/v0/deployments/:deploymentId/domain
Params
{ deploymentId: string }
Body
{ domain: string }
Result
void
verifyDomain
Verify a domain after a verification record was added to the domain zone.
Method
PATCH
Path
/v0/domains/:domainId/verify
Params
{ domainId: string }
Result
void