Referencia de la API de
administración de trabajos para AWS
Snowball
La API de administración de trabajos para AWS Snowball es un protocolo de red basado en HTTP (RFC
2616). Para obtener más información sobre esta RFC, consulte
IETF. Para cada llamada a la API de administración de trabajos, debe llevar a cabo una solicitud HTTP al
punto de enlace de la API de administración de trabajos específica de la región de AWS en la que desea
administrar los trabajos. La API utiliza documentos JSON (RFC 4627) para el cuerpo de las solicitudes y
respuestas HTTP.
Note
Las llamadas a las API realizadas en las regiones de los Estados Unidos para publicar los
trabajos o describir las direcciones devolverá, respectivamente, todos los trabajos o direcciones
de los Estados Unidos para esa cuenta.
La API de administración de trabajos para Snowball es un modelo RPC, que contiene un conjunto fijo
de operaciones; los clientes conocen la sintaxis para cada operación sin ninguna interacción previa. A
continuación, encontrará una descripción de cada operación de la API en la notación RPC abstracta, con
un nombre de operación que no aparece en la ruta. Para cada operación, el tema especifica el mapeo a los
elementos de solicitud HTTP.
La operación de administración del trabajo concreta a la que se asigna una solicitud concreta se determina
mediante una combinación del método de la solicitud (GET, PUT, POST o DELETE) y de cuáles de los
distintos patrones coincide con su URI de solicitud. Si la operación es PUT o POST, Snowball extrae los
argumentos de llamada del segmento de la ruta URI de la solicitud, los parámetros de la consulta y el
objeto JSON del cuerpo de la solicitud.
Aunque el nombre de la operación, por ejemplo, CreateJob, no aparece en la ruta, los nombres de
operación son importantes en las políticas de AWS Identity and Access Management (IAM). El nombre
de la operación también se utiliza para nombrar comandos en herramientas de línea de comandos y
elementos del SDK de AWS APIs. Por ejemplo, el comando AWS Command Line Interface de la AWS CLI
(create-job) se mapea a la operación CreateJob. El nombre de la operación también aparece en los
registros de CloudTrail para las llamadas a la API de Snowball.
Para obtener información acerca de cómo instalar y configurar la AWS CLI, además de especificar en qué
regiones desea hacer llamadas desde la AWS CLI, consulte la
usuario.
Note
La API de administración de trabajos proporciona acceso mediante programación a la misma
funcionalidad disponible en la
AWS, que consiste en crear y administrar trabajos para Snowball. Para transferir realmente datos
de forma local con un dispositivo Snowball, es necesario el Cliente de Snowball o el Adaptador de
Amazon S3 para Snowball. Para obtener más información, consulte
un Snowball (p.
AWS Snowball Guía del usuario
Consola de administración de la familia de productos Snow de
55).
HTTP (RFC 2616)
AWS Command Line Interface Guía del
117
en el sitio web de
Transferencia de datos con