Gérer les objets de stockage dans un centre de données à l'aide d'API
Suggérer des modifications
PDF
Les API REST sous le datacenter La catégorie vous permet de gérer les objets de stockage dans votre centre de données, tels que les clusters, les nœuds, les agrégats, les machines virtuelles de stockage, les volumes, les LUN, les partages de fichiers et les espaces de noms. Ces API sont disponibles pour interroger la configuration des objets, tandis que certaines d'entre elles vous permettent d'effectuer les opérations d'ajout, de suppression ou de modification de ces objets.
La plupart de ces API sont des appels GET qui fournissent une agrégation inter-clusters avec prise en charge du filtrage, du tri et de la pagination. Lors de l’exécution de ces API, elles renvoient des données de la base de données. Par conséquent, les objets nouvellement créés doivent être découverts lors du prochain cycle d'acquisition pour apparaître dans la réponse.
Si vous souhaitez interroger les détails d'un objet spécifique, vous devez saisir l'ID unique de cet objet pour afficher ses détails. Par exemple, pour les informations sur les métriques et les analyses des objets de stockage, voir"Affichage des indicateurs de performance" .
curl -X GET "https://<hostname>/api/datacenter/cluster/clusters/4c6bf721-2e3f-11e9-a3e2-00a0985badbb" -H "accept: application/json" -H "Authorization: Basic <Base64EncodedCredentials>"
|
Les commandes CURL, les exemples, les requêtes et les réponses aux API sont disponibles sur votre interface API Swagger. Vous pouvez filtrer et commander les résultats selon des paramètres spécifiques comme indiqué sur Swagger. Ces API vous permettent de filtrer les résultats pour des objets de stockage spécifiques, tels qu'un cluster, un volume ou une machine virtuelle de stockage. |
API pour les objets de stockage dans votre centre de données
| verbe HTTP | Chemin | Description |
|---|---|---|
|
|
Vous pouvez utiliser cette méthode pour afficher les détails des clusters ONTAP dans le centre de données. L'API renvoie des informations, telles que l'adresse IPv4 ou IPv6 du cluster, des informations sur le nœud, telles que l'intégrité du nœud, la capacité de performance et la paire haute disponibilité (HA), et indique si le cluster est une baie All SAN. |
|
|
Renvoie les détails des licences installées sur les clusters de votre centre de données. Vous pouvez filtrer vos résultats en fonction des critères requis. Des informations telles que la clé de licence, la clé de cluster, la date d'expiration et l'étendue de la licence sont renvoyées. Vous pouvez saisir une clé de licence pour récupérer les détails d'une licence spécifique. |
|
|
Vous pouvez utiliser cette méthode pour afficher les détails des nœuds du centre de données. Vous pouvez afficher des informations sur le cluster, l'état du nœud, la capacité de performance et la paire haute disponibilité (HA) du nœud. |
|
|
Vous pouvez utiliser cette méthode pour afficher les détails des partages CIFS dans le centre de données. Outre les détails du cluster, du SVM et du volume, des informations sur la liste de contrôle d'accès (ACL) sont également renvoyées. |
|
|
Vous pouvez utiliser cette méthode pour afficher les détails des politiques d’exportation pour les services NFS pris en charge. Vous pouvez interroger les stratégies d'exportation d'un cluster ou d'une machine virtuelle de stockage et réutiliser la clé de stratégie d'exportation pour provisionner les partages de fichiers NFS. Pour plus d'informations sur l'attribution et la réutilisation des stratégies d'exportation sur les charges de travail, consultez « Provisionnement des partages de fichiers CIFS et NFS ». |
|
|
Vous pouvez utiliser cette méthode pour afficher la collection d’agrégats dans le centre de données ou un agrégat spécifique pour provisionner des charges de travail sur ceux-ci ou les surveiller. Des informations telles que les détails du cluster et du nœud, la capacité de performance utilisée, l'espace disponible et utilisé et l'efficacité du stockage sont renvoyées. |
|
|
Vous pouvez utiliser cette méthode pour afficher la collection de LUN dans l’ensemble du centre de données. Vous pouvez afficher des informations sur le LUN, telles que les détails du cluster et du SVM, les stratégies QoS et les igroups. |
|
|
Vous pouvez utiliser cette méthode pour afficher les détails de toutes les politiques QoS applicables aux objets de stockage dans le centre de données. Des informations telles que les détails du cluster et du SVM, les détails de la politique fixe ou adaptative et le nombre d'objets applicables à cette politique sont renvoyées. |
|
|
Vous pouvez utiliser cette méthode pour afficher les détails de l'arbre Q sur l'ensemble du centre de données pour tous les volumes FlexVol ou FlexGroup . Des informations telles que les détails du cluster et du SVM, le FlexVol volume et la politique d'exportation sont renvoyées. |
|
|
Vous pouvez utiliser cette méthode pour afficher la collection de volumes dans le centre de données. Des informations sur les volumes, telles que les détails du SVM et du cluster, la qualité de service et les politiques d'exportation, que le volume soit de type lecture-écriture, protection des données ou partage de charge, sont renvoyées. Pour les volumes FlexVol et FlexClone , vous pouvez afficher les informations sur les agrégats respectifs. Pour un volume FlexGroup , la requête renvoie la liste des agrégats constitutifs. |
|
|
Vous pouvez attribuer des groupes d'initiateurs (igroups) autorisés à accéder à des cibles LUN particulières. S'il existe un igroup, vous pouvez l'attribuer. Vous pouvez également créer des igroups et les attribuer aux LUN. Vous pouvez utiliser ces méthodes pour interroger, créer, supprimer et modifier respectivement des igroups. Points à noter :
|
|
|
Vous pouvez utiliser ces méthodes pour afficher, créer, supprimer et modifier des machines virtuelles de stockage (VM de stockage).
|
|
|
Points à noter : |
Si vous avez activé le provisionnement de charge de travail basé sur SLO sur votre environnement, lors de la création de la machine virtuelle de stockage, assurez-vous qu'elle prend en charge tous les protocoles requis pour provisionner les LUN et les partages de fichiers sur ceux-ci, par exemple, CIFS ou SMB, NFS, FCP et iSCSI. Les flux de travail de provisionnement peuvent échouer si la machine virtuelle de stockage ne prend pas en charge les services requis. Il est recommandé que les services pour les types de charges de travail respectifs soient également activés sur la machine virtuelle de stockage.
Si vous avez activé le provisionnement de charges de travail basé sur SLO sur votre environnement, vous ne pouvez pas supprimer la machine virtuelle de stockage sur laquelle les charges de travail de stockage ont été provisionnées. Lorsque vous supprimez une machine virtuelle de stockage sur laquelle un serveur CIFS ou SMB a été configuré, cette API supprime également le serveur CIFS ou SMB, ainsi que la configuration Active Directory locale. Cependant, le nom du serveur CIFS ou SMB continue de figurer dans la configuration Active Directory que vous devez supprimer manuellement du serveur Active Directory.
API pour les éléments réseau de votre centre de données
Les API suivantes de la catégorie centre de données récupèrent des informations sur les ports et les interfaces réseau de votre environnement, en particulier les ports FC, les interfaces FC, les ports Ethernet et les interfaces IP.
| verbe HTTP | Chemin | Description |
|---|---|---|
|
|
Récupère des informations sur tous les ports Ethernet de votre environnement de centre de données. Avec une clé de port comme paramètre d'entrée, vous pouvez afficher les informations de ce port spécifique. Des informations telles que les détails du cluster, le domaine de diffusion, les détails du port, tels que l'état, la vitesse et le type, et si le port est activé, sont récupérées. |
|
|
Vous pouvez utiliser cette méthode pour afficher les détails des interfaces FC dans votre environnement de centre de données. Avec une clé d’interface comme paramètre d’entrée, vous pouvez afficher les informations de cette interface spécifique. Des informations telles que les détails du cluster, les détails du nœud d'origine et les détails du port d'origine sont récupérées. |
|
|
Récupère des informations sur tous les ports FC utilisés dans les nœuds de votre environnement de centre de données. Avec une clé de port comme paramètre d'entrée, vous pouvez afficher les informations de ce port spécifique. Des informations telles que les détails du cluster, la description du port, le protocole pris en charge et l'état du port sont récupérées. |
|
|
Vous pouvez utiliser cette méthode pour afficher les détails des interfaces IP dans votre environnement de centre de données. Avec une clé d’interface comme paramètre d’entrée, vous pouvez afficher les informations de cette interface spécifique. Des informations telles que les détails du cluster, les détails de l'espace IP, les détails du nœud domestique et si le basculement est activé sont récupérées. |