此產品有較新版本可以使用。
本繁體中文版使用機器翻譯,譯文僅供參考,若與英文版本牴觸,應以英文版本為準。
進行第一次 ONTAP tools REST API 呼叫
您可以使用 curl 發出 API 呼叫,以開始使用 ONTAP tools for VMware vSphere 10 REST API。
開始之前
您應該審查 curl 範例中所需的必要資訊和參數。
必要資訊
您需要以下物品:
-
ONTAP tools for VMware vSphere 10 的 IP 位址或 FQDN 以及連接埠
-
ONTAP tools Manager 管理員的憑證(使用者名稱和密碼)
參數和變數
以下 curl 範例包含 Bash 風格的變數。您可以在 Bash 環境中設定這些變數,也可以在發出命令之前手動更新它們。如果設定了變數,shell 會在執行每個命令之前將這些值替換到命令中。下表說明這些變數。
| 變數 | 說明 |
|---|---|
$FQDN_IP_PORT |
ONTAP tools Manager 的完整網域名稱或 IP 位址以及連接埠號碼。 |
$MYUSER |
ONTAP tools Manager 帳戶的使用者名稱。 |
$MYPASSWORD |
與 ONTAP tools Manager 使用者名稱關聯的密碼。 |
$ACCESS_TOKEN |
由 ONTAP tools Manager 所核發的存取權杖。 |
以下 Linux 命令列介面 (CLI) 的命令和輸出示範如何設定和顯示變數:
FQDN_IP_PORT=172.14.31.224:8443 echo $FQDN_IP 172.14.31.224:8443
步驟 1:取得存取權杖
您需要取得存取權杖才能使用 REST API。以下範例展示如何請求存取權杖。請根據您的實際環境替換為對應的值。
curl --request POST \
--location "https://$FQDN_IP_PORT/virtualization/api/v1/auth/login” \
--header "Content-Type: application/json" \
--header "Accept: */*" \
-d "{"username": "$MYUSER", "password": "$MYPASSWORD"}"
複製並儲存回應中提供的存取權杖。
步驟 2:發出 REST API 呼叫
取得存取權杖後,您可以使用 curl 發出 REST API 呼叫。請包含第一步中取得的存取權杖。
Curl 範例
curl --request GET \
--location "https://$FQDN_IP_PORT/virtualization/api/v1/vcenters" \
--header "Accept: */*" \
--header "x-auth: $ACCESS_TOKEN"
JSON 回應包含已設定至 ONTAP tools Manager 的 VMware vCenter 執行個體清單。