Todos los productos
Search
Centro de documentos

E-MapReduce:GetRayCluster

Última actualización: Oct 04, 2026

Obtiene 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:GetRayCluster

get

*Todos los recursos.

*

Ninguna Ninguna

Sintaxis de la solicitud

GET /api/v1/workspaces/{workspaceId}/rayCluster/{clusterId} 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

clusterId

string

No

El ID del clúster.

ray-xxxxxxxxxx

Parámetros de la solicitud

Parámetro

Tipo

Obligatorio

Descripción

Ejemplo

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

name

string

El nombre del clúster de Ray.

myRayCluster

displayReleaseVersion

string

La versión del motor DPI de Ray.

ray-1.0.0 (Ray 2.47.1, Python 3.12)

description

string

La descripción.

Ray Cluster for dev.

networkServiceName

string

El nombre de conectividad de red.

vpc

headSpec

object

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

queueName

string

El nombre de la cola.

root_queue

cpu

string

El número de núcleos de CPU.

2

memory

string

El tamaño de memoria, en GiB.

8Gi

enableAutoScaling

boolean

Indica si el escalado automático está habilitado para los nodos trabajadores.

false

idleTimeoutSeconds

integer

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

60

replica

integer

El número de nodos.

1

gpuSpec

string

El tipo de instancia de GPU.

ecs.gn6i-c4g1.xlarge

gftEnabled

boolean

Indica si la tolerancia a fallos de GCS está habilitada.

gftConfig

object

La configuración de tolerancia a fallos de GCS.

redisUrl

string

La dirección de Redis.

10.4.5.6:6789

redisUsername

string

El nombre de usuario de Redis.

default

redisPassword

string

La contraseña de Redis.

123456

env

string

Las variables de entorno.

MY_ENV=123456

rayStartParams

string

Los parámetros de inicio de Ray.

--num-cpus=0

displayReleaseVersion

string

La versión del motor DPI de Ray.

err-1.3.0 (Ray 2.55.1, Python 3.12)

state

string

El estado de la sesión. Valores válidos:

  • Starting: iniciando.

  • Running: en ejecución.

  • Stopping: deteniendo.

  • Stopped: detenido.

  • Error: con error.

Valores válidos:

  • Stopped :

    Detenido.

  • Starting :

    Iniciando.

  • Running :

    En ejecución.

  • Error :

    Error.

  • Stopping :

    Deteniendo.

Running

creator

string

El UID del usuario que creó el clúster.

202077646755523991

creatorName

string

El alias del creador.

Alice

modifier

string

El UID del usuario que actualizó el clúster por última vez.

202077646755523991

modifierName

string

El alias del modificador.

Alice

userId

string

El ID de cuenta de Alibaba Cloud del creador.

123456789012

dashboardUrl

string

La URL del panel del clúster de Ray.

https://emr-ray-gateway-cn-hangzhou.aliyuncs.com/workspace/w-xxxxxxxx/raycluster/ray-xxxxxx/dashboard?token=xxxxxx

jobUrl

string

La dirección pública para enviar trabajos de Ray.

https://emr-spark-ray-gateway-cn-hangzhou.aliyuncs.com

submitToken

string

El token de autenticación para enviar trabajos de Ray. Incluya este token en el encabezado de la solicitud como "ray-token": "token".

1d06484d3b424f7fa4ab7082a4076da2

modified

boolean

Indica si la configuración se ha modificado.

false

extraParam

string

Los parámetros adicionales en formato JSON.

{}

message

string

El mensaje de error cuando el estado es Error.

ok

instances

array<object>

Los ID de los nodos del clúster de Ray.

object

La estructura de nodo del clúster de Ray.

type

string

El tipo del nodo.

Head

instanceId

string

El ID del nodo.

ray-uiulpgow9xljim10-head-7cgta

containerState

string

El estado del contenedor principal.

Running

reason

string

La información del nodo.

OOMKilled

phase

string

El estado del pod del nodo.

Running

message

string

La información del estado del pod del nodo.

ok

startTime

integer

La hora de inicio. El valor es una marca de tiempo UNIX en milisegundos.

1762946698000

createTime

integer

La hora de creación. El valor es una marca de tiempo UNIX en milisegundos.

1735870116167

containerStateReason

string

La información del contenedor principal.

ok

containerStateMessage

string

La información del estado del contenedor principal.

ContainerExit

containerExitCode

integer

El código de salida del contenedor principal.

137

instanceId

string

Los ID de los nodos del clúster de Ray.

ray-k7nm8ahl5te4tg93-xxxxxxx

workerSpec

array<object>

La información de los nodos de trabajo del clúster de Ray.

object

La estructura de información de los nodos de trabajo del clúster de Ray.

groupName

string

El nombre del grupo de nodos de trabajo.

WorkerGroup1

workerType

string

El tipo de grupo de nodos de trabajo.

Valores válidos:

  • CPU :

    Nodo de trabajo de CPU.

CPU

replica

integer

El número de nodos de trabajo.

2

queueName

string

El nombre de la cola.

root_queue

cpu

string

El número de núcleos de CPU.

2

memory

string

El tamaño de memoria, en GiB.

8Gi

minReplica

integer

El número mínimo de nodos de trabajo.

1

maxReplica

integer

El número máximo de nodos de trabajo.

10

gpuSpec

string

El tipo de instancia de GPU.

ecs.gn6i-c4g1.xlarge

displayReleaseVersion

string

La versión del motor de base de datos.

ray-1.2.0 (Ray 2.55.1, Python 3.12)

env

string

Las variables de entorno de Ray.

MY_ENV=12456

rayStartParams

string

Los parámetros de inicio de Ray.

--num-cpus=0

startTime

integer

La hora de inicio. El valor es una marca de tiempo UNIX en milisegundos.

1750327083303

createTime

integer

La hora de creación. El valor es una marca de tiempo UNIX en milisegundos.

1750327083303

modifiedTime

integer

La hora de actualización. El valor es una marca de tiempo UNIX en milisegundos.

1754274541693

grpcEndpoint

string

El endpoint gRPC (red interna). El nombre de dominio del endpoint también se puede usar para enviar trabajos de Ray.

ray://emr-spark-ray-gateway-cn-hangzhou-internal.emr.aliyuncs.com:80

volumeIds

array

La lista de ID de archivos administrados.

string

El ID del archivo administrado.

vol-123456789

jobUrlInner

string

La dirección de red interna para enviar trabajos de Ray.

http://emr-spark-ray-gateway-cn-hangzhou-internal.emr.aliyuncs.com

Ejemplos

Respuesta exitosa

JSON Formato

{
  "requestId": "DD6B1B2A-5837-5237-ABE4-FF0C8944",
  "clusterId": "ray-k7nm8ahl5te4tg91",
  "name": "myRayCluster",
  "displayReleaseVersion": "ray-1.0.0 (Ray 2.47.1, Python 3.12)",
  "description": "Clúster de Ray para desarrollo",
  "networkServiceName": "vpc",
  "headSpec": {
    "queueName": "root_queue",
    "cpu": "2",
    "memory": "8Gi",
    "enableAutoScaling": false,
    "idleTimeoutSeconds": 60,
    "replica": 1,
    "gpuSpec": "ecs.gn6i-c4g1.xlarge",
    "gftEnabled": false,
    "gftConfig": {
      "redisUrl": "10.4.5.6:6789",
      "redisUsername": "default",
      "redisPassword": "123456"
    },
    "env": "MY_ENV=123456",
    "rayStartParams": "--num-cpus=0",
    "displayReleaseVersion": "err-1.3.0 (Ray 2.55.1, Python 3.12)"
  },
  "state": "Running",
  "creator": "202077646755523991",
  "creatorName": "Alice",
  "modifier": "202077646755523991",
  "modifierName": "Alice",
  "userId": "123456789012",
  "dashboardUrl": "https://emr-ray-gateway-cn-hangzhou.aliyuncs.com/workspace/w-xxxxxxxx/raycluster/ray-xxxxxx/dashboard?token=xxxxxx",
  "jobUrl": "https://emr-spark-ray-gateway-cn-hangzhou.aliyuncs.com",
  "submitToken": "1d06484d3b424f7fa4ab7082a4076da2",
  "modified": false,
  "extraParam": "{}",
  "message": "ok",
  "instances": [
    {
      "type": "Head",
      "instanceId": "ray-uiulpgow9xljim10-head-7cgta",
      "containerState": "Running",
      "reason": "OOMKilled",
      "phase": "Running",
      "message": "ok",
      "startTime": 1762946698000,
      "createTime": 1735870116167,
      "containerStateReason": "ok",
      "containerStateMessage": "ContainerExit",
      "containerExitCode": 137
    }
  ],
  "instanceId": "ray-k7nm8ahl5te4tg93-xxxxxxx",
  "workerSpec": [
    {
      "groupName": "WorkerGroup1",
      "workerType": "CPU",
      "replica": 2,
      "queueName": "root_queue",
      "cpu": "2",
      "memory": "8Gi",
      "minReplica": 1,
      "maxReplica": 10,
      "gpuSpec": "ecs.gn6i-c4g1.xlarge",
      "displayReleaseVersion": "ray-1.2.0 (Ray 2.55.1, Python 3.12)",
      "env": "MY_ENV=12456",
      "rayStartParams": "--num-cpus=0"
    }
  ],
  "startTime": 1750327083303,
  "createTime": 1750327083303,
  "modifiedTime": 1754274541693,
  "grpcEndpoint": "ray://emr-spark-ray-gateway-cn-hangzhou-internal.emr.aliyuncs.com:80",
  "volumeIds": [
    "vol-123456789"
  ],
  "jobUrlInner": "http://emr-spark-ray-gateway-cn-hangzhou-internal.emr.aliyuncs.com"
}

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.