RunCommand - Simple Application Server: Central de Documentação do Alibaba Cloud

Executa comandos em um servidor de aplicativo simples.

Descrição da operação

O Command Assistant é uma ferramenta automatizada de O&M para o Simple Application Server. Você pode manter servidores de aplicativo simples executando comandos shell, PowerShell e em lote no console do Simple Application Server sem fazer login remoto nos servidores.

Antes de usar o Command Assistant, observe os seguintes itens:

O servidor de aplicativo simples deve estar no estado Running.
O cliente do Cloud Assistant está instalado no servidor. Por padrão, o cliente do Cloud Assistant é instalado nos servidores de aplicativo simples. Se você desinstalou o cliente manualmente, será necessário reinstalá-lo. Para mais informações, consulte Instalar o agente 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

swas-open:RunCommand

create

*Command

acs:swas-open:{#regionId}:{#accountId}:{#CommandId}

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
CommandContent	string	Sim	O conteúdo do comando. Observe os seguintes itens: Se você definir `EnableParameter` como true, o recurso de parâmetros personalizados será ativado no conteúdo do comando e você poderá configurar parâmetros personalizados com base nas seguintes regras: Defina parâmetros personalizados no formato {{}}. Dentro de `{{}}`, os espaços e as quebras de linha antes e depois dos nomes dos parâmetros são ignorados. O número de parâmetros personalizados não pode ser maior que 20. O nome de um parâmetro personalizado pode conter apenas letras, dígitos, sublinhados (_) e hifens (-). O nome não diferencia maiúsculas de minúsculas. Cada nome de parâmetro personalizado não pode exceder 64 bytes de comprimento.	ifconfig -s
WorkingDir	string	Não	O caminho de execução do comando. Caminhos personalizados são suportados. Os caminhos de execução padrão variam de acordo com os sistemas operacionais dos servidores. Para servidores Linux, o caminho padrão é /root do usuário root. Para servidores Windows, o caminho padrão é C:\Windows\system32.	/root
RegionId	string	Sim	O ID da região do servidor de aplicativo simples. Você pode chamar a operação ListRegions para consultar a lista de regiões mais recente.	cn-hangzhou
Timeout	integer	Não	O tempo limite do comando no servidor. Se uma tarefa de execução de comando atingir o tempo limite, o Command Assistant encerrará à força o processo da tarefa. Valores válidos: 10 a 86400. Unidade: segundos. O período de 86400 segundos equivale a 24 horas. Valor padrão: 60.	60
Type	string	Sim	O tipo de linguagem do comando. Valores válidos: RunBatScript: comandos em lote (aplicável a servidores Windows). RunPowerShellScript: comandos PowerShell (aplicável a servidores Windows). RunShellScript: comandos shell (aplicável a servidores Linux).	RunShellScript
EnableParameter	boolean	Não	Especifica se o recurso de parâmetros personalizados deve ser ativado. Valor padrão: false.	false
Parameters	object	Não	Os parâmetros personalizados no formato de par chave-valor que devem ser transmitidos quando o comando inclui parâmetros personalizados. Por exemplo, se o conteúdo do comando for `echo {{name}}`, você pode usar `Parameters` para transmitir o par chave-valor `{"name":"Jack"}`. A chave `name` do parâmetro personalizado é substituída automaticamente pelo valor emparelhado Jack para gerar um novo comando. Como resultado, o comando `echo Jack` é executado. Você pode especificar até 20 parâmetros personalizados. Observe os seguintes itens: A chave de um parâmetro personalizado pode ter até 64 caracteres de comprimento e não pode ser uma string vazia. O valor de um parâmetro personalizado pode ser uma string vazia. O tamanho do comando (incluindo parâmetros personalizados e conteúdo original do comando) após a codificação Base64 não pode exceder 16 KB. Os nomes dos parâmetros personalizados especificados por Parameters devem estar incluídos nos nomes dos parâmetros personalizados que você especificou ao criar o comando. Você pode usar strings vazias para representar os parâmetros que não são transmitidos. Este parâmetro é deixado vazio por padrão, o que indica que o recurso de parâmetros personalizados está desativado.	{"name":"Jack", "accessKey":"LTAI****************"}
WorkingUser	string	Não	Um usuário do servidor que executa o comando. Recomendamos que você execute o comando como um usuário comum para reduzir os riscos de segurança. Valores padrão: Para servidores Linux, o valor padrão é root. Para servidores Windows, o valor padrão é system.	root
WindowsPasswordName	string	Não	O nome da senha usada para executar o comando em um servidor de aplicativo simples Windows. Se você quiser usar um nome de usuário diferente do nome de usuário padrão "system" para executar o comando em um servidor Windows, deverá especificar os parâmetros WindowsPasswordName e WorkingUser. A senha é hospedada em texto simples no repositório de parâmetros do CloudOps Orchestration Service (OOS) para mitigar o risco de vazamento de senhas. Apenas o nome da senha é transmitido usando WindowsPasswordName.	axtSecretPassword
InstanceId	string	Sim	O ID do servidor de aplicativo simples.	ace0706b2ac4454d984295a94213****
Name	string	Sim	O nome do comando.	testName

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	Esquema da resposta.
RequestId	string	O ID da solicitação.	473469C7-AA6F-4DC5-B3DB-A3DC0DE3****
InvokeId	string	O ID da execução.	t-hz02p9545t6****

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3****",
  "InvokeId": "t-hz02p9545t6****"
}

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.