如何使用華為云的API
華為云API符合RESTful API的設計理論。
REST從資源的角度來觀察整個網絡,分布在各處的資源由URI(Uniform Resource Identifier)確定,而客戶端的應用通過URL(Unified Resource Locator)來獲取資源。
調用接口的格式:
URL的一般格式為:https://Endpoint/uri
URL中的參數說明如表1-1所示。
表1-1 URL中的參數說明
參數
描述
Endpoint
Web服務入口點的URL,從地區和終端節點中獲取。
uri
資源路徑,也即API訪問路徑。從具體接口的URI模塊獲取,例如“v3/auth/tokens”。
地區和終端節點的連接地址:http://developer.huaweicloud.com/endpoint.html
在HTTP協議中,請求可以使用多種請求方法例如GET、 PUT、 POST、 DELETE、PATCH,用于指明以何種方式來訪問指定的資源,目前提供的REST接口支持的請求方法如下表1-2所示。
調用接口的方法
表1-2請求方法一覽表
方法
說明
GET
請求服務器返回指定資源。
PUT
請求服務器更新指定資源。
POST
請求服務器新增資源或執行特殊操作。
DELETE
請求服務器刪除指定資源,如刪除對象等。
PATCH
請求服務器更新資源的部分內容。
當資源不存在的時候,PATCH可能會去創建一個新的資源。
調用接口的認證方式
·???????? 調用接口有如下兩種認證方式,您可以任選其中一種進行認證鑒權。
·???????? Token認證:通過Token認證調用請求。
·???????? AK/SK認證:通過AK(Access Key ID)/SK(Secret Access Key)加密調用請求。
本文主要介紹,如何使用postman通過token認證的方式調用華為云的API
1、發送“POST https://IAM的Endpoint/v3/auth/tokens”,獲取IAM的Endpoint及消息體中的區域名稱。
請參考地區和終端節點。
當服務區域名稱為“所有”時,選擇“中國華北區1”的Endpoint。
請求內容示例如下:
下面示例代碼中的紅色字需要替換為實際內容
{
"auth": {
"identity": {
"methods": [
"password"
],
"password": {
"user": {
"name": "username",
"password": "password",
"domain": {
"name": "domainname"
}
}
}
},
"scope": {
"project": {
"id": "0215ef11e49d4743be23dd97a1561e91" //假設id是"0215ef11e49d4743be23dd97a1561e91"
}
}
}
}
2、請求響應成功后在響應消息頭中包含的“X-Subject-Token”的值即為Token值。
3、調用業務接口,在請求消息頭中增加“X-Auth-Token”,“X-Auth-Token”的取值為2中獲取的Token。
在調用接口的時候,部分URL中需要填入項目編號(project_id或者tenant_id,本文中project_id和tenant_id含義一樣),所以需要先在管理控制臺上獲取到項目編號。項目編號獲取步驟如下:
注冊并登錄管理控制臺。
單擊用戶名,在下拉列表中單擊“我的憑證”。
在“我的憑證”頁面的項目列表中查看項目ID。
注:選擇的項目ID與所屬區域一定要對應的上,例如選擇華南區IAM的endpoint獲取token,那項目ID也要選擇華南區對應的項目ID
使用postman請求調用API示例(以華南區舉例)如下:
一、?? 獲取token
在地區和終端節點上,選擇對應的區域以及終端節點,本例以華南區為例
獲取token的url為https://iam.cn-south-1.myhwclouds.com/v3/auth/tokens
二、?? 調用服務API
可以參考服務的API文檔調用API,以調用網絡接口查詢router為例
url為 https://vpc.cn-south-1.myhwclouds.com/v2.0/routers
將第一步獲取的token填入header中X-Auth-Token對應的value中
云服務 華為公有云
版權聲明:本文內容由網絡用戶投稿,版權歸原作者所有,本站不擁有其著作權,亦不承擔相應法律責任。如果您發現本站中有涉嫌抄襲或描述失實的內容,請聯系我們jiasou666@gmail.com 處理,核實后本網站將在24小時內刪除侵權內容。
版權聲明:本文內容由網絡用戶投稿,版權歸原作者所有,本站不擁有其著作權,亦不承擔相應法律責任。如果您發現本站中有涉嫌抄襲或描述失實的內容,請聯系我們jiasou666@gmail.com 處理,核實后本網站將在24小時內刪除侵權內容。