取得稽核狀態

您可以透過 Audit Manager 或 Compliance Manager，取得進行中稽核的狀態。稽核作業可能需要較長時間才能完成，追蹤這項狀態有助於瞭解稽核作業的進度。

事前準備

取得進行中稽核作業的狀態

控制台

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

    前往「查看稽核記錄」

  2. 在「View assessments」(查看評估) 頁面中，您可以查看進行中稽核作業的目前狀態，或進一步瞭解已完成的稽核作業。

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

  4. (預覽) 選用：如要使用新版控制台查看稽核狀態，請完成下列步驟：

    1. 按一下「切換至新版介面」。

    2. 如要查看稽核的詳細資訊，請按一下稽核名稱。

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 Audit Manager 正在根據法規遵循控管機制評估資源。
OPERATION_STATE_EVALUATION_DONE Audit Manager 已完成法規遵循評估。
OPERATION_STATE_EVIDENCE_REPORT_GENERATION_IN_PROGRESS 稽核管理員正在根據評估資料建立稽核報告。
OPERATION_STATE_EVIDENCE_REPORT_GENERATION_DONE 稽核管理工具已產生稽核報告。
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 Audit Manager 正在根據法規遵循控管機制評估資源。
OPERATION_STATE_EVALUATION_DONE Audit Manager 已完成法規遵循評估。
OPERATION_STATE_EVIDENCE_REPORT_GENERATION_IN_PROGRESS 稽核管理員正在根據評估資料建立稽核報告。
OPERATION_STATE_EVIDENCE_REPORT_GENERATION_DONE 稽核管理工具已產生稽核報告。
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"
  }
}

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

後續步驟