Skip to main content
ONTAP tools for VMware vSphere 105
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.

Faça sua primeira chamada à API REST das ONTAP tools

Colaboradores netapp-revathid
PDFs

Você pode fazer uma chamada de API usando curl para começar a usar o ONTAP tools for VMware vSphere 10 API REST.

Antes de começar

Você deve revisar as informações e os parâmetros necessários nos exemplos do curl.

Informações necessárias

Você precisa do seguinte:

  • ONTAP tools for VMware vSphere 10, endereço IP ou domínio totalmente qualificado, assim como a porta

  • Credenciais do administrador do ONTAP tools Manager (nome de usuário e senha)

Parâmetros e variáveis

Os exemplos de curl apresentados abaixo incluem variáveis no estilo Bash. Você pode definir essas variáveis no ambiente Bash ou atualizá-las manualmente antes de executar os comandos. Se você definir as variáveis, o shell substituirá os valores em cada comando antes de executá-lo. As variáveis são descritas na tabela abaixo.

Variável Descrição

$FQDN_IP_PORT

O nome de domínio totalmente qualificado ou endereço IP do ONTAP tools Manager, juntamente com o número da porta.

$MYUSER

Nome de usuário para a conta do Gerenciador de ferramentas ONTAP.

$MYPASSWORD

Senha associada ao nome de usuário do Gerenciador de ferramentas ONTAP.

$ACCESS_TOKEN

O token de acesso emitido pelo ONTAP tools Manager.

Os comandos e a respectiva saída na linha de comando do Linux ilustram como uma variável pode ser definida e exibida:

FQDN_IP_PORT=172.14.31.224:8443
echo $FQDN_IP
172.14.31.224:8443

Etapa 1: obtenha um token de acesso

Você precisa obter um token de acesso para usar a API REST. Um exemplo de como solicitar um token de acesso é apresentado abaixo. Você deve substituir os valores apropriados para o seu ambiente.

curl --request POST \
--location "https://$FQDN_IP_PORT/virtualization/api/v1/auth/login” \
--header "Content-Type: application/json" \
--header "Accept: */*" \
-d "{"username": "$MYUSER", "password": "$MYPASSWORD"}"

Copie e salve o token de acesso fornecido na resposta.

Etapa 2: faça a chamada à API REST

Após obter um token de acesso, você pode usar o curl para fazer uma chamada à API REST. Inclua o token de acesso obtido na primeira etapa.

Exemplo de curl
curl --request GET \
--location "https://$FQDN_IP_PORT/virtualization/api/v1/vcenters" \
--header "Accept: */*" \
--header "x-auth: $ACCESS_TOKEN"

A resposta JSON inclui uma lista das instâncias do VMware vCenter configuradas no ONTAP tools Manager.