最初の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環境で設定することも、コマンドを実行する前に手動で更新することもできます。変数を設定すると、シェルは各コマンドを実行する前に、その値を代入します。各変数は以下の表に記載されています。
| 変数 | 説明 |
|---|---|
$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 --request GET \
--location "https://$FQDN_IP_PORT/virtualization/api/v1/vcenters" \
--header "Accept: */*" \
--header "x-auth: $ACCESS_TOKEN"
JSON レスポンスには、ONTAP tools Manager に設定された VMware vCenter インスタンスのリストが含まれています。