ModifyCommand - Elastic Compute Service: Central de Documentação do Alibaba Cloud

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

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

ecs:ModifyCommand

update

*Command.

acs:ecs:{#regionId}:{#accountId}:command/{#commandId}

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
RegionId	string	Sim	O ID da região. Você pode chamar DescribeRegions para consultar a lista de regiões mais recente.	cn-hangzhou
CommandId	string	Sim	O ID do comando. Você pode chamar DescribeCommands para consultar todos os IDs de comandos disponíveis.	c-hz01272yr52****
Name	string	Não	O nome do comando. O nome aceita todos os conjuntos de caracteres e pode ter até 128 caracteres de comprimento.	test-CommandName
Description	string	Não	A descrição do comando. A descrição aceita todos os conjuntos de caracteres e pode ter até 512 caracteres de comprimento.	Esta é a descrição
CommandContent	string	Não	Nota Este parâmetro foi descontinuado e não tem efeito mesmo se especificado.	echo
WorkingDir	string	Não	O caminho de execução. O caminho pode ter até 200 caracteres de comprimento.	/home/
Timeout	integer	Não	O tempo limite máximo para a execução do comando em instâncias ECS. Unidade: segundos. Se o comando não puder ser concluído dentro do tempo limite especificado, o comando expirará. Quando ocorre um tempo limite, o processo do comando é encerrado à força pelo cancelamento do PID do comando.	120
Launcher	string	Não	O programa de inicialização para a execução do script. O valor pode ter até 1 KB de comprimento.	python3 -u {{ACS::ScriptFileName\|Ext(".py")}}

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object
RequestId	string	O ID da solicitação.	0DE9B41E-EF0D-40A0-BB43-37749C5BDA9C

Exemplos

Resposta de sucesso

JSON formato

{
  "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.	A operação de API não é suportada na região especificada. Verifique se o valor do parâmetro RegionId está correto.
400	InvalidParameter.WorkingDir	The specified parameter WorkingDir is not valid.	O parâmetro WorkingDir especificado é inválido.
500	InternalError.Dispatch	An error occurred when you dispatched the request.	Ocorreu um erro ao enviar a solicitação. Tente novamente mais tarde.
403	InvalidParameterCharacter	The specified parameter %s contains illegal characters.
403	CmdName.Readonly	The command name is readonly after publishing.	O comando foi publicado e não pode ser modificado.
403	CmdName.ExceedLimit	The length of the command name exceeds the upper limit.	O nome do comando excede o comprimento máximo.
403	CmdContent.ExceedLimit	The length of the command content exceeds the upper limit.	O conteúdo do seu comando é muito longo. Simplifique o conteúdo do seu comando.
403	CmdDesc.ExceedLimit	The length of the command description exceeds the upperlimit.	O comprimento da descrição do comando excede o limite superior.
403	Operation.Forbidden	The operation is not permitted.	A operação não é permitida.
403	InvalidParameterCharacter.CommandName	The command Name contains illegal characters.	O nome do comando contém caracteres inválidos.
403	InvalidParameterCharacter.CommandDescription	The command Description contains illegal characters.	A descrição do comando contém caracteres inválidos.
403	InvalidParameterCharacter.CommandWorkingDir	The command WorkingDir contains illegal characters.	O caminho de execução do comando contém caracteres inválidos.
403	InvalidLauncher.LengthLimitExceeded	The length of the parameter Launcher exceeds the limit of 1 KB characters.	O comprimento do parâmetro Launcher excede o limite de 1 KB.
403	InvalidTimeout.ExceedLimit	The specified parameter Timeout exceeds the upper limit.
404	InvalidRegionId.NotFound	The RegionId provided does not exist in our records.	O RegionId especificado não existe. Verifique se o produto está disponível nesta região.
404	InvalidCmdId.NotFound	The specified command ID does not exist.	O parâmetro CommandId especificado é inválido. Verifique se o valor do parâmetro está correto. Você pode chamar DescribeCommands para consultar todos os valores de CommandId disponíveis.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.