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.

Découvrez l'API REST des ONTAP tools

Contributeurs netapp-revathid
PDF

ONTAP tools for VMware vSphere 10 est un ensemble d'outils de gestion du cycle de vie des machines virtuelles. Il comprend une API REST robuste que vous pouvez utiliser dans vos processus d'automatisation.

Fondation des services web REST

REST (Representational State Transfer) est un style de création d'applications web distribuées, incluant la conception d'API de services web. Il établit un ensemble de technologies pour exposer des ressources basées sur le serveur et gérer leur état.

Ressources et représentation de l’état

Les ressources sont les composants fondamentaux d'une application de services Web REST. La conception d'une API REST comporte deux tâches initiales importantes :

  • Identifiez les ressources système ou serveur

  • Définissez les états des ressources et les opérations de transition d'état associées

Les applications clientes peuvent afficher et modifier l'état des ressources via des flux de messages bien définis.

Messages HTTP

Le protocole de transfert hypertexte (HTTP) est le protocole utilisé par le client et le serveur de services web pour échanger des messages concernant les ressources. Il suit le modèle CRUD basé sur les opérations génériques de création, lecture, mise à jour et suppression. Le protocole HTTP comprend des en-têtes de requête et de réponse ainsi que des codes d'état de réponse.

Formatage des données JSON

Bien que plusieurs formats de messages soient disponibles, l’option la plus populaire est JavaScript Object Notation (JSON). JSON est une norme industrielle permettant de représenter des structures de données simples en texte brut et est utilisé pour transférer des informations d’état décrivant les ressources et les actions souhaitées.

Sécurité

La sécurité est un aspect important d'une API REST. En plus du protocole Transport Layer Security (TLS) utilisé pour protéger le trafic HTTP sur le réseau, l'API REST ONTAP tools for VMware vSphere 10 utilise également des jetons d'accès pour l'authentification. Vous devez obtenir un jeton d'accès et l'utiliser lors des appels d'API suivants.

Prise en charge des requêtes asynchrones

Les ONTAP tools for VMware vSphere 10 REST API exécutent la plupart des requêtes de manière synchrone et renvoient un code d’état lorsque l’opération est terminée. Elles prennent également en charge le traitement asynchrone pour les tâches nécessitant plus de temps pour s’achever.

Environnement du gestionnaire ONTAP tools

Il existe plusieurs aspects de l'environnement ONTAP tools Manager que vous devez prendre en compte.

machine virtuelle

Les ONTAP tools for VMware vSphere 10 sont déployés à l'aide de l'architecture de plug-in distant vSphere. Le logiciel, y compris la prise en charge de l'API REST, s'exécute dans une machine virtuelle distincte.

Adresse IP des outils ONTAP

ONTAP tools for VMware vSphere 10 expose une adresse IP unique servant de passerelle vers les fonctionnalités de la machine virtuelle. Vous devez fournir l'adresse lors de la configuration initiale et elle est attribuée à un composant d'équilibreur de charge interne. L'adresse est utilisée par l'interface utilisateur de ONTAP tools Manager, ainsi que pour accéder directement à la page de documentation Swagger et à l'API REST.

Deux API REST

Outre l'API REST ONTAP tools for VMware vSphere 10, le cluster ONTAP possède sa propre API REST. ONTAP tools Manager utilise l'API REST ONTAP en tant que client pour effectuer des tâches liées au stockage. Il est important de garder à l'esprit que ces deux API sont séparées et distinctes. Pour plus d'informations, consultez "Automatisation ONTAP".