객체 스토리지 클래스 변경

이 페이지에서는 객체 덮어쓰기를 통해 버킷 내 객체의 스토리지 클래스를 변경하는 방법을 설명합니다. 객체를 덮어쓰지 않고 객체 스토리지 클래스를 변경하는 방법을 알아보려면 객체 수명 주기 관리 기능을 참조하세요.

Console

Console을 통해서는 개별 객체 스토리지 클래스를 설정할 수 없습니다. 대신 gsutil을 사용하세요.

gsutil

rewrite 명령어에 -s 플래그를 사용합니다. 예를 들면 다음과 같습니다.

gsutil rewrite -s [STORAGE_CLASS] gs://[PATH_TO_OBJECT]

각 항목의 의미는 다음과 같습니다.

• [STORAGE_CLASS]는 객체의 새로운 스토리지 클래스입니다. 예를 들면 nearline입니다.
• [PATH_TO_OBJECT]는 클래스를 변경할 객체의 이름입니다. 예를 들면 pets/dog.png입니다.

REST API

JSON API

주의: 원본 객체에서 유지하려는 ACL은 요청 본문에 제공하는 객체 리소스에 포함되어야 합니다.

1. OAuth 2.0 Playground에서 승인 액세스 토큰을 가져옵니다. Playground에서 OAuth 사용자 인증 정보를 사용하도록 구성합니다.

2. 다음 정보를 포함하는 .json 파일을 만듭니다.

   {
     "storageClass": "[STORAGE_CLASS]"
   }

   각 항목의 의미는 다음과 같습니다.

   • [STORAGE_CLASS]는 객체의 새로운 스토리지 클래스입니다. 예를 들면 nearline입니다.

3. cURL을 사용하여 POST 객체 요청으로 JSON API를 호출합니다.

   curl -X POST --data-binary @[JSON_FILE_NAME].json \
     -H "Authorization: Bearer [OAUTH2_TOKEN]" \
     -H "Content-Type: application/json" \
     "https://www.googleapis.com/storage/v1/b/[BUCKET_NAME]/o/[OBJECT_NAME]/rewriteTo/b/[BUCKET_NAME]/o/[OBJECT_NAME]"

   각 항목의 의미는 다음과 같습니다.

   • [JSON_FILE_NAME]은 2단계에서 만든 JSON 파일의 이름입니다.
   • [OAUTH2_TOKEN]은 1단계에서 생성한 액세스 토큰입니다.
   • [BUCKET_NAME]은 원본 객체를 포함하는 버킷의 이름입니다. 예를 들면 my-bucket입니다.
   • [OBJECT_NAME]은 객체의 이름입니다. 예를 들면 pets/dog.png입니다.

XML API

주의: 원본 객체에서 유지하려는 메타데이터(예: 커스텀 메타데이터)는 요청에 제공되는 헤더에 포함되어야 합니다. 또한 포함 버킷의 기본 객체 ACL과 다른 객체의 ACL은 객체를 업로드한 후에 다시 적용해야 합니다.

1. OAuth 2.0 Playground에서 승인 액세스 토큰을 가져옵니다. OAuth 사용자 인증 정보를 사용하도록 Playground를 구성합니다.

2. cURL을 사용하여 PUT Object 요청으로 XML API를 호출합니다.

   curl -X PUT --data-binary @[OBJECT] \
     -H "Authorization: Bearer [OAUTH2_TOKEN]" \
     -H "Content-Type: [OBJECT_CONTENT_TYPE]" \
     -H "x-goog-storage-class: [STORAGE_CLASS]" \
     "https://storage.googleapis.com/[BUCKET_NAME]/[OBJECT_NAME]"

   각 항목의 의미는 다음과 같습니다.

   • [OBJECT]는 스토리지 클래스를 변경할 객체의 로컬 경로입니다(XML API를 사용하여 스토리지 클래스를 변경할 때 이 객체를 다시 업로드해야 함). 예를 들면 Desktop/dog.png입니다.
   • [OAUTH2_TOKEN]은 1단계에서 생성한 액세스 토큰입니다.
   • [OBJECT_CONTENT_TYPE]은 객체의 콘텐츠 유형입니다. 예를 들면 image/png입니다.
   • [STORAGE_CLASS]는 객체의 새로운 스토리지 클래스입니다. 예를 들면 nearline입니다.
   • [BUCKET_NAME]은 덮어쓰려는 객체가 포함된 버킷의 이름입니다. 예를 들면 my-bucket입니다.
   • [OBJECT_NAME]은 덮어쓰려는 객체의 이름입니다. 예를 들면 pets/dog.png입니다.

참고: 이 가이드에는 데이터 덮어쓰기가 포함됩니다. 데이터가 원래 Nearline Storage 또는 Coldline Storage로 저장된 경우 가져오기 및 조기 삭제 수수료가 부과될 수 있습니다. 또한 버킷에 객체 버전 관리를 사용 설정한 경우에는 원본 객체가 명시적으로 삭제될 때까지 버킷에 남아 있습니다.