Skip to main content
Active IQ Unified Manager
La version française est une traduction automatique. La version anglaise prévaut sur la française en cas de divergence.

Dépanner les volumes ONTAP à l'aide des API de passerelle

PDF

Les API de passerelle agissent comme une passerelle pour appeler les API ONTAP afin d'interroger des informations sur vos objets de stockage ONTAP et de prendre des mesures correctives pour résoudre les problèmes signalés.

Ce workflow reprend un exemple de cas d'utilisation dans lequel un événement est déclenché lorsqu'un volume ONTAP atteint presque sa capacité. Le flux de travail montre é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 des points suivants :

  • Vous connaissez les API de passerelle et la manière dont elles sont utilisées. Pour plus d'informations, voir"Accéder aux API ONTAP via un accès proxy" .

  • Vous connaissez l’utilisation des API REST ONTAP . Pour plus d'informations sur l'utilisation des API REST ONTAP , consultezhttps://docs.netapp.com/us-en/ontap-automation/index.html["Documentation sur l'automatisation ONTAP"] .

  • Vous êtes un administrateur d'application.

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

Le diagramme suivant illustre chaque étape du flux de travail de résolution du problème d’utilisation de la capacité du volume ONTAP .

flux de travail de la passerelle API ontap

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

  1. Notez le nom du volume à partir de l’événement notifiant l’utilisation de la capacité du volume.

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

    Catégorie verbe HTTP Chemin

    centre de données

    OBTENIR

    /datacenter/storage/volumes

  3. Récupérez l’UUID du cluster et l’UUID du volume à partir de la sortie.

  4. Sur l'interface Web d'Unified Manager, accédez à Général > Paramètres des fonctionnalités > Passerelle API pour vérifier si la fonctionnalité Passerelle API est activée. À moins qu’elle ne soit activée, les API sous la catégorie passerelle ne sont pas disponibles pour que vous puissiez les appeler. Activez la fonctionnalité si elle est désactivée.

  5. Utiliser l'UUID du 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 API, les informations d'identification d'Unified Manager sont transmises en interne pour l'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

    Gestionnaire unifié : passerelle

    ONTAP: stockage

    OBTENIR

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

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

    Dans /gateways/{uuid}/{path}, la valeur de {uuid} doit être remplacée par l'UUID du cluster sur lequel l'opération REST doit être effectuée. {path} doit être remplacé par l'URL ONTAP REST /storage/volumes/{uuid}.

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

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

    Exemple de commande cURL

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

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

  7. Utilisez l’UUID du cluster et exécutez l’API ONTAP suivante via la passerelle API pour redimensionner le volume. Pour plus d’informations sur les paramètres d’entrée pour la passerelle et les API ONTAP , consultez l’étape 5.

    Catégorie verbe HTTP Chemin

    Gestionnaire unifié : passerelle

    ONTAP: stockage

    CORRECTIF

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

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

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

    Exemple de commande cURL

    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.

  8. Vérifiez si le travail s'est exécuté avec succès en utilisant l'UUID du travail. Utilisez l’UUID du cluster et l’UUID du travail pour exécuter l’API ONTAP suivante via la passerelle API. Pour plus d’informations sur les paramètres d’entrée pour la passerelle et les API ONTAP , consultez l’étape 5.

    Catégorie verbe HTTP Chemin

    Gestionnaire unifié : passerelle

    ONTAP: cluster

    OBTENIR

    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 .

  9. 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 pour la passerelle et les API ONTAP , consultez l’étape 5.

    Catégorie verbe HTTP Chemin

    Gestionnaire unifié : passerelle

    ONTAP: stockage

    OBTENIR

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

    API ONTAP : /storage/volumes/{uuid}

    La sortie affiche une taille de volume augmentée de 120 Go.