本文為您介紹通過OpenAPI使用云防火墻(Cloud Firewall)。
查看OpenAPI文檔
您可以通過API概覽查看支持的接口列表。本文以DescribeAssetList - 查詢云防火墻防護的資產的信息為例,為您介紹如何使用OpenAPI集成SDK示例。
創建RAM用戶并授權
身份
您可以使用阿里云賬號(主賬號)、RAM用戶(子賬號)、RAM角色調用該接口,有關各種身份的差異,請參見身份、憑據與授權。本案例中,我們使用RAM用戶進行接口調用。
登錄RAM訪問控制,創建一個僅允許API調用的RAM用戶,并記錄AccessKey信息。具體操作,請參見創建RAM用戶。
授權
訪問RAM用戶列表,單擊目標RAM用戶操作列的添加權限。
在權限策略區塊中輸入關鍵字CloudFirewall進行搜索,選擇AliyunYundunCloudFirewallFullAccess策略。
說明云防火墻的系統權限策略如下:
AliyunYundunCloudFirewallFullAccess:管理云防火墻的權限。
AliyunYundunCloudFirewallReadOnlyAccess:只讀管理云防火墻的權限。
關于如何創建自定義權限,請參見授權信息。
單擊確認新增授權,完成授權操作。
憑證
在創建RAM用戶時會默認生成一個AccessKey,可直接使用。您也可以進入到對應的RAM用戶詳情頁面,在認證管理頁簽,單擊創建AccessKey,創建一個新的AccessKey。具體操作,請參見創建AccessKey。
調用OpenAPI
本文以Python語言為例,為您介紹OpenAPI的調用方法。
準備Python環境
下載并安裝Python。
Python 3的下載地址,請參見Python 3。
查看Python版本。
Linux和macOS系統
打開終端,輸入
python --version
。Windows系統
在Python的安裝路徑下,雙擊python.exe。
打開命令提示符頁面。
通過鍵盤快捷鍵Win+R打開運行對話框,輸入命令python,單擊確定。
配置環境變量
關于如何配置環境變量,請參見在Linux、macOS和Windows系統配置環境變量。
安裝依賴
pip install alibabacloud_credentials
pip install alibabacloud_cloudfw20171207==1.3.2
pip install alibabacloud_tea_console
下載示例代碼
在OpenAPI門戶,訪問DescribeAssetList - 查詢云防火墻防護的資產的信息接口的調試地址。
在參數配置頁簽,輸入必選參數CurrentPage和PageSize的值,然后單擊發起調用。
在SDK示例頁簽,單擊Python頁簽,獲取Python語言的SDK示例。
單擊下載完整工程,下載示例代碼包。
在本地解壓示例代碼包,并進入alibabacloud_sample目錄。
運行代碼
執行以下命令:
python sample.py
得到如下輸出結果:
{
"headers": {
"date": "Thu, 10 Aug 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-expose-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****,
"Name": "launch-****-20210409",
"NewResourceTag": "",
"Note": "",
"ProtectStatus": "closed",
"RegionID": "cn-hangzhou",
"RegionStatus": "enable",
"ResourceInstanceId": "i-bp14vt99zpj899eq****",
"ResourceType": "EcsPublicIP",
"RiskLevel": "",
"SgStatus": "block",
"SgStatusTime": 1691350656,
"SyncStatus": "enable",
"Type": "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****,
"Name": "launch-****-20230712",
"NewResourceTag": "",
"Note": "",
"ProtectStatus": "closed",
"RegionID": "cn-hangzhou",
"RegionStatus": "enable",
"ResourceInstanceId": "i-bp1ic3k18jrurbxd****",
"ResourceType": "EcsPublicIP",
"RiskLevel": "",
"SgStatus": "block",
"SgStatusTime": 1691350656,
"SyncStatus": "enable",
"Type": "ecs"
}],
"RequestId": "B49120FC-5A22-5500-A005-060F487EF211",
"TotalCount": 16
}
}