転送アクセラレーション機能を使用すると、世界中のユーザーがObject Storage Service (OSS) に保存されているオブジェクトに短時間でアクセスできます。 この機能は、データを長い地理的距離で転送する必要があるシナリオに適しています。 この機能は、ギガバイトまたはテラバイトのサイズの大きなオブジェクトをダウンロードまたはアップロードするためにも使用できます。
使用上の注意
このトピックでは、中国 (杭州) リージョンのパブリックエンドポイントを使用します。 OSSと同じリージョンにある他のAlibaba CloudサービスからOSSにアクセスする場合は、内部エンドポイントを使用します。 OSSリージョンとエンドポイントの詳細については、「リージョンとエンドポイント」をご参照ください。
このトピックでは、OSSエンドポイントを使用してOSSClientインスタンスを作成します。 カスタムドメイン名またはSTS (Security Token Service) を使用してOSSClientインスタンスを作成する場合は、「初期化」をご参照ください。
転送アクセラレーションの有効化
次のサンプルコードは、examplebucketという名前のバケットの転送アクセラレーションを有効にする方法の例を示しています。
oss2のインポート
oss2.credentialsからEnvironmentVariableCredentialsProviderをインポート
# 環境変数からアクセス資格情報を取得します。 サンプルコードを実行する前に、OSS_ACCESS_KEY_IDおよびOSS_ACCESS_KEY_SECRET環境変数が設定されていることを確認してください。
auth = oss2.ProviderAuth(EnvironmentVariableCredentialsProvider())
# バケットが配置されているリージョンのエンドポイントを指定します。 たとえば、バケットが中国 (杭州) リージョンにある場合、エンドポイントをhttps://oss-cn-hangzhou.aliyuncs.comに設定します。
# バケットの名前を指定します。
bucket = oss2.Bucket(auth, 'https:// oss-cn-hangzhou.aliyuncs.com ', 'examplebucket')
# バケットの転送アクセラレーションを設定します。
# enabledがtrueに設定されている場合、転送アクセラレーションが有効になります。 enabledがfalseに設定されている場合、転送アクセラレーションは無効になります。
enabled = 'true'
bucket.put_bucket_transfer_acceleration(enabled)
バケットの転送アクセラレーションステータスの照会
次のサンプルコードは、examplebucketという名前のバケットの転送アクセラレーションステータスを照会する方法の例を示しています。
oss2のインポート
oss2.credentialsからEnvironmentVariableCredentialsProviderをインポート
# 環境変数からアクセス資格情報を取得します。 サンプルコードを実行する前に、OSS_ACCESS_KEY_IDおよびOSS_ACCESS_KEY_SECRET環境変数が設定されていることを確認してください。
auth = oss2.ProviderAuth(EnvironmentVariableCredentialsProvider())
# バケットが配置されているリージョンのエンドポイントを指定します。 たとえば、バケットが中国 (杭州) リージョンにある場合、エンドポイントをhttps://oss-cn-hangzhou.aliyuncs.comに設定します。
# バケットの名前を指定します。
bucket = oss2.Bucket(auth, 'https:// oss-cn-hangzhou.aliyuncs.com ', 'examplebucket')
# バケットの転送アクセラレーションステータスを照会します。
# 戻り値がtrueの場合、バケットの転送アクセラレーション機能が有効になります。 戻り値がfalseの場合、バケットの転送アクセラレーション機能は無効になります。
result = bucket.get_bucket_transfer_acceleration()
enabled_text = result.enabled
print (「転送アクセラレーションを有効にするかどうかを返す: 」、enabled_text)
参考資料
バケットの転送アクセラレーションを有効にするために使用される完全なサンプルコードについては、GitHubをご覧ください。
転送アクセラレーションを有効にするために呼び出すことができるAPI操作の詳細については、「PutBucketTransferAcceleration」をご参照ください。
バケットの転送アクセラレーションステータスを照会するために呼び出すことができるAPI操作の詳細については、「GetBucketTransferAcceleration」をご参照ください。