Todos os produtos
Search
Central de documentação

E-MapReduce:UpdateRayCluster

Última atualização: Oct 28, 2026

Atualiza um cluster Ray.

Experimente agora

Experimente esta API no OpenAPI Explorer, sem necessidade de assinatura manual. Chamadas bem-sucedidas geram automaticamente código SDK correspondente aos seus parâmetros. Faça o download com segurança de credenciais integrada para uso local.

Testar

Autorização RAM

A tabela abaixo descreve a autorização necessária para chamar esta API. Você pode defini-la em uma política do Resource Access Management (RAM). As colunas da tabela estão detalhadas abaixo:

  • Ação: As ações que podem ser usadas no elemento Action das instruções de política de permissão do RAM para conceder permissões para executar a operação.

  • API: A API que você pode chamar para executar a ação.

  • Nível de acesso: O nível de acesso predefinido concedido para cada API. Valores válidos: create, list, get, update e delete.

  • Tipo de recurso: O tipo de recurso que suporta autorização para executar a ação. Indica se a ação suporta permissão em nível de recurso. O recurso especificado deve ser compatível com a ação. Caso contrário, a política será ineficaz.

    • Para APIs com permissões em nível de recurso, os tipos de recursos obrigatórios são marcados com um asterisco (*). Especifique o Nome de Recurso Alibaba Cloud (ARN) correspondente no elemento Resource da política.

    • Para APIs sem permissões em nível de recurso, é exibido como Todos os Recursos. Use um asterisco (*) no elemento Resource da política.

  • Chave de condição: As chaves de condição definidas pelo serviço. A chave permite controle granular, aplicando-se somente a ações ou a ações associadas a recursos específicos. Além das chaves de condição específicas do serviço, o Alibaba Cloud fornece um conjunto de chaves de condição comuns aplicáveis a todos os serviços compatíveis com RAM.

  • Ação dependente: As ações dependentes necessárias para executar a ação. Para concluir a ação, o usuário RAM ou a função RAM deve ter permissões para executar todas as ações dependentes.

Ação

Nível de acesso

Tipo de recurso

Chave de condição

Ação dependente

emr-serverless-spark:UpdateRayCluster

none

*Todos os recursos.

*

Nenhuma Nenhuma

Sintaxe da solicitação

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

Parâmetros de caminho

Parâmetro

Tipo

Obrigatório

Descrição

Exemplo

workspaceId

string

Não

O ID do workspace.

w-d2d82aa09155

clusterId

string

Não

O ID do cluster.

ray-uiulpgow9xljimm1

Parâmetros da solicitação

Parâmetro

Tipo

Obrigatório

Descrição

Exemplo

body

object

Não

A struct da solicitação.

name

string

Não

O nome do cluster Ray. O nome deve ter de 1 a 64 caracteres.

myRayCluster

displayReleaseVersion

string

Não

A versão do mecanismo Ray DPI.

ray-1.0.0 (Ray 2.47.1, Python 3.12)

description

string

Não

A descrição.

Ray Cluster for dev.

networkServiceName

string

Não

O nome da conexão de rede.

vpc

headSpec

object

Não

As informações do nó head para o cluster Ray.

queueName

string

Não

O nome da fila.

root_queue

cpu

string

Não

O número de núcleos de CPU.

2

memory

string

Não

O tamanho da memória. Unidade: GiB.

8Gi

enableAutoScaling

boolean

Não

Especifica se o escalonamento automático deve ser ativado.

false

idleTimeoutSeconds

integer

Não

O período de tempo limite de ociosidade para workers após a ativação do escalonamento automático.

60

gpuSpec

string

Não

O tipo de instância GPU.

ecs.gn6i-c4g1.xlarge

gftEnabled

boolean

Não

Especifica se a tolerância a falhas do GCS deve ser ativada.

gftConfig

object

Não

A configuração de tolerância a falhas do GCS.

redisUrl

string

Não

O endereço do Redis.

10.4.5.6:6379

redisUsername

string

Não

O nome de usuário do Redis.

default

redisPassword

string

Não

A senha do Redis.

123456

env

string

Não

As variáveis de ambiente.

MY_ENV=123456

rayStartParams

string

Não

Os parâmetros de inicialização do Ray.

--num-cpus=0

displayReleaseVersion

string

Não

A versão do mecanismo Ray DPI.

ray-1.2.0 (Ray 2.55.1, Python 3.12)

workerSpec

array<object>

Não

As informações do nó worker para o cluster Ray. Há suporte para no máximo 50 grupos de workers.

object

Não

A struct de informações do nó worker para o cluster Ray.

groupName

string

Não

O nome do grupo de workers.

WorkerGroup1

workerType

string

Não

O tipo de worker.

Valores válidos:

  • CPU :

    Worker de CPU.

CPU

replica

integer

Não

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

2

queueName

string

Não

O nome da fila.

root_queue

cpu

string

Não

O número de núcleos de CPU.

2

memory

string

Não

O tamanho da memória. Unidade: GiB.

8Gi

minReplica

integer

Não

O número mínimo de workers. Valor mínimo: 1. O valor deve ser menor ou igual ao valor de maxReplica.

1

maxReplica

integer

Não

O número máximo de workers. Valor mínimo: 1.

10

gpuSpec

string

Não

O tipo de instância GPU.

ecs.gn6i-c4g1.xlarge

displayReleaseVersion

string

Não

A versão do mecanismo DPI.

ray-1.2.0 (Ray 2.55.1, Python 3.12)

env

string

Não

As variáveis de ambiente do Ray.

MY_ENV=123456

rayStartParams

string

Não

Os parâmetros de inicialização do Ray.

--num-cpus=0

extraParam

string

Não

Os parâmetros extras. O valor deve estar no formato JSON.

{}

volumeIds

array

Não

A lista de IDs de diretórios gerenciados para montar.

string

Não

O ID do diretório gerenciado.

vol-1234567890

Elementos de resposta

Elemento

Tipo

Descrição

Exemplo

object

Esquema da resposta.

requestId

string

O ID da solicitação.

DD6B1B2A-5837-5237-ABE4-FF0C8944

clusterId

string

O ID do cluster.

ray-xxxxxxxxxxx

Exemplos

Resposta de sucesso

JSON formato

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

Códigos de erro

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.