创建Ray集群。
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
请求语法
POST /api/v1/workspaces/{workspaceId}/rayCluster HTTP/1.1路径参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| workspaceId |
string |
否 |
工作空间 ID。 |
w-d2d82aa09155 |
请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| body |
object |
否 |
请求结构体。 |
|
| name |
string |
否 |
Ray 集群名称，长度 1 到 64。 |
testRayCluster |
| displayReleaseVersion |
string |
否 |
Ray 引擎版本。 |
ray-1.0.0 (Ray 2.47.1, Python 3.12) |
| description |
string |
否 |
描述信息。 |
Ray Cluster for dev. |
| networkServiceName |
string |
否 |
网络连接名称。 |
vpc |
| headSpec |
object |
否 |
Ray 集群 Head 节点参数。 |
|
| queueName |
string |
否 |
队列名称。 |
root_queue |
| cpu |
string |
否 |
CPU 核数。 |
2 |
| memory |
string |
否 |
内存，单位 Gi。 |
8Gi |
| enableAutoScaling |
boolean |
否 |
是否开启 Worker 自动扩缩容。 |
false |
| idleTimeoutSeconds |
integer |
否 |
开启自动扩缩容后 Worker Idle 时间。 |
60 |
| workerSpec |
array<object> |
否 |
Ray 集群 Worker 节点参数，最多 50 组。 |
|
|
object |
否 |
Worker 节点结构体。 |
||
| groupName |
string |
否 |
Worker 组名。 |
WorkerGroup1 |
| workerType |
string |
否 |
Worker 类型。 |
CPU |
| replica |
integer |
否 |
Worker 数量，最小 1。 |
2 |
| queueName |
string |
否 |
队列名称。 |
root_queue |
| cpu |
string |
否 |
CPU 核数。 |
4 |
| memory |
string |
否 |
内存，单位 Gi。 |
16Gi |
| minReplica |
integer |
否 |
开启自动扩缩容后最小 Worker 数量，最小 1，必须小于等于 maxReplica。 |
1 |
| maxReplica |
integer |
否 |
开启自动扩缩容后最大 Worker 数量，最小 1。 |
10 |
| extraParam |
string |
否 |
额外参数，必须为 json 格式。 |
{} |
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
Schema of Response |
||
| requestId |
string |
请求 ID。 |
DD6B1B2A-5837-5237-ABE4-FF0C8944 |
| clusterId |
string |
Ray 集群 ID。 |
ray-k7nm8ahl5te4tg91 |
示例
正常返回示例
JSON格式
{
"requestId": "DD6B1B2A-5837-5237-ABE4-FF0C8944",
"clusterId": "ray-k7nm8ahl5te4tg91"
}错误码
访问错误中心查看更多错误码。
变更历史
更多信息，参考变更详情。