이 페이지는 볼트와 2012년부터 원래 REST API를 사용하는 Amazon Glacier 서비스의 기존 고객만 사용할 수 있습니다.
아카이브 스토리지 솔루션을 찾고 있다면 Amazon S3의 Amazon Glacier 스토리지 클래스, S3 Glacier Instant Retrieval, S3 Glacier Flexible Retrieval 및 S3 Glacier Deep Archive를 사용하는 것이 좋습니다. 이러한 스토리지 옵션에 대한 자세한 내용은 Amazon Glacier 스토리지 클래스
Amazon Glacier(기존 독립 실행형 볼트 기반 서비스)는 2025년 12월 15일부터 기존 고객에게 영향을 주지 않고 더 이상 신규 고객을 받지 않습니다. Amazon Glacier는 데이터를 볼트에 저장하고 Amazon S3 및 Amazon S3 Glacier 스토리지 클래스와 구별되는 자체 API를 갖춘 독립 실행형 서비스입니다. 기존 데이터는 Amazon Glacier에서 무기한으로 안전하게 보관되며 액세스 가능합니다. 마이그레이션은 필요하지 않습니다. 저비용 장기 아카이브 스토리지의 경우, AWS에서는 S3 버킷 기반 API, 전체 AWS 리전 가용성, 저렴한 비용 및 AWS 서비스 통합을 통해 우수한 고객 경험을 제공하는 Amazon S3 Glacier 스토리지 클래스
볼트 액세스 정책 설정(PUT access-policy)
설명
이 작업에서는 볼트 액세스 정책을 구성하여 기존 정책을 덮어씁니다. 볼트 액세스 정책을 구성하려면 PUT 요청을 볼트의 access-policy 하위 리소스에 전송합니다. 볼트마다 액세스 정책 1개를 설정할 수 있으며, 정책 크기는 최대 20KB로 제한됩니다. 볼트 액세스 정책에 대한 자세한 내용은 볼트 액세스 정책 섹션을 참조하세요.
요청
구문
볼트 액세스 정책을 설정하려면 다음 구문 예제와 같이 HTTP PUT 요청을 볼트의 access-policy 하위 리소스 URI로 전송합니다.
PUT /AccountId/vaults/vaultName/access-policy HTTP/1.1 Host: glacier.Region.amazonaws.com Date:DateAuthorization:SignatureValueContent-Length:Lengthx-amz-glacier-version: 2012-06-01 { "Policy": "string" }
참고
AccountId 값은 볼트를 소유한 계정의 AWS 계정 ID입니다. AWS 계정 ID 또는 선택적으로 하나의 '-'(하이픈)을 지정할 수 있습니다. 이 경우에 Amazon Glacier는 요청 서명에 사용된 자격 증명과 연결된 AWS 계정 ID를 사용합니다. 계정 ID를 사용하는 경우 ID에 하이픈('-')을 포함할 수 없습니다.
요청 파라미터
이 작업은 요청 파라미터를 사용하지 않습니다.
요청 헤더
이 작업은 모든 작업에 일반적인 요청 헤더만 사용합니다. 일반적인 요청 헤더에 대한 내용은 공통 요청 헤더 섹션을 참조하세요.
요청 본문
요청 본문의 JSON에 포함되는 필드는 다음과 같습니다.
- 정책
-
JSON 문자열 형식의 볼트 액세스 정책으로서 "\"를 이스케이프 문자로 사용합니다.
유형: 문자열
필수 항목 여부: 예
응답
정책이 허용되면 Amazon Glacier가 응답으로 204 No Content를 반환합니다.
구문
HTTP/1.1 204 No Content x-amzn-RequestId: x-amzn-RequestId Date: Date
응답 헤더
이 작업은 대부분의 응답에 일반적인 응답 헤더만 사용합니다. 일반적인 응답 헤더에 대한 내용은 공통 응답 헤더 섹션을 참조하세요.
응답 본문
이 작업은 응답 본문을 반환하지 않습니다.
오류
Amazon Glacier 예외 및 오류 메시지에 대한 자세한 내용은 오류 응답 섹션을 참조하세요.
예시
요청 예시
다음은 HTTP PUT 요청을 볼트의 access-policy 하위 리소스 URI로 전송하는 예제입니다. Policy JSON 문자열은 이스케이프 문자로 "\"를 사용합니다.
PUT /-/vaults/examplevault/access-policy HTTP/1.1 Host: glacier.us-west-2.amazonaws.com x-amz-Date: 20170210T120000Z Authorization: AWS4-HMAC-SHA256 Credential=AKIAIOSFODNN7EXAMPLE/20141123/us-west-2/glacier/aws4_request,SignedHeaders=host;x-amz-date;x-amz-glacier-version,Signature=9257c16da6b25a715ce900a5b45b03da0447acf430195dcb540091b12966f2a2 Content-Length: length x-amz-glacier-version: 2012-06-01 {"Policy":"{\"Version\":\"2012-10-17\", \"Statement\":[{\"Sid\":\"Define-owner-access-rights\",\"Effect\":\"Allow\",\"Principal\":{\"AWS\":\"arn:aws:iam::999999999999:root\"},\"Action\":\"glacier:DeleteArchive\",\"Resource\":\"arn:aws:glacier:us-west-2:999999999999:vaults/examplevault\"}]}"}
응답의 예
요청이 성공하면 Amazon Glacier(Amazon Glacier)가 다음 예시와 같이 HTTP 204 No Content를 반환합니다.
HTTP/1.1 204 No Content x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q Date: Wed, 10 Feb 2017 12:02:00 GMT
관련 섹션
참고
언어 특정 Amazon SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하세요.
