すべてのプロダクト
Search
ドキュメントセンター

Object Storage Service:OSS SDK for Python 2.0 を使用してオブジェクトのストレージクラスを変換する

最終更新日:Oct 21, 2025

Object Storage Service (OSS) は、ホットデータからコールドデータまで、さまざまなデータストレージシナリオに対応するために、標準、低頻度アクセス (IA)、アーカイブ、コールドアーカイブ、ディープコールドアーカイブといったストレージタイプを提供しています。OSS では、オブジェクトが一度作成されると、その内容は変更できません。オブジェクトのストレージクラスを変換したい場合は、新しいオブジェクトを作成してそのストレージクラスを変換する必要があります。このトピックでは、OSS SDK for Python 2.0 を使用したストレージクラスの変換方法について説明します。

使用上の注意

  • このトピックのサンプルコードでは、中国 (杭州) リージョンのリージョン ID cn-hangzhou を使用します。デフォルトでは、バケット内のリソースにアクセスするためにパブリックエンドポイントが使用されます。バケットが配置されているのと同じリージョン内の他の Alibaba Cloud サービスからバケット内のリソースにアクセスする場合は、内部エンドポイントを使用します。OSS がサポートするリージョンとエンドポイントの詳細については、「リージョンとエンドポイント」をご参照ください。

  • オブジェクトのストレージクラスを変換するには、oss:GetObjectoss:PutObject、および oss:RestoreObject の権限が必要です。詳細については、「RAM ユーザーにカスタム権限を付与する」をご参照ください。

サンプルコード

CopyObject メソッドを使用してストレージクラスを変換する

CopyObject メソッドを使用して、オブジェクトのストレージクラスを標準からアーカイブに変換できます。

import argparse
import alibabacloud_oss_v2 as oss

# コマンドライン引数パーサーを作成します。
parser = argparse.ArgumentParser(description="copy object sample")

# バケットが配置されているリージョンを指定する --region コマンドライン引数を追加します。この引数は必須です。
parser.add_argument('--region', help='The region in which the bucket is located.', required=True)
# 宛先バケットの名前を指定する --bucket コマンドライン引数を追加します。この引数は必須です。
parser.add_argument('--bucket', help='The name of the destination bucket.', required=True)
# 他のサービスが OSS にアクセスするために使用できるドメイン名を指定する --endpoint コマンドライン引数を追加します。この引数はオプションです。
parser.add_argument('--endpoint', help='The domain names that other services can use to access OSS')
# 宛先オブジェクトの名前を指定する --key コマンドライン引数を追加します。この引数は必須です。
parser.add_argument('--key', help='The name of the destination object.', required=True)
# ソースオブジェクトの名前を指定する --source_key コマンドライン引数を追加します。この引数は必須です。
parser.add_argument('--source_key', help='The name of the source object.', required=True)
# ソースバケットの名前を指定する --source_bucket コマンドライン引数を追加します。この引数は必須です。
parser.add_argument('--source_bucket', help='The name of the source bucket.', required=True)

def main():
    # コマンドライン引数を解析します。
    args = parser.parse_args()

    # ID 検証のために環境変数から認証情報を読み込みます。
    credentials_provider = oss.credentials.EnvironmentVariableCredentialsProvider()

    # SDK のデフォルト設定を読み込み、認証情報プロバイダーを設定します。
    cfg = oss.config.load_default()
    cfg.credentials_provider = credentials_provider

    # 設定でリージョンを設定します。
    cfg.region = args.region

    # endpoint パラメーターが指定されている場合は、設定でエンドポイントを設定します。
    if args.endpoint is not None:
        cfg.endpoint = args.endpoint

    # 設定に基づいて OSS クライアントを作成します。
    client = oss.Client(cfg)

    # オブジェクトをコピーするリクエストを実行します。
    result = client.copy_object(oss.CopyObjectRequest(
        bucket=args.bucket,  # 宛先バケットの名前を指定します。
        key=args.key,  # 宛先オブジェクトのキーを指定します。
        source_key=args.source_key,  # ソースオブジェクトのキーを指定します。
        source_bucket=args.source_bucket,  # ソースバケットの名前を指定します。
        storage_class= "Archive", # ストレージクラスをアーカイブストレージに変換します。
    ))

    # コピー操作の結果を出力します。
    print(f'status code: {result.status_code},'
          f' request id: {result.request_id},'
          f' version id: {result.version_id},'
          f' hash crc64: {result.hash_crc64},'
          f' source version id: {result.source_version_id},'
          f' server side encryption: {result.server_side_encryption},'
          f' server side data encryption: {result.server_side_data_encryption},'
          f' last modified: {result.last_modified},'
          f' etag: {result.etag},'
    )

# スクリプトが直接実行されたときに main 関数を呼び出します。
if __name__ == "__main__":
    main()  # スクリプトのエントリポイント。ファイルが直接実行されると main 関数が呼び出されます。

Copier を使用してオブジェクトのストレージクラスを変換する

OSS SDK for Python 2.0 の Copier.Copy メソッドを使用して、ストレージクラスを変換できます。このメソッドは、単純コピーとマルチパートコピーの操作を組み合わせ、提供されたリクエストパラメーターに応じて最適なものをインテリジェントに選択します。

以下は、Copier.Copy メソッドを使用してオブジェクトのストレージクラスを標準からアーカイブに変換するためのサンプルコードです。

import argparse
import alibabacloud_oss_v2 as oss

# コマンドライン引数パーサーを作成します。
parser = argparse.ArgumentParser(description="copier sample")

# バケットが配置されているリージョンを指定する --region コマンドライン引数 (必須) を追加します。
parser.add_argument('--region', help='The region in which the bucket is located.', required=True)

# 宛先バケットの名前を指定する --bucket コマンドライン引数 (必須) を追加します。
parser.add_argument('--bucket', help='The name of the destination bucket.', required=True)

# OSS のエンドポイントを指定する --endpoint コマンドライン引数 (オプション) を追加します。
parser.add_argument('--endpoint', help='The domain names that other services can use to access OSS')

# 宛先オブジェクトの名前を指定する --key コマンドライン引数 (必須) を追加します。
parser.add_argument('--key', help='The name of the destination object.', required=True)

# ソースオブジェクトの名前を指定する --source_key コマンドライン引数 (必須) を追加します。
parser.add_argument('--source_key', help='The name of the source object.', required=True)

# ソースバケットの名前を指定する --source_bucket コマンドライン引数 (必須) を追加します。
parser.add_argument('--source_bucket', help='The name of the source bucket.', required=True)


def main():
    # コマンドライン引数を解析します。
    args = parser.parse_args()

    # 環境変数から認証情報を読み込みます。
    # EnvironmentVariableCredentialsProvider を使用して、環境変数から AccessKey ID と AccessKey シークレットを読み取ります。
    credentials_provider = oss.credentials.EnvironmentVariableCredentialsProvider()

    # SDK のデフォルト設定を使用します。
    cfg = oss.config.load_default()
    cfg.credentials_provider = credentials_provider  # 認証情報プロバイダーを設定します。
    cfg.region = args.region  # バケットが配置されているリージョンを設定します。
    if args.endpoint is not None:
        cfg.endpoint = args.endpoint  # エンドポイントが指定されている場合は、カスタムエンドポイントを設定します。

    # OSS クライアントを作成します。
    client = oss.Client(cfg)

    # Copier インスタンスを作成し、コピー操作を実行します。
    copier = client.copier()

    # コピー操作を実行します。
    result = copier.copy(
        oss.CopyObjectRequest(
            bucket=args.bucket,          # 宛先バケットの名前。
            key=args.key,                # 宛先オブジェクトの名前。
            source_bucket=args.source_bucket,  # ソースバケットの名前。
            source_key=args.source_key,  # ソースオブジェクトの名前。
            storage_class="Archive", # ストレージクラスをアーカイブストレージに変換します。
        )
    )

    # コピー結果を出力します。
    # vars(result) を使用して結果オブジェクトを辞書に変換し、その辞書を出力します。
    print(vars(result))


if __name__ == "__main__":
    main()