Enumeración de capacidad aprovisionada (GET capacidad-aprovisionada)

Esta operación muestra las unidades de capacidad aprovisionadas de la Cuenta de AWS especificada. Para obtener más información sobre la capacidad aprovisionada, consulte Opciones de recuperación de archivos.

Una unidad de capacidad aprovisionada dura un mes a partir de la fecha y la hora de la compra, que es la fecha de inicio. La unidad se caduca en la fecha de vencimiento, que es exactamente un mes después de la fecha de inicio, al segundo más cercano.

Si la fecha de inicio es el 31 de un mes, la fecha de vencimiento es el último día del mes siguiente. Por ejemplo, si la fecha de inicio es 31 de agosto, la fecha de vencimiento es 30 de septiembre. Por ejemplo, si la fecha de inicio es 31 de enero, la fecha de vencimiento es 28 de febrero. Puede ver esta funcionalidad en la Respuesta de ejemplo.

Sintaxis de la solicitud

Para publicar la capacidad de recuperación aprovisionada de una cuenta, envíe una solicitud HTTP GET al URI de la capacidad aprovisionada, tal y como se muestra en el siguiente ejemplo de sintaxis.

GET /AccountId/provisioned-capacity 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 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 S3 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 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

Si la operación se realiza correctamente, el servicio devuelve una respuesta HTTP 200 OK.

Sintaxis de la respuesta

HTTP/1.1 200 OK
x-amzn-RequestId: x-amzn-RequestId
Date: Date
Content-Type: application/json
Content-Length: Length
{
   "ProvisionedCapacityList": 
      {
         "CapacityId" : "string",
         "StartDate" : "string"
         "ExpirationDate" : "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.

CapacityId

ID que identifica la unidad de capacidad aprovisionada.

Tipo: cadena.

StartDate

Fecha en que se adquirió la unidad de capacidad aprovisionada, en formato UTC (horario universal coordinado).

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

ExpirationDate

Fecha en que caduca la unidad de capacidad aprovisionada, en formato UTC (horario universal coordinado).

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

Errores

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

Ejemplos

En el siguiente ejemplo, se muestran las unidades de capacidad aprovisionadas de una cuenta.

Solicitud de ejemplo

En este ejemplo, se envía una solicitud GET para recuperar una lista con las unidades de capacidad aprovisionadas de una determinada cuenta.

GET /123456789012/priority-capacity 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

Si la solicitud se ha realizado correctamente, Amazon S3 Glacier (S3 Glacier) devuelve una respuesta HTTP 200 OK con una lista de las unidades de capacidad aprovisionadas en la cuenta, tal y como se muestra en el siguiente ejemplo.

La unidad de capacidad aprovisionada que aparece primero es un ejemplo de unidad con fecha de inicio del 31 de enero de 2017 y fecha de vencimiento del 28 de febrero de 2017. Como se ha explicado previamente, si la fecha de inicio es el 31 de un mes, la fecha de vencimiento es el último día del mes siguiente.

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

{
   "ProvisionedCapacityList",
      {
         "CapacityId": "zSaq7NzHFQDANTfQkDen4V7z",
         "StartDate": "2017-01-31T14:26:33.031Z",
         "ExpirationDate": "2017-02-28T14:26:33.000Z",
      },
      {
         "CapacityId": "yXaq7NzHFQNADTfQkDen4V7z",
         "StartDate": "2016-12-13T20:11:51.095Z"",
         "ExpirationDate": "2017-01-13T20:11:51.000Z" ",
      },
      ...
}

Secciones relacionadas

• Adquisición de capacidad aprovisionada (POST capacidad-aprovisionada)