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.
CreateTask
Indica a uno o más dispositivos que inicien una tarea, como desbloquear o reiniciar.
Sintaxis de la solicitud
POST /task HTTP/1.1
Content-type: application/json
{
"clientToken": "string
",
"command": { ... },
"description": "string
",
"tags": {
"string
" : "string
"
},
"targets": [ "string
" ]
}
Parámetros de solicitud del URI
La solicitud no utiliza ningún parámetro de URI.
Cuerpo de la solicitud
La solicitud acepta los siguientes datos en formato JSON.
- clientToken
-
Un token que garantiza que la acción se llame solo una vez con los detalles especificados.
Tipo: string
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 64.
Patrón:
[!-~]+
Obligatorio: no
- command
-
La tarea que se va a realizar. Solo se ejecuta una tarea en un dispositivo a la vez.
Tipo: objeto Command
Nota: Este objeto es una unión. Solo se puede especificar o devolver un miembro de este objeto.
Obligatorio: sí
- description
-
Una descripción de la tarea y sus objetivos.
Tipo: string
Limitaciones de longitud: longitud mínima de 1. Longitud máxima de 128.
Patrón:
[A-Za-z0-9 _.,!#]*
Obligatorio: no
-
Metadatos opcionales que se asignan a un recurso. Las etiquetas permiten clasificar los recursos de diversas maneras, por ejemplo, según la finalidad, el propietario o el entorno.
Tipo: mapa de cadena a cadena
Obligatorio: no
- targets
-
Una lista de los ID de los dispositivos administrados.
Tipo: matriz de cadenas
Miembros de la matriz: número mínimo de 1 artículo. La cantidad máxima es de 10 elementos.
Obligatorio: sí
Sintaxis de la respuesta
HTTP/1.1 200
Content-type: application/json
{
"taskArn": "string",
"taskId": "string"
}
Elementos de respuesta
Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.
El servicio devuelve los datos siguientes en formato JSON.
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.
Código de estado HTTP: 403
- InternalServerException
-
Se ha producido un error inesperado al procesar la solicitud.
Código de estado HTTP: 500
- ResourceNotFoundException
-
La solicitud hace referencia a un recurso que no existe.
Código de estado HTTP: 404
- ServiceQuotaExceededException
-
La solicitud provocaría que se superara una cuota de servicio.
Código de estado HTTP: 402
- ThrottlingException
-
La solicitud fue denegada debido a una limitación de la solicitud.
Código de estado HTTP: 429
- ValidationException
-
La entrada no cumple las restricciones especificadas por un AWS servicio.
Código de estado HTTP: 400
Véase también
Para obtener más información sobre el uso de esta API en uno de los AWS SDK específicos del idioma, consulta lo siguiente: