Revisions

Revisions are associated with an inference workload and represent a snapshot of its configuration. A revision is created on each change to the inference workload.

Get inference workload revisions by id. [Experimental]

Retrieve the details of inference workload revisions by workload id. Supported for clusters v2.21+.

SecuritybearerAuth

Request

path Parameters

workloadId

required

string <uuid>

The Universally Unique Identifier (UUID) of the workload.

query Parameters

deleted

boolean

Return only deleted resources when true.

Responses

200

Executed successfully.

401

Unauthorized

403

Forbidden

404

The specified resource was not found

500

unexpected error

503

unexpected error

get/api/v1/workloads/inferences/{workloadId}/revisions

Response samples

application/json

{"revisions": [{"type": "runai-revision",
"name": "very-important-job",
"id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
"workloadId": "06d16c5d-4728-42fa-b573-3b11820d999f",
"tenantId": 1001,
"clusterId": "71f69d83-ba66-4822-adf5-55ce55efd210",
"projectId": 1,
"departmentId": 2,
"createdAt": "2022-01-01T03:49:52.531Z",
"deletedAt": "2022-08-12T19:28:24.131Z",
"revisionRequestedResources": {"gpuRequestType": "portion",
"gpu": {"limit": 1.5,
"request": 1
},
"gpuMemory": {"limit": "2G",
"request": "200M"
},
"cpu": {"limit": 1.5,
"request": 1
},
"cpuMemory": {"limit": "2G",
"request": "200M"
},
"migProfile": ["1g.5gb"
],
"extendedResources": [{"resource": "hardware-vendor.example/foo",
"quantity": 2,
"exclude": false
}
]
},
"podsRequestedResources": {"gpuRequestType": "portion",
"gpu": {"limit": 1.5,
"request": 1
},
"gpuMemory": {"limit": "2G",
"request": "200M"
},
"cpu": {"limit": 1.5,
"request": 1
},
"cpuMemory": {"limit": "2G",
"request": "200M"
},
"migProfile": ["1g.5gb"
],
"extendedResources": [{"resource": "hardware-vendor.example/foo",
"quantity": 2,
"exclude": false
}
]
},
"requestedPods": {"number": 1,
"min": 2,
"max": 5,
"parallelism": 3,
"completions": 5
},
"requestedNodePools": ["default"
],
"allocatedResources": {"gpu": 1.5,
"migProfile": ["1g.5gb"
],
"gpuMemory": "200Mi",
"cpu": 0.5,
"cpuMemory": "0B",
"extendedResources": [{"resource": "hardware-vendor.example/foo",
"quantity": 2,
"exclude": false
}
]
},
"currentNodePools": ["default"
],
"runningPods": 1,
"images": ["alpine:latest"
],
"environmentVariables": {"property1": "string",
"property2": "string"
},
"command": "sleep",
"arguments": "1000",
"conditions": [{"type": "Ready",
"status": "False",
"message": "Resource validation failed: ...",
"reason": "ErrorConfig",
"lastTransitionTime": "2022-01-01T03:49:52.531Z"
}
],
"phase": "Creating",
"phaseMessage": "Not enough resources in the requested nodepool",
"phaseUpdatedAt": "2022-06-08T11:28:24.131Z",
"additionalFields": { }
}
]
}

Get inference workload revisions count. [Experimental]

Retrieve the number of an inference workload revisions from a cluster. Supported for clusters v2.21+.

SecuritybearerAuth

Request

path Parameters

workloadId

required

string <uuid>

The Universally Unique Identifier (UUID) of the workload.

query Parameters

deleted

boolean

Return only deleted resources when true.

Responses

200

Executed successfully.

401

Unauthorized

403

Forbidden

500

unexpected error

503

unexpected error

get/api/v1/workloads/inferences/{workloadId}/revisions/count

Response samples

application/json

{"count": 1
}

Get revision data. [Experimental]

Retrieve revision details using a revision id. Supported for clusters v2.21+.

SecuritybearerAuth

Request

path Parameters

revisionId

required

string <uuid>

The Universally Unique Identifier (UUID) of the revision.

Responses

200

Executed successfully.

401

Unauthorized

403

Forbidden

404

The specified resource was not found

500

unexpected error

503

unexpected error

get/api/v1/workloads/inferences/revisions/{revisionId}

Response samples

application/json

{"type": "runai-revision",
"name": "very-important-job",
"id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
"workloadId": "06d16c5d-4728-42fa-b573-3b11820d999f",
"tenantId": 1001,
"clusterId": "71f69d83-ba66-4822-adf5-55ce55efd210",
"projectId": 1,
"departmentId": 2,
"createdAt": "2022-01-01T03:49:52.531Z",
"deletedAt": "2022-08-12T19:28:24.131Z",
"revisionRequestedResources": {"gpuRequestType": "portion",
"gpu": {"limit": 1.5,
"request": 1
},
"gpuMemory": {"limit": "2G",
"request": "200M"
},
"cpu": {"limit": 1.5,
"request": 1
},
"cpuMemory": {"limit": "2G",
"request": "200M"
},
"migProfile": ["1g.5gb"
],
"extendedResources": [{"resource": "hardware-vendor.example/foo",
"quantity": 2,
"exclude": false
}
]
},
"podsRequestedResources": {"gpuRequestType": "portion",
"gpu": {"limit": 1.5,
"request": 1
},
"gpuMemory": {"limit": "2G",
"request": "200M"
},
"cpu": {"limit": 1.5,
"request": 1
},
"cpuMemory": {"limit": "2G",
"request": "200M"
},
"migProfile": ["1g.5gb"
],
"extendedResources": [{"resource": "hardware-vendor.example/foo",
"quantity": 2,
"exclude": false
}
]
},
"requestedPods": {"number": 1,
"min": 2,
"max": 5,
"parallelism": 3,
"completions": 5
},
"requestedNodePools": ["default"
],
"allocatedResources": {"gpu": 1.5,
"migProfile": ["1g.5gb"
],
"gpuMemory": "200Mi",
"cpu": 0.5,
"cpuMemory": "0B",
"extendedResources": [{"resource": "hardware-vendor.example/foo",
"quantity": 2,
"exclude": false
}
]
},
"currentNodePools": ["default"
],
"runningPods": 1,
"images": ["alpine:latest"
],
"environmentVariables": {"property1": "string",
"property2": "string"
},
"command": "sleep",
"arguments": "1000",
"conditions": [{"type": "Ready",
"status": "False",
"message": "Resource validation failed: ...",
"reason": "ErrorConfig",
"lastTransitionTime": "2022-01-01T03:49:52.531Z"
}
],
"phase": "Creating",
"phaseMessage": "Not enough resources in the requested nodepool",
"phaseUpdatedAt": "2022-06-08T11:28:24.131Z",
"additionalFields": { }
}

➔ Next to Distributed