Las API de VMware Cloud se utilizan para recuperar un informe de estado del SDDC de VMware Site Recovery.

Recuperar un token de API para su organización

El token de API es una forma de autenticación similar al nombre de usuario y la contraseña de una organización específica en VMware Cloud Services.

Un token de API caduca en 6 meses de forma predeterminada. Puede cambiar el TTL al crear el token de API.

Procedimiento

  1. Inicie sesión en https://vmc.vmware.com/.
  2. Haga clic en el nombre de usuario en la parte superior derecha y cambie a la organización que desea utilizar.
  3. Desplácese hasta Mi cuenta > Tokens de API > Generar un nuevo token de API.
  4. Introduzca el nombre del token, el TTL, los ámbitos, etc.
    En el cuadro de ámbitos, seleccione Todas las funciones.
  5. Haga clic en Generar.

Qué hacer a continuación

Después de generar el token de API, copie y registre el valor del token.

Recuperar un token de autenticación mediante un token de API

Debe tener un token de autenticación válido para utilizar las API de VMware Cloud.

Requisitos previos

Compruebe que ha recuperado un token de API.

Procedimiento

  1. (opcional) En Linux, utilice el siguiente comando para obtener el token de autenticación.
    export REFRESH_TOKEN=...
    export AUTH_TOKEN=$(curl "https://console.cloud.vmware.com/csp/gateway/am/api/auth/api-tokens/authorize" -X POST -d "api_token=$REFRESH_TOKEN" | jq -r .access_token)
    export DRAAS_BACKEND_URL=https://vmc.vmware.com
    export ORG_ID=...
    export SDDC_ID=...
  2. (opcional) En Windows PowerShell, ejecute el siguiente comando.
    $REFRESH_TOKEN="..."
    $AUTH_TOKEN=Invoke-WebRequest -Method Post -Uri "https://console.cloud.vmware.com/csp/gateway/am/api/auth/api-tokens/authorize" -Body @{"api_token" = $REFRESH_TOKEN} | ConvertFrom-Json | Select-Object -ExpandProperty access_token
    $DRAAS_BACKEND_URL="https://vmc.vmware.com"
    $ORG_ID="..."
    $SDDC_ID="..."

Recuperar un informe de estado del SDDC de VMware Site Recovery

Después de adquirir el token de autenticación y recibir el correo electrónico VMware Site Recovery - Informe de estado de Site Recovery, puede comprobar los informes de estado de los SDDC.

Procedimiento

  1. Para recuperar el informe de estado en formato JSON, copie cada elemento curl del correo electrónico.
    curl "https://vmc.vmware.com/api/vsr-guardrails/{{org-id}}/deployments/{{sddc-id}}/site-recovery-health-report" -X GET -H "csp-auth-token: $AUTH_TOKEN"

    Para formatear la salida json y facilitar la legibilidad, puede agregar el comando jq.

    curl "https://vmc.vmware.com/api/vsr-guardrails/{{org-id}}/deployments/{{sddc-id}}/site-recovery-health-report" -X GET -H "csp-auth-token: $AUTH_TOKEN" | jq . 

    Puede redireccionar el resultado a un archivo JSON.

    curl "https://vmc.vmware.com/api/vsr-guardrails/{{org-id}}/deployments/{{sddc-id}}/site-recovery-health-report" -X GET -H "csp-auth-token: $AUTH_TOKEN" | jq . > example.json
  2. Para recuperar el informe de estado en formato HTML, copie cada elemento curl del correo electrónico.
    curl "https://vmc.vmware.com/api/vsr-guardrails/{{org-id}}/deployments/{{sddc-id}}/site-recovery-health-html-report" -X GET -H "csp-auth-token: $AUTH_TOKEN"
    Puede redireccionar el resultado a un archivo HTML.
    curl "https://vmc.vmware.com/api/vsr-guardrails/{{org-id}}/deployments/{{sddc-id}}/site-recovery-health-html-report" -X GET -H "csp-auth-token: $AUTH_TOKEN" > example.html