Menjadwalkan atau menjalankan audit

Audit memungkinkan Anda mengumpulkan bukti yang diperlukan untuk menilai Google Cloud organisasi Anda terhadap framework yang didukung. Anda dapat menjadwalkan audit untuk dijalankan secara berkala atau menjalankan audit on-demand.

Audit adalah operasi yang berjalan lama dan mungkin memerlukan waktu beberapa jam. Durasinya bergantung pada jumlah resource dalam cakupan audit, yaitu organisasi, project, atau folder yang sebelumnya Anda daftarkan.

Anda dapat membuat jadwal untuk kombinasi framework dan resource tertentu hanya jika jadwal aktif atau dijeda belum ada untuk kombinasi tersebut.

Sebelum memulai

Menjadwalkan dan menjalankan audit

Anda dapat membuat jadwal untuk menjalankan audit secara berulang atau menjalankan audit on-demand.

Konsol

  1. Di konsol Google Cloud , buka halaman Run assessment di Audit Manager.

    Buka Audit Manager

  2. Di bagian Choose resource and region, lakukan hal berikut:

    1. Pilih organisasi, folder, atau project yang ingin Anda audit.

    2. Pilih lokasi tempat Anda ingin memproses penilaian audit. Untuk daftar lokasi yang didukung, lihat Lokasi Audit Manager.

    3. Klik Berikutnya.

  3. Di bagian Choose regulation, pilih framework yang ingin Anda gunakan untuk mengaudit resource, lalu klik Next. Untuk mengetahui informasi tentang framework yang didukung, lihat Framework yang didukung.

  4. Opsional: Jika bagian Configure Parameters muncul, selesaikan langkah-langkah berikut:

    1. Klik Ubah Konfigurasi.

    2. Di jendela Configure parameters, tambahkan parameter yang diperlukan untuk kontrol cloud. Untuk mengetahui informasi selengkapnya tentang parameter, lihat Referensi kontrol cloud Compliance Manager dan Kontrol cloud Assured Workloads.

    3. Klik Simpan.

  5. Opsional: Di bagian View Assessment Plan, Anda dapat mendownload file ODS yang berisi informasi tentang cakupan audit berdasarkan framework yang Anda pilih. Untuk mendownload file, klik link, lalu klik Berikutnya.

  6. Di bagian Choose storage bucket, pilih bucket penyimpanan tempat Anda ingin menyimpan laporan audit dan bukti, lalu klik Done. Jika bucket Anda tidak tercantum, minta administrator untuk mendaftarkan resource Anda dengan bucket penyimpanan Anda.

  7. Opsional: Di bagian Schedule, tetapkan salah satu hal berikut:

    • Seberapa sering mengulangi audit (harian, mingguan, bulanan, kuartalan, atau tahunan).

    • Jangka waktu yang akan disertakan dalam audit. Jika Anda memilih Tidak pernah berakhir, audit akan terus berjalan dari tanggal mulai yang Anda tentukan hingga Anda menghentikannya secara manual.

  8. Untuk memulai audit, klik Jalankan Audit atau Jalankan Audit Terjadwal.

    Anda dapat melihat status audit on-demand di halaman Lihat penilaian atau melihat audit terjadwal di tab Jadwal di halaman Pengelolaan audit.

gcloud

Opsional: Membuat penilaian audit

Sebelum menjalankan audit, Anda dapat membuat penilaian atau cakupan audit, yang mencakup perincian tugas mendetail untuk audit berdasarkan framework yang Anda pilih.

Perintah gcloud audit-manager audit-scopes generate menghasilkan cakupan audit.

Sebelum menggunakan salah satu data perintah di bawah, lakukan penggantian berikut:

  • RESOURCE_TYPE: jenis resource. Nilai yang valid adalah organization, folder, dan project.
  • RESOURCE_ID: ID resource organisasi, project, atau folder. Contoh: 8767234.
  • LOCATION: lokasi endpoint Audit Manager API. Untuk mengetahui daftar endpoint yang tersedia, lihat Lokasi Audit Manager. Misalnya: us-central1
  • FRAMEWORK: ID framework yang akan diaudit. Contoh: builtin-cis-v8. Untuk menemukan ID framework, lihat halaman Lihat penilaian di konsol Google Cloud .
  • AUDIT_REPORT_FORMAT: format laporan audit output. Hanya format ODF yang didukung: AUDIT_REPORT_FORMAT_ODF.
  • OUTPUT_DIRECTORY: direktori tempat output harus disimpan. Contoh: reports.
  • OUTPUT_FILENAME: nama file output. Jangan sertakan ekstensi file dalam nama file. Contoh: scopeReport.

Jalankan perintah berikut:

Linux, macOS, atau Cloud Shell

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)

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)

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

Menjalankan audit sesuai permintaan

Perintah gcloud audit-manager audit-reports generate menjalankan audit.

Sebelum menggunakan salah satu data perintah di bawah, lakukan penggantian berikut:

  • RESOURCE_TYPE: jenis resource. Nilai yang valid adalah organization, folder, dan project.
  • RESOURCE_ID: ID resource organisasi, project, atau folder. Contoh: 8767234.
  • LOCATION: lokasi endpoint Audit Manager API. Untuk mengetahui daftar endpoint yang tersedia, lihat Lokasi Audit Manager. Misalnya: us-central1
  • FRAMEWORK: ID framework yang akan diaudit. Contoh: builtin-cis-v8. Untuk menemukan ID framework, lihat halaman Lihat penilaian di konsol Google Cloud .
  • BUCKET_URI: URI bucket Cloud Storage. Contoh: gs://testbucketauditmanager
  • AUDIT_REPORT_FORMAT: format laporan audit output. Hanya format ODF yang didukung: AUDIT_REPORT_FORMAT_ODF.

Jalankan perintah berikut:

Linux, macOS, atau Cloud Shell

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)

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)

gcloud audit-manager audit-reports generate ^
    --RESOURCE_TYPE=RESOURCE_ID ^
    --location=LOCATION ^
    --compliance-framework=FRAMEWORK ^
    --report-format=AUDIT_REPORT_FORMAT ^
    --gcs-uri=BUCKET_URI

Anda akan melihat respons seperti berikut:

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

Menjadwalkan audit

Perintah gcloud audit-manager audit-schedules create membuat jadwal audit.

Sebelum menggunakan salah satu data perintah di bawah, lakukan penggantian berikut:

  • RESOURCE_TYPE: jenis resource. Nilai yang valid adalah organization, folder, dan project.
  • RESOURCE_ID: ID resource organisasi, project, atau folder. Contoh: 8767234.
  • LOCATION: lokasi endpoint Audit Manager API. Untuk mengetahui daftar endpoint yang tersedia, lihat Lokasi Audit Manager. Misalnya: us-central1
  • AUDIT_SCHEDULE_ID: ID jadwal audit. Contoh: my-schedule-id. Untuk menemukan ID jadwal yang ada, lihat halaman Pengelolaan audit di konsol Google Cloud .
  • FRAMEWORK: ID framework yang akan diaudit. Contoh: builtin-cis-v8. Untuk menemukan ID framework, lihat halaman Lihat penilaian di konsol Google Cloud .
  • AUDIT_REPORT_FORMAT: format laporan audit output. Hanya Format OpenDocument (ODF) yang didukung: odf.
  • BUCKET_URI: URI bucket Cloud Storage. Contoh: gs://testbucketauditmanager
  • FREQUENCY: frekuensi proses audit terjadwal. Nilai yang valid adalah daily, weekly, monthly, quarterly, dan annually. Misalnya: weekly.
  • SCHEDULE_START_TIME: tanggal dan waktu saat proses audit pertama dimulai, dalam format RFC 3339. Contoh: 2026-10-25T10:00:00Z.
  • DISPLAY_NAME: optional. Nama tampilan untuk jadwal audit. Contoh: NIST 800-53 Weekly Audit.
  • SCHEDULE_END_TIME: opsional. Tanggal dan waktu saat jadwal audit berhenti, dalam format RFC 3339. Contoh: 2027-10-25T10:00:00Z.
  • TIME_ZONE: optional. Zona waktu untuk jadwal audit dalam format IANA. Audit Manager menggunakan nilai ini untuk menafsirkan waktu mulai dan waktu berakhir. Jika tidak ditentukan, jumlah defaultnya adalah UTC. Misalnya: America/New_York

Jalankan perintah berikut:

Linux, macOS, atau Cloud Shell

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)

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)

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

Anda akan melihat respons seperti berikut:

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

Opsional: Membuat penilaian audit

Sebelum menjalankan audit, Anda dapat membuat penilaian atau cakupan audit, yang mencakup perincian tugas mendetail untuk audit berdasarkan framework yang Anda pilih.

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

  • RESOURCE_TYPE: jenis resource. Nilai yang valid adalah organizations, folders, dan projects.
  • RESOURCE_ID: ID resource organisasi, project, atau folder. Contoh: 8767234.
  • LOCATION: lokasi endpoint Audit Manager API. Untuk mengetahui daftar endpoint yang tersedia, lihat Lokasi Audit Manager. Misalnya: us-central1
  • FRAMEWORK: ID framework yang akan diaudit. Contoh: builtin-cis-v8. Untuk menemukan ID framework, lihat halaman Melihat penilaian di konsol Google Cloud .
  • AUDIT_REPORT_FORMAT: format laporan audit output. Hanya format ODF yang didukung: AUDIT_REPORT_FORMAT_ODF.

Metode HTTP dan URL:

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

Meminta isi JSON:


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

Untuk mengirim permintaan Anda, pilih salah satu opsi berikut:

curl

Simpan isi permintaan dalam file bernama request.json, dan jalankan perintah berikut:

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

Simpan isi permintaan dalam file bernama request.json, dan jalankan perintah berikut:

$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

Anda akan melihat respons JSON seperti berikut:

{

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

Responsnya mencakup informasi berikut:

  • scope_report_contents: format byte konten laporan, yang harus Anda konversi ke OpenDocument Format (ODF) sebelum peninjauan.
  • name: ID string unik dari resource yang berlaku.

Menjalankan audit sesuai permintaan

Untuk menjalankan audit on-demand, kirim permintaan POST ke endpoint auditReport:generate.

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

  • RESOURCE_TYPE: jenis resource. Nilai yang valid adalah organizations, folders, dan projects.
  • RESOURCE_ID: ID resource organisasi, project, atau folder. Contoh: 8767234.
  • LOCATION: lokasi endpoint Audit Manager API. Untuk mengetahui daftar endpoint yang tersedia, lihat Lokasi Audit Manager. Misalnya: us-central1
  • FRAMEWORK: ID framework yang akan diaudit. Contoh: builtin-cis-v8. Untuk menemukan ID framework, lihat halaman Melihat penilaian di konsol Google Cloud .
  • BUCKET_URI: URI bucket Cloud Storage. Contoh: gs://testbucketauditmanager
  • AUDIT_REPORT_FORMAT: format laporan audit output. Hanya format ODF yang didukung: AUDIT_REPORT_FORMAT_ODF.

Metode HTTP dan URL:

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

Meminta isi JSON:


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

Untuk mengirim permintaan Anda, pilih salah satu opsi berikut:

curl

Simpan isi permintaan dalam file bernama request.json, dan jalankan perintah berikut:

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

Simpan isi permintaan dalam file bernama request.json, dan jalankan perintah berikut:

$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

Anda akan melihat respons JSON seperti berikut:

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

Responsnya mencakup informasi berikut:

  • name: ID string unik untuk permintaan operasi penilaian audit. Gunakan ID ini untuk melacak progres penilaian audit. Contoh: projects/PROJECT_ID/locations/LOCATION/operations/098234UNIQUE_ID.
  • done: flag boolean yang menunjukkan apakah penilaian audit sudah selesai. Flag ini ditetapkan ke false saat proses dimulai dan berubah menjadi true saat penilaian audit selesai.

Menjadwalkan audit

Untuk menjadwalkan audit berulang, kirim permintaan POST ke endpoint auditSchedules.

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

  • RESOURCE_TYPE: jenis resource. Nilai yang valid adalah organizations, folders, dan projects.
  • RESOURCE_ID: ID resource organisasi, project, atau folder. Contoh: 8767234.
  • LOCATION: lokasi endpoint Audit Manager API. Untuk mengetahui daftar endpoint yang tersedia, lihat Lokasi Audit Manager. Misalnya: us-central1
  • AUDIT_SCHEDULE_ID: ID jadwal audit. Contoh: my-schedule-id. Untuk menemukan ID jadwal yang ada, lihat halaman Pengelolaan audit di konsol Google Cloud .
  • FRAMEWORK: ID framework yang akan diaudit. Contoh: builtin-cis-v8. Untuk menemukan ID framework, lihat halaman Melihat penilaian di konsol Google Cloud .
  • BUCKET_URI: URI bucket Cloud Storage. Contoh: gs://testbucketauditmanager
  • AUDIT_REPORT_FORMAT: format laporan audit output. Hanya format ODF yang didukung: AUDIT_REPORT_FORMAT_ODF.
  • FREQUENCY: frekuensi proses audit terjadwal. Nilai yang valid adalah DAILY, WEEKLY, MONTHLY, QUARTERLY, dan ANNUALLY. Misalnya: WEEKLY.
  • SCHEDULE_START_TIME: tanggal dan waktu saat proses audit pertama dimulai, dalam format RFC 3339. Contoh: 2026-10-25T10:00:00Z.
  • DISPLAY_NAME: optional. Nama tampilan untuk jadwal audit. Contoh: NIST 800-53 Weekly Audit.
  • SCHEDULE_END_TIME: opsional. Tanggal dan waktu saat jadwal audit berhenti, dalam format RFC 3339. Contoh: 2027-10-25T10:00:00Z.
  • TIME_ZONE: optional. Zona waktu untuk jadwal audit dalam format IANA. Audit Manager menggunakan nilai ini untuk menafsirkan waktu mulai dan waktu berakhir. Jika tidak ditentukan, jumlah defaultnya adalah UTC. Misalnya: America/New_York

Metode HTTP dan URL:

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

Meminta isi JSON:

{
  "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"
  }
}

Untuk mengirim permintaan Anda, pilih salah satu opsi berikut:

curl

Simpan isi permintaan dalam file bernama request.json, dan jalankan perintah berikut:

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

Simpan isi permintaan dalam file bernama request.json, dan jalankan perintah berikut:

$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

Anda akan melihat respons JSON seperti berikut:

{
  "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"
}

Melihat audit terjadwal

Anda dapat melihat detail tentang audit terjadwal, termasuk cakupan, framework, dan konfigurasi jadwal.

Konsol

  1. Di konsol Google Cloud , buka halaman Audit management di Audit Manager.

    Buka Audit Manager

  2. Di tab Jadwal, lihat daftar audit terjadwal.

gcloud

Melihat daftar audit terjadwal

Untuk melihat daftar audit terjadwal, jalankan perintah gcloud audit-manager audit-schedules list.

Sebelum menggunakan salah satu data perintah di bawah, lakukan penggantian berikut:

  • RESOURCE_TYPE: jenis resource. Nilai yang valid adalah organization, folder, dan project.
  • RESOURCE_ID: ID resource organisasi, project, atau folder. Contoh: 8767234.
  • LOCATION: lokasi endpoint Audit Manager API. Untuk mengetahui daftar endpoint yang tersedia, lihat Lokasi Audit Manager. Misalnya: us-central1

Jalankan perintah berikut:

Linux, macOS, atau Cloud Shell

gcloud audit-manager audit-schedules list \
    --RESOURCE_TYPE=RESOURCE_ID \
    --location=LOCATION

Windows (PowerShell)

gcloud audit-manager audit-schedules list `
    --RESOURCE_TYPE=RESOURCE_ID `
    --location=LOCATION

Windows (cmd.exe)

gcloud audit-manager audit-schedules list ^
    --RESOURCE_TYPE=RESOURCE_ID ^
    --location=LOCATION

Anda akan melihat respons seperti berikut:

┌────────────┬────────────┬──────────────┬────────────┬────────────┬───────────────┬─────────────────┬─────────────┬─────────────┬───────────────┬───────────────────┬───────────────┐
│     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'}        │             │             │               │                   │               │
└────────────┴────────────┴──────────────┴────────────┴────────────┴───────────────┴─────────────────┴─────────────┴─────────────┴───────────────┴───────────────────┴───────────────┘

Melihat detail tentang audit terjadwal

Untuk melihat detail tentang audit terjadwal tertentu, jalankan perintah gcloud audit-manager audit-schedules describe.

Sebelum menggunakan salah satu data perintah di bawah, lakukan penggantian berikut:

  • RESOURCE_TYPE: jenis resource. Nilai yang valid adalah organizations, folders, dan projects.
  • RESOURCE_ID: ID resource organisasi, project, atau folder. Contoh: 8767234.
  • LOCATION: lokasi endpoint Audit Manager API. Untuk mengetahui daftar endpoint yang tersedia, lihat Lokasi Audit Manager. Misalnya: us-central1
  • AUDIT_SCHEDULE_ID: ID jadwal audit. Contoh: my-schedule-id. Untuk menemukan ID jadwal yang ada, lihat halaman Pengelolaan audit di konsol Google Cloud .

Jalankan perintah berikut:

Linux, macOS, atau Cloud Shell

gcloud audit-manager audit-schedules describe \
    RESOURCE_TYPE/RESOURCE_ID/locations/LOCATION/auditSchedules/AUDIT_SCHEDULE_ID

Windows (PowerShell)

gcloud audit-manager audit-schedules describe `
    RESOURCE_TYPE/RESOURCE_ID/locations/LOCATION/auditSchedules/AUDIT_SCHEDULE_ID

Windows (cmd.exe)

gcloud audit-manager audit-schedules describe ^
    RESOURCE_TYPE/RESOURCE_ID/locations/LOCATION/auditSchedules/AUDIT_SCHEDULE_ID

Anda akan melihat respons seperti berikut:

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

Melihat daftar audit terjadwal

Untuk melihat daftar audit terjadwal, kirim permintaan GET ke endpoint auditSchedules.

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

  • RESOURCE_TYPE: jenis resource. Nilai yang valid adalah organizations, folders, dan projects.
  • RESOURCE_ID: ID resource organisasi, project, atau folder. Contoh: 8767234.
  • LOCATION: lokasi endpoint Audit Manager API. Untuk mengetahui daftar endpoint yang tersedia, lihat Lokasi Audit Manager. Misalnya: us-central1

Metode HTTP dan URL:

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

Untuk mengirim permintaan Anda, pilih salah satu opsi berikut:

curl

Jalankan perintah berikut:

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

PowerShell

Jalankan perintah berikut:

$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

Anda akan melihat respons JSON seperti berikut:

{
  "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"
    }
  ]
}

Melihat detail tentang audit terjadwal

Untuk melihat detail tentang audit terjadwal tertentu, kirim permintaan GET ke endpoint auditSchedules dan tentukan ID jadwal.

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

  • RESOURCE_TYPE: jenis resource. Nilai yang valid adalah organizations, folders, dan projects.
  • RESOURCE_ID: ID resource organisasi, project, atau folder. Contoh: 8767234.
  • LOCATION: lokasi endpoint Audit Manager API. Untuk mengetahui daftar endpoint yang tersedia, lihat Lokasi Audit Manager. Misalnya: us-central1
  • AUDIT_SCHEDULE_ID: ID jadwal audit. Contoh: my-schedule-id. Untuk menemukan ID jadwal yang ada, lihat halaman Pengelolaan audit di konsol Google Cloud .

Metode HTTP dan URL:

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

Untuk mengirim permintaan Anda, pilih salah satu opsi berikut:

curl

Jalankan perintah berikut:

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

Jalankan perintah berikut:

$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

Anda akan melihat respons JSON seperti berikut:

{
  "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"
}

Memperbarui audit terjadwal

Anda dapat menjeda, melanjutkan, dan menghentikan audit berulang. Untuk mengubah jadwal, Anda harus menghapus audit terjadwal yang ada, lalu membuat audit terjadwal baru.

Konsol

  1. Di konsol Google Cloud , buka halaman Audit management di Audit Manager.

    Buka Audit Manager

  2. Di tab Jadwal, temukan audit terjadwal yang ingin Anda perbarui.

  3. Lakukan salah satu hal berikut:

    • Untuk menjeda jadwal audit, klik Jeda jadwal.

    • Untuk memulai ulang audit yang Anda jeda, klik Lanjutkan jadwal.

    • Untuk menghapus audit terjadwal, klik Hentikan jadwal.

gcloud

Untuk menjeda, melanjutkan, atau menghapus jadwal audit, jalankan perintah gcloud audit-manager audit-schedules update untuk memperbarui status jadwal.

Sebelum menggunakan salah satu data perintah di bawah, lakukan penggantian berikut:

  • RESOURCE_TYPE: jenis resource. Nilai yang valid adalah organizations, folders, dan projects.
  • RESOURCE_ID: ID resource organisasi, project, atau folder. Contoh: 8767234.
  • LOCATION: lokasi endpoint Audit Manager API. Untuk mengetahui daftar endpoint yang tersedia, lihat Lokasi Audit Manager. Misalnya: us-central1
  • AUDIT_SCHEDULE_ID: ID jadwal audit. Contoh: my-schedule-id. Untuk menemukan ID jadwal yang ada, lihat halaman Pengelolaan audit di konsol Google Cloud .
  • SCHEDULE_STATE: status target untuk jadwal audit. Tetapkan ke salah satu opsi berikut:
    • paused: untuk menjeda jadwal aktif.
    • active: untuk melanjutkan jadwal yang dijeda.
    • deleted: untuk menghentikan dan menghapus jadwal.

Jalankan perintah berikut:

Linux, macOS, atau Cloud Shell

gcloud audit-manager audit-schedules update \
    RESOURCE_TYPE/RESOURCE_ID/locations/LOCATION/auditSchedules/AUDIT_SCHEDULE_ID \
    --state=SCHEDULE_STATE

Windows (PowerShell)

gcloud audit-manager audit-schedules update `
    RESOURCE_TYPE/RESOURCE_ID/locations/LOCATION/auditSchedules/AUDIT_SCHEDULE_ID `
    --state=SCHEDULE_STATE

Windows (cmd.exe)

gcloud audit-manager audit-schedules update ^
    RESOURCE_TYPE/RESOURCE_ID/locations/LOCATION/auditSchedules/AUDIT_SCHEDULE_ID ^
    --state=SCHEDULE_STATE

Anda akan melihat respons seperti berikut:

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

Untuk menjeda, melanjutkan, atau menghapus jadwal audit, kirim permintaan PATCH untuk memperbarui kolom state jadwal audit.

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

  • RESOURCE_TYPE: jenis resource. Nilai yang valid adalah organizations, folders, dan projects.
  • RESOURCE_ID: ID resource organisasi, project, atau folder. Contoh: 8767234.
  • LOCATION: lokasi endpoint Audit Manager API. Untuk mengetahui daftar endpoint yang tersedia, lihat Lokasi Audit Manager. Misalnya: us-central1
  • AUDIT_SCHEDULE_ID: ID jadwal audit. Contoh: my-schedule-id. Untuk menemukan ID jadwal yang ada, lihat halaman Pengelolaan audit di konsol Google Cloud .
  • SCHEDULE_STATE: status target untuk jadwal audit. Tetapkan ke salah satu opsi berikut:
    • SCHEDULE_STATE_PAUSED: untuk menjeda jadwal aktif.
    • SCHEDULE_STATE_ACTIVE: untuk melanjutkan jadwal yang dijeda.
    • SCHEDULE_STATE_DELETED: untuk menghentikan dan menghapus jadwal.

Metode HTTP dan URL:

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

Meminta isi JSON:

{
  "state": "SCHEDULE_STATE"
}

Untuk mengirim permintaan Anda, pilih salah satu opsi berikut:

curl

Simpan isi permintaan dalam file bernama request.json, dan jalankan perintah berikut:

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

Simpan isi permintaan dalam file bernama request.json, dan jalankan perintah berikut:

$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

Anda akan menerima respons JSON yang mirip dengan yang berikut ini:

{
  "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"
}

Langkah berikutnya