객체 스토리지 클래스 변경

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

기본 요건

기본 요건은 사용되는 도구에 따라 다를 수 있습니다.

콘솔

Google Cloud Console을 통해 개별 객체 스토리지 클래스를 설정할 수 없습니다. 대신 명령줄을 사용합니다.

명령줄

명령줄 유틸리티를 사용하여 이 가이드를 완료하려면 적절한 IAM 권한이 있어야 합니다. 액세스하려는 객체가 사용자가 만들지 않은 프로젝트에 존재할 경우 프로젝트 소유자가 필요한 권한이 포함된 역할을 사용자에게 제공해야 할 수 있습니다.

특정 작업에 필요한 권한 목록은 gsutil 명령어에 대한 IAM 권한을 참조하세요.

관련 역할 목록은 Cloud Storage 역할을 참조하세요. 또는 특별히 제한된 권한이 있는 커스텀 역할을 만들 수 있습니다.

코드 샘플

Cloud Storage 클라이언트 라이브러리를 사용하여 이 가이드를 완료하려면 적절한 IAM 권한이 있어야 합니다. 액세스하려는 객체가 사용자가 만들지 않은 프로젝트에 존재할 경우 프로젝트 소유자가 필요한 권한이 포함된 역할을 사용자에게 제공해야 할 수 있습니다. 달리 명시되지 않는 한 클라이언트 라이브러리 요청은 JSON API를 통해 수행됩니다.

특정 작업에 필요한 권한 목록은 JSON 메서드에 대한 IAM 권한을 참조하세요.

관련 역할 목록은 Cloud Storage 역할을 참조하세요. 또는 특별히 제한된 권한이 있는 커스텀 역할을 만들 수 있습니다.

REST API

JSON API

JSON API를 사용하여 이 가이드를 완료하려면 적절한 IAM 권한이 있어야 합니다. 액세스하려는 객체가 사용자가 만들지 않은 프로젝트에 존재할 경우 프로젝트 소유자가 필요한 권한이 포함된 역할을 사용자에게 제공해야 할 수 있습니다.

특정 작업에 필요한 권한 목록은 JSON 메서드에 대한 IAM 권한을 참조하세요.

관련 역할 목록은 Cloud Storage 역할을 참조하세요. 또는 특별히 제한된 권한이 있는 커스텀 역할을 만들 수 있습니다.

객체의 저장소 등급 변경

객체의 스토리지 클래스를 변경하려면 다음 단계를 완료합니다.

콘솔

Google Cloud Console을 통해 개별 객체 스토리지 클래스를 설정할 수 없습니다. 대신 명령줄을 사용합니다.

명령줄

gcloud

미리보기

이 제품 또는 기능에는 Google Cloud 서비스 약관의 GA 출시 전 제공 서비스 약관이 적용됩니다. GA 이전 제품 및 기능은 지원이 제한될 수 있으며, GA 이전 제품 및 기능의 변경사항은 다른 GA 이전 버전과 호환되지 않을 수 있습니다. 자세한 내용은 출시 단계 설명을 참조하세요.

gcloud alpha storage objects update 명령어를 --storage-class 플래그와 함께 사용합니다. 예를 들면 다음과 같습니다.

gcloud alpha storage objects update gs://BUCKET_NAME/OBJECT_NAME --storage-class=STORAGE_CLASS

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

• BUCKET_NAME은 클래스를 변경할 객체가 포함된 버킷의 이름입니다. 예를 들면 my-bucket입니다.
• OBJECT_NAME는 클래스를 변경할 객체의 이름입니다. 예를 들면 pets/dog.png입니다.
• STORAGE_CLASS는 객체의 새 스토리지 클래스입니다. 예를 들면 nearline입니다.

gsutil

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

gsutil rewrite -s STORAGE_CLASS gs://BUCKET_NAME/OBJECT_NAME

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

• STORAGE_CLASS는 객체의 새 스토리지 클래스입니다. 예를 들면 nearline입니다.
• BUCKET_NAME은 클래스를 변경할 객체가 포함된 버킷의 이름입니다. 예를 들면 my-bucket입니다.
• OBJECT_NAME는 클래스를 변경할 객체의 이름입니다. 예를 들면 pets/dog.png입니다.

코드 샘플

C++

자세한 내용은 Cloud Storage C++ API 참조 문서를 확인하세요.

GitHub에서 보기 의견 보내기

namespace gcs = ::google::cloud::storage;
using ::google::cloud::StatusOr;
[](gcs::Client client, std::string const& bucket_name,
   std::string const& object_name, std::string const& storage_class) {
  StatusOr<gcs::ObjectMetadata> object_metadata =
      client.RewriteObjectBlocking(
          bucket_name, object_name, bucket_name, object_name,
          gcs::WithObjectMetadata(
              gcs::ObjectMetadata().set_storage_class(storage_class)));

  if (!object_metadata) {
    throw std::runtime_error(object_metadata.status().message());
  }

  std::cout << "Changed storage class of object " << object_metadata->name()
            << " in bucket " << object_metadata->bucket() << " to "
            << object_metadata->storage_class() << "\n";
}

C#

자세한 내용은 Cloud Storage C# API 참조 문서를 확인하세요.

GitHub에서 보기 의견 보내기

using Google.Cloud.Storage.V1;
using System;

public class ChangeFileStorageClassSample
{
    public Google.Apis.Storage.v1.Data.Object ChangeFileStorageClass(
        string bucketName = "your-bucket-name",
        string objectName = "your-object-name",
        string storageClass = StorageClasses.Standard)
    {
        var storage = StorageClient.Create();

        // Changing storage class requires a rewrite operation, which can only be done
        // by the underlying service
        var obj = new Google.Apis.Storage.v1.Data.Object { StorageClass = storageClass };
        storage.Service.Objects.Rewrite(obj, bucketName, objectName, bucketName, objectName).Execute();

        var file = storage.GetObject(bucketName, objectName);
        Console.WriteLine($"Object {objectName} in bucket {bucketName} had" +
            $" its storage class set to {storageClass}.");

        return file;
    }
}

Go

자세한 내용은 Cloud Storage Go API 참조 문서를 확인하세요.

GitHub에서 보기 의견 보내기

import (
	"context"
	"fmt"
	"io"
	"time"

	"cloud.google.com/go/storage"
)

// changeObjectStorageClass changes the storage class of a single object.
func changeObjectStorageClass(w io.Writer, bucket, object string) error {
	// bucket := "bucket-name"
	// object := "object-name"
	ctx := context.Background()
	client, err := storage.NewClient(ctx)
	if err != nil {
		return fmt.Errorf("storage.NewClient: %v", err)
	}
	defer client.Close()

	ctx, cancel := context.WithTimeout(ctx, time.Second*10)
	defer cancel()

	o := client.Bucket(bucket).Object(object)

	// Optional: set a generation-match precondition to avoid potential race
	// conditions and data corruptions. The request to upload is aborted if the
	// object's generation number does not match your precondition.
	attrs, err := o.Attrs(ctx)
	if err != nil {
		return fmt.Errorf("object.Attrs: %v", err)
	}
	o = o.If(storage.Conditions{GenerationMatch: attrs.Generation})

	// See the StorageClass documentation for other valid storage classes:
	// https://cloud.google.com/storage/docs/storage-classes
	newStorageClass := "COLDLINE"
	// You can't change an object's storage class directly, the only way is
	// to rewrite the object with the desired storage class.
	copier := o.CopierFrom(o)
	copier.StorageClass = newStorageClass
	if _, err := copier.Run(ctx); err != nil {
		return fmt.Errorf("copier.Run: %v", err)
	}
	fmt.Fprintf(w, "Object %v in bucket %v had its storage class set to %v\n", object, bucket, newStorageClass)
	return nil
}

자바

자세한 내용은 Cloud Storage 자바 API 참조 문서를 확인하세요.

GitHub에서 보기 의견 보내기

import com.google.cloud.storage.Blob;
import com.google.cloud.storage.BlobId;
import com.google.cloud.storage.BlobInfo;
import com.google.cloud.storage.Storage;
import com.google.cloud.storage.StorageClass;
import com.google.cloud.storage.StorageOptions;

public class ChangeObjectStorageClass {
  public static void changeObjectStorageClass(
      String projectId, String bucketName, String objectName) {
    // The ID of your GCP project
    // String projectId = "your-project-id";

    // The ID of your GCS bucket
    // String bucketName = "your-unique-bucket-name";

    // The ID of your GCS object
    // String objectName = "your-object-name";

    Storage storage = StorageOptions.newBuilder().setProjectId(projectId).build().getService();
    BlobId blobId = BlobId.of(bucketName, objectName);

    // See the StorageClass documentation for other valid storage classes:
    // https://googleapis.dev/java/google-cloud-clients/latest/com/google/cloud/storage/StorageClass.html
    StorageClass storageClass = StorageClass.COLDLINE;

    // You can't change an object's storage class directly, the only way is to rewrite the object
    // with the
    // desired storage class
    Storage.CopyRequest request =
        Storage.CopyRequest.newBuilder()
            .setSource(blobId)
            .setTarget(BlobInfo.newBuilder(blobId).setStorageClass(storageClass).build())
            .build();
    Blob updatedBlob = storage.copy(request).getResult();

    System.out.println(
        "Object "
            + objectName
            + " in bucket "
            + bucketName
            + " had its storage class set to "
            + updatedBlob.getStorageClass().name());
  }
}

Node.js

자세한 내용은 Cloud Storage Node.js API 참조 문서를 확인하세요.

GitHub에서 보기 의견 보내기

// Imports the Google Cloud client library
const {Storage} = require('@google-cloud/storage');

// Creates a client
const storage = new Storage();

/**
 * TODO(developer): Uncomment the following lines before running the sample.
 */
// The ID of your GCS bucket
// const bucketName = 'your-unique-bucket-name';

// The ID of your GCS file
// const fileName = 'your-file-name';

// The name of a storage class
// See the StorageClass documentation for other valid storage classes:
// https://googleapis.dev/java/google-cloud-clients/latest/com/google/cloud/storage/StorageClass.html
// const storageClass = 'coldline';

async function fileChangeStorageClass() {
  await storage
    .bucket(bucketName)
    .file(fileName)
    .setStorageClass(storageClass);

  console.log(`${fileName} has been set to ${storageClass}`);
}

fileChangeStorageClass().catch(console.error);

PHP

자세한 내용은 Cloud Storage PHP API 참조 문서를 확인하세요.

GitHub에서 보기 의견 보내기

use Google\Cloud\Storage\StorageClient;

/**
 * Change the storage class of the given file.
 *
 * @param string $bucketName The name of your Cloud Storage bucket.
 * @param string $objectName The name of your Cloud Storage object.
 * @param string $storageClass The storage class of the new object.
 */
function change_file_storage_class($bucketName, $objectName, $storageClass)
{
    // $bucketName = 'my-bucket';
    // $objectName = 'my-object';
    // $storageClass = 'COLDLINE';

    $storage = new StorageClient();
    $bucket = $storage->bucket($bucketName);
    $object = $bucket->object($objectName);

    // Storage class cannot be changed directly. But we can rewrite the object
    // using the new storage class.

    $newObject = $object->rewrite($bucket, [
        'storageClass' => $storageClass,
    ]);

    printf(
        'Object %s in bucket %s had its storage class set to %s',
        $objectName,
        $bucketName,
        $newObject->info()['storageClass']
    );
}

Python

자세한 내용은 Cloud Storage Python API 참조 문서를 확인하세요.

GitHub에서 보기 의견 보내기

from google.cloud import storage

def change_file_storage_class(bucket_name, blob_name):
    """Change the default storage class of the blob"""
    # bucket_name = "your-bucket-name"
    # blob_name = "your-object-name"

    storage_client = storage.Client()

    bucket = storage_client.get_bucket(bucket_name)
    blob = bucket.get_blob(blob_name)
    blob.update_storage_class("NEARLINE")

    print(
        "Blob {} in bucket {} had its storage class set to {}".format(
            blob_name,
            bucket_name,
            blob.storage_class
        )
    )
    return blob

Ruby

자세한 내용은 Cloud Storage Ruby API 참조 문서를 확인하세요.

GitHub에서 보기 의견 보내기

def change_file_storage_class bucket_name:, file_name:
  # The ID of your GCS bucket
  # bucket_name = "your-unique-bucket-name"

  # The ID of your GCS object
  # file_name = "your-file-name"

  require "google/cloud/storage"

  storage = Google::Cloud::Storage.new
  bucket = storage.bucket bucket_name, skip_lookup: true

  file = bucket.file file_name

  file.storage_class = "NEARLINE"

  puts "File #{file_name} in bucket #{bucket_name} had its storage class set to #{file.storage_class}"
end

REST API

JSON API

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

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

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

   {
     "storageClass": "STORAGE_CLASS"
   }

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

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

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

   curl -X POST --data-binary @JSON_FILE_NAME \
     -H "Authorization: Bearer OAUTH2_TOKEN" \
     -H "Content-Type: application/json" \
     "https://storage.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은 객체의 URL 인코딩 이름입니다. 예를 들어 pets/dog.png는 pets%2Fdog.png로 URL 인코딩됩니다.

XML API

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

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

2. cURL을 사용하여 PUT 객체 요청으로 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은 다시 작성할 객체의 URL 인코딩 이름입니다. 예를 들어 pets/dog.png는 pets%2Fdog.png로 URL 인코딩됩니다.

참고: 이 가이드에는 A 클래스 작업인 데이터 재작성이 포함되며 데이터가 원래 Nearline Storage, Coldline Storage 또는 Archive Storage로 저장된 경우 가져오기 및 조기 삭제 요금이 청구될 수 있습니다. 또한 버킷에 객체 버전 관리를 사용 설정한 경우에는 원본 객체가 명시적으로 삭제될 때까지 버킷에 남아 있습니다.

다음 단계

• 사용 가능한 스토리지 클래스에 대해 자세히 알아보세요.
• 객체 수명 주기 관리를 사용하여 객체 스토리지 클래스를 변경합니다.
• 객체 메타데이터에 대해 자세히 알아보세요.