Todos los productos
Search
Centro de documentos

E-MapReduce:CreateRayCluster

Última actualización: Sep 03, 2026

Crea un clúster de Ray.

Pruébelo ahora

Pruebe esta API en OpenAPI Explorer sin necesidad de firma manual. Las llamadas exitosas generan automáticamente código SDK acorde a sus parámetros. Descárguelo con seguridad de credenciales integrada para uso local.

Test

Autorización de RAM

La siguiente tabla describe la autorización necesaria para invocar esta API. Puede definirla en una directiva de Resource Access Management (RAM). A continuación, se detallan las columnas de la tabla:

  • Action: Estas acciones se utilizan en el elemento Action de las declaraciones de directivas de permisos de RAM para otorgar permisos que permitan realizar la operación.

  • API: La API que debe invocarse para llevar a cabo la acción.

  • Nivel de acceso: Nivel de acceso predefinido que se concede para cada API. Valores válidos: create, list, get, update y delete.

  • Tipo de recurso: Tipo de recurso que admite autorización para ejecutar la acción. Indica si la acción es compatible con permisos a nivel de recurso. El recurso especificado debe ser compatible con la acción; de lo contrario, la directiva no surtirá efecto.

    • En las API con permisos a nivel de recurso, los tipos de recursos obligatorios se marcan con un asterisco (*). Especifique el Alibaba Cloud Resource Name (ARN) correspondiente en el elemento Resource de la directiva.

    • Para las API sin permisos a nivel de recurso, se muestra All Resources. Utilice un asterisco (*) en el elemento Resource de la directiva.

  • Clave de condición: Claves de condición definidas por el servicio. Permiten un control granular y se aplican ya sea solo a acciones o a acciones asociadas con recursos específicos. Además de las claves de condición específicas del servicio, Alibaba Cloud proporciona un conjunto de common condition keys aplicables a todos los servicios compatibles con RAM.

  • Acción dependiente: Acciones dependientes necesarias para ejecutar la acción principal. Para completar la operación, el usuario de RAM o el rol de RAM debe contar con permisos para realizar todas las acciones dependientes.

Action

Nivel de acceso

Tipo de recurso

Clave de condición

Acción dependiente

emr-serverless-spark:CreateRayCluster

create

*Todos los recursos.

*

Ninguna Ninguna

Sintaxis de la solicitud

POST /api/v1/workspaces/{workspaceId}/rayCluster HTTP/1.1

Parámetros de ruta

Parámetro

Tipo

Obligatorio

Descripción

Ejemplo

workspaceId

string

No

El ID del espacio de trabajo.

w-d2d82aa09155

Parámetros de la solicitud

Parámetro

Tipo

Obligatorio

Descripción

Ejemplo

body

object

No

La estructura de la solicitud.

name

string

No

El nombre del clúster de Ray. El nombre debe tener entre 1 y 64 caracteres de longitud.

testRayCluster

displayReleaseVersion

string

No

La versión del motor Ray DPI.

ray-1.0.0 (Ray 2.47.1, Python 3.12)

description

string

No

La descripción.

Clúster de Ray para desarrollo

networkServiceName

string

No

El nombre de la conectividad de red.

vpc

headSpec

object

No

Los parámetros del nodo principal del clúster de Ray.

queueName

string

No

El nombre de la cola.

root_queue

cpu

string

No

El número de núcleos de CPU.

2

memory

string

No

El tamaño de memoria. Unidad: Gi.

8Gi

enableAutoScaling

boolean

No

Especifica si se debe habilitar el escalado automático para los workers.

false

idleTimeoutSeconds

integer

No

El período de tiempo de espera de inactividad de los workers después de habilitar el escalado automático.

60

gpuSpec

string

No

El modelo de GPU.

ecs.gn6i-c4g1.xlarge

gftEnabled

boolean

No

Especifica si se debe habilitar la tolerancia a fallos de GCS.

gftConfig

object

No

La configuración de tolerancia a fallos de GCS.

redisUrl

string

No

La URL de Redis.

10.12.3.4:6379

redisUsername

string

No

El nombre de usuario de Redis.

default

redisPassword

string

No

La contraseña de Redis.

redispasswd

env

string

No

Las variables de entorno.

MY_ENV=hello\nMY_ENV2=hello2

rayStartParams

string

No

Los parámetros de inicio del nodo Ray.

--num-cpus=0 --num-gpus=0

displayReleaseVersion

string

No

La versión del motor Ray DPI.

ray-1.2.0 (Ray 2.55.1, Python 3.12)

workerSpec

array<object>

No

Los parámetros de los nodos worker del clúster de Ray. Se admite un máximo de 50 grupos.

object

No

La estructura del nodo worker.

groupName

string

No

El nombre del grupo de workers.

WorkerGroup1

workerType

string

No

El tipo de worker.

CPU

replica

integer

No

El número de workers. Valor mínimo: 1.

2

queueName

string

No

El nombre de la cola.

root_queue

cpu

string

No

El número de núcleos de CPU.

4

memory

string

No

El tamaño de memoria. Unidad: Gi.

16Gi

minReplica

integer

No

El número mínimo de workers después de habilitar el escalado automático. Valor mínimo: 1. El valor debe ser menor o igual que maxReplica.

1

maxReplica

integer

No

El número máximo de workers después de habilitar el escalado automático. Valor mínimo: 1.

10

gpuSpec

string

No

El modelo de GPU.

ecs.gn6i-c4g1.xlarge

displayReleaseVersion

string

No

La versión del motor. Si no se especifica este parámetro, el valor es el mismo que el del nodo principal.

ray-1.2.0 (Ray 2.55.1, Python 3.12)

env

string

No

Las variables de entorno.

MY_ENV=hello\nMY_ENV2=hello2

rayStartParams

string

No

Los parámetros de inicio del nodo Ray.

--num-cpus=0 --num-gpus=0

extraParam

string

No

Los parámetros adicionales. El valor debe estar en formato JSON.

{}

volumeIds

array

No

La lista de ID de directorios administrados para montar.

string

No

El ID del directorio administrado.

vol-1234567890

Elementos de la respuesta

Elemento

Tipo

Descripción

Ejemplo

object

Esquema de la respuesta.

requestId

string

El ID de la solicitud.

DD6B1B2A-5837-5237-ABE4-FF0C8944

clusterId

string

El ID del clúster de Ray.

ray-k7nm8ahl5te4tg91

Ejemplos

Respuesta exitosa

JSON Formato

{
  "requestId": "DD6B1B2A-5837-5237-ABE4-FF0C8944",
  "clusterId": "ray-k7nm8ahl5te4tg91"
}

Códigos de error

Consulte Códigos de error para ver la lista completa.

Notas de la versión

Consulte Notas de la versión para ver la lista completa.