排定及執行稽核作業

您可以透過稽核收集所需證據,依據支援的架構評估Google Cloud 組織。您可以排定定期執行稽核,或隨選執行稽核。

稽核作業需要長時間執行,可能需要幾小時才能完成。所需時間取決於稽核範圍內的資源數量,也就是您先前註冊的組織、專案或資料夾。

安排稽核時,只有在特定架構和資源組合沒有運作中或已暫停的排程時,才能為該架構和資源建立排程。

事前準備

  • 確認您具備下列其中一個 IAM 角色:

    • Audit Manager 管理員 (roles/auditmanager.admin)
    • Audit Manager 稽核者 (roles/auditmanager.auditor)
  • 確認組織、專案或資料夾已註冊稽核。

排定及執行稽核作業

您可以建立排程,定期執行稽核,或隨選執行稽核。

控制台

  1. 在 Google Cloud 控制台,前往 Audit Manager 的「Run assessment」(執行評估) 頁面。

    前往「稽核管理工具」

  2. 在「Choose resource and region」(選擇資源和區域) 部分,執行下列操作:

    1. 選取要稽核的組織、資料夾或專案。

    2. 選取稽核評估的處理位置。如需支援的位置清單,請參閱「稽核管理工具位置」。

    3. 點選「下一步」。

  3. 在「Choose regulation」(選擇法規) 部分,選取要用來稽核資源的架構,然後點選「Next」(下一步)。如要瞭解支援的架構,請參閱「支援的架構」。

  4. 選用:如果畫面上顯示「Configure Parameters」(設定參數) 區段,請完成下列步驟:

    1. 按一下「修改設定」。

    2. 在「Configure parameters」(設定參數) 視窗中,新增雲端控管機制所需的參數。如要進一步瞭解參數,請參閱「Compliance Manager 雲端控管機制參考資料」和「Assured Workloads 雲端控管機制」。

    3. 按一下 [儲存]。

  5. 選用:在「View Assessment Plan」(查看評估計畫) 部分,您可以下載 ODS 檔案,其中包含根據所選架構的稽核範圍資訊。如要下載檔案,請點選連結,然後點選「Next」(下一步)。

  6. 在「Choose storage bucket」(選擇儲存空間 bucket) 部分,選取要儲存稽核報告和證據的儲存空間 bucket,然後按一下「Done」(完成)。如果未列出 bucket,請要求管理員使用儲存空間 bucket 註冊資源。

  7. 選用:在「Schedule」(排程) 部分,設定下列任一項目:

    • 重複稽核的頻率 (每日、每月、每季或每年)。

    • 稽核涵蓋的時間範圍。如果選擇「Never ending」(永不結束),稽核作業會從您指定的開始日期持續執行,直到您手動停止為止。

  8. 如要開始稽核,請按一下「執行稽核」或「執行排定的稽核」。

    您可以在「查看評估作業」頁面查看稽核狀態。

gcloud

選用:產生稽核評估

實際執行稽核前,您可以根據選擇的法規遵循架構,產生稽核評估 (或範圍),其中包含稽核的詳細工作細目。

gcloud audit-manager audit-scopes generate 指令會產生稽核範圍。

使用下列任何指令資料前,請先替換以下項目:

  • RESOURCE_TYPE:資源類型。有效值為 organization、folder 和 project。
  • RESOURCE_ID:組織、專案或資料夾的資源 ID。例如:8767234。
  • LOCATION:Audit Manager API 端點的位置。如需可用端點清單,請參閱「稽核管理工具位置」。例如:us-central1。
  • FRAMEWORK:要稽核的架構 ID。例如:builtin-cis-v8。如要查看架構 ID,請前往稽核管理工具的「查看評估」頁面。
  • AUDIT_REPORT_FORMAT:輸出稽核報告的格式。僅支援 ODF 格式:AUDIT_REPORT_FORMAT_ODF。
  • OUTPUT_DIRECTORY:輸出內容必須儲存的目錄。例如:reports。
  • OUTPUT_FILENAME:輸出檔案的名稱。請勿在檔案名稱中加入副檔名。例如:scopeReport。

執行下列指令:

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

執行隨選稽核

gcloud audit-manager audit-reports generate 指令會執行稽核。

使用下列任何指令資料前,請先替換以下項目:

  • RESOURCE_TYPE:資源類型。有效值為 organization、folder 和 project。
  • RESOURCE_ID:組織、專案或資料夾的資源 ID。例如:8767234。
  • LOCATION:Audit Manager API 端點的位置。如需可用端點清單,請參閱「稽核管理工具位置」。例如:us-central1。
  • FRAMEWORK:要稽核的架構 ID。例如:builtin-cis-v8。如要查看架構 ID,請前往稽核管理工具的「查看評估」頁面。
  • BUCKET_URI:Cloud Storage bucket 的 URI。例如:gs://testbucketauditmanager。
  • AUDIT_REPORT_FORMAT:輸出稽核報告的格式。僅支援 ODF 格式:AUDIT_REPORT_FORMAT_ODF。

執行下列指令:

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

您應該會收到類似以下的回應:

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

REST

選用:產生稽核評估

實際執行稽核前,您可以根據選擇的法規遵循架構,產生稽核評估 (或範圍),其中包含稽核的詳細工作細目。

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

  • RESOURCE_TYPE:資源類型。有效值為 organizations、folders 和 projects。
  • RESOURCE_ID:組織、專案或資料夾的資源 ID。例如:8767234。
  • LOCATION:Audit Manager API 端點的位置。如需可用端點清單,請參閱「稽核管理工具位置」。例如:us-central1。
  • FRAMEWORK:要稽核的架構 ID。例如:builtin-cis-v8。如要查看架構 ID,請前往稽核管理工具的「查看評估」頁面。
  • AUDIT_REPORT_FORMAT:輸出稽核報告的格式。僅支援 ODF 格式:AUDIT_REPORT_FORMAT_ODF。

HTTP 方法和網址:

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

JSON 要求內文:


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

如要傳送要求,請選擇以下其中一個選項:

curl

將要求主體儲存在名為 request.json 的檔案中,然後執行下列指令:

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

將要求主體儲存在名為 request.json 的檔案中,然後執行下列指令:

$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

您應該會收到如下的 JSON 回覆:

{

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

回應包含下列資訊:

    scope_reports_contents 欄位是內容的位元組格式,必須先轉換為 ODF 格式才能查看。

  • name:適用資源的專屬字串 ID。

執行隨選稽核

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

  • RESOURCE_TYPE:資源類型。有效值為 organizations、folders 和 projects。
  • RESOURCE_ID:組織、專案或資料夾的資源 ID。例如:8767234。
  • LOCATION:Audit Manager API 端點的位置。如需可用端點清單,請參閱「稽核管理工具位置」。例如:us-central1。
  • FRAMEWORK:要稽核的架構 ID。例如:builtin-cis-v8。如要查看架構 ID,請前往稽核管理工具的「查看評估」頁面。
  • BUCKET_URI:Cloud Storage bucket 的 URI。例如:gs://testbucketauditmanager。
  • AUDIT_REPORT_FORMAT:輸出稽核報告的格式。僅支援 ODF 格式:AUDIT_REPORT_FORMAT_ODF。

HTTP 方法和網址:

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

JSON 要求內文:


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

如要傳送要求,請選擇以下其中一個選項:

curl

將要求主體儲存在名為 request.json 的檔案中,然後執行下列指令:

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

將要求主體儲存在名為 request.json 的檔案中,然後執行下列指令:

$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

您應該會收到如下的 JSON 回覆:

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

回應包含下列資訊:

  • name:稽核評估作業要求的專屬字串 ID。這個 ID 用於追蹤稽核評估程序的進度。例如:operation/098234。
  • done:布林值標記,設為 false,表示程序已觸發。稽核評估完成後,這個值會設為 true。

執行排定的稽核作業

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

  • RESOURCE_TYPE:資源類型。有效值為 organizations、folders 和 projects。
  • RESOURCE_ID:組織、專案或資料夾的資源 ID。例如:8767234。
  • LOCATION:Audit Manager API 端點的位置。如需可用端點清單,請參閱「稽核管理工具位置」。例如:us-central1。
  • FRAMEWORK:要稽核的架構 ID。例如:builtin-cis-v8。如要查看架構 ID,請前往稽核管理工具的「查看評估」頁面。
  • BUCKET_URI:Cloud Storage bucket 的 URI。例如:gs://testbucketauditmanager。
  • AUDIT_REPORT_FORMAT:輸出稽核報告的格式。僅支援 ODF 格式:AUDIT_REPORT_FORMAT_ODF。
  • DISPLAY_NAME:稽核排程的名稱。例如:NIST 800-53 Daily Audit。
  • SCHEDULE_START_TIME:稽核排程生效的時間戳記。例如:2026-02-25T10:00:00Z。
  • SCHEDULE_END_TIME:稽核排程停止的時間戳記。例如:2027-02-25T10:00:00Z。
  • FREQUENCY:排定稽核作業的執行頻率。可能的值為:DAILY、WEEKLY、MONTHLY、QUARTERLY 或 ANNUALLY。例如:DAILY。
  • TIME_ZONE:稽核排程的時區,採用 IANA 格式。這個變數用於解讀 start_time 和 end_time。如未指定,則預設為世界標準時間。例如:America/New_York。
  • SCHEDULE_STATE:稽核排程的狀態。可以是 SCHEDULE_STATE_ACTIVE、SCHEDULE_STATE_PAUSED 或 SCHEDULE_STATE_DELETED。例如:SCHEDULE_STATE_ACTIVE。
  • AUDIT_SCHEDULE_ID:稽核排程的專屬 ID。

HTTP 方法和網址:

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

JSON 要求內文:

{
  "display_name": "DISPLAY_NAME",
  "gcs_uri": "BUCKET_URI",
  "compliance_framework": "FRAMEWORK",
  "report_format": "AUDIT_REPORT_FORMAT",
  "schedule_config": {
    "start_time": "SCHEDULE_START_TIME",
    "end_time": "SCHEDULE_END_TIME",
    "frequency": "FREQUENCY",
    "time_zone": "TIME_ZONE"
  },
  "state": "SCHEDULE_STATE"
}

如要傳送要求,請選擇以下其中一個選項:

curl

將要求主體儲存在名為 request.json 的檔案中,然後執行下列指令:

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?audit_schedule_id=AUDIT_SCHEDULE_ID"

PowerShell

將要求主體儲存在名為 request.json 的檔案中,然後執行下列指令:

$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?audit_schedule_id=AUDIT_SCHEDULE_ID" | Select-Object -Expand Content

您應該會收到如下的 JSON 回覆:

{
  "name": "projects/834/locations/us-central1/auditSchedules/my-schedule-id",
  "display_name": "My first audit schedule",
  "gcs_uri": "gs://my-bucket",
  "compliance_framework": "NIST_800_53",
  "report_format": "AUDIT_REPORT_FORMAT_ODF",
  "schedule_config": {
    "start_time": "2026-02-25T10:00:00Z",
    "end_time": "2027-02-25T10:00:00Z",
    "frequency": "DAILY",
    "time_zone": "America/New_York"
  },
  "state": "SCHEDULE_STATE_ACTIVE",
  "create_time": "2026-02-25T13:27:00Z",
  "update_time": "2026-02-25T13:27:00Z"
}

更新排定的稽核作業

您可以暫停、繼續及停止週期性稽核。如要變更排程,請刪除現有的排定稽核,然後建立新的排定稽核。

控制台

  1. 前往 Google Cloud 控制台,在 Audit Manager 中前往「Audit management」(稽核管理) 頁面。

    前往「稽核管理工具」

  2. 在「排程」分頁中,找出要更新的排定稽核作業。

  3. 執行下列其中一個步驟:

    • 如要暫停稽核排程,請按一下 「暫停排程」。

    • 如要重新啟動已暫停的稽核,請按一下「 繼續排程」。

    • 如要刪除排定的稽核,請按一下「 停止排程」。

REST

如要暫停、繼續或刪除稽核排程,請傳送 PATCH 要求,更新稽核排程的 state。

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

  • RESOURCE_TYPE:資源類型。有效值為 organizations、folders 和 projects。
  • RESOURCE_ID:組織、專案或資料夾的資源 ID。例如:8767234。
  • LOCATION:Audit Manager API 端點的位置。如需可用端點清單,請參閱「稽核管理工具位置」。例如:us-central1。
  • AUDIT_SCHEDULE_ID:要更新的稽核排程 ID。例如:my-schedule-id。
  • SCHEDULE_STATE:稽核排程的目標狀態。設為下列其中一項:
    • SCHEDULE_STATE_PAUSED:暫停進行中的排程。
    • SCHEDULE_STATE_ACTIVE:恢復已暫停的時間表。
    • SCHEDULE_STATE_DELETED:停止並刪除排程。

HTTP 方法和網址:

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

JSON 要求內文:

{
  "state": "SCHEDULE_STATE"
}

如要傳送要求,請選擇以下其中一個選項:

curl

將要求主體儲存在名為 request.json 的檔案中,然後執行下列指令:

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

將要求主體儲存在名為 request.json 的檔案中,然後執行下列指令:

$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

您應該會收到如下的 JSON 回覆:

{
  "name": "projects/834/locations/us-central1/auditSchedules/my-schedule-id",
  "display_name": "My first audit schedule",
  "gcs_uri": "gs://my-bucket",
  "compliance_framework": "NIST_800_53",
  "report_format": "AUDIT_REPORT_FORMAT_ODF",
  "schedule_config": {
    "start_time": "2026-02-25T10:00:00Z",
    "end_time": "2027-02-25T10:00:00Z",
    "frequency": "DAILY",
    "time_zone": "America/New_York"
  },
  "state": "SCHEDULE_STATE_PAUSED",
  "create_time": "2026-02-25T13:27:00Z",
  "update_time": "2026-09-11T18:15:00Z"
}

後續步驟