이 페이지는 Vaults를 사용하는 S3 Glacier 서비스의 기존 고객과 2012년의 원본을 사용할 수 있습니다. REST API
아카이브 스토리지 솔루션을 찾고 있다면 Amazon S3의 S3 Glacier 스토리지 클래스, S3 Glacier 인스턴트 검색, S3 Glacier 플렉서블 검색 및 S3 Glacier Deep Archive를 사용하는 것이 좋습니다. 이러한 스토리지 옵션에 대한 자세한 내용은 Amazon S3 사용 설명서의 S3 Glacier 스토리지 클래스
기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
볼트 설명(GET vault)
설명
이번 작업에서는 볼트의 Amazon 리소스 이름(ARN), 볼트 생성 날짜, 볼트에 저장된 아카이브 수, 볼트에 저장된 모든 아카이브의 총 크기 등 볼트에 대한 정보를 반환합니다. 아카이브의 수와 총 크기는 Amazon S3 Glacier(S3 Glacier)가 마지막으로 생성한 볼트 인벤토리를 기준으로 합니다(Amazon S3 Glacier 볼트 작업 참조). S3 Glacier는 거의 매일 볼트 인벤토리를 생성합니다. 이 말은 아카이브를 볼트에 추가하거나 삭제한 직후에 볼트 설명 요청을 전송하더라도 응답에 변경 내용이 반영되지 않을 수도 있다는 것을 말합니다.
요청
볼트 정보를 가져오려면 GET
요청을 특정 볼트 리소스의 URI로 전송합니다.
조건
GET /
AccountId
/vaults/VaultName
HTTP/1.1 Host: glacier.Region
.amazonaws.com Date:Date
Authorization:SignatureValue
x-amz-glacier-version: 2012-06-01
참고
AccountId
값은 볼트를 소유한 계정의 AWS 계정 ID입니다. AWS 계정 ID 또는 선택적으로 하나의 '-
'(하이픈)을 지정할 수 있습니다. 이 경우에 Amazon S3 Glacier는 요청 서명에 사용된 보안 인증 정보와 연결된 AWS 계정 ID를 사용합니다. 계정 ID를 사용하는 경우 ID에 하이픈('-')을 포함할 수 없습니다.
요청 파라미터
이 작업은 요청 파라미터를 사용하지 않습니다.
요청 헤더
이 작업은 모든 작업에 일반적인 요청 헤더만 사용합니다. 일반적인 요청 헤더에 대한 내용은 공통 요청 헤더 단원을 참조하십시오.
요청 본문
이 작업에는 요청 본문이 없습니다.
응답
조건
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 }
응답 헤더
이 작업은 대부분의 응답에 일반적인 응답 헤더만 사용합니다. 일반적인 응답 헤더에 대한 내용은 공통 응답 헤더 단원을 참조하십시오.
응답 본문
JSON 응답 본문에는 다음과 같은 JSON 필드가 포함됩니다.
- CreationDate
-
볼트가 생성된 UTC 날짜입니다.
유형: ISO 8601 날짜 형식의 문자열 표현입니다. 예:
2013-03-20T17:03:43.221Z
- LastInventoryDate
-
S3 Glacier가 마지막 볼트 인벤토리를 완료한 UTC 날짜입니다. 볼트 인벤토리의 시작에 대한 자세한 내용은 작업 시작 (POST작업) 단원을 참조하십시오.
유형: ISO 8601 날짜 형식의 문자열 표현입니다. 예:
2013-03-20T17:03:43.221Z
- NumberOfArchives
-
마지막 볼트 인벤토리를 기준으로 볼트에 저장된 아카이브 수입니다. 인벤토리가 아직 볼트에서 실행되지 않은 경우, 예를 들어 볼트를 방금 생성하였다면 이 필드는 null 값을 반환합니다.
형식: 숫자
- SizeInBytes
-
마지막 인벤토리 날짜를 기준으로 아카이브별 오버헤드를 포함하여 볼트에 저장된 아카이브의 총 크기(바이트)입니다. 인벤토리가 아직 볼트에서 실행되지 않은 경우, 예를 들어 볼트를 방금 생성하였다면 이 필드는
null
값을 반환합니다.형식: 숫자
- VaultARN
-
볼트의 Amazon 리소스 이름(ARN)입니다.
유형: 문자열
- VaultName
-
생성 시 지정한 볼트 이름입니다. 볼트 이름은 볼트의 ARN에도 포함됩니다.
유형: 문자열
오류
Amazon S3 Glacier의 예외 및 오류 메시지에 대한 자세한 내용은 오류 응답를 참조하세요.
예시
예 요청
다음은 이름이 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
응답의 예
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" }
관련 단원
참고 항목
언어특정 Amazon SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하세요.