DescribeInvocationResults - - Centro de documentación de Alibaba Cloud

Consulta los resultados de ejecución de comandos de Cloud Assistant en instancias de Elastic Compute Service (ECS).

Notas de uso

Después de ejecutar un comando, es posible que la operación no se complete correctamente o que devuelva resultados inesperados. Llame a esta operación para consultar los resultados reales de la ejecución.
Puede consultar la información de las tareas de comando de las últimas cuatro semanas. Se conserva un máximo de 100,000 registros de tareas.

Depuración

OpenAPI Explorer calcula automáticamente el valor de la firma. Para su comodidad, le recomendamos llamar a esta operación en OpenAPI Explorer. OpenAPI Explorer genera dinámicamente el código de ejemplo de la operación para diferentes SDK.

Parámetros de solicitud

Parámetro	Tipo	Obligatorio	Ejemplo	Descripción
Action	String	Sí	DescribeInvocationResults	La operación que desea realizar. Establezca el valor en DescribeInvocationResults.
RegionId	String	Sí	cn-hangzhou	El ID de región del comando. Puede llamar a la operación DescribeRegions para consultar la lista de regiones más reciente.
ResourceGroupId	String	No	rg-bp67acfmxazb4p****	El ID del resource group. Al establecer este parámetro, se consultan los resultados de ejecución de comandos en el resource group especificado.
InvokeId	String	No	t-hz0jdfwd9f****	El ID de la tarea de comando. Puede llamar a la operación DescribeInvocations para consultar los ID de todas las tareas de comando.
InstanceId	String	No	i-bp1i7gg30r52z2em****	El ID de la instancia.
CommandId	String	No	c-hz0jdfwcsr****	El ID del comando.
InvokeRecordStatus	String	No	Running	El estado de ejecución de la tarea de comando. Valores válidos: Running Tarea programada: Antes de detener manualmente la tarea programada, el estado general de ejecución siempre es Running. Tarea única: Si el comando se está ejecutando en las instancias, el estado general de ejecución es Running. Finished: Tarea programada: El estado general de ejecución no puede ser Finished. Tarea única: La ejecución se completó en todas las instancias, o bien se detuvo manualmente en algunas instancias y se completó en otras. Success: Tarea única: La ejecución se completó y el código de salida es 0. Tarea programada: La última ejecución fue exitosa, el código de salida es 0 y el ciclo especificado finalizó. Failed: Tarea programada: El estado general de ejecución no puede ser Failed. Tarea única: La ejecución falló en todas las instancias. PartialFailed: Tarea programada: El estado general de ejecución no puede ser PartialFailed. Tarea única: La ejecución falló en algunas instancias. Stopped: La tarea está detenida. Stopping: La tarea se está deteniendo.
IncludeHistory	Boolean	No	false	Especifica si se deben devolver los resultados de ejecuciones programadas históricas. Valores válidos: true: Devuelve los resultados de ejecuciones programadas históricas. Si establece este parámetro en true, debe configurar InvokeId con el ID de una tarea que se ejecute según una programación (RepeatMode establecido en Period) o en cada inicio del sistema (RepeatMode establecido en EveryReboot). false: No devuelve los resultados de ejecuciones programadas históricas. Valor predeterminado: false.
ContentEncoding	String	No	PlainText	El modo de codificación de los valores `CommandContent` y `Output` en la respuesta. Valores válidos: PlainText: Devuelve el contenido original del comando y sus salidas. Base64: Devuelve el contenido del comando y sus salidas codificados en Base64. Valor predeterminado: Base64.
PageNumber	Long	No	1	El número de página. Las páginas comienzan desde la página 1. Valor predeterminado: 1.
PageSize	Long	No	1	El número de entradas por página. Valores válidos: 1 a 50. Valor predeterminado: 10.
Tag.N.Key	String	No	TestKey	La clave de la etiqueta N de la tarea de comando. Valores válidos de N: 1 a 20. La clave de la etiqueta no puede ser una cadena vacía. Si se especifica una sola etiqueta para consultar recursos, la respuesta puede mostrar hasta 1,000 recursos que tengan esta etiqueta asignada. Si se especifican varias etiquetas para consultar recursos, la respuesta puede mostrar hasta 1,000 recursos que tengan todas estas etiquetas asignadas. Para consultar más de 1,000 recursos con etiquetas específicas, llame a la operación ListTagResources. La clave de la etiqueta puede tener una longitud máxima de 128 caracteres y no puede contener `http://` ni `https://`. La clave de la etiqueta no puede comenzar con `acs:` ni `aliyun`.
Tag.N.Value	String	No	TestValue	El valor de la etiqueta N de la tarea de comando. Valores válidos de N: 1 a 20. El valor de la etiqueta puede ser una cadena vacía. El valor de la etiqueta puede tener una longitud máxima de 128 caracteres y no puede contener `http://` ni `https://`.

Parámetros de respuesta

Parámetro	Tipo	Ejemplo	Descripción
RequestId	String	473469C7-AA6F-4DC5-B3DB-A3DC0DE*****	El ID de la solicitud.
Invocation	Object		Detalles sobre los resultados de la ejecución.
PageSize	Long	1	El número de entradas por página.
PageNumber	Long	1	El número de página.
TotalCount	Long	1	El número total de comandos.
InvocationResults	Array of InvocationResult		Los resultados de la ejecución.
InvocationResult
InvocationStatus	String	Success	El estado de ejecución en una sola instancia. Valores válidos: Pending: El comando se estaba verificando o enviando. Invalid: El tipo de comando o el parámetro especificado no era válido. Aborted: No se pudo enviar el comando. Para enviar un comando a una instancia, asegúrese de que la instancia esté en estado Running y de que el comando pueda enviarse dentro de 1 minuto. Running: El comando se estaba ejecutando en las instancias. Success: Tarea única: La ejecución se completó y el código de salida fue 0. Tarea programada: La última ejecución fue exitosa, el código de salida fue 0 y el ciclo especificado finalizó. Failed: Tarea única: La ejecución se completó, pero el código de salida no fue 0. Tarea programada: La última ejecución fue exitosa, el código de salida no fue 0 y el ciclo especificado estaba por finalizar. Error: La ejecución no pudo continuar debido a una excepción. Timeout: La ejecución excedió el tiempo de espera. Cancelled: La ejecución se canceló y el comando no se ejecutó. Stopping: La tarea de comando en estado Running se estaba deteniendo. Terminated: La ejecución se interrumpió mientras el comando se estaba ejecutando. Scheduled: Tarea única: El estado de ejecución nunca puede ser Scheduled. Tarea programada: El comando está en espera de ejecución.
Repeats	Integer	0	El número de veces que se ejecutó el comando en la instancia. Si el comando está configurado para ejecutarse solo una vez, el valor es 0 o 1. Si el comando está configurado para ejecutarse según una programación, el valor corresponde al número de veces que se ejecutó el comando.
CommandId	String	c-hz0jdfwcsr****	El ID del comando.
InstanceId	String	i-bp1i7gg30r52z2em****	El ID de la instancia.
Output	String	MTU6MzA6MDEK	La salida del comando. Si ContentEncoding se estableció en PlainText en la solicitud, se devuelve la salida original del comando. Si ContentEncoding se estableció en Base64 en la solicitud, se devuelve la salida del comando codificada en Base64.
Dropped	Integer	0	El tamaño del texto de Output que se trunca y descarta cuando el valor de `Output` supera los 24 KB.
StopTime	String	2020-01-19T09:15:47Z	La hora en que se detuvo la tarea de comando. Si llama a la operación `StopInvocation` para detener la tarea de comando, el valor de este parámetro es la hora en que se realiza la llamada.
ExitCode	Long	0	El código de salida de la tarea de comando. Para instancias Linux, el código de salida corresponde al proceso shell. Para instancias Windows, el código de salida corresponde al proceso por lotes o de PowerShell.
StartTime	String	2019-12-20T06:15:55Z	La hora en que el comando comenzó a ejecutarse en la instancia.
ErrorInfo	String	the specified instance does not exists	El motivo por el cual no se pudo enviar o ejecutar el comando. Valores válidos: Si este parámetro se deja vacío, el comando se ejecuta 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	El código de error devuelto cuando no se pudo enviar o ejecutar el comando. Valores válidos: Si este parámetro se deja vacío, el comando se ejecuta normalmente. InstanceNotExists: La instancia no existía o fue liberada. InstanceReleased: La instancia se liberó mientras el comando se estaba ejecutando. InstanceNotRunning: La instancia no se estaba ejecutando mientras el comando se estaba ejecutando. CommandNotApplicable: El comando no era aplicable a la instancia especificada. AccountNotExists: La cuenta especificada no existía. DirectoryNotExists: El directorio especificado no existía. BadCronExpression: La expresión cron utilizada para especificar la programación no era válida. ClientNotRunning: Cloud Assistant Agent no se estaba ejecutando. ClientNotResponse: Cloud Assistant Agent no respondió. ClientIsUpgrading: Cloud Assistant Agent se estaba actualizando. ClientNeedUpgrade: Es necesario actualizar Cloud Assistant Agent. DeliveryTimeout: La solicitud para enviar el comando excedió el tiempo de espera. ExecutionTimeout: La ejecución excedió el tiempo de espera. ExecutionException: Ocurrió una excepción mientras el comando se estaba ejecutando. ExecutionInterrupted: La tarea de comando se interrumpió. ExitCodeNonzero: La tarea de comando se completó, pero el código de salida no fue 0.
FinishedTime	String	2019-12-20T06:15:56Z	La hora de finalización de la tarea de comando. Si la tarea de comando excede el tiempo de espera, la hora de finalización es igual a la hora de inicio de la tarea de comando especificada por `StartTime` más el período de tiempo de espera especificado por `Timeout`.
InvokeId	String	t-hz0jdfwd9f****	El ID de la tarea de comando.
InvokeRecordStatus	String	Running	El estado de ejecución de la tarea de comando. Valores válidos: Running: Tarea programada: Antes de detener manualmente la tarea programada, el estado general de ejecución siempre es Running. Tarea única: Si el comando se está ejecutando en las instancias, el estado general de ejecución es Running. Finished: Tarea programada: El estado general de ejecución no podía ser Finished. Tarea única: La ejecución se completó en todas las instancias, o bien se detuvo manualmente en algunas instancias y se completó en otras. Failed: Tarea programada: El estado general de ejecución no podía ser Failed. Ejecución única: La ejecución falló en todas las instancias. PartialFailed: Tarea programada: El estado general de ejecución no podía ser PartialFailed. Tarea única: La ejecución falló en algunas instancias. Stopped: La tarea estaba detenida. Stopping: La tarea se estaba deteniendo.
Username	String	test	El nombre de usuario que se utilizó para ejecutar el comando en la instancia.
ContainerId	String	ab141ddfbacfe02d9dbc25966ed971536124527097398d419a6746873fea****	El ID del contenedor.
ContainerName	String	test-container	El nombre del contenedor.
Tags	Array of Tag		Las etiquetas de la tarea de comando.
Tag
TagKey	String	owner	La clave de la etiqueta de la tarea de comando.
TagValue	String	zhangsan	El valor de la etiqueta de la tarea de comando.

Ejemplos

Solicitudes de ejemplo

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

Respuestas exitosas de ejemplo

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 error

Código de estado HTTP	Código de error	Mensaje de error	Descripción
400	RegionId.ApiNotSupported	The api is not supported in this region.	Esta operación no se puede realizar en la región especificada. Compruebe si el valor del parámetro RegionId es válido.
400	Duplicate.TagKey	The Tag.N.Key contain duplicate key.	La clave de la etiqueta ya existe. Las claves de etiqueta deben ser únicas.
400	InvalidTagKey.Malformed	The specified Tag.n.Key is not valid.	Valor de Tag.N.Key no válido.
400	InvalidTagValue.Malformed	The specified Tag.n.Value is not valid.	Valor de Tag.N.Value no válido.
400	MissingParameter.TagKey	You must specify Tag.N.Key.	Tag.N.Key es obligatorio.
400	InvalidParam.PageNumber	The specified parameter is invalid.	Valor de PageNumber no válido.
400	InvalidParam.PageSize	The specified parameter is invalid.	Valor de PageSize no válido.
403	Operation.Forbidden	The operation is not permitted.	La operación no es compatible.
500	InternalError.Dispatch	An error occurred when you dispatched the request.	Ocurrió un error al enviar la solicitud. Inténtelo de nuevo más tarde.
500	ServiceUnavailable	The request has failed due to a temporary failure of the server.	La solicitud falló debido a un error temporal del servidor backend.
500	InternalError	The request processing has failed due to some unknown error.	Ocurrió un error interno. Inténtelo de nuevo más tarde.

Para obtener una lista de códigos de error, consulte Códigos de error del servicio.