updateCluster - AWS ParallelCluster

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

updateCluster

Atualiza um cluster.

Sintaxe da solicitação

PUT /v3/clusters/{clusterName} { "clusterConfiguration": "string", "dryrun": boolean, "forceUpdate": boolean, "region": "string", "suppressValidators": "string", "validationFailureLevel": "string" }

Corpo da solicitação

clusterConfiguration

A configuração do cluster como um documento YAML.

Obrigatório: Sim

clusterName

O nome do cluster.

Tipo: sequência

Obrigatório: Sim

dryrun

Se definido como true, executa somente a validação da solicitação, sem criar nenhum recurso. Use este parâmetro para validar a configuração do cluster e atualizar os requisitos. O padrão é false.

Tipo: booliano

Obrigatório: Não

forceUpdate

Se definido como true, ignora os erros de validação da atualização e força a atualização. O padrão é false.

Tipo: booliano

Obrigatório: Não

região

A Região da AWS em que o cluster está.

Tipo: sequência

Obrigatório: Não

suppressValidators

Identifica um ou mais validadores de configuração a serem suprimidos.

Tipo: sequência

Formato: (ALL|type:[A-Za-z0-9]+)

Obrigatório: Não

Exemplo de valores válidos: currentValue, requestedValue, message

validationFailureLevel

O nível mínimo de validação que pode causar falha na atualização.

Tipo: sequência

Valores válidos: INFO | WARNING | ERROR

Obrigatório: Não

Sintaxe da resposta

{ "cluster": { "clusterName": "string", "region": "string", "version": "string", "cloudformationStackArn": "string", "cloudformationStackStatus": "UPDATE_IN_PROGRESS", "clusterStatus": "UPDATE_IN_PROGRESS", "scheduler": { "type": "string", "metadata": { "name": "string", "version": "string" } } }, "validationMessages": [ { "id": "string", "type": "string", "level": "INFO", "message": "string" } ], "changeSet": [ { "parameter": "string", "currentValue": "string", "requestedValue": "string" } ] }

Corpo da resposta

changeSet

O conjunto de alterações para a atualização do cluster.

currentValue

O valor atual do parâmetro a ser atualizado.

Tipo: sequência

parameter

O parâmetro a ser atualizado.

Tipo: sequência

requestedValue

O valor solicitado para o parâmetro a ser atualizado.

Tipo: sequência

cluster
cloudformationStackArn

O nome do recurso da Amazon (ARN) da pilha principal do CloudFormation.

Tipo: sequência

cloudformationStackStatus

Status de pilha do CloudFormation.

Tipo: sequência

Valores válidos: CREATE_IN_PROGRESS | CREATE_FAILED | CREATE_COMPLETE | ROLLBACK_IN_PROGRESS | ROLLBACK_FAILED | ROLLBACK_COMPLETE | DELETE_IN_PROGRESS | DELETE_FAILED | DELETE_COMPLETE | UPDATE_IN_PROGRESS | UPDATE_COMPLETE_CLEANUP_IN_PROGRESS | UPDATE_COMPLETE | UPDATE_ROLLBACK_IN_PROGRESS | UPDATE_ROLLBACK_FAILED | UPDATE_ROLLBACK_COMPLETE_CLEANUP_IN_PROGRESS | UPDATE_ROLLBACK_COMPLETE

clusterName

Nome do cluster.

Tipo: sequência

clusterStatus

Status do cluster.

Tipo: sequência

Valores válidos: CREATE_IN_PROGRESS | CREATE_FAILED | CREATE_COMPLETE | DELETE_IN_PROGRESS | DELETE_FAILED | DELETE_COMPLETE | UPDATE_IN_PROGRESS | UPDATE_COMPLETE | UPDATE_FAILED

região

A Região da AWS em que o cluster foi criado.

Tipo: sequência

scheduler (programador)
metadata

Os metadados do programador.

name

O nome do programador.

Tipo: sequência

versão

A versão do programador.

Tipo: sequência

tipo

O tipo de programador.

Tipo: sequência

versão

Versão do AWS ParallelCluster usada para criar o cluster.

Tipo: sequência

validationMessages

Uma lista de mensagens com um nível de validação inferior a validationFailureLevel. A lista de mensagens é coletada durante a validação da configuração.

id

O ID do validador.

Tipo: sequência

level

O nível de validação.

Tipo: sequência

Valores válidos: INFO | WARNING | ERROR

message

A mensagem de validação.

Tipo: sequência

tipo

O tipo do validador.

Tipo: sequência

Exemplo

Python

Solicitação

$ update_cluster(cluster_name_3x, path/config-file.yaml)

Resposta 200

{ 'change_set': [ { 'current_value': '10', 'parameter': 'Scheduling.SlurmQueues[queue1].ComputeResources[t2micro].MaxCount', 'requested_value': '15' } ], 'cluster': { 'cloudformation_stack_arn': 'arn:aws:cloudformation:us-east-1:123456789012:stack/test-api-cluster/e0462730-50b5-11ed-99a3-0a5ddc4a34c7', 'cloudformation_stack_status': 'UPDATE_IN_PROGRESS', 'cluster_name': 'cluster-3x', 'cluster_status': 'UPDATE_IN_PROGRESS', 'region': 'us-east-1', 'scheduler': { 'type': 'slurm' }, 'version': '3.2.1' } }