Consulta a lista de execução e o status dos comandos do Cloud Assistant.
Descrição da operação
-
Após executar um comando, a execução não é necessariamente bem-sucedida nem produz os resultados esperados. Verifique os resultados reais da execução com base nos valores de retorno desta operação. A saída real tem precedência.
-
Você pode consultar as informações de execução dos últimos 30 dias. No máximo 10.000 registros de execução são retidos.
-
Você pode assinar os eventos de status de tarefa do Cloud Assistant para obter resultados de tarefas por meio de eventos, evitando polling frequente e melhorando a eficiência.
-
Ao consultar a primeira página de uma consulta paginada, defina apenas MaxResults para limitar o número de entradas retornadas. O valor NextToken na resposta serve como token para consultar as páginas subsequentes. Ao consultar as páginas subsequentes, defina o parâmetro NextToken com o valor NextToken obtido na resposta anterior e defina MaxResults para limitar o número de entradas retornadas.
-
Diferenças entre DescribeInvocations e DescribeInvocationResults:
- Quando uma única chamada RunCommand/InvokeCommand especifica várias instâncias:
DescribeInvocations retorna o status de execução em cada instância e o status agregado de todas as instâncias.
DescribeInvocationResults retorna apenas o status de execução individual em cada instância, sem o status agregado de várias instâncias.
- Quando uma única chamada RunCommand/InvokeCommand especifica uma instância:
DescribeInvocations e DescribeInvocationResults são amplamente intercambiáveis e podem substituir um ao outro.
Para visualizar o histórico de execução de tarefas agendadas (periódicas) ou tarefas que são executadas automaticamente na inicialização da instância (RepeatMode=Period, EveryReboot), apenas DescribeInvocationResults pode recuperar registros de execução anteriores (especificando IncludeHistory=true). DescribeInvocations retorna apenas o status mais recente da tarefa.
Para visualizar o conteúdo e os parâmetros do comando, apenas DescribeInvocations retorna CommandContent.
- Quando uma única chamada RunCommand/InvokeCommand especifica várias instâncias:
Experimente agora
Testar
Autorização RAM
|
Ação |
Nível de acesso |
Tipo de recurso |
Chave de condição |
Ação dependente |
|
ecs:DescribeInvocations |
get |
Instância.
Command.
|
Nenhuma | 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 |
| ResourceGroupId |
string |
Não |
O ID do grupo de recursos para execução de comando. Após especificar este parâmetro, você também deve especificar ResourceGroupId ao executar o comando. Este parâmetro filtra os resultados de execução do comando correspondente. |
rg-bp67acfmxazb4p**** |
| InvokeId |
string |
Não |
O ID de execução do comando. |
t-hz0jdfwd9f**** |
| CommandId |
string |
Não |
O ID do comando. Você pode chamar DescribeCommands para consultar todos os IDs de comando disponíveis. |
c-hz0jdfwcsr**** |
| CommandName |
string |
Não |
O nome do comando. Este parâmetro não entra em vigor se o parâmetro InstanceId também for especificado. |
CommandTestName |
| CommandType |
string |
Não |
O tipo de comando. Valores válidos:
|
RunShellScript |
| Timed |
boolean |
Não |
Especifica se o comando consultado está agendado para ser executado automaticamente no futuro. Valores válidos:
Valor padrão: false. |
true |
| InvokeStatus |
string |
Não |
O status geral de execução do comando. O status geral de execução depende do status de execução comum de uma ou mais instâncias na execução. Valores válidos:
|
Finished |
| InstanceId |
string |
Não |
O ID da instância. Se você especificar este parâmetro, todos os registros de execução de comando para a instância serão consultados. |
i-bp1i7gg30r52z2em**** |
| ContentEncoding |
string |
Não |
O modo de codificação dos campos CommandContent e Output na resposta. Valores válidos:
Valor padrão: Base64. |
PlainText |
| IncludeOutput |
boolean |
Não |
Especifica se a saída do comando deve ser retornada nos resultados.
Valor padrão: false. |
false |
| PageNumber |
integer |
Não |
Nota
Este parâmetro está prestes a ser descontinuado. Use NextToken e MaxResults para realizar operações de consulta paginada. |
1 |
| PageSize |
integer |
Não |
Nota
Este parâmetro está prestes a ser descontinuado. Use NextToken e MaxResults para realizar operações de consulta paginada. |
10 |
| MaxResults |
integer |
Não |
O número máximo de entradas por página para uma consulta paginada. Valor máximo: 50. Valor padrão: 10. |
10 |
| NextToken |
string |
Não |
O token de paginação. Defina este parâmetro com o valor NextToken retornado na chamada de API anterior. |
AAAAAdDWBF2 |
| RepeatMode |
string |
Não |
O modo de execução do comando. Este parâmetro não entra em vigor se o parâmetro InstanceId também for especificado. Valores válidos:
Valor padrão: vazio, o que indica que todos os modos de execução são consultados. |
Once |
| Tag |
array<object> |
Não |
As tags. |
|
|
object |
Não |
As tags. |
||
| Key |
string |
Não |
A chave da tag da execução do comando. Valores válidos de N: 1 a 20. A chave da tag não pode ser uma string vazia. Se você usar uma única tag para filtrar recursos, o número de recursos com esta tag não pode exceder 1.000. Se você usar várias tags para filtrar recursos, o número de recursos com todas as tags especificadas anexadas não pode exceder 1.000. Se a contagem de recursos exceder 1.000, chame ListTagResources para executar a consulta. A chave da tag pode ter até 64 caracteres e não pode começar com aliyun ou acs:. Não pode conter http:// ou https://. |
TestKey |
| Value |
string |
Não |
O valor da tag da execução do comando. Valores válidos de N: 1 a 20. O valor da tag pode ser uma string vazia. O valor da tag pode ter até 128 caracteres e não pode conter http:// ou https://. |
TestValue |
Elementos de resposta
|
Elemento |
Tipo |
Descrição |
Exemplo |
|
object |
|||
| Invocations |
object |
||
| Invocation |
array<object> |
Os registros de execução do comando. |
|
|
array<object> |
A hora em que a tarefa foi criada. |
||
| CommandContent |
string |
O conteúdo do comando.
|
cnBtIC1xYSB8IGdyZXAgdnNm**** |
| CommandDescription |
string |
A descrição do comando. |
testDescription |
| CommandId |
string |
O ID do comando. |
c-hz0jdfwcsr**** |
| CommandName |
string |
O nome do comando. |
CommandTestName |
| CommandType |
string |
O tipo de comando. |
RunShellScript |
| ContainerId |
string |
O ID do contêiner. |
ab141ddfbacfe02d9dbc25966ed971536124527097398d419a6746873fea**** |
| ContainerName |
string |
O nome do contêiner. |
test-container |
| CreationTime |
string |
A hora em que a tarefa foi criada. A hora é exibida no formato ISO 8601 em UTC. |
2020-01-19T09:15:46Z |
| Frequency |
string |
A programação na qual o comando é executado. |
0 */20 * * * * |
| InvocationStatus |
string |
O status geral de execução do comando. O status geral de execução depende do status de execução comum de todas as instâncias nesta invocação. Valores válidos:
Nota
O parâmetro de resposta InvokeStatus tem um significado semelhante, mas recomendamos que você verifique este parâmetro em seu lugar. |
Running |
| InvokeId |
string |
O ID de execução do comando. |
t-hz0jdfwd9f**** |
| InvokeInstances |
object |
||
| InvokeInstance |
array<object> |
O tipo de conjunto de instâncias de destino para a execução. |
|
|
object |
A lista de status de execução. |
||
| CreationTime |
string |
A hora em que a execução do comando começou. A hora é exibida no formato ISO 8601 em UTC. |
2019-12-20T06:15:54Z |
| Dropped |
integer |
O comprimento do texto truncado e descartado após o texto no campo Output exceder 24 KB. |
0 |
| ErrorCode |
string |
O código de erro para falha na entrega do comando ou falha na execução. Valores válidos:
|
InstanceNotExists |
| ErrorInfo |
string |
O motivo detalhado para falha na entrega do comando ou falha na execução. Valores válidos:
|
the specified instance does not exists |
| ExitCode |
integer |
O código de saída do processo do comando. Valores válidos:
|
0 |
| FinishTime |
string |
A hora em que o processo do comando terminou. A hora é exibida no formato ISO 8601 em UTC. |
2019-12-20T06:15:56Z |
| InstanceId |
string |
O ID da instância. |
i-bp1i7gg30r52z2em**** |
| InstanceInvokeStatus |
string |
O status de execução do comando em uma única instância. Nota
Recomendamos que você verifique o parâmetro de resposta InvocationStatus em vez deste parâmetro. |
Finished |
| InvocationStatus |
string |
O status de execução do comando em uma única instância. Valores válidos:
|
Success |
| OssOutputErrorCode |
string |
O código de erro quando a entrega falha. Este parâmetro é retornado apenas quando OssOutputStatus é Failed. Valores válidos:
|
CloudAssistant.UnsupportedInvocationStatus |
| OssOutputErrorInfo |
string |
Os detalhes do erro quando a entrega falha. Este parâmetro é retornado apenas quando OssOutputStatus é Failed. |
The invocation status does not support output delivery |
| OssOutputStatus |
string |
O status de entrega da saída de execução do comando para o OSS. Valores válidos:
|
Finished |
| OssOutputUri |
string |
O URI do arquivo no OSS para o qual a saída de execução do comando é entregue. Este campo é uma string vazia quando a entrega falha ou está em andamento. |
oss://testBucket/testPrefix/output.txt |
| Output |
string |
A saída do comando.
|
OutPutTestmsg |
| Repeats |
integer |
O número de vezes que o comando foi executado na instância.
|
0 |
| StartTime |
string |
A hora em que o comando começou a ser executado na instância. A hora é exibida no formato ISO 8601 em UTC. |
2019-12-20T06:15:55Z |
| StopTime |
string |
A hora em que StopInvocation foi chamado para interromper a execução do comando. A hora é exibida no formato ISO 8601 em UTC. |
2020-01-19T09:15:47Z |
| Timed |
boolean |
Indica se o comando consultado está agendado para ser executado automaticamente no futuro. |
false |
| UpdateTime |
string |
A hora em que o status do comando foi atualizado pela última vez. A hora é exibida no formato ISO 8601 em UTC. |
2020-01-19T09:15:47Z |
| InvokeStatus |
string |
O status geral de execução do comando. Nota
Recomendamos que você verifique o parâmetro de resposta InvocationStatus em vez deste parâmetro. |
Finished |
| Launcher |
string |
O launcher usado para executar o script. O launcher pode ter até 1 KB de comprimento. |
python3 -u {{ACS::ScriptFileName|Ext(".py")}} |
| OssOutputDelivery |
string |
A configuração de entrega do OSS para a saída de execução do comando. |
oss://testBucket/testPrefix |
| Parameters |
string |
Os parâmetros personalizados no comando. |
{} |
| RepeatMode |
string |
O modo de execução do comando. Valores válidos:
|
Once |
| Tags |
object |
||
| Tag |
array<object> |
As informações de tag da execução do comando. |
|
|
object |
As informações de tag da execução do comando. |
||
| TagKey |
string |
A chave da tag da execução do comando. |
owner |
| TagValue |
string |
O valor da tag da execução do comando. |
zhangsan |
| TerminationMode |
string |
O modo usado quando a tarefa é interrompida (interrompida manualmente ou interrompida devido a tempo limite). Valores válidos:
|
ProcessTree |
| Timed |
boolean |
Indica se o comando consultado está agendado para ser executado automaticamente no futuro. |
false |
| Timeout |
integer |
O período máximo de tempo limite para o comando ser executado em instâncias ECS. Unidade: segundos. Se o comando não puder ser executado por algum motivo, ocorrerá um tempo limite. Quando ocorre um tempo limite, o processo do comando é encerrado à força encerrando o PID do comando. |
60 |
| Username |
string |
O nome de usuário usado para executar o comando na instância ECS. |
test |
| WorkingDir |
string |
O diretório de trabalho do comando. |
/home/ |
| NextToken |
string |
O token de paginação retornado nesta chamada. |
AAAAAdDWBF2 |
| PageNumber |
integer |
O número da página dos resultados da consulta. |
1 |
| PageSize |
integer |
O número de entradas por página. |
10 |
| RequestId |
string |
O ID da solicitação. |
473469C7-AA6F-4DC5-B3DB-A3DC0DE3**** |
| TotalCount |
integer |
O número total de comandos. |
1 |
Exemplos
Resposta de sucesso
JSON formato
{
"Invocations": {
"Invocation": [
{
"CommandContent": "cnBtIC1xYSB8IGdyZXAgdnNm****",
"CommandDescription": "testDescription",
"CommandId": "c-hz0jdfwcsr****",
"CommandName": "CommandTestName",
"CommandType": "RunShellScript",
"ContainerId": "ab141ddfbacfe02d9dbc25966ed971536124527097398d419a6746873fea****",
"ContainerName": "test-container",
"CreationTime": "2020-01-19T09:15:46Z",
"Frequency": "0 */20 * * * *",
"InvocationStatus": "Running",
"InvokeId": "t-hz0jdfwd9f****",
"InvokeInstances": {
"InvokeInstance": [
{
"CreationTime": "2019-12-20T06:15:54Z",
"Dropped": 0,
"ErrorCode": "InstanceNotExists",
"ErrorInfo": "a instância especificada não existe",
"ExitCode": 0,
"FinishTime": "2019-12-20T06:15:56Z",
"InstanceId": "i-bp1i7gg30r52z2em****",
"InstanceInvokeStatus": "Finished",
"InvocationStatus": "Success",
"OssOutputErrorCode": "CloudAssistant.UnsupportedInvocationStatus",
"OssOutputErrorInfo": "O status da invocação não suporta a entrega de saída",
"OssOutputStatus": "Finished",
"OssOutputUri": "oss://testBucket/testPrefix/output.txt",
"Output": "OutPutTestmsg",
"Repeats": 0,
"StartTime": "2019-12-20T06:15:55Z",
"StopTime": "2020-01-19T09:15:47Z",
"Timed": false,
"UpdateTime": "2020-01-19T09:15:47Z"
}
]
},
"InvokeStatus": "Finished",
"Launcher": "python3 -u {{ACS::ScriptFileName|Ext(\".py\")}}",
"OssOutputDelivery": "oss://testBucket/testPrefix",
"Parameters": "{}",
"RepeatMode": "Once",
"Tags": {
"Tag": [
{
"TagKey": "owner",
"TagValue": "zhangsan"
}
]
},
"TerminationMode": "ProcessTree",
"Timed": false,
"Timeout": 60,
"Username": "test",
"WorkingDir": "/home/"
}
]
},
"NextToken": "AAAAAdDWBF2",
"PageNumber": 1,
"PageSize": 10,
"RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3****",
"TotalCount": 1
}
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 | NumberExceed.Tags | The Tags parameter number is exceed. | O número de tags excede o limite máximo. Você pode especificar até 20 tags para esta operação. |
| 400 | Duplicate.TagKey | The Tag.N.Key contain duplicate key. | Existem chaves duplicadas nas tags. Certifique-se de que todas as chaves sejam únicas. |
| 400 | InvalidTagKey.Malformed | The specified Tag.n.Key is not valid. | O parâmetro de chave de tag especificado é inválido. |
| 400 | InvalidTagValue.Malformed | The specified Tag.n.Value is not valid. | O parâmetro de valor da tag especificado é inválido. |
| 400 | MissingParameter.TagKey | You must specify Tag.N.Key. | Especifique uma chave de tag. |
| 400 | InvalidParam.PageNumber | The specified parameter is invalid. | |
| 400 | InvalidParam.PageSize | The specified parameter is invalid. | |
| 400 | InvalidParameter.NextToken | The specified parameter NextToken is not valid. | |
| 400 | InvalidParameter.MaxResults | The specified parameter MaxResults is not valid. | O parâmetro MaxResults 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 | Operation.Forbidden | The operation is not permitted. | A operação não é permitida. |
| 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 | InvalidCommandId.NotFound | The specified commandId does not exist |
Consulte Códigos de Erro para uma lista completa.
Notas de versão
Consulte Notas de Versão para uma lista completa.