取得稽核狀態

本頁面說明如何取得使用稽核管理員或法規遵循管理員啟動的稽核作業狀態。稽核作業是長時間執行的作業，因此在作業執行期間取得稽核狀態會很有幫助。

事前準備

取得進行中稽核的狀態

控制台

  1. 前往 Google Cloud 控制台的「View audits」(查看稽核) 頁面。

    前往「查看稽核」

  2. 在「查看評估」頁面中，您可以查看稽核的目前狀態，或取得已完成稽核的詳細資訊。

  3. 如要查看稽核的詳細資訊，請按一下「狀態」欄中的連結。

gcloud

gcloud audit-manager operations describe 指令會說明稽核作業。

使用下方的任何指令資料之前，請先替換以下項目：

  • RESOURCE_TYPE：資源類型，可以是專案或資料夾。例如：folders 或 projects。
  • RESOURCE_ID：專案或資料夾的資源 ID。例如：8767234。
  • LOCATION：Audit Manager API 端點的位置。如需可用端點清單，請參閱「稽核管理員位置」。例如：us-central1。
  • AUDIT_OPERATION_ID：執行稽核時，回應主體中包含的進行中作業專屬 ID。例如：098234。

執行下列指令：

Linux、macOS 或 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

成功的回應會包含下列其中一種執行狀態類型：

狀態類型 說明
OPERATION_STATE_UNSPECIFIED 無效狀態。
OPERATION_STATE_NOT_STARTED 稽核報告產生程序尚未開始。
OPERATION_STATE_EVALUATION_IN_PROGRESS 稽核管理員正在根據法規遵循控管措施評估資源。
OPERATION_STATE_EVALUATION_DONE Audit Manager 已完成法規遵循評估。
OPERATION_STATE_EVIDENCE_REPORT_GENERATION_IN_PROGRESS 稽核管理員會根據評估資料建立稽核報告。
OPERATION_STATE_EVIDENCE_REPORT_GENERATION_DONE Audit Manager 已產生稽核報告。
OPERATION_STATE_EVIDENCE_UPLOAD_IN_PROGRESS Audit Manager 正在將稽核報告和證據上傳至目的地。
OPERATION_STATE_DONE 稽核報告產生程序已完成。
OPERATION_STATE_FAILED 稽核報告生成程序失敗。

如果適用，每種執行狀態類型可能會提供下列額外資訊：

其他狀態 說明
failure_reason 如果稽核評估失敗，這個欄位會說明失敗的原因。
evaluation_percent_complete 如果評估作業已開始，這個欄位會顯示進度百分比。如果程序尚未開始，該欄位會從 0 開始。程序完成時，欄位會設為 100。
report_generation_percent_complete 如果報表產生作業已開始，這個欄位會提供進度百分比。如果程序尚未開始，該欄位會從 0 開始。程序完成時，欄位會設為 100。
report_uploading_percent_complete 如果報告上傳作業已開始，這個欄位會顯示進度百分比。如果程序尚未開始，該欄位會從 0 開始。程序完成時，欄位會設為 100。

成功的 gcloud 回應會類似以下內容：

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

使用任何要求資料之前，請先修改下列項目的值：

  • RESOURCE_TYPE：資源類型，可以是專案或資料夾。例如：folders 或 projects。
  • RESOURCE_ID：專案或資料夾的資源 ID。例如：8767234。
  • LOCATION：Audit Manager API 端點的位置。如需可用端點清單，請參閱「稽核管理員位置」。例如：us-central1。
  • AUDIT_OPERATION_ID：執行稽核時，回應主體中包含的進行中作業專屬 ID。例如：098234。

HTTP 方法和網址：

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

如要傳送要求，請選擇以下其中一個選項：

curl

執行下列指令： 

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

執行下列指令： 

$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

成功的回應會包含下列其中一種執行狀態類型：

狀態類型 說明
OPERATION_STATE_UNSPECIFIED 無效狀態。
OPERATION_STATE_NOT_STARTED 稽核報告產生程序尚未開始。
OPERATION_STATE_EVALUATION_IN_PROGRESS 稽核管理員正在根據法規遵循控管措施評估資源。
OPERATION_STATE_EVALUATION_DONE Audit Manager 已完成法規遵循評估。
OPERATION_STATE_EVIDENCE_REPORT_GENERATION_IN_PROGRESS 稽核管理員會根據評估資料建立稽核報告。
OPERATION_STATE_EVIDENCE_REPORT_GENERATION_DONE Audit Manager 已產生稽核報告。
OPERATION_STATE_EVIDENCE_UPLOAD_IN_PROGRESS Audit Manager 正在將稽核報告和證據上傳至目的地。
OPERATION_STATE_DONE 稽核報告產生程序已完成。
OPERATION_STATE_FAILED 稽核報告生成程序失敗。

如果適用，每種執行狀態類型可能會提供下列額外資訊：

其他狀態 說明
failure_reason 如果稽核評估失敗，這個欄位會說明失敗的原因。
evaluation_percent_complete 如果評估作業已開始，這個欄位會顯示進度百分比。如果程序尚未開始，該欄位會從 0 開始。程序完成時，欄位會設為 100。
report_generation_percent_complete 如果報表產生作業已開始，這個欄位會提供進度百分比。如果程序尚未開始，該欄位會從 0 開始。程序完成時，欄位會設為 100。
report_uploading_percent_complete 如果報告上傳作業已開始，這個欄位會顯示進度百分比。如果程序尚未開始，該欄位會從 0 開始。程序完成時，欄位會設為 100。

成功的 REST 回應會與下列內容相似：

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

稽核報告完成並上傳後，系統會傳回報告的連結。

後續步驟