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

Object Storage Service:転送アクセラレーション (Python SDK V1)

最終更新日:Nov 29, 2025

転送アクセラレーションは、世界中のユーザーの OSS アクセス速度を向上させます。長距離でのデータ転送や、GB または TB 単位の大容量ファイルのアップロード/ダウンロードに適しています。

注意事項

  • このトピックでは、中国 (杭州) リージョンのパブリックエンドポイントを使用します。OSS と同じリージョンにある他の Alibaba Cloud サービスから OSS にアクセスする場合は、内部エンドポイントを使用します。OSS のリージョンとエンドポイントの詳細については、「リージョンとエンドポイント」をご参照ください。

  • このトピックでは、OSS エンドポイントを使用して OSSClient インスタンスを作成します。カスタムドメイン名または Security Token Service (STS) を使用して OSSClient インスタンスを作成する場合は、「初期化」をご参照ください。

転送アクセラレーションの有効化

次のコードは、`examplebucket` という名前のバケットの転送アクセラレーションを有効にする方法の例を示しています。

import oss2
from oss2.credentials import EnvironmentVariableCredentialsProvider

# 環境変数からアクセス認証情報を取得します。サンプルコードを実行する前に、OSS_ACCESS_KEY_ID および OSS_ACCESS_KEY_SECRET 環境変数が設定されていることを確認してください。
auth = oss2.ProviderAuthV4(EnvironmentVariableCredentialsProvider())

# バケットが配置されているリージョンのエンドポイントを指定します。 たとえば、バケットが中国 (杭州) リージョンにある場合、エンドポイントを https://oss-cn-hangzhou.aliyuncs.com に設定します。
endpoint = "https://oss-cn-hangzhou.aliyuncs.com"
# エンドポイントに対応するリージョン情報 (cn-hangzhou など) を指定します。 注:このパラメーターは V4 署名に必要です。
region = "cn-hangzhou"

# バケット名 (examplebucket など) を指定します。
bucket = oss2.Bucket(auth, endpoint, "examplebucket", region=region)

# バケットの転送アクセラレーションステータスを設定します。
# enabled を true に設定すると、転送アクセラレーションが有効になります。enabled を false に設定すると、転送アクセラレーションは無効になります。
enabled = 'true'
bucket.put_bucket_transfer_acceleration(enabled)

転送アクセラレーションステータスのクエリ

次のコードは、`examplebucket` という名前のバケットの転送アクセラレーションステータスをクエリする方法の例を示しています。

import oss2
from oss2.credentials import EnvironmentVariableCredentialsProvider

# 環境変数からアクセス認証情報を取得します。サンプルコードを実行する前に、OSS_ACCESS_KEY_ID および OSS_ACCESS_KEY_SECRET 環境変数が設定されていることを確認してください。
auth = oss2.ProviderAuthV4(EnvironmentVariableCredentialsProvider())

# バケットが配置されているリージョンのエンドポイントを指定します。 たとえば、バケットが中国 (杭州) リージョンにある場合、エンドポイントを https://oss-cn-hangzhou.aliyuncs.com に設定します。
endpoint = "https://oss-cn-hangzhou.aliyuncs.com"
# エンドポイントに対応するリージョン情報 (cn-hangzhou など) を指定します。 注:このパラメーターは V4 署名に必要です。
region = "cn-hangzhou"

# バケット名 (examplebucket など) を指定します。
bucket = oss2.Bucket(auth, endpoint, "examplebucket", region=region)

# バケットの転送アクセラレーションステータスをクエリします。
# 戻り値が true の場合、バケットの転送アクセラレーションは有効になっています。戻り値が false の場合、バケットの転送アクセラレーションは無効になっています。
result = bucket.get_bucket_transfer_acceleration()
enabled_text = result.enabled
print("転送アクセラレーションを有効にするかどうかを返します: ", enabled_text)

関連ドキュメント

  • 転送アクセラレーションの完全なサンプルコードについては、GitHub の例をご参照ください。

  • 転送アクセラレーションを有効にする API 操作の詳細については、「PutBucketTransferAcceleration」をご参照ください。

  • 転送アクセラレーションステータスをクエリする API 操作の詳細については、「GetBucketTransferAcceleration」をご参照ください。