Descripción del almacén (GET almacén) - Amazon S3 Glacier
DescripciónSolicitudesRespuestasEjemplosSecciones relacionadasVéase también

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.

Descripción del almacén (GET almacén)

Descripción

Esta operación devuelve información sobre el almacén, como el nombre de recurso de Amazon (ARN), la fecha en que se creó el almacén, el número de archivos incluidos en el almacén y el tamaño total de todos los archivos del almacén. El número de archivos y su tamaño total se calculan a partir del último inventario que generó Amazon S3 Glacier (S3 Glacier) (consulte Trabajar con almacenes en Amazon S3 Glacier). S3 Glacier genera los inventarios de almacén aproximadamente una vez al día. Esto significa que si agrega o quita un archivo de un almacén y envía inmediatamente la solicitud Describe Vault, es muy probable que la respuesta no refleje los cambios.

Solicitudes

Para obtener información acerca de un almacén, envíe una solicitud GET al URI del recurso de almacén específico.

Sintaxis

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

nota

El valor AccountId es el ID de la Cuenta de AWS propietaria del almacén. Puede especificar un ID de Cuenta de AWS o, si lo desea, un solo carácter “-” (guion), en cuyo caso, Amazon S3 Glacier usa el ID de la Cuenta de AWS asociada con las credenciales empleadas para firmar la solicitud. Si usa un ID de cuenta, no incluya ningún guion (“-”) en el ID.

Parámetros de solicitud

Esta operación no usa parámetros de solicitud.

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.

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

{
  "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.

Cuerpo de respuesta

El cuerpo de la respuesta contiene los siguientes campos JSON.

CreationDate

Fecha en formato UTC en la que se creó el almacén.

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

LastInventoryDate

Fecha en formato UTC en la que S3 Glacier completó el último inventario de almacén. Para obtener información acerca de cómo iniciar un inventario de un almacén, consulte Iniciar trabajo (POSTtrabajos).

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

NumberOfArchives

Número de archivos del almacén según el último inventario. Este campo devolverá el valor null si aún no se ha ejecutado un inventario del almacén; por ejemplo, si se acaba de crear el almacén.

Tipo: Número

SizeInBytes

Tamaño total en bytes de los archivos del almacén, incluidas las sobrecargas de cada archivo, desde la fecha del último inventario. Este campo devolverá el valor null si aún no se ha ejecutado un inventario del almacén; por ejemplo, si se acaba de crear el almacén.

Tipo: Número

VaultARN

Nombre de recurso de Amazon (ARN) del almacén.

Tipo: cadena

VaultName

Nombre del almacén que se especificó en el momento en que se creó. El nombre también se incluye en el ARN del almacén.

Tipo: cadena

Errores

Para obtener información acerca de los mensajes de error y las excepciones de Amazon S3 Glacier, consulte Respuestas de error.

Ejemplos

Solicitud de ejemplo

En el ejemplo siguiente, se muestra cómo obtener información sobre un almacén llamado examplevault.

GET /-/vaults/examplevault 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

HTTP/1.1 200 OK
x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q
Date: Wed, 10 Feb 2017 12:02:00 GMT
Content-Type: application/json
Content-Length: 260

{
  "CreationDate" : "2012-02-20T17:01:45.198Z",
  "LastInventoryDate" : "2012-03-20T17:03:43.221Z",
  "NumberOfArchives" : 192,
  "SizeInBytes" : 78088912,
  "VaultARN" : "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault",
  "VaultName" : "examplevault"
}

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: