本产品推出了新版本。
简体中文版经机器翻译而成,仅供参考。如与英语版出现任何冲突,应以英语版为准。
进行首次 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 实例列表。