このガイドでは、Python を使用して Anti-DDoS Basic API を初めて呼び出す方法について説明します。この例では、指定されたパブリック IP アドレスを持つアセットがどのリージョンに属しているかを照会します。
前提条件
開始する前に、以下が揃っていることを確認してください。
Alibaba Cloud アカウント
Python 3 がインストールされていること (Python 3 のダウンロード)
RAM コンソールへのアクセス権
仕組み
この例では、指定された IP アドレスのリージョンとインスタンスの詳細を返す Anti-DDoS Basic の操作である DescribeIpLocationService を呼び出します。呼び出しアドレス。完全な API リファレンスについては、「機能別操作リスト」をご参照ください。
呼び出しフローは次のとおりです。
環境変数に保存されている AccessKey ペアを使用して認証します。
InternetIpパラメーターとしてパブリック IP アドレスを渡します。一致するインスタンス ID、タイプ、およびリージョンを含む応答を受信します。
RAM ユーザーの設定
Anti-DDoS Basic への API 呼び出しには、有効な認証情報が必要です。この操作は、Alibaba Cloud アカウント、Resource Access Management (RAM) ユーザー、または RAM ロールを使用して呼び出すことができます。これらの ID タイプ間の違いについては、「ID、認証情報、および権限付与」をご参照ください。このガイドでは、専用の AccessKey ペアを持つ RAM ユーザーを使用します。これにより、root Alibaba Cloud アカウントを使用する場合と比較して、露出が制限されます。
RAM ユーザーの作成と権限付与
RAM コンソールにログインします。RAM ユーザーを作成し、AccessKey ペアを記録する手順に従います。
「ユーザー」ページに移動します。RAM ユーザーを見つけ、[権限の追加] を [操作] 列でクリックします。
[ポリシー] セクションで
Yundunddosを検索し、[AliyunYundunDDoSFullAccess] を選択します。説明Anti-DDoS Basic は、次の 2 つのシステムポリシーを提供します。
AliyunYundunDDoSFullAccess — 完全な管理権限
AliyunYundunDDoSReadOnlyAccess — 読み取り専用アクセス
[権限の付与] をクリックします。
AccessKey ペアの作成
デフォルトでは、RAM ユーザーを作成すると AccessKey ペアが生成されます。RAM ユーザーの詳細ページに移動して、[認証] タブを開き、[AccessKey の作成] をクリックして AccessKey ペアを作成することもできます。AccessKey ID と AccessKey シークレットを保存してください。詳細については、「AccessKey ペアの作成」をご参照ください。
操作の呼び出し
環境変数の設定
コードに認証情報をハードコーディングしないように、AccessKey ペアを環境変数に保存します。設定手順はオペレーティングシステムによって異なります。詳細については、「Linux、macOS、および Windows での環境変数の設定」をご参照ください。
依存関係のインストール
pip install alibabacloud_credentials
pip install alibabacloud_antiddos_public20170518==1.0.2
pip install alibabacloud_tea_consoleサンプルコードの取得
[インターネットIP] を
47.110.XX.XXに設定し、[通話開始] をクリックします。[SDK サンプルコード] タブをクリックし、[言語] セクションに移動して、[Python] を選択します。
[ダウンロード プロジェクト] をクリックして、サンプルコードパッケージをダウンロードします。
パッケージを解凍し、
alibabacloud_sampleディレクトリを開きます。
サンプルの実行
python sample.py期待される出力:
{
"Instance":{
"InstanceId":"eip-bp1bxkujsn1kwo4la****",
"InstanceType":"eip",
"InternetIp":"47.110.XX.XX",
"Region":"cn-hangzhou"
},
"RequestId":"377E4E81-C897-5988-9E61-E51A2262E5C1"
}この応答は、Elastic IP アドレス (EIP) インスタンスと、アセットが存在するリージョン (cn-hangzhou) を確認します。
次のステップ
他の Anti-DDoS Basic 操作を調べるには、「完全な API リファレンス」を参照してください。
RAM ユーザーの代替手段として RAM ロールと Alibaba Cloud アカウントを使用する方法を理解するには、「ID、認証情報、および権限付与」を確認してください。