jobParameters - Amazon Glacier
ContenidoMás información

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

Si busca soluciones de almacenamiento de archivos, se recomienda que utilice las clases de almacenamiento de Amazon 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 las clases de almacenamiento de Amazon Glacier.

Amazon Glacier (servicio original independiente basado en almacenes) ya no aceptará nuevos clientes a partir del 15 de diciembre de 2025, sin que ello afecte a los clientes actuales. Amazon Glacier es un servicio independiente con sus propias API que almacena datos en almacenes y es distinto de las clases de almacenamiento Amazon S3 y Amazon S3 Glacier. Sus datos actuales permanecerán seguros y accesibles en Amazon Glacier de forma indefinida. No hay que hacer migraciones. Para un almacenamiento de archivos a largo plazo y de bajo costo, AWS recomienda las clases de almacenamiento Amazon S3 Glacier, que ofrecen una experiencia del cliente superior con las API basadas en buckets de S3, Región de AWS disponibilidad total, costos más bajos e AWS integración de servicios. Si desea mejorar las capacidades, considere la posibilidad de migrar a las clases de almacenamiento de Amazon S3 Glacier mediante nuestra AWSGuía de soluciones para la transferencia de datos de los almacenes de Amazon Glacier a las clases de almacenamiento de Amazon S3 Glacier.

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 Glacier (Amazon 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 Amazon 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í, Amazon 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

Nivel

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 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