This endpoint is in preview and may be modified or removed at any time.
To use this endpoint, add preview=true to the request query parameters.
Retrieves a live deployment by its Resource Identifier (RID), including its deployed model version and runtime configuration.
Third-party applications using this endpoint via OAuth2 must request the following operation scope: api:models-read.
objectstringThe Resource Identifier (RID) of a Live Deployment.
objectThe currently deployed model version.
stringoptionalThe model branch this deployment tracks. Present for direct deployments that follow the latest model version on a branch; absent for deployment types that are not branch-scoped.
objectThe compute resource configuration for the deployment.
objectThe current operational status of the deployment.
1
2
3
curl \
\t-H "Authorization: Bearer $TOKEN" \
"https://$HOSTNAME/api/v2/models/liveDeployments/ri.foundry-ml-live.main.live-deployment.f351c142-0e4c-4b12-adc2-6e1539737ae9?preview=true"1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
{
"runtimeConfiguration": {
"minReplicas": 1,
"maxReplicas": 3,
"cpu": 1,
"memory": "256MiB",
"threadCount": 32
},
"modelVersion": {
"modelRid": "ri.models.main.model.f351c142-0e4c-4b12-adc2-6e1539737ae9",
"modelVersionRid": "ri.models.main.model-version.adf94926-c3ac-41ea-beb2-4946699d08ee"
},
"rid": "ri.foundry-ml-live.main.live-deployment.f351c142-0e4c-4b12-adc2-6e1539737ae9",
"branch": "master",
"status": {
"state": "ACTIVE",
"isReady": true
}
}| Error Name | ||
|---|---|---|
Unsupported | Error Code | INVALID_ARGUMENT |
| Status Code | 400 | |
| Description | The Live Deployment type is not supported by the API. | |
| Parameters | | |
Live | Error Code | NOT_FOUND |
| Status Code | 404 | |
| Description | The given LiveDeployment could not be found. | |
| Parameters | liveDeploymentRid | |
See Errors for a general overview of errors in the platform.