Mit den VMware Cloud-APIs können Sie einen Integritätsbericht für Ihr VMware Site Recovery-SDDC abrufen.

Abrufen eines API-Tokens für Ihre Organisation

Das API-Token ist eine Authentifizierungsform für eine bestimmte Organisation in VMware Cloud Services, ähnlich wie Benutzername und Kennwort.

Ein API-Token läuft standardmäßig in 6 Monaten ab. Sie können die TTL ändern, wenn Sie das API-Token erstellen.

Prozedur

  1. Melden Sie sich bei https://vmc.vmware.com/ an.
  2. Klicken Sie oben rechts auf Ihren Benutzernamen und wechseln Sie dann zu der Organisation, die Sie verwenden möchten.
  3. Navigieren Sie zu Mein Konto > API-Token > Neues API-Token generieren.
  4. Geben Sie den Tokennamen, TTL, Geltungsbereiche usw. ein.
    Wählen Sie im Feld „Geltungsbereiche“ die Option Alle Rollen aus.
  5. Klicken Sie auf Generieren.

Nächste Maßnahme

Nachdem das API-Token generiert wurde, kopieren Sie den Tokenwert und zeichnen Sie ihn auf.

Abrufen eines Authentifizierungstokens mithilfe eines API-Tokens

Sie benötigen ein gültiges Authentifizierungstoken, um die VMware Cloud-APIs verwenden zu können.

Voraussetzungen

Stellen Sie sicher, dass Sie ein API-Token abgerufen haben.

Prozedur

  1. (Optional) Verwenden Sie für Linux den folgenden Befehl zum Abrufen des Authentifizierungstokens.
    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. (Optional) Führen Sie für Windows PowerShell den folgenden Befehl aus.
    $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="..."

Abrufen eines Integritätsberichts für das VMware Site Recovery-SDDC

Wenn Sie das Authentifizierungstoken abgerufen und die E-Mail „VMware Site Recovery – Site Recovery-Integritätsbericht“ erhalten haben, können Sie die Integritätsberichte für die SDDCs überprüfen.

Prozedur

  1. Um den Integritätsbericht im JSON-Format abzurufen, kopieren Sie jedes curl-Element aus der 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"

    Zum Formatieren der JSON-Ausgabe zur einfacheren Lesbarkeit können Sie den Befehl jq hinzufügen.

    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 . 

    Sie können das Ergebnis in eine JSON-Datei umleiten.

    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. Um den Integritätsbericht im HTML-Format abzurufen, kopieren Sie jedes curl-Element aus der 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"
    Sie können das Ergebnis in eine HTML-Datei umleiten.
    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