通过审核,您可以收集根据支持的框架评估Google Cloud 组织所需的证据。您可以安排定期运行审核,也可以按需运行审核。
审核是一项长时间运行的操作,可能需要几个小时。时长取决于审核范围内的资源数量,即您之前注册的组织、项目或文件夹。
如果您安排审核,则只能在框架和资源组合尚无有效或已暂停的时间表时,为特定框架和资源创建时间表。
准备工作
确保您拥有以下 IAM 角色之一:
- Audit Manager Admin (
roles/auditmanager.admin) - Audit Manager Auditor (
roles/auditmanager.auditor)
- Audit Manager Admin (
确保您的组织、项目或文件夹已注册进行审核。
安排和运行审核
您可以创建时间表来定期运行审核,也可以按需运行审核。
控制台
在 Google Cloud 控制台中,前往 Audit Manager 中的运行评估页面。
在选择资源和区域部分中,执行以下操作:
选择需要审核的组织、文件夹或项目。
选择必须在哪个位置处理审核评估。如需查看受支持位置的列表,请参阅 Audit Manager 位置。
点击下一步。
在选择法规部分中,选择要用于审核资源的框架,然后点击下一步。如需了解支持的框架,请参阅支持的框架。
可选:如果显示配置参数部分,请完成以下操作:
点击修改配置。
在配置参数窗口中,为云控制措施添加所需的参数。如需详细了解这些参数,请参阅合规性管理器云控制参考文档和 Assured Workloads 云控制。
点击保存。
可选:在查看评估计划部分中,您可以下载一个 ODS 文件,其中包含基于您所选框架的审核范围信息。如需下载该文件,请点击相应链接,然后点击下一步。
在选择存储桶部分中,选择必须保存审核报告和证据的存储桶,然后点击完成。如果您的存储桶未列出,请让管理员将您的资源注册到您的存储桶。
可选:在时间表部分中,设置以下任一选项:
重复审核的频率(每天、每月、每季度或每年)。
要纳入审核的时间段。如果您选择永不结束,则审核会从您指定的开始日期开始持续运行,直到您手动停止。
如需开始审核,请点击运行审核或运行预定的审核。
您可以在查看评估页面上查看审核状态。
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"
}
响应包含以下信息:
name:适用资源的唯一字符串标识符。
scope_reports_contents 字段是内容的字节格式,在审核之前必须转换为 ODF 格式。
运行按需审核
在使用任何请求数据之前,请先进行以下替换:
- 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"
}
更新预定审核
您可以暂停、恢复和停止周期性审核。如果您想更改时间表,则必须删除现有的预定审核,然后创建新的预定审核。
控制台
在 Google Cloud 控制台中,前往 Audit Manager 中的审核管理页面。
在时间表标签页中,找到要更新的预定审核。
执行下列其中一项操作:
如需暂停审核时间表,请点击 暂停时间表。
如需重启已暂停的审核,请点击 恢复时间表。
如需删除预定的审核,请点击 停止预定。
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"
}