Audit planen oder ausführen

Mit Audits können Sie die Nachweise erfassen, die Sie benötigen, um Ihre Organisation anhand von unterstützten Frameworks zu bewerten.Google Cloud Sie können eine Prüfung in regelmäßigen Abständen oder bei Bedarf ausführen lassen.

Eine Prüfung ist ein Vorgang mit langer Ausführungszeit, der einige Stunden dauern kann. Die Dauer hängt von der Anzahl der Ressourcen im Audit-Umfang ab, d. h. von der Organisation, dem Projekt oder dem Ordner, den Sie zuvor registriert haben.

Sie können einen Zeitplan für eine bestimmte Kombination aus Framework und Ressource nur erstellen, wenn für diese Kombination noch kein aktiver oder pausierter Zeitplan vorhanden ist.

Hinweis

• Bitten Sie Ihren Administrator, Ihnen eine der folgenden IAM-Rollen (Identity and Access Management) zuzuweisen, um die Berechtigungen zu erhalten, die Sie zum Ausführen oder Planen einer Prüfung benötigen:

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

• Registrieren Sie Ihre Organisation, Ihr Projekt oder Ihren Ordner für die Prüfung.

Audit planen und ausführen

Sie können einen Zeitplan erstellen, um eine Prüfung regelmäßig auszuführen, oder eine On-Demand-Prüfung ausführen.

Console

1. Rufen Sie in der Google Cloud Console im Audit Manager die Seite Bewertung ausführen auf.

   Audit Manager aufrufen

2. Führen Sie im Abschnitt Ressource und Region auswählen die folgenden Schritte aus:

   1. Wählen Sie die Organisation, den Ordner oder das Projekt aus, das Sie prüfen möchten.

   2. Wählen Sie den Standort aus, an dem die Auditbewertung verarbeitet werden soll. Eine Liste der unterstützten Standorte finden Sie unter Audit Manager-Standorte.

   3. Klicken Sie auf Weiter.

3. Wählen Sie im Abschnitt Verordnung auswählen das Framework aus, anhand dessen Sie Ihre Ressource prüfen möchten, und klicken Sie dann auf Weiter. Informationen zu unterstützten Frameworks finden Sie unter Unterstützte Frameworks.

4. Optional: Wenn der Abschnitt Parameter konfigurieren angezeigt wird, gehen Sie so vor:

   1. Klicken Sie auf Konfiguration ändern.

   2. Fügen Sie im Fenster Parameter konfigurieren die erforderlichen Parameter für die Cloud-Einstellungen hinzu. Weitere Informationen zu den Parametern finden Sie in der Referenz zu Cloud-Kontrollen im Compliance Manager und unter Cloud-Kontrollen für Assured Workloads.

   3. Klicken Sie auf Speichern.

5. Optional: Im Abschnitt Bewertungsplan ansehen können Sie eine ODS-Datei herunterladen, die Informationen zum Audit-Umfang basierend auf dem von Ihnen ausgewählten Framework enthält. Klicken Sie auf den Link, um die Datei herunterzuladen, und dann auf Weiter.

6. Wählen Sie im Abschnitt Storage-Bucket auswählen den Storage-Bucket aus, in dem Sie den Auditbericht und die Nachweise speichern möchten, und klicken Sie dann auf Fertig. Wenn Ihr Bucket nicht aufgeführt ist, bitten Sie Ihren Administrator, Ihre Ressource bei Ihrem Speicher-Bucket zu registrieren.

7. Optional: Legen Sie im Abschnitt Zeitplan eine der folgenden Optionen fest:

   • Wie oft die Prüfung wiederholt werden soll (täglich, wöchentlich, monatlich, vierteljährlich oder jährlich).

   • Der Zeitraum, der in die Prüfung einbezogen werden soll. Wenn Sie Unbegrenzt auswählen, wird die Prüfung ab dem von Ihnen angegebenen Startdatum fortgesetzt, bis Sie sie manuell beenden.

8. Klicken Sie auf Audit ausführen oder Geplantes Audit ausführen, um das Audit zu starten.

   Den Status eines On-Demand-Audits können Sie auf der Seite Bewertungen ansehen einsehen. Ihre geplanten Audits finden Sie auf der Seite Auditverwaltung auf dem Tab Zeitpläne.

gcloud

Optional: Auditbewertung generieren

Bevor Sie ein Audit ausführen, können Sie eine Auditbewertung oder einen Auditbereich generieren, die bzw. der eine detaillierte Aufgabenaufschlüsselung für das Audit basierend auf dem von Ihnen ausgewählten Framework enthält.

Mit dem Befehl gcloud audit-manager audit-scopes generate wird ein Prüfbereich generiert.

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.
• FRAMEWORK: die ID des Frameworks, das geprüft werden soll. Beispiel: builtin-cis-v8 Die ID eines Frameworks finden Sie in der Google Cloud Console auf der Seite Bewertungen ansehen.
• AUDIT_REPORT_FORMAT: das Format des Ausgabe-Auditberichts. Es wird nur das ODF-Format unterstützt: AUDIT_REPORT_FORMAT_ODF.
• OUTPUT_DIRECTORY: das Verzeichnis, in dem die Ausgabe gespeichert werden muss. Beispiel: reports
• OUTPUT_FILENAME: der Name der Ausgabedatei. Geben Sie die Dateiendung nicht im Dateinamen an. Beispiel: scopeReport.

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 audit-scopes generate \
    --RESOURCE_TYPE=RESOURCE_ID \
    --location=LOCATION \
    --compliance-framework=FRAMEWORK \
    --report-format=AUDIT_REPORT_FORMAT \
    --output-directory=OUTPUT_DIRECTORY \
    --output-file-name=OUTPUT_FILENAME

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 audit-scopes generate `
    --RESOURCE_TYPE=RESOURCE_ID `
    --location=LOCATION `
    --compliance-framework=FRAMEWORK `
    --report-format=AUDIT_REPORT_FORMAT `
    --output-directory=OUTPUT_DIRECTORY `
    --output-file-name=OUTPUT_FILENAME

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 audit-scopes generate ^
    --RESOURCE_TYPE=RESOURCE_ID ^
    --location=LOCATION ^
    --compliance-framework=FRAMEWORK ^
    --report-format=AUDIT_REPORT_FORMAT ^
    --output-directory=OUTPUT_DIRECTORY ^
    --output-file-name=OUTPUT_FILENAME

On-Demand-Prüfung ausführen

Mit dem Befehl gcloud audit-manager audit-reports generate wird eine Prüfung ausgeführt.

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.
• FRAMEWORK: die ID des Frameworks, das geprüft werden soll. Beispiel: builtin-cis-v8 Die ID eines Frameworks finden Sie in der Google Cloud Console auf der Seite Bewertungen ansehen.
• BUCKET_URI: der URI des Cloud Storage-Bucket. Beispiel: gs://testbucketauditmanager.
• AUDIT_REPORT_FORMAT: das Format des Ausgabe-Auditberichts. Es wird nur das ODF-Format unterstützt: AUDIT_REPORT_FORMAT_ODF.

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 audit-reports generate \
    --RESOURCE_TYPE=RESOURCE_ID \
    --location=LOCATION \
    --compliance-framework=FRAMEWORK \
    --report-format=AUDIT_REPORT_FORMAT \
    --gcs-uri=BUCKET_URI

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 audit-reports generate `
    --RESOURCE_TYPE=RESOURCE_ID `
    --location=LOCATION `
    --compliance-framework=FRAMEWORK `
    --report-format=AUDIT_REPORT_FORMAT `
    --gcs-uri=BUCKET_URI

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 audit-reports generate ^
    --RESOURCE_TYPE=RESOURCE_ID ^
    --location=LOCATION ^
    --compliance-framework=FRAMEWORK ^
    --report-format=AUDIT_REPORT_FORMAT ^
    --gcs-uri=BUCKET_URI

Sie sollten eine Antwort ähnlich der folgenden erhalten:

done: false
name: projects/10398413/locations/987234/operations/operation-1726842525305-6228ddb4dca96-78a6db59-f9dd9a24

Audit planen

Mit dem Befehl gcloud audit-manager audit-schedules create wird ein Prüfzeitplan erstellt.

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_SCHEDULE_ID: die ID des Prüfzeitplans. Beispiel: my-schedule-id Die ID eines vorhandenen Zeitplans finden Sie in der Google Cloud Console auf der Seite Audit-Verwaltung.
• FRAMEWORK: die ID des Frameworks, das geprüft werden soll. Beispiel: builtin-cis-v8 Die ID eines Frameworks finden Sie in der Google Cloud Console auf der Seite Bewertungen ansehen.
• AUDIT_REPORT_FORMAT: das Format des ausgegebenen Auditberichts. Es wird nur das OpenDocument-Format (ODF) unterstützt: odf.
• BUCKET_URI: der URI des Cloud Storage-Bucket. Beispiel: gs://testbucketauditmanager.
• FREQUENCY: die Häufigkeit geplanter Audit-Ausführungen. Gültige Werte sind daily, weekly, monthly, quarterly und annually. Beispiel: weekly.
• SCHEDULE_START_TIME: Datum und Uhrzeit des Beginns des ersten Prüflaufs im RFC 3339-Format. Beispiel: 2026-10-25T10:00:00Z.
• DISPLAY_NAME: optional. Ein Anzeigename für den Prüfzeitplan. Beispiel: NIST 800-53 Weekly Audit.
• SCHEDULE_END_TIME: Optional. Datum und Uhrzeit, zu denen der Prüfzeitplan beendet wird, im RFC 3339-Format. Beispiel: 2027-10-25T10:00:00Z
• TIME_ZONE: optional. Die Zeitzone für den Prüfzeitplan im IANA-Format. Audit Manager verwendet diesen Wert, um die Start- und Endzeit zu interpretieren. Wenn keine Angabe erfolgt, lautet der Standardwert UTC. Beispiel: America/New_York.

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 audit-schedules create \
    --RESOURCE_TYPE=RESOURCE_ID \
    --location=LOCATION \
    --audit-schedule-id=AUDIT_SCHEDULE_ID \
    --compliance-framework=FRAMEWORK \
    --report-format=AUDIT_REPORT_FORMAT \
    --gcs-uri=BUCKET_URI \
    --start-time=SCHEDULE_START_TIME \
    --frequency=FREQUENCY \
    --display-name="DISPLAY_NAME" \
    --end-time=SCHEDULE_END_TIME \
    --time-zone=TIME_ZONE

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 audit-schedules create `
    --RESOURCE_TYPE=RESOURCE_ID `
    --location=LOCATION `
    --audit-schedule-id=AUDIT_SCHEDULE_ID `
    --compliance-framework=FRAMEWORK `
    --report-format=AUDIT_REPORT_FORMAT `
    --gcs-uri=BUCKET_URI `
    --start-time=SCHEDULE_START_TIME `
    --frequency=FREQUENCY `
    --display-name="DISPLAY_NAME" `
    --end-time=SCHEDULE_END_TIME `
    --time-zone=TIME_ZONE

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 audit-schedules create ^
    --RESOURCE_TYPE=RESOURCE_ID ^
    --location=LOCATION ^
    --audit-schedule-id=AUDIT_SCHEDULE_ID ^
    --compliance-framework=FRAMEWORK ^
    --report-format=AUDIT_REPORT_FORMAT ^
    --gcs-uri=BUCKET_URI ^
    --start-time=SCHEDULE_START_TIME ^
    --frequency=FREQUENCY ^
    --display-name="DISPLAY_NAME" ^
    --end-time=SCHEDULE_END_TIME ^
    --time-zone=TIME_ZONE

Sie sollten eine Antwort ähnlich der folgenden erhalten:

complianceFramework: builtin-cis-v8
gcsUri: gs://my-bucket
name: projects/834/locations/us-central1/auditSchedules/my-schedule-id
reportFormat: AUDIT_REPORT_FORMAT_ODF
scheduleConfig:
  frequency: weekly
  startTime: '2026-10-25T10:00:00Z'
state: SCHEDULE_STATE_ACTIVE

REST

Optional: Auditbewertung generieren

Bevor Sie ein Audit ausführen, können Sie eine Auditbewertung oder einen Auditbereich generieren, die bzw. der eine detaillierte Aufgabenaufschlüsselung für das Audit basierend auf dem von Ihnen ausgewählten Framework enthält.

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.
• FRAMEWORK: die ID des Frameworks, das geprüft werden soll. Beispiel: builtin-cis-v8 Die ID eines Frameworks finden Sie in der Google Cloud Console auf der Seite Bewertungen ansehen.
• AUDIT_REPORT_FORMAT: das Format des Ausgabe-Auditberichts. Es wird nur das ODF-Format unterstützt: AUDIT_REPORT_FORMAT_ODF.

HTTP-Methode und URL:

POST https://auditmanager.googleapis.com/v1/RESOURCE_TYPE/RESOURCE_ID/locations/LOCATION/auditScopesReport:generate

JSON-Text der Anfrage:

{
  "compliance_framework" : "FRAMEWORK",
  "report_format" : "AUDIT_REPORT_FORMAT"
}

Wenn Sie die Anfrage senden möchten, wählen Sie eine der folgenden Optionen aus:

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.

Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json und führen Sie den folgenden Befehl aus:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://auditmanager.googleapis.com/v1/RESOURCE_TYPE/RESOURCE_ID/locations/LOCATION/auditScopesReport:generate"

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.

Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json und führen Sie den folgenden Befehl aus:

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

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://auditmanager.googleapis.com/v1/RESOURCE_TYPE/RESOURCE_ID/locations/LOCATION/auditScopesReport:generate" | Select-Object -Expand Content

Sie sollten eine JSON-Antwort ähnlich wie diese erhalten:

{

  "scope_report_contents": "980u43nrf090834uhbkfehf......",
  "name" : "folders/8767234/locations/us-west"
}

Die Antwort enthält die folgenden Informationen:

• scope_report_contents: das Byteformat des Berichtsinhalts, das Sie vor der Überprüfung in das OpenDocument-Format (ODF) konvertieren müssen.
• name: eine eindeutige String-ID der entsprechenden Ressource.

On-Demand-Prüfung ausführen

Wenn Sie eine On-Demand-Prüfung ausführen möchten, senden Sie eine POST-Anfrage an den Endpunkt auditReport:generate.

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.
• FRAMEWORK: die ID des Frameworks, das geprüft werden soll. Beispiel: builtin-cis-v8 Die ID eines Frameworks finden Sie in der Google Cloud Console auf der Seite Bewertungen ansehen.
• BUCKET_URI: der URI des Cloud Storage-Bucket. Beispiel: gs://testbucketauditmanager.
• AUDIT_REPORT_FORMAT: das Format des Ausgabe-Auditberichts. Es wird nur das ODF-Format unterstützt: AUDIT_REPORT_FORMAT_ODF.

HTTP-Methode und URL:

POST https://auditmanager.googleapis.com/v1/RESOURCE_TYPE/RESOURCE_ID/locations/LOCATION/auditReport:generate

JSON-Text der Anfrage:

{
  "destination" : {
    "gcs_uri" : "BUCKET_URI"
  },
  "compliance_framework" : "FRAMEWORK",
  "report_format" : "AUDIT_REPORT_FORMAT"
}

Wenn Sie die Anfrage senden möchten, wählen Sie eine der folgenden Optionen aus:

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.

Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json und führen Sie den folgenden Befehl aus:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://auditmanager.googleapis.com/v1/RESOURCE_TYPE/RESOURCE_ID/locations/LOCATION/auditReport:generate"

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.

Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json und führen Sie den folgenden Befehl aus:

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

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://auditmanager.googleapis.com/v1/RESOURCE_TYPE/RESOURCE_ID/locations/LOCATION/auditReport:generate" | Select-Object -Expand Content

Sie sollten eine JSON-Antwort ähnlich wie diese erhalten:

{
  "name": "organizations/834/projects/10398413/locations/987234/operations/098234",
  "done": false
}

Die Antwort enthält die folgenden Informationen:

• name: Eine eindeutige String-ID für die Anfrage zur Auditbewertung. Verwenden Sie diese Kennung, um den Fortschritt der Auditbewertung zu verfolgen. Beispiel: projects/PROJECT_ID/locations/LOCATION/operations/098234UNIQUE_ID.
• done: ein boolesches Flag, das angibt, ob die Auditbewertung abgeschlossen ist. Dieses Flag wird beim Start des Prozesses auf false gesetzt und ändert sich nach Abschluss der Auditbewertung in true.

Audit planen

Wenn Sie eine wiederkehrende Prüfung planen möchten, senden Sie eine POST-Anfrage an den Endpunkt auditSchedules.

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_SCHEDULE_ID: die ID des Prüfzeitplans. Beispiel: my-schedule-id Die ID eines vorhandenen Zeitplans finden Sie in der Google Cloud Console auf der Seite Audit-Verwaltung.
• FRAMEWORK: die ID des Frameworks, das geprüft werden soll. Beispiel: builtin-cis-v8 Die ID eines Frameworks finden Sie in der Google Cloud Console auf der Seite Bewertungen ansehen.
• BUCKET_URI: der URI des Cloud Storage-Bucket. Beispiel: gs://testbucketauditmanager.
• AUDIT_REPORT_FORMAT: das Format des Ausgabe-Auditberichts. Es wird nur das ODF-Format unterstützt: AUDIT_REPORT_FORMAT_ODF.
• FREQUENCY: die Häufigkeit geplanter Audit-Ausführungen. Gültige Werte sind DAILY, WEEKLY, MONTHLY, QUARTERLY und ANNUALLY. Beispiel: WEEKLY.
• SCHEDULE_START_TIME: Datum und Uhrzeit des Beginns des ersten Prüflaufs im RFC 3339-Format. Beispiel: 2026-10-25T10:00:00Z.
• DISPLAY_NAME: optional. Ein Anzeigename für den Prüfzeitplan. Beispiel: NIST 800-53 Weekly Audit.
• SCHEDULE_END_TIME: Optional. Datum und Uhrzeit, zu denen der Prüfzeitplan beendet wird, im RFC 3339-Format. Beispiel: 2027-10-25T10:00:00Z
• TIME_ZONE: optional. Die Zeitzone für den Prüfzeitplan im IANA-Format. Audit Manager verwendet diesen Wert, um die Start- und Endzeit zu interpretieren. Wenn keine Angabe erfolgt, lautet der Standardwert UTC. Beispiel: America/New_York.

HTTP-Methode und URL:

POST https://auditmanager.googleapis.com/v1/RESOURCE_TYPE/RESOURCE_ID/locations/LOCATION/auditSchedules?auditScheduleId=AUDIT_SCHEDULE_ID

JSON-Text der Anfrage:

{
  "displayName": "DISPLAY_NAME",
  "gcsUri": "BUCKET_URI",
  "complianceFramework": "FRAMEWORK",
  "reportFormat": "AUDIT_REPORT_FORMAT",
  "scheduleConfig": {
    "startTime": "SCHEDULE_START_TIME",
    "endTime": "SCHEDULE_END_TIME",
    "frequency": "FREQUENCY",
    "timeZone": "TIME_ZONE"
  }
}

Wenn Sie die Anfrage senden möchten, wählen Sie eine der folgenden Optionen aus:

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.

Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json und führen Sie den folgenden Befehl aus:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://auditmanager.googleapis.com/v1/RESOURCE_TYPE/RESOURCE_ID/locations/LOCATION/auditSchedules?auditScheduleId=AUDIT_SCHEDULE_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.

Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json und führen Sie den folgenden Befehl aus:

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

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://auditmanager.googleapis.com/v1/RESOURCE_TYPE/RESOURCE_ID/locations/LOCATION/auditSchedules?auditScheduleId=AUDIT_SCHEDULE_ID" | Select-Object -Expand Content

Sie sollten eine JSON-Antwort ähnlich wie diese erhalten:

{
  "name": "projects/834/locations/us-central1/auditSchedules/my-schedule-id",
  "displayName": "My first audit schedule",
  "gcsUri": "gs://my-bucket",
  "complianceFramework": "builtin-cis-v8",
  "reportFormat": "AUDIT_REPORT_FORMAT_ODF",
  "scheduleConfig": {
    "startTime": "2026-10-25T10:00:00Z",
    "endTime": "2027-10-25T10:00:00Z",
    "frequency": "WEEKLY",
    "timeZone": "America/New_York"
  },
  "state": "SCHEDULE_STATE_ACTIVE",
  "createTime": "2026-10-25T13:27:00Z",
  "updateTime": "2026-10-25T13:27:00Z"
}

Geplante Audits ansehen

Sie können Details zu Ihren geplanten Audits aufrufen, einschließlich Umfang, Framework und Zeitplankonfiguration.

Console

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

   Audit Manager aufrufen

2. Auf dem Tab Zeitpläne finden Sie eine Liste der geplanten Audits.

gcloud

Liste der geplanten Audits ansehen

Führen Sie den Befehl gcloud audit-manager audit-schedules list aus, um eine Liste der geplanten Audits aufzurufen.

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.

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 audit-schedules list \
    --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 audit-schedules list `
    --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 audit-schedules list ^
    --RESOURCE_TYPE=RESOURCE_ID ^
    --location=LOCATION

Sie sollten eine Antwort ähnlich der folgenden erhalten:

┌────────────┬────────────┬──────────────┬────────────┬────────────┬───────────────┬─────────────────┬─────────────┬─────────────┬───────────────┬───────────────────┬───────────────┐
│     ID     │ FRAMEWORK  │ DISPLAY_NAME │   STATE    │  GCS_URI   │ REPORT_FORMAT │ SCHEDULE_CONFIG │ CREATE_TIME │ UPDATE_TIME │ NEXT_RUN_TIME │ LAST_TRIGGER_TIME │ ERROR_MESSAGE │
├────────────┼────────────┼──────────────┼────────────┼────────────┼───────────────┼─────────────────┼─────────────┼─────────────┼───────────────┼───────────────────┼───────────────┤
│ my-schedul │ builtin-ci │ My first aud │ SCHEDULE_S │ gs://my-bu │ AUDIT_REPORT_ │ {'frequency':   │ 2026-10-25T │ 2026-10-25T │               │                   │               │
│ e-id       │ s-v8       │ it schedule  │ TATE_ACTIV │ cket       │ FORMAT_ODF    │ 'weekly',       │ 13:27:00Z   │ 13:27:00Z   │               │                   │               │
│            │            │              │ E          │            │               │ 'startTime':    │             │             │               │                   │               │
│            │            │              │            │            │               │ '2026-10-25T10: │             │             │               │                   │               │
│            │            │              │            │            │               │ 00:00Z'}        │             │             │               │                   │               │
└────────────┴────────────┴──────────────┴────────────┴────────────┴───────────────┴─────────────────┴─────────────┴─────────────┴───────────────┴───────────────────┴───────────────┘

Details zu einer geplanten Prüfung ansehen

Führen Sie den Befehl gcloud audit-manager audit-schedules describe aus, um Details zu einer bestimmten geplanten Prüfung aufzurufen.

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

• 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_SCHEDULE_ID: die ID des Prüfzeitplans. Beispiel: my-schedule-id Die ID eines vorhandenen Zeitplans finden Sie in der Google Cloud Console auf der Seite Audit-Verwaltung.

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 audit-schedules describe \
    RESOURCE_TYPE/RESOURCE_ID/locations/LOCATION/auditSchedules/AUDIT_SCHEDULE_ID

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 audit-schedules describe `
    RESOURCE_TYPE/RESOURCE_ID/locations/LOCATION/auditSchedules/AUDIT_SCHEDULE_ID

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 audit-schedules describe ^
    RESOURCE_TYPE/RESOURCE_ID/locations/LOCATION/auditSchedules/AUDIT_SCHEDULE_ID

Sie sollten eine Antwort ähnlich der folgenden erhalten:

complianceFramework: builtin-cis-v8
gcsUri: gs://my-bucket
name: projects/834/locations/us-central1/auditSchedules/my-schedule-id
reportFormat: AUDIT_REPORT_FORMAT_ODF
scheduleConfig:
  frequency: weekly
  startTime: '2026-10-25T10:00:00Z'
state: SCHEDULE_STATE_ACTIVE

REST

Liste der geplanten Audits ansehen

Wenn Sie eine Liste der geplanten Audits aufrufen möchten, senden Sie eine GET-Anfrage an den Endpunkt auditSchedules.

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.

HTTP-Methode und URL:

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

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/v1/RESOURCE_TYPE/RESOURCE_ID/locations/LOCATION/auditSchedules"

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 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/auditSchedules" | Select-Object -Expand Content

Sie sollten eine JSON-Antwort ähnlich wie diese erhalten:

{
  "auditSchedules": [
    {
      "name": "projects/834/locations/us-central1/auditSchedules/my-schedule-id",
      "displayName": "My first audit schedule",
      "gcsUri": "gs://my-bucket",
      "complianceFramework": "builtin-cis-v8",
      "reportFormat": "AUDIT_REPORT_FORMAT_ODF",
      "scheduleConfig": {
        "startTime": "2026-10-25T10:00:00Z",
        "endTime": "2027-10-25T10:00:00Z",
        "frequency": "WEEKLY",
        "timeZone": "America/New_York"
      },
      "state": "SCHEDULE_STATE_ACTIVE",
      "createTime": "2026-10-25T13:27:00Z",
      "updateTime": "2026-10-25T13:27:00Z"
    }
  ]
}

Details zu einer geplanten Prüfung ansehen

Wenn Sie Details zu einer bestimmten geplanten Prüfung aufrufen möchten, senden Sie eine GET-Anfrage an den Endpunkt auditSchedules und geben Sie die Zeitplan-ID an.

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_SCHEDULE_ID: die ID des Prüfzeitplans. Beispiel: my-schedule-id Die ID eines vorhandenen Zeitplans finden Sie in der Google Cloud Console auf der Seite Audit-Verwaltung.

HTTP-Methode und URL:

GET https://auditmanager.googleapis.com/v1/RESOURCE_TYPE/RESOURCE_ID/locations/LOCATION/auditSchedules/AUDIT_SCHEDULE_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/v1/RESOURCE_TYPE/RESOURCE_ID/locations/LOCATION/auditSchedules/AUDIT_SCHEDULE_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 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/auditSchedules/AUDIT_SCHEDULE_ID" | Select-Object -Expand Content

Sie sollten eine JSON-Antwort ähnlich wie diese erhalten:

{
  "name": "projects/834/locations/us-central1/auditSchedules/my-schedule-id",
  "displayName": "My first audit schedule",
  "gcsUri": "gs://my-bucket",
  "complianceFramework": "builtin-cis-v8",
  "reportFormat": "AUDIT_REPORT_FORMAT_ODF",
  "scheduleConfig": {
    "startTime": "2026-10-25T10:00:00Z",
    "endTime": "2027-10-25T10:00:00Z",
    "frequency": "WEEKLY",
    "timeZone": "America/New_York"
  },
  "state": "SCHEDULE_STATE_ACTIVE",
  "createTime": "2026-10-25T13:27:00Z",
  "updateTime": "2026-10-25T13:27:00Z"
}

Geplante Audits aktualisieren

Sie können wiederkehrende Audits pausieren, fortsetzen und beenden. Wenn Sie einen Zeitplan ändern möchten, müssen Sie die vorhandene geplante Prüfung löschen und dann eine neue geplante Prüfung erstellen.

Console

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

   Audit Manager aufrufen

2. Suchen Sie auf dem Tab Zeitpläne nach der geplanten Prüfung, die Sie aktualisieren möchten.

3. Führen Sie einen der folgenden Schritte aus:

   • Wenn Sie einen Prüfzeitplan pausieren möchten, klicken Sie auf Zeitplan pausieren.

   • Wenn Sie eine pausierte Prüfung fortsetzen möchten, klicken Sie auf  Zeitplan fortsetzen.

   • Wenn Sie eine geplante Prüfung löschen möchten, klicken Sie auf Zeitplan beenden.

gcloud

Wenn Sie einen Prüfzeitplan pausieren, fortsetzen oder löschen möchten, führen Sie den Befehl gcloud audit-manager audit-schedules update aus, um den Status des Zeitplans zu aktualisieren.

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

• 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_SCHEDULE_ID: die ID des Prüfzeitplans. Beispiel: my-schedule-id Die ID eines vorhandenen Zeitplans finden Sie in der Google Cloud Console auf der Seite Audit-Verwaltung.
• SCHEDULE_STATE: der Zielstatus für den Prüfzeitplan. Legen Sie einen der folgenden Werte fest:
  • paused: um einen aktiven Zeitplan zu pausieren.
  • active: um einen pausierten Zeitplan fortzusetzen.
  • deleted: um einen Zeitplan zu beenden und zu löschen.

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 audit-schedules update \
    RESOURCE_TYPE/RESOURCE_ID/locations/LOCATION/auditSchedules/AUDIT_SCHEDULE_ID \
    --state=SCHEDULE_STATE

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 audit-schedules update `
    RESOURCE_TYPE/RESOURCE_ID/locations/LOCATION/auditSchedules/AUDIT_SCHEDULE_ID `
    --state=SCHEDULE_STATE

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 audit-schedules update ^
    RESOURCE_TYPE/RESOURCE_ID/locations/LOCATION/auditSchedules/AUDIT_SCHEDULE_ID ^
    --state=SCHEDULE_STATE

Sie sollten eine Antwort ähnlich der folgenden erhalten:

complianceFramework: builtin-cis-v8
gcsUri: gs://my-bucket
name: projects/834/locations/us-central1/auditSchedules/my-schedule-id
reportFormat: AUDIT_REPORT_FORMAT_ODF
scheduleConfig:
  frequency: daily
  startTime: '2026-02-25T10:00:00Z'
state: SCHEDULE_STATE_PAUSED

REST

Wenn Sie einen Prüfzeitplan pausieren, fortsetzen oder löschen möchten, senden Sie eine PATCH-Anfrage, um das Feld state des Prüfzeitplans zu aktualisieren.

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_SCHEDULE_ID: die ID des Prüfzeitplans. Beispiel: my-schedule-id Die ID eines vorhandenen Zeitplans finden Sie in der Google Cloud Console auf der Seite Audit-Verwaltung.
• SCHEDULE_STATE: der Zielstatus für den Prüfzeitplan. Legen Sie einen der folgenden Werte fest:
  • SCHEDULE_STATE_PAUSED: um einen aktiven Zeitplan zu pausieren.
  • SCHEDULE_STATE_ACTIVE: um einen pausierten Zeitplan fortzusetzen.
  • SCHEDULE_STATE_DELETED: um einen Zeitplan zu beenden und zu löschen.

HTTP-Methode und URL:

PATCH https://auditmanager.googleapis.com/v1/RESOURCE_TYPE/RESOURCE_ID/locations/LOCATION/auditSchedules/AUDIT_SCHEDULE_ID?updateMask=state

JSON-Text der Anfrage:

{
  "state": "SCHEDULE_STATE"
}

Wenn Sie die Anfrage senden möchten, wählen Sie eine der folgenden Optionen aus:

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.

Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json und führen Sie den folgenden Befehl aus:

curl -X PATCH \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://auditmanager.googleapis.com/v1/RESOURCE_TYPE/RESOURCE_ID/locations/LOCATION/auditSchedules/AUDIT_SCHEDULE_ID?updateMask=state"

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.

Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json und führen Sie den folgenden Befehl aus:

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

Invoke-WebRequest `
    -Method PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://auditmanager.googleapis.com/v1/RESOURCE_TYPE/RESOURCE_ID/locations/LOCATION/auditSchedules/AUDIT_SCHEDULE_ID?updateMask=state" | Select-Object -Expand Content

Sie sollten eine JSON-Antwort ähnlich wie diese erhalten:

{
  "name": "projects/834/locations/us-central1/auditSchedules/my-schedule-id",
  "displayName": "My first audit schedule",
  "gcsUri": "gs://my-bucket",
  "complianceFramework": "builtin-cis-v8",
  "reportFormat": "AUDIT_REPORT_FORMAT_ODF",
  "scheduleConfig": {
    "startTime": "2026-02-25T10:00:00Z",
    "endTime": "2027-02-25T10:00:00Z",
    "frequency": "DAILY",
    "timeZone": "America/New_York"
  },
  "state": "SCHEDULE_STATE_PAUSED",
  "createTime": "2026-02-25T13:27:00Z",
  "updateTime": "2026-09-11T18:15:00Z"
}

Nächste Schritte

• Status einer Prüfung abrufen
• Probleme bei der Ausführung von Audits beheben