프로비저닝된 용량 나열(GET provisioned-capacity)

이 작업은 지정된 AWS 계정를 위해 프로비저닝된 용량 단위를 나열합니다. 프로비저닝된 용량에 대한 자세한 내용은 아카이브 검색 옵션 단원을 참조하십시오.

프로비저닝된 용량 유닛은 구매한 날짜 및 시간, 즉 시작 날짜로부터 1개월 지속됩니다. 유닛은 시작 날짜로부터 정확하게 1개월(초 단위) 후인 만료 날짜에 만료됩니다.

시작 날짜가 31일인 경우에는 만료 날짜는 다음 달 말일이 됩니다. 예를 들어 시작 날짜가 8월 31일이라면 만료 날짜는 9월 30일입니다. 시작 날짜가 1월 31일이라면 만료 날짜는 2월 28일입니다. 응답의 예에서 이러한 기능을 볼 수 있습니다.

요청 구문

계정에 프로비저닝된 가져오기 용량을 나열하려면 다음 구문 예제와 같이 HTTP GET 요청을 프로비저닝된 용량 URI에게 전송합니다.

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

참고

AccountId 값은 AWS 계정 ID입니다. 이 값은 요청 서명에 사용된 보안 인증 정보와 연결된 AWS 계정 ID와 반드시 일치해야 합니다. AWS 계정 ID 또는 선택적으로 하나의 '-'(하이픈)을 지정할 수 있습니다. 이 경우에 Amazon S3 Glacier는 요청 서명에 사용된 보안 인증 정보와 연결된 AWS 계정 ID를 사용합니다. 계정 ID를 지정하는 경우 ID에 하이픈('-')을 포함하지 않습니다.

요청 파라미터

이 작업은 요청 파라미터를 사용하지 않습니다.

요청 헤더

이 작업은 모든 작업에 일반적인 요청 헤더만 사용합니다. 일반적인 요청 헤더에 대한 내용은 공통 요청 헤더 단원을 참조하십시오.

요청 본문

이 작업에는 요청 본문이 없습니다.

응답

작업이 성공하면 서비스가 HTTP 200 OK 응답을 다시 전송합니다.

응답 구문

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"
      }
}

응답 헤더

이 작업은 대부분의 응답에 일반적인 응답 헤더만 사용합니다. 일반적인 응답 헤더에 대한 내용은 공통 응답 헤더 단원을 참조하십시오.

응답 본문

JSON 응답 본문에는 다음과 같은 JSON 필드가 포함됩니다.

CapacityId

프로비저닝된 용량 단위를 식별하는 ID입니다.

유형: 문자열.

StartDate

프로비저닝된 용량 단위를 구매한 날짜(UTC)입니다.

유형: 문자열. ISO 8601 날짜 형식의 문자열 표현입니다. 예: 2013-03-20T17:03:43.221Z

ExpirationDate

프로비저닝된 용량 단위가 만료되는 날짜(UTC)입니다.

유형: 문자열. ISO 8601 날짜 형식의 문자열 표현입니다. 예: 2013-03-20T17:03:43.221Z

오류

Amazon S3 Glacier의 예외 및 오류 메시지에 대한 자세한 내용은 오류 응답를 참조하세요.

예시

다음은 계정에 프로비저닝된 용량 단위를 나열하는 예제입니다.

예 요청

이번 예제에서는 GET 요청을 전송하여 지정된 계정에 프로비저닝된 용량 단위 목록을 가져옵니다.

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

응답의 예

요청이 성공하면 Amazon S3 Glacier(S3 Glacier)가 다음 예제와 같이 계정에 프로비저닝된 용량 단위 목록과 함께 HTTP 200 OK를 반환합니다.

처음에 나열된 프로비저닝된 용량 유닛은 시작 날짜가 2017년 1월 31일이고 만료 날짜가 2017년 2월 28일인 유닛의 예입니다. 앞서 설명한 대로, 시작 날짜가 31일인 경우에는 만료 날짜는 다음 달 말일이 됩니다.

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" ",
      },
      ...
}

관련 단원

• 프로비저닝된 용량 구매(POST provisioned-capacity)