安排和运行审核

通过审核,您可以收集根据支持的框架评估Google Cloud 组织所需的证据。您可以安排定期运行审核,也可以按需运行审核。

审核是一项长时间运行的操作,可能需要几个小时。时长取决于审核范围内的资源数量,即您之前注册的组织、项目或文件夹。

如果您安排审核,则只能在框架和资源组合尚无有效或已暂停的时间表时,为特定框架和资源创建时间表。

准备工作

  • 确保您拥有以下 IAM 角色之一:

    • Audit Manager Admin (roles/auditmanager.admin)
    • Audit Manager Auditor (roles/auditmanager.auditor)
  • 确保您的组织、项目或文件夹已注册进行审核。

安排和运行审核

您可以创建时间表来定期运行审核,也可以按需运行审核。

控制台

  1. 在 Google Cloud 控制台中,前往 Audit Manager 中的运行评估页面。

    前往 Audit Manager

  2. 在选择资源和区域部分中,执行以下操作:

    1. 选择需要审核的组织、文件夹或项目。

    2. 选择必须在哪个位置处理审核评估。如需查看受支持位置的列表,请参阅 Audit Manager 位置。

    3. 点击下一步。

  3. 在选择法规部分中,选择要用于审核资源的框架,然后点击下一步。如需了解支持的框架,请参阅支持的框架。

  4. 可选:如果显示配置参数部分,请完成以下操作:

    1. 点击修改配置。

    2. 在配置参数窗口中,为云控制措施添加所需的参数。如需详细了解这些参数,请参阅合规性管理器云控制参考文档和 Assured Workloads 云控制。

    3. 点击保存。

  5. 可选:在查看评估计划部分中,您可以下载一个 ODS 文件,其中包含基于您所选框架的审核范围信息。如需下载该文件,请点击相应链接,然后点击下一步。

  6. 在选择存储桶部分中,选择必须保存审核报告和证据的存储桶,然后点击完成。如果您的存储桶未列出,请让管理员将您的资源注册到您的存储桶。

  7. 可选:在时间表部分中,设置以下任一选项:

    • 重复审核的频率(每天、每月、每季度或每年)。

    • 要纳入审核的时间段。如果您选择永不结束,则审核会从您指定的开始日期开始持续运行,直到您手动停止。

  8. 如需开始审核,请点击运行审核或运行预定的审核。

    您可以在查看评估页面上查看审核状态。

gcloud

可选:生成审核评估

在运行实际审核之前,您可以生成审核评估(或范围),其中包含根据您选择的合规性框架对审核进行的详细任务细分。

gcloud audit-manager audit-scopes generate 命令会生成审核范围。

在使用下面的命令数据之前,请先进行以下替换:

  • RESOURCE_TYPE:资源类型。有效值为 organization、folder 和 project。
  • RESOURCE_ID:组织、项目或文件夹的资源 ID。例如:8767234。
  • LOCATION:Audit Manager API 端点的位置。如需查看可用端点的列表,请参阅 Audit Manager 位置。例如:us-central1。
  • FRAMEWORK:要审核的框架的 ID。例如:builtin-cis-v8。如需查找框架的 ID,请参阅 Audit Manager 中的查看评估页面。
  • 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 端点的位置。如需查看可用端点的列表,请参阅 Audit Manager 位置。例如:us-central1。
  • FRAMEWORK:要审核的框架的 ID。例如:builtin-cis-v8。如需查找框架的 ID,请参阅 Audit Manager 中的查看评估页面。
  • BUCKET_URI:Cloud Storage 存储桶的 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 端点的位置。如需查看可用端点的列表,请参阅 Audit Manager 位置。例如:us-central1。
  • FRAMEWORK:要审核的框架的 ID。例如:builtin-cis-v8。如需查找框架的 ID,请参阅 Audit Manager 中的查看评估页面。
  • 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:适用资源的唯一字符串标识符。

运行按需审核

在使用任何请求数据之前,请先进行以下替换:

  • RESOURCE_TYPE:资源类型。有效值为 organizations、folders 和 projects。
  • RESOURCE_ID:组织、项目或文件夹的资源 ID。例如:8767234。
  • LOCATION:Audit Manager API 端点的位置。如需查看可用端点的列表,请参阅 Audit Manager 位置。例如:us-central1。
  • FRAMEWORK:要审核的框架的 ID。例如:builtin-cis-v8。如需查找框架的 ID,请参阅 Audit Manager 中的查看评估页面。
  • BUCKET_URI:Cloud Storage 存储桶的 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:审核评估操作请求的唯一字符串标识符。 此标识符用于跟踪审核评估流程的进度。例如:operation/098234。
  • done:一个布尔值标志,设置为 false,表示该过程已触发。审核评估完成后,此字段会设置为 true。

运行预定审核

在使用任何请求数据之前,请先进行以下替换:

  • RESOURCE_TYPE:资源类型。有效值为 organizations、folders 和 projects。
  • RESOURCE_ID:组织、项目或文件夹的资源 ID。例如:8767234。
  • LOCATION:Audit Manager API 端点的位置。如需查看可用端点的列表,请参阅 Audit Manager 位置。例如:us-central1。
  • FRAMEWORK:要审核的框架的 ID。例如:builtin-cis-v8。如需查找框架的 ID,请参阅 Audit Manager 中的查看评估页面。
  • BUCKET_URI:Cloud Storage 存储桶的 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。如果未指定,则默认为世界协调时间 (UTC)。例如:America/New_York。
  • SCHEDULE_STATE:审核时间表的状态。可以是以下值之一:SCHEDULE_STATE_ACTIVE、SCHEDULE_STATE_PAUSED 或 SCHEDULE_STATE_DELETED。例如:SCHEDULE_STATE_ACTIVE。
  • AUDIT_SCHEDULE_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 Manager

  2. 在时间表标签页中,找到要更新的预定审核。

  3. 执行下列其中一项操作:

    • 如需暂停审核时间表,请点击 暂停时间表。

    • 如需重启已暂停的审核,请点击 恢复时间表。

    • 如需删除预定的审核,请点击 停止预定。

REST

如需暂停、恢复或删除审核时间表,请发送 PATCH 请求以更新审核时间表的 state。

在使用任何请求数据之前,请先进行以下替换:

  • RESOURCE_TYPE:资源类型。有效值为 organizations、folders 和 projects。
  • RESOURCE_ID:组织、项目或文件夹的资源 ID。例如:8767234。
  • LOCATION:Audit Manager API 端点的位置。如需查看可用端点的列表,请参阅 Audit Manager 位置。例如: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"
}

后续步骤