Todos os produtos
Search
Central de documentação

:ModifyCommand

Última atualização: Jul 03, 2026

Modifica os parâmetros de um comando do Cloud Assistant.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Para sua conveniência, recomendamos que você chame esta operação no OpenAPI Explorer. O OpenAPI Explorer gera dinamicamente o código de exemplo da operação para diferentes SDKs.

Parâmetros da solicitação

Parâmetro Tipo Obrigatório Exemplo Descrição
Action String Sim ModifyCommand

A operação a ser executada. Defina o valor como ModifyCommand.

RegionId String Sim cn-hangzhou

ID da região do comando. Chame a operação DescribeRegions para consultar a lista de regiões mais recente.

CommandId String Sim c-hz01272yr52****

ID do comando. Chame a operação DescribeCommands para consultar todos os IDs de comando disponíveis.

Name String Não test-CommandName

Nome do comando. Aceita todos os conjuntos de caracteres e pode ter até 128 caracteres.

Description String Não This is description.

Descrição do comando. Aceita todos os conjuntos de caracteres e pode ter até 512 caracteres.

CommandContent String Não echo
Nota Este parâmetro foi descontinuado e não tem efeito.
WorkingDir String Não /home/

Caminho de execução do comando. O valor pode ter até 200 caracteres.

Timeout Long Não 120

Tempo limite máximo para execução do comando nas instâncias. Unidade: segundos. Se o comando não for concluído dentro do período especificado, ocorrerá um erro de tempo limite. Nesse caso, o cliente do Cloud Assistant encerra forçosamente o processo do comando cancelando o ID do processo (PID) correspondente.

Parâmetros de resposta

Parâmetro

Tipo

Exemplo

Descrição

RequestId

String

0DE9B41E-EF0D-40A0-BB43-37749C5BDA9C

ID da solicitação.

Exemplos

Exemplos de solicitações

https://ecs.aliyuncs.com/?Action=ModifyCommand
&CommandId=c-hz01272yr52****
&RegionId=cn-hangzhou
&Name=test-CommandName
&Description=This is description.
&CommandContent=c2VydmljZSB0b21jYXQgc3RhcnQ=
&WorkingDir=/home/
&Timeout=120
&<Common request parameters>

Exemplos de respostas de sucesso

Formato XML

HTTP/1.1 200 OK
Content-Type:application/xml

<ModifyCommandResponse>
    <RequestId>0DE9B41E-EF0D-40A0-BB43-37749C5BDA9C</RequestId>
</ModifyCommandResponse>

Formato JSON

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "0DE9B41E-EF0D-40A0-BB43-37749C5BDA9C"
}

Códigos de erro

Código de status HTTP

Código de erro

Mensagem de erro

Descrição

400

RegionId.ApiNotSupported

The api is not supported in this region.

Esta operação não pode ser executada na região especificada. Verifique se o parâmetro RegionId é válido.

400

InvalidParameter.WorkingDir

The specified parameter WorkingDir is not valid.

Valor inválido para o parâmetro WorkingDir.

403

CmdName.Readonly

The command name is readonly after publishing.

O comando já foi publicado e seu nome não pode ser alterado.

403

CmdName.ExceedLimit

The length of the command name exceeds the upper limit.

O comprimento do nome do comando excede o limite máximo permitido.

403

CmdContent.ExceedLimit

The length of the command content exceeds the upper limit.

O comprimento do conteúdo do comando excede o limite máximo permitido.

403

CmdDesc.ExceedLimit

The length of the command description exceeds the upperlimit.

O comprimento da descrição do comando excede o limite máximo permitido.

403

Operation.Forbidden

The operation is not permitted.

A operação não é suportada.

404

InvalidCmdId.NotFound

The specified command ID does not exist.

Valor inválido para CommandId. Chame a operação DescribeCommands para consultar todos os IDs de comando disponíveis.

500

InternalError.Dispatch

An error occurred when you dispatched the request.

Ocorreu um erro durante o envio da solicitação. Tente novamente mais tarde.

Para obter uma lista de códigos de erro, consulte Códigos de erro do serviço.