本ガイドでは、Alibaba Cloud SDK for Python を使用して Data Transmission Service (DTS) の WhiteIpList API を呼び出す手順について説明します。
前提条件
開始する前に、以下の条件を満たしていることを確認してください。
Alibaba Cloud アカウント
Python 3 のインストール(バージョン確認には
python --versionを実行)pip パッケージマネージャ
ステップ 1:API ドキュメントの参照
API オペレーションを呼び出す前に、ドキュメントを読んでリクエストパラメーターと期待される応答を理解してください。「機能別の操作一覧」をご参照ください。
ステップ 2:RAM ユーザーの作成と権限の付与
DTS 権限を持つ RAM ユーザーが既に存在する場合は、このステップはスキップできます。
RAM ユーザーの作成:
RAM コンソールにログインし、「ユーザー」ページへ移動します。[ユーザーの作成] をクリックします。
[ログオン名] を
dts-openapi-operatorに設定し、[アクセスモード] を [永続的な AccessKey を使用してアクセス] に設定します。[OK] をクリックし、AccessKey ID および AccessKey Secret を保存します。
DTS 権限の付与:
「ユーザー」ページで対象の RAM ユーザーを見つけ、[操作] 列の [権限の追加] をクリックします。
表示されたパネルの検索ボックスに
Aliyundtsを入力し、[AliyunDTSFullAccess] を選択します。[権限の付与] をクリックします。
AliyunDTSFullAccess は、DTS に対する読み取りおよび書き込み権限を付与します — RAM ユーザーは、DTS インスタンスの購入、構成、および管理が可能です。AliyunDTSReadOnlyAccess は、タスクの詳細および構成を表示するための読み取り専用アクセスを付与しますが、変更はできません。カスタム権限ポリシーについては、「カスタムポリシーを使用して RAM ユーザーに DTS インスタンスの管理を許可する」をご参照ください。
ステップ 3:環境変数の設定
認証情報をハードコードせず、環境変数として保存します。
Linux または macOS の場合:
export ALIBABA_CLOUD_ACCESS_KEY_ID=<access_key_id>
export ALIBABA_CLOUD_ACCESS_KEY_SECRET=<access_key_secret>Windows の場合:
ALIBABA_CLOUD_ACCESS_KEY_ID および ALIBABA_CLOUD_ACCESS_KEY_SECRET 環境変数を設定するファイルを作成し、システムを再起動します。
<access_key_id> および <access_key_secret> は、ステップ 2 で保存した値に置き換えてください。
ステップ 4:依存関係のインストール
ターミナルで以下のコマンドを実行します。
pip install alibabacloud_credentials
pip install alibabacloud_dts20200101
pip install alibabacloud_tea_consoleステップ 5:サンプルコードのダウンロード
「」および「WhiteIpList」API ページへ移動します。
[パラメーター] タブでリクエストパラメーターを設定します。本例では、[タイプ] を
vpcに、[リージョン] をcn-hangzhou(中国 (杭州))に設定します。[SDK サンプルコード] タブで [Python] を選択し、[プロジェクトのダウンロード] をクリックします。
ダウンロードしたパッケージを展開し、
alibabacloud_sampleディレクトリへ移動します。
ステップ 6:コードの実行
python sample.py正常な応答の例を以下に示します。
{
"headers": {
"date": "Wed, 26 Jul 2023 01:38:10 GMT",
"content-type": "application/json;charset=utf-8",
"content-length": "2349",
"connection": "keep-alive",
"keep-alive": "timeout=25",
"vary": "Accept-Encoding",
"access-control-allow-origin": "*",
"access-control-expose-headers": "*",
"x-acs-request-id": "F67A05B4-639B-5A3E-800F-2015E31D****",
"x-acs-trace-id": "cd5216b8e3d13a155510760d6b7f****",
"etag": "2iMUqZd0YJhWwB0iy0qP****"
},
"statusCode": 200,
"body": {
"HttpStatusCode": 200,
"IpList": "100.104.XX.XX/XX,100.104.XX.XX/XX,100.104.XX.XX/XX,****",
"RequestId": "F67A05B4-639B-5A3E-800F-2015E31D****",
"Success": true
}
}Success: true および statusCode: 200 により、API 呼び出しが成功したことが確認できます。IpList フィールドには、指定されたリージョン内の VPC に対する IP アドレスの許可リストが含まれます。
次のステップ
他の DTS API オペレーションを確認するには、「機能別オペレーション一覧」をご参照ください。
他のプログラミング言語向け SDK を利用する:「Data Transmission SDK」