볼트 만들기(PUT 값) - Amazon S3 Glacier
설명요청응답예시관련 단원참고

이 페이지는 저장소와 2012년 원래 REST API를 사용하는 S3 Glacier 서비스의 기존 고객만 사용할 수 있습니다.

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

볼트 만들기(PUT 값)

설명

이 작업은 지정한 이름으로 새로운 볼트를 생성합니다.   볼트 이름은 AWS 계정에 속하는 AWS 리전 내에서 반드시 고유해야 합니다. 계정 1개에서 최대 1,000개까지 볼트를 생성할 수 있습니다. 더 많은 볼트 생성을 위한 자세한 정보는 Amazon S3 Glacier 제품 세부 정보 페이지를 참조하세요.

볼트 이름을 지정할 때는 다음 지침을 따라야 합니다.

  • 이름에 포함되는 문자 길이는 1~255자입니다.

  • 유효한 문자는 A~Z, a~z, 0~9, ‘-’(하이픈), ‘_’(밑줄), ‘.’(마침표)입니다.

이 작업은 멱등성을 갖기 때문에 동일한 요청을 여러 차례 전송할 수 있으며, Amazon S3 Glacier(S3 Glacier)가 지정한 볼트를 처음 생성한 이후부터는 추가적인 영향을 미치지 않습니다.

요청

구문

볼트 생성을 위해 HTTP PUT 요청을 생성할 볼트의 URI로 전송합니다.

PUT /AccountId/vaults/VaultName HTTP/1.1
Host: glacier.Region.amazonaws.com
Date: Date
Authorization: SignatureValue
Content-Length: Length
x-amz-glacier-version: 2012-06-01

참고

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

요청 파라미터

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

요청 헤더

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

요청 본문

이 작업의 요청 본문은 비어 있어야 합니다(0바이트).

응답

구문

HTTP/1.1 201 Created
x-amzn-RequestId: x-amzn-RequestId
Date: Date
Location: Location

응답 헤더

성공적인 응답에는 모든 작업에 일반적인 응답 헤더 외에 다음 응답 헤더가 포함됩니다. 일반적인 응답 헤더에 대한 자세한 내용은 공통 응답 헤더 단원을 참조하십시오.

명칭 설명

Location

생성된 볼트의 상대적 URI 경로입니다.

유형: 문자열

응답 본문

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

Errors

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

예시

요청 예시

다음은 HTTP PUT 요청을 전송하여 examplevault라는 이름의 볼트를 생성하는 예제입니다.

PUT /-/vaults/examplevault HTTP/1.1
Host: glacier.us-west-2.amazonaws.com
x-amz-Date: 20170210T120000Z
x-amz-glacier-version: 2012-06-01
Content-Length: 0
Authorization: AWS4-HMAC-SHA256 Credential=AKIAIOSFODNN7EXAMPLE/20141123/us-west-2/glacier/aws4_request,SignedHeaders=host;x-amz-date;x-amz-glacier-version,Signature=9257c16da6b25a715ce900a5b45b03da0447acf430195dcb540091b12966f2a2

응답의 예

S3 Glacier가 볼트를 생성하고, Location 헤더에 볼트의 상대적 URI 경로를 반환합니다. 계정 ID는 요청에서 계정 ID 또는 하이픈('Location') 지정 여부에 상관없이 항상 - 헤더에 표시됩니다.

HTTP/1.1 201 Created
x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q
Date: Wed, 10 Feb 2017 12:02:00 GMT
Location: /111122223333/vaults/examplevault

참고

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