OSS SDK for Pythonを使用してリージョンのエンドポイントをクエリする方法 - Object Storage Service

このトピックでは、Object Storage Service (OSS) でサポートされているすべてのリージョンまたは特定のリージョンのエンドポイント (パブリックエンドポイント、内部エンドポイント、アクセラレーションエンドポイントを含む) をクエリする方法について説明します。

使用上の注意

OSS SDK for Python 2.18.0 以降のみがエンドポイントのクエリをサポートしています。
リージョンまたは特定のリージョンにバケットを作成したかどうかに関係なく、OSS でリージョンまたは特定のリージョンがサポートされているかどうかに基づいてエンドポイントをクエリできます。
このトピックでは、中国 (杭州) リージョンのパブリックエンドポイントを使用しています。 OSS と同じリージョン内の他の Alibaba Cloud サービスから OSS にアクセスする場合は、内部エンドポイントを使用します。 OSS のリージョンとエンドポイントの詳細については、「リージョンとエンドポイント」をご参照ください。
このトピックでは、OSS エンドポイントを使用して OSSClient インスタンスを作成します。カスタムドメイン名または Security Token Service (STS) を使用して OSSClient インスタンスを作成する場合は、「初期化」をご参照ください。

サポートされているすべてのリージョンのエンドポイントをクエリする

次のコードは、サポートされているすべてのリージョンのエンドポイントをクエリする方法の例を示しています。

# -*- coding: utf-8 -*-
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"

# エンドポイントにマッピングされるリージョンの ID を指定します。例: cn-hangzhou。署名アルゴリズム V4 を使用する場合は、このパラメーターが必要です。
region = "cn-hangzhou"


service = oss2.Service(auth, endpoint, region=region)

# サポートされているすべてのリージョンのエンドポイントをクエリします。
result = service.describe_regions()

for r in result.regions:
    # サポートされているすべてのリージョンの情報を表示します。
    print('region: {0}'.format(r.region))
    # サポートされているすべてのリージョンのパブリックエンドポイントを表示します。
    print('internet_endpoint: {0}'.format(r.internet_endpoint))
    # サポートされているすべてのリージョンの内部エンドポイントを表示します。
    print('internal_endpoint: {0}'.format(r.internal_endpoint))
    # サポートされているすべてのリージョンのアクセラレーションエンドポイントを表示します。
    print('accelerate_endpoint: {0}'.format(r.accelerate_endpoint))

特定のリージョンのエンドポイントをクエリする

次のコードは、特定のリージョンのエンドポイントをクエリする方法の例を示しています。

# -*- coding: utf-8 -*-
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"

# エンドポイントにマッピングされるリージョンの ID を指定します。例: cn-hangzhou。署名アルゴリズム V4 を使用する場合は、このパラメーターが必要です。
region = "cn-hangzhou"

service = oss2.Service(auth, endpoint, region=region)


# この例では、中国 (杭州) リージョンのエンドポイントがクエリされます。他のリージョンのエンドポイントをクエリする場合は、このパラメーターの値を実際のリージョンに置き換えます。
result = service.describe_regions('oss-cn-hangzhou')

for r in result.regions:
    # リージョンの情報を表示します。
    print('region: {0}'.format(r.region))
    # リージョンのパブリックエンドポイントを表示します。
    print('internet_endpoint: {0}'.format(r.internet_endpoint))
    # リージョンの内部エンドポイントを表示します。
    print('internal_endpoint: {0}'.format(r.internal_endpoint))
    # リージョンのアクセラレーションエンドポイントを表示します。
    print('accelerate_endpoint: {0}'.format(r.accelerate_endpoint))

Object Storage Service:OSS SDK for Python 1.0 を使用してリージョンのエンドポイントをクエリする

使用上の注意

サポートされているすべてのリージョンのエンドポイントをクエリする

特定のリージョンのエンドポイントをクエリする

関連情報