Skip to main content
Active IQ Unified Manager 9.9
9.9
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épannage des volumes ONTAP à l'aide d'API de passerelle

Contributeurs
PDF

Les API de passerelle servent de passerelle pour appeler les API ONTAP pour interroger les informations sur vos objets de stockage ONTAP et prendre les mesures correctives nécessaires pour résoudre les problèmes signalés.

Ce flux de travail prend un exemple d'utilisation dans lequel un événement est déclenché lorsqu'un volume ONTAP atteint presque sa capacité. Ce workflow explique également comment résoudre ce problème en invoquant une combinaison d'API REST Active IQ Unified Manager et ONTAP.

Remarque

Avant d'exécuter les étapes du workflow, assurez-vous que :

  • Vous connaissez les API de passerelle et leur utilisation. Pour plus d'informations, reportez-vous à la section « API de passerelle ».

Accès aux API ONTAP via un accès proxy

  • Vous connaissez l'utilisation des API REST de ONTAP. Pour plus d'informations sur l'utilisation des API REST de ONTAP, reportez-vous à la section "Documentation sur l'automatisation ONTAP".

  • Vous êtes administrateur d'applications.

  • Le cluster sur lequel vous souhaitez exécuter les opérations d'API REST est pris en charge par ONTAP 9.5 ou version ultérieure et le cluster est ajouté à Unified Manager via HTTPS.

Le schéma suivant illustre chaque étape du workflow pour le dépannage des problèmes liés à l'utilisation de la capacité des volumes ONTAP.

workflow ONTAP de la passerelle d'api

Ce workflow couvre les points d'invocation des API REST Unified Manager et ONTAP.

  1. Noter le nom du volume provenant de l'événement afin de prévenir l'utilisation de la capacité du volume.

  2. En utilisant le nom du volume comme valeur dans name , interrogez le volume en exécutant l'API Unified Manager suivante.

Catégorie Verbe HTTP Chemin

data center

OBTENEZ

/datacenter/storage/volumes

  1. Récupère l'UUID et l'UUID de volume du cluster à partir du résultat.

  2. Dans l'interface utilisateur Web d'Unified Manager, accédez à général > Paramètres de fonctionnalité > passerelle API pour vérifier si la fonctionnalité passerelle API est activée. Sauf si elle est activée, les API sous le gateway la catégorie n'est pas disponible pour que vous puissiez appeler. Activez la fonction si elle est désactivée.

  3. Utilisez l'UUID de cluster pour exécuter l'API ONTAP /storage/volumes/{uuid} Via la passerelle API. La requête renvoie les détails du volume lorsque l'UUID du volume est transmis en tant que paramètre API.

Pour exécuter les API ONTAP via la passerelle d'API, les identifiants Unified Manager sont transférés en interne à des fins d'authentification, et vous n'avez pas besoin d'exécuter une étape d'authentification supplémentaire pour l'accès individuel au cluster.

Catégorie Verbe HTTP Chemin

Unified Manager : passerelle

ONTAP : stockage

OBTENEZ

API de passerelle : /gateways/{uuid}/{path}

API ONTAP : /storage/volumes/{uuid}
Remarque

Dans /gateways/{uuid}/{path}, la valeur de {uuid} Doit être remplacé par l'UUID de cluster sur lequel l'opération DE REPOS est à effectuer. {path} Doit être remplacé par l'URL REST de ONTAP /storage/volumes/{uuid}.

L'URL ajoutée est : /gateways/{cluster_uuid}/storage/volumes/{volume_uuid}

Lors de l'exécution du GET Opération, l'URL générée est : GEThttps://<hostname>/api/gateways/<cluster_UUID>/storage/volumes/{volume_uuid}

Commande Curl exemple

curl -X GET "https://<hostname>/api/gateways/1cd8a442-86d1-11e0-ae1c-9876567890123/storage/volumes/028baa66-41bd-11e9-81d5-00a0986138f7"
-H "accept: application/hal+json" -H "Authorization: Basic <Base64EncodedCredentials>"

  1. À partir des résultats, déterminez la taille, l'utilisation et la mesure corrective à prendre. Dans ce flux de travail, la mesure corrective prise consiste à redimensionner le volume.

  2. Utilisez l'UUID de cluster et exécutez l'API ONTAP suivante via la passerelle d'API pour redimensionner le volume. Pour plus d'informations sur les paramètres d'entrée de la passerelle et des API ONTAP, reportez-vous à l'étape 5.

Catégorie Verbe HTTP Chemin

Unified Manager : passerelle

ONTAP : stockage

CORRECTIF

API de passerelle : /gateways/{uuid}/{path}

API ONTAP : /storage/volumes/{uuid}
Remarque

Vous devez, en plus de l'UUID et de l'UUID de volume du cluster, entrer une valeur pour le size paramètre de redimensionnement du volume. Assurez-vous de saisir la valeur dans octets. Par exemple, si vous souhaitez augmenter la taille d'un volume de 100 Go à 120 Go, entrez la valeur du paramètre size à la fin de la requête : -d {\"size\": 128849018880}"

Commande Curl exemple

curl -X PATCH "https://<hostname>/api/gateways/1cd8a442-86d1-11e0-ae1c-9876567890123/storage/volumes/028baa66-41bd-11e9-81d5-00a0986138f7" -H
    "accept: application/hal+json" -H "Authorization: Basic <Base64EncodedCredentials>" -d
    {\"size\": 128849018880}"

La sortie JSON renvoie un UUID de tâche.

  1. Vérifiez si le travail a bien été exécuté à l'aide de l'UUID du travail. Utilisez l'UUID et l'UUID de cluster pour exécuter l'API ONTAP suivante via la passerelle d'API. Pour plus d'informations sur les paramètres d'entrée de la passerelle et des API ONTAP, reportez-vous à l'étape 5.

Catégorie Verbe HTTP Chemin

Unified Manager : passerelle

ONTAP : cluster

OBTENEZ

API de passerelle : /gateways/{uuid}/{path}

API ONTAP : /cluster/jobs/{uuid}

Les codes HTTP renvoyés sont les mêmes que les codes d'état HTTP de l'API REST ONTAP.

  1. Exécutez l'API ONTAP suivante pour interroger les détails du volume redimensionné. Pour plus d'informations sur les paramètres d'entrée de la passerelle et des API ONTAP, reportez-vous à l'étape 5.

Catégorie Verbe HTTP Chemin

Unified Manager : passerelle

ONTAP : stockage

OBTENEZ

API de passerelle : /gateways/{uuid}/{path}

API ONTAP : /storage/volumes/{uuid}

La sortie affiche une taille de volume accrue de 120 Go.