**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](https://aws.amazon.com/s3/storage-classes/glacier/). Amazon Glacier (servicio original independiente basado en bóveda) ya no acepta nuevos clientes. 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 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](https://aws.amazon.com/s3/storage-classes/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 [AWS Guía de soluciones para la transferencia de datos de los almacenes de Amazon Glacier a las clases de almacenamiento de Amazon S3 Glacier](https://aws.amazon.com/solutions/guidance/data-transfer-from-amazon-s3-glacier-vaults-to-amazon-s3/). 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 almacenes (GET almacenes) ## Descripción Esta operación enumera todos los almacenes que sean propiedad de la cuenta del usuario que hace la llamada. La lista que se devuelve en la respuesta ordenada en ASCII por nombre de almacén. De forma predeterminada, esta operación devuelve un máximo de 10 elementos por solicitud. Si no hay más almacenes para mostrar, el campo `marker` del cuerpo de la respuesta contiene el nombre de recurso de Amazon (ARN) del almacén en el que continuará la lista cuando se envíe una nueva solicitud de enumeración de almacenes; de lo contrario, el campo `marker` es `null`. En la siguiente solicitud de enumeración de almacenes se establece el parámetro `marker` en el valor que Amazon Glacier (Amazon Glacier) devolvió en las respuestas a su solicitud anterior de enumeración de almacenes. También puede limitar el número de almacenes devueltos en la respuesta especificando el parámetro `limit` en la solicitud. ## Solicitudes Para obtener una lista de almacenes, envíe una solicitud `GET` al recurso *vaults*. ### Sintaxis ``` 1. GET /AccountId/vaults HTTP/1.1 2. Host: glacier.Region.amazonaws.com 3. Date: Date 4. Authorization: SignatureValue 5. x-amz-glacier-version: 2012-06-01 ``` **nota** El valor `AccountId` es el ID de Cuenta de AWS. Este valor debe coincidir con el ID de la Cuenta de AWS asociada con las credenciales que se utilizaron para firmar la solicitud. Puede especificar un ID de Cuenta de AWS o, si lo desea, un solo carácter “`-`” (guion), en cuyo caso, Amazon Glacier usa el ID de la Cuenta de AWS asociada con las credenciales empleadas para firmar la solicitud. Si especifica su ID de cuenta, no incluya ningún guion (“-”) en él. ### Parámetros de la solicitud Esta operación usa los siguientes parámetros de solicitud. | Nombre | Descripción | Obligatorio | | --- | --- | --- | | limit | Número máximo de almacenes que se van a devolver. El límite predeterminado es 10. El número de almacenes devueltos 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 10. | No | | marker | Una cadena utilizada para la paginación. `marker` especifica el ARN del almacén después del que debe empezar la lista de almacenes. (El almacén especificado por `marker` no está incluido en la lista devuelta). El valor de `marker` se obtiene de una respuesta anterior de enumeración de almacenes. Tiene que incluir `marker` únicamente si quiere continuar la paginación de resultados que se inició en una solicitud anterior de enumeración de almacenes. La especificación de un valor vacío ("") para el marcador devuelve una lista de almacenes a partir del primer almacén. Tipo: cadena Restricciones: ninguna | No | ### Encabezados de solicitud Esta operación solo usa encabezados de solicitud que sean comunes para todas las operaciones. Para obtener información acerca de los encabezados de solicitudes comunes, consulte [Encabezados de solicitudes comunes](api-common-request-headers.md). ### 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 { "Marker": String "VaultList": [ { "CreationDate": String, "LastInventoryDate": String, "NumberOfArchives": Number, "SizeInBytes": Number, "VaultARN": String, "VaultName": String }, ... ] } ``` ### Encabezados de respuesta 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](api-common-response-headers.md). ### Cuerpo de respuesta El cuerpo de la respuesta contiene los siguientes campos JSON. **CreationDate** La fecha en que se creó el almacén, en UTC (hora universal coordinada). *Tipo*: cadena. Una representación de cadena con el formato de fecha ISO 8601; por ejemplo, `2013-03-20T17:03:43.221Z`. **LastInventoryDate** La fecha del último inventario de almacén, en UTC (hora universal coordinada). Este campo puede ser nulo si aún no se ha ejecutado un inventario del almacén; por ejemplo, si se acaba de crear el almacén. Para obtener información acerca de cómo iniciar un inventario de un almacén, consulte [Inicialización de trabajos (POST trabajos)](api-initiate-job-post.md). *Tipo*: una representación de cadena con el formato de fecha ISO 8601; por ejemplo, `2013-03-20T17:03:43.221Z`. **Marker** `vaultARN` indica dónde se va a continuar la paginación de los resultados. Puede utilizar `marker` en otra solicitud de enumeración de almacenes para obtener más almacenes en la lista. Si no hay más almacenes, este valor es `null`. *Tipo:* cadena **NumberOfArchives** Número de archivos del almacén desde la última fecha de inventario. *Tipo*: Número **SizeInBytes** Tamaño total, en bytes, de todos los archivos del almacén, incluidas las sobrecargas de cada archivo, desde la fecha del último inventario. *Tipo*: Número **VaultARN** Nombre de recurso de Amazon (ARN) del almacén. *Tipo:* cadena **VaultList** Una matriz de objetos, donde cada objeto ofrece una descripción de un almacén. *Tipo*: Array **VaultName** El nombre del almacén. *Tipo:* cadena ### Errores Para obtener información acerca de los mensajes de error y las excepciones de Amazon Glacier, consulte [Respuestas de error](api-error-responses.md). ## Ejemplos ### Ejemplo: enumerar todos los almacenes En el siguiente ejemplo se enumeran los almacenes. Como los parámetros `marker` y `limit` no están especificados en la solicitud, se devolverán, como máximo, 10 cargas almacenes. #### Solicitud de ejemplo ``` 1. GET /-/vaults HTTP/1.1 2. Host: glacier.us-west-2.amazonaws.com 3. x-amz-Date: 20170210T120000Z 4. x-amz-glacier-version: 2012-06-01 5. 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 El valor de `Marker` es `null`, lo que indica no hay más almacenes para enumerar. ``` 1. HTTP/1.1 200 OK 2. x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q 3. Date: Wed, 10 Feb 2017 12:02:00 GMT 4. Content-Type: application/json 5. Content-Length: 497 6. 7. { 8. "Marker": null, 9. "VaultList": [ 10. { 11. "CreationDate": "2012-03-16T22:22:47.214Z", 12. "LastInventoryDate": "2012-03-21T22:06:51.218Z", 13. "NumberOfArchives": 2, 14. "SizeInBytes": 12334, 15. "VaultARN": "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault1", 16. "VaultName": "examplevault1" 17. }, 18. { 19. "CreationDate": "2012-03-19T22:06:51.218Z", 20. "LastInventoryDate": "2012-03-21T22:06:51.218Z", 21. "NumberOfArchives": 0, 22. "SizeInBytes": 0, 23. "VaultARN": "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault2", 24. "VaultName": "examplevault2" 25. }, 26. { 27. "CreationDate": "2012-03-19T22:06:51.218Z", 28. "LastInventoryDate": "2012-03-25T12:14:31.121Z", 29. "NumberOfArchives": 0, 30. "SizeInBytes": 0, 31. "VaultARN": "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault3", 32. "VaultName": "examplevault3" 33. } 34. ] 35. } ``` ### Ejemplo: lista parcial de almacenes El siguiente ejemplo devuelve dos almacenes desde el almacén especificado por `marker`. #### Solicitud de ejemplo ``` 1. GET /-/vaults?limit=2&marker=arn:aws:glacier:us-west-2:012345678901:vaults/examplevault1 HTTP/1.1 2. Host: glacier.us-west-2.amazonaws.com 3. x-amz-Date: 20170210T120000Z 4. x-amz-glacier-version: 2012-06-01 5. 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 Se devuelven dos almacenes en la lista. `Marker` contiene el ARN de almacén para continuar la paginación en otra solicitud de enumeración de almacenes. ``` 1. HTTP/1.1 200 OK 2. x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q 3. Date: Wed, 10 Feb 2017 12:02:00 GMT 4. Content-Type: application/json 5. Content-Length: 497 6. 7. { 8. "Marker": "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault3", 9. "VaultList": [ 10. { 11. "CreationDate": "2012-03-16T22:22:47.214Z", 12. "LastInventoryDate": "2012-03-21T22:06:51.218Z", 13. "NumberOfArchives": 2, 14. "SizeInBytes": 12334, 15. "VaultARN": "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault1", 16. "VaultName": "examplevault1" 17. }, 18. { 19. "CreationDate": "2012-03-19T22:06:51.218Z", 20. "LastInventoryDate": "2012-03-21T22:06:51.218Z", 21. "NumberOfArchives": 0, 22. "SizeInBytes": 0, 23. "VaultARN": "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault2", 24. "VaultName": "examplevault2" 25. } 26. ] 27. } ``` ## Secciones relacionadas + [Creación de un almacén (almacén PUT)](api-vault-put.md) + [Eliminación de almacén (DELETE almacén)](api-vault-delete.md) + [Inicialización de trabajos (POST trabajos)](api-initiate-job-post.md) + [Administración de identidades y accesos para Amazon Glacier](security-iam.md) ## Véase también Para obtener más información sobre el uso de esta API en uno de los SDK de Amazon específicos de idioma, consulte lo siguiente: + [AWS Command Line Interface](https://docs.aws.amazon.com/cli/latest/reference/glacier/list-vaults.html)