Descripción Solicitudes Respuestas Ejemplos Secciones relacionadas

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.

Enumeración de partes (GET uploadID)

Descripción

Esta operación de carga multiparte enumera las partes de un archivo que se han cargado en una carga multiparte específica identificada por un ID de carga. Para obtener información sobre la carga multiparte, consulte Carga de archivos grandes por partes (carga multiparte).

Puede realizar esta solicitud en cualquier momento durante una carga multiparte en curso antes de completar la carga multiparte. Amazon Glacier devuelve la lista de partes ordenada por rango que haya especificado en cada carga de partes. Si envía una solicitud de lista de piezas después de completar la carga de varias partes, Amazon Glacier (Amazon Glacier) devolverá un error.

La operación de enumeración de partes admite la paginación. Siempre debe consultar si el campo Marker del cuerpo de la respuesta contiene un marcador en el que continuará la lista; si no hay más elementos, el campo marker será null. Si no marker es nulo, para buscar el siguiente conjunto de piezas, envió otra solicitud de lista de piezas con el parámetro de solicitud establecido en el marker valor de marcador que Amazon Glacier devolvió en respuesta a su solicitud anterior de lista de piezas.

También puede limitar el número de partes devueltas en la respuesta especificando el parámetro limit en la solicitud.

Solicitudes

Sintaxis

Para enumerar las partes de una carga multiparte en curso, envíe una solicitud GET al URI del recurso de ID de carga multiparte. El ID de carga multiparte se devuelve al iniciar una carga multiparte (Inicio de la carga multiparte (POST cargas-multiparte)). Si lo desea, también puede especificar los parámetros marker y limit.


GET /AccountId/vaults/VaultName/multipart-uploads/uploadID HTTP/1.1
Host: glacier.Region.amazonaws.com
Date: Date
Authorization: SignatureValue
x-amz-glacier-version: 2012-06-01

nota

El AccountId valor es el Cuenta de AWS ID de la cuenta propietaria del almacén. Puede especificar un Cuenta de AWS ID o, si lo desea, un único - '' (guión), en cuyo caso Amazon Glacier utilizará el Cuenta de AWS ID asociado a las credenciales utilizadas para firmar la solicitud. Si usa un ID de cuenta, no incluya ningún guion (“-”) en el ID.

Parámetros de la solicitud

Nombre Descripción Obligatorio

Nombre	Descripción	Obligatorio
`limit`	Número máximo de partes que se van a devolver. El límite predeterminado es 50. El número de partes devueltas puede ser menor que el límite especificado, pero nunca puede superarlo. Tipo: cadena Restricciones: el valor entero mínimo es `1`. El valor entero máximo es `50`.	No
`marker`	Cadena opaca utilizada para la paginación. `marker` especifica la parte en la deben comenzar las listas de partes. Obtenga el valor `marker` de la respuesta de una respuesta anterior de la enumeración de partes. Solo tiene que incluir `marker` si quiere continuar la paginación de resultados que se inició en una solicitud anterior de enumeración de partes. Tipo: cadena Restricciones: ninguna	No

limit

Número máximo de partes que se van a devolver. El límite predeterminado es 50. El número de partes devueltas puede ser menor que el límite especificado, pero nunca puede superarlo.

Tipo: cadena

Restricciones: el valor entero mínimo es 1. El valor entero máximo es 50.

marker

Cadena opaca utilizada para la paginación. marker especifica la parte en la deben comenzar las listas de partes. Obtenga el valor marker de la respuesta de una respuesta anterior de la enumeración de partes. Solo tiene que incluir marker si quiere continuar la paginación de resultados que se inició en una solicitud anterior de enumeración de partes.

Tipo: cadena

Restricciones: ninguna

Encabezados de solicitud

Esta operación solo usa encabezados de respuesta que sean comunes a la mayoría de las respuestas. Para obtener información acerca de los encabezados de respuestas comunes, consulte Encabezados de respuesta comunes.

Cuerpo de la solicitud

Esta operación no tiene un cuerpo de la solicitud.

Respuestas

Sintaxis


HTTP/1.1 200 OK
x-amzn-RequestId: x-amzn-RequestId
Date: Date
Content-Type: application/json
Content-Length: Length

{
    "ArchiveDescription" : String,
    "CreationDate" : String,
    "Marker": String,
    "MultipartUploadId" : String,
    "PartSizeInBytes" : Number,
    "Parts" : 
    [ {
      "RangeInBytes" : String,
      "SHA256TreeHash" : String
      },
      ...
     ],
    "VaultARN" : String
}

Encabezados de respuesta

Cuerpo de respuesta

El cuerpo de la respuesta contiene los siguientes campos JSON.

ArchiveDescription

Descripción del archivo que se especificó en la solicitud Initiate Multipart Upload. Este campo es null si no se especificó ninguna descripción del archivo en la operación Initiate Multipart Upload.

Tipo: cadena

CreationDate

Momento en formato UTC en que se creó la carga multiparte.

Tipo: cadena. Una representación de cadena con el formato de fecha ISO 8601; por ejemplo, 2013-03-20T17:03:43.221Z.

Marker

Cadena opaca que indica dónde se va a continuar la paginación de los resultados. Puede utilizar marker en una nueva solicitud de enumeración de partes para recuperar más trabajos de la lista. Si no hay más partes, este valor es null.

Tipo: cadena

MultipartUploadId

El ID de la carga a la que están asociadas las partes.

Tipo: cadena

PartSizeInBytes

El tamaño de la parte en bytes. Es el mismo valor que ha especificado en la solicitud de inicio de carga multiparte.

Tipo: Número

Partes

Una lista de los tamaños de parte de la carga multiparte. Cada objeto de la matriz contiene un parte de nombre/valor RangeBytes y sha256-tree-hash.

Tipo: Array

RangeInBytes

El rango de bytes de una parte, incluido el valor superior del rango.

Tipo: cadena

SHA256TreeHash

El valor hash del SHA256 árbol que Amazon Glacier calculó para la pieza. Este campo nunca es null.

Tipo: cadena

VaultARN

Nombre de recurso de Amazon (ARN) del almacén en el que se inició la carga multiparte.

Tipo: cadena

Errores

Para obtener información sobre las excepciones y los mensajes de error de Amazon Glacier, consulteRespuestas de error.

Ejemplos

Ejemplo: enumeración de partes de una carga multiparte

En el siguiente ejemplo se enumeran todas las partes de una carga. El ejemplo envía una solicitud HTTP GET al URI del ID de una carga multiparte específica en curso y devuelve un máximo de 1000 partes.

Solicitud de ejemplo


GET /-/vaults/examplevault/multipart-uploads/OW2fM5iVylEpFEMM9_HpKowRapC3vn5sSL39_396UW9zLFUWVrnRHaPjUJddQ5OxSHVXjYtrN47NBZ-khxOjyEXAMPLE HTTP/1.1
Host: glacier.us-west-2.amazonaws.com
x-amz-Date: 20170210T120000Z
x-amz-glacier-version: 2012-06-01
Authorization: AWS4-HMAC-SHA256 Credential=AKIAIOSFODNN7EXAMPLE/20141123/us-west-2/glacier/aws4_request,SignedHeaders=host;x-amz-date;x-amz-glacier-version,Signature=9257c16da6b25a715ce900a5b45b03da0447acf430195dcb540091b12966f2a2

Respuesta de ejemplo

En la respuesta, Amazon Glacier devuelve una lista de las partes cargadas asociadas al ID de carga multiparte especificado. En este ejemplo, solo hay dos partes. El campo Marker devuelto es null, lo que indica que no hay más partes de la carga multiparte.


HTTP/1.1 200 OK
x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q
Date: Wed, 10 Feb 2017 12:00:00 GMT
Content-Type: application/json
Content-Length: 412
      
{
    "ArchiveDescription" : "archive description",
    "CreationDate" : "2012-03-20T17:03:43.221Z",
    "Marker": null,
    "MultipartUploadId" : "OW2fM5iVylEpFEMM9_HpKowRapC3vn5sSL39_396UW9zLFUWVrnRHaPjUJddQ5OxSHVXjYtrN47NBZ-khxOjyEXAMPLE",
    "PartSizeInBytes" : 4194304,
    "Parts" : 
    [ {
      "RangeInBytes" : "0-4194303",
      "SHA256TreeHash" : "01d34dabf7be316472c93b1ef80721f5d4"
      },
      {
      "RangeInBytes" : "4194304-8388607",
      "SHA256TreeHash" : "0195875365afda349fc21c84c099987164"
      }],
    "VaultARN" : "arn:aws:glacier:us-west-2:012345678901:vaults/demo1-vault"
}

Ejemplo: enumeración de partes de una carga multiparte (especificar el marcador y los parámetros de solicitud de límite)

En el siguiente ejemplo, se muestra cómo se utiliza la paginación para obtener un número limitado de resultados. El ejemplo envía una solicitud HTTP GET al URI del ID de una carga multiparte específica en curso para devolver una parte. Un parámetro marker de inicio especifica en qué parte comienza la lista de partes. Puede obtener el valor marker de la respuesta de una solicitud anteriores de una lista de partes. Además, en este ejemplo el parámetro limit se establece en 1 y devuelve una parte. Tenga en cuenta que el campo Marker no es null, lo que indica que hay al menos una parte para obtener.

Solicitud de ejemplo


GET /-/vaults/examplevault/multipart-uploads/OW2fM5iVylEpFEMM9_HpKowRapC3vn5sSL39_396UW9zLFUWVrnRHaPjUJddQ5OxSHVXjYtrN47NBZ-khxOjyEXAMPLE?marker=1001&limit=1 HTTP/1.1
Host: glacier.us-west-2.amazonaws.com
x-amz-Date: 20170210T120000Z
x-amz-glacier-version: 2012-06-01
Authorization: AWS4-HMAC-SHA256 Credential=AKIAIOSFODNN7EXAMPLE/20141123/us-west-2/glacier/aws4_request,SignedHeaders=host;x-amz-date;x-amz-glacier-version,Signature=9257c16da6b25a715ce900a5b45b03da0447acf430195dcb540091b12966f2a2

Respuesta de ejemplo

En la respuesta, Amazon Glacier devuelve una lista de las partes cargadas que están asociadas al ID de carga multiparte en curso especificado.


HTTP/1.1 200 OK
x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q
Date: Wed, 10 Feb 2017 12:00:00 GMT
Content-Type: text/json
Content-Length: 412
      
{
    "ArchiveDescription" : "archive description 1",
    "CreationDate" : "2012-03-20T17:03:43.221Z",
    "Marker": "MfgsKHVjbQ6EldVl72bn3_n5h2TaGZQUO-Qb3B9j3TITf7WajQ",
    "MultipartUploadId" : "OW2fM5iVylEpFEMM9_HpKowRapC3vn5sSL39_396UW9zLFUWVrnRHaPjUJddQ5OxSHVXjYtrN47NBZ-khxOjyEXAMPLE",
    "PartSizeInBytes" : 4194304,
    "Parts" : 
    [ {
      "RangeInBytes" : "4194304-8388607",
      "SHA256TreeHash" : "01d34dabf7be316472c93b1ef80721f5d4"
      }],
    "VaultARN" : "arn:aws:glacier:us-west-2:012345678901:vaults/demo1-vault"
}

Aviso JavaScript está desactivado o no está disponible en su navegador.

Para utilizar la documentación de AWS, debe estar habilitado JavaScript. Para obtener más información, consulte las páginas de ayuda de su navegador.

Convenciones del documento

Initiate Multipart Upload

List Multipart Uploads