이 페이지는 볼트와 2012년의 원래 REST API를 사용하는 Amazon Glacier 서비스의 기존 고객에게만 해당됩니다.
아카이브 스토리지 솔루션을 찾고 있다면 Amazon Glacier Amazon S3, S3 Glacier Flexible Retrieval 및 S3S3 Glacier Deep Archive의 Amazon Glacier 스토리지 클래스를 사용하는 것이 좋습니다. 이러한 스토리지 옵션에 대한 자세한 내용은 Amazon Glacier 스토리지 클래스
Amazon Glacier(기존 독립 실행형 볼트 기반 서비스)는 2025년 12월 15일부터 기존 고객에게 영향을 주지 않고 더 이상 신규 고객을 받지 않습니다. Amazon Glacier는 데이터를 볼트에 저장하고 Amazon S3 및 Amazon S3 Glacier 스토리지 클래스와 구별되는 자체 APIs가 있는 독립 실행형 서비스입니다. 기존 데이터는 Amazon Glacier에서 무기한으로 안전하고 액세스할 수 있습니다. 마이그레이션이 필요하지 않습니다. 저비용 장기 아카이브 스토리지의 경우는 S3 버킷 기반 API, 전체 가용성, 저렴한 비용 및 서비스 통합을 통해 우수한 고객 경험을 제공하는 Amazon S3 Glacier 스토리지 클래스
기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
볼트 알림 구성 설정(PUT notification-configuration)
설명
아카이브 및 볼트 인벤토리 검색은 Amazon Glacier(Amazon Glacier)에서 비동기 작업으로, 먼저 작업을 시작하고 작업이 완료될 때까지 기다려야 작업 출력을 다운로드할 수 있습니다. 작업이 완료되었을 때 알림 메시지를 Amazon Simple Notification Service(SNS) 토픽에 게시하도록 볼트를 구성할 수 있습니다. 이번 작업으로 볼트에 대한 알림 구성 설정이 가능합니다. 자세한 내용은 Amazon Glacier에서 볼트 알림 구성 단원을 참조하십시오.
알림 구성을 설정하려면 PUT 요청을 볼트의 notification-configuration 하위 리소스에 전송합니다. 알림 구성은 볼트에 따라 다르기 때문에 볼트 하위 리소스라고 불리기도 합니다. 요청에는 Amazon Simple Notification Service(Amazon SNS) 주제와 Amazon Glacier가 주제에 알림을 보내도록 하려는 이벤트를 제공하는 JSON 문서가 포함되어야 합니다.
알림 메시지를 게시하도록 볼트를 구성할 수 있는 이벤트는 다음과 같습니다.
-
ArchiveRetrievalCompleted: 이 이벤트는 아카이브 검색으로 시작된 작업이 완료되었을 때 발생합니다(작업 시작(POST jobs)). 완료된 작업은 상태가Succeeded또는Failed가 될 수 있습니다. SNS 주제로 전송되는 알림 메시지는 작업 설명(GET JobID)에서 반환되는 출력과 동일합니다. -
InventoryRetrievalCompleted: 이 이벤트는 인벤토리 검색으로 시작된 작업이 완료되었을 때 발생합니다(작업 시작(POST jobs)). 완료된 작업은 상태가Succeeded또는Failed가 될 수 있습니다. SNS 주제로 전송되는 알림 메시지는 작업 설명(GET JobID)에서 반환되는 출력과 동일합니다.
Amazon SNS 토픽은 알림 메시지를 해당 토픽 게시할 수 있도록 반드시 볼트에 권한을 부여해야 합니다.
요청
볼트에 대한 알림 구성을 설정하려면 PUT 요청을 볼트의 notification-configuration 하위 리소스 URI로 전송합니다. 구성은 요청 본문에서 지정하며, Amazon SNS 토픽 이름을 비롯해 각 토픽으로 알림 메시지를 트리거하는 이벤트들의 배열이 포함됩니다.
구문
PUT /AccountId/vaults/VaultName/notification-configuration HTTP/1.1 Host: glacier.Region.amazonaws.com Date:DateAuthorization:SignatureValuex-amz-glacier-version: 2012-06-01 { "SNSTopic":String, "Events":[String, ...] }
참고
AccountId 값은 볼트를 소유한 계정의 AWS 계정 ID입니다. AWS 계정 ID를 지정하거나 선택적으로 단일 '-'(하이픈)를 지정할 수 있습니다.이 경우 Amazon Glacier는 요청에 서명하는 데 사용되는 자격 증명과 연결된 AWS 계정 ID를 사용합니다. 계정 ID를 사용하는 경우 ID에 하이픈('-')을 포함할 수 없습니다.
요청 파라미터
이 작업은 요청 파라미터를 사용하지 않습니다.
요청 헤더
이 작업은 모든 작업에 일반적인 요청 헤더만 사용합니다. 일반적인 요청 헤더에 대한 내용은 공통 요청 헤더 섹션을 참조하세요.
요청 본문
요청 본문의 JSON에 포함되는 필드는 다음과 같습니다.
- 이벤트
-
Amazon Glacier가 알림을 보내도록 하려는 하나 이상의 이벤트 배열입니다.
유효한 값:
ArchiveRetrievalCompleted|InventoryRetrievalCompleted필수 항목 여부: 예
유형: 배열
- SNSTopic
-
Amazon SNS 토픽 ARN입니다. 자세한 내용은 Amazon Simple Notification Service 시작 가이드의 Amazon SNS 시작하기를 참조하세요.
필수 항목 여부: 예
유형: 문자열
응답
이에 대한 응답으로 알림 구성이 수락204 No Content되면 Amazon Glacier(Amazon Glacier)가를 반환합니다.
구문
HTTP/1.1 204 No Content x-amzn-RequestId: x-amzn-RequestId Date: Date
응답 헤더
이 작업은 모든 작업에 일반적인 요청 헤더만 사용합니다. 일반적인 요청 헤더에 대한 내용은 공통 요청 헤더 섹션을 참조하세요.
응답 본문
이 작업은 응답 본문을 반환하지 않습니다.
오류
Amazon Glacier 예외 및 오류 메시지에 대한 자세한 내용은 섹션을 참조하세요오류 응답.
예시
다음은 볼트 알림 구성 방법을 설명한 예제입니다.
요청 예시
다음 요청은 examplevault 알림 구성을 설정하여 두 개의 이벤트(ArchiveRetrievalCompleted와 InventoryRetrievalCompleted) 알림이 Amazon SNS 토픽 arn:aws:sns:us-west-2:012345678901:mytopic으로 전송되게 합니다.
PUT /-/vaults/examplevault/notification-policy 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 { "Events": ["ArchiveRetrievalCompleted", "InventoryRetrievalCompleted"], "SNSTopic": "arn:aws:sns:us-west-2:012345678901:mytopic" }
응답의 예
요청이 성공하면 응답으로 204 No Content가 반환됩니다.
HTTP/1.1 204 No Content x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q Date: Wed, 10 Feb 2017 12:00:00 GMT
관련 단원
참고
언어 특정 Amazon SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하세요.
