Custom Models¶
This page outlines the operations, endpoints, parameters, and example requests and responses for the Custom Models.
GET /api/v2/customJobLimits/¶
Retrieve custom job limits.
Code samples¶
# You can also use wget
curl -X GET https://app.datarobot.com/api/v2/customJobLimits/ \
-H "Accept: application/json" \
-H "Authorization: Bearer {access-token}"
Example responses¶
200 Response
{
"maxCustomJobRuns": 0,
"maxCustomJobTimeout": 0
}
Responses¶
| Status | Meaning | Description | Schema |
|---|---|---|---|
| 200 | OK | Custom job limits | CustomJobLimitsResponse |
| 403 | Forbidden | Custom jobs are not enabled. | None |
To perform this operation, you must be authenticated by means of one of the following methods:
BearerAuth
GET /api/v2/customJobs/¶
List custom jobs.
Code samples¶
# You can also use wget
curl -X GET https://app.datarobot.com/api/v2/customJobs/?offset=0&limit=1000 \
-H "Accept: application/json" \
-H "Authorization: Bearer {access-token}"
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
| offset | query | integer | true | This many results will be skipped. |
| limit | query | integer | true | At most this many results are returned. |
| onlyRunning | query | string | false | Whether only custom jobs that are currently being run should be returned. |
| search | query | string | false | If supplied, only include custom jobs whose name or description contain this string. |
| jobType | query | array[string] | false | The type of the custom job to filter by. |
Enumerated Values¶
| Parameter | Value |
|---|---|
| onlyRunning | [false, False, true, True] |
| jobType | [default, hostedCustomMetric, notification, retraining] |
Example responses¶
200 Response
{
"count": 0,
"data": [
{
"created": "string",
"description": "string",
"entryPoint": "string",
"environmentId": "string",
"environmentVersionId": "string",
"id": "string",
"items": [
{
"commitSha": "string",
"created": "string",
"fileName": "string",
"filePath": "string",
"fileSource": "string",
"id": "string",
"ref": "string",
"repositoryFilePath": "string",
"repositoryLocation": "string",
"repositoryName": "string"
}
],
"jobType": "default",
"lastRun": "string",
"name": "string",
"resources": {
"egressNetworkPolicy": "none",
"resourceBundleId": "string"
},
"runtimeParameters": [
{
"allowEmpty": true,
"credentialType": "adlsGen2Oauth",
"currentValue": "string",
"defaultValue": "string",
"description": "string",
"fieldName": "string",
"maxValue": 0,
"minValue": 0,
"overrideValue": "string",
"type": "boolean"
}
],
"updated": "string"
}
],
"next": "http://example.com",
"previous": "http://example.com",
"totalCount": 0
}
Responses¶
| Status | Meaning | Description | Schema |
|---|---|---|---|
| 200 | OK | List of custom jobs. | CustomJobListResponse |
| 403 | Forbidden | Custom jobs are not enabled. | None |
To perform this operation, you must be authenticated by means of one of the following methods:
BearerAuth
POST /api/v2/customJobs/¶
Create a custom job.
Code samples¶
# You can also use wget
curl -X POST https://app.datarobot.com/api/v2/customJobs/ \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-H "Authorization: Bearer {access-token}"
Body parameter¶
{
"description": "string",
"environmentId": "string",
"environmentVersionId": "string",
"file": "string",
"filePath": "string",
"jobType": "default",
"name": "string",
"resources": {
"egressNetworkPolicy": "none",
"resourceBundleId": "string"
},
"runtimeParameterValues": "string"
}
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
| body | body | CreateCustomJob | false | none |
Example responses¶
201 Response
{
"created": "string",
"description": "string",
"entryPoint": "string",
"environmentId": "string",
"environmentVersionId": "string",
"id": "string",
"items": [
{
"commitSha": "string",
"created": "string",
"fileName": "string",
"filePath": "string",
"fileSource": "string",
"id": "string",
"ref": "string",
"repositoryFilePath": "string",
"repositoryLocation": "string",
"repositoryName": "string"
}
],
"jobType": "default",
"lastRun": "string",
"name": "string",
"resources": {
"egressNetworkPolicy": "none",
"resourceBundleId": "string"
},
"runtimeParameters": [
{
"allowEmpty": true,
"credentialType": "adlsGen2Oauth",
"currentValue": "string",
"defaultValue": "string",
"description": "string",
"fieldName": "string",
"maxValue": 0,
"minValue": 0,
"overrideValue": "string",
"type": "boolean"
}
],
"updated": "string"
}
Responses¶
| Status | Meaning | Description | Schema |
|---|---|---|---|
| 201 | Created | Created. | CustomJobResponse |
| 403 | Forbidden | Custom jobs are not enabled. | None |
| 422 | Unprocessable Entity | Input parameters are invalid. | None |
To perform this operation, you must be authenticated by means of one of the following methods:
BearerAuth
POST /api/v2/customJobs/fromHostedCustomMetricGalleryTemplate/¶
Creates a custom job from the hosted custom metric template.
Code samples¶
# You can also use wget
curl -X POST https://app.datarobot.com/api/v2/customJobs/fromHostedCustomMetricGalleryTemplate/ \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-H "Authorization: Bearer {access-token}"
Body parameter¶
{
"description": "",
"name": "string",
"sidecarDeploymentId": "string",
"templateId": "string"
}
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
| body | body | CustomJobFromGalleryTemplateCreate | false | none |
Example responses¶
201 Response
{
"created": "string",
"description": "string",
"entryPoint": "string",
"environmentId": "string",
"environmentVersionId": "string",
"id": "string",
"items": [
{
"commitSha": "string",
"created": "string",
"fileName": "string",
"filePath": "string",
"fileSource": "string",
"id": "string",
"ref": "string",
"repositoryFilePath": "string",
"repositoryLocation": "string",
"repositoryName": "string"
}
],
"jobType": "default",
"lastRun": "string",
"name": "string",
"resources": {
"egressNetworkPolicy": "none",
"resourceBundleId": "string"
},
"runtimeParameters": [
{
"allowEmpty": true,
"credentialType": "adlsGen2Oauth",
"currentValue": "string",
"defaultValue": "string",
"description": "string",
"fieldName": "string",
"maxValue": 0,
"minValue": 0,
"overrideValue": "string",
"type": "boolean"
}
],
"updated": "string"
}
Responses¶
| Status | Meaning | Description | Schema |
|---|---|---|---|
| 201 | Created | Custom metric test job creation started. | CustomJobResponse |
| 403 | Forbidden | User does not have permission to create a custom job. | None |
To perform this operation, you must be authenticated by means of one of the following methods:
BearerAuth
DELETE /api/v2/customJobs/{customJobId}/¶
Delete custom job.
Code samples¶
# You can also use wget
curl -X DELETE https://app.datarobot.com/api/v2/customJobs/{customJobId}/ \
-H "Authorization: Bearer {access-token}"
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
| customJobId | path | string | true | ID of the custom job. |
Responses¶
| Status | Meaning | Description | Schema |
|---|---|---|---|
| 204 | No Content | Custom job deleted. | None |
| 403 | Forbidden | Custom jobs are not enabled. | None |
To perform this operation, you must be authenticated by means of one of the following methods:
BearerAuth
GET /api/v2/customJobs/{customJobId}/¶
Retrieve custom job.
Code samples¶
# You can also use wget
curl -X GET https://app.datarobot.com/api/v2/customJobs/{customJobId}/ \
-H "Accept: application/json" \
-H "Authorization: Bearer {access-token}"
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
| customJobId | path | string | true | ID of the custom job. |
Example responses¶
200 Response
{
"created": "string",
"description": "string",
"entryPoint": "string",
"environmentId": "string",
"environmentVersionId": "string",
"id": "string",
"items": [
{
"commitSha": "string",
"created": "string",
"fileName": "string",
"filePath": "string",
"fileSource": "string",
"id": "string",
"ref": "string",
"repositoryFilePath": "string",
"repositoryLocation": "string",
"repositoryName": "string"
}
],
"jobType": "default",
"lastRun": "string",
"name": "string",
"resources": {
"egressNetworkPolicy": "none",
"resourceBundleId": "string"
},
"runtimeParameters": [
{
"allowEmpty": true,
"credentialType": "adlsGen2Oauth",
"currentValue": "string",
"defaultValue": "string",
"description": "string",
"fieldName": "string",
"maxValue": 0,
"minValue": 0,
"overrideValue": "string",
"type": "boolean"
}
],
"updated": "string"
}
Responses¶
| Status | Meaning | Description | Schema |
|---|---|---|---|
| 200 | OK | Custom job | CustomJobResponse |
| 403 | Forbidden | Custom jobs are not enabled. | None |
To perform this operation, you must be authenticated by means of one of the following methods:
BearerAuth
PATCH /api/v2/customJobs/{customJobId}/¶
Update custom job.
Code samples¶
# You can also use wget
curl -X PATCH https://app.datarobot.com/api/v2/customJobs/{customJobId}/ \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-H "Authorization: Bearer {access-token}"
Body parameter¶
{
"description": "string",
"entryPoint": "string",
"environmentId": "string",
"environmentVersionId": "string",
"file": "string",
"filePath": "string",
"filesToDelete": "string",
"name": "string",
"resources": {
"egressNetworkPolicy": "none",
"resourceBundleId": "string"
},
"runtimeParameterValues": "string"
}
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
| customJobId | path | string | true | ID of the custom job. |
| body | body | UpdateCustomJob | false | none |
Example responses¶
201 Response
{
"created": "string",
"description": "string",
"entryPoint": "string",
"environmentId": "string",
"environmentVersionId": "string",
"id": "string",
"items": [
{
"commitSha": "string",
"created": "string",
"fileName": "string",
"filePath": "string",
"fileSource": "string",
"id": "string",
"ref": "string",
"repositoryFilePath": "string",
"repositoryLocation": "string",
"repositoryName": "string"
}
],
"jobType": "default",
"lastRun": "string",
"name": "string",
"resources": {
"egressNetworkPolicy": "none",
"resourceBundleId": "string"
},
"runtimeParameters": [
{
"allowEmpty": true,
"credentialType": "adlsGen2Oauth",
"currentValue": "string",
"defaultValue": "string",
"description": "string",
"fieldName": "string",
"maxValue": 0,
"minValue": 0,
"overrideValue": "string",
"type": "boolean"
}
],
"updated": "string"
}
Responses¶
| Status | Meaning | Description | Schema |
|---|---|---|---|
| 201 | Created | Updated custom job | CustomJobResponse |
| 403 | Forbidden | Custom jobs are not enabled. | None |
| 422 | Unprocessable Entity | Input parameters are invalid. | None |
To perform this operation, you must be authenticated by means of one of the following methods:
BearerAuth
GET /api/v2/customJobs/{customJobId}/customMetrics/¶
List all of the custom metrics associated with a custom job.
Code samples¶
# You can also use wget
curl -X GET https://app.datarobot.com/api/v2/customJobs/{customJobId}/customMetrics/ \
-H "Accept: application/json" \
-H "Authorization: Bearer {access-token}"
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
| offset | query | integer | false | This many results will be skipped. |
| limit | query | integer | false | At most this many results are returned. |
| customJobId | path | string | true | ID of the custom job. |
Example responses¶
201 Response
{
"baselineValues": [
{
"value": 0
}
],
"createdAt": "2019-08-24T14:15:22Z",
"deployment": {
"createdAt": "2019-08-24T14:15:22Z",
"creatorFirstName": "string",
"creatorGravatarHash": "string",
"creatorLastName": "string",
"creatorUsername": "string",
"id": "string",
"name": "string"
},
"description": "",
"directionality": "higherIsBetter",
"id": "string",
"isModelSpecific": true,
"name": "string",
"sampleCount": {
"columnName": "string"
},
"schedule": {
"dayOfMonth": [
"*"
],
"dayOfWeek": [
"*"
],
"hour": [
"*"
],
"minute": [
"*"
],
"month": [
"*"
]
},
"timeStep": "hour",
"timestamp": {
"columnName": "string",
"timeFormat": "%m/%d/%Y"
},
"type": "average",
"units": "string",
"value": {
"columnName": "string"
}
}
Responses¶
| Status | Meaning | Description | Schema |
|---|---|---|---|
| 201 | Created | Custom metrics associated with custom job. | MetricCreateFromCustomJobResponse |
| 403 | Forbidden | User does not have permission to custom jobs. | None |
To perform this operation, you must be authenticated by means of one of the following methods:
BearerAuth
DELETE /api/v2/customJobs/{customJobId}/customMetrics/{customMetricId}/¶
Delete a custom metric associated with a custom job.
Code samples¶
# You can also use wget
curl -X DELETE https://app.datarobot.com/api/v2/customJobs/{customJobId}/customMetrics/{customMetricId}/ \
-H "Authorization: Bearer {access-token}"
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
| customJobId | path | string | true | ID of the custom job. |
| customMetricId | path | string | true | ID of the custom metric. |
Responses¶
| Status | Meaning | Description | Schema |
|---|---|---|---|
| 204 | No Content | none | None |
| 403 | Forbidden | User does not have permission to custom jobs. | None |
To perform this operation, you must be authenticated by means of one of the following methods:
BearerAuth
PATCH /api/v2/customJobs/{customJobId}/customMetrics/{customMetricId}/¶
Update custom metric associated with a custom job.
Code samples¶
# You can also use wget
curl -X PATCH https://app.datarobot.com/api/v2/customJobs/{customJobId}/customMetrics/{customMetricId}/ \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-H "Authorization: Bearer {access-token}"
Body parameter¶
{
"baselineValues": [
{
"value": 0
}
],
"batch": {
"columnName": "string"
},
"description": "string",
"directionality": "higherIsBetter",
"name": "string",
"sampleCount": {
"columnName": "string"
},
"schedule": {
"dayOfMonth": [
"*"
],
"dayOfWeek": [
"*"
],
"hour": [
"*"
],
"minute": [
"*"
],
"month": [
"*"
]
},
"timestamp": {
"columnName": "string",
"timeFormat": "%m/%d/%Y"
},
"type": "average",
"units": "string",
"value": {
"columnName": "string"
}
}
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
| customJobId | path | string | true | ID of the custom job. |
| customMetricId | path | string | true | ID of the custom metric. |
| body | body | CustomJobCustomMetricUpdate | false | none |
Example responses¶
200 Response
{
"baselineValues": [
{
"value": 0
}
],
"createdAt": "2019-08-24T14:15:22Z",
"deployment": {
"createdAt": "2019-08-24T14:15:22Z",
"creatorFirstName": "string",
"creatorGravatarHash": "string",
"creatorLastName": "string",
"creatorUsername": "string",
"id": "string",
"name": "string"
},
"description": "",
"directionality": "higherIsBetter",
"id": "string",
"isModelSpecific": true,
"name": "string",
"sampleCount": {
"columnName": "string"
},
"schedule": {
"dayOfMonth": [
"*"
],
"dayOfWeek": [
"*"
],
"hour": [
"*"
],
"minute": [
"*"
],
"month": [
"*"
]
},
"timeStep": "hour",
"timestamp": {
"columnName": "string",
"timeFormat": "%m/%d/%Y"
},
"type": "average",
"units": "string",
"value": {
"columnName": "string"
}
}
Responses¶
| Status | Meaning | Description | Schema |
|---|---|---|---|
| 200 | OK | Updated custom metric. | MetricCreateFromCustomJobResponse |
| 403 | Forbidden | User does not have permission to custom jobs. | None |
To perform this operation, you must be authenticated by means of one of the following methods:
BearerAuth
GET /api/v2/customJobs/{customJobId}/hostedCustomMetricTemplate/¶
Retrieve a template for hosted custom metric job.
Code samples¶
# You can also use wget
curl -X GET https://app.datarobot.com/api/v2/customJobs/{customJobId}/hostedCustomMetricTemplate/ \
-H "Accept: application/json" \
-H "Authorization: Bearer {access-token}"
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
| customJobId | path | string | true | ID of the custom job. |
Example responses¶
200 Response
{
"createdAt": "2019-08-24T14:15:22Z",
"createdBy": "string",
"customJobId": "string",
"directionality": "higherIsBetter",
"id": "string",
"isModelSpecific": true,
"timeStep": "hour",
"type": "average",
"units": "string",
"updatedAt": "2019-08-24T14:15:22Z",
"updatedBy": "string"
}
Responses¶
| Status | Meaning | Description | Schema |
|---|---|---|---|
| 200 | OK | Hosted custom metric template retrieved. | HostedCustomMetricTemplateResponse |
| 403 | Forbidden | User does not have permission to retrieve a custom metric test job. | None |
| 404 | Not Found | Custom job does not exist or user does not have permission to access it. | None |
To perform this operation, you must be authenticated by means of one of the following methods:
BearerAuth
PATCH /api/v2/customJobs/{customJobId}/hostedCustomMetricTemplate/¶
Updates a template for hosted custom metric job.
Code samples¶
# You can also use wget
curl -X PATCH https://app.datarobot.com/api/v2/customJobs/{customJobId}/hostedCustomMetricTemplate/ \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-H "Authorization: Bearer {access-token}"
Body parameter¶
{
"directionality": "higherIsBetter",
"isModelSpecific": true,
"timeStep": "hour",
"type": "average",
"units": "string"
}
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
| customJobId | path | string | true | ID of the custom job. |
| body | body | HostedCustomMetricTemplateUpdate | false | none |
Example responses¶
201 Response
{
"createdAt": "2019-08-24T14:15:22Z",
"createdBy": "string",
"customJobId": "string",
"directionality": "higherIsBetter",
"id": "string",
"isModelSpecific": true,
"timeStep": "hour",
"type": "average",
"units": "string",
"updatedAt": "2019-08-24T14:15:22Z",
"updatedBy": "string"
}
Responses¶
| Status | Meaning | Description | Schema |
|---|---|---|---|
| 201 | Created | Hosted custom metric template updated. | HostedCustomMetricTemplateResponse |
| 403 | Forbidden | User does not have permission to update a custom metric test job. | None |
| 404 | Not Found | Custom job or template does not exist or user does not have permission to access it. | None |
| 409 | Conflict | Custom job have at least 1 associated deployment. | None |
To perform this operation, you must be authenticated by means of one of the following methods:
BearerAuth
POST /api/v2/customJobs/{customJobId}/hostedCustomMetricTemplate/¶
Creates a template for hosted custom metric job.
Code samples¶
# You can also use wget
curl -X POST https://app.datarobot.com/api/v2/customJobs/{customJobId}/hostedCustomMetricTemplate/ \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-H "Authorization: Bearer {access-token}"
Body parameter¶
{
"directionality": "higherIsBetter",
"isModelSpecific": true,
"timeStep": "hour",
"type": "average",
"units": "string"
}
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
| customJobId | path | string | true | ID of the custom job. |
| body | body | HostedCustomMetricTemplateCreate | false | none |
Example responses¶
201 Response
{
"createdAt": "2019-08-24T14:15:22Z",
"createdBy": "string",
"customJobId": "string",
"directionality": "higherIsBetter",
"id": "string",
"isModelSpecific": true,
"timeStep": "hour",
"type": "average",
"units": "string",
"updatedAt": "2019-08-24T14:15:22Z",
"updatedBy": "string"
}
Responses¶
| Status | Meaning | Description | Schema |
|---|---|---|---|
| 201 | Created | Hosted custom metric template created. | HostedCustomMetricTemplateResponse |
| 403 | Forbidden | User does not have permission to create a custom metric test job. | None |
| 404 | Not Found | Custom job does not exist or user does not have permission to access it. | None |
| 409 | Conflict | Hosted custom metric template already exists. | None |
To perform this operation, you must be authenticated by means of one of the following methods:
BearerAuth
GET /api/v2/customJobs/{customJobId}/items/{itemId}/¶
Retrieve custom job file content.
Code samples¶
# You can also use wget
curl -X GET https://app.datarobot.com/api/v2/customJobs/{customJobId}/items/{itemId}/ \
-H "Accept: application/json" \
-H "Authorization: Bearer {access-token}"
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
| customJobId | path | string | true | ID of the custom job. |
| itemId | path | string | true | ID of the file item. |
Example responses¶
200 Response
{
"content": "string",
"fileName": "string",
"filePath": "string",
"id": "string"
}
Responses¶
| Status | Meaning | Description | Schema |
|---|---|---|---|
| 200 | OK | Custom job file content | CustomJobFileResponse |
| 403 | Forbidden | Custom jobs are not enabled. | None |
| 404 | Not Found | No file found. | None |
| 422 | Unprocessable Entity | File is not utf-8 encoded. | None |
To perform this operation, you must be authenticated by means of one of the following methods:
BearerAuth
GET /api/v2/customJobs/{customJobId}/runs/¶
List custom job runs.
Code samples¶
# You can also use wget
curl -X GET https://app.datarobot.com/api/v2/customJobs/{customJobId}/runs/ \
-H "Accept: application/json" \
-H "Authorization: Bearer {access-token}"
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
| offset | query | integer | false | This many results will be skipped. |
| limit | query | integer | false | At most this many results are returned. |
| scheduledJobId | query | string | false | If supplied, only include custom job runs that are scheduled with this scheduled job id. |
| customJobId | path | string | true | ID of the custom job. |
Example responses¶
200 Response
{
"count": 0,
"data": [
{
"created": "string",
"customJobId": "string",
"description": "string",
"duration": 0,
"entryPoint": "string",
"id": "string",
"items": [
{
"commitSha": "string",
"created": "string",
"fileName": "string",
"filePath": "string",
"fileSource": "string",
"id": "string",
"ref": "string",
"repositoryFilePath": "string",
"repositoryLocation": "string",
"repositoryName": "string"
}
],
"jobStatusId": "string",
"resources": {
"egressNetworkPolicy": "none",
"resourceBundleId": "string"
},
"runtimeParameters": [
{
"allowEmpty": true,
"credentialType": "adlsGen2Oauth",
"currentValue": "string",
"defaultValue": "string",
"description": "string",
"fieldName": "string",
"maxValue": 0,
"minValue": 0,
"overrideValue": "string",
"type": "boolean"
}
],
"status": "succeeded"
}
],
"next": "http://example.com",
"previous": "http://example.com",
"totalCount": 0
}
Responses¶
| Status | Meaning | Description | Schema |
|---|---|---|---|
| 200 | OK | List of custom job runs. | CustomJobRunListResponse |
| 403 | Forbidden | Custom jobs are not enabled. | None |
To perform this operation, you must be authenticated by means of one of the following methods:
BearerAuth
POST /api/v2/customJobs/{customJobId}/runs/¶
Create a custom job run.
Code samples¶
# You can also use wget
curl -X POST https://app.datarobot.com/api/v2/customJobs/{customJobId}/runs/ \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-H "Authorization: Bearer {access-token}"
Body parameter¶
{
"description": "string",
"runtimeParameterValues": [
{
"fieldName": "string",
"type": "boolean",
"value": "string"
}
]
}
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
| customJobId | path | string | true | ID of the custom job. |
| body | body | CreateCustomJobRun | false | none |
Example responses¶
201 Response
{
"created": "string",
"customJobId": "string",
"description": "string",
"duration": 0,
"entryPoint": "string",
"id": "string",
"items": [
{
"commitSha": "string",
"created": "string",
"fileName": "string",
"filePath": "string",
"fileSource": "string",
"id": "string",
"ref": "string",
"repositoryFilePath": "string",
"repositoryLocation": "string",
"repositoryName": "string"
}
],
"jobStatusId": "string",
"resources": {
"egressNetworkPolicy": "none",
"resourceBundleId": "string"
},
"runtimeParameters": [
{
"allowEmpty": true,
"credentialType": "adlsGen2Oauth",
"currentValue": "string",
"defaultValue": "string",
"description": "string",
"fieldName": "string",
"maxValue": 0,
"minValue": 0,
"overrideValue": "string",
"type": "boolean"
}
],
"status": "succeeded"
}
Responses¶
| Status | Meaning | Description | Schema |
|---|---|---|---|
| 201 | Created | Created. | CustomJobRunResponse |
| 403 | Forbidden | Custom jobs are not enabled. | None |
| 422 | Unprocessable Entity | Input parameters are invalid. | None |
To perform this operation, you must be authenticated by means of one of the following methods:
BearerAuth
DELETE /api/v2/customJobs/{customJobId}/runs/{customJobRunId}/¶
Cancel custom job run.
Code samples¶
# You can also use wget
curl -X DELETE https://app.datarobot.com/api/v2/customJobs/{customJobId}/runs/{customJobRunId}/ \
-H "Authorization: Bearer {access-token}"
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
| customJobId | path | string | true | ID of the custom job. |
| customJobRunId | path | string | true | ID of the custom job run. |
Responses¶
| Status | Meaning | Description | Schema |
|---|---|---|---|
| 204 | No Content | Custom job run canceled | None |
| 403 | Forbidden | Custom jobs are not enabled. | None |
| 422 | Unprocessable Entity | Input parameters are invalid. | None |
To perform this operation, you must be authenticated by means of one of the following methods:
BearerAuth
GET /api/v2/customJobs/{customJobId}/runs/{customJobRunId}/¶
Retrieve custom job run.
Code samples¶
# You can also use wget
curl -X GET https://app.datarobot.com/api/v2/customJobs/{customJobId}/runs/{customJobRunId}/ \
-H "Accept: application/json" \
-H "Authorization: Bearer {access-token}"
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
| customJobId | path | string | true | ID of the custom job. |
| customJobRunId | path | string | true | ID of the custom job run. |
Example responses¶
200 Response
{
"created": "string",
"customJobId": "string",
"description": "string",
"duration": 0,
"entryPoint": "string",
"id": "string",
"items": [
{
"commitSha": "string",
"created": "string",
"fileName": "string",
"filePath": "string",
"fileSource": "string",
"id": "string",
"ref": "string",
"repositoryFilePath": "string",
"repositoryLocation": "string",
"repositoryName": "string"
}
],
"jobStatusId": "string",
"resources": {
"egressNetworkPolicy": "none",
"resourceBundleId": "string"
},
"runtimeParameters": [
{
"allowEmpty": true,
"credentialType": "adlsGen2Oauth",
"currentValue": "string",
"defaultValue": "string",
"description": "string",
"fieldName": "string",
"maxValue": 0,
"minValue": 0,
"overrideValue": "string",
"type": "boolean"
}
],
"status": "succeeded"
}
Responses¶
| Status | Meaning | Description | Schema |
|---|---|---|---|
| 200 | OK | Custom job run | CustomJobRunResponse |
| 403 | Forbidden | Custom jobs are not enabled. | None |
To perform this operation, you must be authenticated by means of one of the following methods:
BearerAuth
PATCH /api/v2/customJobs/{customJobId}/runs/{customJobRunId}/¶
Update custom job run.
Code samples¶
# You can also use wget
curl -X PATCH https://app.datarobot.com/api/v2/customJobs/{customJobId}/runs/{customJobRunId}/ \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-H "Authorization: Bearer {access-token}"
Body parameter¶
{
"description": "string",
"runtimeParameterValues": [
{
"fieldName": "string",
"type": "boolean",
"value": "string"
}
]
}
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
| customJobId | path | string | true | ID of the custom job. |
| customJobRunId | path | string | true | ID of the custom job run. |
| body | body | CreateCustomJobRun | false | none |
Example responses¶
201 Response
{
"created": "string",
"customJobId": "string",
"description": "string",
"duration": 0,
"entryPoint": "string",
"id": "string",
"items": [
{
"commitSha": "string",
"created": "string",
"fileName": "string",
"filePath": "string",
"fileSource": "string",
"id": "string",
"ref": "string",
"repositoryFilePath": "string",
"repositoryLocation": "string",
"repositoryName": "string"
}
],
"jobStatusId": "string",
"resources": {
"egressNetworkPolicy": "none",
"resourceBundleId": "string"
},
"runtimeParameters": [
{
"allowEmpty": true,
"credentialType": "adlsGen2Oauth",
"currentValue": "string",
"defaultValue": "string",
"description": "string",
"fieldName": "string",
"maxValue": 0,
"minValue": 0,
"overrideValue": "string",
"type": "boolean"
}
],
"status": "succeeded"
}
Responses¶
| Status | Meaning | Description | Schema |
|---|---|---|---|
| 201 | Created | Updated custom job run | CustomJobRunResponse |
| 403 | Forbidden | Custom jobs are not enabled. | None |
| 422 | Unprocessable Entity | Input parameters are invalid. | None |
To perform this operation, you must be authenticated by means of one of the following methods:
BearerAuth
GET /api/v2/customJobs/{customJobId}/runs/{customJobRunId}/items/{itemId}/¶
Retrieve custom job run file content.
Code samples¶
# You can also use wget
curl -X GET https://app.datarobot.com/api/v2/customJobs/{customJobId}/runs/{customJobRunId}/items/{itemId}/ \
-H "Accept: application/json" \
-H "Authorization: Bearer {access-token}"
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
| customJobId | path | string | true | ID of the custom job. |
| customJobRunId | path | string | true | ID of the custom job run. |
| itemId | path | string | true | ID of the file item. |
Example responses¶
200 Response
{
"content": "string",
"fileName": "string",
"filePath": "string",
"id": "string"
}
Responses¶
| Status | Meaning | Description | Schema |
|---|---|---|---|
| 200 | OK | Custom job run file content | CustomJobFileResponse |
| 403 | Forbidden | Custom jobs are not enabled. | None |
| 404 | Not Found | No file found. | None |
| 422 | Unprocessable Entity | File is not utf-8 encoded. | None |
To perform this operation, you must be authenticated by means of one of the following methods:
BearerAuth
DELETE /api/v2/customJobs/{customJobId}/runs/{customJobRunId}/logs/¶
Delete custom job run logs.
Code samples¶
# You can also use wget
curl -X DELETE https://app.datarobot.com/api/v2/customJobs/{customJobId}/runs/{customJobRunId}/logs/ \
-H "Authorization: Bearer {access-token}"
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
| customJobId | path | string | true | ID of the custom job. |
| customJobRunId | path | string | true | ID of the custom job run. |
Responses¶
| Status | Meaning | Description | Schema |
|---|---|---|---|
| 204 | No Content | Custom job run logs deleted. | None |
| 404 | Not Found | No log found. | None |
To perform this operation, you must be authenticated by means of one of the following methods:
BearerAuth
GET /api/v2/customJobs/{customJobId}/runs/{customJobRunId}/logs/¶
Retrieve custom job run logs.
Code samples¶
# You can also use wget
curl -X GET https://app.datarobot.com/api/v2/customJobs/{customJobId}/runs/{customJobRunId}/logs/ \
-H "Authorization: Bearer {access-token}"
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
| customJobId | path | string | true | ID of the custom job. |
| customJobRunId | path | string | true | ID of the custom job run. |
Responses¶
| Status | Meaning | Description | Schema |
|---|---|---|---|
| 200 | OK | The log file download. | None |
| 404 | Not Found | No log found. | None |
Response Headers¶
| Status | Header | Type | Format | Description |
|---|---|---|---|---|
| 200 | Content-Disposition | string | Contains an auto generated filename for this download ("attachment;filename=custom-job-run- |
To perform this operation, you must be authenticated by means of one of the following methods:
BearerAuth
GET /api/v2/customJobs/{customJobId}/sharedRoles/¶
Get a list of users, groups and organizations who have access to this custom job and their roles on the custom job.
Code samples¶
# You can also use wget
curl -X GET https://app.datarobot.com/api/v2/customJobs/{customJobId}/sharedRoles/?offset=0&limit=10 \
-H "Accept: application/json" \
-H "Authorization: Bearer {access-token}"
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
| id | query | string | false | Only return roles for a user, group or organization with this identifier. |
| offset | query | integer | true | This many results will be skipped |
| limit | query | integer | true | At most this many results are returned |
| name | query | string | false | Only return roles for a user, group or organization with this name. |
| shareRecipientType | query | string | false | List access controls for recipients with this type. |
| customJobId | path | string | true | ID of the custom job. |
Enumerated Values¶
| Parameter | Value |
|---|---|
| shareRecipientType | [user, group, organization] |
Example responses¶
200 Response
{
"count": 0,
"data": [
{
"id": "string",
"name": "string",
"role": "ADMIN",
"shareRecipientType": "user"
}
],
"next": "string",
"previous": "string",
"totalCount": 0
}
Responses¶
| Status | Meaning | Description | Schema |
|---|---|---|---|
| 200 | OK | The Custom Job's access control list. | SharingListV2Response |
| 404 | Not Found | Either the Custom Job does not exist or the user does not have permissions to view the Custom Job. | None |
| 422 | Unprocessable Entity | Both username and userId were specified | None |
To perform this operation, you must be authenticated by means of one of the following methods:
BearerAuth
PATCH /api/v2/customJobs/{customJobId}/sharedRoles/¶
Set roles for users on this custom job.
Code samples¶
# You can also use wget
curl -X PATCH https://app.datarobot.com/api/v2/customJobs/{customJobId}/sharedRoles/ \
-H "Content-Type: application/json" \
-H "Authorization: Bearer {access-token}"
Body parameter¶
{
"operation": "updateRoles",
"roles": [
{
"role": "string",
"shareRecipientType": "user",
"username": "string"
}
]
}
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
| customJobId | path | string | true | ID of the custom job. |
| body | body | SharedRolesUpdate | false | none |
Responses¶
| Status | Meaning | Description | Schema |
|---|---|---|---|
| 204 | No Content | Roles updated successfully. | None |
| 409 | Conflict | The request would leave the custom job without an owner. | None |
| 422 | Unprocessable Entity | One of the users in the request does not exist, or the request is otherwise invalid | None |
To perform this operation, you must be authenticated by means of one of the following methods:
BearerAuth
POST /api/v2/customJobsCleanup/{customJobId}/¶
Permanently delete custom job.
Code samples¶
# You can also use wget
curl -X POST https://app.datarobot.com/api/v2/customJobsCleanup/{customJobId}/ \
-H "Authorization: Bearer {access-token}"
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
| customJobId | path | string | true | ID of the custom job. |
Responses¶
| Status | Meaning | Description | Schema |
|---|---|---|---|
| 204 | No Content | Custom job permanently deleted. | None |
| 401 | Unauthorized | Permadelete not enabled or user not permitted to permadelete. | None |
| 403 | Forbidden | Custom jobs are not enabled. | None |
| 409 | Conflict | At least one of the custom job componenets are not soft-deleted, therefore can not permanently delete. | None |
To perform this operation, you must be authenticated by means of one of the following methods:
BearerAuth
GET /api/v2/customModelDeployments/¶
List of model deployments for user sorted by creation time descending.
Code samples¶
# You can also use wget
curl -X GET https://app.datarobot.com/api/v2/customModelDeployments/?offset=0&limit=100 \
-H "Accept: application/json" \
-H "Authorization: Bearer {access-token}"
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
| offset | query | integer | true | This many results will be skipped. |
| limit | query | integer | true | At most this many results are returned. |
| customModelIds | query | any | false | List of ID's of the custom model which model deployments will be retrieved. |
| environmentIds | query | any | false | List of ID's of the execution environment which model deployments will be retrieved. |
Example responses¶
200 Response
{
"count": 0,
"data": [
{
"customModel": {
"id": "string",
"name": "string"
},
"customModelImageId": "string",
"customModelVersion": {
"id": "string",
"label": "string"
},
"deployed": "string",
"deployedBy": "string",
"executionEnvironment": {
"id": "string",
"name": "string"
},
"executionEnvironmentVersion": {
"id": "string",
"label": "string"
},
"id": "string",
"imageType": "customModelImage",
"label": "string",
"status": "active",
"testingStatus": "not_tested"
}
],
"next": "http://example.com",
"previous": "http://example.com",
"totalCount": 0
}
Responses¶
| Status | Meaning | Description | Schema |
|---|---|---|---|
| 200 | OK | OK. | CustomModelDeploymentListResponse |
| 400 | Bad Request | Query parameters are invalid. | None |
To perform this operation, you must be authenticated by means of one of the following methods:
BearerAuth
GET /api/v2/customModelDeployments/{deploymentId}/logs/¶
Retrieve the logs generated during deployment of the custom model.
Code samples¶
# You can also use wget
curl -X GET https://app.datarobot.com/api/v2/customModelDeployments/{deploymentId}/logs/ \
-H "Authorization: Bearer {access-token}"
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
| deploymentId | path | string | true | ID of the custom model deployment. |
Responses¶
| Status | Meaning | Description | Schema |
|---|---|---|---|
| 200 | OK | The response will contain a text file with the contents of the Custom Model deployment log. | None |
| 404 | Not Found | No logs found. | None |
Response Headers¶
| Status | Header | Type | Format | Description |
|---|---|---|---|---|
| 200 | Content-Disposition | string | Contains an auto generated filename of the log file ("attachment;filename=deployment- |
To perform this operation, you must be authenticated by means of one of the following methods:
BearerAuth
POST /api/v2/customModelDeployments/{deploymentId}/logs/¶
Request logs from a custom deployed model.
Code samples¶
# You can also use wget
curl -X POST https://app.datarobot.com/api/v2/customModelDeployments/{deploymentId}/logs/ \
-H "Accept: application/json" \
-H "Authorization: Bearer {access-token}"
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
| deploymentId | path | string | true | ID of the custom model deployment. |
Example responses¶
202 Response
{
"statusId": "string"
}
Responses¶
| Status | Meaning | Description | Schema |
|---|---|---|---|
| 202 | Accepted | Accepted: request placed to a queue for processing. | CustomModelAsyncOperationResponse |
| 404 | Not Found | Deployment not found or model is not a Custom Model. | None |
| 422 | Unprocessable Entity | Deployed model is not a Custom Model. | None |
Response Headers¶
| Status | Header | Type | Format | Description |
|---|---|---|---|---|
| 202 | Location | string | URL for tracking async job status. |
To perform this operation, you must be authenticated by means of one of the following methods:
BearerAuth
GET /api/v2/customModelDeployments/{deploymentId}/logs/{logId}/¶
Retrieve the logs generated during predictions on the deployed custom model.
Code samples¶
# You can also use wget
curl -X GET https://app.datarobot.com/api/v2/customModelDeployments/{deploymentId}/logs/{logId}/ \
-H "Authorization: Bearer {access-token}"
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
| deploymentId | path | string | true | ID of the custom model deployment. |
| logId | path | string | true | ID of the custom model deployment log. |
Responses¶
| Status | Meaning | Description | Schema |
|---|---|---|---|
| 200 | OK | The response will contain a text file with the contents of the Custom Model deployment log. | None |
| 404 | Not Found | No logs found. | None |
Response Headers¶
| Status | Header | Type | Format | Description |
|---|---|---|---|---|
| 200 | Content-Disposition | string | Contains an auto generated filename of the log file ("attachment;filename=deployment- |
To perform this operation, you must be authenticated by means of one of the following methods:
BearerAuth
GET /api/v2/customModelLimits/¶
Retrieve custom model resource limits the user has access to.
Code samples¶
# You can also use wget
curl -X GET https://app.datarobot.com/api/v2/customModelLimits/ \
-H "Accept: application/json" \
-H "Authorization: Bearer {access-token}"
Example responses¶
200 Response
{
"desiredCustomModelContainerSize": 134217728,
"maxCustomModelContainerSize": 134217728,
"maxCustomModelReplicasPerDeployment": 0,
"maxCustomModelTestingParallelUsers": 0
}
Responses¶
| Status | Meaning | Description | Schema |
|---|---|---|---|
| 200 | OK | OK. | CustomModelResourceLimits |
To perform this operation, you must be authenticated by means of one of the following methods:
BearerAuth
GET /api/v2/customModelTests/¶
Retrieve the testing history for a model.
Code samples¶
# You can also use wget
curl -X GET https://app.datarobot.com/api/v2/customModelTests/?offset=0&limit=1000&customModelId=string \
-H "Accept: application/json" \
-H "Authorization: Bearer {access-token}"
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
| offset | query | integer | true | This many results will be skipped. |
| limit | query | integer | true | At most this many results are returned. |
| resourceBundleId | query | string | false | A single identifier that represents a bundle of resources: Memory, CPU, GPU, etc. A list of available bundles can be obtained via the resource bundles endpoint. |
| maximumMemory | query | integer | false | The maximum memory that might be allocated by the custom-model. If exceeded, the custom-model will be killed. This setting is incompatible with setting the resourceBundleId. |
| networkEgressPolicy | query | string | false | Network egress policy. |
| desiredMemory | query | integer | false | The amount of memory that is expected to be allocated by the custom model. This setting is incompatible with setting the resourceBundleId. |
| replicas | query | integer | false | A fixed number of replicas that will be set for the given custom-model. |
| requiresHa | query | boolean | false | Require all custom model replicas to be deployed on different Kubernetes nodes for predictions fault tolerance. |
| customModelId | query | string | true | ID of the Custom Model to retrieve testing history for. |
Enumerated Values¶
| Parameter | Value |
|---|---|
| networkEgressPolicy | [NONE, PUBLIC] |
Example responses¶
200 Response
{
"count": 0,
"data": [
{
"completedAt": "string",
"created": "string",
"createdBy": "string",
"customModel": {
"id": "string",
"name": "string"
},
"customModelImageId": "string",
"customModelVersion": {
"id": "string",
"label": "string"
},
"datasetId": "string",
"datasetVersionId": "string",
"desiredMemory": 134217728,
"executionEnvironment": {
"id": "string",
"name": "string"
},
"executionEnvironmentVersion": {
"id": "string",
"label": "string"
},
"id": "string",
"imageType": "customModelImage",
"maximumMemory": 134217728,
"networkEgressPolicy": "NONE",
"overallStatus": "not_tested",
"replicas": 0,
"requiresHa": true,
"resourceBundleId": "string",
"testingStatus": {
"errorCheck": {
"message": "string",
"status": "not_tested"
},
"longRunningService": {
"message": "string",
"status": "not_tested"
},
"nullValueImputation": {
"message": "string",
"status": "not_tested"
},
"sideEffects": {
"message": "string",
"status": "not_tested"
}
}
}
],
"next": "http://example.com",
"previous": "http://example.com",
"totalCount": 0
}
Responses¶
| Status | Meaning | Description | Schema |
|---|---|---|---|
| 200 | OK | OK. | CustomModelTestsListResponse |
To perform this operation, you must be authenticated by means of one of the following methods:
BearerAuth
POST /api/v2/customModelTests/¶
Test a custom inference model. This will start a job to check that the custom model can make predictions against the supplied dataset without breaking.
Code samples¶
# You can also use wget
curl -X POST https://app.datarobot.com/api/v2/customModelTests/ \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-H "Authorization: Bearer {access-token}"
Body parameter¶
{
"configuration": {
"errorCheck": "fail",
"longRunningService": "fail",
"nullValueImputation": "skip",
"sideEffects": "skip"
},
"customModelId": "string",
"customModelVersionId": "string",
"datasetId": "string",
"datasetVersionId": "string",
"desiredMemory": 134217728,
"environmentId": "string",
"environmentVersionId": "string",
"maximumMemory": 134217728,
"networkEgressPolicy": "NONE",
"replicas": 0,
"requiresHa": true,
"resourceBundleId": "string"
}
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
| body | body | CustomModelTests | false | none |
Example responses¶
202 Response
{
"statusId": "string"
}
Responses¶
| Status | Meaning | Description | Schema |
|---|---|---|---|
| 202 | Accepted | Model testing job successfully started. | CustomModelAsyncOperationResponse |
| 403 | Forbidden | No access to use data for testing custom model. | None |
| 404 | Not Found | Custom model or dataset not found. | None |
| 422 | Unprocessable Entity | Custom Model Testing cannot be submitted because of invalid input or model state: (1) if user does not have permission to create legacy conversion environment, (2) testing is already in progress for the custom model, (3) dataset used for testing is not snapshotted,(4) other cases. | None |
Response Headers¶
| Status | Header | Type | Format | Description |
|---|---|---|---|---|
| 202 | Location | string | URL that can be polled to check the status. |
To perform this operation, you must be authenticated by means of one of the following methods:
BearerAuth
DELETE /api/v2/customModelTests/{customModelTestId}/¶
Cancel custom inference model testing.
Code samples¶
# You can also use wget
curl -X DELETE https://app.datarobot.com/api/v2/customModelTests/{customModelTestId}/ \
-H "Authorization: Bearer {access-token}"
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
| customModelTestId | path | string | true | ID of the testing history attempt. |
Responses¶
| Status | Meaning | Description | Schema |
|---|---|---|---|
| 204 | No Content | Testing canceled. | None |
| 404 | Not Found | Testing attempt not found. | None |
| 409 | Conflict | Testing attempt has already reached a terminal state. | None |
To perform this operation, you must be authenticated by means of one of the following methods:
BearerAuth
GET /api/v2/customModelTests/{customModelTestId}/¶
Retrieve a specific testing history entry for a custom model.
Code samples¶
# You can also use wget
curl -X GET https://app.datarobot.com/api/v2/customModelTests/{customModelTestId}/ \
-H "Accept: application/json" \
-H "Authorization: Bearer {access-token}"
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
| customModelTestId | path | string | true | ID of the testing history attempt. |
Example responses¶
200 Response
{
"completedAt": "string",
"created": "string",
"createdBy": "string",
"customModel": {
"id": "string",
"name": "string"
},
"customModelImageId": "string",
"customModelVersion": {
"id": "string",
"label": "string"
},
"datasetId": "string",
"datasetVersionId": "string",
"desiredMemory": 134217728,
"executionEnvironment": {
"id": "string",
"name": "string"
},
"executionEnvironmentVersion": {
"id": "string",
"label": "string"
},
"id": "string",
"imageType": "customModelImage",
"maximumMemory": 134217728,
"networkEgressPolicy": "NONE",
"overallStatus": "not_tested",
"replicas": 0,
"requiresHa": true,
"resourceBundleId": "string",
"testingStatus": {
"errorCheck": {
"message": "string",
"status": "not_tested"
},
"longRunningService": {
"message": "string",
"status": "not_tested"
},
"nullValueImputation": {
"message": "string",
"status": "not_tested"
},
"sideEffects": {
"message": "string",
"status": "not_tested"
}
}
}
Responses¶
| Status | Meaning | Description | Schema |
|---|---|---|---|
| 200 | OK | OK. | CustomModelTestsResponse |
To perform this operation, you must be authenticated by means of one of the following methods:
BearerAuth
GET /api/v2/customModelTests/{customModelTestId}/log/¶
Retrieve the logs from a model testing attempt.
Code samples¶
# You can also use wget
curl -X GET https://app.datarobot.com/api/v2/customModelTests/{customModelTestId}/log/ \
-H "Authorization: Bearer {access-token}"
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
| customModelTestId | path | string | true | ID of the testing history attempt. |
Responses¶
| Status | Meaning | Description | Schema |
|---|---|---|---|
| 200 | OK | The log file will be downloaded. | None |
| 404 | Not Found | No testing log found. | None |
Response Headers¶
| Status | Header | Type | Format | Description |
|---|---|---|---|---|
| 200 | Content-Disposition | string | Contains an auto generated filename for this download ("attachment;filename=testing- |
To perform this operation, you must be authenticated by means of one of the following methods:
BearerAuth
GET /api/v2/customModelTests/{customModelTestId}/tail/¶
Retrieve the last N lines of logs from a model testing attempt.
Code samples¶
# You can also use wget
curl -X GET https://app.datarobot.com/api/v2/customModelTests/{customModelTestId}/tail/?lines=100 \
-H "Accept: application/json" \
-H "Authorization: Bearer {access-token}"
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
| lines | query | integer | true | Number of lines from the log to retrieve (1-1000, default 100). |
| customModelTestId | path | string | true | ID of the testing history attempt. |
Example responses¶
200 Response
{
"log": "string"
}
Responses¶
| Status | Meaning | Description | Schema |
|---|---|---|---|
| 200 | OK | The log tail was retrieved. | CustomModelTestsLogTailResponse |
| 400 | Bad Request | Requested number of lines is invalid. | None |
| 404 | Not Found | The testing history entry cannot be found. | None |
To perform this operation, you must be authenticated by means of one of the following methods:
BearerAuth
GET /api/v2/customModels/¶
Retrieve metadata for all custom models the user has access to.
Code samples¶
# You can also use wget
curl -X GET https://app.datarobot.com/api/v2/customModels/?offset=0&limit=1000 \
-H "Accept: application/json" \
-H "Authorization: Bearer {access-token}"
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
| offset | query | integer | true | This many results will be skipped. |
| limit | query | integer | true | At most this many results are returned. |
| customModelType | query | string | false | If "training" specified, only Custom Training Tasks will be returned. If "inference" specified, only Custom Inference Models will be returned. If not specified, all custom models will be returned. After deprecation, only Custom Inference Models will be returned |
| isDeployed | query | string | false | If "true" specified, only deployed custom models will be returned. If "false" specified, only not deployed custom models will be returned. If not specified, all custom models will be returned. |
| orderBy | query | string | false | Sort order which will be applied to custom model list, valid options are "created", "updated". Prefix the attribute name with a dash to sort in descending order, e.g. orderBy="-created". By default, the orderBy parameter is None which will result in custom models being returned in order of creation time descending. |
| searchFor | query | string | false | String to search for occurrence in custom model's description, language and name. Search is case insensitive. If not specified, all custom models will be returned. |
Enumerated Values¶
| Parameter | Value |
|---|---|
| customModelType | [training, inference] |
| isDeployed | [false, False, true, True] |
| orderBy | [created, -created, updated, -updated] |
Example responses¶
200 Response
{
"count": 0,
"data": [
{
"calibratePredictions": true,
"classLabels": [
"string"
],
"created": "string",
"createdBy": "string",
"customModelType": "training",
"deploymentsCount": 0,
"description": "string",
"desiredMemory": 134217728,
"gitModelVersion": {
"commitUrl": "http://example.com",
"mainBranchCommitSha": "stringstringstringstringstringstringstri",
"pullRequestCommitSha": null,
"refName": "string"
},
"id": "string",
"isTrainingDataForVersionsPermanentlyEnabled": true,
"language": "string",
"latestVersion": {
"baseEnvironmentId": "string",
"baseEnvironmentVersionId": "string",
"created": "string",
"customModelId": "string",
"dependencies": [
{
"constraints": [
{
"constraintType": "<",
"version": "string"
}
],
"extras": "string",
"line": "string",
"lineNumber": 0,
"packageName": "string"
}
],
"description": "string",
"desiredMemory": 134217728,
"gitModelVersion": {
"commitUrl": "http://example.com",
"mainBranchCommitSha": "stringstringstringstringstringstringstri",
"pullRequestCommitSha": null,
"refName": "string"
},
"holdoutData": {
"datasetId": "string",
"datasetName": "string",
"datasetVersionId": "string",
"partitionColumn": "string"
},
"id": "string",
"isFrozen": true,
"items": [
{
"commitSha": "string",
"created": "string",
"fileName": "string",
"filePath": "string",
"fileSource": "string",
"id": "string",
"ref": "string",
"repositoryFilePath": "string",
"repositoryLocation": "string",
"repositoryName": "string",
"storagePath": "string",
"workspaceId": "string"
}
],
"label": "string",
"maximumMemory": 134217728,
"networkEgressPolicy": "NONE",
"replicas": 0,
"requiredMetadata": {},
"requiredMetadataValues": [
{
"fieldName": "string",
"value": "string"
}
],
"requiresHa": true,
"resourceBundleId": "string",
"trainingData": {
"assignmentError": {
"message": "string"
},
"assignmentInProgress": false,
"datasetId": "string",
"datasetName": "string",
"datasetVersionId": "string"
},
"versionMajor": 0,
"versionMinor": 0
},
"maximumMemory": 134217728,
"name": "string",
"negativeClassLabel": "string",
"networkEgressPolicy": "NONE",
"playgroundId": "string",
"positiveClassLabel": "string",
"predictionThreshold": 0,
"replicas": 0,
"requiresHa": true,
"resourceBundleId": "string",
"supportsAnomalyDetection": true,
"supportsBinaryClassification": true,
"supportsRegression": true,
"targetName": "string",
"targetType": "Binary",
"trainingDataAssignmentInProgress": true,
"trainingDataFileName": "string",
"trainingDataPartitionColumn": "string",
"trainingDatasetId": "string",
"trainingDatasetVersionId": "string",
"updated": "string",
"userProvidedId": "string"
}
],
"next": "http://example.com",
"previous": "http://example.com",
"totalCount": 0
}
Responses¶
| Status | Meaning | Description | Schema |
|---|---|---|---|
| 200 | OK | OK. | CustomModelListResponse |
To perform this operation, you must be authenticated by means of one of the following methods:
BearerAuth
POST /api/v2/customModels/¶
Creates a new custom model and returns the newly created metadata record for it.
All custom models must support at least one target type (binaryClassification, regression). Custom inference models can only support a single target type. A regression model is expected to produce predictions that are arbitrary floating-point or integer numbers. A classification model is expected to return predictions with probability scores for each class. For example, a binary classification model might return:
.. code:: Python
{
positiveClassLabel: probability,
negativeClassLabel: 1.0 - probability
}
For Custom Inference Models, the file parameter must be either a tarball or zip archive
containing, at minimum,
a script named start_server.sh. It may contain additional files, including scripts and
precompiled binaries as well as data files. start_server.sh may execute these scripts
and/or binaries. When this script is executed, it is run as part of an Environment
(specified via subsequent API calls), and all included scripts and binaries
can take advantage of any programming language interpreters, compilers, libraries,
or other tools included in the Environment. start_server.sh must be marked as executable
(chmod +x).
When start_server.sh is launched, it must launch and maintain
(in the foreground) a Web server that listens on two URLs:
GET $URL_PREFIX/This route must return a 200 response code with an empty body immediately if the server is ready to respond to prediction requests. Otherwise it should either not accept the request, not respond to the request, or return a 503 response code.-
POST $URL_PREFIX/predict_no_state/This route must accept as input a JSON object of the form:.. code-block:: Python
{ 'X': { 'col1': [...col1_data...], 'col2': [...col2_data...], 'col3': [...col3_data...], ... } }The data lists will all be the same length.
It must return a JSON object of the form:
.. code-block:: Python
{ 'predictions': [...predictions data...] }The predictions data must correspond 1:1 to the rows in the input data lists.
$URL_PREFIXis provided as an environment variable. The Web server process must re-read its value every time the process starts, as it may change. It is an opaque string that is guaranteed to be a valid URL component, but may contain path separators (/).
Code samples¶
# You can also use wget
curl -X POST https://app.datarobot.com/api/v2/customModels/ \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-H "Authorization: Bearer {access-token}"
Body parameter¶
{
"calibratePredictions": "True",
"classLabels": [
"string"
],
"customModelType": "training",
"description": "string",
"desiredMemory": 134217728,
"gitModelVersion": {
"commitUrl": "http://example.com",
"mainBranchCommitSha": "stringstringstringstringstringstringstri",
"pullRequestCommitSha": null,
"refName": "string"
},
"isTrainingDataForVersionsPermanentlyEnabled": true,
"language": "string",
"maximumMemory": 134217728,
"name": "string",
"negativeClassLabel": "string",
"networkEgressPolicy": "NONE",
"playgroundId": "string",
"positiveClassLabel": "string",
"predictionThreshold": 0.5,
"replicas": 0,
"requiresHa": true,
"supportsBinaryClassification": true,
"supportsRegression": true,
"targetName": "string",
"targetType": "Binary",
"userProvidedId": "string"
}
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
| body | body | CustomModelCreate | false | none |
Example responses¶
201 Response
{
"calibratePredictions": true,
"classLabels": [
"string"
],
"created": "string",
"createdBy": "string",
"customModelType": "training",
"deploymentsCount": 0,
"description": "string",
"desiredMemory": 134217728,
"gitModelVersion": {
"commitUrl": "http://example.com",
"mainBranchCommitSha": "stringstringstringstringstringstringstri",
"pullRequestCommitSha": null,
"refName": "string"
},
"id": "string",
"isTrainingDataForVersionsPermanentlyEnabled": true,
"language": "string",
"latestVersion": {
"baseEnvironmentId": "string",
"baseEnvironmentVersionId": "string",
"created": "string",
"customModelId": "string",
"dependencies": [
{
"constraints": [
{
"constraintType": "<",
"version": "string"
}
],
"extras": "string",
"line": "string",
"lineNumber": 0,
"packageName": "string"
}
],
"description": "string",
"desiredMemory": 134217728,
"gitModelVersion": {
"commitUrl": "http://example.com",
"mainBranchCommitSha": "stringstringstringstringstringstringstri",
"pullRequestCommitSha": null,
"refName": "string"
},
"holdoutData": {
"datasetId": "string",
"datasetName": "string",
"datasetVersionId": "string",
"partitionColumn": "string"
},
"id": "string",
"isFrozen": true,
"items": [
{
"commitSha": "string",
"created": "string",
"fileName": "string",
"filePath": "string",
"fileSource": "string",
"id": "string",
"ref": "string",
"repositoryFilePath": "string",
"repositoryLocation": "string",
"repositoryName": "string",
"storagePath": "string",
"workspaceId": "string"
}
],
"label": "string",
"maximumMemory": 134217728,
"networkEgressPolicy": "NONE",
"replicas": 0,
"requiredMetadata": {},
"requiredMetadataValues": [
{
"fieldName": "string",
"value": "string"
}
],
"requiresHa": true,
"resourceBundleId": "string",
"trainingData": {
"assignmentError": {
"message": "string"
},
"assignmentInProgress": false,
"datasetId": "string",
"datasetName": "string",
"datasetVersionId": "string"
},
"versionMajor": 0,
"versionMinor": 0
},
"maximumMemory": 134217728,
"name": "string",
"negativeClassLabel": "string",
"networkEgressPolicy": "NONE",
"playgroundId": "string",
"positiveClassLabel": "string",
"predictionThreshold": 0,
"replicas": 0,
"requiresHa": true,
"resourceBundleId": "string",
"supportsAnomalyDetection": true,
"supportsBinaryClassification": true,
"supportsRegression": true,
"targetName": "string",
"targetType": "Binary",
"trainingDataAssignmentInProgress": true,
"trainingDataFileName": "string",
"trainingDataPartitionColumn": "string",
"trainingDatasetId": "string",
"trainingDatasetVersionId": "string",
"updated": "string",
"userProvidedId": "string"
}
Responses¶
| Status | Meaning | Description | Schema |
|---|---|---|---|
| 201 | Created | Created. | CustomModelResponse |
| 403 | Forbidden | Custom model creation is not enabled. | None |
| 422 | Unprocessable Entity | Input parameters are invalid. | None |
To perform this operation, you must be authenticated by means of one of the following methods:
BearerAuth
POST /api/v2/customModels/fromCustomModel/¶
Creates a copy of the provided custom model, including metadata, versions of that model, and uploaded files. Associates the new versions with files owned by the custom model.
Code samples¶
# You can also use wget
curl -X POST https://app.datarobot.com/api/v2/customModels/fromCustomModel/ \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-H "Authorization: Bearer {access-token}"
Body parameter¶
{
"customModelId": "string"
}
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
| body | body | CustomModelCopy | false | none |
Example responses¶
201 Response
{
"calibratePredictions": true,
"classLabels": [
"string"
],
"created": "string",
"createdBy": "string",
"customModelType": "training",
"deploymentsCount": 0,
"description": "string",
"desiredMemory": 134217728,
"gitModelVersion": {
"commitUrl": "http://example.com",
"mainBranchCommitSha": "stringstringstringstringstringstringstri",
"pullRequestCommitSha": null,
"refName": "string"
},
"id": "string",
"isTrainingDataForVersionsPermanentlyEnabled": true,
"language": "string",
"latestVersion": {
"baseEnvironmentId": "string",
"baseEnvironmentVersionId": "string",
"created": "string",
"customModelId": "string",
"dependencies": [
{
"constraints": [
{
"constraintType": "<",
"version": "string"
}
],
"extras": "string",
"line": "string",
"lineNumber": 0,
"packageName": "string"
}
],
"description": "string",
"desiredMemory": 134217728,
"gitModelVersion": {
"commitUrl": "http://example.com",
"mainBranchCommitSha": "stringstringstringstringstringstringstri",
"pullRequestCommitSha": null,
"refName": "string"
},
"holdoutData": {
"datasetId": "string",
"datasetName": "string",
"datasetVersionId": "string",
"partitionColumn": "string"
},
"id": "string",
"isFrozen": true,
"items": [
{
"commitSha": "string",
"created": "string",
"fileName": "string",
"filePath": "string",
"fileSource": "string",
"id": "string",
"ref": "string",
"repositoryFilePath": "string",
"repositoryLocation": "string",
"repositoryName": "string",
"storagePath": "string",
"workspaceId": "string"
}
],
"label": "string",
"maximumMemory": 134217728,
"networkEgressPolicy": "NONE",
"replicas": 0,
"requiredMetadata": {},
"requiredMetadataValues": [
{
"fieldName": "string",
"value": "string"
}
],
"requiresHa": true,
"resourceBundleId": "string",
"trainingData": {
"assignmentError": {
"message": "string"
},
"assignmentInProgress": false,
"datasetId": "string",
"datasetName": "string",
"datasetVersionId": "string"
},
"versionMajor": 0,
"versionMinor": 0
},
"maximumMemory": 134217728,
"name": "string",
"negativeClassLabel": "string",
"networkEgressPolicy": "NONE",
"playgroundId": "string",
"positiveClassLabel": "string",
"predictionThreshold": 0,
"replicas": 0,
"requiresHa": true,
"resourceBundleId": "string",
"supportsAnomalyDetection": true,
"supportsBinaryClassification": true,
"supportsRegression": true,
"targetName": "string",
"targetType": "Binary",
"trainingDataAssignmentInProgress": true,
"trainingDataFileName": "string",
"trainingDataPartitionColumn": "string",
"trainingDatasetId": "string",
"trainingDatasetVersionId": "string",
"updated": "string",
"userProvidedId": "string"
}
Responses¶
| Status | Meaning | Description | Schema |
|---|---|---|---|
| 201 | Created | Successfully created copy. | CustomModelResponse |
To perform this operation, you must be authenticated by means of one of the following methods:
BearerAuth
POST /api/v2/customModels/predictionExplanationsInitialization/¶
Create a new prediction explanations initialization for custom model. This is a necessary prerequisite for generating prediction explanations.
.. minversion:: v2.23 DEPRECATED please use custom model version route instead: POST /api/v2/customModels/{customModelId}/versions/{customModelVersionId}/predictionExplanationsInitialization/
Code samples¶
# You can also use wget
curl -X POST https://app.datarobot.com/api/v2/customModels/predictionExplanationsInitialization/ \
-H "Content-Type: application/json" \
-H "Authorization: Bearer {access-token}"
Body parameter¶
{
"customModelId": "string",
"customModelVersionId": "string",
"environmentId": "string",
"environmentVersionId": "string"
}
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
| body | body | CustomModelPredictionExplanations | false | none |
Responses¶
| Status | Meaning | Description | Schema |
|---|---|---|---|
| 202 | Accepted | The request was accepted and will be worked on. | None |
| 422 | Unprocessable Entity | Specified custom model is not valid for prediction explanations. | None |
Response Headers¶
| Status | Header | Type | Format | Description |
|---|---|---|---|---|
| 202 | Location | string | URL to poll to track the prediction explanation initialization has finished. |
To perform this operation, you must be authenticated by means of one of the following methods:
BearerAuth
DELETE /api/v2/customModels/{customModelId}/¶
Delete a custom model. Only users who have permission to edit custom model can delete it. Only custom models which are not currently deployed or undergoing custom model testing can be deleted. Relevant CustomModelImage will be deleted also.
Code samples¶
# You can also use wget
curl -X DELETE https://app.datarobot.com/api/v2/customModels/{customModelId}/ \
-H "Authorization: Bearer {access-token}"
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
| customModelId | path | string | true | ID of the custom model. |
Responses¶
| Status | Meaning | Description | Schema |
|---|---|---|---|
| 204 | No Content | Record deleted. | None |
| 409 | Conflict | This custom model is currently deployed and cannot be deleted. The response body will contain link where those deployments can be retrieved. | None |
To perform this operation, you must be authenticated by means of one of the following methods:
BearerAuth
GET /api/v2/customModels/{customModelId}/¶
Retrieve metadata for a custom model.
Code samples¶
# You can also use wget
curl -X GET https://app.datarobot.com/api/v2/customModels/{customModelId}/ \
-H "Accept: application/json" \
-H "Authorization: Bearer {access-token}"
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
| customModelId | path | string | true | ID of the custom model. |
Example responses¶
200 Response
{
"calibratePredictions": true,
"classLabels": [
"string"
],
"created": "string",
"createdBy": "string",
"customModelType": "training",
"deploymentsCount": 0,
"description": "string",
"desiredMemory": 134217728,
"gitModelVersion": {
"commitUrl": "http://example.com",
"mainBranchCommitSha": "stringstringstringstringstringstringstri",
"pullRequestCommitSha": null,
"refName": "string"
},
"id": "string",
"isTrainingDataForVersionsPermanentlyEnabled": true,
"language": "string",
"latestVersion": {
"baseEnvironmentId": "string",
"baseEnvironmentVersionId": "string",
"created": "string",
"customModelId": "string",
"dependencies": [
{
"constraints": [
{
"constraintType": "<",
"version": "string"
}
],
"extras": "string",
"line": "string",
"lineNumber": 0,
"packageName": "string"
}
],
"description": "string",
"desiredMemory": 134217728,
"gitModelVersion": {
"commitUrl": "http://example.com",
"mainBranchCommitSha": "stringstringstringstringstringstringstri",
"pullRequestCommitSha": null,
"refName": "string"
},
"holdoutData": {
"datasetId": "string",
"datasetName": "string",
"datasetVersionId": "string",
"partitionColumn": "string"
},
"id": "string",
"isFrozen": true,
"items": [
{
"commitSha": "string",
"created": "string",
"fileName": "string",
"filePath": "string",
"fileSource": "string",
"id": "string",
"ref": "string",
"repositoryFilePath": "string",
"repositoryLocation": "string",
"repositoryName": "string",
"storagePath": "string",
"workspaceId": "string"
}
],
"label": "string",
"maximumMemory": 134217728,
"networkEgressPolicy": "NONE",
"replicas": 0,
"requiredMetadata": {},
"requiredMetadataValues": [
{
"fieldName": "string",
"value": "string"
}
],
"requiresHa": true,
"resourceBundleId": "string",
"trainingData": {
"assignmentError": {
"message": "string"
},
"assignmentInProgress": false,
"datasetId": "string",
"datasetName": "string",
"datasetVersionId": "string"
},
"versionMajor": 0,
"versionMinor": 0
},
"maximumMemory": 134217728,
"name": "string",
"negativeClassLabel": "string",
"networkEgressPolicy": "NONE",
"playgroundId": "string",
"positiveClassLabel": "string",
"predictionThreshold": 0,
"replicas": 0,
"requiresHa": true,
"resourceBundleId": "string",
"supportsAnomalyDetection": true,
"supportsBinaryClassification": true,
"supportsRegression": true,
"targetName": "string",
"targetType": "Binary",
"trainingDataAssignmentInProgress": true,
"trainingDataFileName": "string",
"trainingDataPartitionColumn": "string",
"trainingDatasetId": "string",
"trainingDatasetVersionId": "string",
"updated": "string",
"userProvidedId": "string"
}
Responses¶
| Status | Meaning | Description | Schema |
|---|---|---|---|
| 200 | OK | OK. | CustomModelResponse |
To perform this operation, you must be authenticated by means of one of the following methods:
BearerAuth
PATCH /api/v2/customModels/{customModelId}/¶
Updates metadata for an existing custom model.
All custom models must support at least one target type (binaryClassification, regression). Custom inference models can only support a single target type.
Setting positiveClassLabel and negativeClassLabel to null will set
the labels to their default values (1 and 0 for positiveClassLabel and negativeClassLabel,
respectively).
Setting positiveClassLabel, negativeClassLabel, 'targetName` is disabled if model
has active deployments or assigned training data.
Code samples¶
# You can also use wget
curl -X PATCH https://app.datarobot.com/api/v2/customModels/{customModelId}/ \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-H "Authorization: Bearer {access-token}"
Body parameter¶
{
"classLabels": [
"string"
],
"description": "string",
"desiredMemory": 134217728,
"gitModelVersion": {
"commitUrl": "http://example.com",
"mainBranchCommitSha": "stringstringstringstringstringstringstri",
"pullRequestCommitSha": null,
"refName": "string"
},
"isTrainingDataForVersionsPermanentlyEnabled": true,
"language": "string",
"maximumMemory": 134217728,
"name": "string",
"negativeClassLabel": "string",
"networkEgressPolicy": "NONE",
"positiveClassLabel": "string",
"predictionThreshold": 0.5,
"replicas": 0,
"requiresHa": true,
"targetName": "string"
}
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
| customModelId | path | string | true | ID of the custom model. |
| body | body | CustomModelUpdate | false | none |
Example responses¶
201 Response
{
"calibratePredictions": true,
"classLabels": [
"string"
],
"created": "string",
"createdBy": "string",
"customModelType": "training",
"deploymentsCount": 0,
"description": "string",
"desiredMemory": 134217728,
"gitModelVersion": {
"commitUrl": "http://example.com",
"mainBranchCommitSha": "stringstringstringstringstringstringstri",
"pullRequestCommitSha": null,
"refName": "string"
},
"id": "string",
"isTrainingDataForVersionsPermanentlyEnabled": true,
"language": "string",
"latestVersion": {
"baseEnvironmentId": "string",
"baseEnvironmentVersionId": "string",
"created": "string",
"customModelId": "string",
"dependencies": [
{
"constraints": [
{
"constraintType": "<",
"version": "string"
}
],
"extras": "string",
"line": "string",
"lineNumber": 0,
"packageName": "string"
}
],
"description": "string",
"desiredMemory": 134217728,
"gitModelVersion": {
"commitUrl": "http://example.com",
"mainBranchCommitSha": "stringstringstringstringstringstringstri",
"pullRequestCommitSha": null,
"refName": "string"
},
"holdoutData": {
"datasetId": "string",
"datasetName": "string",
"datasetVersionId": "string",
"partitionColumn": "string"
},
"id": "string",
"isFrozen": true,
"items": [
{
"commitSha": "string",
"created": "string",
"fileName": "string",
"filePath": "string",
"fileSource": "string",
"id": "string",
"ref": "string",
"repositoryFilePath": "string",
"repositoryLocation": "string",
"repositoryName": "string",
"storagePath": "string",
"workspaceId": "string"
}
],
"label": "string",
"maximumMemory": 134217728,
"networkEgressPolicy": "NONE",
"replicas": 0,
"requiredMetadata": {},
"requiredMetadataValues": [
{
"fieldName": "string",
"value": "string"
}
],
"requiresHa": true,
"resourceBundleId": "string",
"trainingData": {
"assignmentError": {
"message": "string"
},
"assignmentInProgress": false,
"datasetId": "string",
"datasetName": "string",
"datasetVersionId": "string"
},
"versionMajor": 0,
"versionMinor": 0
},
"maximumMemory": 134217728,
"name": "string",
"negativeClassLabel": "string",
"networkEgressPolicy": "NONE",
"playgroundId": "string",
"positiveClassLabel": "string",
"predictionThreshold": 0,
"replicas": 0,
"requiresHa": true,
"resourceBundleId": "string",
"supportsAnomalyDetection": true,
"supportsBinaryClassification": true,
"supportsRegression": true,
"targetName": "string",
"targetType": "Binary",
"trainingDataAssignmentInProgress": true,
"trainingDataFileName": "string",
"trainingDataPartitionColumn": "string",
"trainingDatasetId": "string",
"trainingDatasetVersionId": "string",
"updated": "string",
"userProvidedId": "string"
}
Responses¶
| Status | Meaning | Description | Schema |
|---|---|---|---|
| 201 | Created | Created. | CustomModelResponse |
| 403 | Forbidden | Custom inference model modification is not enabled for the user. | None |
| 409 | Conflict | Custom model cannot be updated while it is being validated or some fields cannot be updated after deployment or assigning training data. | None |
| 422 | Unprocessable Entity | Input parameters are invalid. | None |
To perform this operation, you must be authenticated by means of one of the following methods:
BearerAuth
GET /api/v2/customModels/{customModelId}/accessControl/¶
Get a list of users who have access to this custom model and their roles on it.
Code samples¶
# You can also use wget
curl -X GET https://app.datarobot.com/api/v2/customModels/{customModelId}/accessControl/?offset=0&limit=1000 \
-H "Accept: application/json" \
-H "Authorization: Bearer {access-token}"
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
| offset | query | integer | true | This many results will be skipped. |
| limit | query | integer | true | At most this many results are returned. |
| customModelId | path | string | true | ID of the custom model. |
Example responses¶
200 Response
{
"count": 0,
"data": [
{
"canShare": true,
"role": "string",
"userId": "string",
"username": "string"
}
],
"next": "http://example.com",
"previous": "http://example.com"
}
Responses¶
| Status | Meaning | Description | Schema |
|---|---|---|---|
| 200 | OK | A list of users who have access to this custom model and their roles on it. | CustomModelAccessControlListResponse |
| 400 | Bad Request | Both username and userId were specified. | None |
To perform this operation, you must be authenticated by means of one of the following methods:
BearerAuth
PATCH /api/v2/customModels/{customModelId}/accessControl/¶
Grant access or update roles for users on this custom model and appropriate learning data. Up to 100 user roles may be set in a single request.
Code samples¶
# You can also use wget
curl -X PATCH https://app.datarobot.com/api/v2/customModels/{customModelId}/accessControl/ \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-H "Authorization: Bearer {access-token}"
Body parameter¶
{
"data": [
{
"canShare": true,
"role": "ADMIN",
"username": "string"
}
]
}
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
| customModelId | path | string | true | ID of the custom model. |
| body | body | SharingUpdateOrRemoveWithGrant | false | none |
Example responses¶
204 Response
{
"data": [
{
"canShare": true,
"role": "string",
"userId": "string",
"username": "string"
}
]
}
Responses¶
| Status | Meaning | Description | Schema |
|---|---|---|---|
| 204 | No Content | Roles updated successfully. | CustomModelAccessControlUpdateResponse |
| 409 | Conflict | The request would leave the custom model without an owner. | None |
| 422 | Unprocessable Entity | One of the users in the request does not exist, or the request is otherwise invalid. | None |
To perform this operation, you must be authenticated by means of one of the following methods:
BearerAuth
GET /api/v2/customModels/{customModelId}/download/¶
Download the latest item bundle from a custom model as a zip compressed archive.
Code samples¶
# You can also use wget
curl -X GET https://app.datarobot.com/api/v2/customModels/{customModelId}/download/ \
-H "Authorization: Bearer {access-token}"
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
| pps | query | string | false | Download model version from PPS tab.If "true" specified, model archive includes dependencies install script. If "false" specified, dependencies script is not included. If not specified -> "false" behavior. |
| customModelId | path | string | true | ID of the custom model. |
Enumerated Values¶
| Parameter | Value |
|---|---|
| pps | [false, False, true, True] |
Responses¶
| Status | Meaning | Description | Schema |
|---|---|---|---|
| 200 | OK | The download succeeded. | None |
Response Headers¶
| Status | Header | Type | Format | Description |
|---|---|---|---|---|
| 200 | Content-Disposition | string | Contains an auto generated filename for this download ("attachment;filename=model- |
To perform this operation, you must be authenticated by means of one of the following methods:
BearerAuth
PATCH /api/v2/customModels/{customModelId}/trainingData/¶
The current API is deprecated and scheduled for removal in v2.34. Training data assignment is implemented in CustomModelVersionCreateController and CustomModelVersionCreateFromLatestController.
Assigns the specified dataset to the specified custom model as training data. For each of the custom model's deployments, the training data from the specified project provides a baseline to enable drift tracking. The API is disabled and returns HTTP 422 when a custom model is converted to assign training data at the version level. See isTrainingDataForVersionsPermanentlyEnabled parameter for POST /api/v2/customModels/ and PATCH /api/v2/customModels/{customModelId}/ Use training data assignment at the version level: POST /api/v2/customModels/{customModelId}/versions/ PATCH /api/v2/customModels/{customModelId}/versions/
Code samples¶
# You can also use wget
curl -X PATCH https://app.datarobot.com/api/v2/customModels/{customModelId}/trainingData/ \
-H "Content-Type: application/json" \
-H "Authorization: Bearer {access-token}"
Body parameter¶
{
"datasetId": "string",
"datasetName": "string",
"datasetVersionId": "string",
"partitionColumn": "string"
}
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
| customModelId | path | string | true | ID of the custom model. |
| body | body | DeprecatedTrainingDataForModelsAssignment | false | none |
Responses¶
| Status | Meaning | Description | Schema |
|---|---|---|---|
| 202 | Accepted | The request was accepted and will be worked on. | None |
| 409 | Conflict | Custom model has assigned training data already and is deployed. | None |
| 410 | Gone | The requested Dataset has been deleted. | None |
| 422 | Unprocessable Entity | Dataset ingest must finish before assigning training data or provided dataset is incompatible with the custom model. | None |
Response Headers¶
| Status | Header | Type | Format | Description |
|---|---|---|---|---|
| 202 | Location | string | URL to poll to track the training data assignment has finished. |
To perform this operation, you must be authenticated by means of one of the following methods:
BearerAuth
GET /api/v2/customModels/{customModelId}/versions/¶
List custom model versions.
Code samples¶
# You can also use wget
curl -X GET https://app.datarobot.com/api/v2/customModels/{customModelId}/versions/?offset=0&limit=1000 \
-H "Accept: application/json" \
-H "Authorization: Bearer {access-token}"
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
| offset | query | integer | true | This many results will be skipped. |
| limit | query | integer | true | At most this many results are returned. |
| mainBranchCommitSha | query | string | false | Specifies the commit SHA-1 in GitHub repository from the main branch that corresponds to a given custom model version. |
| customModelId | path | string | true | ID of the custom model. |
Example responses¶
200 Response
{
"count": 0,
"data": [
{
"baseEnvironmentId": "string",
"baseEnvironmentVersionId": "string",
"created": "string",
"customModelId": "string",
"dependencies": [
{
"constraints": [
{
"constraintType": "<",
"version": "string"
}
],
"extras": "string",
"line": "string",
"lineNumber": 0,
"packageName": "string"
}
],
"description": "string",
"desiredMemory": 134217728,
"gitModelVersion": {
"commitUrl": "http://example.com",
"mainBranchCommitSha": "stringstringstringstringstringstringstri",
"pullRequestCommitSha": null,
"refName": "string"
},
"holdoutData": {
"datasetId": "string",
"datasetName": "string",
"datasetVersionId": "string",
"partitionColumn": "string"
},
"id": "string",
"isFrozen": true,
"items": [
{
"commitSha": "string",
"created": "string",
"fileName": "string",
"filePath": "string",
"fileSource": "string",
"id": "string",
"ref": "string",
"repositoryFilePath": "string",
"repositoryLocation": "string",
"repositoryName": "string",
"storagePath": "string",
"workspaceId": "string"
}
],
"label": "string",
"maximumMemory": 134217728,
"networkEgressPolicy": "NONE",
"replicas": 0,
"requiredMetadata": {},
"requiredMetadataValues": [
{
"fieldName": "string",
"value": "string"
}
],
"requiresHa": true,
"resourceBundleId": "string",
"trainingData": {
"assignmentError": {
"message": "string"
},
"assignmentInProgress": false,
"datasetId": "string",
"datasetName": "string",
"datasetVersionId": "string"
},
"versionMajor": 0,
"versionMinor": 0
}
],
"next": "http://example.com",
"previous": "http://example.com",
"totalCount": 0
}
Responses¶
| Status | Meaning | Description | Schema |
|---|---|---|---|
| 200 | OK | OK. | CustomModelVersionListResponse |
| 400 | Bad Request | Query parameters are invalid. | None |
| 422 | Unprocessable Entity | Input parameters are invalid. | None |
To perform this operation, you must be authenticated by means of one of the following methods:
BearerAuth
PATCH /api/v2/customModels/{customModelId}/versions/¶
Create a new custom model version with files added, replaced or deleted. Files from the previous version of a custom models will be used as a basis.
Code samples¶
# You can also use wget
curl -X PATCH https://app.datarobot.com/api/v2/customModels/{customModelId}/versions/ \
-H "Content-Type: multipart/form-data" \
-H "Accept: application/json" \
-H "Authorization: Bearer {access-token}"
Body parameter¶
baseEnvironmentId: string
baseEnvironmentVersionId: string
desiredMemory: 134217728
file: string
filePath: string
filesToDelete: string
gitModelVersion:
commitUrl: http://example.com
mainBranchCommitSha: stringstringstringstringstringstringstri
pullRequestCommitSha: null
refName: string
holdoutData: string
isMajorUpdate: "false"
keepTrainingHoldoutData: "true"
maximumMemory: 134217728
networkEgressPolicy: NONE
replicas: 0
requiredMetadata: string
requiredMetadataValues: string
requiresHa: true
resourceBundleId: string
trainingData: string
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
| customModelId | path | string | true | ID of the custom model. |
| body | body | CustomModelVersionCreateFromLatest | false | none |
Example responses¶
201 Response
{
"baseEnvironmentId": "string",
"baseEnvironmentVersionId": "string",
"created": "string",
"customModelId": "string",
"dependencies": [
{
"constraints": [
{
"constraintType": "<",
"version": "string"
}
],
"extras": "string",
"line": "string",
"lineNumber": 0,
"packageName": "string"
}
],
"description": "string",
"desiredMemory": 134217728,
"gitModelVersion": {
"commitUrl": "http://example.com",
"mainBranchCommitSha": "stringstringstringstringstringstringstri",
"pullRequestCommitSha": null,
"refName": "string"
},
"holdoutData": {
"datasetId": "string",
"datasetName": "string",
"datasetVersionId": "string",
"partitionColumn": "string"
},
"id": "string",
"isFrozen": true,
"items": [
{
"commitSha": "string",
"created": "string",
"fileName": "string",
"filePath": "string",
"fileSource": "string",
"id": "string",
"ref": "string",
"repositoryFilePath": "string",
"repositoryLocation": "string",
"repositoryName": "string",
"storagePath": "string",
"workspaceId": "string"
}
],
"label": "string",
"maximumMemory": 134217728,
"networkEgressPolicy": "NONE",
"replicas": 0,
"requiredMetadata": {},
"requiredMetadataValues": [
{
"fieldName": "string",
"value": "string"
}
],
"requiresHa": true,
"resourceBundleId": "string",
"trainingData": {
"assignmentError": {
"message": "string"
},
"assignmentInProgress": false,
"datasetId": "string",
"datasetName": "string",
"datasetVersionId": "string"
},
"versionMajor": 0,
"versionMinor": 0
}
Responses¶
| Status | Meaning | Description | Schema |
|---|---|---|---|
| 201 | Created | Item successfully created. | CustomModelVersionResponse |
| 403 | Forbidden | User does not have permissions to use requested Dataset | None |
| 404 | Not Found | Either custom model or dataset not found or user does not have edit permissions. | None |
| 413 | Payload Too Large | Item or collection of items was too large in size (bytes). | None |
| 422 | Unprocessable Entity | Cannot create the custom task version due to one or more errors. All error responses will have a "message" field and some may have optional fields. The optional fields include: ["errors", "dependencies", "invalidDependencies"] | None |
To perform this operation, you must be authenticated by means of one of the following methods:
BearerAuth
POST /api/v2/customModels/{customModelId}/versions/¶
Create a new custom model version with attached files if supplied.
Code samples¶
# You can also use wget
curl -X POST https://app.datarobot.com/api/v2/customModels/{customModelId}/versions/ \
-H "Content-Type: multipart/form-data" \
-H "Accept: application/json" \
-H "Authorization: Bearer {access-token}"
Body parameter¶
baseEnvironmentId: string
baseEnvironmentVersionId: string
desiredMemory: 134217728
file: string
filePath: string
gitModelVersion:
commitUrl: http://example.com
mainBranchCommitSha: stringstringstringstringstringstringstri
pullRequestCommitSha: null
refName: string
holdoutData: string
isMajorUpdate: "false"
keepTrainingHoldoutData: "true"
maximumMemory: 134217728
networkEgressPolicy: NONE
replicas: 0
requiredMetadata: string
requiredMetadataValues: string
requiresHa: true
resourceBundleId: string
trainingData: string
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
| customModelId | path | string | true | ID of the custom model. |
| body | body | CustomModelVersionCreate | false | none |
Example responses¶
201 Response
{
"baseEnvironmentId": "string",
"baseEnvironmentVersionId": "string",
"created": "string",
"customModelId": "string",
"dependencies": [
{
"constraints": [
{
"constraintType": "<",
"version": "string"
}
],
"extras": "string",
"line": "string",
"lineNumber": 0,
"packageName": "string"
}
],
"description": "string",
"desiredMemory": 134217728,
"gitModelVersion": {
"commitUrl": "http://example.com",
"mainBranchCommitSha": "stringstringstringstringstringstringstri",
"pullRequestCommitSha": null,
"refName": "string"
},
"holdoutData": {
"datasetId": "string",
"datasetName": "string",
"datasetVersionId": "string",
"partitionColumn": "string"
},
"id": "string",
"isFrozen": true,
"items": [
{
"commitSha": "string",
"created": "string",
"fileName": "string",
"filePath": "string",
"fileSource": "string",
"id": "string",
"ref": "string",
"repositoryFilePath": "string",
"repositoryLocation": "string",
"repositoryName": "string",
"storagePath": "string",
"workspaceId": "string"
}
],
"label": "string",
"maximumMemory": 134217728,
"networkEgressPolicy": "NONE",
"replicas": 0,
"requiredMetadata": {},
"requiredMetadataValues": [
{
"fieldName": "string",
"value": "string"
}
],
"requiresHa": true,
"resourceBundleId": "string",
"trainingData": {
"assignmentError": {
"message": "string"
},
"assignmentInProgress": false,
"datasetId": "string",
"datasetName": "string",
"datasetVersionId": "string"
},
"versionMajor": 0,
"versionMinor": 0
}
Responses¶
| Status | Meaning | Description | Schema |
|---|---|---|---|
| 201 | Created | Item successfully created. | CustomModelVersionResponse |
| 403 | Forbidden | User does not have permissions to use requested Dataset | None |
| 404 | Not Found | Either custom model or dataset not found or user does not have edit permissions. | None |
| 413 | Payload Too Large | Item or collection of items was too large in size (bytes). | None |
| 422 | Unprocessable Entity | Cannot create the custom task version due to one or more errors. All error responses will have a "message" field and some may have optional fields. The optional fields include: ["errors", "dependencies", "invalidDependencies"] | None |
To perform this operation, you must be authenticated by means of one of the following methods:
BearerAuth
PATCH /api/v2/customModels/{customModelId}/versions/fromRepository/¶
Create a new custom model version with files added from a remote repository. Files from the previous version of a custom models will be used as a basis.
Code samples¶
# You can also use wget
curl -X PATCH https://app.datarobot.com/api/v2/customModels/{customModelId}/versions/fromRepository/ \
-H "Content-Type: application/json" \
-H "Authorization: Bearer {access-token}"
Body parameter¶
{
"baseEnvironmentId": "string",
"isMajorUpdate": true,
"keepTrainingHoldoutData": "true",
"ref": "string",
"repositoryId": "string",
"requiredMetadata": {},
"requiredMetadataValues": [
{
"fieldName": "string",
"value": "string"
}
],
"sourcePath": "string"
}
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
| customModelId | path | string | true | ID of the custom model. |
| body | body | CustomModelVersionCreateFromRepository | false | none |
Responses¶
| Status | Meaning | Description | Schema |
|---|---|---|---|
| 202 | Accepted | Accepted: request placed to a queue for processing. | None |
| 422 | Unprocessable Entity | Custom Model version cannot be created: (1) input parameters are invalid, (2) if user does not have permission to create legacy conversion environment. | None |
Response Headers¶
| Status | Header | Type | Format | Description |
|---|---|---|---|---|
| 202 | Location | string | URL for tracking async job status. |
To perform this operation, you must be authenticated by means of one of the following methods:
BearerAuth
POST /api/v2/customModels/{customModelId}/versions/fromRepository/¶
Create a new custom model version with only files added from the specified remote repository.
Code samples¶
# You can also use wget
curl -X POST https://app.datarobot.com/api/v2/customModels/{customModelId}/versions/fromRepository/ \
-H "Content-Type: application/json" \
-H "Authorization: Bearer {access-token}"
Body parameter¶
{
"baseEnvironmentId": "string",
"isMajorUpdate": true,
"keepTrainingHoldoutData": "true",
"ref": "string",
"repositoryId": "string",
"requiredMetadata": {},
"requiredMetadataValues": [
{
"fieldName": "string",
"value": "string"
}
],
"sourcePath": "string"
}
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
| customModelId | path | string | true | ID of the custom model. |
| body | body | CustomModelVersionCreateFromRepository | false | none |
Responses¶
| Status | Meaning | Description | Schema |
|---|---|---|---|
| 202 | Accepted | Accepted: request placed to a queue for processing. | None |
| 422 | Unprocessable Entity | Custom Model version cannot be created: (1) input parameters are invalid, (2) if user does not have permission to create legacy conversion environment. | None |
Response Headers¶
| Status | Header | Type | Format | Description |
|---|---|---|---|---|
| 202 | Location | string | URL for tracking async job status. |
To perform this operation, you must be authenticated by means of one of the following methods:
BearerAuth
PATCH /api/v2/customModels/{customModelId}/versions/withTrainingData/¶
Current API is deprecated and will be removed in v2.33. Training data assignment is implemented in CustomModelVersionCreateController and CustomModelVersionCreateFromLatestController.
Creates a new custom model version (bumping it up a minor version) with the specified training and holdout data. This functionality has to be explicitly enabled for the current model. See isTrainingDataForVersionsPermanentlyEnabled parameter for POST /api/v2/customModels/ and PATCH /api/v2/customModels/{customModelId}/ This API is going to be deprecated. Use model version creation APIs to assign training data at the version level: POST /api/v2/customModels/{customModelId}/versions/ PATCH /api/v2/customModels/{customModelId}/versions/
Code samples¶
# You can also use wget
curl -X PATCH https://app.datarobot.com/api/v2/customModels/{customModelId}/versions/withTrainingData/ \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-H "Authorization: Bearer {access-token}"
Body parameter¶
{
"gitModelVersion": {
"commitUrl": "http://example.com",
"mainBranchCommitSha": "stringstringstringstringstringstringstri",
"pullRequestCommitSha": null,
"refName": "string"
},
"holdoutData": {
"datasetId": "string",
"datasetName": "string",
"datasetVersionId": "string",
"partitionColumn": "string"
},
"trainingData": {
"assignmentInProgress": false,
"datasetId": "string",
"datasetName": "string",
"datasetVersionId": "string"
}
}
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
| customModelId | path | string | true | ID of the custom model. |
| body | body | DeprecatedCustomModelVersionTrainingDataUpdate | false | none |
Example responses¶
202 Response
{
"baseEnvironmentId": "string",
"baseEnvironmentVersionId": "string",
"created": "string",
"customModelId": "string",
"dependencies": [
{
"constraints": [
{
"constraintType": "<",
"version": "string"
}
],
"extras": "string",
"line": "string",
"lineNumber": 0,
"packageName": "string"
}
],
"description": "string",
"desiredMemory": 134217728,
"gitModelVersion": {
"commitUrl": "http://example.com",
"mainBranchCommitSha": "stringstringstringstringstringstringstri",
"pullRequestCommitSha": null,
"refName": "string"
},
"holdoutData": {
"datasetId": "string",
"datasetName": "string",
"datasetVersionId": "string",
"partitionColumn": "string"
},
"id": "string",
"isFrozen": true,
"items": [
{
"commitSha": "string",
"created": "string",
"fileName": "string",
"filePath": "string",
"fileSource": "string",
"id": "string",
"ref": "string",
"repositoryFilePath": "string",
"repositoryLocation": "string",
"repositoryName": "string",
"storagePath": "string",
"workspaceId": "string"
}
],
"label": "string",
"maximumMemory": 134217728,
"networkEgressPolicy": "NONE",
"replicas": 0,
"requiredMetadata": {},
"requiredMetadataValues": [
{
"fieldName": "string",
"value": "string"
}
],
"requiresHa": true,
"resourceBundleId": "string",
"trainingData": {
"assignmentError": {
"message": "string"
},
"assignmentInProgress": false,
"datasetId": "string",
"datasetName": "string",
"datasetVersionId": "string"
},
"versionMajor": 0,
"versionMinor": 0
}
Responses¶
| Status | Meaning | Description | Schema |
|---|---|---|---|
| 202 | Accepted | The request was accepted and will be worked on. | CustomModelVersionResponse |
| 404 | Not Found | Custom model not found or user does not have edit permissions. | None |
| 410 | Gone | The requested Dataset has been deleted. | None |
| 422 | Unprocessable Entity | Cannot update custom model training data. | None |
Response Headers¶
| Status | Header | Type | Format | Description |
|---|---|---|---|---|
| 202 | Location | string | URL to poll to track the training data assignment has finished. |
To perform this operation, you must be authenticated by means of one of the following methods:
BearerAuth
GET /api/v2/customModels/{customModelId}/versions/{customModelVersionId}/¶
Display a requested version of a custom model along with the files attached to it.
Code samples¶
# You can also use wget
curl -X GET https://app.datarobot.com/api/v2/customModels/{customModelId}/versions/{customModelVersionId}/ \
-H "Accept: application/json" \
-H "Authorization: Bearer {access-token}"
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
| customModelId | path | string | true | ID of the custom model. |
| customModelVersionId | path | string | true | ID of the custom model version. |
Example responses¶
200 Response
{
"baseEnvironmentId": "string",
"baseEnvironmentVersionId": "string",
"created": "string",
"customModelId": "string",
"dependencies": [
{
"constraints": [
{
"constraintType": "<",
"version": "string"
}
],
"extras": "string",
"line": "string",
"lineNumber": 0,
"packageName": "string"
}
],
"description": "string",
"desiredMemory": 134217728,
"gitModelVersion": {
"commitUrl": "http://example.com",
"mainBranchCommitSha": "stringstringstringstringstringstringstri",
"pullRequestCommitSha": null,
"refName": "string"
},
"holdoutData": {
"datasetId": "string",
"datasetName": "string",
"datasetVersionId": "string",
"partitionColumn": "string"
},
"id": "string",
"isFrozen": true,
"items": [
{
"commitSha": "string",
"created": "string",
"fileName": "string",
"filePath": "string",
"fileSource": "string",
"id": "string",
"ref": "string",
"repositoryFilePath": "string",
"repositoryLocation": "string",
"repositoryName": "string",
"storagePath": "string",
"workspaceId": "string"
}
],
"label": "string",
"maximumMemory": 134217728,
"networkEgressPolicy": "NONE",
"replicas": 0,
"requiredMetadata": {},
"requiredMetadataValues": [
{
"fieldName": "string",
"value": "string"
}
],
"requiresHa": true,
"resourceBundleId": "string",
"trainingData": {
"assignmentError": {
"message": "string"
},
"assignmentInProgress": false,
"datasetId": "string",
"datasetName": "string",
"datasetVersionId": "string"
},
"versionMajor": 0,
"versionMinor": 0
}
Responses¶
| Status | Meaning | Description | Schema |
|---|---|---|---|
| 200 | OK | OK. | CustomModelVersionResponse |
To perform this operation, you must be authenticated by means of one of the following methods:
BearerAuth
PATCH /api/v2/customModels/{customModelId}/versions/{customModelVersionId}/¶
Edit metadata of a specific model version.
Code samples¶
# You can also use wget
curl -X PATCH https://app.datarobot.com/api/v2/customModels/{customModelId}/versions/{customModelVersionId}/ \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-H "Authorization: Bearer {access-token}"
Body parameter¶
{
"description": "string",
"gitModelVersion": {
"commitUrl": "http://example.com",
"mainBranchCommitSha": "stringstringstringstringstringstringstri",
"pullRequestCommitSha": null,
"refName": "string"
},
"requiredMetadata": {},
"requiredMetadataValues": [
{
"fieldName": "string",
"value": "string"
}
]
}
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
| customModelId | path | string | true | ID of the custom model. |
| customModelVersionId | path | string | true | ID of the custom model version. |
| body | body | CustomModelVersionMetadataUpdate | false | none |
Example responses¶
200 Response
{
"baseEnvironmentId": "string",
"baseEnvironmentVersionId": "string",
"created": "string",
"customModelId": "string",
"dependencies": [
{
"constraints": [
{
"constraintType": "<",
"version": "string"
}
],
"extras": "string",
"line": "string",
"lineNumber": 0,
"packageName": "string"
}
],
"description": "string",
"desiredMemory": 134217728,
"gitModelVersion": {
"commitUrl": "http://example.com",
"mainBranchCommitSha": "stringstringstringstringstringstringstri",
"pullRequestCommitSha": null,
"refName": "string"
},
"holdoutData": {
"datasetId": "string",
"datasetName": "string",
"datasetVersionId": "string",
"partitionColumn": "string"
},
"id": "string",
"isFrozen": true,
"items": [
{
"commitSha": "string",
"created": "string",
"fileName": "string",
"filePath": "string",
"fileSource": "string",
"id": "string",
"ref": "string",
"repositoryFilePath": "string",
"repositoryLocation": "string",
"repositoryName": "string",
"storagePath": "string",
"workspaceId": "string"
}
],
"label": "string",
"maximumMemory": 134217728,
"networkEgressPolicy": "NONE",
"replicas": 0,
"requiredMetadata": {},
"requiredMetadataValues": [
{
"fieldName": "string",
"value": "string"
}
],
"requiresHa": true,
"resourceBundleId": "string",
"trainingData": {
"assignmentError": {
"message": "string"
},
"assignmentInProgress": false,
"datasetId": "string",
"datasetName": "string",
"datasetVersionId": "string"
},
"versionMajor": 0,
"versionMinor": 0
}
Responses¶
| Status | Meaning | Description | Schema |
|---|---|---|---|
| 200 | OK | The edit was successful. | CustomModelVersionResponse |
| 404 | Not Found | Custom model not found or user does not have edit permissions. | None |
| 422 | Unprocessable Entity | Cannot update custom model metadata. | None |
To perform this operation, you must be authenticated by means of one of the following methods:
BearerAuth
GET /api/v2/customModels/{customModelId}/versions/{customModelVersionId}/conversions/¶
Get the list of custom model conversions that are associated with the given custom model. Alternatively, it can return a single item list of the latest custom model conversion that is associated with the given custom model version.
Code samples¶
# You can also use wget
curl -X GET https://app.datarobot.com/api/v2/customModels/{customModelId}/versions/{customModelVersionId}/conversions/?offset=0&limit=1000 \
-H "Accept: application/json" \
-H "Authorization: Bearer {access-token}"
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
| offset | query | integer | true | This many results will be skipped. |
| limit | query | integer | true | At most this many results are returned. |
| isLatest | query | string | false | Whether to return only the latest associated custom model conversion or all of the associated ones. |
| customModelId | path | string | true | ID of the custom model. |
| customModelVersionId | path | string | true | ID of the custom model version. |
Enumerated Values¶
| Parameter | Value |
|---|---|
| isLatest | [false, False, true, True] |
Example responses¶
200 Response
{
"count": 0,
"data": [
{
"conversionInProgress": true,
"conversionSucceeded": true,
"created": "string",
"customModelVersionId": "string",
"generatedMetadata": {
"outputColumns": [
[
"string"
]
],
"outputDatasets": [
"string"
]
},
"id": "string",
"logMessage": "string",
"mainProgramItemId": "string",
"shouldStop": false
}
],
"next": "http://example.com",
"previous": "http://example.com",
"totalCount": 0
}
Responses¶
| Status | Meaning | Description | Schema |
|---|---|---|---|
| 200 | OK | none | ConversionListResponse |
To perform this operation, you must be authenticated by means of one of the following methods:
BearerAuth
POST /api/v2/customModels/{customModelId}/versions/{customModelVersionId}/conversions/¶
Converts files in the given custom model version to a JAR file.
Code samples¶
# You can also use wget
curl -X POST https://app.datarobot.com/api/v2/customModels/{customModelId}/versions/{customModelVersionId}/conversions/ \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-H "Authorization: Bearer {access-token}"
Body parameter¶
{
"mainProgramItemId": "string"
}
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
| customModelId | path | string | true | ID of the custom model. |
| customModelVersionId | path | string | true | ID of the custom model version. |
| body | body | ConversionCreateQuery | false | none |
Example responses¶
202 Response
{
"conversionId": "string",
"statusId": "string"
}
Responses¶
| Status | Meaning | Description | Schema |
|---|---|---|---|
| 202 | Accepted | The request was accepted and will be worked on. | CustomModelConversionAsyncOperationResponse |
| 422 | Unprocessable Entity | Input parameters are invalid. | None |
To perform this operation, you must be authenticated by means of one of the following methods:
BearerAuth
DELETE /api/v2/customModels/{customModelId}/versions/{customModelVersionId}/conversions/{conversionId}/¶
Stop a running conversion for given model and model version.
Code samples¶
# You can also use wget
curl -X DELETE https://app.datarobot.com/api/v2/customModels/{customModelId}/versions/{customModelVersionId}/conversions/{conversionId}/ \
-H "Authorization: Bearer {access-token}"
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
| customModelId | path | string | true | ID of the custom model. |
| customModelVersionId | path | string | true | ID of the custom model version. |
| conversionId | path | string | true | ID of the custom model conversion. |
Responses¶
| Status | Meaning | Description | Schema |
|---|---|---|---|
| 204 | No Content | none | None |
| 422 | Unprocessable Entity | The given conversion is not active. | None |
To perform this operation, you must be authenticated by means of one of the following methods:
BearerAuth
GET /api/v2/customModels/{customModelId}/versions/{customModelVersionId}/conversions/{conversionId}/¶
Get a given custom model conversion.
Code samples¶
# You can also use wget
curl -X GET https://app.datarobot.com/api/v2/customModels/{customModelId}/versions/{customModelVersionId}/conversions/{conversionId}/ \
-H "Accept: application/json" \
-H "Authorization: Bearer {access-token}"
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
| customModelId | path | string | true | ID of the custom model. |
| customModelVersionId | path | string | true | ID of the custom model version. |
| conversionId | path | string | true | ID of the custom model conversion. |
Example responses¶
200 Response
{
"conversionInProgress": true,
"conversionSucceeded": true,
"created": "string",
"customModelVersionId": "string",
"generatedMetadata": {
"outputColumns": [
[
"string"
]
],
"outputDatasets": [
"string"
]
},
"id": "string",
"logMessage": "string",
"mainProgramItemId": "string",
"shouldStop": false
}
Responses¶
| Status | Meaning | Description | Schema |
|---|---|---|---|
| 200 | OK | none | ConversionResponse |
To perform this operation, you must be authenticated by means of one of the following methods:
BearerAuth
GET /api/v2/customModels/{customModelId}/versions/{customModelVersionId}/download/¶
Download a specific item bundle from a custom model as a zip compressed archive.
Code samples¶
# You can also use wget
curl -X GET https://app.datarobot.com/api/v2/customModels/{customModelId}/versions/{customModelVersionId}/download/ \
-H "Authorization: Bearer {access-token}"
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
| pps | query | string | false | Download model version from PPS tab.If "true" specified, model archive includes dependencies install script. If "false" specified, dependencies script is not included. If not specified -> "false" behavior. |
| customModelId | path | string | true | ID of the custom model. |
| customModelVersionId | path | string | true | ID of the custom model version. |
Enumerated Values¶
| Parameter | Value |
|---|---|
| pps | [false, False, true, True] |
Responses¶
| Status | Meaning | Description | Schema |
|---|---|---|---|
| 200 | OK | The download succeeded. | None |
Response Headers¶
| Status | Header | Type | Format | Description |
|---|---|---|---|---|
| 200 | Content-Disposition | string | Contains an auto generated filename for this download ("attachment;filename=model- |
To perform this operation, you must be authenticated by means of one of the following methods:
BearerAuth
GET /api/v2/customModels/{customModelId}/versions/{customModelVersionId}/featureImpact/¶
Retrieve feature impact scores for features in a custom inference model image.
This route is a counterpart of a corresponding endpoint for native models: GET /api/v2/projects/{projectId}/models/{modelId}/featureImpact/
Code samples¶
# You can also use wget
curl -X GET https://app.datarobot.com/api/v2/customModels/{customModelId}/versions/{customModelVersionId}/featureImpact/ \
-H "Accept: application/json" \
-H "Authorization: Bearer {access-token}"
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
| customModelId | path | string | true | ID of the custom model. |
| customModelVersionId | path | string | true | ID of the custom model version. |
Example responses¶
200 Response
{
"count": 0,
"featureImpacts": [
{
"featureName": "string",
"impactNormalized": 1,
"impactUnnormalized": 0,
"parentFeatureName": "string",
"redundantWith": "string"
}
],
"next": "http://example.com",
"previous": "http://example.com",
"ranRedundancyDetection": true,
"rowCount": 0,
"shapBased": true
}
Responses¶
| Status | Meaning | Description | Schema |
|---|---|---|---|
| 200 | OK | Custom model feature impact returned. | FeatureImpactResponse |
| 404 | Not Found | No feature impact data found for custom model. | None |
| 422 | Unprocessable Entity | Cannot retrieve feature impact scores: (1) if custom model is not an inference model, (2) if training data is not assigned, (3) if feature impact job is in progress for custom model. | None |
To perform this operation, you must be authenticated by means of one of the following methods:
BearerAuth
POST /api/v2/customModels/{customModelId}/versions/{customModelVersionId}/featureImpact/¶
Add a request to calculate feature impact for a custom inference model image to the queue.
This route is a counterpart of a corresponding endpoint for native models: POST /api/v2/projects/{projectId}/models/{modelId}/featureImpact/
Code samples¶
# You can also use wget
curl -X POST https://app.datarobot.com/api/v2/customModels/{customModelId}/versions/{customModelVersionId}/featureImpact/ \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-H "Authorization: Bearer {access-token}"
Body parameter¶
{
"rowCount": 10
}
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
| customModelId | path | string | true | ID of the custom model. |
| customModelVersionId | path | string | true | ID of the custom model version. |
| body | body | FeatureImpactCreatePayload | false | none |
Example responses¶
202 Response
{
"statusId": "string"
}
Responses¶
| Status | Meaning | Description | Schema |
|---|---|---|---|
| 202 | Accepted | Feature impact request has been successfully submitted. | FeatureImpactCreateResponse |
| 404 | Not Found | If feature impact has already been submitted. The response will include jobId property which can be used for tracking its progress. |
None |
| 422 | Unprocessable Entity | If job cannot be submitted because of invalid input or model state: (1) if image id does not correspond to a custom inference model, (2) if training data is not yet assigned or assignment is in progress, (3) if the rowCount exceeds the minimum or maximum value for this model's training data. |
None |
Response Headers¶
| Status | Header | Type | Format | Description |
|---|---|---|---|---|
| 202 | Location | string | Contains a url for tracking job status: GET /api/v2/status/{statusId}/. |
To perform this operation, you must be authenticated by means of one of the following methods:
BearerAuth
POST /api/v2/customModels/{customModelId}/versions/{customModelVersionId}/predictionExplanationsInitialization/¶
Create a new prediction explanations initialization for custom model version. This is a necessary prerequisite for generating prediction explanations.
Code samples¶
# You can also use wget
curl -X POST https://app.datarobot.com/api/v2/customModels/{customModelId}/versions/{customModelVersionId}/predictionExplanationsInitialization/ \
-H "Authorization: Bearer {access-token}"
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
| customModelId | path | string | true | ID of the custom model. |
| customModelVersionId | path | string | true | ID of the custom model version. |
Responses¶
| Status | Meaning | Description | Schema |
|---|---|---|---|
| 202 | Accepted | The request was accepted and will be worked on. | None |
| 422 | Unprocessable Entity | Specified custom model is not valid for prediction explanations. | None |
Response Headers¶
| Status | Header | Type | Format | Description |
|---|---|---|---|---|
| 202 | Location | string | URL to poll to track the prediction explanation initialization has finished. |
To perform this operation, you must be authenticated by means of one of the following methods:
BearerAuth
GET /api/v2/deletedCustomJobs/¶
List deleted custom jobs.
Code samples¶
# You can also use wget
curl -X GET https://app.datarobot.com/api/v2/deletedCustomJobs/ \
-H "Accept: application/json" \
-H "Authorization: Bearer {access-token}"
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
| offset | query | integer | false | This many results will be skipped. |
| limit | query | integer | false | At most this many results are returned. |
Example responses¶
200 Response
{
"count": 0,
"data": [
{
"created": "string",
"description": "string",
"entryPoint": "string",
"environmentId": "string",
"environmentVersionId": "string",
"id": "string",
"items": [
{
"commitSha": "string",
"created": "string",
"fileName": "string",
"filePath": "string",
"fileSource": "string",
"id": "string",
"ref": "string",
"repositoryFilePath": "string",
"repositoryLocation": "string",
"repositoryName": "string"
}
],
"jobType": "default",
"lastRun": "string",
"name": "string",
"resources": {
"egressNetworkPolicy": "none",
"resourceBundleId": "string"
},
"runtimeParameters": [
{
"allowEmpty": true,
"credentialType": "adlsGen2Oauth",
"currentValue": "string",
"defaultValue": "string",
"description": "string",
"fieldName": "string",
"maxValue": 0,
"minValue": 0,
"overrideValue": "string",
"type": "boolean"
}
],
"updated": "string"
}
],
"next": "http://example.com",
"previous": "http://example.com",
"totalCount": 0
}
Responses¶
| Status | Meaning | Description | Schema |
|---|---|---|---|
| 200 | OK | List of deleted custom jobs. | CustomJobListResponse |
| 403 | Forbidden | Custom jobs are not enabled. | None |
To perform this operation, you must be authenticated by means of one of the following methods:
BearerAuth
GET /api/v2/mlops/compute/bundles/¶
Retrieve metadata for all resource bundles the user has access to.
Notice: Endpoint is currently in [PUBLIC_PREVIEW]. Do not use it in production workflows to reduce risk. See details:
This endpoint depends on the following features that are subject to change.
| Feature Flag | Maturity | Enabled by default | Description |
|---|---|---|---|
| MLOPS_RESOURCE_REQUEST_BUNDLES | PUBLIC_PREVIEW | false | Instead of managing resources (i.e. CPU, memory, and GPU) individually, users select an available bundle of resources that best fits their Custom Model/Job/App, etc. |
Code samples¶
# You can also use wget
curl -X GET https://app.datarobot.com/api/v2/mlops/compute/bundles/ \
-H "Accept: application/json" \
-H "Authorization: Bearer {access-token}"
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
| useCases | query | string | false | If it is specified, only bundles for this use case will be returned. |
| offset | query | integer | false | Number of results to skip. |
| limit | query | integer | false | At most this many results are returned. The default may change without notice. |
Enumerated Values¶
| Parameter | Value |
|---|---|
| useCases | [customApplication, customJob, customModel, sapAICore] |
Example responses¶
200 Response
{
"count": 0,
"data": [
{
"cpuCount": 0,
"description": "string",
"gpuCount": 0,
"gpuMaker": "nvidia",
"hasGpu": true,
"id": "string",
"isDefault": true,
"isDeleted": true,
"memoryBytes": 0,
"name": "string",
"useCases": [
"customApplication"
]
}
],
"next": "http://example.com",
"previous": "http://example.com",
"totalCount": 0
}
Responses¶
| Status | Meaning | Description | Schema |
|---|---|---|---|
| 200 | OK | List of resource bundle metadata. | ResourceRequestBundleListResponse |
| 403 | Forbidden | Resource bundles are not enabled. | None |
To perform this operation, you must be authenticated by means of one of the following methods:
BearerAuth
GET /api/v2/mlops/compute/bundles/{resourceRequestBundleId}/¶
Retrieve resource bundle.
Notice: Endpoint is currently in [PUBLIC_PREVIEW]. Do not use it in production workflows to reduce risk. See details:
This endpoint depends on the following features that are subject to change.
| Feature Flag | Maturity | Enabled by default | Description |
|---|---|---|---|
| MLOPS_RESOURCE_REQUEST_BUNDLES | PUBLIC_PREVIEW | false | Instead of managing resources (i.e. CPU, memory, and GPU) individually, users select an available bundle of resources that best fits their Custom Model/Job/App, etc. |
Code samples¶
# You can also use wget
curl -X GET https://app.datarobot.com/api/v2/mlops/compute/bundles/{resourceRequestBundleId}/ \
-H "Accept: application/json" \
-H "Authorization: Bearer {access-token}"
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
| resourceRequestBundleId | path | string | true | ID of the bundle. |
Example responses¶
200 Response
{
"cpuCount": 0,
"description": "string",
"gpuCount": 0,
"gpuMaker": "nvidia",
"hasGpu": true,
"id": "string",
"isDefault": true,
"isDeleted": true,
"memoryBytes": 0,
"name": "string",
"useCases": [
"customApplication"
]
}
Responses¶
| Status | Meaning | Description | Schema |
|---|---|---|---|
| 200 | OK | Resource bundle | ResourceRequestBundleResponse |
| 403 | Forbidden | Resource bundles are not enabled or the user does not have access to specified bundle. | None |
| 404 | Not Found | Resource bundle does not exist. | None |
To perform this operation, you must be authenticated by means of one of the following methods:
BearerAuth
Schemas¶
AccessControlV2
{
"id": "string",
"name": "string",
"role": "ADMIN",
"shareRecipientType": "user"
}
Properties¶
| Name | Type | Required | Restrictions | Description |
|---|---|---|---|---|
| id | string | true | The identifier of the recipient. | |
| name | string | true | The name of the recipient. | |
| role | string | true | The role of the recipient on this entity. | |
| shareRecipientType | string | true | The type of the recipient. |
Enumerated Values¶
| Property | Value |
|---|---|
| role | [ADMIN, CONSUMER, DATA_SCIENTIST, EDITOR, OBSERVER, OWNER, READ_ONLY, READ_WRITE, USER] |
| shareRecipientType | [user, group, organization] |
BatchField
{
"columnName": "string"
}
A custom metric batch ID source when reading values from columnar dataset like a file.
Properties¶
| Name | Type | Required | Restrictions | Description |
|---|---|---|---|---|
| columnName | string¦null | true | Column name |
ConversionCreateQuery
{
"mainProgramItemId": "string"
}
Properties¶
| Name | Type | Required | Restrictions | Description |
|---|---|---|---|---|
| mainProgramItemId | string | true | The main program file item ID. |
ConversionListResponse
{
"count": 0,
"data": [
{
"conversionInProgress": true,
"conversionSucceeded": true,
"created": "string",
"customModelVersionId": "string",
"generatedMetadata": {
"outputColumns": [
[
"string"
]
],
"outputDatasets": [
"string"
]
},
"id": "string",
"logMessage": "string",
"mainProgramItemId": "string",
"shouldStop": false
}
],
"next": "http://example.com",
"previous": "http://example.com",
"totalCount": 0
}
Properties¶
| Name | Type | Required | Restrictions | Description |
|---|---|---|---|---|
| count | integer | false | Number of items returned on this page. | |
| data | [ConversionResponse] | true | List of custom model conversions. | |
| next | string(uri)¦null | true | URL pointing to the next page (if null, there is no next page). | |
| previous | string(uri)¦null | true | URL pointing to the previous page (if null, there is no previous page). | |
| totalCount | integer | true | The total number of items across all pages. |
ConversionResponse
{
"conversionInProgress": true,
"conversionSucceeded": true,
"created": "string",
"customModelVersionId": "string",
"generatedMetadata": {
"outputColumns": [
[
"string"
]
],
"outputDatasets": [
"string"
]
},
"id": "string",
"logMessage": "string",
"mainProgramItemId": "string",
"shouldStop": false
}
Properties¶
| Name | Type | Required | Restrictions | Description |
|---|---|---|---|---|
| conversionInProgress | boolean¦null | false | Whether a custom model conversion is in progress or not. | |
| conversionSucceeded | boolean¦null | false | Indication for a successful custom model conversion. | |
| created | string | true | ISO-8601 timestamp of when the custom model conversion created. | |
| customModelVersionId | string | true | ID of the custom model version. | |
| generatedMetadata | GeneratedMetadata | false | Custom model conversion output metadata. | |
| id | string | true | ID of the custom model version. | |
| logMessage | string¦null | false | The output log message from the custom model conversion process. | |
| mainProgramItemId | string¦null | false | The main program file item ID. | |
| shouldStop | boolean | false | Whether the user requested to stop the given conversion. |
CreateCustomJob
{
"description": "string",
"environmentId": "string",
"environmentVersionId": "string",
"file": "string",
"filePath": "string",
"jobType": "default",
"name": "string",
"resources": {
"egressNetworkPolicy": "none",
"resourceBundleId": "string"
},
"runtimeParameterValues": "string"
}
Properties¶
| Name | Type | Required | Restrictions | Description |
|---|---|---|---|---|
| description | string | false | maxLength: 10000 |
The description of the custom job. |
| environmentId | string | false | The ID of the execution environment to use for this custom job. | |
| environmentVersionId | string | false | The ID of the execution environment version to use for this custom job. If not provided, the latest execution environment version will be used. | |
| file | string(binary) | false | A file with code for a custom task or a custom model. For each file supplied as form data, you must have a corresponding filePath supplied that shows the relative location of the file. For example, you have two files: /home/username/custom-task/main.py and /home/username/custom-task/helpers/helper.py. When uploading these files, you would also need to include two filePath fields of, "main.py" and "helpers/helper.py". If the supplied file already exists at the supplied filePath, the old file is replaced by the new file. |
|
| filePath | any | false | The local path of the file being uploaded. See the file field explanation for more details. |
oneOf
| Name | Type | Required | Restrictions | Description |
|---|---|---|---|---|
| » anonymous | string | false | none |
xor
| Name | Type | Required | Restrictions | Description |
|---|---|---|---|---|
| » anonymous | [string] | false | none |
continued
| Name | Type | Required | Restrictions | Description |
|---|---|---|---|---|
| jobType | string | false | Type of the custom job. | |
| name | string | true | maxLength: 255 |
Name of the custom job. |
| resources | CustomJobResources | false | The custom job resources that will be applied in the k8s cluster. | |
| runtimeParameterValues | string | false | Ability to inject values into a custom job at runtime. The fieldName must match a fieldName that is listed in the runtimeParameterDefinitions section of the metadata.yaml file. This list will be merged with any existing runtime values set from the prior version when issuing a PATCH request so it is possible to specify a null value to unset specific parameters and fall back to the defaultValue from the definition. |
Enumerated Values¶
| Property | Value |
|---|---|
| jobType | [default, hostedCustomMetric, notification, retraining] |
CreateCustomJobRun
{
"description": "string",
"runtimeParameterValues": [
{
"fieldName": "string",
"type": "boolean",
"value": "string"
}
]
}
Properties¶
| Name | Type | Required | Restrictions | Description |
|---|---|---|---|---|
| description | string | false | maxLength: 10000 |
The description of the custom job run. |
| runtimeParameterValues | [RuntimeParameterValue] | false | Ability to inject values at runtime. The fieldName must match a fieldName that is listed in the runtimeParameterDefinitions section of the custom job metadata.yaml file. It has a priority over an existing runtime parameter overrides defined at the custom job level. |
CustomJobCustomMetricUpdate
{
"baselineValues": [
{
"value": 0
}
],
"batch": {
"columnName": "string"
},
"description": "string",
"directionality": "higherIsBetter",
"name": "string",
"sampleCount": {
"columnName": "string"
},
"schedule": {
"dayOfMonth": [
"*"
],
"dayOfWeek": [
"*"
],
"hour": [
"*"
],
"minute": [
"*"
],
"month": [
"*"
]
},
"timestamp": {
"columnName": "string",
"timeFormat": "%m/%d/%Y"
},
"type": "average",
"units": "string",
"value": {
"columnName": "string"
}
}
Properties¶
| Name | Type | Required | Restrictions | Description |
|---|---|---|---|---|
| baselineValues | [MetricBaselineValue] | false | maxItems: 5 |
Baseline values |
| batch | BatchField | false | A custom metric batch ID source when reading values from columnar dataset like a file. | |
| description | string | false | maxLength: 1000 |
A description of the custom metric. |
| directionality | string | false | Directionality of the custom metric. | |
| name | string | false | Name of the custom metric. | |
| sampleCount | SampleCountField | false | Points to a weight column if users provide pre-aggregated metric values. Used with columnar datasets. | |
| schedule | Schedule | false | The scheduling information defining how often and when to execute this job to the Job Scheduling service. Optional if enabled = False. | |
| timestamp | MetricTimestampSpoofing | false | A custom metric timestamp spoofing when reading values from file, like dataset. By default, we replicate pd.to_datetime formatting behaviour. | |
| type | string | false | Type (and aggregation character) of a metric. | |
| units | string | false | Units or Y Label of given custom metric. | |
| value | ValueField | false | A custom metric value source when reading values from columnar dataset like a file. |
Enumerated Values¶
| Property | Value |
|---|---|
| directionality | [higherIsBetter, lowerIsBetter] |
| type | [average, categorical, gauge, sum] |
CustomJobFileResponse
{
"content": "string",
"fileName": "string",
"filePath": "string",
"id": "string"
}
Properties¶
| Name | Type | Required | Restrictions | Description |
|---|---|---|---|---|
| content | string | true | Content of the chosen file. | |
| fileName | string | true | Name of the chosen file. | |
| filePath | string | true | Path of the chosen file. | |
| id | string | true | The ID of the custom job. |
CustomJobFromGalleryTemplateCreate
{
"description": "",
"name": "string",
"sidecarDeploymentId": "string",
"templateId": "string"
}
Properties¶
| Name | Type | Required | Restrictions | Description |
|---|---|---|---|---|
| description | string | false | maxLength: 1000 |
Description of the hosted custom metric job. |
| name | string | true | maxLength: 255 |
Name of the hosted custom metric job. |
| sidecarDeploymentId | string | false | Sidecar deployment ID. | |
| templateId | string | true | Custom Metric Template ID. |
CustomJobLimitsResponse
{
"maxCustomJobRuns": 0,
"maxCustomJobTimeout": 0
}
Properties¶
| Name | Type | Required | Restrictions | Description |
|---|---|---|---|---|
| maxCustomJobRuns | integer | true | Number of custom jobs allowed to run in parallel. | |
| maxCustomJobTimeout | integer | true | Execution time limit for the custom job in seconds. |
CustomJobListResponse
{
"count": 0,
"data": [
{
"created": "string",
"description": "string",
"entryPoint": "string",
"environmentId": "string",
"environmentVersionId": "string",
"id": "string",
"items": [
{
"commitSha": "string",
"created": "string",
"fileName": "string",
"filePath": "string",
"fileSource": "string",
"id": "string",
"ref": "string",
"repositoryFilePath": "string",
"repositoryLocation": "string",
"repositoryName": "string"
}
],
"jobType": "default",
"lastRun": "string",
"name": "string",
"resources": {
"egressNetworkPolicy": "none",
"resourceBundleId": "string"
},
"runtimeParameters": [
{
"allowEmpty": true,
"credentialType": "adlsGen2Oauth",
"currentValue": "string",
"defaultValue": "string",
"description": "string",
"fieldName": "string",
"maxValue": 0,
"minValue": 0,
"overrideValue": "string",
"type": "boolean"
}
],
"updated": "string"
}
],
"next": "http://example.com",
"previous": "http://example.com",
"totalCount": 0
}
Properties¶
| Name | Type | Required | Restrictions | Description |
|---|---|---|---|---|
| count | integer | false | Number of items returned on this page. | |
| data | [CustomJobResponse] | true | List of custom jobs. | |
| next | string(uri)¦null | true | URL pointing to the next page (if null, there is no next page). | |
| previous | string(uri)¦null | true | URL pointing to the previous page (if null, there is no previous page). | |
| totalCount | integer | true | The total number of items across all pages. |
CustomJobResources
{
"egressNetworkPolicy": "none",
"resourceBundleId": "string"
}
The custom job resources that will be applied in the k8s cluster.
Properties¶
| Name | Type | Required | Restrictions | Description |
|---|---|---|---|---|
| egressNetworkPolicy | string | true | Egress network policy. | |
| resourceBundleId | string¦null | false | A single identifier that represents a bundle of resources: Memory, CPU, GPU, etc. A list of available bundles can be obtained via the resource bundles endpoint. |
Enumerated Values¶
| Property | Value |
|---|---|
| egressNetworkPolicy | [none, public] |
CustomJobResponse
{
"created": "string",
"description": "string",
"entryPoint": "string",
"environmentId": "string",
"environmentVersionId": "string",
"id": "string",
"items": [
{
"commitSha": "string",
"created": "string",
"fileName": "string",
"filePath": "string",
"fileSource": "string",
"id": "string",
"ref": "string",
"repositoryFilePath": "string",
"repositoryLocation": "string",
"repositoryName": "string"
}
],
"jobType": "default",
"lastRun": "string",
"name": "string",
"resources": {
"egressNetworkPolicy": "none",
"resourceBundleId": "string"
},
"runtimeParameters": [
{
"allowEmpty": true,
"credentialType": "adlsGen2Oauth",
"currentValue": "string",
"defaultValue": "string",
"description": "string",
"fieldName": "string",
"maxValue": 0,
"minValue": 0,
"overrideValue": "string",
"type": "boolean"
}
],
"updated": "string"
}
Properties¶
| Name | Type | Required | Restrictions | Description |
|---|---|---|---|---|
| created | string | true | ISO-8601 timestamp of when the custom job was created. | |
| description | string | false | maxLength: 10000 |
The description of the custom job. |
| entryPoint | string¦null | false | The ID of the entry point file to use. | |
| environmentId | string¦null | true | The ID of the execution environment used for this custom job. | |
| environmentVersionId | string¦null | true | The ID of the execution environment version used for this custom job. | |
| id | string | true | The ID of the custom job. | |
| items | [WorkspaceItemResponse] | true | List of file items. | |
| jobType | string | true | Type of the custom job. | |
| lastRun | string¦null | true | The last custom job run. | |
| name | string | true | The name of the custom job. | |
| resources | CustomJobResources | true | The custom job resources that will be applied in the k8s cluster. | |
| runtimeParameters | [RuntimeParameterUnified] | false | Unified view of the defined runtime parameters for this custom job along with any values that are currently set that override the default value from their definition. | |
| updated | string | true | ISO-8601 timestamp of when custom job was last updated. |
Enumerated Values¶
| Property | Value |
|---|---|
| jobType | [default, hostedCustomMetric, notification, retraining] |
CustomJobRunListResponse
{
"count": 0,
"data": [
{
"created": "string",
"customJobId": "string",
"description": "string",
"duration": 0,
"entryPoint": "string",
"id": "string",
"items": [
{
"commitSha": "string",
"created": "string",
"fileName": "string",
"filePath": "string",
"fileSource": "string",
"id": "string",
"ref": "string",
"repositoryFilePath": "string",
"repositoryLocation": "string",
"repositoryName": "string"
}
],
"jobStatusId": "string",
"resources": {
"egressNetworkPolicy": "none",
"resourceBundleId": "string"
},
"runtimeParameters": [
{
"allowEmpty": true,
"credentialType": "adlsGen2Oauth",
"currentValue": "string",
"defaultValue": "string",
"description": "string",
"fieldName": "string",
"maxValue": 0,
"minValue": 0,
"overrideValue": "string",
"type": "boolean"
}
],
"status": "succeeded"
}
],
"next": "http://example.com",
"previous": "http://example.com",
"totalCount": 0
}
Properties¶
| Name | Type | Required | Restrictions | Description |
|---|---|---|---|---|
| count | integer | false | Number of items returned on this page. | |
| data | [CustomJobRunResponse] | true | List of custom job runs. | |
| next | string(uri)¦null | true | URL pointing to the next page (if null, there is no next page). | |
| previous | string(uri)¦null | true | URL pointing to the previous page (if null, there is no previous page). | |
| totalCount | integer | true | The total number of items across all pages. |
CustomJobRunResponse
{
"created": "string",
"customJobId": "string",
"description": "string",
"duration": 0,
"entryPoint": "string",
"id": "string",
"items": [
{
"commitSha": "string",
"created": "string",
"fileName": "string",
"filePath": "string",
"fileSource": "string",
"id": "string",
"ref": "string",
"repositoryFilePath": "string",
"repositoryLocation": "string",
"repositoryName": "string"
}
],
"jobStatusId": "string",
"resources": {
"egressNetworkPolicy": "none",
"resourceBundleId": "string"
},
"runtimeParameters": [
{
"allowEmpty": true,
"credentialType": "adlsGen2Oauth",
"currentValue": "string",
"defaultValue": "string",
"description": "string",
"fieldName": "string",
"maxValue": 0,
"minValue": 0,
"overrideValue": "string",
"type": "boolean"
}
],
"status": "succeeded"
}
Properties¶
| Name | Type | Required | Restrictions | Description |
|---|---|---|---|---|
| created | string | true | ISO-8601 timestamp of when the model was created. | |
| customJobId | string | true | The ID of the custom job. | |
| description | string | false | maxLength: 10000 |
The description of the custom job run. |
| duration | number | true | Duration of the custom test run is seconds. | |
| entryPoint | string | false | The entry point file item ID in the custom job's workspace. | |
| id | string | true | The ID of the custom job. | |
| items | [WorkspaceItemResponse] | true | List of file items. | |
| jobStatusId | string¦null | true | ID to track the custom job run execution status. | |
| resources | CustomJobResources | true | The custom job resources that will be applied in the k8s cluster. | |
| runtimeParameters | [RuntimeParameterUnified] | false | Unified view of the defined runtime parameters for this custom job along with any values that are currently set that override the default value from their definition. | |
| status | string | true | The status of the custom job run. |
Enumerated Values¶
| Property | Value |
|---|---|
| status | [succeeded, failed, running, interrupted, canceling, canceled] |
CustomModelAccessControlListResponse
{
"count": 0,
"data": [
{
"canShare": true,
"role": "string",
"userId": "string",
"username": "string"
}
],
"next": "http://example.com",
"previous": "http://example.com"
}
Properties¶
| Name | Type | Required | Restrictions | Description |
|---|---|---|---|---|
| count | integer | true | Number of items in current page. | |
| data | [CustomModelAccessControlResponse] | true | List of the requested custom model access control entries. | |
| next | string(uri)¦null | true | URL pointing to the next page (if null, there is no next page) | |
| previous | string(uri)¦null | true | URL pointing to the previous page (if null, there is no previous page |
CustomModelAccessControlResponse
{
"canShare": true,
"role": "string",
"userId": "string",
"username": "string"
}
Properties¶
| Name | Type | Required | Restrictions | Description |
|---|---|---|---|---|
| canShare | boolean | true | Whether this user can share this custom model | |
| role | string | true | This users role. | |
| userId | string | true | This user's userId. | |
| username | string | true | The username for this user's entry. |
CustomModelAccessControlUpdateResponse
{
"data": [
{
"canShare": true,
"role": "string",
"userId": "string",
"username": "string"
}
]
}
Properties¶
| Name | Type | Required | Restrictions | Description |
|---|---|---|---|---|
| data | [CustomModelAccessControlResponse] | true | Roles were successfully updated. |
CustomModelAsyncOperationResponse
{
"statusId": "string"
}
Properties¶
| Name | Type | Required | Restrictions | Description |
|---|---|---|---|---|
| statusId | string | true | ID that can be used with GET /api/v2/status/{statusId}/ to poll for the testing job's status |
CustomModelConversionAsyncOperationResponse
{
"conversionId": "string",
"statusId": "string"
}
Properties¶
| Name | Type | Required | Restrictions | Description |
|---|---|---|---|---|
| conversionId | string | true | ID that can be used to stop a given conversion. | |
| statusId | string | true | ID that can be used with GET /api/v2/status/{statusId}/ to poll for the testing job's status |
CustomModelCopy
{
"customModelId": "string"
}
Properties¶
| Name | Type | Required | Restrictions | Description |
|---|---|---|---|---|
| customModelId | string | true | ID of the custom model to copy. |
CustomModelCreate
{
"calibratePredictions": "True",
"classLabels": [
"string"
],
"customModelType": "training",
"description": "string",
"desiredMemory": 134217728,
"gitModelVersion": {
"commitUrl": "http://example.com",
"mainBranchCommitSha": "stringstringstringstringstringstringstri",
"pullRequestCommitSha": null,
"refName": "string"
},
"isTrainingDataForVersionsPermanentlyEnabled": true,
"language": "string",
"maximumMemory": 134217728,
"name": "string",
"negativeClassLabel": "string",
"networkEgressPolicy": "NONE",
"playgroundId": "string",
"positiveClassLabel": "string",
"predictionThreshold": 0.5,
"replicas": 0,
"requiresHa": true,
"supportsBinaryClassification": true,
"supportsRegression": true,
"targetName": "string",
"targetType": "Binary",
"userProvidedId": "string"
}
Properties¶
| Name | Type | Required | Restrictions | Description |
|---|---|---|---|---|
| calibratePredictions | boolean | false | Whether model predictions should be calibrated by DataRobot.Only applies to anomaly detection training tasks; we recommend this if you have not already included calibration in your model code.Calibration improves the probability estimates of a model, and modifies the predictions of non-probabilistic models to be interpretable as probabilities. This will facilitate comparison to DataRobot models, and give access to ROC curve insights on external data. | |
| classLabels | [string] | false | maxItems: 100 |
The class labels for multiclass classification. Required for multiclass inference models. If using one of the [DataRobot] base environments and your model produces an ndarray of unlabeled class probabilities, the order of the labels should match the order of the predicted output |
| customModelType | string | true | The type of custom model. | |
| description | string | false | maxLength: 10000 |
The user-friendly description of the model. |
| desiredMemory | integer¦null | false | maximum: 15032385536 minimum: 134217728 |
The amount of memory that is expected to be allocated by the custom model. |
| gitModelVersion | GitModelVersion | false | Contains git related attributes that are associated with a custom model version. | |
| isTrainingDataForVersionsPermanentlyEnabled | boolean | false | Indicates that training data assignment is now permanently at the version level only for the custom model. Once enabled, this cannot be disabled. Training data assignment on the model level PATCH /api/v2/customModels/{customModelId}/trainingData/ will be permanently disabled for this particular model. | |
| language | string | false | maxLength: 500 |
Programming language name in which model is written. |
| maximumMemory | integer¦null | false | maximum: 15032385536 minimum: 134217728 |
The maximum memory that might be allocated by the custom-model. If exceeded, the custom-model will be killed |
| name | string | true | maxLength: 255 |
The user-friendly name for the model. |
| negativeClassLabel | string¦null | false | maxLength: 500 |
The negative class label for custom models that support binary classification. If specified, positiveClassLabel must also be specified. Default value is "0". |
| networkEgressPolicy | string¦null | false | Network egress policy. | |
| playgroundId | string¦null | false | ID of the GenAI Playground associated with the given custom inference model. | |
| positiveClassLabel | string¦null | false | maxLength: 500 |
The positive class label for custom models that support binary classification. If specified, negativeClassLabel must also be specified. Default value is "1". |
| predictionThreshold | number | false | maximum: 1 minimum: 0 |
The prediction threshold which will be used for binary classification custom model. |
| replicas | integer¦null | false | maximum: 8 minimum: 0 (exclusive) |
A fixed number of replicas that will be set for the given custom-model. |
| requiresHa | boolean¦null | false | Require all custom model replicas to be deployed on different Kubernetes nodes for predictions fault tolerance. | |
| supportsBinaryClassification | boolean | false | Whether the model supports binary classification. | |
| supportsRegression | boolean | false | Whether the model supports regression. | |
| targetName | string¦null | false | maxLength: 500 |
The name of the target for labeling predictions. Required for model type 'inference'. Specifying this value for a model type 'training' will result in an error. |
| targetType | string | false | The target type of the custom model | |
| userProvidedId | string | false | maxLength: 100 |
A user-provided unique ID associated with the given custom inference model. |
Enumerated Values¶
| Property | Value |
|---|---|
| customModelType | [training, inference] |
| networkEgressPolicy | [NONE, DR_API_ACCESS, PUBLIC] |
| targetType | [Binary, Regression, Multiclass, Anomaly, Transform, TextGeneration, Unstructured, VectorDatabase] |
CustomModelDeploymentListResponse
{
"count": 0,
"data": [
{
"customModel": {
"id": "string",
"name": "string"
},
"customModelImageId": "string",
"customModelVersion": {
"id": "string",
"label": "string"
},
"deployed": "string",
"deployedBy": "string",
"executionEnvironment": {
"id": "string",
"name": "string"
},
"executionEnvironmentVersion": {
"id": "string",
"label": "string"
},
"id": "string",
"imageType": "customModelImage",
"label": "string",
"status": "active",
"testingStatus": "not_tested"
}
],
"next": "http://example.com",
"previous": "http://example.com",
"totalCount": 0
}
Properties¶
| Name | Type | Required | Restrictions | Description |
|---|---|---|---|---|
| count | integer | false | Number of items returned on this page. | |
| data | [CustomModelDeploymentResponse] | true | List of custom model deployments. | |
| next | string(uri)¦null | true | URL pointing to the next page (if null, there is no next page). | |
| previous | string(uri)¦null | true | URL pointing to the previous page (if null, there is no previous page). | |
| totalCount | integer | true | The total number of items across all pages. |
CustomModelDeploymentResponse
{
"customModel": {
"id": "string",
"name": "string"
},
"customModelImageId": "string",
"customModelVersion": {
"id": "string",
"label": "string"
},
"deployed": "string",
"deployedBy": "string",
"executionEnvironment": {
"id": "string",
"name": "string"
},
"executionEnvironmentVersion": {
"id": "string",
"label": "string"
},
"id": "string",
"imageType": "customModelImage",
"label": "string",
"status": "active",
"testingStatus": "not_tested"
}
Properties¶
| Name | Type | Required | Restrictions | Description |
|---|---|---|---|---|
| customModel | CustomModelShortResponse | true | Custom model associated with this deployment. | |
| customModelImageId | string | true | The id of the custom model image associated with this deployment. | |
| customModelVersion | CustomModelVersionShortResponse | true | Custom model version associated with this deployment. | |
| deployed | string | true | ISO-8601 timestamp of when deployment was created. | |
| deployedBy | string | true | The username of the user that deployed the custom model. | |
| executionEnvironment | ExecutionEnvironmentShortResponse | true | Execution environment associated with this deployment. | |
| executionEnvironmentVersion | ExecutionEnvironmentVersionShortResponse | true | Execution environment version associated with this deployment. | |
| id | string | true | The ID of the deployment. | |
| imageType | string | false | The type of the image, either customModelImage if the testing attempt is using a customModelImage as its model or customModelVersion if the testing attempt is using a customModelVersion with dependency management. | |
| label | string | true | User-friendly name of the model deployment. | |
| status | string | true | Deployment status. | |
| testingStatus | string | true | Latest testing status of the deployed custom model image. |
Enumerated Values¶
| Property | Value |
|---|---|
| imageType | [customModelImage, customModelVersion] |
| status | [active, archived, errored, inactive, launching, replacingModel, stopping] |
| testingStatus | [not_tested, queued, failed, canceled, succeeded, in_progress, aborted, warning, skipped] |
CustomModelListResponse
{
"count": 0,
"data": [
{
"calibratePredictions": true,
"classLabels": [
"string"
],
"created": "string",
"createdBy": "string",
"customModelType": "training",
"deploymentsCount": 0,
"description": "string",
"desiredMemory": 134217728,
"gitModelVersion": {
"commitUrl": "http://example.com",
"mainBranchCommitSha": "stringstringstringstringstringstringstri",
"pullRequestCommitSha": null,
"refName": "string"
},
"id": "string",
"isTrainingDataForVersionsPermanentlyEnabled": true,
"language": "string",
"latestVersion": {
"baseEnvironmentId": "string",
"baseEnvironmentVersionId": "string",
"created": "string",
"customModelId": "string",
"dependencies": [
{
"constraints": [
{
"constraintType": "<",
"version": "string"
}
],
"extras": "string",
"line": "string",
"lineNumber": 0,
"packageName": "string"
}
],
"description": "string",
"desiredMemory": 134217728,
"gitModelVersion": {
"commitUrl": "http://example.com",
"mainBranchCommitSha": "stringstringstringstringstringstringstri",
"pullRequestCommitSha": null,
"refName": "string"
},
"holdoutData": {
"datasetId": "string",
"datasetName": "string",
"datasetVersionId": "string",
"partitionColumn": "string"
},
"id": "string",
"isFrozen": true,
"items": [
{
"commitSha": "string",
"created": "string",
"fileName": "string",
"filePath": "string",
"fileSource": "string",
"id": "string",
"ref": "string",
"repositoryFilePath": "string",
"repositoryLocation": "string",
"repositoryName": "string",
"storagePath": "string",
"workspaceId": "string"
}
],
"label": "string",
"maximumMemory": 134217728,
"networkEgressPolicy": "NONE",
"replicas": 0,
"requiredMetadata": {},
"requiredMetadataValues": [
{
"fieldName": "string",
"value": "string"
}
],
"requiresHa": true,
"resourceBundleId": "string",
"trainingData": {
"assignmentError": {
"message": "string"
},
"assignmentInProgress": false,
"datasetId": "string",
"datasetName": "string",
"datasetVersionId": "string"
},
"versionMajor": 0,
"versionMinor": 0
},
"maximumMemory": 134217728,
"name": "string",
"negativeClassLabel": "string",
"networkEgressPolicy": "NONE",
"playgroundId": "string",
"positiveClassLabel": "string",
"predictionThreshold": 0,
"replicas": 0,
"requiresHa": true,
"resourceBundleId": "string",
"supportsAnomalyDetection": true,
"supportsBinaryClassification": true,
"supportsRegression": true,
"targetName": "string",
"targetType": "Binary",
"trainingDataAssignmentInProgress": true,
"trainingDataFileName": "string",
"trainingDataPartitionColumn": "string",
"trainingDatasetId": "string",
"trainingDatasetVersionId": "string",
"updated": "string",
"userProvidedId": "string"
}
],
"next": "http://example.com",
"previous": "http://example.com",
"totalCount": 0
}
Properties¶
| Name | Type | Required | Restrictions | Description |
|---|---|---|---|---|
| count | integer | false | Number of items returned on this page. | |
| data | [CustomModelResponse] | true | List of custom models. | |
| next | string(uri)¦null | true | URL pointing to the next page (if null, there is no next page). | |
| previous | string(uri)¦null | true | URL pointing to the previous page (if null, there is no previous page). | |
| totalCount | integer | true | The total number of items across all pages. |
CustomModelPredictionExplanations
{
"customModelId": "string",
"customModelVersionId": "string",
"environmentId": "string",
"environmentVersionId": "string"
}
Properties¶
| Name | Type | Required | Restrictions | Description |
|---|---|---|---|---|
| customModelId | string | true | ID of the custom model. | |
| customModelVersionId | string | true | ID of the custom model version. | |
| environmentId | string | false | The ID of environment to use. If not specified, the customModelVersion's dependency environment will be used. | |
| environmentVersionId | string | false | The ID of environment version to use. Defaults to the latest successfully built version. |
CustomModelResourceLimits
{
"desiredCustomModelContainerSize": 134217728,
"maxCustomModelContainerSize": 134217728,
"maxCustomModelReplicasPerDeployment": 0,
"maxCustomModelTestingParallelUsers": 0
}
Properties¶
| Name | Type | Required | Restrictions | Description |
|---|---|---|---|---|
| desiredCustomModelContainerSize | integer¦null | false | maximum: 15032385536 minimum: 134217728 |
The maximum memory that might be allocated by the custom-model. If exceeded, the custom-model will be killed |
| maxCustomModelContainerSize | integer¦null | false | maximum: 15032385536 minimum: 134217728 |
The maximum memory that might be allocated by the custom-model. If exceeded, the custom-model will be killed |
| maxCustomModelReplicasPerDeployment | integer¦null | false | maximum: 8 minimum: 0 (exclusive) |
A fixed number of replicas that will be set for the given custom-model. |
| maxCustomModelTestingParallelUsers | integer | true | maximum: 20 minimum: 0 (exclusive) |
The maximum number of parallel users that can be used for Custom Model Testing checks |
CustomModelResponse
{
"calibratePredictions": true,
"classLabels": [
"string"
],
"created": "string",
"createdBy": "string",
"customModelType": "training",
"deploymentsCount": 0,
"description": "string",
"desiredMemory": 134217728,
"gitModelVersion": {
"commitUrl": "http://example.com",
"mainBranchCommitSha": "stringstringstringstringstringstringstri",
"pullRequestCommitSha": null,
"refName": "string"
},
"id": "string",
"isTrainingDataForVersionsPermanentlyEnabled": true,
"language": "string",
"latestVersion": {
"baseEnvironmentId": "string",
"baseEnvironmentVersionId": "string",
"created": "string",
"customModelId": "string",
"dependencies": [
{
"constraints": [
{
"constraintType": "<",
"version": "string"
}
],
"extras": "string",
"line": "string",
"lineNumber": 0,
"packageName": "string"
}
],
"description": "string",
"desiredMemory": 134217728,
"gitModelVersion": {
"commitUrl": "http://example.com",
"mainBranchCommitSha": "stringstringstringstringstringstringstri",
"pullRequestCommitSha": null,
"refName": "string"
},
"holdoutData": {
"datasetId": "string",
"datasetName": "string",
"datasetVersionId": "string",
"partitionColumn": "string"
},
"id": "string",
"isFrozen": true,
"items": [
{
"commitSha": "string",
"created": "string",
"fileName": "string",
"filePath": "string",
"fileSource": "string",
"id": "string",
"ref": "string",
"repositoryFilePath": "string",
"repositoryLocation": "string",
"repositoryName": "string",
"storagePath": "string",
"workspaceId": "string"
}
],
"label": "string",
"maximumMemory": 134217728,
"networkEgressPolicy": "NONE",
"replicas": 0,
"requiredMetadata": {},
"requiredMetadataValues": [
{
"fieldName": "string",
"value": "string"
}
],
"requiresHa": true,
"resourceBundleId": "string",
"trainingData": {
"assignmentError": {
"message": "string"
},
"assignmentInProgress": false,
"datasetId": "string",
"datasetName": "string",
"datasetVersionId": "string"
},
"versionMajor": 0,
"versionMinor": 0
},
"maximumMemory": 134217728,
"name": "string",
"negativeClassLabel": "string",
"networkEgressPolicy": "NONE",
"playgroundId": "string",
"positiveClassLabel": "string",
"predictionThreshold": 0,
"replicas": 0,
"requiresHa": true,
"resourceBundleId": "string",
"supportsAnomalyDetection": true,
"supportsBinaryClassification": true,
"supportsRegression": true,
"targetName": "string",
"targetType": "Binary",
"trainingDataAssignmentInProgress": true,
"trainingDataFileName": "string",
"trainingDataPartitionColumn": "string",
"trainingDatasetId": "string",
"trainingDatasetVersionId": "string",
"updated": "string",
"userProvidedId": "string"
}
Properties¶
| Name | Type | Required | Restrictions | Description |
|---|---|---|---|---|
| calibratePredictions | boolean | false | Determines whether ot not predictions should be calibrated by DataRobot.Only applies to anomaly detection. | |
| classLabels | [string] | false | If the model is a multiclass classifier, these are the model's class labels | |
| created | string | true | ISO-8601 timestamp of when the model was created. | |
| createdBy | string | true | The username of the custom model creator. | |
| customModelType | string | false | The type of custom model. | |
| deploymentsCount | integer | true | The number of models deployed. | |
| description | string | true | The description of the model. | |
| desiredMemory | integer¦null | false | maximum: 15032385536 minimum: 134217728 |
The amount of memory that is expected to be allocated by the custom model. |
| gitModelVersion | GitModelVersion | false | Contains git related attributes that are associated with a custom model version. | |
| id | string | true | The ID of the custom model. | |
| isTrainingDataForVersionsPermanentlyEnabled | boolean | false | Indicates that training data assignment is now permanently at the version level only for the custom model. Once enabled, this cannot be disabled. Assigning training data on the model level PATCH /api/v2/customModels/{customModelId}/trainingData/ will be permanently disabled and return HTTP 422 for this particular model. Use training data assignment at the version level: POST /api/v2/customModels/{customModelId}/versions/ PATCH /api/v2/customModels/{customModelId}/versions/ | |
| language | string | true | The programming language used to write the model. | |
| latestVersion | CustomModelVersionResponse | true | The latest version for the custom model (if this field is empty, the model is not ready for use). | |
| maximumMemory | integer¦null | false | maximum: 15032385536 minimum: 134217728 |
The maximum memory that might be allocated by the custom-model. If exceeded, the custom-model will be killed |
| name | string | true | The name of the model. | |
| negativeClassLabel | string | false | If the model is a binary classifier, this is the negative class label. | |
| networkEgressPolicy | string¦null | false | Network egress policy. | |
| playgroundId | string¦null | false | ID of the GenAI Playground associated with the given custom inference model. | |
| positiveClassLabel | string | false | If the model is a binary classifier, this is the positive class label. | |
| predictionThreshold | number | false | If the model is a binary classifier, this is the prediction threshold. | |
| replicas | integer¦null | false | maximum: 8 minimum: 0 (exclusive) |
A fixed number of replicas that will be set for the given custom-model. |
| requiresHa | boolean¦null | false | Require all custom model replicas to be deployed on different Kubernetes nodes for predictions fault tolerance. | |
| resourceBundleId | string¦null | false | A single identifier that represents a bundle of resources: Memory, CPU, GPU, etc. A list of available bundles can be obtained via the resource bundles endpoint. | |
| supportsAnomalyDetection | boolean | false | Whether the model supports anomaly detection. | |
| supportsBinaryClassification | boolean | true | Whether the model supports binary classification. | |
| supportsRegression | boolean | true | Whether the model supports regression. | |
| targetName | string | false | The name of the target for labeling predictions. | |
| targetType | string | true | The target type of custom model. | |
| trainingDataAssignmentInProgress | boolean | false | Indicates if training data is currently being assigned to the custom model. | |
| trainingDataFileName | string¦null | false | The name of the file that was used as training data if it was assigned previously. | |
| trainingDataPartitionColumn | string¦null | false | The name of the column containing the partition assignments in training data if it was assigned previously and partitioning was provided. | |
| trainingDatasetId | string¦null | false | The ID of the dataset that was used as training data if it was assigned previously. | |
| trainingDatasetVersionId | string¦null | false | The ID of the dataset version that was used as training data if it was assigned previously. | |
| updated | string | true | ISO-8601 timestamp of when model was last updated. | |
| userProvidedId | string | false | maxLength: 100 |
A user-provided unique ID associated with the given custom inference model. |
Enumerated Values¶
| Property | Value |
|---|---|
| customModelType | [training, inference] |
| networkEgressPolicy | [NONE, DR_API_ACCESS, PUBLIC] |
| targetType | [Binary, Regression, Multiclass, Anomaly, Transform, TextGeneration, Unstructured, VectorDatabase] |
CustomModelShortResponse
{
"id": "string",
"name": "string"
}
Custom model associated with this deployment.
Properties¶
| Name | Type | Required | Restrictions | Description |
|---|---|---|---|---|
| id | string | true | The ID of the custom model. | |
| name | string | true | User-friendly name of the model. |
CustomModelTesting
{
"errorCheck": {
"message": "string",
"status": "not_tested"
},
"longRunningService": {
"message": "string",
"status": "not_tested"
},
"nullValueImputation": {
"message": "string",
"status": "not_tested"
},
"sideEffects": {
"message": "string",
"status": "not_tested"
}
}
Maps the testing types to their status and message for the testing entry. Testing type represents a single check executed during the test.
Properties¶
| Name | Type | Required | Restrictions | Description |
|---|---|---|---|---|
| errorCheck | TestingStatus | false | Ensures that the custom model image can build and launch. If it cannot, the test is marked as Failed and subsequent test are aborted. | |
| longRunningService | TestingStatus | false | Ensures that the custom model image can build and launch. If it cannot, the test is marked as Failed and subsequent test are aborted. | |
| nullValueImputation | TestingStatus | false | Ensures that the custom model image can build and launch. If it cannot, the test is marked as Failed and subsequent test are aborted. | |
| sideEffects | TestingStatus | false | Ensures that the custom model image can build and launch. If it cannot, the test is marked as Failed and subsequent test are aborted. |
CustomModelTests
{
"configuration": {
"errorCheck": "fail",
"longRunningService": "fail",
"nullValueImputation": "skip",
"sideEffects": "skip"
},
"customModelId": "string",
"customModelVersionId": "string",
"datasetId": "string",
"datasetVersionId": "string",
"desiredMemory": 134217728,
"environmentId": "string",
"environmentVersionId": "string",
"maximumMemory": 134217728,
"networkEgressPolicy": "NONE",
"replicas": 0,
"requiresHa": true,
"resourceBundleId": "string"
}
Properties¶
| Name | Type | Required | Restrictions | Description |
|---|---|---|---|---|
| configuration | CustomModelTestsConfig | false | Key value map of Testing type and Testing type config. | |
| customModelId | string | true | The ID of the custom model to test. | |
| customModelVersionId | string | true | The ID of custom model version to use. | |
| datasetId | string | false | The ID of the dataset to use for testing. Dataset ID is required for regular (non-unstructured) custom models. | |
| datasetVersionId | string | false | The ID of the version of the dataset item to use as the testing dataset. Defaults to the latest version. | |
| desiredMemory | integer¦null | false | maximum: 15032385536 minimum: 134217728 |
The amount of memory that is expected to be allocated by the custom model. This setting is incompatible with setting the resourceBundleId. |
| environmentId | string | false | The ID of environment to use. If not specified, the customModelVersion's dependency environment will be used. | |
| environmentVersionId | string | false | The ID of environment version to use. Defaults to the latest successfully built version. | |
| maximumMemory | integer¦null | false | maximum: 15032385536 minimum: 134217728 |
The maximum memory that might be allocated by the custom-model. If exceeded, the custom-model will be killed. This setting is incompatible with setting the resourceBundleId. |
| networkEgressPolicy | string¦null | false | Network egress policy. | |
| replicas | integer¦null | false | maximum: 8 minimum: 0 (exclusive) |
A fixed number of replicas that will be set for the given custom-model. |
| requiresHa | boolean¦null | false | Require all custom model replicas to be deployed on different Kubernetes nodes for predictions fault tolerance. | |
| resourceBundleId | string¦null | false | A single identifier that represents a bundle of resources: Memory, CPU, GPU, etc. A list of available bundles can be obtained via the resource bundles endpoint. |
Enumerated Values¶
| Property | Value |
|---|---|
| networkEgressPolicy | [NONE, PUBLIC] |
CustomModelTestsConfig
{
"errorCheck": "fail",
"longRunningService": "fail",
"nullValueImputation": "skip",
"sideEffects": "skip"
}
Key value map of Testing type and Testing type config.
Properties¶
| Name | Type | Required | Restrictions | Description |
|---|---|---|---|---|
| errorCheck | string | false | Ensures that the model can make predictions on the provided test dataset. | |
| longRunningService | string | false | Ensures that the custom model image can build and launch. If it cannot, the test is marked as Failed and subsequent test are aborted. | |
| nullValueImputation | string | false | Verifies that the model can impute null values. Required for Feature Impact. | |
| sideEffects | string | false | Verifies that predictions made on the dataset match row-wise predictions for the same dataset. Fails if the predictions do not match. |
Enumerated Values¶
| Property | Value |
|---|---|
| errorCheck | [fail, skip] |
| longRunningService | fail |
| nullValueImputation | [skip, warn, fail] |
| sideEffects | [skip, warn, fail] |
CustomModelTestsListResponse
{
"count": 0,
"data": [
{
"completedAt": "string",
"created": "string",
"createdBy": "string",
"customModel": {
"id": "string",
"name": "string"
},
"customModelImageId": "string",
"customModelVersion": {
"id": "string",
"label": "string"
},
"datasetId": "string",
"datasetVersionId": "string",
"desiredMemory": 134217728,
"executionEnvironment": {
"id": "string",
"name": "string"
},
"executionEnvironmentVersion": {
"id": "string",
"label": "string"
},
"id": "string",
"imageType": "customModelImage",
"maximumMemory": 134217728,
"networkEgressPolicy": "NONE",
"overallStatus": "not_tested",
"replicas": 0,
"requiresHa": true,
"resourceBundleId": "string",
"testingStatus": {
"errorCheck": {
"message": "string",
"status": "not_tested"
},
"longRunningService": {
"message": "string",
"status": "not_tested"
},
"nullValueImputation": {
"message": "string",
"status": "not_tested"
},
"sideEffects": {
"message": "string",
"status": "not_tested"
}
}
}
],
"next": "http://example.com",
"previous": "http://example.com",
"totalCount": 0
}
Properties¶
| Name | Type | Required | Restrictions | Description |
|---|---|---|---|---|
| count | integer | false | Number of items returned on this page. | |
| data | [CustomModelTestsResponse] | true | List of custom model tests. | |
| next | string(uri)¦null | true | URL pointing to the next page (if null, there is no next page). | |
| previous | string(uri)¦null | true | URL pointing to the previous page (if null, there is no previous page). | |
| totalCount | integer | true | The total number of items across all pages. |
CustomModelTestsLogTailResponse
{
"log": "string"
}
Properties¶
| Name | Type | Required | Restrictions | Description |
|---|---|---|---|---|
| log | string | true | The N lines of the log. |
CustomModelTestsResponse
{
"completedAt": "string",
"created": "string",
"createdBy": "string",
"customModel": {
"id": "string",
"name": "string"
},
"customModelImageId": "string",
"customModelVersion": {
"id": "string",
"label": "string"
},
"datasetId": "string",
"datasetVersionId": "string",
"desiredMemory": 134217728,
"executionEnvironment": {
"id": "string",
"name": "string"
},
"executionEnvironmentVersion": {
"id": "string",
"label": "string"
},
"id": "string",
"imageType": "customModelImage",
"maximumMemory": 134217728,
"networkEgressPolicy": "NONE",
"overallStatus": "not_tested",
"replicas": 0,
"requiresHa": true,
"resourceBundleId": "string",
"testingStatus": {
"errorCheck": {
"message": "string",
"status": "not_tested"
},
"longRunningService": {
"message": "string",
"status": "not_tested"
},
"nullValueImputation": {
"message": "string",
"status": "not_tested"
},
"sideEffects": {
"message": "string",
"status": "not_tested"
}
}
}
Properties¶
| Name | Type | Required | Restrictions | Description |
|---|---|---|---|---|
| completedAt | string | true | ISO-8601 timestamp of when the testing attempt was completed. | |
| created | string | true | ISO-8601 timestamp of when the testing entry was created. | |
| createdBy | string | true | The username of the user that started the custom model test. | |
| customModel | CustomModelShortResponse | true | Custom model associated with this deployment. | |
| customModelImageId | string¦null | true | If testing was successful, ID of the custom inference model image that can be used for a deployment, otherwise null. | |
| customModelVersion | CustomModelVersionShortResponse | true | Custom model version associated with this deployment. | |
| datasetId | string | true | ID of the dataset used for testing. | |
| datasetVersionId | string | true | ID of the specific dataset version used for testing. | |
| desiredMemory | integer¦null | false | maximum: 15032385536 minimum: 134217728 |
The amount of memory that is expected to be allocated by the custom model. This setting is incompatible with setting the resourceBundleId. |
| executionEnvironment | ExecutionEnvironmentShortResponse | true | Execution environment associated with this deployment. | |
| executionEnvironmentVersion | ExecutionEnvironmentVersionShortResponse | true | Execution environment version associated with this deployment. | |
| id | string | true | ID of the testing history entry. | |
| imageType | string | false | The type of the image, either customModelImage if the testing attempt is using a customModelImage as its model or customModelVersion if the testing attempt is using a customModelVersion with dependency management. | |
| maximumMemory | integer¦null | false | maximum: 15032385536 minimum: 134217728 |
The maximum memory that might be allocated by the custom-model. If exceeded, the custom-model will be killed. This setting is incompatible with setting the resourceBundleId. |
| networkEgressPolicy | string¦null | false | Network egress policy. | |
| overallStatus | string | true | The overall status of the testing history entry. | |
| replicas | integer¦null | false | maximum: 8 minimum: 0 (exclusive) |
A fixed number of replicas that will be set for the given custom-model. |
| requiresHa | boolean¦null | false | Require all custom model replicas to be deployed on different Kubernetes nodes for predictions fault tolerance. | |
| resourceBundleId | string¦null | false | A single identifier that represents a bundle of resources: Memory, CPU, GPU, etc. A list of available bundles can be obtained via the resource bundles endpoint. | |
| testingStatus | CustomModelTesting | true | Maps the testing types to their status and message for the testing entry. Testing type represents a single check executed during the test. |
Enumerated Values¶
| Property | Value |
|---|---|
| imageType | [customModelImage, customModelVersion] |
| networkEgressPolicy | [NONE, PUBLIC] |
| overallStatus | [not_tested, queued, failed, canceled, succeeded, in_progress, aborted, warning, skipped] |
CustomModelUpdate
{
"classLabels": [
"string"
],
"description": "string",
"desiredMemory": 134217728,
"gitModelVersion": {
"commitUrl": "http://example.com",
"mainBranchCommitSha": "stringstringstringstringstringstringstri",
"pullRequestCommitSha": null,
"refName": "string"
},
"isTrainingDataForVersionsPermanentlyEnabled": true,
"language": "string",
"maximumMemory": 134217728,
"name": "string",
"negativeClassLabel": "string",
"networkEgressPolicy": "NONE",
"positiveClassLabel": "string",
"predictionThreshold": 0.5,
"replicas": 0,
"requiresHa": true,
"targetName": "string"
}
Properties¶
| Name | Type | Required | Restrictions | Description |
|---|---|---|---|---|
| classLabels | [string] | false | maxItems: 100 |
The class labels for multiclass classification. Required for multiclass inference models. If using one of the [DataRobot] base environments and your model produces an ndarray of unlabeled class probabilities, the order of the labels should match the order of the predicted output |
| description | string | false | maxLength: 10000 |
The user-friendly description of the model. |
| desiredMemory | integer¦null | false | maximum: 15032385536 minimum: 134217728 |
The amount of memory that is expected to be allocated by the custom model. |
| gitModelVersion | GitModelVersion | false | Contains git related attributes that are associated with a custom model version. | |
| isTrainingDataForVersionsPermanentlyEnabled | boolean | false | Indicates that training data assignment is now permanently at the version level only for the custom model. Once enabled, this cannot be disabled. Training data assignment on the model level PATCH /api/v2/customModels/{customModelId}/trainingData/ will be permanently disabled for this particular model. | |
| language | string | false | maxLength: 500 |
Programming language name in which model is written. |
| maximumMemory | integer¦null | false | maximum: 15032385536 minimum: 134217728 |
The maximum memory that might be allocated by the custom-model. If exceeded, the custom-model will be killed |
| name | string | false | maxLength: 255 |
The user-friendly name for the model. |
| negativeClassLabel | string¦null | false | maxLength: 500 |
The negative class label for custom models that support binary classification. If specified, positiveClassLabel must also be specified. Default value is "0". |
| networkEgressPolicy | string¦null | false | Network egress policy. | |
| positiveClassLabel | string¦null | false | maxLength: 500 |
The positive class label for custom models that support binary classification. If specified, negativeClassLabel must also be specified. Default value is "1". |
| predictionThreshold | number | false | maximum: 1 minimum: 0 |
The prediction threshold which will be used for binary classification custom model. |
| replicas | integer¦null | false | maximum: 8 minimum: 0 (exclusive) |
A fixed number of replicas that will be set for the given custom-model. |
| requiresHa | boolean¦null | false | Require all custom model replicas to be deployed on different Kubernetes nodes for predictions fault tolerance. | |
| targetName | string¦null | false | maxLength: 500 |
The name of the target for labeling predictions. Required for model type 'inference'. Specifying this value for a model type 'training' will result in an error. |
Enumerated Values¶
| Property | Value |
|---|---|
| networkEgressPolicy | [NONE, DR_API_ACCESS, PUBLIC] |
CustomModelVersionCreate
{
"baseEnvironmentId": "string",
"baseEnvironmentVersionId": "string",
"desiredMemory": 134217728,
"file": "string",
"filePath": "string",
"gitModelVersion": {
"commitUrl": "http://example.com",
"mainBranchCommitSha": "stringstringstringstringstringstringstri",
"pullRequestCommitSha": null,
"refName": "string"
},
"holdoutData": "string",
"isMajorUpdate": "false",
"keepTrainingHoldoutData": "true",
"maximumMemory": 134217728,
"networkEgressPolicy": "NONE",
"replicas": 0,
"requiredMetadata": "string",
"requiredMetadataValues": "string",
"requiresHa": true,
"resourceBundleId": "string",
"trainingData": "string"
}
Properties¶
| Name | Type | Required | Restrictions | Description |
|---|---|---|---|---|
| baseEnvironmentId | string | false | The base environment to use with this model version. At least one of "baseEnvironmentId" and "baseEnvironmentVersionId" must be provided. If both are specified, the version must belong to the environment. | |
| baseEnvironmentVersionId | string | false | The base environment version ID to use with this model version. At least one of "baseEnvironmentId" and "baseEnvironmentVersionId" must be provided. If both are specified, the version must belong to the environment. If not specified: in the case where the previous model versions exist, the value from the latest model version is inherited, otherwise, the latest successfully built version of the environment specified in "baseEnvironmentId" is used. | |
| desiredMemory | integer¦null | false | maximum: 15032385536 minimum: 134217728 |
The amount of memory that is expected to be allocated by the custom model. This setting is incompatible with setting the resourceBundleId. |
| file | string(binary) | false | A file with code for a custom task or a custom model. For each file supplied as form data, you must have a corresponding filePath supplied that shows the relative location of the file. For example, you have two files: /home/username/custom-task/main.py and /home/username/custom-task/helpers/helper.py. When uploading these files, you would also need to include two filePath fields of, "main.py" and "helpers/helper.py". If the supplied file already exists at the supplied filePath, the old file is replaced by the new file. |
|
| filePath | any | false | The local path of the file being uploaded. See the file field explanation for more details. |
oneOf
| Name | Type | Required | Restrictions | Description |
|---|---|---|---|---|
| » anonymous | string | false | none |
xor
| Name | Type | Required | Restrictions | Description |
|---|---|---|---|---|
| » anonymous | [string] | false | none |
continued
| Name | Type | Required | Restrictions | Description |
|---|---|---|---|---|
| gitModelVersion | GitModelVersion | false | Contains git related attributes that are associated with a custom model version. | |
| holdoutData | string¦null | false | Holdout data configuration may be supplied for version. This functionality has to be explicitly enabled for the current model. See isTrainingDataForVersionsPermanentlyEnabled parameter for POST /api/v2/customModels/ and PATCH /api/v2/customModels/{customModelId}/ | |
| isMajorUpdate | string | true | If set to true, new major version will created, otherwise minor version will be created. | |
| keepTrainingHoldoutData | boolean | false | If the version should inherit training and holdout data from the previous version. Defaults to true.This field is only applicable if the model has training data for versions enabled. Otherwise the field value will be ignored. | |
| maximumMemory | integer¦null | false | maximum: 15032385536 minimum: 134217728 |
The maximum memory that might be allocated by the custom-model. If exceeded, the custom-model will be killed. This setting is incompatible with setting the resourceBundleId. |
| networkEgressPolicy | string¦null | false | Network egress policy. | |
| replicas | integer¦null | false | maximum: 8 minimum: 0 (exclusive) |
A fixed number of replicas that will be set for the given custom-model. |
| requiredMetadata | string | false | Additional parameters required by the execution environment. The required keys are defined by the fieldNames in the base environment's requiredMetadataKeys. Once set, they cannot be changed. If you to change them, make a new version. | |
| requiredMetadataValues | string | false | Additional parameters required by the execution environment. The required fieldNames are defined by the fieldNames in the base environment's requiredMetadataKeys. | |
| requiresHa | boolean¦null | false | Require all custom model replicas to be deployed on different Kubernetes nodes for predictions fault tolerance. | |
| resourceBundleId | string¦null | false | A single identifier that represents a bundle of resources: Memory, CPU, GPU, etc. A list of available bundles can be obtained via the resource bundles endpoint. | |
| trainingData | string¦null | false | Training data configuration may be supplied for version. This functionality has to be explicitly enabled for the current model. See isTrainingDataForVersionsPermanentlyEnabled parameter for POST /api/v2/customModels/ and PATCH /api/v2/customModels/{customModelId}/ |
Enumerated Values¶
| Property | Value |
|---|---|
| isMajorUpdate | [false, False, true, True] |
| networkEgressPolicy | [NONE, PUBLIC] |
CustomModelVersionCreateFromLatest
{
"baseEnvironmentId": "string",
"baseEnvironmentVersionId": "string",
"desiredMemory": 134217728,
"file": "string",
"filePath": "string",
"filesToDelete": "string",
"gitModelVersion": {
"commitUrl": "http://example.com",
"mainBranchCommitSha": "stringstringstringstringstringstringstri",
"pullRequestCommitSha": null,
"refName": "string"
},
"holdoutData": "string",
"isMajorUpdate": "false",
"keepTrainingHoldoutData": "true",
"maximumMemory": 134217728,
"networkEgressPolicy": "NONE",
"replicas": 0,
"requiredMetadata": "string",
"requiredMetadataValues": "string",
"requiresHa": true,
"resourceBundleId": "string",
"trainingData": "string"
}
Properties¶
| Name | Type | Required | Restrictions | Description |
|---|---|---|---|---|
| baseEnvironmentId | string | false | The base environment to use with this model version. At least one of "baseEnvironmentId" and "baseEnvironmentVersionId" must be provided. If both are specified, the version must belong to the environment. | |
| baseEnvironmentVersionId | string | false | The base environment version ID to use with this model version. At least one of "baseEnvironmentId" and "baseEnvironmentVersionId" must be provided. If both are specified, the version must belong to the environment. If not specified: in the case where the previous model versions exist, the value from the latest model version is inherited, otherwise, the latest successfully built version of the environment specified in "baseEnvironmentId" is used. | |
| desiredMemory | integer¦null | false | maximum: 15032385536 minimum: 134217728 |
The amount of memory that is expected to be allocated by the custom model. This setting is incompatible with setting the resourceBundleId. |
| file | string(binary) | false | A file with code for a custom task or a custom model. For each file supplied as form data, you must have a corresponding filePath supplied that shows the relative location of the file. For example, you have two files: /home/username/custom-task/main.py and /home/username/custom-task/helpers/helper.py. When uploading these files, you would also need to include two filePath fields of, "main.py" and "helpers/helper.py". If the supplied file already exists at the supplied filePath, the old file is replaced by the new file. |
|
| filePath | any | false | The local path of the file being uploaded. See the file field explanation for more details. |
oneOf
| Name | Type | Required | Restrictions | Description |
|---|---|---|---|---|
| » anonymous | string | false | none |
xor
| Name | Type | Required | Restrictions | Description |
|---|---|---|---|---|
| » anonymous | [string] | false | none |
continued
| Name | Type | Required | Restrictions | Description |
|---|---|---|---|---|
| filesToDelete | any | false | The IDs of the files to be deleted. |
oneOf
| Name | Type | Required | Restrictions | Description |
|---|---|---|---|---|
| » anonymous | string | false | none |
xor
| Name | Type | Required | Restrictions | Description |
|---|---|---|---|---|
| » anonymous | [string] | false | none |
continued
| Name | Type | Required | Restrictions | Description |
|---|---|---|---|---|
| gitModelVersion | GitModelVersion | false | Contains git related attributes that are associated with a custom model version. | |
| holdoutData | string¦null | false | Holdout data configuration may be supplied for version. This functionality has to be explicitly enabled for the current model. See isTrainingDataForVersionsPermanentlyEnabled parameter for POST /api/v2/customModels/ and PATCH /api/v2/customModels/{customModelId}/ | |
| isMajorUpdate | string | true | If set to true, new major version will created, otherwise minor version will be created. | |
| keepTrainingHoldoutData | boolean | false | If the version should inherit training and holdout data from the previous version. Defaults to true.This field is only applicable if the model has training data for versions enabled. Otherwise the field value will be ignored. | |
| maximumMemory | integer¦null | false | maximum: 15032385536 minimum: 134217728 |
The maximum memory that might be allocated by the custom-model. If exceeded, the custom-model will be killed. This setting is incompatible with setting the resourceBundleId. |
| networkEgressPolicy | string¦null | false | Network egress policy. | |
| replicas | integer¦null | false | maximum: 8 minimum: 0 (exclusive) |
A fixed number of replicas that will be set for the given custom-model. |
| requiredMetadata | string | false | Additional parameters required by the execution environment. The required keys are defined by the fieldNames in the base environment's requiredMetadataKeys. Once set, they cannot be changed. If you to change them, make a new version. | |
| requiredMetadataValues | string | false | Additional parameters required by the execution environment. The required fieldNames are defined by the fieldNames in the base environment's requiredMetadataKeys. | |
| requiresHa | boolean¦null | false | Require all custom model replicas to be deployed on different Kubernetes nodes for predictions fault tolerance. | |
| resourceBundleId | string¦null | false | A single identifier that represents a bundle of resources: Memory, CPU, GPU, etc. A list of available bundles can be obtained via the resource bundles endpoint. | |
| trainingData | string¦null | false | Training data configuration may be supplied for version. This functionality has to be explicitly enabled for the current model. See isTrainingDataForVersionsPermanentlyEnabled parameter for POST /api/v2/customModels/ and PATCH /api/v2/customModels/{customModelId}/ |
Enumerated Values¶
| Property | Value |
|---|---|
| isMajorUpdate | [false, False, true, True] |
| networkEgressPolicy | [NONE, PUBLIC] |
CustomModelVersionCreateFromRepository
{
"baseEnvironmentId": "string",
"isMajorUpdate": true,
"keepTrainingHoldoutData": "true",
"ref": "string",
"repositoryId": "string",
"requiredMetadata": {},
"requiredMetadataValues": [
{
"fieldName": "string",
"value": "string"
}
],
"sourcePath": "string"
}
Properties¶
| Name | Type | Required | Restrictions | Description |
|---|---|---|---|---|
| baseEnvironmentId | string | false | The base environment to use with this version. | |
| isMajorUpdate | boolean | false | If set to true, new major version will created, otherwise minor version will be created. | |
| keepTrainingHoldoutData | boolean | false | If the version should inherit training and holdout data from the previous version. Defaults to true.This field is only applicable if the model has training data for versions enabled. Otherwise the field value will be ignored. | |
| ref | string | false | Remote reference (branch, commit, etc). Latest, if not specified. | |
| repositoryId | string | true | The ID of remote repository used to pull sources. This ID can be found using the /api/v2/remoteRepositories/ endpoint. | |
| requiredMetadata | object | false | Additional parameters required by the execution environment. The required keys are defined by the fieldNames in the base environment's requiredMetadataKeys. Once set, they cannot be changed. If you to change them, make a new version. | |
| requiredMetadataValues | [RequiredMetadataValue] | false | Additional parameters required by the execution environment. The required fieldNames are defined by the fieldNames in the base environment's requiredMetadataKeys. | |
| sourcePath | any | false | A remote repository file path to be pulled into a custom model or custom task. |
oneOf
| Name | Type | Required | Restrictions | Description |
|---|---|---|---|---|
| » anonymous | string | false | none |
xor
| Name | Type | Required | Restrictions | Description |
|---|---|---|---|---|
| » anonymous | [string] | false | none |
CustomModelVersionListResponse
{
"count": 0,
"data": [
{
"baseEnvironmentId": "string",
"baseEnvironmentVersionId": "string",
"created": "string",
"customModelId": "string",
"dependencies": [
{
"constraints": [
{
"constraintType": "<",
"version": "string"
}
],
"extras": "string",
"line": "string",
"lineNumber": 0,
"packageName": "string"
}
],
"description": "string",
"desiredMemory": 134217728,
"gitModelVersion": {
"commitUrl": "http://example.com",
"mainBranchCommitSha": "stringstringstringstringstringstringstri",
"pullRequestCommitSha": null,
"refName": "string"
},
"holdoutData": {
"datasetId": "string",
"datasetName": "string",
"datasetVersionId": "string",
"partitionColumn": "string"
},
"id": "string",
"isFrozen": true,
"items": [
{
"commitSha": "string",
"created": "string",
"fileName": "string",
"filePath": "string",
"fileSource": "string",
"id": "string",
"ref": "string",
"repositoryFilePath": "string",
"repositoryLocation": "string",
"repositoryName": "string",
"storagePath": "string",
"workspaceId": "string"
}
],
"label": "string",
"maximumMemory": 134217728,
"networkEgressPolicy": "NONE",
"replicas": 0,
"requiredMetadata": {},
"requiredMetadataValues": [
{
"fieldName": "string",
"value": "string"
}
],
"requiresHa": true,
"resourceBundleId": "string",
"trainingData": {
"assignmentError": {
"message": "string"
},
"assignmentInProgress": false,
"datasetId": "string",
"datasetName": "string",
"datasetVersionId": "string"
},
"versionMajor": 0,
"versionMinor": 0
}
],
"next": "http://example.com",
"previous": "http://example.com",
"totalCount": 0
}
Properties¶
| Name | Type | Required | Restrictions | Description |
|---|---|---|---|---|
| count | integer | false | Number of items returned on this page. | |
| data | [CustomModelVersionResponse] | true | List of custom model versions. | |
| next | string(uri)¦null | true | URL pointing to the next page (if null, there is no next page). | |
| previous | string(uri)¦null | true | URL pointing to the previous page (if null, there is no previous page). | |
| totalCount | integer | true | The total number of items across all pages. |
CustomModelVersionMetadataUpdate
{
"description": "string",
"gitModelVersion": {
"commitUrl": "http://example.com",
"mainBranchCommitSha": "stringstringstringstringstringstringstri",
"pullRequestCommitSha": null,
"refName": "string"
},
"requiredMetadata": {},
"requiredMetadataValues": [
{
"fieldName": "string",
"value": "string"
}
]
}
Properties¶
| Name | Type | Required | Restrictions | Description |
|---|---|---|---|---|
| description | string | false | maxLength: 10000 |
New description for the custom task or model. |
| gitModelVersion | GitModelVersion | false | Contains git related attributes that are associated with a custom model version. | |
| requiredMetadata | object | false | Additional parameters required by the execution environment. The required keys are defined by the fieldNames in the base environment's requiredMetadataKeys. | |
| requiredMetadataValues | [RequiredMetadataValue] | false | Additional parameters required by the execution environment. The required fieldNames are defined by the fieldNames in the base environment's requiredMetadataKeys. |
CustomModelVersionResponse
{
"baseEnvironmentId": "string",
"baseEnvironmentVersionId": "string",
"created": "string",
"customModelId": "string",
"dependencies": [
{
"constraints": [
{
"constraintType": "<",
"version": "string"
}
],
"extras": "string",
"line": "string",
"lineNumber": 0,
"packageName": "string"
}
],
"description": "string",
"desiredMemory": 134217728,
"gitModelVersion": {
"commitUrl": "http://example.com",
"mainBranchCommitSha": "stringstringstringstringstringstringstri",
"pullRequestCommitSha": null,
"refName": "string"
},
"holdoutData": {
"datasetId": "string",
"datasetName": "string",
"datasetVersionId": "string",
"partitionColumn": "string"
},
"id": "string",
"isFrozen": true,
"items": [
{
"commitSha": "string",
"created": "string",
"fileName": "string",
"filePath": "string",
"fileSource": "string",
"id": "string",
"ref": "string",
"repositoryFilePath": "string",
"repositoryLocation": "string",
"repositoryName": "string",
"storagePath": "string",
"workspaceId": "string"
}
],
"label": "string",
"maximumMemory": 134217728,
"networkEgressPolicy": "NONE",
"replicas": 0,
"requiredMetadata": {},
"requiredMetadataValues": [
{
"fieldName": "string",
"value": "string"
}
],
"requiresHa": true,
"resourceBundleId": "string",
"trainingData": {
"assignmentError": {
"message": "string"
},
"assignmentInProgress": false,
"datasetId": "string",
"datasetName": "string",
"datasetVersionId": "string"
},
"versionMajor": 0,
"versionMinor": 0
}
The latest version for the custom model (if this field is empty, the model is not ready for use).
Properties¶
| Name | Type | Required | Restrictions | Description |
|---|---|---|---|---|
| baseEnvironmentId | string¦null | false | The base environment to use with this model version. | |
| baseEnvironmentVersionId | string¦null | false | The base environment version to use with this model version. | |
| created | string | true | ISO-8601 timestamp of when the model was created. | |
| customModelId | string | true | the ID of the custom model. | |
| dependencies | [DependencyResponse] | false | The parsed dependencies of the custom model version if the version has a valid requirements.txt file. | |
| description | string¦null | true | Description of a custom model version. | |
| desiredMemory | integer¦null | false | maximum: 15032385536 minimum: 134217728 |
The amount of memory that is expected to be allocated by the custom model. This setting is incompatible with setting the resourceBundleId. |
| gitModelVersion | GitModelVersion | false | Contains git related attributes that are associated with a custom model version. | |
| holdoutData | HoldoutDataResponse | false | Holdout data configuration. | |
| id | string | true | the ID of the custom model version created. | |
| isFrozen | boolean | true | If the version is frozen and immutable (i.e. it is either deployed or has been edited, causing a newer version to be yielded). | |
| items | [DeprecatedCustomModelWorkspaceItemResponse] | true | List of file items. | |
| label | string | true | A semantic version number of the major and minor version. | |
| maximumMemory | integer¦null | false | maximum: 15032385536 minimum: 134217728 |
The maximum memory that might be allocated by the custom-model. If exceeded, the custom-model will be killed. This setting is incompatible with setting the resourceBundleId. |
| networkEgressPolicy | string¦null | false | Network egress policy. | |
| replicas | integer¦null | false | maximum: 8 minimum: 0 (exclusive) |
A fixed number of replicas that will be set for the given custom-model. |
| requiredMetadata | object | false | Additional parameters required by the execution environment. The required keys are defined by the fieldNames in the base environment's requiredMetadataKeys. Once set, they cannot be changed. If you to change them, make a new version. | |
| requiredMetadataValues | [RequiredMetadataValue] | false | Additional parameters required by the execution environment. The required fieldNames are defined by the fieldNames in the base environment's requiredMetadataKeys. | |
| requiresHa | boolean¦null | false | Require all custom model replicas to be deployed on different Kubernetes nodes for predictions fault tolerance. | |
| resourceBundleId | string¦null | false | A single identifier that represents a bundle of resources: Memory, CPU, GPU, etc. A list of available bundles can be obtained via the resource bundles endpoint. | |
| trainingData | TrainingDataResponse | false | Training data configuration. | |
| versionMajor | integer | true | The major version number, incremented on deployments or larger file changes. | |
| versionMinor | integer | true | The minor version number, incremented on general file changes. |
Enumerated Values¶
| Property | Value |
|---|---|
| networkEgressPolicy | [NONE, PUBLIC] |
CustomModelVersionShortResponse
{
"id": "string",
"label": "string"
}
Custom model version associated with this deployment.
Properties¶
| Name | Type | Required | Restrictions | Description |
|---|---|---|---|---|
| id | string | true | The ID of the custom model version. | |
| label | string | true | User-friendly name of the model version. |
DependencyConstraint
{
"constraintType": "<",
"version": "string"
}
Properties¶
| Name | Type | Required | Restrictions | Description |
|---|---|---|---|---|
| constraintType | string | true | The constraint type to apply to the version. | |
| version | string | true | The version label to use in the constraint. |
Enumerated Values¶
| Property | Value |
|---|---|
| constraintType | [<, <=, ==, >=, >] |
DependencyResponse
{
"constraints": [
{
"constraintType": "<",
"version": "string"
}
],
"extras": "string",
"line": "string",
"lineNumber": 0,
"packageName": "string"
}
Properties¶
| Name | Type | Required | Restrictions | Description |
|---|---|---|---|---|
| constraints | [DependencyConstraint] | true | Constraints that should be applied to the dependency when installed. | |
| extras | string | false | The dependency's package extras. | |
| line | string | true | The original line from the requirements.txt file. | |
| lineNumber | integer | true | The line number the requirement was on in requirements.txt. | |
| packageName | string | true | The dependency's package name. |
Deployment
{
"createdAt": "2019-08-24T14:15:22Z",
"creatorFirstName": "string",
"creatorGravatarHash": "string",
"creatorLastName": "string",
"creatorUsername": "string",
"id": "string",
"name": "string"
}
The deployment associated to the custom metric.
Properties¶
| Name | Type | Required | Restrictions | Description |
|---|---|---|---|---|
| createdAt | string(date-time) | true | Timestamp when the deployment was created. | |
| creatorFirstName | string¦null | true | First name of the deployment creator. | |
| creatorGravatarHash | string¦null | true | Gravatar hash of the deployment creator. | |
| creatorLastName | string¦null | true | Last name of the deployment creator. | |
| creatorUsername | string¦null | true | Username of the deployment creator. | |
| id | string | true | The ID of the deployment. | |
| name | string | true | Name of the deployment. |
DeprecatedCustomModelVersionTrainingDataUpdate
{
"gitModelVersion": {
"commitUrl": "http://example.com",
"mainBranchCommitSha": "stringstringstringstringstringstringstri",
"pullRequestCommitSha": null,
"refName": "string"
},
"holdoutData": {
"datasetId": "string",
"datasetName": "string",
"datasetVersionId": "string",
"partitionColumn": "string"
},
"trainingData": {
"assignmentInProgress": false,
"datasetId": "string",
"datasetName": "string",
"datasetVersionId": "string"
}
}
Properties¶
| Name | Type | Required | Restrictions | Description |
|---|---|---|---|---|
| gitModelVersion | GitModelVersion | false | Contains git related attributes that are associated with a custom model version. | |
| holdoutData | DeprecatedHoldoutDataAssignment | false | Holdout data configuration. | |
| trainingData | DeprecatedTrainingDataForVersionsAssignment | true | Training data configuration. |
DeprecatedCustomModelWorkspaceItemResponse
{
"commitSha": "string",
"created": "string",
"fileName": "string",
"filePath": "string",
"fileSource": "string",
"id": "string",
"ref": "string",
"repositoryFilePath": "string",
"repositoryLocation": "string",
"repositoryName": "string",
"storagePath": "string",
"workspaceId": "string"
}
Properties¶
| Name | Type | Required | Restrictions | Description |
|---|---|---|---|---|
| commitSha | string¦null | false | SHA1 hash pointing to the original file revision (set only for files pulled from Git-like repositories). | |
| created | string | true | ISO-8601 timestamp of when the file item was created. | |
| fileName | string | true | Name of the file item. | |
| filePath | string | true | Path of the file item. | |
| fileSource | string | true | Source of the file item. | |
| id | string | true | ID of the file item. | |
| ref | string¦null | false | Remote reference (branch, commit, tag). Branch "master", if not specified. | |
| repositoryFilePath | string¦null | false | Full path to the file in the remote repository. | |
| repositoryLocation | string¦null | false | URL to remote repository from which the file was pulled (e.g. Git server or S3 Bucket name). | |
| repositoryName | string¦null | false | Name of the repository from which the file was pulled. | |
| storagePath | string | true | Storage path of the file item. | |
| workspaceId | string | true | Workspace ID of the file item. |
DeprecatedHoldoutDataAssignment
{
"datasetId": "string",
"datasetName": "string",
"datasetVersionId": "string",
"partitionColumn": "string"
}
Holdout data configuration.
Properties¶
| Name | Type | Required | Restrictions | Description |
|---|---|---|---|---|
| datasetId | string¦null | false | The ID of the dataset. | |
| datasetName | string¦null | false | maxLength: 255 |
A user-friendly name for the dataset. |
| datasetVersionId | string¦null | false | The ID of the dataset version. | |
| partitionColumn | string¦null | false | maxLength: 500 |
The name of the column containing the partition assignments. |
DeprecatedTrainingDataForModelsAssignment
{
"datasetId": "string",
"datasetName": "string",
"datasetVersionId": "string",
"partitionColumn": "string"
}
Properties¶
| Name | Type | Required | Restrictions | Description |
|---|---|---|---|---|
| datasetId | string¦null | false | The ID of the dataset. | |
| datasetName | string¦null | false | maxLength: 255 |
A user-friendly name for the dataset. |
| datasetVersionId | string¦null | false | The ID of the dataset version. | |
| partitionColumn | string¦null | false | maxLength: 500 |
The name of the column containing the partition assignments. |
DeprecatedTrainingDataForVersionsAssignment
{
"assignmentInProgress": false,
"datasetId": "string",
"datasetName": "string",
"datasetVersionId": "string"
}
Training data configuration.
Properties¶
| Name | Type | Required | Restrictions | Description |
|---|---|---|---|---|
| assignmentInProgress | boolean | false | Indicates if training data is currently being assigned to the custom model. Only for structured models. | |
| datasetId | string¦null | false | The ID of the dataset. | |
| datasetName | string¦null | false | maxLength: 255 |
A user-friendly name for the dataset. |
| datasetVersionId | string¦null | false | The ID of the dataset version. |
ExecutionEnvironmentShortResponse
{
"id": "string",
"name": "string"
}
Execution environment associated with this deployment.
Properties¶
| Name | Type | Required | Restrictions | Description |
|---|---|---|---|---|
| id | string | true | The ID of the execution environment. | |
| name | string | true | User-friendly name of the execution environment. |
ExecutionEnvironmentVersionShortResponse
{
"id": "string",
"label": "string"
}
Execution environment version associated with this deployment.
Properties¶
| Name | Type | Required | Restrictions | Description |
|---|---|---|---|---|
| id | string | true | The ID of the execution environment version. | |
| label | string | true | User-friendly name of the execution environment version. |
FeatureImpactCreatePayload
{
"rowCount": 10
}
Properties¶
| Name | Type | Required | Restrictions | Description |
|---|---|---|---|---|
| rowCount | integer | false | maximum: 100000 minimum: 10 |
The sample size to use for Feature Impact computation. It is possible to re-compute Feature Impact with a different row count. |
FeatureImpactCreateResponse
{
"statusId": "string"
}
Properties¶
| Name | Type | Required | Restrictions | Description |
|---|---|---|---|---|
| statusId | string | true | ID that can be used with GET /api/v2/status/{statusId}/ for tracking job status. |
FeatureImpactItem
{
"featureName": "string",
"impactNormalized": 1,
"impactUnnormalized": 0,
"parentFeatureName": "string",
"redundantWith": "string"
}
Properties¶
| Name | Type | Required | Restrictions | Description |
|---|---|---|---|---|
| featureName | string | true | The name of the feature. | |
| impactNormalized | number | true | maximum: 1 |
The same as impactUnnormalized, but normalized such that the highest value is 1. |
| impactUnnormalized | number | true | How much worse the error metric score is when making predictions on modified data. | |
| parentFeatureName | string¦null | false | The name of the parent feature. | |
| redundantWith | string¦null | true | Name of feature that has the highest correlation with this feature. |
FeatureImpactResponse
{
"count": 0,
"featureImpacts": [
{
"featureName": "string",
"impactNormalized": 1,
"impactUnnormalized": 0,
"parentFeatureName": "string",
"redundantWith": "string"
}
],
"next": "http://example.com",
"previous": "http://example.com",
"ranRedundancyDetection": true,
"rowCount": 0,
"shapBased": true
}
Properties¶
| Name | Type | Required | Restrictions | Description |
|---|---|---|---|---|
| count | integer | true | Number of feature impact records in a given batch. | |
| featureImpacts | [FeatureImpactItem] | true | maxItems: 1000 |
A list which contains feature impact scores for each feature used by a model. If the model has more than 1000 features, the most important 1000 features are returned. |
| next | string(uri)¦null | true | URL for the next page of results or null. |
|
| previous | string(uri)¦null | true | URL for the next page of results or null. |
|
| ranRedundancyDetection | boolean | true | Indicates whether redundant feature identification was run while calculating this feature impact. | |
| rowCount | integer¦null | true | The number of rows that was used to calculate feature impact. For the feature impact calculated with the default logic, without specifying the rowCount, we return null here. |
|
| shapBased | boolean | true | Indicates whether feature impact was calculated using Shapley values. True for anomaly detection models when the project is unsupervised, as permutation approach is not applicable. Note that supervised projects must use an alternative route for SHAP impact: /api/v2/projects/(projectId)/models/(modelId)/shapImpact/ |
GeneratedMetadata
{
"outputColumns": [
[
"string"
]
],
"outputDatasets": [
"string"
]
}
Custom model conversion output metadata.
Properties¶
| Name | Type | Required | Restrictions | Description |
|---|---|---|---|---|
| outputColumns | [array] | true | A list of column lists that are associated with the output datasets from the custom model conversion process. | |
| outputDatasets | [string] | true | maxItems: 50 minItems: 1 |
A list of output datasets from the custom model conversion process. |
GitModelVersion
{
"commitUrl": "http://example.com",
"mainBranchCommitSha": "stringstringstringstringstringstringstri",
"pullRequestCommitSha": null,
"refName": "string"
}
Contains git related attributes that are associated with a custom model version.
Properties¶
| Name | Type | Required | Restrictions | Description |
|---|---|---|---|---|
| commitUrl | string(uri) | true | A URL to the commit page in GitHub repository. | |
| mainBranchCommitSha | string | true | maxLength: 40 minLength: 40 minLength: 40 |
Specifies the commit SHA-1 in GitHub repository from the main branch that corresponds to a given custom model version. |
| pullRequestCommitSha | string¦null | true | maxLength: 40 minLength: 40 minLength: 40 |
Specifies the commit SHA-1 in GitHub repository from the main branch that corresponds to a given custom model version. |
| refName | string | true | The branch or tag name that triggered the workflow run. For workflows triggered by push, this is the branch or tag ref that was pushed. For workflows triggered by pull_request, this is the pull request merge branch. |
GrantAccessControlWithId
{
"id": "string",
"role": "string",
"shareRecipientType": "user"
}
Properties¶
| Name | Type | Required | Restrictions | Description |
|---|---|---|---|---|
| id | string | true | The ID of the recipient. | |
| role | string | true | The role of the recipient on this entity. One of OWNER, USER, OBSERVER. | |
| shareRecipientType | string | true | Describes the recipient type, either user, group, or organization. |
Enumerated Values¶
| Property | Value |
|---|---|
| shareRecipientType | [user, group, organization] |
GrantAccessControlWithUsername
{
"role": "string",
"shareRecipientType": "user",
"username": "string"
}
Properties¶
| Name | Type | Required | Restrictions | Description |
|---|---|---|---|---|
| role | string | true | The role of the recipient on this entity. One of OWNER, USER, OBSERVER. | |
| shareRecipientType | string | true | Describes the recipient type, either user, group, or organization. | |
| username | string | true | Username of the user to update the access role for. |
Enumerated Values¶
| Property | Value |
|---|---|
| shareRecipientType | [user, group, organization] |
HoldoutDataResponse
{
"datasetId": "string",
"datasetName": "string",
"datasetVersionId": "string",
"partitionColumn": "string"
}
Holdout data configuration.
Properties¶
| Name | Type | Required | Restrictions | Description |
|---|---|---|---|---|
| datasetId | string¦null | false | The ID of the dataset. Should be provided only for unstructured models. | |
| datasetName | string¦null | false | maxLength: 255 |
A user-friendly name for the dataset. |
| datasetVersionId | string¦null | false | The ID of the dataset version. Should be provided only for unstructured models. | |
| partitionColumn | string¦null | false | maxLength: 500 |
The name of the column containing the partition assignments. |
HostedCustomMetricTemplateCreate
{
"directionality": "higherIsBetter",
"isModelSpecific": true,
"timeStep": "hour",
"type": "average",
"units": "string"
}
Properties¶
| Name | Type | Required | Restrictions | Description |
|---|---|---|---|---|
| directionality | string¦null | false | Directionality of the custom metric. This field is required for numeric custom metrics. | |
| isModelSpecific | boolean | true | Determines whether the metric is related to the model or deployment. | |
| timeStep | string | true | Custom metric time bucket size. | |
| type | string | true | Type (and aggregation character) of a metric. | |
| units | string¦null | false | Units or the Y-axis label of the given custom metric. This field is required for numeric custom metrics. |
Enumerated Values¶
| Property | Value |
|---|---|
| directionality | [higherIsBetter, lowerIsBetter] |
| timeStep | hour |
| type | [average, categorical, gauge, sum] |
HostedCustomMetricTemplateResponse
{
"createdAt": "2019-08-24T14:15:22Z",
"createdBy": "string",
"customJobId": "string",
"directionality": "higherIsBetter",
"id": "string",
"isModelSpecific": true,
"timeStep": "hour",
"type": "average",
"units": "string",
"updatedAt": "2019-08-24T14:15:22Z",
"updatedBy": "string"
}
Properties¶
| Name | Type | Required | Restrictions | Description |
|---|---|---|---|---|
| createdAt | string(date-time) | true | Hosted custom metric template creation timestamp. | |
| createdBy | string | true | ID of the user who created the hosted custom metric template. | |
| customJobId | string | true | ID of the associatedCustom job. | |
| directionality | string¦null | false | Directionality of the custom metric. This field is required for numeric custom metrics. | |
| id | string | true | ID of the hosted custom metric template. | |
| isModelSpecific | boolean | true | Determines whether the metric is related to the model or deployment. | |
| timeStep | string | true | Custom metric time bucket size. | |
| type | string | true | Type (and aggregation character) of a metric. | |
| units | string¦null | false | Units or the Y-axis label of the given custom metric. This field is required for numeric custom metrics. | |
| updatedAt | string(date-time) | true | Hosted custom metric template update timestamp. | |
| updatedBy | string | true | ID of the user who updated the hosted custom metric template. |
Enumerated Values¶
| Property | Value |
|---|---|
| directionality | [higherIsBetter, lowerIsBetter] |
| timeStep | hour |
| type | [average, categorical, gauge, sum] |
HostedCustomMetricTemplateUpdate
{
"directionality": "higherIsBetter",
"isModelSpecific": true,
"timeStep": "hour",
"type": "average",
"units": "string"
}
Properties¶
| Name | Type | Required | Restrictions | Description |
|---|---|---|---|---|
| directionality | string | false | Directionality of the custom metric. | |
| isModelSpecific | boolean | false | Determines whether the metric is related to the model or deployment. | |
| timeStep | string | false | Custom metric time bucket size. | |
| type | string | false | Type (and aggregation character) of a metric. | |
| units | string | false | Units or Y Label of given custom metric. |
Enumerated Values¶
| Property | Value |
|---|---|
| directionality | [higherIsBetter, lowerIsBetter] |
| timeStep | hour |
| type | [average, categorical, gauge, sum] |
MetricBaselineValue
{
"value": 0
}
Properties¶
| Name | Type | Required | Restrictions | Description |
|---|---|---|---|---|
| value | number | true | A reference value in given metric units. |
MetricCreateFromCustomJobResponse
{
"baselineValues": [
{
"value": 0
}
],
"createdAt": "2019-08-24T14:15:22Z",
"deployment": {
"createdAt": "2019-08-24T14:15:22Z",
"creatorFirstName": "string",
"creatorGravatarHash": "string",
"creatorLastName": "string",
"creatorUsername": "string",
"id": "string",
"name": "string"
},
"description": "",
"directionality": "higherIsBetter",
"id": "string",
"isModelSpecific": true,
"name": "string",
"sampleCount": {
"columnName": "string"
},
"schedule": {
"dayOfMonth": [
"*"
],
"dayOfWeek": [
"*"
],
"hour": [
"*"
],
"minute": [
"*"
],
"month": [
"*"
]
},
"timeStep": "hour",
"timestamp": {
"columnName": "string",
"timeFormat": "%m/%d/%Y"
},
"type": "average",
"units": "string",
"value": {
"columnName": "string"
}
}
Properties¶
| Name | Type | Required | Restrictions | Description |
|---|---|---|---|---|
| baselineValues | [MetricBaselineValue] | false | maxItems: 5 |
Baseline values |
| createdAt | string(date-time) | true | Hosted custom metric creation timestamp. | |
| deployment | Deployment | true | The deployment associated to the custom metric. | |
| description | string | false | maxLength: 1000 |
Description of the custom metric. |
| directionality | string¦null | true | Directionality of the custom metric. | |
| id | string | true | The ID of the custom metric. | |
| isModelSpecific | boolean | true | Determines whether the metric is related to the model or deployment. | |
| name | string | true | maxLength: 255 |
Name of the custom metric. |
| sampleCount | SampleCountField | false | Points to a weight column if users provide pre-aggregated metric values. Used with columnar datasets. | |
| schedule | Schedule | false | The scheduling information defining how often and when to execute this job to the Job Scheduling service. Optional if enabled = False. | |
| timeStep | string | true | Custom metric time bucket size. | |
| timestamp | MetricTimestampSpoofing | false | A custom metric timestamp spoofing when reading values from file, like dataset. By default, we replicate pd.to_datetime formatting behaviour. | |
| type | string | true | Type (and aggregation character) of a metric. | |
| units | string¦null | true | Units or the Y-axis label of the given custom metric. | |
| value | ValueField | false | A custom metric value source when reading values from columnar dataset like a file. |
Enumerated Values¶
| Property | Value |
|---|---|
| directionality | [higherIsBetter, lowerIsBetter] |
| timeStep | hour |
| type | [average, categorical, gauge, sum] |
MetricTimestampSpoofing
{
"columnName": "string",
"timeFormat": "%m/%d/%Y"
}
A custom metric timestamp spoofing when reading values from file, like dataset. By default, we replicate pd.to_datetime formatting behaviour.
Properties¶
| Name | Type | Required | Restrictions | Description |
|---|---|---|---|---|
| columnName | string¦null | false | Column name | |
| timeFormat | string¦null | false | Format |
Enumerated Values¶
| Property | Value |
|---|---|
| timeFormat | [%m/%d/%Y, %m/%d/%y, %d/%m/%y, %m-%d-%Y, %m-%d-%y, %Y/%m/%d, %Y-%m-%d, %Y-%m-%d %H:%M:%S, %Y/%m/%d %H:%M:%S, %Y.%m.%d %H:%M:%S, %Y-%m-%d %H:%M, %Y/%m/%d %H:%M, %y/%m/%d, %y-%m-%d, %y-%m-%d %H:%M:%S, %y.%m.%d %H:%M:%S, %y/%m/%d %H:%M:%S, %y-%m-%d %H:%M, %y.%m.%d %H:%M, %y/%m/%d %H:%M, %m/%d/%Y %H:%M, %m/%d/%y %H:%M, %d/%m/%Y %H:%M, %d/%m/%y %H:%M, %m-%d-%Y %H:%M, %m-%d-%y %H:%M, %d-%m-%Y %H:%M, %d-%m-%y %H:%M, %m.%d.%Y %H:%M, %m/%d.%y %H:%M, %d.%m.%Y %H:%M, %d.%m.%y %H:%M, %m/%d/%Y %H:%M:%S, %m/%d/%y %H:%M:%S, %m-%d-%Y %H:%M:%S, %m-%d-%y %H:%M:%S, %m.%d.%Y %H:%M:%S, %m.%d.%y %H:%M:%S, %d/%m/%Y %H:%M:%S, %d/%m/%y %H:%M:%S, %Y-%m-%d %H:%M:%S.%f, %y-%m-%d %H:%M:%S.%f, %Y-%m-%dT%H:%M:%S.%fZ, %y-%m-%dT%H:%M:%S.%fZ, %Y-%m-%dT%H:%M:%S.%f, %y-%m-%dT%H:%M:%S.%f, %Y-%m-%dT%H:%M:%S, %y-%m-%dT%H:%M:%S, %Y-%m-%dT%H:%M:%SZ, %y-%m-%dT%H:%M:%SZ, %Y.%m.%d %H:%M:%S.%f, %y.%m.%d %H:%M:%S.%f, %Y.%m.%dT%H:%M:%S.%fZ, %y.%m.%dT%H:%M:%S.%fZ, %Y.%m.%dT%H:%M:%S.%f, %y.%m.%dT%H:%M:%S.%f, %Y.%m.%dT%H:%M:%S, %y.%m.%dT%H:%M:%S, %Y.%m.%dT%H:%M:%SZ, %y.%m.%dT%H:%M:%SZ, %Y%m%d, %m %d %Y %H %M %S, %m %d %y %H %M %S, %H:%M, %M:%S, %H:%M:%S, %Y %m %d %H %M %S, %y %m %d %H %M %S, %Y %m %d, %y %m %d, %d/%m/%Y, %Y-%d-%m, %y-%d-%m, %Y/%d/%m %H:%M:%S.%f, %Y/%d/%m %H:%M:%S.%fZ, %Y/%m/%d %H:%M:%S.%f, %Y/%m/%d %H:%M:%S.%fZ, %y/%d/%m %H:%M:%S.%f, %y/%d/%m %H:%M:%S.%fZ, %y/%m/%d %H:%M:%S.%f, %y/%m/%d %H:%M:%S.%fZ, %m.%d.%Y, %m.%d.%y, %d.%m.%y, %d.%m.%Y, %Y.%m.%d, %Y.%d.%m, %y.%m.%d, %y.%d.%m, %Y-%m-%d %I:%M:%S %p, %Y/%m/%d %I:%M:%S %p, %Y.%m.%d %I:%M:%S %p, %Y-%m-%d %I:%M %p, %Y/%m/%d %I:%M %p, %y-%m-%d %I:%M:%S %p, %y.%m.%d %I:%M:%S %p, %y/%m/%d %I:%M:%S %p, %y-%m-%d %I:%M %p, %y.%m.%d %I:%M %p, %y/%m/%d %I:%M %p, %m/%d/%Y %I:%M %p, %m/%d/%y %I:%M %p, %d/%m/%Y %I:%M %p, %d/%m/%y %I:%M %p, %m-%d-%Y %I:%M %p, %m-%d-%y %I:%M %p, %d-%m-%Y %I:%M %p, %d-%m-%y %I:%M %p, %m.%d.%Y %I:%M %p, %m/%d.%y %I:%M %p, %d.%m.%Y %I:%M %p, %d.%m.%y %I:%M %p, %m/%d/%Y %I:%M:%S %p, %m/%d/%y %I:%M:%S %p, %m-%d-%Y %I:%M:%S %p, %m-%d-%y %I:%M:%S %p, %m.%d.%Y %I:%M:%S %p, %m.%d.%y %I:%M:%S %p, %d/%m/%Y %I:%M:%S %p, %d/%m/%y %I:%M:%S %p, %Y-%m-%d %I:%M:%S.%f %p, %y-%m-%d %I:%M:%S.%f %p, %Y-%m-%dT%I:%M:%S.%fZ %p, %y-%m-%dT%I:%M:%S.%fZ %p, %Y-%m-%dT%I:%M:%S.%f %p, %y-%m-%dT%I:%M:%S.%f %p, %Y-%m-%dT%I:%M:%S %p, %y-%m-%dT%I:%M:%S %p, %Y-%m-%dT%I:%M:%SZ %p, %y-%m-%dT%I:%M:%SZ %p, %Y.%m.%d %I:%M:%S.%f %p, %y.%m.%d %I:%M:%S.%f %p, %Y.%m.%dT%I:%M:%S.%fZ %p, %y.%m.%dT%I:%M:%S.%fZ %p, %Y.%m.%dT%I:%M:%S.%f %p, %y.%m.%dT%I:%M:%S.%f %p, %Y.%m.%dT%I:%M:%S %p, %y.%m.%dT%I:%M:%S %p, %Y.%m.%dT%I:%M:%SZ %p, %y.%m.%dT%I:%M:%SZ %p, %m %d %Y %I %M %S %p, %m %d %y %I %M %S %p, %I:%M %p, %I:%M:%S %p, %Y %m %d %I %M %S %p, %y %m %d %I %M %S %p, %Y/%d/%m %I:%M:%S.%f %p, %Y/%d/%m %I:%M:%S.%fZ %p, %Y/%m/%d %I:%M:%S.%f %p, %Y/%m/%d %I:%M:%S.%fZ %p, %y/%d/%m %I:%M:%S.%f %p, %y/%d/%m %I:%M:%S.%fZ %p, %y/%m/%d %I:%M:%S.%f %p, %y/%m/%d %I:%M:%S.%fZ %p] |
RequiredMetadataValue
{
"fieldName": "string",
"value": "string"
}
Properties¶
| Name | Type | Required | Restrictions | Description |
|---|---|---|---|---|
| fieldName | string | true | The required field name. This value will be added as an environment variable when running custom models. | |
| value | string | true | maxLength: 100 |
The value for the given field. |
ResourceRequestBundleListResponse
{
"count": 0,
"data": [
{
"cpuCount": 0,
"description": "string",
"gpuCount": 0,
"gpuMaker": "nvidia",
"hasGpu": true,
"id": "string",
"isDefault": true,
"isDeleted": true,
"memoryBytes": 0,
"name": "string",
"useCases": [
"customApplication"
]
}
],
"next": "http://example.com",
"previous": "http://example.com",
"totalCount": 0
}
Properties¶
| Name | Type | Required | Restrictions | Description |
|---|---|---|---|---|
| count | integer | false | Number of items returned on this page. | |
| data | [ResourceRequestBundleResponse] | true | maxItems: 100 |
List of bundles. |
| next | string(uri)¦null | true | URL pointing to the next page (if null, there is no next page). | |
| previous | string(uri)¦null | true | URL pointing to the previous page (if null, there is no previous page). | |
| totalCount | integer | true | The total number of items across all pages. |
ResourceRequestBundleResponse
{
"cpuCount": 0,
"description": "string",
"gpuCount": 0,
"gpuMaker": "nvidia",
"hasGpu": true,
"id": "string",
"isDefault": true,
"isDeleted": true,
"memoryBytes": 0,
"name": "string",
"useCases": [
"customApplication"
]
}
Properties¶
| Name | Type | Required | Restrictions | Description |
|---|---|---|---|---|
| cpuCount | integer | true | Max number of CPUs available. | |
| description | string | true | A short description of CPU, Memory and other resources. | |
| gpuCount | integer¦null | false | Max number of GPUs available. | |
| gpuMaker | string¦null | false | The manufacture of the GPU. | |
| hasGpu | boolean | true | If this bundle provides at least one GPU resource. | |
| id | string | true | The id of the bundle. | |
| isDefault | boolean | false | If this should be the default resource choice. | |
| isDeleted | boolean | false | If the bundle has been deleted and should not be used. | |
| memoryBytes | integer | true | Max amount of memory available. | |
| name | string | true | A short name for the bundle. | |
| useCases | [string] | true | List of use cases this bundle supports. |
Enumerated Values¶
| Property | Value |
|---|---|
| gpuMaker | [nvidia, amd, intel] |
RuntimeParameterUnified
{
"allowEmpty": true,
"credentialType": "adlsGen2Oauth",
"currentValue": "string",
"defaultValue": "string",
"description": "string",
"fieldName": "string",
"maxValue": 0,
"minValue": 0,
"overrideValue": "string",
"type": "boolean"
}
Properties¶
| Name | Type | Required | Restrictions | Description |
|---|---|---|---|---|
| allowEmpty | boolean | false | Indicates whether the param must be set before registration | |
| credentialType | string¦null | false | The type of credential, required only for credentials parameters. | |
| currentValue | any | false | Given the default and the override, this is the actual current value of the parameter. |
anyOf
| Name | Type | Required | Restrictions | Description |
|---|---|---|---|---|
| » anonymous | string | false | none |
or
| Name | Type | Required | Restrictions | Description |
|---|---|---|---|---|
| » anonymous | number | false | none |
or
| Name | Type | Required | Restrictions | Description |
|---|---|---|---|---|
| » anonymous | boolean | false | none |
continued
| Name | Type | Required | Restrictions | Description |
|---|---|---|---|---|
| defaultValue | any | false | The default value for the given field. |
anyOf
| Name | Type | Required | Restrictions | Description |
|---|---|---|---|---|
| » anonymous | string | false | none |
or
| Name | Type | Required | Restrictions | Description |
|---|---|---|---|---|
| » anonymous | number | false | none |
or
| Name | Type | Required | Restrictions | Description |
|---|---|---|---|---|
| » anonymous | boolean | false | none |
continued
| Name | Type | Required | Restrictions | Description |
|---|---|---|---|---|
| description | string¦null | false | Description how this parameter impacts the running model. | |
| fieldName | string | true | The parameter name. This value will be added as an environment variable when running custom models. | |
| maxValue | number¦null | false | The maximum value for a numeric field. | |
| minValue | number¦null | false | The minimum value for a numeric field. | |
| overrideValue | any | false | Value set by the user that overrides the default set in the definition. |
anyOf
| Name | Type | Required | Restrictions | Description |
|---|---|---|---|---|
| » anonymous | string | false | none |
or
| Name | Type | Required | Restrictions | Description |
|---|---|---|---|---|
| » anonymous | number | false | none |
or
| Name | Type | Required | Restrictions | Description |
|---|---|---|---|---|
| » anonymous | boolean | false | none |
continued
| Name | Type | Required | Restrictions | Description |
|---|---|---|---|---|
| type | string | true | The type of this value. |
Enumerated Values¶
| Property | Value |
|---|---|
| credentialType | [adlsGen2Oauth, apiToken, azure, azureServicePrincipal, basic, bearer, databricksAccessTokenAccount, databricksServicePrincipalAccount, gcp, oauth, rsa, s3, sapOauth, snowflakeKeyPairUserAccount, snowflakeOauthUserAccount, tableauAccessToken] |
| type | [boolean, credential, customMetric, deployment, modelPackage, numeric, string] |
RuntimeParameterValue
{
"fieldName": "string",
"type": "boolean",
"value": "string"
}
Properties¶
| Name | Type | Required | Restrictions | Description |
|---|---|---|---|---|
| fieldName | string | true | The required field name. This value will be added as an environment variable when running custom models. | |
| type | string | true | The type of this value. | |
| value | any | true | The string, boolean or numeric value for the given field. |
anyOf
| Name | Type | Required | Restrictions | Description |
|---|---|---|---|---|
| » anonymous | string¦null | false | maxLength: 4096 |
The value for the given field. |
or
| Name | Type | Required | Restrictions | Description |
|---|---|---|---|---|
| » anonymous | boolean | false | The boolean value for the field (default False) |
or
| Name | Type | Required | Restrictions | Description |
|---|---|---|---|---|
| » anonymous | number | false | The numeric value for the field |
Enumerated Values¶
| Property | Value |
|---|---|
| type | [boolean, credential, customMetric, deployment, modelPackage, numeric, string] |
SampleCountField
{
"columnName": "string"
}
Points to a weight column if users provide pre-aggregated metric values. Used with columnar datasets.
Properties¶
| Name | Type | Required | Restrictions | Description |
|---|---|---|---|---|
| columnName | string¦null | true | Column name |
Schedule
{
"dayOfMonth": [
"*"
],
"dayOfWeek": [
"*"
],
"hour": [
"*"
],
"minute": [
"*"
],
"month": [
"*"
]
}
The scheduling information defining how often and when to execute this job to the Job Scheduling service. Optional if enabled = False.
Properties¶
| Name | Type | Required | Restrictions | Description |
|---|---|---|---|---|
| dayOfMonth | [anyOf] | true | The date(s) of the month that the job will run. Allowed values are either [1 ... 31] or ["*"] for all days of the month. This field is additive with dayOfWeek, meaning the job will run both on the date(s) defined in this field and the day specified by dayOfWeek (for example, dates 1st, 2nd, 3rd, plus every Tuesday). If dayOfMonth is set to ["*"] and dayOfWeek is defined, the scheduler will trigger on every day of the month that matches dayOfWeek (for example, Tuesday the 2nd, 9th, 16th, 23rd, 30th). Invalid dates such as February 31st are ignored. |
anyOf
| Name | Type | Required | Restrictions | Description |
|---|---|---|---|---|
| » anonymous | number | false | none |
or
| Name | Type | Required | Restrictions | Description |
|---|---|---|---|---|
| » anonymous | string | false | none |
continued
| Name | Type | Required | Restrictions | Description |
|---|---|---|---|---|
| dayOfWeek | [anyOf] | true | The day(s) of the week that the job will run. Allowed values are [0 .. 6], where (Sunday=0), or ["*"], for all days of the week. Strings, either 3-letter abbreviations or the full name of the day, can be used interchangeably (e.g., "sunday", "Sunday", "sun", or "Sun", all map to [0]. This field is additive with dayOfMonth, meaning the job will run both on the date specified by dayOfMonth and the day defined in this field. |
anyOf
| Name | Type | Required | Restrictions | Description |
|---|---|---|---|---|
| » anonymous | number | false | none |
or
| Name | Type | Required | Restrictions | Description |
|---|---|---|---|---|
| » anonymous | string | false | none |
continued
| Name | Type | Required | Restrictions | Description |
|---|---|---|---|---|
| hour | [anyOf] | true | The hour(s) of the day that the job will run. Allowed values are either ["*"] meaning every hour of the day or [0 ... 23]. |
anyOf
| Name | Type | Required | Restrictions | Description |
|---|---|---|---|---|
| » anonymous | number | false | none |
or
| Name | Type | Required | Restrictions | Description |
|---|---|---|---|---|
| » anonymous | string | false | none |
continued
| Name | Type | Required | Restrictions | Description |
|---|---|---|---|---|
| minute | [anyOf] | true | The minute(s) of the day that the job will run. Allowed values are either ["*"] meaning every minute of the day or[0 ... 59]. |
anyOf
| Name | Type | Required | Restrictions | Description |
|---|---|---|---|---|
| » anonymous | number | false | none |
or
| Name | Type | Required | Restrictions | Description |
|---|---|---|---|---|
| » anonymous | string | false | none |
continued
| Name | Type | Required | Restrictions | Description |
|---|---|---|---|---|
| month | [anyOf] | true | The month(s) of the year that the job will run. Allowed values are either [1 ... 12] or ["*"] for all months of the year. Strings, either 3-letter abbreviations or the full name of the month, can be used interchangeably (e.g., "jan" or "october"). Months that are not compatible with dayOfMonth are ignored, for example {"dayOfMonth": [31], "month":["feb"]}. |
anyOf
| Name | Type | Required | Restrictions | Description |
|---|---|---|---|---|
| » anonymous | number | false | none |
or
| Name | Type | Required | Restrictions | Description |
|---|---|---|---|---|
| » anonymous | string | false | none |
SharedRolesUpdate
{
"operation": "updateRoles",
"roles": [
{
"role": "string",
"shareRecipientType": "user",
"username": "string"
}
]
}
Properties¶
| Name | Type | Required | Restrictions | Description |
|---|---|---|---|---|
| operation | string | true | Name of the action being taken. The only operation is 'updateRoles'. | |
| roles | [oneOf] | true | maxItems: 100 minItems: 1 |
Array of GrantAccessControl objects., up to maximum 100 objects. |
oneOf
| Name | Type | Required | Restrictions | Description |
|---|---|---|---|---|
| » anonymous | GrantAccessControlWithUsername | false | none |
xor
| Name | Type | Required | Restrictions | Description |
|---|---|---|---|---|
| » anonymous | GrantAccessControlWithId | false | none |
Enumerated Values¶
| Property | Value |
|---|---|
| operation | updateRoles |
SharingListV2Response
{
"count": 0,
"data": [
{
"id": "string",
"name": "string",
"role": "ADMIN",
"shareRecipientType": "user"
}
],
"next": "string",
"previous": "string",
"totalCount": 0
}
Properties¶
| Name | Type | Required | Restrictions | Description |
|---|---|---|---|---|
| count | integer | true | The number of items returned. | |
| data | [AccessControlV2] | true | maxItems: 1000 |
The access control list. |
| next | string¦null | true | URL pointing to the next page. | |
| previous | string¦null | true | URL pointing to the previous page. | |
| totalCount | integer | true | Total number of items matching the condition. |
SharingUpdateOrRemoveWithGrant
{
"data": [
{
"canShare": true,
"role": "ADMIN",
"username": "string"
}
]
}
Properties¶
| Name | Type | Required | Restrictions | Description |
|---|---|---|---|---|
| data | [UserRoleWithGrant] | true | maxItems: 100 |
List of sharing roles to update. |
TestingStatus
{
"message": "string",
"status": "not_tested"
}
Ensures that the custom model image can build and launch. If it cannot, the test is marked as Failed and subsequent test are aborted.
Properties¶
| Name | Type | Required | Restrictions | Description |
|---|---|---|---|---|
| message | string | true | Test message. | |
| status | string | true | Test status. |
Enumerated Values¶
| Property | Value |
|---|---|
| status | [not_tested, queued, failed, canceled, succeeded, in_progress, aborted, warning, skipped] |
TrainingDataAssignmentErrorResponse
{
"message": "string"
}
Training data configuration.
Properties¶
| Name | Type | Required | Restrictions | Description |
|---|---|---|---|---|
| message | string¦null | false | maxLength: 10000 |
Training data assignment error message |
TrainingDataResponse
{
"assignmentError": {
"message": "string"
},
"assignmentInProgress": false,
"datasetId": "string",
"datasetName": "string",
"datasetVersionId": "string"
}
Training data configuration.
Properties¶
| Name | Type | Required | Restrictions | Description |
|---|---|---|---|---|
| assignmentError | TrainingDataAssignmentErrorResponse | false | Training data configuration. | |
| assignmentInProgress | boolean | false | Indicates if training data is currently being assigned to the custom model. Only for structured models. | |
| datasetId | string¦null | false | The ID of the dataset. | |
| datasetName | string¦null | false | maxLength: 255 |
A user-friendly name for the dataset. |
| datasetVersionId | string¦null | false | The ID of the dataset version. |
UpdateCustomJob
{
"description": "string",
"entryPoint": "string",
"environmentId": "string",
"environmentVersionId": "string",
"file": "string",
"filePath": "string",
"filesToDelete": "string",
"name": "string",
"resources": {
"egressNetworkPolicy": "none",
"resourceBundleId": "string"
},
"runtimeParameterValues": "string"
}
Properties¶
| Name | Type | Required | Restrictions | Description |
|---|---|---|---|---|
| description | string | <