Python 用 Alibaba Cloud SDK V2.0 でエンドポイントを設定する - Alibaba Cloud SDK

エンドポイントは、Alibaba Cloud サービスのドメイン名です。たとえば、Elastic Compute Service (ECS) のエンドポイントは ecs.cn-hangzhou.aliyuncs.com です。

エンドポイントを設定する

Python 用 Alibaba Cloud SDK V2.0 は、エンドポイントを設定するための 2 つの方法を提供しています。次のセクションでは、優先順位の高い順に方法について説明します。

説明

カスタムエンドポイントを指定してエンドポイントを設定することをお勧めします。

カスタムエンドポイントを指定します。クライアントを初期化するときにエンドポイントを指定できます。OpenAPI Explorer でエンドポイントを照会できます。詳細については、このトピックの「付録: エンドポイントを照会する」セクションをご参照ください。
```
from alibabacloud_tea_openapi.models import Config

config = Config(
    # 認証情報を設定します。
    endpoint='<endpoint>'  # endpoint
)
```
カスタムリージョン ID を指定します。
- Alibaba Cloud サービスの SDK にリージョン ID とエンドポイントの関係オブジェクトが含まれており、指定されたリージョン ID が関係オブジェクトに含まれている場合、関係オブジェクトからエンドポイントを取得できます。
- Alibaba Cloud サービスの SDK にリージョン ID とエンドポイントの関係オブジェクトが含まれていない場合、または指定されたリージョン ID が関係オブジェクトに含まれていない場合、エンドポイントは連結ルールに基づいて自動的に連結されます。
```
from alibabacloud_tea_openapi.models import Config

config = Config(
    # 認証情報を設定します。
    region_id='cn-hangzhou',  # リージョン ID に基づいてエンドポイントを指定します。
)
```

VPC エンドポイントが使用されるシナリオ

Alibaba Cloud SDK を使用して API オペレーションを呼び出し、ビジネスに次の要件がある場合は、VPC エンドポイントを設定することをお勧めします。

ビジネスシステムは、オンプレミスデータセンターとクラウドデータセンターの両方にデプロイされています。異なるビジネスモジュールは、VPC ネットワークに基づいて構築され、分離されたクラウド環境を構築します。データセンターはインターネットを介して相互に通信します。
クラウドデータセンターは、VPC ネットワークに基づいてデプロイされています。Express Connect 回線を介してオンプレミスデータセンターと通信し、ハイブリッドクラウド接続を実装します。これにより、コアユーザーデータのセキュリティが確保され、ワークロードの変動への対応と高速なデータ同期に役立ちます。
VPC ネットワークに基づいてデプロイされた複数のアプリケーションが外部サービスを提供する必要があり、アプリケーションのワークロードはさまざまな時点で変動します。この場合、複数の IP アドレスが帯域幅を共有する必要があり、トラフィックの変動を削減してコストを削減する必要があります。
クラウドサービスは VPC ネットワークに基づいて構築されます。さまざまな地域のユーザーのネットワークレイテンシを削減するために、ビジネスシステムは異なるノードにデプロイされます。ユーザーエクスペリエンスを最適化するには、これらのノード間の高帯域幅接続が必要です。

認証情報を要求するためのエンドポイントの設定

一部の API オペレーションは、オープンプラットフォームのエンドポイントを設定するために呼び出すことができます。エンドポイントを設定しない場合は、デフォルトのパブリックエンドポイントが使用されます。エンドポイントを使用してファイルアップロード認証サービスを呼び出し、認証情報とデフォルトの Object Storage Service (OSS) バケットに関する情報を取得できます。

認証に使用されるエンドポイント。VPC を介して認証情報を要求するように仮想プライベートクラウド (VPC) エンドポイントを設定できます。認証情報はファイルのアップロードに使用されます。

from alibabacloud_tea_openapi.models import Config
from alibabacloud_tea_util.models import RuntimeOptions

from alibabacloud_facebody20191230.models import DetectBodyCountAdvanceRequest
from alibabacloud_facebody20191230.client import Client

runtime = RuntimeOptions()
config = Config(
    # 認証情報を設定します。
    region_id='cn-hangzhou',
    # 認証に使用されるエンドポイント。
    open_platform_endpoint='openplatform-vpc.cn-shanghai.aliyuncs.com'
)

client = Client(config)
with open('test.txt', 'rb') as f:
    request = DetectBodyCountAdvanceRequest(image_urlobject=f)
    response = client.detect_body_count_advance(request, runtime)
    # サーバー側によって返される本文とヘッダーを含むレスポンス。
    print(response.body)
    print(response.headers)

認証に使用されるエンドポイント。内部ネットワークまたは VPC を介して認証情報を要求するように VPC エンドポイントを設定できます。認証情報はファイルのアップロードに使用されます。

from alibabacloud_tea_openapi.models import Config
from alibabacloud_tea_util.models import RuntimeOptions

from alibabacloud_facebody20191230.models import DetectBodyCountAdvanceRequest
from alibabacloud_facebody20191230.client import Client

runtime = RuntimeOptions()
config = Config(
    # 認証情報を設定します。
    region_id='cn-hangzhou',
    open_platform_endpoint='openplatform-vpc.cn-shanghai.aliyuncs.com',
    endpoint_type='internal' # ファイルのアップロードに使用する Object Storage Service (OSS) エンドポイントを設定します。
)

client = Client(config)
with open('test.txt', 'rb') as f:
    request = DetectBodyCountAdvanceRequest(image_urlobject=f)
    response = client.detect_body_count_advance(request, runtime)
    # サーバー側によって返される本文とヘッダーを含むレスポンス。
    print(response.body)
    print(response.headers)

付録: エンドポイントを照会する

OpenAPI Explorer でエンドポイントを照会できます。

OpenAPI Explorer のホームページで Alibaba Cloud サービスを選択します。この例では、ECS が選択されています。

2. ECS のホームページで、[リージョン] タブをクリックします。

3. 指定するリージョンを見つけ、そのリージョンの ECS のエンドポイントをコピーします。

デバッグページで ECS のエンドポイントを照会することもできます。このページで、左側のナビゲーションペインの [リージョン] にポインターを移動すると、ECS のエンドポイントが表示されます。