Status eines Audits abrufen

Auf dieser Seite wird beschrieben, wie Sie den Status einer laufenden Prüfung abrufen, die Sie mit Audit Manager oder Compliance Manager gestartet haben. Prüfungen sind Vorgänge mit langer Ausführungszeit. Es kann hilfreich sein, den Status einer Prüfung abzurufen, während der Vorgang ausgeführt wird.

Hinweis

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

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

Status einer laufenden Prüfung abrufen

Console

  1. Rufen Sie in der Google Cloud Console die Seite Prüfungen ansehen auf.

    Zu „Prüfungen ansehen“

  2. Auf der Seite Bewertungen ansehen können Sie den aktuellen Status einer laufenden Prüfung ansehen oder weitere Informationen zu einer abgeschlossenen Prüfung abrufen.

  3. Klicken Sie in der Spalte Status auf den Link, um weitere Informationen zur Prüfung aufzurufen.

gcloud

Mit dem gcloud audit-manager operations describe Befehl wird ein Prüfungsvorgang beschrieben.

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

  • RESOURCE_TYPE: Der Ressourcentyp, entweder ein Projekt oder ein Ordner. Beispiel: folders oder projects.
  • RESOURCE_ID: Die Ressourcen-ID des Projekts oder 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 wurde noch nicht gestartet.
OPERATION_STATE_EVALUATION_IN_PROGRESS Audit Manager bewertet die Ressourcen anhand von Compliance-Kontrollen.
OPERATION_STATE_EVALUATION_DONE Audit Manager hat die Compliance-Bewertung abgeschlossen.
OPERATION_STATE_EVIDENCE_REPORT_GENERATION_IN_PROGRESS Audit Manager erstellt einen Prüfbericht aus den bewerteten 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 Prüfbericht und die Nachweise an das Ziel hoch.
OPERATION_STATE_DONE Die Erstellung des Prüfberichts ist abgeschlossen.
OPERATION_STATE_FAILED Die Erstellung des Prüfberichts ist fehlgeschlagen.

Für jeden Ausführungsstatustyp können gegebenenfalls die folgenden zusätzlichen Informationen verfügbar sein:

Zusätzlicher Status Beschreibung
failure_reason Wenn die Prüfungsbewertung fehlschlägt, wird in diesem Feld der Grund für den Fehler angegeben.
evaluation_percent_complete Wenn die Bewertung gestartet wurde, wird in diesem Feld der Fortschritt in Prozent angegeben. Wenn der Vorgang 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 Vorgang 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 das Hochladen des Berichts gestartet wurde, wird in diesem Feld der Fortschritt in Prozent angegeben. Wenn der Vorgang 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, entweder ein Projekt oder ein Ordner. Beispiel: folders oder projects.
  • RESOURCE_ID: Die Ressourcen-ID des Projekts oder 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 folgenden 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 wurde noch nicht gestartet.
OPERATION_STATE_EVALUATION_IN_PROGRESS Audit Manager bewertet die Ressourcen anhand von Compliance-Kontrollen.
OPERATION_STATE_EVALUATION_DONE Audit Manager hat die Compliance-Bewertung abgeschlossen.
OPERATION_STATE_EVIDENCE_REPORT_GENERATION_IN_PROGRESS Audit Manager erstellt einen Prüfbericht aus den bewerteten 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 Prüfbericht und die Nachweise an das Ziel hoch.
OPERATION_STATE_DONE Die Erstellung des Prüfberichts ist abgeschlossen.
OPERATION_STATE_FAILED Die Erstellung des Prüfberichts ist fehlgeschlagen.

Für jeden Ausführungsstatustyp können gegebenenfalls die folgenden zusätzlichen Informationen verfügbar sein:

Zusätzlicher Status Beschreibung
failure_reason Wenn die Prüfungsbewertung fehlschlägt, wird in diesem Feld der Grund für den Fehler angegeben.
evaluation_percent_complete Wenn die Bewertung gestartet wurde, wird in diesem Feld der Fortschritt in Prozent angegeben. Wenn der Vorgang 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 Vorgang 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 das Hochladen des Berichts gestartet wurde, wird in diesem Feld der Fortschritt in Prozent angegeben. Wenn der Vorgang 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 Prüfbericht fertiggestellt und hochgeladen wurde, wird ein Link zum Bericht zurückgegeben.

Nächste Schritte