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 REST original de 2012.

Si busca soluciones de almacenamiento de archivos, le recomendamos 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 bóveda) 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 propio APIs 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 se requiere ninguna migración. 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 de cliente superior con S3 basada en cubos APIs, 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 Guía de AWS soluciones para transferir datos de los almacenes de Amazon Glacier a las clases de almacenamiento de Amazon S3 Glacier.

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 identificador de archivo válido que haya obtenido en 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

El rango de bytes que se va a recuperar para unarchive-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). Alineado en megabytes significa que StartByteValuedebe ser divisible por 1 MB y EndByteValuemás 1 debe ser divisible por 1 MB o estar al final del archivo especificado como valor de tamaño de byte del archivo menos 1. Si no RetrievalByteRangeestá 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

El nombre del recurso de Amazon (ARN) del tema Amazon SNS en el que Amazon Glacier envía una notificación cuando se completa el trabajo y el resultado está listo 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 por usted. 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 los temas de SNS, consulte CreateTopicla 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