볼트 알림 가져오기(GET notification-configuration) - Amazon S3 Glacier
설명요청응답예시관련 단원참고 항목

이 페이지는 Vaults와 2012RESTAPI년의 원본을 사용하는 S3 Glacier 서비스의 기존 고객만 사용할 수 있습니다.

아카이브 스토리지 솔루션을 찾고 있다면 Amazon S3, S3 Glacier Instant Retrieval , S33 S3 Glacier Flexible Retrieval 및 S3 Glacier Deep Archive 의 S3 Glacier 스토리지 클래스를 사용하는 것이 좋습니다. Amazon S3 이러한 스토리지 옵션에 대한 자세한 내용은 Amazon S3 사용 설명서의 S3 Glacier 스토리지 클래스 및 S3 Glacier 스토리지 클래스를 사용하는 장기 데이터 스토리지를 참조하세요. Amazon S3 이러한 스토리지 클래스는 Amazon S3 를 사용하며API, 모든 리전에서 사용할 수 있고, Amazon S3 콘솔 내에서 관리할 수 있습니다. 스토리지 비용 분석, 스토리지 렌즈, 고급 선택적 암호화 기능 등과 같은 기능을 제공합니다.

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

볼트 알림 가져오기(GET notification-configuration)

설명

이번 작업에서는 볼트에 설정되어 있는 notification-configuration 하위 리소스를 가져옵니다(볼트 알림 구성 설정(PUT notification-configuration) 참조). 볼트에 알림 구성이 설정되어 있지 않으면 404 Not Found 오류가 반환됩니다. 볼트 알림에 대한 자세한 내용은 Amazon S3 Glacier의 볼트 알림 구성 단원을 참조하십시오.

요청

알림 구성 정보를 가져오려면 GET 요청을 볼트의 notification-configuration 하위 리소스 URI로 전송합니다.

조건

GET /AccountId/vaults/VaultName/notification-configuration 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
{
  "Events": [
    String,
    ...
  ],
  "SNSTopic": String
}

응답 헤더

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

응답 본문

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

이벤트

Amazon S3 Glacier(S3 Glacier)가 지정된 Amazon SNS 토픽으로 알림 메시지를 보내게 되는 하나 이상의 이벤트로 이루어진 목록입니다. 볼트를 구성할 때 알림 메시지를 게시하게 되는 볼트 이벤트에 대한 자세한 내용은 볼트 알림 구성 설정(PUT notification-configuration) 단원을 참조하십시오.

유형: 배열

SNSTopic

Amazon Simple Notification Service(SNS) 토픽의 Amazon 리소스 이름(ARN)입니다. 자세한 내용은 Amazon Simple Notification Service 시작 가이드의 Amazon SNS 시작하기를 참조하세요.

유형: 문자열

오류

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

예시

다음은 볼트에 설정된 알림 구성을 가져오는 방법을 설명한 예제입니다.

예 요청

이번 예제에서는 GET 요청이 볼트의 notification-configuration 하위 리소스로 전송됩니다.

GET /-/vaults/examplevault/notification-configuration 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

응답의 예

응답이 성공적으로 반환되면 감사 로깅 구성 문서가 응답 본문에 JSON 형식으로 표시됩니다. 이번 예시에서는 구성에 따라 두 가지 이벤트(ArchiveRetrievalCompleted와 InventoryRetrievalCompleted)에 대한 알림 메시지가 Amazon SNS 토픽 arn:aws:sns:us-west-2:012345678901:mytopic으로 전송되는 것을 보여줍니다.

HTTP/1.1 200 OK
x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q
Date: Wed, 10 Feb 2017 12:00:00 GMT
Content-Type: application/json
Content-Length: 150
  
{
  "Events": [
    "ArchiveRetrievalCompleted",
    "InventoryRetrievalCompleted"
  ],
  "SNSTopic": "arn:aws:sns:us-west-2:012345678901:mytopic"
}

참고 항목

언어 특정 Amazon SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하세요.