DescribeInvocationResults - : Central de Documentação do Alibaba Cloud

Notas de uso

Após executar um comando, ele pode não ter sido bem-sucedido ou pode retornar resultados inesperados. Chame esta operação para consultar os resultados reais de execução.
É possível consultar informações sobre tarefas de comandos das últimas quatro semanas. Até 100.000 registros de tarefas podem ser retidos.

Depuração

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

Parâmetros de solicitação

Parâmetro	Tipo	Obrigatório	Exemplo	Descrição
Action	String	Yes	DescribeInvocationResults	A operação que você deseja executar. Defina o valor como DescribeInvocationResults.
RegionId	String	Yes	cn-hangzhou	O ID da região do comando. Chame a operação DescribeRegions para consultar a lista de regiões mais recente.
ResourceGroupId	String	No	rg-bp67acfmxazb4p****	O ID do grupo de recursos. Ao definir este parâmetro, a consulta retorna os resultados de execução de comandos do grupo de recursos especificado.
InvokeId	String	No	t-hz0jdfwd9f****	O ID da tarefa de comando. Chame a operação DescribeInvocations para consultar os IDs de todas as tarefas de comandos.
InstanceId	String	No	i-bp1i7gg30r52z2em****	O ID da instância.
CommandId	String	No	c-hz0jdfwcsr****	O ID do comando.
InvokeRecordStatus	String	No	Running	O estado de execução da tarefa de comando. Valores válidos: Running Tarefa agendada: antes de você parar manualmente a tarefa agendada, o estado geral de execução é sempre Running. Tarefa única: se o comando está sendo executado nas instâncias, o estado geral de execução é Running. Finished: Tarefa agendada: o estado geral de execução não pode ser Finished. Tarefa única: a execução foi concluída em todas as instâncias, ou foi parada manualmente em algumas instâncias e concluída nas demais. Success: Tarefa única: a execução foi concluída e o código de saída é 0. Tarefa agendada: a última execução foi bem-sucedida, o código de saída é 0 e o ciclo especificado terminou. Failed: Tarefa agendada: o estado geral de execução não pode ser Failed. Tarefa única: a execução falhou em todas as instâncias. PartialFailed: Tarefa agendada: o estado geral de execução não pode ser PartialFailed. Tarefa única: a execução falhou em algumas instâncias. Stopped: a tarefa foi parada. Stopping: a tarefa está sendo parada.
IncludeHistory	Boolean	No	false	Indica se a resposta deve incluir os resultados de execuções agendadas históricas. Valores válidos: true: retorna os resultados de execuções agendadas históricas. Ao definir este parâmetro como true, defina InvokeId como o ID de uma tarefa executada por agendamento (RepeatMode definido como Period) ou a cada inicialização do sistema (RepeatMode definido como EveryReboot). false: não retorna os resultados de execuções agendadas históricas. Valor padrão: false.
ContentEncoding	String	No	PlainText	O modo de codificação dos valores de `CommandContent` e `Output` na resposta. Valores válidos: PlainText: retorna o conteúdo original do comando e as saídas do comando. Base64: retorna o conteúdo do comando e as saídas do comando codificados em Base64. Valor padrão: Base64.
PageNumber	Long	No	1	O número da página. As páginas começam a partir da página 1. Valor padrão: 1.
PageSize	Long	No	1	O número de entradas por página. Valores válidos: 1 a 50. Valor padrão: 10.
Tag.N.Key	String	No	TestKey	A chave da tag N da tarefa de comando. Valores válidos de N: 1 a 20. A chave da tag não pode ser uma string vazia. Ao especificar uma única tag para consultar recursos, até 1.000 recursos com essa tag podem ser exibidos na resposta. Ao especificar múltiplas tags, até 1.000 recursos com todas as tags especificadas podem ser exibidos na resposta. Para consultar mais de 1.000 recursos com tags específicas, chame a operação ListTagResources. A chave da tag pode ter até 128 caracteres e não pode conter `http://` ou `https://`. A chave da tag não pode começar com `acs:` ou `aliyun`.
Tag.N.Value	String	No	TestValue	O valor da tag N da tarefa de 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://`.

Parâmetros de resposta

Parâmetro	Tipo	Exemplo	Descrição
RequestId	String	473469C7-AA6F-4DC5-B3DB-A3DC0DE*****	O ID da solicitação.
Invocation	Object		Detalhes sobre os resultados de execução.
PageSize	Long	1	O número de entradas por página.
PageNumber	Long	1	O número da página.
TotalCount	Long	1	O número total de comandos.
InvocationResults	Array of InvocationResult		Os resultados de execução.
InvocationResult
InvocationStatus	String	Success	O estado de execução em uma única instância. Valores válidos: Pending: o comando estava sendo verificado ou enviado. Invalid: o tipo de comando ou parâmetro especificado era inválido. Aborted: o envio do comando falhou. Para enviar um comando a uma instância, certifique-se de que a instância esteja no estado Running e que o comando possa ser enviado em até 1 minuto. Running: o comando estava sendo executado nas instâncias. Success: Tarefa única: a execução foi concluída e o código de saída era 0. Tarefa agendada: a última execução foi bem-sucedida, o código de saída era 0 e o ciclo especificado terminou. Failed: Tarefa única: a execução foi concluída, mas o código de saída não era 0. Tarefa agendada: a última execução foi bem-sucedida, o código de saída não era 0 e o ciclo especificado estava prestes a terminar. Error: a execução não pode prosseguir devido a uma exceção. Timeout: a execução expirou. Cancelled: a execução foi cancelada e o comando não foi executado. Stopping: a tarefa de comando no estado Running estava sendo parada. Terminated: a execução foi encerrada enquanto o comando estava sendo executado. Scheduled: Tarefa única: o estado de execução nunca pode ser Scheduled. Tarefa agendada: o comando está aguardando execução.
Repeats	Integer	0	O número de vezes que o comando foi executado na instância. Se o comando estiver configurado para ser executado apenas uma vez, o valor é 0 ou 1. Se o comando estiver configurado para execução agendada, o valor é o número de vezes que o comando foi executado.
CommandId	String	c-hz0jdfwcsr****	O ID do comando.
InstanceId	String	i-bp1i7gg30r52z2em****	O ID da instância.
Output	String	MTU6MzA6MDEK	A saída do comando. Se ContentEncoding estiver definido como PlainText na solicitação, a saída original do comando é retornada. Se ContentEncoding estiver definido como Base64 na solicitação, a saída do comando codificada em Base64 é retornada.
Dropped	Integer	0	O tamanho do texto de Output truncado e descartado quando o valor de `Output` excede 24 KB.
StopTime	String	2020-01-19T09:15:47Z	O horário em que a tarefa de comando foi parada. Ao chamar a operação `StopInvocation` para parar a tarefa de comando, o valor deste parâmetro é o horário em que a operação foi chamada.
ExitCode	Long	0	O código de saída da tarefa de comando. Para instâncias Linux, o código de saída é o código de saída do processo shell. Para instâncias Windows, o código de saída é o código de saída do processo batch ou PowerShell.
StartTime	String	2019-12-20T06:15:55Z	O horário em que o comando começou a ser executado na instância.
ErrorInfo	String	the specified instance does not exists	O motivo pelo qual o envio ou a execução do comando falhou. Valores válidos: Se este parâmetro estiver vazio, o comando foi executado normalmente. the specified instance does not exist the instance has released when create task the instance is not running when create task the command is not applicable the specified account does not exist the specified directory does not exist the cron job expression is invalid the aliyun service is not running on the instance the aliyun service in the instance does not response the aliyun service in the instance is upgrading now the aliyun service in the instance need upgrade the command delivery has been timeout the command execution has been timeout the command execution got an exception the command execution has been interrupted the command execution exit code is not zero the specified instance has been released
ErrorCode	String	InstanceNotExists	O código de erro retornado quando o envio ou a execução do comando falhou. Valores válidos: Se este parâmetro estiver vazio, o comando foi executado normalmente. InstanceNotExists: a instância não existia ou foi liberada. InstanceReleased: a instância foi liberada enquanto o comando estava sendo executado. InstanceNotRunning: a instância não estava em execução enquanto o comando estava sendo executado. CommandNotApplicable: o comando não era aplicável à instância especificada. AccountNotExists: a conta especificada não existia. DirectoryNotExists: o diretório especificado não existia. BadCronExpression: a expressão cron utilizada para especificar um agendamento era inválida. ClientNotRunning: o Cloud Assistant Agent não estava em execução. ClientNotResponse: o Cloud Assistant Agent não respondeu. ClientIsUpgrading: o Cloud Assistant Agent estava sendo atualizado. ClientNeedUpgrade: o Cloud Assistant Agent precisa ser atualizado. DeliveryTimeout: a solicitação de envio do comando expirou. ExecutionTimeout: a execução expirou. ExecutionException: ocorreu uma exceção durante a execução do comando. ExecutionInterrupted: a tarefa de comando foi interrompida. ExitCodeNonzero: a tarefa de comando foi concluída, mas o código de saída não era 0.
FinishedTime	String	2019-12-20T06:15:56Z	O horário de conclusão da tarefa de comando. Se a tarefa de comando expirar, o horário de término é igual ao horário de início da tarefa especificado por `StartTime` mais o período de timeout especificado por `Timeout`.
InvokeId	String	t-hz0jdfwd9f****	O ID da tarefa de comando.
InvokeRecordStatus	String	Running	O estado de execução da tarefa de comando. Valores válidos: Running: Tarefa agendada: antes de você parar manualmente a tarefa agendada, o estado geral de execução é sempre Running. Tarefa única: se o comando está sendo executado nas instâncias, o estado geral de execução é Running. Finished: Tarefa agendada: o estado geral de execução não pode ser Finished. Tarefa única: a execução foi concluída em todas as instâncias, ou foi parada manualmente em algumas instâncias e concluída nas demais. Failed: Tarefa agendada: o estado geral de execução não pode ser Failed. Tarefa única: a execução falhou em todas as instâncias. PartialFailed: Tarefa agendada: o estado geral de execução não pode ser PartialFailed. Tarefa única: a execução falhou em algumas instâncias. Stopped: a tarefa foi parada. Stopping: a tarefa estava sendo parada.
Username	String	test	O nome de usuário utilizado para executar o comando na instância.
ContainerId	String	ab141ddfbacfe02d9dbc25966ed971536124527097398d419a6746873fea****	O ID do container.
ContainerName	String	test-container	O nome do container.
Tags	Array of Tag		As tags da tarefa de comando.
Tag
TagKey	String	owner	A chave da tag da tarefa de comando.
TagValue	String	zhangsan	O valor da tag da tarefa de comando.

Exemplos

Exemplos de solicitação

http(s)://ecs.aliyuncs.com/?Action=DescribeInvocationResults
&RegionId=cn-hangzhou
&InstanceId=i-bp1i7gg30r52z2em****
&PageNumber=1
&PageSize=1
&<Common request parameters>

Exemplos de respostas de sucesso

Formato XML

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

<DescribeInvocationResultsResponse>
    <RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE*****</RequestId>
    <Invocation>
        <InvocationResults>
            <InvocationResult>
                <Dropped>0</Dropped>
                <InvocationStatus>Success</InvocationStatus>
                <InstanceId>i-bp1i7gg30r52z2em****</InstanceId>
                <ExitCode>0</ExitCode>
                <ErrorInfo>the specified instance does not exists</ErrorInfo>
                <StartTime>2019-12-20T06:15:55Z</StartTime>
                <Repeats>0</Repeats>
                <InvokeRecordStatus>Running</InvokeRecordStatus>
                <FinishedTime>2019-12-20T06:15:56Z</FinishedTime>
                <Output>MTU6MzA6MDEK</Output>
                <CommandId>c-hz0jdfwcsr****</CommandId>
                <ErrorCode>InstanceNotExists</ErrorCode>
                <InvokeId>t-hz0jdfwd9f****</InvokeId>
                <StopTime>2020-01-19T09:15:47Z</StopTime>
                <Username>test</Username>
                <ContainerId>ab141ddfbacfe02d9dbc25966ed971536124527097398d419a6746873fea****</ContainerId>
                <ContainerName>test-container</ContainerName>
                <Tags>
                    <TagKey>owner</TagKey>
                    <TagValue>zhangsan</TagValue>
                </Tags>
            </InvocationResult>
        </InvocationResults>
        <TotalCount>1</TotalCount>
        <PageSize>1</PageSize>
        <PageNumber>1</PageNumber>
    </Invocation>
</DescribeInvocationResultsResponse>

Formato JSON

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

{
  "RequestId" : "473469C7-AA6F-4DC5-B3DB-A3DC0DE*****",
  "Invocation" : {
    "InvocationResults" : {
      "InvocationResult" : [ {
        "Dropped" : 0,
        "InvocationStatus" : "Success",
        "InstanceId" : "i-bp1i7gg30r52z2em****",
        "ExitCode" : 0,
        "ErrorInfo" : "the specified instance does not exists",
        "StartTime" : "2019-12-20T06:15:55Z",
        "Repeats" : 0,
        "InvokeRecordStatus" : "Running",
        "FinishedTime" : "2019-12-20T06:15:56Z",
        "Output" : "MTU6MzA6MDEK",
        "CommandId" : "c-hz0jdfwcsr****",
        "ErrorCode" : "InstanceNotExists",
        "InvokeId" : "t-hz0jdfwd9f****",
        "StopTime" : "2020-01-19T09:15:47Z",
        "Username" : "test",
        "ContainerId" : "ab141ddfbacfe02d9dbc25966ed971536124527097398d419a6746873fea****",
        "ContainerName" : "test-container",
        "Tags" : [ {
          "TagKey" : "owner",
          "TagValue" : "zhangsan"
        } ]
      } ]
    },
    "TotalCount" : 1,
    "PageSize" : 1,
    "PageNumber" : 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.	Esta operação não pode ser executada na região especificada. Verifique se o valor do parâmetro RegionId é válido.
400	Duplicate.TagKey	The Tag.N.Key contain duplicate key.	A chave da tag já existe. As chaves das tags devem ser exclusivas.
400	InvalidTagKey.Malformed	The specified Tag.n.Key is not valid.	Valor de Tag.N.Key inválido.
400	InvalidTagValue.Malformed	The specified Tag.n.Value is not valid.	Valor de Tag.N.Value inválido.
400	MissingParameter.TagKey	You must specify Tag.N.Key.	Tag.N.Key é obrigatório.
400	InvalidParam.PageNumber	The specified parameter is invalid.	Valor de PageNumber inválido.
400	InvalidParam.PageSize	The specified parameter is invalid.	Valor de PageSize inválido.
403	Operation.Forbidden	The operation is not permitted.	A operação não é permitida.
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.	A solicitação falhou devido a uma falha temporária do servidor de backend.
500	InternalError	The request processing has failed due to some unknown error.	Ocorreu um erro interno. Tente novamente mais tarde.

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