데이터 가져오기 정책 설정(PUT policy) - Amazon Glacier

이 페이지는 볼트와 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(기존 독립 실행형 볼트 기반 서비스)는 더 이상 신규 고객을 받지 않습니다. Amazon Glacier는 데이터를 볼트에 저장하고 Amazon S3 및 Amazon S3 Glacier 스토리지 클래스와 구별되는 자체 API를 갖춘 독립 실행형 서비스입니다. 기존 데이터는 Amazon Glacier에서 무기한으로 안전하게 보관되며 액세스 가능합니다. 마이그레이션은 필요하지 않습니다. 저비용 장기 아카이브 스토리지의 경우는 S3 버킷 기반 API, 전체 가용성, 저렴한 비용 및 서비스 통합을 통해 우수한 고객 경험을 제공하는 Amazon S3 Glacier 스토리지 클래스를 AWS 권장합니다. S3 APIs AWS 리전 AWS 향상된 기능을 원하는 경우 Amazon Glacier 볼트에서 Amazon S3 Glacier 스토리지 클래스로 데이터를 전송하기 위한AWS 솔루션 지침을 사용하여 Amazon S3 Glacier 스토리지 클래스로 마이그레이션하는 것이 좋습니다.

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

데이터 가져오기 정책 설정(PUT policy)

설명

이번 작업에서는 PUT 요청 시 지정한 AWS 리전의 데이터 검색 정책을 설정한 후 규정합니다. 정책은 AWS 계정의 AWS 리전당 하나씩 설정할 수 있습니다. PUT 요청이 성공하면 몇 분 이내에 정책이 규정됩니다.

하지만 정책이 규정되기 전에는 정책 설정 작업이 진행 중인 가져오기 작업에 적용되지 않습니다. 데이터 가져오기 정책에 대한 자세한 내용은 Amazon Glacier 데이터 검색 정책 섹션을 참조하세요.

요청

구문

데이터 가져오기 정책을 설정하려면 다음 구문 예제와 같이 HTTP PUT 요청을 데이터 가져오기 정책 URI로 전송합니다.

PUT /AccountId/policies/data-retrieval HTTP/1.1 Host: glacier.Region.amazonaws.com Date: Date Authorization: SignatureValue Content-Length: Length x-amz-glacier-version: 2012-06-01 { "Policy": { "Rules":[ { "Strategy": String, "BytesPerHour": Number } ] } }

참고

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

요청 파라미터

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

요청 헤더

이 작업은 모든 작업에 일반적인 요청 헤더만 사용합니다. 일반적인 요청 헤더에 대한 내용은 공통 요청 헤더 섹션을 참조하세요.

요청 본문

요청 본문의 JSON에 포함되는 필드는 다음과 같습니다.

BytesPerHour

한 시간이 가져올 수 있는 최대 바이트 수입니다.

이 필드는 Strategy 필드 값이 BytesPerHour인 경우에만 필요합니다. Strategy 필드가 BytesPerHour로 설정되어 있지 않은 상태에서 이 필드를 설정하면 PUT 작업이 거부됩니다.

유형: 숫자

필수 항목 여부: Strategy 필드가 BytesPerHour로 설정되어 있는 경우 예이고, 그렇지 않으면 아니요입니다.

유효한 값: 최소 정수 값 1. 최대 정수 값 2^63 - 1 포함

Rules

정책 규칙입니다. 이 규칙이 목록 유형이지만 현재는 Strategy 필드와 BytesPerHour 필드(옵션)로 구성된 규칙 하나만 있어야 합니다.

유형: 배열

필수 항목 여부: 예

Strategy

설정할 데이터 가져오기 정책의 유형입니다.

유형: 문자열

필수 항목 여부: 예

유효한 값: BytesPerHour|FreeTier|None. BytesPerHour는 콘솔에서 최대 가져오기 속도를 선택하는 것과 동일합니다. FreeTier는 콘솔에서 프리 티어만을 선택하는 것과 동일합니다. None은 콘솔에서 가져오기 정책 없음을 선택하는 것과 동일합니다. 콘솔에서 데이터 가져오기 정책을 선택하는 것에 대한 자세한 내용은 Amazon Glacier 데이터 검색 정책 섹션을 참조하세요.

응답

구문

HTTP/1.1 204 No Content x-amzn-RequestId: x-amzn-RequestId Date: Date

응답 헤더

이 작업은 대부분의 응답에 일반적인 응답 헤더만 사용합니다. 일반적인 응답 헤더에 대한 내용은 공통 응답 헤더 섹션을 참조하세요.

응답 본문

이 작업은 응답 본문을 반환하지 않습니다.

오류

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

예시

요청 예시

다음은 Strategy 필드가 BytesPerHour로 설정되어 있을 때 HTTP PUT 요청을 전송하는 예제입니다.

PUT /-/policies/data-retrieval 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 { "Policy": { "Rules":[ { "Strategy":"BytesPerHour", "BytesPerHour":10737418240 } ] } }

다음은 Strategy 필드가 FreeTier로 설정되어 있을 때 HTTP PUT 요청을 전송하는 예제입니다.

PUT /-/policies/data-retrieval 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 { "Policy": { "Rules":[ { "Strategy":"FreeTier" } ] } }

다음은 Strategy 필드가 None으로 설정되어 있을 때 HTTP PUT 요청을 전송하는 예제입니다.

PUT /-/policies/data-retrieval 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 { "Policy": { "Rules":[ { "Strategy":"None" } ] } }

응답의 예

요청이 성공하면 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