Status eines Audits abrufen

Auf dieser Seite wird beschrieben, wie Sie den Status einer laufenden Prüfung in Audit Manager abrufen. 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.

Hinweise

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

  • Audit Manager-Administrator (roles/auditmanager.admin)
  • Audit Manager-Auditor (roles/auditmanager.auditor)

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

Status einer laufenden Prüfung abrufen

Console

1. Rufen Sie in der Google Cloud Console die Seite Audit Manager auf.

   Audit Manager aufrufen

2. Klicken Sie im Bereich Compliance audits (Compliance-Prüfungen) auf View audits (Prüfungen ansehen).

3. Auf der Seite View assessments (Prüfungen ansehen) können Sie den aktuellen Status einer laufenden Prüfung einsehen oder weitere Informationen zu einer abgeschlossenen Prüfung abrufen.

4. Wenn Sie weitere Informationen zum Audit aufrufen möchten, klicken Sie in der Spalte Status auf den Link.

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, entweder ein Projekt oder ein Ordner. Beispiel: folder
• RESOURCE_ID: Die Ressourcen-ID des Projekts oder Ordners. Beispiel: 8767234
• LOCATION: Der Speicherort des Audit Manager API-Endpunkt. Eine Liste der verfügbaren Endpunkte finden Sie unter 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

Hinweis: Prüfen Sie, ob die Google Cloud CLI mit Authentifizierung und einem Projekt initialisiert wurde. Führen Sie dazu gcloud init oder gcloud auth login und gcloud config set project aus.

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

Windows (PowerShell)

Hinweis: Prüfen Sie, ob die Google Cloud CLI mit Authentifizierung und einem Projekt initialisiert wurde. Führen Sie dazu gcloud init oder gcloud auth login und gcloud config set project aus.

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

Windows (cmd.exe)

Hinweis: Prüfen Sie, ob die Google Cloud CLI mit Authentifizierung und einem Projekt initialisiert wurde Führen Sie dazu gcloud init oder gcloud auth login und gcloud config set project aus.

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

REST

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

• RESOURCE_TYPE: Der Ressourcentyp, entweder ein Projekt oder ein Ordner. Beispiel: folder
• RESOURCE_ID: Die Ressourcen-ID des Projekts oder Ordners. Beispiel: 8767234
• LOCATION: Der Speicherort des Audit Manager API-Endpunkt. Eine Liste der verfügbaren Endpunkte finden Sie unter 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/RESOURCE_TYPE/RESOURCE_ID/locations/LOCATION//operationDetails/AUDIT_OPERATION_ID

Senden Sie die Anfrage mithilfe einer der folgenden Optionen:

curl

Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto in der gcloud-Befehlszeile angemeldet haben, indem Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt haben, die Sie automatisch in der gcloud-Befehlszeile anmeldet. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

Führen Sie folgenden Befehl aus:

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

PowerShell

Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto in der gcloud-Befehlszeile angemeldet haben, indem Sie gcloud init oder gcloud auth login ausgeführt haben. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

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/RESOURCE_TYPE/RESOURCE_ID/locations/LOCATION//operationDetails/AUDIT_OPERATION_ID" | Select-Object -Expand Content

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

  
Status type
  
Description
  

  
OPERATION_STATE_UNSPECIFIED
  
An invalid state.
  
  

  
OPERATION_STATE_NOT_STARTED
  
The audit report generation process has not yet started.
  
  

  
OPERATION_STATE_EVALUATION_IN_PROGRESS
  
Audit Manager is evaluating the resources against compliance
   controls.
  
  

  
OPERATION_STATE_EVALUATION_DONE
  
Audit Manager has completed
    compliance evaluation.
  
    

  
OPERATION_STATE_EVIDENCE_REPORT_GENERATION_IN_PROGRESS
  
Audit Manager is creating an audit report from the evaluated data.
  
  

  
OPERATION_STATE_EVIDENCE_REPORT_GENERATION_DONE
  
Audit Manager has completed the generation of the audit report.
  
  

  
OPERATION_STATE_EVIDENCE_UPLOAD_IN_PROGRESS
  
Audit Manager is uploading the audit report and evidence to the destination.
  
  

  
OPERATION_STATE_DONE
  
The audit report generation process is completed.
  
  

  
OPERATION_STATE_FAILED
  
The audit report generation process has failed.
  


  
Each of the execution status types might provide any of the following additional information, when applicable:

  

  
Additional status
  
Description
  

  
failure_reason
  
If the audit assessment fails, this field
   provides the reason for the failure.
  
  

  
evaluation_percent_complete
  
If evaluation has started, this
    field provides the percentage of the progress.
    When the process is yet to start, the field starts at 0.
    When the process is concluded, the field is
    set to 100.
  
  

  
report_generation_percent_complete
  
If the report generation has started, this
    field provides percentage of the progress. When the process is yet to start,
    the field starts at 0. When the process is concluded, the field is
    set to 100.
  
  

  
report_uploading_percent_complete
  
If the report uploading has started, this
    field provides percentage of the progress. When the process is yet to start,
    the field starts at 0. When the process is concluded, the field is set to 100.
  
  

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

Nächste Schritte

• Prüfbericht ansehen