jobParameters - Amazon S3 Glacier

Esta página es solo para los clientes actuales del servicio S3 Glacier que utilizan Vaults y el original de 2012. REST API

Si busca soluciones de almacenamiento de archivos, le sugerimos que utilice las clases de almacenamiento S3 Glacier en Amazon S3, S3 Glacier Instant Retrieval, S3 Glacier Flexible Retrieval y S3 Glacier Deep Archive. Para obtener más información sobre estas opciones de almacenamiento, consulte Clases de almacenamiento de S3 Glacier y Almacenamiento de datos a largo plazo con clases de almacenamiento de S3 Glacier en la Guía del usuario de Amazon S3. Estas clases de almacenamiento utilizan Amazon S3API, están disponibles en todas las regiones y se pueden gestionar en la consola de Amazon S3. Ofrecen funciones como el análisis de costos de almacenamiento, Storage Lens, funciones avanzadas de cifrado opcionales y más.

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.

jobParameters

Ofrece opciones para definir un trabajo.

Contenido

ArchiveId

ID del archivo que desea. Este campo es obligatorio si Type está establecido en select o archive-retrieval. Se produce un error si este campo se especifica en la solicitud de un trabajo de recuperación de inventario.

Valores válidos: debe ser un ID de archivo válido obtenido de una solicitud anterior a Amazon S3 Glacier (S3 Glacier).

Tipo: cadena

Obligatorio: Sí, cuando Type está establecido en select o archive-retrieval.

Descripción

Descripción opcional del trabajo.

Valores válidos: la descripción debe tener 1024 bytes o menos. Los caracteres permitidos son caracteres ASCII de 7 bits sin códigos de control; en particular, valores ASCII de 32 a 126 en decimal o de 0x20 a 0x7E en hexadecimal.

Tipo: cadena

Obligatorio: No

Formato

(Opcional) Formato de salida cuando se inicia un trabajo para recuperar un inventario del almacén. Si se va a iniciar un trabajo de inventario y no se especifica el campo Format, se utilizará JSON como formato predeterminado.

Valores válidos: CSV | JSON

Tipo: cadena

Obligatorio: No

InventoryRetrievalParameters

Parámetros de entrada que se utilizan en una recuperación de inventario por intervalos.

Tipo: InventoryRetrievalJobInput objeto

Obligatorio: No

OutputLocation

Objeto que contiene información sobre la ubicación en la que se guardan los resultados del trabajo de selección.

Tipo: OutputLocation objeto

Obligatorio: Sí, para los trabajos select.

RetrievalByteRange

Intervalo de bytes que se va a recuperar de archive-retrieval con el formato "StartByteValue-EndByteValue". Si este campo no está especificado, se recupera todo el archivo. Si este campo está especificado, el intervalo de bytes debe estar alineado en megabytes (1024* 1024). Estar alineado en megabytes significa que StartByteValue debe ser divisible por 1 MB, mientras que EndByteValue más 1 debe ser divisible por 1 MB o ser el final del archivo especificado como el tamaño en bytes del archivo menos 1. Si RetrievalByteRange no está alineado en megabytes, esta operación devuelve una respuesta 400.

Se produce un error si este campo se especifica en una solicitud de trabajo inventory-retrieval o select.

Tipo: cadena

Obligatorio: No

SelectParameters

Objeto que contiene información sobre los parámetros que se utilizan en una selección.

Tipo: SelectParameters objeto

Obligatorio: No

SNSTopic

Nombre de recurso de Amazon (ARN) del tema de Amazon SNS al que S3 Glacier envía notificaciones cuando se completa el trabajo y la salida está lista para su descarga. El tema especificado publica la notificación para sus suscriptores.

El tema de SNS debe existir previamente. Si no es así, S3 Glacier no lo crea automáticamente. Además, el tema de SNS debe tener una política que permita a la cuenta que creó el trabajo publicar mensajes en el tema. Para obtener información sobre los nombres de tema de SNS, consulte CreateTopic en la Referencia de la API de Amazon Simple Notification Service.

Tipo: cadena

Obligatorio: No

datos y búsqueda

Nivel que se va a utilizar en un trabajo de selección o recuperación de archivo. Standard es el valor predeterminado.

Valores válidos: Expedited | Standard | Bulk

Tipo: cadena

Obligatorio: No

Tipo

Tipo de trabajo. Puede iniciar un trabajo de para realizar una consulta de selección de un archivo, recuperar un archivo u obtener el inventario de un almacén.

Valores válidos: select | archive-retrieval | inventory-retrieval

Tipo: cadena

Obligatorio: Sí

Más información