このトピックでは、Cloud FirewallのAPI操作を呼び出す方法について説明します。
APIドキュメントの表示
サポートされているAPI操作は、[関数別の操作の一覧] で表示できます。 このトピックでは、DescribeAssetList操作を例として使用し、Alibaba Cloud SDKを使用してAPI操作を呼び出す方法を示します。 詳細については、「DescribeAssetList」をご参照ください。
RAMユーザーを作成し、RAMユーザーに権限を付与する
ID
Alibaba Cloudアカウント、RAM (Resource Access Management) ユーザー、またはRAMロールを使用して操作を呼び出すことができます。 ID間の違いの詳細については、「ID、資格情報、および権限付与」をご参照ください。 このトピックでは、例としてRAMユーザーを使用します。
RAMコンソールにログインし、API操作の呼び出しのみを許可されたRAMユーザーを作成し、そのRAMユーザーのAccessKeyペアを記録します。 RAM ユーザーの作成
権限付与
RAMコンソールの [ユーザー] ページに移動し、RAMユーザーを見つけて、[操作] 列の [権限の追加] をクリックします。
[ポリシー] セクションで、検索ボックスにCloudFirewallと入力して検索し、AliyunYundunCloudFirewallFullAccessポリシーを選択します。
説明Cloud Firewallのシステムポリシーを次に示します。
AliyunYundunCloudFirewallFullAccess: Cloud Firewallの管理権限。
AliyunYundunCloudFirewallReadOnlyAccess: Cloud Firewallに対する読み取り専用権限。
カスタムポリシーの作成方法の詳細については、「RAM権限付与」をご参照ください。
[権限付与] をクリックします。
資格情報
デフォルトでは、RAMユーザーを作成するとAccessKeyペアが生成されます。 AccessKeyペアを直接使用できます。 次の操作を実行して、AccessKeyペアを作成することもできます。RAMユーザーの詳細ページに移動します。 [認証] タブで、[AccessKeyの作成] をクリックします。 詳細については、「AccessKeyペアの作成」をご参照ください。
操作を呼び出す
次の例は、Pythonで操作を呼び出す方法を示しています。
Python環境を準備する
Pythonをダウンロードしてインストールします。
Python 3のダウンロード方法の詳細については、Pythonの公式Webサイトをご覧ください。
Pythonのバージョンを確認してください。
LinuxまたはmacOS
ターミナルを開き、
python -- versionコマンドを実行します。Windows
Pythonインストールディレクトリで、python.exeをダブルクリックします。
コマンドプロンプトを開きます。
Win + Rキーを押して [実行] ダイアログボックスを開き、pythonと入力し、[OK] をクリックします。
環境変数を設定します。
環境変数の設定方法の詳細については、「Linux、macOS、およびWindowsでの環境変数の設定」をご参照ください。
依存関係のインストール
pipインストールalibabacloud_credentials
pip install alibabacloud_cloudfw20171207==1.3.2
pip install alibabacloud_tea_console サンプルコードのダウンロード
OpenAPI Explorerで、のURLにアクセスします。 DescribeAssetList操作。
[パラメーター] タブで、必要なパラメーター [CurrentPage] および [PageSize] を指定し、[呼び出しの開始] をクリックします。
[SDKサンプルコード] タブで、[Python] タブをクリックして、操作のPythonサンプルコードを取得します。
[プロジェクトのダウンロード] をクリックして、サンプルコードパッケージをダウンロードします。
コンピューターでサンプルコードパッケージを解凍し、alibabacloud_sampleディレクトリに移動します。
サンプルコードの実行
以下のコマンドを実行します。
python sample.py次のコマンド出力が表示されます。
{
"headers": {
"date": "Thu、8月10日2023 10:18:48 GMT" 、"content-type": "application/json;charset=utf-8" 、"content-length": "1194" 、"connection": "keep-alive" 、"keep-alive": "timeout=25" 、"vary": "Accept-Encoding" 、"access-control-allow-origin": "*" 、"access-control-exposure-headers": "*" 、"x-acs-request-id": "B49120FC-5A22-5500-A005-060F487E ****" 、"x-acs-trace-id": "e04deb393afe188190485401aa41 ****" 、"etag": "1SZicxaXw FjDwnyteba ****"
},
"statusCode": 200、"body": {
"Assets": [{
"AliUid": 163710033944 **** 、"BindInstanceId": "i-bp14vt99zpj899eq ****" 、"BindInstanceName": "launch-****-20210409" 、"CreateTimeStamp": "2023-07-05 15:05:01" 、"InternetAddress": "118.31.XX.XX" 、"IntranetAddress": "192.168.XX.XX" 、"MemberUid": 163710033944 **** 、"名前": "launch-****-20210409" 、"NewResourceTag": "" 、"ノート": "" 、"ProtectStatus": "closed" 、"RegionID": "cn-hangzhou" 、"RegionStatus": "enable" 、"ResourceInstanceId": "i-bp14vt99zpj899eq ****" 、"ResourceType": "EcsPublicIP" 、"RiskLevel": "" 、"SgStatus": "ブロック" 、"SgStatusTime": 1691350656、"SyncStatus": "enable" 、"タイプ": "ecs"
}, {
"AliUid": 163710033944 **** 、"BindInstanceId": "i-bp1ic3k18jrurbxd ****" 、"BindInstanceName": "launch-****-20230712" 、"CreateTimeStamp": "2023-07-12 17:49:46" 、"InternetAddress": "47.111.XX.XX" 、"IntranetAddress": "10.0.XX.XX" 、"MemberUid": 163710033944 **** 、"名前": "launch-****-20230712" 、"NewResourceTag": "" 、"ノート": "" 、"ProtectStatus": "closed" 、"RegionID": "cn-hangzhou" 、"RegionStatus": "enable" 、"ResourceInstanceId": "i-bp1ic3k18jrurbxd ****" 、"ResourceType": "EcsPublicIP" 、"RiskLevel": "" 、"SgStatus": "ブロック" 、"SgStatusTime": 1691350656、"SyncStatus": "enable" 、"タイプ": "ecs"
}],
"RequestId": "B49120FC-5A22-5500-A005-060F487EF211" 、"TotalCount": 16
}
}