排定或執行稽核

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

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

只有在特定架構和資源組合沒有啟用或暫停的排程時，才能為該組合建立排程。

事前準備

排定及執行稽核作業

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

控制台

  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」(選擇儲存空間值區) 部分，選取要儲存稽核報告和證據的儲存空間值區，然後按一下「Done」(完成)。如果未列出值區，請要求管理員註冊資源和儲存空間 bucket。

  7. 選用：在「Schedule」(時間表) 部分，設定下列任一項目：

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

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

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

    您可以在「View assessments」(查看評估) 頁面查看隨選稽核的狀態，或在「Audit management」(稽核管理) 頁面的「Schedules」(排程) 分頁查看排定的稽核。

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，請前往 Google Cloud 控制台的「查看評估」頁面。
  • 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，請前往 Google Cloud 控制台的「查看評估」頁面。
  • 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

排定稽核作業

gcloud audit-manager audit-schedules create 指令會建立稽核排程。

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

  • RESOURCE_TYPE：資源類型。有效值為 organization、folder 和 project。
  • RESOURCE_ID：組織、專案或資料夾的資源 ID。例如：8767234。
  • LOCATION：Audit Manager API 端點的位置。如需可用端點清單，請參閱「稽核管理工具位置」。例如：us-central1。
  • AUDIT_SCHEDULE_ID：稽核排程的 ID。例如：my-schedule-id。如要查看現有排程的 ID，請前往 Google Cloud 控制台的「Audit management」(稽核管理) 頁面。
  • FRAMEWORK：要稽核的架構 ID。例如：builtin-cis-v8。如要查看架構 ID，請前往 Google Cloud 控制台的「查看評估」頁面。
  • AUDIT_REPORT_FORMAT：輸出稽核報告的格式。僅支援 OpenDocument 格式 (ODF)：odf。
  • BUCKET_URI：Cloud Storage bucket 的 URI。例如：gs://testbucketauditmanager。
  • FREQUENCY：排定稽核執行的頻率。有效值為 daily、weekly、monthly、quarterly 和 annually。例如：weekly。
  • SCHEDULE_START_TIME：第一次稽核執行的開始日期和時間，採用 RFC 3339 格式。例如：2026-10-25T10:00:00Z。
  • DISPLAY_NAME：選用。稽核排程的顯示名稱。例如：NIST 800-53 Weekly Audit。
  • SCHEDULE_END_TIME：選用。稽核排程停止的日期和時間，採用 RFC 3339 格式。例如：2027-10-25T10:00:00Z。
  • TIME_ZONE：選用。稽核排程的時區，採用 IANA 格式。稽核管理工具會使用這個值解讀開始時間和結束時間。如未指定，預設值為 UTC。例如：America/New_York。

執行下列指令：

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

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

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

選用：產生稽核評估

執行稽核前，您可以產生稽核評估或範圍，其中包含根據所選架構的詳細稽核工作細目。

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

  • RESOURCE_TYPE：資源類型。有效值為 organizations、folders 和 projects。
  • RESOURCE_ID：組織、專案或資料夾的資源 ID。例如：8767234。
  • LOCATION：Audit Manager API 端點的位置。如需可用端點清單，請參閱「稽核管理工具位置」。例如：us-central1。
  • FRAMEWORK：要稽核的架構 ID。例如：builtin-cis-v8。如要查看架構 ID，請前往 Google Cloud 控制台的「查看評估」頁面。
  • 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_report_contents：報表內容的位元組格式，必須先轉換為 OpenDocument 格式 (ODF) 才能查看。
  • name：適用資源的專屬字串 ID。

執行隨選稽核

如要執行隨選稽核，請將 POST 要求傳送至 auditReport:generate 端點。

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

  • RESOURCE_TYPE：資源類型。有效值為 organizations、folders 和 projects。
  • RESOURCE_ID：組織、專案或資料夾的資源 ID。例如：8767234。
  • LOCATION：Audit Manager API 端點的位置。如需可用端點清單，請參閱「稽核管理工具位置」。例如：us-central1。
  • FRAMEWORK：要稽核的架構 ID。例如：builtin-cis-v8。如要查看架構 ID，請前往 Google Cloud 控制台的「查看評估」頁面。
  • 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 追蹤稽核評估進度。例如：projects/PROJECT_ID/locations/LOCATION/operations/098234UNIQUE_ID。
  • done：布林值旗標，指出稽核評估是否完成。程序開始時，這個標記會設為 false，稽核評估完成後則會變更為 true。

排定稽核作業

如要排定週期性稽核，請將 POST 要求傳送至 auditSchedules 端點。

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

  • RESOURCE_TYPE：資源類型。有效值為 organizations、folders 和 projects。
  • RESOURCE_ID：組織、專案或資料夾的資源 ID。例如：8767234。
  • LOCATION：Audit Manager API 端點的位置。如需可用端點清單，請參閱「稽核管理工具位置」。例如：us-central1。
  • AUDIT_SCHEDULE_ID：稽核排程的 ID。例如：my-schedule-id。如要查看現有排程的 ID，請前往 Google Cloud 控制台的「Audit management」(稽核管理) 頁面。
  • FRAMEWORK：要稽核的架構 ID。例如：builtin-cis-v8。如要查看架構 ID，請前往 Google Cloud 控制台的「查看評估」頁面。
  • BUCKET_URI：Cloud Storage bucket 的 URI。例如：gs://testbucketauditmanager。
  • AUDIT_REPORT_FORMAT：輸出稽核報告的格式。僅支援 ODF 格式：AUDIT_REPORT_FORMAT_ODF。
  • FREQUENCY：排定稽核執行的頻率。有效值為 DAILY、WEEKLY、MONTHLY、QUARTERLY 和 ANNUALLY。例如：WEEKLY。
  • SCHEDULE_START_TIME：第一次稽核執行的開始日期和時間，採用 RFC 3339 格式。例如：2026-10-25T10:00:00Z。
  • DISPLAY_NAME：選用。稽核排程的顯示名稱。例如：NIST 800-53 Weekly Audit。
  • SCHEDULE_END_TIME：選用。稽核排程停止的日期和時間，採用 RFC 3339 格式。例如：2027-10-25T10:00:00Z。
  • TIME_ZONE：選用。稽核排程的時區，採用 IANA 格式。稽核管理工具會使用這個值解讀開始時間和結束時間。如未指定，預設值為 UTC。例如：America/New_York。

HTTP 方法和網址：

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

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

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

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

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

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

查看排定的稽核作業

您可以查看排定稽核的詳細資料，包括範圍、架構和排程設定。

控制台

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

    前往稽核管理工具

  2. 在「時程」分頁中，查看已排定的稽核清單。

gcloud

查看排定的稽核清單

如要查看排定的稽核清單，請執行 gcloud audit-manager audit-schedules list 指令。

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

  • RESOURCE_TYPE：資源類型。有效值為 organization、folder 和 project。
  • RESOURCE_ID：組織、專案或資料夾的資源 ID。例如：8767234。
  • LOCATION：Audit Manager API 端點的位置。如需可用端點清單，請參閱「稽核管理工具位置」。例如：us-central1。

執行下列指令：

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

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

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

查看排定稽核的詳細資料

如要查看特定排定稽核的詳細資料，請執行 gcloud audit-manager audit-schedules describe 指令。

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

  • RESOURCE_TYPE：資源類型。有效值為 organizations、folders 和 projects。
  • RESOURCE_ID：組織、專案或資料夾的資源 ID。例如：8767234。
  • LOCATION：Audit Manager API 端點的位置。如需可用端點清單，請參閱「稽核管理工具位置」。例如：us-central1。
  • AUDIT_SCHEDULE_ID：稽核排程的 ID。例如：my-schedule-id。如要查看現有排程的 ID，請前往 Google Cloud 控制台的「Audit management」(稽核管理) 頁面。

執行下列指令：

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

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

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

查看排定的稽核清單

如要查看排定的稽核清單，請向 auditSchedules 端點傳送 GET 要求。

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

  • RESOURCE_TYPE：資源類型。有效值為 organizations、folders 和 projects。
  • RESOURCE_ID：組織、專案或資料夾的資源 ID。例如：8767234。
  • LOCATION：Audit Manager API 端點的位置。如需可用端點清單，請參閱「稽核管理工具位置」。例如：us-central1。

HTTP 方法和網址：

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

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

curl

執行下列指令： 

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

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/auditSchedules" | Select-Object -Expand Content

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

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

查看排定稽核的詳細資料

如要查看特定排定稽核作業的詳細資料，請將 GET 要求傳送至 auditSchedules 端點，並指定排程 ID。

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

  • RESOURCE_TYPE：資源類型。有效值為 organizations、folders 和 projects。
  • RESOURCE_ID：組織、專案或資料夾的資源 ID。例如：8767234。
  • LOCATION：Audit Manager API 端點的位置。如需可用端點清單，請參閱「稽核管理工具位置」。例如：us-central1。
  • AUDIT_SCHEDULE_ID：稽核排程的 ID。例如：my-schedule-id。如要查看現有排程的 ID，請前往 Google Cloud 控制台的「Audit management」(稽核管理) 頁面。

HTTP 方法和網址：

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

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

curl

執行下列指令： 

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

執行下列指令： 

$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

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

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

更新排定的稽核作業

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

控制台

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

    前往「稽核管理工具」

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

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

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

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

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

gcloud

如要暫停、繼續或刪除稽核排程，請執行 gcloud audit-manager audit-schedules update 指令，更新排程狀態。

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

  • RESOURCE_TYPE：資源類型。有效值為 organizations、folders 和 projects。
  • RESOURCE_ID：組織、專案或資料夾的資源 ID。例如：8767234。
  • LOCATION：Audit Manager API 端點的位置。如需可用端點清單，請參閱「稽核管理工具位置」。例如：us-central1。
  • AUDIT_SCHEDULE_ID：稽核排程的 ID。例如：my-schedule-id。如要查看現有排程的 ID，請前往 Google Cloud 控制台的「Audit management」(稽核管理) 頁面。
  • SCHEDULE_STATE：稽核排程的目標狀態。設為下列其中一項：
    • paused：暫停進行中的排程。
    • active：恢復已暫停的時間表。
    • deleted：停止並刪除排程。

執行下列指令：

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

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

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

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

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

  • RESOURCE_TYPE：資源類型。有效值為 organizations、folders 和 projects。
  • RESOURCE_ID：組織、專案或資料夾的資源 ID。例如：8767234。
  • LOCATION：Audit Manager API 端點的位置。如需可用端點清單，請參閱「稽核管理工具位置」。例如：us-central1。
  • AUDIT_SCHEDULE_ID：稽核排程的 ID。例如：my-schedule-id。如要查看現有排程的 ID，請前往 Google Cloud 控制台的「Audit management」(稽核管理) 頁面。
  • 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",
  "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"
}

後續步驟