本文以Python語言為例,為您介紹如何使用OpenAPI建立任播Elastic IP Address執行個體的完整樣本。
步驟一:查看OpenAPI文檔
通過閱讀API概覽得知,建立任播Elastic IP Address執行個體的OpenAPI為AllocateAnycastEipAddress。請您根據文檔,瞭解調用該介面需要準備的資料和許可權。
步驟二:建立RAM使用者並完成授權
阿里雲帳號擁有所有API的存取權限,建議您建立並使用RAM使用者進行API訪問或日常營運。
您可以使用阿里雲帳號(主帳號)、RAM使用者、RAM角色調用該介面,有關各種身份的差異請參見身份。
本樣本使用RAM使用者進行介面調用。
-
建立RAM使用者。
-
登入RAM存取控制。
-
在左側導覽列,選擇身份管理 > 用戶。
-
在用戶頁面,單擊創建用戶。
-
在創建用戶頁面,設定登錄名稱和顯示名稱、訪問配置為使用控制台訪問。
-
單擊確認。
建立RAM使用者成功後,請記錄使用者登入名稱稱和密碼,您在調用OpenAPI時,需要使用該RAM使用者登入阿里雲OpenAPI開發人員門戶。
-
-
為RAM使用者授權。
-
進入到對應的RAM使用者詳情頁,在AccessKey頁簽,單擊创建 AccessKey。
更多操作詳情,請參見建立AccessKey。
重要RAM使用者的AccessKey Secret只在建立時顯示,不支援查看,請下載CSV檔案後妥善保管。
步驟三:準備環境
-
下載並安裝Python。
具體操作,請參見安裝Python。
-
搭建Python開發環境。
本文在Windows安裝PyCharm為例。具體操作,請參見在Windows搭建Python開發環境。
-
配置環境變數。
調用介面前,需要配置環境變數,以便通過環境變數讀取存取憑證。在Linux、macOS和Windows作業系統下配置環境變數的方法,請參見在Linux、macOS和Windows系統配置環境變數。
重要環境變數配置完成之後,為確保新的設定被正確應用,您可能需要重啟相關的開發工具(IDE等)或服務。
-
安裝環境依賴。
在終端裝置中,執行以下命令,安裝任播Elastic IP Address的SDK包與環境依賴。
pip install alibabacloud_eipanycast20200309==1.1.2 pip install alibabacloud_tea_console
步驟四:下載範例程式碼
-
使用RAM使用者登入OpenAPI門戶的API調試頁面。
-
選擇雲產品為任播Elastic IP Address。
-
在左側導覽列,找到並單擊AllocateAnycastEipAddress介面,服務地址預設未華東1(杭州),ServiceLocation參數輸入international。
-
單擊發起調用。
在調用結果地區,您可以看到查詢結果、Request Header、Response Header等資訊,狀態代碼200表示調用成功。
-
擷取SDK範例程式碼。
OpenAPI平台提供了多種程式設計語言(Java、Go、Python、Node.js、TypeScript、PHP、C++等)的SDK。開發人員只需要整合SDK,通過SDK暴露的方法直接調用OpenAPI。SDK統一封裝了簽名邏輯、逾時機制、重試機制,並根據文檔返回結構化Response對象,易於開發。
以擷取Python SDK範例程式碼為例,其他語言擷取方式相同。
-
在SDK樣本頁簽,選擇SDK版本和SDK語言。推薦使用V2.0版本。關於V2.0和V1.0的區別,請參見V1.0 SDK和V2.0 SDK區別。
-
單擊下載完整工程可以下載完整的SDK工程。下載後完成解壓。
說明-
在SDK樣本顯示地區的右上方,單擊
表徵圖可以複製SDK範例程式碼。 -
單擊SDK安裝資訊,可以擷取SDK包名稱、SDK包版本、SDK包管理平台、SDK安裝命令等基礎資訊,便於您整合開發。
-
-
步驟五:運行SDK範例程式碼
-
開啟PyCharm,單擊File > Open,選擇解壓好的工程檔案,在Creating Virtual Environment視窗單擊OK,等待Python虛擬環境的建立和依賴資源下載。
-
運行範例程式碼。
在PyCharm視窗左側檔案目錄alibabacloud_sample下雙擊sample.py,然後在頂部單擊運行按鈕,查看運行結果。
如果看到
"statusCode":200表示調用成功。運行成功後,終端輸出類似以下響應:
[LOG] {"headers":{"date":"Fri, 28 Jun 2024 06:57:00 GMT","content-type":"application/json;charset=utf-8","content-length":"121","connection":"keep-alive","keep-alive":"timeout=25","access-control-allow-origin":"*","access-control-expose-headers":"*","x-acs-request-id":"1CB825B4-3E78-563D-A6BC-799844E1E2A7","x-acs-trace-id":"51ca6d471e36724cd0bfd1be5b81567b","etag":"1twpU5vKwy5avZiRACIRhOA1"},"statusCode":200,"body":{"AnycastId":"aeip-bp1f1hxxx","OrderId":"5xxx","RequestId":"1CB825B4-3E78-563D-A6BC-799844E1E2A7"}} Process finished with exit code 0