Status eines Audits abrufen

Sie können den Status einer laufenden Prüfung abrufen, die Sie mit Audit Manager oder Compliance Manager gestartet haben. Audits können sehr lange dauern. Wenn Sie diesen Status im Blick behalten, können Sie den Fortschritt des Audits während der Ausführung verfolgen.

Hinweis

  • Prüfen Sie, ob Sie eine der folgenden IAM-Rollen haben:

  • Suchen Sie die Prüfung, deren Status Sie abrufen möchten.

Status eines laufenden Audits abrufen

Console

  1. Rufen Sie in der Google Cloud Console die Seite Audits ansehen auf.

    Zu „Audits ansehen“

  2. Auf der Seite Bewertungen ansehen können Sie den aktuellen Status eines laufenden Audits einsehen oder weitere Informationen zu einem abgeschlossenen Audit abrufen.

  3. Wenn Sie weitere Informationen zur Prüfung aufrufen möchten, klicken Sie auf den Link in der Spalte Status.

  4. Klicken Sie auf den Namen der Prüfung, um weitere Informationen dazu aufzurufen.

gcloud

Der Befehl gcloud audit-manager operations describe beschreibt einen Audit-Vorgang.

Ersetzen Sie folgende Werte, bevor sie einen der Befehlsdaten verwenden:

  • RESOURCE_TYPE: Der Ressourcentyp. Gültige Werte sind organization, folder und project.
  • RESOURCE_ID: die Ressourcen-ID der Organisation, des Projekts oder des Ordners. Beispiel: 8767234
  • LOCATION: der Standort des Audit Manager API-Endpunkt. Eine Liste der verfügbaren Endpunkte finden Sie unter Audit Manager-Standorte. Beispiel: us-central1.
  • AUDIT_OPERATION_ID: Die eindeutige ID für den laufenden Vorgang, die im Antworttext enthalten war, als Sie die Prüfung ausgeführt haben. Beispiel: 098234.

Führen Sie folgenden Befehl aus:

Linux, macOS oder Cloud Shell

gcloud audit-manager operations describe AUDIT_OPERATION_ID \
    --RESOURCE_TYPE=RESOURCE_ID \
    --location=LOCATION

Windows (PowerShell)

gcloud audit-manager operations describe AUDIT_OPERATION_ID `
    --RESOURCE_TYPE=RESOURCE_ID `
    --location=LOCATION

Windows (cmd.exe)

gcloud audit-manager operations describe AUDIT_OPERATION_ID ^
    --RESOURCE_TYPE=RESOURCE_ID ^
    --location=LOCATION

Eine erfolgreiche Antwort enthält einen der folgenden Ausführungsstatustypen:

Statustyp Beschreibung
OPERATION_STATE_UNSPECIFIED Ein ungültiger Status.
OPERATION_STATE_NOT_STARTED Die Erstellung des Prüfberichts hat noch nicht begonnen.
OPERATION_STATE_EVALUATION_IN_PROGRESS Audit Manager wertet die Ressourcen anhand von Compliance-Kontrollen aus.
OPERATION_STATE_EVALUATION_DONE Audit Manager hat die Compliancebewertung abgeschlossen.
OPERATION_STATE_EVIDENCE_REPORT_GENERATION_IN_PROGRESS Audit Manager erstellt einen Auditbericht aus den ausgewerteten Daten.
OPERATION_STATE_EVIDENCE_REPORT_GENERATION_DONE Audit Manager hat die Erstellung des Prüfberichts abgeschlossen.
OPERATION_STATE_EVIDENCE_UPLOAD_IN_PROGRESS Audit Manager lädt den Auditbericht und die Nachweise an das Ziel hoch.
OPERATION_STATE_DONE Der Prüfbericht wurde erstellt.
OPERATION_STATE_FAILED Die Erstellung des Prüfberichts ist fehlgeschlagen.

Für jeden Ausführungsstatustyp können gegebenenfalls die folgenden zusätzlichen Informationen angezeigt werden:

Zusätzlicher Status Beschreibung
failure_reason Wenn die Auditbewertung fehlschlägt, wird in diesem Feld der Grund für den Fehler angegeben.
evaluation_percent_complete Wenn die Bewertung begonnen hat, wird in diesem Feld der Fortschritt in Prozent angegeben. Wenn der Prozess noch nicht gestartet wurde, beginnt das Feld bei 0. Wenn der Vorgang abgeschlossen ist, wird das Feld auf 100 gesetzt.
report_generation_percent_complete Wenn die Berichterstellung gestartet wurde, wird in diesem Feld der Fortschritt in Prozent angegeben. Wenn der Prozess noch nicht gestartet wurde, beginnt das Feld bei 0. Wenn der Vorgang abgeschlossen ist, wird das Feld auf 100 gesetzt.
report_uploading_percent_complete Wenn der Berichtsupload gestartet wurde, wird in diesem Feld der Fortschritt in Prozent angegeben. Wenn der Prozess noch nicht gestartet wurde, beginnt das Feld bei 0. Wenn der Vorgang abgeschlossen ist, wird das Feld auf 100 gesetzt.

Eine erfolgreiche gcloud-Antwort sieht in etwa so aus:

done: true
name: projects/PROJECT_ID/locations/LOCATION/operationDetails/AUDIT_OPERATION_ID
response:
  '@type': type.googleapis.com/google.cloud.auditmanager.v1.AuditReport
  gcsUri: gs://testbucketauditmanager

REST

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

  • RESOURCE_TYPE: Der Ressourcentyp. Gültige Werte sind organizations, folders und projects.
  • RESOURCE_ID: die Ressourcen-ID der Organisation, des Projekts oder des Ordners. Beispiel: 8767234
  • LOCATION: der Standort des Audit Manager API-Endpunkt. Eine Liste der verfügbaren Endpunkte finden Sie unter Audit Manager-Standorte. Beispiel: us-central1.
  • AUDIT_OPERATION_ID: Die eindeutige ID für den laufenden Vorgang, die im Antworttext enthalten war, als Sie die Prüfung ausgeführt haben. Beispiel: 098234.

HTTP-Methode und URL: 

GET https://auditmanager.googleapis.com/v1/RESOURCE_TYPE/RESOURCE_ID/locations/LOCATION//operationDetails/AUDIT_OPERATION_ID

Senden Sie die Anfrage mithilfe einer der folgenden Optionen:

curl

Führen Sie folgenden Befehl aus: 

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://auditmanager.googleapis.com/v1/RESOURCE_TYPE/RESOURCE_ID/locations/LOCATION//operationDetails/AUDIT_OPERATION_ID"

PowerShell

Führen Sie diesen Befehl aus:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://auditmanager.googleapis.com/v1/RESOURCE_TYPE/RESOURCE_ID/locations/LOCATION//operationDetails/AUDIT_OPERATION_ID" | Select-Object -Expand Content

Eine erfolgreiche Antwort enthält einen der folgenden Ausführungsstatustypen:

Statustyp Beschreibung
OPERATION_STATE_UNSPECIFIED Ein ungültiger Status.
OPERATION_STATE_NOT_STARTED Die Erstellung des Prüfberichts hat noch nicht begonnen.
OPERATION_STATE_EVALUATION_IN_PROGRESS Audit Manager wertet die Ressourcen anhand von Compliance-Kontrollen aus.
OPERATION_STATE_EVALUATION_DONE Audit Manager hat die Compliancebewertung abgeschlossen.
OPERATION_STATE_EVIDENCE_REPORT_GENERATION_IN_PROGRESS Audit Manager erstellt einen Auditbericht aus den ausgewerteten Daten.
OPERATION_STATE_EVIDENCE_REPORT_GENERATION_DONE Audit Manager hat die Erstellung des Prüfberichts abgeschlossen.
OPERATION_STATE_EVIDENCE_UPLOAD_IN_PROGRESS Audit Manager lädt den Auditbericht und die Nachweise an das Ziel hoch.
OPERATION_STATE_DONE Der Prüfbericht wurde erstellt.
OPERATION_STATE_FAILED Die Erstellung des Prüfberichts ist fehlgeschlagen.

Für jeden Ausführungsstatustyp können gegebenenfalls die folgenden zusätzlichen Informationen angezeigt werden:

Zusätzlicher Status Beschreibung
failure_reason Wenn die Auditbewertung fehlschlägt, wird in diesem Feld der Grund für den Fehler angegeben.
evaluation_percent_complete Wenn die Bewertung begonnen hat, wird in diesem Feld der Fortschritt in Prozent angegeben. Wenn der Prozess noch nicht gestartet wurde, beginnt das Feld bei 0. Wenn der Vorgang abgeschlossen ist, wird das Feld auf 100 gesetzt.
report_generation_percent_complete Wenn die Berichterstellung gestartet wurde, wird in diesem Feld der Fortschritt in Prozent angegeben. Wenn der Prozess noch nicht gestartet wurde, beginnt das Feld bei 0. Wenn der Vorgang abgeschlossen ist, wird das Feld auf 100 gesetzt.
report_uploading_percent_complete Wenn der Berichtsupload gestartet wurde, wird in diesem Feld der Fortschritt in Prozent angegeben. Wenn der Prozess noch nicht gestartet wurde, beginnt das Feld bei 0. Wenn der Vorgang abgeschlossen ist, wird das Feld auf 100 gesetzt.

Eine erfolgreiche REST-Antwort sieht in etwa so aus:

{
  "name": "projects/PROJECT_ID/locations/LOCATION/operationDetails/AUDIT_OPERATION_ID",
  "done": true,
  "response": {
    "@type": "type.googleapis.com/google.cloud.auditmanager.v1.AuditReport",
    "gcsUri": "gs://testbucketauditmanager"
  }
}

Wenn ein Auditbericht fertiggestellt und hochgeladen wurde, wird ein Link zum Bericht zurückgegeben.

Nächste Schritte