Consulta los resultados de ejecución de uno o más comandos de Cloud Assistant, que corresponden a los resultados reales de ejecución en las instancias de ECS.
Descripción de la operación
Descripción de la operación
-
Después de ejecutar un comando, no se garantiza que tenga éxito o produzca los resultados esperados. Llame a esta operación para ver los resultados de ejecución reales basados en la salida real.
-
Puede consultar la información de ejecución de los últimos 30 días. Se puede retener un máximo de 10,000 entradas de información de ejecución.
-
Puede usar la suscripción a eventos de estado de tareas de Cloud Assistant para obtener los resultados de las tareas a través de eventos, lo que evita el sondeo frecuente y mejora la eficiencia.
-
Al consultar la primera página de forma paginada, configure solo
MaxResultspara limitar el número de entradas a devolver. El valorNextTokenen la respuesta se utiliza como credencial para consultar las páginas siguientes. Al consultar las páginas siguientes de forma paginada, configureNextTokencon el valorNextTokenobtenido de la respuesta anterior y configureMaxResultspara limitar el número de entradas a devolver. -
Diferencias entre
DescribeInvocationsyDescribeInvocationResults:- Cuando una sola llamada a
RunCommand/InvokeCommandespecifica varias instancias:DescribeInvocationsdevuelve el estado de ejecución en cada instancia y el estado agregado en varias instancias.DescribeInvocationResultsdevuelve solo el estado de ejecución individual en cada instancia, sin el estado agregado en varias instancias.
- Cuando una sola llamada a
RunCommand/InvokeCommandespecifica una instancia:DescribeInvocationsyDescribeInvocationResultsson en gran medida intercambiables.
Cuando necesita ver el historial de ejecución de tareas programadas (periódicas) o tareas que se ejecutan en cada inicio del sistema (
RepeatMode=Period, EveryReboot), soloDescribeInvocationResultspuede devolver los registros de ejecución históricos (debe especificarIncludeHistory=true).DescribeInvocationsdevuelve solo el estado más reciente de la tarea.Cuando necesita ver el contenido o los parámetros del comando, solo
DescribeInvocationsdevuelveCommandContent.
- Cuando una sola llamada a
Pruébelo ahora
Test
Autorización de RAM
|
Action |
Nivel de acceso |
Tipo de recurso |
Clave de condición |
Acción dependiente |
|
ecs:DescribeInvocationResults |
get |
Command.
Instance.
|
Ninguna | Ninguna |
Parámetros de la solicitud
|
Parámetro |
Tipo |
Obligatorio |
Descripción |
Ejemplo |
| RegionId |
string |
Sí |
El ID de la región. Puede llamar a DescribeRegions para consultar la lista de regiones más reciente. |
cn-hangzhou |
| ResourceGroupId |
string |
No |
El ID del grupo de recursos de la ejecución del comando. Después de especificar este parámetro, también debe especificar el ID del grupo de recursos al ejecutar el comando. Este parámetro se utiliza para filtrar los resultados de ejecución correspondientes a dicho comando. |
rg-bp67acfmxazb4p**** |
| InvokeId |
string |
No |
El ID de ejecución del comando. Puede llamar a DescribeInvocations para consultar el InvokeId. |
t-hz0jdfwd9f**** |
| InstanceId |
string |
No |
El ID de la instancia. |
i-bp1i7gg30r52z2em**** |
| CommandId |
string |
No |
El ID del comando. |
c-hz0jdfwcsr**** |
| InvokeRecordStatus |
string |
No |
El estado de ejecución del comando. Valores válidos:
|
Running |
| IncludeHistory |
boolean |
No |
Especifica si se deben devolver los registros del historial de ejecuciones de comandos programados. Valores válidos:
Valor predeterminado: false. |
false |
| ContentEncoding |
string |
No |
El tipo de codificación de los campos CommandContent y Output en la respuesta. Valores válidos:
Valor predeterminado: Base64. |
PlainText |
| PageNumber |
integer |
No |
Nota
Este parámetro está a punto de quedar obsoleto. Use NextToken y MaxResults para las consultas paginadas. |
1 |
| PageSize |
integer |
No |
Nota
Este parámetro está a punto de quedar obsoleto. Use NextToken y MaxResults para las consultas paginadas. |
1 |
| MaxResults |
integer |
No |
El número máximo de entradas por página para consultas paginadas. Valor máximo: 50. Valor predeterminado: 10. |
10 |
| NextToken |
string |
No |
El token de paginación. Configure este parámetro con el valor NextToken devuelto en la llamada a la API anterior. |
AAAAAdDWBF2 |
| Tag |
array<object> |
No |
Las etiquetas. |
|
|
object |
No |
Las etiquetas. |
||
| Key |
string |
No |
La clave de etiqueta de la ejecución del comando. Valores válidos de N: 1 a 20. La clave de etiqueta no puede ser una cadena vacía. Si usa una sola etiqueta para filtrar recursos, el número de recursos con esta etiqueta no puede exceder los 1,000. Si usa varias etiquetas para filtrar recursos, el número de recursos que tienen todas las etiquetas especificadas no puede exceder los 1,000. Si el recuento de recursos excede los 1,000, llame a ListTagResources para consultar los recursos. La clave de etiqueta puede tener hasta 64 caracteres de longitud y no puede comenzar con aliyun ni acs:. No puede contener http:// ni https://. |
ClaveDePrueba |
| Value |
string |
No |
El valor de etiqueta de la ejecución del comando. Valores válidos de N: 1 a 20. El valor de etiqueta puede ser una cadena vacía. El valor de etiqueta puede tener hasta 128 caracteres de longitud y no puede contener http:// ni https://. |
ValorDePrueba |
Elementos de la respuesta
|
Elemento |
Tipo |
Descripción |
Ejemplo |
|
object |
|||
| Invocation |
object |
La colección de resultados de ejecución de comandos. |
|
| InvocationResults |
object |
||
| InvocationResult |
array<object> |
El conjunto de resultados de ejecución del comando. |
|
|
array<object> |
|||
| CommandId |
string |
El ID del comando. |
c-hz0jdfwcsr**** |
| ContainerId |
string |
El ID del contenedor. |
ab141ddfbacfe02d9dbc25966ed971536124527097398d419a6746873fea**** |
| ContainerName |
string |
El nombre del contenedor. |
test-container |
| Dropped |
integer |
El tamaño del texto que se truncó y descartó cuando el campo |
0 |
| ErrorCode |
string |
El código de error para una falla en la entrega o ejecución del comando. Valores válidos:
|
InstanceNotExists |
| ErrorInfo |
string |
El motivo detallado de la falla en la entrega o ejecución del comando. Valores válidos:
|
the specified instance does not exists |
| ExitCode |
integer |
El código de salida del comando.
|
0 |
| FinishedTime |
string |
La hora en que se completó la ejecución del comando. Si la ejecución del comando agota el tiempo de espera, la hora de finalización se calcula como |
2019-12-20T06:15:56Z |
| InstanceId |
string |
El ID de la instancia. |
i-bp1i7gg30r52z2em**** |
| InvocationStatus |
string |
El estado de ejecución del comando en una sola instancia. Valores válidos:
|
Success |
| InvokeId |
string |
El ID de ejecución del comando. |
t-hz0jdfwd9f**** |
| InvokeRecordStatus |
string |
El estado de ejecución del comando. Valores válidos:
|
Running |
| Launcher |
string |
El programa de arranque para la ejecución del script. El valor puede tener hasta 1 KB de longitud. |
python3 -u {{ACS::ScriptFileName|Ext(".py")}} |
| OssOutputDelivery |
string |
La configuración de entrega de OSS para la salida de ejecución del comando. |
oss://testBucket/testPrefix |
| OssOutputErrorCode |
string |
El código de error cuando falla la entrega. Este parámetro se devuelve solo cuando OssOutputStatus es Failed. Valores válidos:
|
CloudAssistant.UnsupportedInvocationStatus |
| OssOutputErrorInfo |
string |
Los detalles del error cuando falla la entrega. Este parámetro se devuelve solo cuando OssOutputStatus es Failed. |
The invocation status does not support output delivery |
| OssOutputStatus |
string |
El estado de entrega de la salida de ejecución del comando. Valores válidos:
|
Finished |
| OssOutputUri |
string |
El URI del archivo entregado a OSS para la salida de ejecución del comando. Este campo es una cadena vacía cuando la entrega falla o está en curso. |
oss://testBucket/testPrefix/output.txt |
| Output |
string |
La salida de la ejecución del comando.
|
MTU6MzA6MDEK |
| Repeats |
integer |
El número de veces que se ejecutó el comando en la instancia.
|
0 |
| StartTime |
string |
La hora en que el comando comenzó a ejecutarse en la instancia. La hora se muestra en formato ISO 8601 en hora UTC. |
2019-12-20T06:15:55Z |
| StopTime |
string |
La hora en que se llamó a |
2020-01-19T09:15:47Z |
| Tags |
object |
||
| Tag |
array<object> |
La información de etiquetas de la ejecución del comando. |
|
|
object |
La información de etiquetas de la ejecución del comando. |
||
| TagKey |
string |
La clave de etiqueta de la ejecución del comando. |
owner |
| TagValue |
string |
El valor de etiqueta de la ejecución del comando. |
zhangsan |
| TerminationMode |
string |
El modo utilizado cuando la tarea se detiene (detenida manualmente o interrumpida por tiempo de espera agotado). Valores válidos:
|
ProcessTree |
| Username |
string |
El nombre de usuario utilizado para ejecutar el comando en la instancia de ECS. |
test |
| NextToken |
string |
El token de paginación devuelto en esta llamada. |
AAAAAdDWBF2 |
| PageNumber |
integer |
El número de página actual. |
1 |
| PageSize |
integer |
El número de entradas por página configurado para las consultas paginadas. |
1 |
| TotalCount |
integer |
El número total de comandos. |
1 |
| RequestId |
string |
El ID de la solicitud. |
473469C7-AA6F-4DC5-B3DB-A3DC0DE***** |
Ejemplos
Respuesta exitosa
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 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. | La operación de API no es compatible en la región especificada. Compruebe si el valor del parámetro RegionId es correcto. |
| 400 | NumberExceed.Tags | The Tags parameter number is exceed. | El número de etiquetas excede el límite máximo. Puede especificar hasta 20 etiquetas para esta operación. |
| 400 | Duplicate.TagKey | The Tag.N.Key contain duplicate key. | Existen claves duplicadas en las etiquetas. Asegúrese de que todas las claves sean únicas. |
| 400 | InvalidTagKey.Malformed | The specified Tag.n.Key is not valid. | El parámetro de clave de etiqueta especificado no es válido. |
| 400 | InvalidTagValue.Malformed | The specified Tag.n.Value is not valid. | El parámetro de valor de etiqueta especificado no es válido. |
| 400 | MissingParameter.TagKey | You must specify Tag.N.Key. | Especifique una clave de etiqueta. |
| 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. | El parámetro NextToken especificado no es válido. |
| 400 | InvalidParameter.MaxResults | The specified parameter MaxResults is not valid. | El parámetro MaxResults especificado no es válido. |
| 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. | |
| 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. | La operación no está permitida. |
| 404 | InvalidRegionId.NotFound | The RegionId provided does not exist in our records. | El RegionId especificado no existe. Verifique si el producto está disponible en esta región. |
| 404 | InvalidCommandId.NotFound | The specified commandId does not exist |
Consulte Códigos de error para ver la lista completa.
Notas de la versión
Consulte Notas de la versión para ver la lista completa.