객체 저장소 등급 변경하기

이 페이지에서는 객체 덮어쓰기를 통해 버킷 내 객체의 저장소 등급을 변경하는 방법을 설명합니다. 객체를 덮어쓰지 않고 객체 저장소 등급을 변경하는 방법을 알아보려면 객체 수명 주기 관리 기능을 참조하세요. 객체별 저장소 등급에 대해 자세히 알아보려면 객체별 장소 등급을 참조하세요.

콘솔

콘솔을 통해서는 개별 객체 저장소 등급을 설정할 수 없습니다. 대신 gsutil을 사용하세요.

gsutil

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

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

여기에서 [STORAGE_CLASS]는 객체의 새 저장소 등급이고, [PATH_TO_OBJECT]는 등급을 변경 중인 객체의 이름입니다.

REST API

JSON API

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

1. OAuth 2.0 Playground에서 승인 액세스 토큰을 가져옵니다. Playground에서 OAuth 사용자 인증 정보를 사용하도록 구성합니다.
2. 다음 정보를 포함하는 .json 파일을 만듭니다. 여기서 [VALUES_IN_BRACKETS]를 적절한 값으로 바꿉니다.

{
"storageClass": "[STORAGE_CLASS]"
}

3. cURL을 사용하여 JSON API를 호출합니다. 여기서 [VALUES_IN_BRACKETS]를 적절한 값으로 바꿉니다.

   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]"

XML API

주의: ACL 및 맞춤 메타데이터와 같이 원본 객체에서 유지하려는 메타데이터는 요청 본문에서 제공하는 객체 리소스에 포함시켜야 합니다. 또한 포함하는 객체의 기본 객체 ACL과 다른 객체의 ACL은 객체 업로드 후 다시 적용해야 합니다.

1. OAuth 2.0 Playground에서 승인 액세스 토큰을 가져옵니다. OAuth 사용자 인증 정보를 사용하도록 Playground를 구성합니다.
2. 저장소 등급 변경이 필요한 객체를 요청에 포함시킵니다. XML API를 사용하여 저장소 등급을 변경하면 객체를 다시 업로드해야 합니다.
3. cURL을 사용하여 XML API를 호출합니다. 여기서 [VALUES_IN_BRACKETS]를 적절한 값으로 바꿉니다.

   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]"

자세한 내용은 객체 저장소 등급 설정 페이지를 참조하세요.

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