Updates a Ray cluster.
Try it now
Test
RAM authorization
Request syntax
POST /api/v1/workspaces/{workspaceId}/rayCluster/{clusterId} HTTP/1.1Path Parameters
|
Parameter |
Type |
Required |
Description |
Example |
| workspaceId |
string |
No |
The workspace ID. |
w-d2d82aa09155 |
| clusterId |
string |
No |
The cluster ID. |
ray-uiulpgow9xljimm1 |
Request parameters
|
Parameter |
Type |
Required |
Description |
Example |
| body |
object |
No |
The request body. |
|
| name |
string |
No |
The name of the Ray cluster. The name must be 1 to 64 characters in length. |
myRayCluster |
| displayReleaseVersion |
string |
No |
Ray engine version. |
ray-1.0.0 (Ray 2.47.1, Python 3.12) |
| description |
string |
No |
Description of the cluster. |
Ray Cluster for dev. |
| networkServiceName |
string |
No |
The name of the network service. |
vpc |
| headSpec |
object |
No |
The information about the head node of the Ray cluster. |
|
| queueName |
string |
No |
The name of the queue. |
root_queue |
| cpu |
string |
No |
The number of CPU cores. |
2 |
| memory |
string |
No |
The memory size. Unit: Gi. |
8Gi |
| enableAutoScaling |
boolean |
No |
Specifies whether to enable automatic scaling. |
false |
| idleTimeoutSeconds |
integer |
No |
The idle timeout in seconds for workers. This parameter is effective only when automatic scaling is enabled. |
60 |
| gpuSpec |
string |
No |
ecs.gn6i-c4g1.xlarge |
|
| workerSpec |
array<object> |
No |
The information about the worker nodes of the Ray cluster. You can specify up to 50 groups. |
|
|
object |
No |
The information for the worker node. |
||
| groupName |
string |
No |
The name of the worker group. |
WorkerGroup1 |
| workerType |
string |
No |
The type of worker. |
CPU |
| replica |
integer |
No |
The number of workers. The minimum value is 1. |
2 |
| queueName |
string |
No |
The name of the queue. |
root_queue |
| cpu |
string |
No |
The number of CPU cores. |
2 |
| memory |
string |
No |
The memory size. Unit: Gi. |
8Gi |
| minReplica |
integer |
No |
The minimum number of workers. The minimum value is 1. This value must be less than or equal to maxReplica. |
1 |
| maxReplica |
integer |
No |
The maximum number of workers. The minimum value is 1. |
10 |
| gpuSpec |
string |
No |
ecs.gn6i-c4g1.xlarge |
|
| extraParam |
string |
No |
The extra parameters. This must be in JSON format. |
{} |
| volumeIds |
array |
No |
||
|
string |
No |
vol-1234567890 |
Response elements
|
Element |
Type |
Description |
Example |
|
object |
Schema of Response |
||
| requestId |
string |
The request ID. |
DD6B1B2A-5837-5237-ABE4-FF0C8944 |
| clusterId |
string |
The cluster ID. |
ray-xxxxxxxxxxx |
Examples
Success response
JSON format
{
"requestId": "DD6B1B2A-5837-5237-ABE4-FF0C8944",
"clusterId": "ray-xxxxxxxxxxx"
}Error codes
See Error Codes for a complete list.
Release notes
See Release Notes for a complete list.