Haz tu primera llamada a la API de REST de ONTAP tools
Sugerir cambios
PDF
Puedes realizar una llamada a la API de REST mediante curl para empezar a utilizar las ONTAP tools for VMware vSphere 10 API de REST.
Antes de empezar
Deberías revisar la información y los parámetros necesarios en los ejemplos de curl.
Necesitas lo siguiente:
-
ONTAP tools for VMware vSphere 10: dirección IP o dominio completo (FQDN), así como el puerto
-
Credenciales para el administrador de ONTAP tools Manager (nombre de usuario y contraseña)
Los ejemplos de curl que se muestran a continuación incluyen variables al estilo de Bash. Puedes configurar estas variables en el entorno de Bash o actualizarlas manualmente antes de ejecutar los comandos. Si configuras las variables, el shell sustituirá los valores en cada comando antes de que se ejecute. Las variables se describen en la tabla siguiente.
| Variable | Descripción |
|---|---|
$FQDN_IP_PORT |
El nombre de dominio completo o la dirección IP de ONTAP tools Manager junto con el número de puerto. |
$MYUSER |
Nombre de usuario para la cuenta de ONTAP tools Manager. |
$MYPASSWORD |
Contraseña asociada con el nombre de usuario de ONTAP tools Manager. |
$ACCESS_TOKEN |
El token de acceso emitido por ONTAP tools Manager. |
Los siguientes comandos y resultados en la línea de comandos de Linux muestran cómo se puede establecer y visualizar una variable:
FQDN_IP_PORT=172.14.31.224:8443 echo $FQDN_IP 172.14.31.224:8443
Paso 1: adquirir un token de acceso
Para utilizar la API de REST, debes obtener un token de acceso. A continuación se muestra un ejemplo de cómo solicitar un token de acceso. Debes sustituir los valores por los correspondientes a tu entorno.
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"}"Copia y guarda el token de acceso proporcionado en la respuesta.
Paso 2: Realizar la llamada a la API de REST
Una vez que tengas un token de acceso, puedes utilizar curl para realizar una llamada a la API de REST. Incluye el token de acceso obtenido en el primer paso.
curl --request GET \
--location "https://$FQDN_IP_PORT/virtualization/api/v1/vcenters" \
--header "Accept: */*" \
--header "x-auth: $ACCESS_TOKEN"La respuesta JSON incluye una lista de las instancias de VMware vCenter configuradas en ONTAP tools Manager.