Get Run
GET/api/v1/runs/:runID
Gets a single run.
Request
Path Parameters
The run ID.
Responses
- 200
- 400
- 401
- 403
- 404
- 500
- 502
- 503
- 504
A single run.
- application/json
- Schema
- Run Response
Schema
- DeployRunDetails
- RefreshRunDetails
If this is a re-run, the ID of the original operation.
runDetails
object
required
Detailed information about a run.
anyOf
Deployment run details.
If the run was canceled.
The full commit hash.
The commit message.
The Environment ID for this run.
The parallelism parameter determines how many nodes are processed simultaneously (in parallel) by the Snowflake compute warehouse.
The number of Nodes deployed.
Refresh run details.
If the run was canceled.
The Environment ID for this run.
A selector string of nodes to exclude.
A selector string of nodes to include.
The Job ID.
The parallelism parameter determines how many nodes are processed simultaneously (in parallel) by the Snowflake compute warehouse.
The Job name.
The number of Nodes deployed.
The datetime when the run ended.
The datetime the run started.
Possible values: [canceled
, completed
, failed
, initializing
, rendering
, running
, waitingToRun
]
runTimeParameters
object
required
The default Environment parameters. Parameters changed during deploy will not show here.
The default Environment parameters. Parameters changed during deploy will not show here.
Possible values: [deploy
, refresh
]
userCredentials
object
Information about the Snowflake account used to perform a run.
Possible values: [Basic
, Cloud
, KeyPair
, OAuth
]
{
"id": 0,
"reRunID": "string",
"runDetails": {
"canceled": true,
"deployCommit": "string",
"deployCommitMessage": "string",
"environmentID": "string",
"parallelism": 0,
"nodesInRun": 0
},
"runEndTime": "2019-08-24T14:15:22Z",
"runHistory": [
0
],
"runStartTime": "2019-08-24T14:15:22Z",
"runStatus": "canceled",
"runTimeParameters": {},
"runType": "deploy",
"userCredentials": {
"snowflakeAccount": "string",
"snowflakeAuthType": "Basic",
"snowflakeRole": "string",
"snowflakeUsername": "string",
"snowflakeWarehouse": "string"
},
"userID": "string",
"version": 0
}
The request was invalid.
- application/json
- Schema
- Invalid Request Error
Schema
error
object
required
The error message.
Additional detail about the error.
{
"error": {
"errorString": "string",
"errorDetail": "string"
}
}
User lacks authorization to perform this action.
- application/json
- Schema
- Unauthorized
Schema
error
object
required
The error message.
Additional detail about the error.
{
"error": {
"errorString": "string",
"errorDetail": "string"
}
}
The client is not permitted to perform the requested operation.
- application/json
- Schema
- Forbidden Error
Schema
error
object
required
The error message.
Additional detail about the error.
{
"error": {
"errorString": "string",
"errorDetail": "string"
}
}
The requested resource could not be found.
- application/json
- Schema
- Not Found Error
Schema
error
object
required
The error message.
Additional detail about the error.
{
"error": {
"errorString": "string",
"errorDetail": "string"
}
}
The server encountered an unexpected condition that prevented it from fulfilling the request.
- application/json
- Schema
- Internal Server Error
Schema
error
object
required
The error message.
Additional detail about the error.
{
"error": {
"errorString": "string",
"errorDetail": "string"
}
}
The server received an error from an upstream system.
- application/json
- Schema
- Bad Gateway Error
Schema
error
object
required
The error message.
Additional detail about the error.
{
"error": {
"errorString": "string",
"errorDetail": "string"
}
}
The service is currently unavailable.
- application/json
- Schema
- Service Unavailable Error
Schema
error
object
required
The error message.
Additional detail about the error.
{
"error": {
"errorString": "string",
"errorDetail": "string"
}
}
The server did not receive a response in time from an upstream system.
- application/json
- Schema
- Gateway Timeout Error
Schema
error
object
required
The error message.
Additional detail about the error.
{
"error": {
"errorString": "string",
"errorDetail": "string"
}
}