Como faço para usar o FSx para APIs REST do ONTAP?

Resolução

Pré-requisitos

O solicitante da API deve ser capaz de fazer conexões HTTPS com o sistema de arquivos FSx para ONTAP e com os endpoints da máquina virtual de armazenamento (SVM). Para obter mais informações, consulte Usando a API REST do NetApp ONTAP.

Execute o Hello World no sistema de arquivos FSx para ONTAP com curl

Na interface de linha de comando de uma instância Linux em sua Amazon Virtual Private Cloud (Amazon VPC) executando o sistema de arquivos FSx para ONTAP, faça o seguinte:

1.    Digite sua senha fsxadmin e o nome do DNS do endpoint. No comando de exemplo a seguir, substitua Password (Senha) e fs-XXXXXXXX.fsx.region.amazonaws.com pelos valores corretos para seu caso de uso:

$ CRED=fsxadmin:Password
$ ONTAP=management.fs-XXXXXXXX.fsx.region.amazonaws.com

2.    Execute o comando a seguir para recuperar a versão do software ONTAP:

$ curl -X GET -u ${CRED} -k "https://${ONTAP}/api/cluster?fields=version"
{
  "version": {
    "full": "NetApp Release 9.10.1RC1P1: Sat Nov 27 18:08:32 UTC 2021",
    "generation": 9,
    "major": 10,
    "minor": 1
  },
  "_links": {
    "self": {
      "href": "/api/cluster"
    }
  }
}

Exemplo de API REST: Obter volumes

Veja a seguir um exemplo do comando GET usado para recuperar volumes:

$ curl -X GET -u ${CRED} -k "https://${ONTAP}/api/storage/volumes"
{
  "records": [
    {
      "uuid": "504c8162-a435-11ec-bb13-130f21c56a08",
      "name": "svm1_root",
      "_links": {
        "self": {
          "href": "/api/storage/volumes/504c8162-a435-11ec-bb13-130f21c56a08"
        }
      }
    },
    {
      "uuid": "956f5ce9-a435-11ec-bb13-130f21c56a08",
      "name": "vol1",
      "_links": {
        "self": {
          "href": "/api/storage/volumes/956f5ce9-a435-11ec-bb13-130f21c56a08"
        }
      }
    }
  ],
  "num_records": 2,
  "_links": {
    "self": {
      "href": "/api/storage/volumes"
    }
  }
}

Observação: algumas APIs não são executadas no FSx para ONTAP.

Use a interface NetApp BlueXP API Swagger

Você pode acessar algumas APIs do NetApp ONTAP usando a interface BlueXP r Connector Swagger. Para obter mais informações, consulte Saiba mais sobre o BlueXP e Como efetuar login na interface do API Swagger do BlueXP (antigo Cloud Manager) no site da NetApp.

As etapas a seguir são um exemplo de acesso à interface do Swagger usando o BlueXP e postando credenciais.

1.    No Conector BlueXP, selecione o menu Ajuda, representado por um ponto de interrogação, e selecione API.

Ou acesse a interface do Swagger diretamente (URL de exemplo: http://connectorip/occm/api-doc/).

2.    Selecione Operações de gestão usuários.

3.    Selecione auth: Operações de autenticação.

4.    Selecione POST /auth/login, Expandir operações.

5.    Selecione Esquema do modelo.

6.    Selecione Clique para definir como valor de parâmetro no esquema do modelo que exibe o seguinte:

{
"email": "string",
"password": "string"
}

7.    No campo Valor em que o esquema do modelo é preenchido, edite a string para fornecer seu e-mail e senha corretos:

{
"email": "user@example.com",
"password": "xxxxxxxxxx"
}

Observação: o ID do e-mail não é fsxadmin. O e-mail é o ID de e-mail Cloud Central Auth0 usado para efetuar login no conector BlueXP. A senha é definida em texto simples.

8.    Selecione Experimente agora mesmo

9.    Verifique se o login foi bem-sucedido a partir do Código de resposta.

Exemplo: API de obtenção de volumes usando a interface BlueXP Swagger

1.    Na interface do Swagger, selecione as operações do ambiente de trabalho FSx (cluster de dados do ONTAP).

2.    Selecione fsx/volumes.

3.    Selecione GET /fsx/volumes, Expandir operações.

4.    No campo Valor, insira o ID do sistema de arquivos do qual você deseja recuperar a lista de volumes.

5.    Selecione Experimente agora mesmo

6.    Verifique se o login foi bem-sucedido a partir do Código de resposta e do Corpo da resposta.

---

Informações relacionadas

Scripts de amostra de Python do API REST do ONTAP agora disponíveis no GitHub