Halaman ini menjelaskan cara mendapatkan status audit yang sedang berlangsung yang Anda mulai menggunakan Audit Manager atau Compliance Manager. Audit adalah operasi yang berjalan lama, dan akan sangat membantu untuk mendapatkan status audit saat operasi sedang berjalan.
Sebelum memulai
Pastikan Anda memiliki salah satu peran IAM berikut:
- Audit Manager Admin (
roles/auditmanager.admin) - Auditor Audit Manager (
roles/auditmanager.auditor) - Pelihat Compliance Manager
(
roles/cloudsecuritycompliance.viewer) (diperlukan jika Anda mengaudit framework yang telah dibuat menggunakan Compliance Manager)
- Audit Manager Admin (
Identifikasi audit yang statusnya ingin Anda dapatkan.
Mendapatkan status audit yang sedang berlangsung
Konsol
Di konsol Google Cloud , buka halaman Lihat audit.
Di halaman Lihat penilaian, Anda dapat melihat status saat ini dari audit yang sedang berlangsung atau mendapatkan informasi selengkapnya tentang audit yang telah selesai.
Untuk melihat informasi selengkapnya tentang audit, klik link di kolom Status.
gcloud
Perintah gcloud audit-manager operations describe
menjelaskan operasi audit.
Sebelum menggunakan salah satu data perintah di bawah, lakukan penggantian berikut:
- RESOURCE_TYPE: jenis resource, baik project maupun folder. Misalnya
foldersatauprojects. - RESOURCE_ID: ID resource 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_OPERATION_ID: ID unik untuk operasi yang sedang berlangsung yang disertakan dalam isi respons saat Anda menjalankan audit. Contoh:
098234.
Jalankan perintah berikut:
Linux, macOS, atau 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
Respons yang berhasil mencakup salah satu jenis status eksekusi berikut:
| Jenis status | Deskripsi |
|---|---|
OPERATION_STATE_UNSPECIFIED |
Status tidak valid. |
OPERATION_STATE_NOT_STARTED |
Proses pembuatan laporan audit belum dimulai. |
OPERATION_STATE_EVALUATION_IN_PROGRESS |
Audit Manager mengevaluasi resource terhadap kontrol kepatuhan. |
OPERATION_STATE_EVALUATION_DONE |
Audit Manager telah menyelesaikan evaluasi kepatuhan. |
OPERATION_STATE_EVIDENCE_REPORT_GENERATION_IN_PROGRESS |
Audit Manager membuat laporan audit dari data yang dievaluasi. |
OPERATION_STATE_EVIDENCE_REPORT_GENERATION_DONE |
Audit Manager telah menyelesaikan pembuatan laporan audit. |
OPERATION_STATE_EVIDENCE_UPLOAD_IN_PROGRESS |
Audit Manager mengupload laporan audit dan bukti ke tujuan. |
OPERATION_STATE_DONE |
Proses pembuatan laporan audit selesai. |
OPERATION_STATE_FAILED |
Proses pembuatan laporan audit gagal. |
Setiap jenis status eksekusi dapat memberikan informasi tambahan berikut, jika berlaku:
| Status tambahan | Deskripsi |
|---|---|
failure_reason |
Jika penilaian audit gagal, kolom ini akan memberikan alasan kegagalan. |
evaluation_percent_complete |
Jika evaluasi telah dimulai, kolom ini memberikan persentase progres. Jika proses belum dimulai, kolom akan dimulai dari 0. Setelah proses selesai, kolom akan ditetapkan ke 100. |
report_generation_percent_complete |
Jika pembuatan laporan telah dimulai, kolom ini memberikan persentase progres. Jika proses belum dimulai, kolom akan dimulai dari 0. Setelah proses selesai, kolom akan ditetapkan ke 100. |
report_uploading_percent_complete |
Jika upload laporan telah dimulai, kolom ini memberikan persentase progres. Jika proses belum dimulai, kolom akan dimulai dari 0. Setelah proses selesai, kolom akan ditetapkan ke 100. |
Respons gcloud yang berhasil akan terlihat seperti berikut:
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
Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:
- RESOURCE_TYPE: jenis resource, baik project maupun folder. Misalnya
foldersatauprojects. - RESOURCE_ID: ID resource 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_OPERATION_ID: ID unik untuk operasi yang sedang berlangsung yang disertakan dalam isi respons saat Anda menjalankan audit. Contoh:
098234.
Metode HTTP dan URL:
GET https://auditmanager.googleapis.com/v1/RESOURCE_TYPE/RESOURCE_ID/locations/LOCATION//operationDetails/AUDIT_OPERATION_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//operationDetails/AUDIT_OPERATION_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//operationDetails/AUDIT_OPERATION_ID" | Select-Object -Expand Content
Respons yang berhasil mencakup salah satu jenis status eksekusi berikut:
| Jenis status | Deskripsi |
|---|---|
OPERATION_STATE_UNSPECIFIED |
Status tidak valid. |
OPERATION_STATE_NOT_STARTED |
Proses pembuatan laporan audit belum dimulai. |
OPERATION_STATE_EVALUATION_IN_PROGRESS |
Audit Manager mengevaluasi resource terhadap kontrol kepatuhan. |
OPERATION_STATE_EVALUATION_DONE |
Audit Manager telah menyelesaikan evaluasi kepatuhan. |
OPERATION_STATE_EVIDENCE_REPORT_GENERATION_IN_PROGRESS |
Audit Manager membuat laporan audit dari data yang dievaluasi. |
OPERATION_STATE_EVIDENCE_REPORT_GENERATION_DONE |
Audit Manager telah menyelesaikan pembuatan laporan audit. |
OPERATION_STATE_EVIDENCE_UPLOAD_IN_PROGRESS |
Audit Manager mengupload laporan audit dan bukti ke tujuan. |
OPERATION_STATE_DONE |
Proses pembuatan laporan audit selesai. |
OPERATION_STATE_FAILED |
Proses pembuatan laporan audit gagal. |
Setiap jenis status eksekusi dapat memberikan informasi tambahan berikut, jika berlaku:
| Status tambahan | Deskripsi |
|---|---|
failure_reason |
Jika penilaian audit gagal, kolom ini akan memberikan alasan kegagalan. |
evaluation_percent_complete |
Jika evaluasi telah dimulai, kolom ini memberikan persentase progres. Jika proses belum dimulai, kolom akan dimulai dari 0. Setelah proses selesai, kolom akan ditetapkan ke 100. |
report_generation_percent_complete |
Jika pembuatan laporan telah dimulai, kolom ini memberikan persentase progres. Jika proses belum dimulai, kolom akan dimulai dari 0. Setelah proses selesai, kolom akan ditetapkan ke 100. |
report_uploading_percent_complete |
Jika upload laporan telah dimulai, kolom ini memberikan persentase progres. Jika proses belum dimulai, kolom akan dimulai dari 0. Setelah proses selesai, kolom akan ditetapkan ke 100. |
Respons REST yang berhasil akan terlihat seperti berikut:
{
"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"
}
}
Setelah laporan audit selesai dan diupload, link ke laporan tersebut akan ditampilkan.