Skip to main content
ONTAP tools for VMware vSphere 105
Une version plus récente de ce produit est disponible.
La version française est une traduction automatique. La version anglaise prévaut sur la française en cas de divergence.

Effectuez votre premier appel API REST avec les ONTAP tools

Contributeurs netapp-revathid
PDF

Vous pouvez effectuer un appel API à l'aide de curl pour commencer à utiliser les ONTAP tools for VMware vSphere 10 REST API.

Avant de commencer

Vous devez examiner les informations et paramètres requis dans les exemples curl.

Informations requises

Vous avez besoin des éléments suivants :

  • ONTAP tools for VMware vSphere 10 adresse IP ou FQDN ainsi que le port

  • Identifiants pour l’administrateur ONTAP tools Manager (nom d’utilisateur et mot de passe)

Paramètres et variables

Les exemples curl ci-dessous utilisent des variables de style Bash. Vous pouvez définir ces variables dans l'environnement Bash ou les modifier manuellement avant d'exécuter les commandes. Si vous définissez les variables, l'interpréteur de commandes substituera leurs valeurs dans chaque commande avant son exécution. Ces variables sont décrites dans le tableau ci-dessous.

Variable Description

$FQDN_IP_PORT

Le nom de domaine complet ou l'adresse IP du ONTAP tools Manager, ainsi que le numéro de port.

$MYUSER

Nom d'utilisateur pour le compte Manager des ONTAP tools.

$MYPASSWORD

Mot de passe associé au nom d'utilisateur du gestionnaire d'outils ONTAP.

$ACCESS_TOKEN

Le jeton d'accès émis par le gestionnaire ONTAP tools.

Les commandes et résultats suivants dans l'interface de ligne de commande Linux illustrent comment définir et afficher une variable :

FQDN_IP_PORT=172.14.31.224:8443
echo $FQDN_IP
172.14.31.224:8443

Étape 1 : Obtenez un jeton d’accès

Vous devez obtenir un jeton d'accès pour utiliser l'API REST. Un exemple de requête de jeton d'accès est présenté ci-dessous. Vous devez remplacer les valeurs par celles appropriées à votre environnement.

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"}"

Copiez et enregistrez le jeton d'accès fourni dans la réponse.

Étape 2 : Émettre l’appel à l’API REST

Une fois que vous avez obtenu un jeton d'accès, vous pouvez utiliser curl pour effectuer un appel à l'API REST. Incluez le jeton d'accès obtenu lors de la première étape.

Exemple de curl
curl --request GET \
--location "https://$FQDN_IP_PORT/virtualization/api/v1/vcenters" \
--header "Accept: */*" \
--header "x-auth: $ACCESS_TOKEN"

La réponse JSON inclut une liste des instances vCenter VMware configurées dans ONTAP tools Manager.