Todos los productos
Search
Centro de documentos

E-MapReduce:ListRayCluster

Última actualización: Oct 28, 2026

Enumera los clústeres 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:ListRayCluster

none

*Todos los recursos.

*

Ninguna Ninguna

Sintaxis de la solicitud

GET /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

pageSize

integer

No

El número de entradas que se devolverán en cada página. Valor predeterminado: 20. Valor mínimo: 1. Valor máximo: 100.

20

pageNum

integer

No

El número de página.

1

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

rayClusters

array<object>

La lista de clústeres de Ray.

array<object>

La estructura del clúster de Ray.

clusterId

string

El ID del clúster.

ray-uiulpgow9xljimm1

name

string

El nombre del clúster de Ray.

testRayCluster

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 la conectividad de red.

vpc

headSpec

object

La información 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

Especifica si el escalado automático está habilitado para los nodos de trabajo.

false

idleTimeoutSeconds

integer

El tiempo de espera de inactividad para los nodos de trabajo, en segundos.

60

replica

integer

El número de nodos.

1

gpuSpec

string

El tipo de instancia de GPU.

ecs.gn6i-c4g1.xlarge

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.

Group1

workerType

string

El tipo de nodo de trabajo.

Valores válidos:

  • CPU :

    Nodo de trabajo de CPU.

CPU

replica

integer

El número de nodos.

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 cuando el escalado automático está habilitado.

1

maxReplica

integer

El número máximo de nodos de trabajo cuando el escalado automático está habilitado.

10

gpuSpec

string

El tipo de instancia de GPU.

ecs.gn6i-c4g1.xlarge

state

string

El estado del clúster. Valores válidos:

  • Starting: El clúster se está iniciando.

  • Running: El clúster está en ejecución.

  • Stopping: El clúster se está deteniendo.

  • Stopped: El clúster está detenido.

  • Error: El clúster ha fallado.

Valores válidos:

  • Stopped :

    Detenido.

  • Starting :

    Iniciando.

  • Running :

    En ejecución.

  • Error :

    Error.

  • Stopping :

    Deteniéndose.

Running

createTime

integer

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

1723722279800

modifiedTime

integer

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

1723722279800

creator

string

El UID del creador.

202077646755123991

creatorName

string

El apodo del creador.

Alice

modifier

string

El UID del último actualizador.

202077646755123991

modifierName

string

El apodo del modificador.

Alice

userId

string

El ID de la cuenta de Alibaba Cloud.

1234567890

dashboardUrl

string

La URL del panel del clúster de Ray.

https://emr-spark-ray-gateway-cn-hangzhou.aliyuncs.com?token=xxxxxxxxx

modified

boolean

Indica si la configuración se ha modificado.

false

message

string

El mensaje de error.

ok

instanceId

string

El ID de la instancia del clúster de Ray.

ray-uiulpgow9xljimm1-xxxxxxx

startTime

integer

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

1723722279800

grpcEndpoint

string

El endpoint interno de gRPC. También puede usar el nombre de dominio para enviar trabajos de Ray.

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

Ejemplos

Respuesta exitosa

JSON Formato

{
  "requestId": "DD6B1B2A-5837-5237-ABE4-FF0C8944",
  "rayClusters": [
    {
      "clusterId": "ray-uiulpgow9xljimm1",
      "name": "testRayCluster",
      "displayReleaseVersion": "ray-1.0.0 (Ray 2.47.1, Python 3.12)",
      "description": "Ray Cluster for dev.",
      "networkServiceName": "vpc",
      "headSpec": {
        "queueName": "root_queue",
        "cpu": "2",
        "memory": "8Gi",
        "enableAutoScaling": false,
        "idleTimeoutSeconds": 60,
        "replica": 1,
        "gpuSpec": "ecs.gn6i-c4g1.xlarge"
      },
      "workerSpec": [
        {
          "groupName": "Group1",
          "workerType": "CPU",
          "replica": 2,
          "queueName": "root_queue",
          "cpu": "2",
          "memory": "8Gi",
          "minReplica": 1,
          "maxReplica": 10,
          "gpuSpec": "ecs.gn6i-c4g1.xlarge"
        }
      ],
      "state": "Running",
      "createTime": 1723722279800,
      "modifiedTime": 1723722279800,
      "creator": "202077646755123991",
      "creatorName": "Alice",
      "modifier": "202077646755123991",
      "modifierName": "Alice",
      "userId": "1234567890",
      "dashboardUrl": "https://emr-spark-ray-gateway-cn-hangzhou.aliyuncs.com?token=xxxxxxxxx",
      "modified": false,
      "message": "ok",
      "instanceId": "ray-uiulpgow9xljimm1-xxxxxxx",
      "startTime": 1723722279800,
      "grpcEndpoint": "ray://emr-spark-ray-gateway-cn-hanghzou-internal.emr.aliyuncs.com:80"
    }
  ]
}

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.