Skip to main content
Active IQ Unified Manager 9.9
9.9
Uma versão mais recente deste produto está disponível.
O português é fornecido por meio de tradução automática para sua conveniência. O inglês precede o português em caso de inconsistências.

Solução de problemas de volumes do ONTAP usando APIs de gateway

Colaboradores netapp-maumita
PDFs

As APIs de gateway atuam como um gateway para invocar as APIs do ONTAP para consultar informações sobre seus objetos de armazenamento do ONTAP e tomar medidas corretivas para solucionar os problemas relatados.

Esse fluxo de trabalho ocupa um exemplo de caso de uso no qual um evento é gerado quando um volume ONTAP quase atinge sua capacidade. O fluxo de trabalho também demonstra como resolver esse problema invocando uma combinação de APIs REST do Active IQ Unified Manager e do ONTAP.

Observação

Antes de executar as etapas do fluxo de trabalho, verifique o seguinte:

  • Você está ciente das APIs de gateway e como elas são usadas. Para obter informações, consulte a seção "APIs de gateway".

Acessando APIs do ONTAP por meio de acesso proxy

  • Você está ciente do uso das APIs REST do ONTAP. Para obter informações sobre como usar APIS REST do ONTAP, "Documentação de automação do ONTAP" consulte .

  • Você é um administrador de aplicativos.

  • O cluster no qual você deseja executar as operações da API REST é compatível com o ONTAP 9.5 ou posterior, e o cluster é adicionado ao Unified Manager em HTTPS.

O diagrama a seguir ilustra cada etapa do fluxo de trabalho para solucionar o problema do uso da capacidade de volume do ONTAP.

fluxo de trabalho do ONTAP gateway api

O fluxo de trabalho abrange os pontos de invocação das APIs REST do Unified Manager e do ONTAP.

  1. Anote o nome do volume do evento notificando a utilização da capacidade do volume.

  2. Usando o nome do volume como o valor no name parâmetro, consulte o volume executando a seguinte API do Unified Manager.

Categoria Verbo HTTP Caminho

data center

OBTER

/datacenter/storage/volumes

  1. Recupere o UUID do cluster e UUUID do volume da saída.

  2. Na IU da Web do Unified Manager, navegue até Geral > Configurações de recursos > Gateway de API para verificar se o recurso API Gateway está ativado. A menos que esteja habilitado, as APIs sob a gateway categoria não estarão disponíveis para você invocar. Ative o recurso se ele estiver desativado.

  3. Use o UUUID do cluster para executar a API ONTAP /storage/volumes/{uuid} por meio do gateway API. A consulta retorna os detalhes do volume quando o UUID do volume é passado como o parâmetro API.

Para executar as APIs do ONTAP por meio do gateway API, as credenciais do Unified Manager são passadas internamente para autenticação e você não precisa executar uma etapa adicional de autenticação para acesso individual ao cluster.

Categoria Verbo HTTP Caminho

Unified Manager: gateway

ONTAP: Armazenamento

OBTER

API Gateway: /gateways/{uuid}/{path}

API do ONTAP: /storage/volumes/{uuid}
Observação

No /gateways/{uuid}/{path}, o valor de {uuid} tem de ser substituído pelo UUID do cluster no qual a operação DE REPOUSO deve ser executada. {path} Deve ser substituído pelo URL REST do ONTAP /storage/volumes/{uuid} .

O URL anexado é: /gateways/{cluster_uuid}/storage/volumes/{volume_uuid}

Ao executar a GET operação, o URL gerado é: GEThttps://<hostname>/api/gateways/<cluster_UUID>/storage/volumes/{volume_uuid}

  • Sample curl comando*

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. A partir da saída, determine o tamanho, o uso e a medida corretiva a ser tomada. Neste fluxo de trabalho, a medida corretiva tomada é redimensionar o volume.

  2. Use o UUUID do cluster e execute a seguinte API do ONTAP através do gateway da API para redimensionar o volume. Para obter informações sobre os parâmetros de entrada para o gateway e as APIs do ONTAP, consulte a etapa 5.

Categoria Verbo HTTP Caminho

Unified Manager: gateway

ONTAP: Armazenamento

PATCH

API Gateway: /gateways/{uuid}/{path}

API do ONTAP: /storage/volumes/{uuid}
Observação

Juntamente com o cluster UUID e UUUID de volume, você deve inserir um valor para o size parâmetro para redimensionar o volume. Certifique-se de inserir o valor em bytes. Por exemplo, se você quiser aumentar o tamanho de um volume de 100 GB para 120 GB, digite o valor do parâmetro size no final da consulta: -d {\"size\": 128849018880}"

  • Sample curl comando*

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

A saída JSON retorna um UUID de trabalho.

  1. Verifique se a tarefa foi executada com êxito usando o UUUID da tarefa. Use o UUUID do cluster e UUUID da tarefa para executar a seguinte API do ONTAP através do gateway da API. Para obter informações sobre os parâmetros de entrada para o gateway e as APIs do ONTAP, consulte a etapa 5.

Categoria Verbo HTTP Caminho

Unified Manager: gateway

ONTAP: Cluster

OBTER

API Gateway: /gateways/{uuid}/{path}

API do ONTAP: /cluster/jobs/{uuid}

Os códigos HTTP retornados são os mesmos que os códigos de status HTTP API REST do ONTAP.

  1. Execute a seguinte API ONTAP para consultar os detalhes do volume redimensionado. Para obter informações sobre os parâmetros de entrada para o gateway e as APIs do ONTAP, consulte a etapa 5.

Categoria Verbo HTTP Caminho

Unified Manager: gateway

ONTAP: Armazenamento

OBTER

API Gateway: /gateways/{uuid}/{path}

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

A saída exibe um tamanho de volume aumentado de 120 GB.