Vous pouvez utiliser les API VMware Cloud pour récupérer un rapport de santé pour votre SDDC VMware Site Recovery.

Récupérer un jeton d'API pour votre organisation

Le jeton d'API est une forme d'authentification qui est semblable à l'utilisation d'un nom d'utilisateur et d'un mot de passe pour une organisation spécifique sur VMware Cloud Services.

Un jeton d'API expire au bout de 6 mois par défaut. Vous pouvez modifier cette durée de vie lorsque vous créez le jeton d'API.

Procédure

  1. Connectez-vous à https://vmc.vmware.com/.
  2. Cliquez sur votre nom d'utilisateur en haut à droite, puis basculez vers l'organisation que vous souhaitez utiliser.
  3. Accédez à Mon compte > Jetons d'API > Générer un nouveau jeton d'API.
  4. Entrez le nom du jeton, la durée de vie, les portées, etc.
    Dans la zone des portées, sélectionnez Tous les rôles.
  5. Cliquez sur Générer.

Que faire ensuite

Une fois le jeton d’API généré, copiez et enregistrez la valeur du jeton.

Récupérer un jeton d'authentification à l'aide d'un jeton d'API

Vous devez disposer d'un jeton d'authentification valide pour utiliser les API VMware Cloud.

Conditions préalables

Vérifiez que vous avez récupéré un jeton d'API.

Procédure

  1. (Facultatif) Pour Linux utilisez la commande suivante pour obtenir un jeton d'authentification.
    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. (Facultatif) Pour Windows Powershell, utilisez la commande suivante.
    $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="..."

Récupérer un rapport de santé pour votre SDDC VMware Site Recovery

Après avoir obtenu le jeton d'authentification et reçu l'e-mail VMware Site Recovery - Rapport de santé de Site Recovery, vous pouvez vérifier les rapports de santé de vos SDDC.

Procédure

  1. Pour récupérer le rapport de santé au format JSON, copiez chaque élément curl à partir de l'e-mail.
    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"

    Pour formater la sortie JSON pour en simplifier la lisibilité, vous pouvez ajouter la commande 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 . 

    Vous pouvez rediriger le résultat vers un fichier 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. Pour récupérer le rapport de santé au format HTML, copiez chaque élément curl à partir de l'e-mail.
    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"
    Vous pouvez rediriger le résultat vers un fichier 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