Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
ListExecutions
Devuelve el estado de las tareas de uno o más dispositivos de destino.
Sintaxis de la solicitud
GET /executions?maxResults=maxResults
&nextToken=nextToken
&state=state
&taskId=taskId
HTTP/1.1
URIParámetros de solicitud
La solicitud utiliza los siguientes URI parámetros.
- maxResults
-
El número máximo de dispositivos que se van a enumerar por página.
Rango válido: valor mínimo de 1. Valor máximo de 100.
- nextToken
-
Un token de paginación para continuar con la siguiente página de tareas.
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 1024 caracteres.
Patrón:
^[a-zA-Z0-9+/=]*$
- state
-
Estructura que se utiliza para filtrar las tareas según su estado actual.
Valores válidos:
QUEUED | IN_PROGRESS | CANCELED | FAILED | SUCCEEDED | REJECTED | TIMED_OUT
- taskId
-
El ID de la tarea.
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 64.
Obligatorio: sí
Cuerpo de la solicitud
La solicitud no tiene un cuerpo de la solicitud.
Sintaxis de la respuesta
HTTP/1.1 200
Content-type: application/json
{
"executions": [
{
"executionId": "string",
"managedDeviceId": "string",
"state": "string",
"taskId": "string"
}
],
"nextToken": "string"
}
Elementos de respuesta
Si la acción se realiza correctamente, el servicio devuelve una respuesta de HTTP 200.
El servicio devuelve los siguientes datos en JSON formato.
- executions
-
Una lista de ejecuciones. Cada ejecución contiene el ID de la tarea, el dispositivo en el que se ejecuta la tarea, el ID de ejecución y el estado de la ejecución.
Tipo: matriz de objetos ExecutionSummary
- nextToken
-
Un token de paginación para continuar con la siguiente página de ejecuciones.
Tipo: cadena
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 1024 caracteres.
Patrón:
^[a-zA-Z0-9+/=]*$
Errores
Para obtener información acerca de los errores comunes a todas las acciones, consulte Errores comunes.
- AccessDeniedException
-
No tiene acceso suficiente para realizar esta acción.
HTTPCódigo de estado: 403
- InternalServerException
-
Se ha producido un error inesperado al procesar la solicitud.
HTTPCódigo de estado: 500
- ResourceNotFoundException
-
La solicitud hace referencia a un recurso que no existe.
HTTPCódigo de estado: 404
- ThrottlingException
-
La solicitud fue denegada debido a una limitación de la solicitud.
HTTPCódigo de estado: 429
- ValidationException
-
La entrada no cumple con las restricciones especificadas por un AWS servicio.
HTTPCódigo de estado: 400
Véase también
Para obtener más información sobre cómo usarlo API en uno de los idiomas específicos AWS SDKs, consulte lo siguiente: