Todos os produtos
Search
Central de documentação

Elastic Compute Service:DescribeInvocationResults

Última atualização: Nov 03, 2026

Consulta os resultados da execução de um ou mais comandos do Cloud Assistant, que são os resultados reais da execução nas instâncias ECS.

Descrição da operação

Descrição da operação

  • Após executar um comando, ele pode não ser executado com sucesso ou não produzir os resultados esperados. Você deve chamar esta operação para consultar de forma paginada os resultados reais da execução. A saída real prevalece.

  • Você pode consultar as informações de execução dos últimos 30 dias. Um máximo de 10.000 registros de execução pode ser retido.

  • Você pode assinar os eventos de status de tarefa do Cloud Assistant para obter os resultados das tarefas por meio de eventos. Isso evita polling frequente e melhora a eficiência.

  • Ao consultar a primeira página, você só precisa definir MaxResults para limitar o número de entradas retornadas. O valor NextToken na resposta é usado como token para consultar de forma paginada a próxima página. Ao consultar a próxima página, defina o parâmetro NextToken com o valor NextToken obtido da resposta anterior e defina MaxResults para limitar o número de entradas retornadas.

  • Diferenças entre DescribeInvocations e DescribeInvocationResults:

    • Quando uma chamada RunCommand ou InvokeCommand especifica várias instâncias:
      • Você pode usar DescribeInvocations para obter o status de execução da tarefa em cada instância e o status agregado da tarefa em várias instâncias.

      • Você pode usar DescribeInvocationResults para obter apenas o status de execução individual em cada instância, que não inclui o status agregado em várias instâncias.

    • Quando uma chamada RunCommand ou InvokeCommand especifica uma única instância:
      • Há pouca diferença entre DescribeInvocations e DescribeInvocationResults. Eles são totalmente intercambiáveis.

    • Quando você precisa visualizar os registros de execução de uma tarefa agendada ou de uma tarefa executada automaticamente na inicialização (RepeatMode=Period, EveryReboot), você só pode usar DescribeInvocationResults para consultar de forma paginada os registros históricos de execução (você deve especificar IncludeHistory=true). DescribeInvocations retorna apenas o status mais recente da tarefa.

    • Quando você precisa visualizar o conteúdo e os parâmetros do comando, apenas DescribeInvocations retorna CommandContent.

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:DescribeInvocationResults

get

Command

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

Instance

acs:ecs:{#regionId}:{#accountId}:instance/{#instanceId}

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 a operação DescribeRegions para consultar a lista de regiões mais recente.

cn-hangzhou

ResourceGroupId

string

Não

O ID do grupo de recursos ao qual a execução do comando pertence. Após especificar este parâmetro, você deve especificar ResourceGroupId ao executar o comando. Isso permite filtrar os resultados de execução do comando correspondentes.

rg-bp67acfmxazb4p****

InvokeId

string

Não

O ID de execução do comando. Você pode chamar a operação DescribeInvocations para consultar o InvokeId.

t-hz0jdfwd9f****

InstanceId

string

Não

O ID da instância.

i-bp1i7gg30r52z2em****

CommandId

string

Não

O ID do comando.

c-hz0jdfwcsr****

InvokeRecordStatus

string

Não

O status de execução do comando. Valores válidos:

  • Running: O comando está em execução.
    • Execução agendada: O status de execução permanece Running até que o comando agendado seja interrompido manualmente.

    • Execução única: O status geral de execução é Running desde que um processo de comando esteja em execução.

  • Finished: O comando foi concluído.
    • Execução agendada: O processo do comando não pode ser concluído.

    • Execução única: O comando é concluído em todas as instâncias, ou o processo do comando é interrompido manualmente em algumas instâncias e concluído nas instâncias restantes.

  • Success:
    • Execução única: O comando foi concluído e o código de saída é 0.

    • Execução agendada: A última execução foi bem-sucedida, o código de saída foi 0 e o tempo de execução especificado terminou.

  • Failed: A execução falhou.
    • Execução agendada: O processo do comando não pode falhar.

    • Execução única: A execução falhou em todas as instâncias.

  • PartialFailed: A execução falhou parcialmente.
    • Execução agendada: O processo do comando não pode falhar parcialmente.

    • Execução única: O processo do comando falhou em algumas instâncias. O status geral de execução é PartialFailed.

  • Stopped: A execução do comando foi interrompida.

  • Stopping: A execução do comando está sendo interrompida.

Running

IncludeHistory

boolean

Não

Especifica se deve retornar os registros históricos de execuções de comandos agendados. Valores válidos:

  • true: Retorna os resultados das execuções de comandos agendados. Se este parâmetro for definido como true, o parâmetro InvokeId não pode estar vazio e deve ser o ID de execução de um comando agendado (RepeatMode é Period) ou de um comando executado após cada inicialização do sistema (RepeatMode é EveryReboot).

  • false: Não retorna os registros históricos.

Valor padrão: false.

false

ContentEncoding

string

Não

O formato de codificação dos campos CommandContent e Output na resposta. Valores válidos:

  • PlainText: Retorna o conteúdo original do comando e as informações de saída.

  • Base64: Retorna o conteúdo do comando e as informações de saída codificados em Base64.

Valor padrão: Base64.

PlainText

PageNumber

integer

Não

Nota

Este parâmetro será descontinuado em breve. Recomendamos que você use NextToken e MaxResults para realizar operações de paginação.

1

PageSize

integer

Não

Nota

Este parâmetro será descontinuado em breve. Recomendamos que você use NextToken e MaxResults para realizar operações de paginação.

1

MaxResults

integer

Não

O número máximo de entradas por página para paginação.

Valor máximo: 50.

Valor padrão: 10.

10

NextToken

string

Não

O token de paginação. Defina o valor como o valor NextToken retornado da chamada de API anterior.

AAAAAdDWBF2

Tag

array<object>

Não

A lista de tags.

object

Não

A lista de tags.

Key

string

Não

A chave da tag do comando a ser executado. Valores válidos de N: 1 a 20. Se você especificar este parâmetro, ele não poderá ser uma string vazia.

Se você usar uma única tag para filtrar recursos, a contagem de recursos sob a tag não poderá exceder 1.000. Se você usar várias tags para filtrar recursos, a contagem de recursos que anexaram várias tags não poderá exceder 1.000. Se a contagem de recursos exceder 1.000, você deve chamar a operação ListTagResources para consultar os recursos.

A chave da tag pode ter até 64 caracteres. Não pode começar com aliyun ou acs: e 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. Este parâmetro 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

Invocation

object

A coleção de resultados da execução do comando.

InvocationResults

object

InvocationResult

array<object>

O conjunto de resultados da execução do comando.

array<object>

CommandId

string

O ID do comando.

c-hz0jdfwcsr****

ContainerId

string

O ID do contêiner.

ab141ddfbacfe02d9dbc25966ed971536124527097398d419a6746873fea****

ContainerName

string

O nome do contêiner.

test-container

Dropped

integer

O comprimento do texto que é truncado e descartado quando o comprimento do texto no campo Output excede 24 KB.

0

ErrorCode

string

O código de erro para a falha ao entregar ou executar o comando. Valores válidos:

  • Empty: O comando é executado normalmente.

  • InstanceNotExists: A instância especificada não existe ou foi liberada.

  • InstanceReleased: A instância foi liberada durante a execução simultânea.

  • InstanceNotRunning: A instância não estava em execução quando o comando foi executado.

  • CommandNotApplicable: O comando não é aplicável à instância especificada.

  • AccountNotExists: O nome de usuário especificado para executar o comando não existe.

  • DirectoryNotExists: O diretório especificado não existe.

  • BadCronExpression: A expressão cron especificada é inválida.

  • ClientNotRunning: O Agente do Cloud Assistant não está em execução.

  • ClientNotResponse: O Agente do Cloud Assistant não está respondendo.

  • ClientIsUpgrading: O Agente do Cloud Assistant está sendo atualizado.

  • ClientNeedUpgrade: O Agente do Cloud Assistant precisa ser atualizado.

  • DeliveryTimeout: A entrega do comando expirou.

  • ExecutionTimeout: A execução simultânea expirou.

  • ExecutionException: Ocorreu uma exceção durante a execução simultânea.

  • ExecutionInterrupted: A execução simultânea foi interrompida.

  • ExitCodeNonzero: A execução simultânea foi concluída, mas o código de saída não é 0.

  • SecurityGroupRuleDenied: As regras do grupo de segurança negaram acesso ao serviço Cloud Assistant.

  • TaskConcurrencyLimit: O número de tarefas executadas simultaneamente excede o limite máximo.

InstanceNotExists

ErrorInfo

string

Os detalhes sobre a falha ao entregar ou executar o comando. Valores válidos:

  • Empty: O comando é executado normalmente.

  • The security group rules denied access to the aliyun service: As regras do grupo de segurança negaram acesso ao serviço Cloud Assistant.

  • The specified instance does not exist: A instância especificada não existe ou foi liberada.

  • The specified instance was released during task execution: A instância foi liberada durante a execução do comando.

  • The specified instance was not running during task execution: A instância não estava em execução quando a execução do comando começou.

  • The OS type of the instance does not support the specified command type: O comando não é aplicável à instância especificada.

  • The specified account does not exist: A conta especificada não existe.

  • The specified directory does not exist: O diretório especificado não existe.

  • The cron expression is invalid: A expressão cron especificada é inválida.

  • The aliyun service is not running on the instance: O Agente do Cloud Assistant não está em execução.

  • The aliyun service in the instance does not response: O Agente do Cloud Assistant não está respondendo.

  • The aliyun service in the instance is upgrading during task execution: O Agente do Cloud Assistant está sendo atualizado.

  • The aliyun service in the instance need to be upgraded to at least version to support the feature: O Agente do Cloud Assistant precisa ser atualizado. é a versão mínima que suporta o recurso, e é o recurso específico.

  • The command delivery has been timeout: A entrega do comando expirou.

  • The command execution has been timeout: A execução do comando expirou.

  • The command execution got an exception: Ocorreu uma exceção durante a execução do comando.

  • The command execution exit code is not zero: A execução do comando foi concluída, mas o código de saída não é 0.

  • The specified instance was released during task execution: A instância foi liberada durante a entrega do arquivo.

the specified instance does not exists

ExitCode

integer

O código de saída do comando.

  • Para instâncias Linux, é o código de saída do comando shell.

  • Para instâncias Windows, é o código de saída do comando batch ou PowerShell.

0

FinishedTime

string

A hora em que a execução do comando foi concluída. Se a execução do comando expirar, a hora de conclusão é calculada adicionando o valor Timeout ao valor StartTime. A hora está no formato ISO 8601 e fuso horário UTC.

2019-12-20T06:15:56Z

InstanceId

string

O ID da instância.

i-bp1i7gg30r52z2em****

InvocationStatus

string

O status de execução do comando em uma única instância. Valores válidos:

  • Pending: O sistema está verificando ou enviando o comando.

  • Invalid: O tipo de comando ou parâmetro especificado é inválido.

  • Aborted: Falha ao enviar o comando para a instância. A instância deve estar em execução e o comando deve ser enviado dentro de 1 minuto.

  • Running: O comando está sendo executado na instância.

  • Success:
    • Execução única: O comando foi concluído e o código de saída é 0.

    • Execução agendada: A última execução foi bem-sucedida, o código de saída foi 0 e o tempo de execução especificado terminou.

  • Failed:
    • Execução única: O comando foi concluído, mas o código de saída não é 0.

    • Execução agendada: A última execução terminou com um código de saída diferente de zero, e a execução agendada será abortada.

  • Error: Ocorreu uma exceção durante a execução do comando e a execução não pode continuar.

  • Timeout: A execução do comando expirou.

  • Cancelled: A execução do comando foi cancelada antes de começar.

  • Stopping: A execução do comando está sendo interrompida.

  • Terminated: A execução do comando foi encerrada.

  • Scheduled:
    • Execução única: Não aplicável. Este status não aparece.

    • Execução agendada: Aguardando para ser executado.

Success

InvokeId

string

O ID de execução do comando.

t-hz0jdfwd9f****

InvokeRecordStatus

string

O status de execução do comando. Valores válidos:

  • Running: O comando está em execução.
    • Execução agendada: O status de execução permanece Running até que o comando agendado seja interrompido manualmente.

    • Execução única: O status geral de execução é Running desde que um processo de comando esteja em execução.

  • Finished: O comando foi concluído.
    • Execução agendada: O processo do comando não pode ser concluído.

    • Execução única: O comando é concluído em todas as instâncias, ou o processo do comando é interrompido manualmente em algumas instâncias e concluído nas instâncias restantes.

  • Failed: A execução falhou.
    • Execução agendada: O processo do comando não pode falhar.

    • Execução única: A execução falhou em todas as instâncias.

  • PartialFailed: A execução falhou parcialmente.
    • Execução agendada: O processo do comando não pode falhar parcialmente.

    • Execução única: O processo do comando falhou em algumas instâncias. O status geral de execução é PartialFailed.

  • Stopped: A execução do comando foi interrompida.

  • Stopping: A execução do comando está sendo interrompida.

Running

Launcher

string

O programa inicializador para a execução do script. O comprimento não pode exceder 1 KB.

python3 -u {{ACS::ScriptFileName|Ext(".py")}}

OssOutputDelivery

string

A configuração de envio de dados do OSS para a saída da execução do comando.

oss://testBucket/testPrefix

OssOutputErrorCode

string

O código de erro retornado quando a entrega falha. Este parâmetro é retornado apenas quando OssOutputStatus é Failed. Valores válidos:

  • CloudAssistant.UnsupportedInvocationStatus: O status do nó não suporta entrega.

  • CloudAssistant.ClientNeedUpgrade: A versão do Cloud Assistant não suporta entrega. A versão do Cloud Assistant deve ser posterior a 2.2.4.1007 para instâncias Linux e posterior a 2.1.4.1007 para instâncias Windows.

  • OSS.AccessDenied: Você não tem permissões de acesso no bucket em Settings.

  • OSS.NoSuchBucket: O bucket em Settings não existe.

  • OSS.FileImmutable: Os dados no bucket estão em status de proteção.

  • OSS.InvalidObjectName: O nome do objeto é inválido. Isso inclui casos em que o nome do objeto não é especificado, excede o limite de comprimento ou é inválido.

CloudAssistant.UnsupportedInvocationStatus

OssOutputErrorInfo

string

Os detalhes do erro retornados 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 da execução do comando. Valores válidos:

  • InProgress: A entrega está em andamento.

  • Finished: A entrega foi concluída.

  • Failed: A entrega falhou.

Finished

OssOutputUri

string

O URI do arquivo para o qual a saída da execução do comando é entregue no OSS. Este campo é uma string vazia quando a entrega falha ou está em andamento.

oss://testBucket/testPrefix/output.txt

Output

string

As informações de saída após a execução do comando.

  • Se ContentEncoding estiver definido como PlainText, as informações de saída originais serão retornadas.

  • Se ContentEncoding estiver definido como Base64, as informações de saída codificadas em Base64 serão retornadas.

MTU6MzA6MDEK

Repeats

integer

O número de vezes que o comando foi executado na instância.

  • Se o modo de execução for execução imediata, o valor é 0 ou 1.

  • Se o modo de execução for execução agendada, o valor é o número de vezes que o comando foi executado.

0

StartTime

string

A hora em que o comando começou a ser executado na instância. A hora está no formato ISO 8601 e fuso horário UTC.

2019-12-20T06:15:55Z

StopTime

string

A hora em que a operação StopInvocation foi chamada para interromper a execução do comando. A hora está no formato ISO 8601 e fuso horário UTC.

2020-01-19T09:15:47Z

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 manualmente ou interrompida devido ao tempo limite de execução. Valores válidos:

  • Process: Interrompe o processo de script atual.

  • ProcessTree: Interrompe a árvore de processos atual, que inclui o processo de script e todos os seus processos filhos.

ProcessTree

Username

string

O nome de usuário usado para executar o comando na instância ECS.

test

NextToken

string

O token de paginação retornado pela chamada atual.

AAAAAdDWBF2

PageNumber

integer

O número da página atual.

1

PageSize

integer

O número de linhas por página para paginação.

1

TotalCount

integer

O número total de comandos.

Nota

Ao usar os parâmetros MaxResults e NextToken para paginação, o valor do parâmetro TotalCount retornado não tem significado.

1

RequestId

string

O ID da solicitação.

473469C7-AA6F-4DC5-B3DB-A3DC0DE*****

Exemplos

Resposta de sucesso

JSON formato

{
  "Invocation": {
    "InvocationResults": {
      "InvocationResult": [
        {
          "CommandId": "c-hz0jdfwcsr****",
          "ContainerId": "ab141ddfbacfe02d9dbc25966ed971536124527097398d419a6746873fea****",
          "ContainerName": "test-container",
          "Dropped": 0,
          "ErrorCode": "InstanceNotExists",
          "ErrorInfo": "the specified instance does not exists",
          "ExitCode": 0,
          "FinishedTime": "2019-12-20T06:15:56Z",
          "InstanceId": "i-bp1i7gg30r52z2em****",
          "InvocationStatus": "Success",
          "InvokeId": "t-hz0jdfwd9f****",
          "InvokeRecordStatus": "Running",
          "Launcher": "python3 -u {{ACS::ScriptFileName|Ext(\".py\")}}",
          "OssOutputDelivery": "oss://testBucket/testPrefix",
          "OssOutputErrorCode": "CloudAssistant.UnsupportedInvocationStatus",
          "OssOutputErrorInfo": "The invocation status does not support output delivery.",
          "OssOutputStatus": "Finished",
          "OssOutputUri": "oss://testBucket/testPrefix/output.txt",
          "Output": "MTU6MzA6MDEK",
          "Repeats": 0,
          "StartTime": "2019-12-20T06:15:55Z",
          "StopTime": "2020-01-19T09:15:47Z",
          "Tags": {
            "Tag": [
              {
                "TagKey": "owner",
                "TagValue": "zhangsan"
              }
            ]
          },
          "TerminationMode": "ProcessTree",
          "Username": "test"
        }
      ]
    },
    "NextToken": "AAAAAdDWBF2",
    "PageNumber": 1,
    "PageSize": 1,
    "TotalCount": 1
  },
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE*****"
}

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 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. Esta operação suporta no máximo 20 tags.
400 Duplicate.TagKey The Tag.N.Key contain duplicate key. Existem chaves duplicadas nas tags. Certifique-se de que as chaves sejam exclusivas.
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 está incorreto.
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.
500 ServiceUnavailable The request has failed due to a temporary failure of the server.
500 InternalError The request processing has failed due to some unknown error.
403 InvalidParameterCharacter The specified parameter %s contains illegal characters.
403 Operation.Forbidden The operation is not permitted. A operação não é permitida.
403 RequestDenied.WAFIntercepted Request denied by WAF security protection. A solicitação foi bloqueada pela proteção de segurança do Web Application Firewall (WAF).
404 InvalidRegionId.NotFound The RegionId provided does not exist in our records. O RegionId especificado não existe. Verifique se o serviço está disponível na 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.