Google 会使用 AI 技术将内容翻译成您偏好的语言。AI 翻译可能包含错误。

安排或运行审核

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

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

只有在特定框架和资源组合尚无有效或暂停的时间表时，您才能为该组合创建时间表。

准备工作

如需获得运行或安排审核所需的权限，请让管理员向您授予以下 Identity and Access Management (IAM) 角色之一：
- Audit Manager Admin (roles/auditmanager.admin)
- Audit Manager Auditor (roles/auditmanager.auditor)
注册您的组织、项目或文件夹以进行审核。

安排和运行审核

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

控制台

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

前往 Audit Manager
在选择资源和区域部分中，执行以下操作：
1. 选择您要审核的组织、文件夹或项目。
2. 选择您要处理审核评估的位置。如需查看受支持位置的列表，请参阅 Audit Manager 位置。
3. 点击下一步。
在选择法规部分中，选择要用于审核资源的框架，然后点击下一步。如需了解支持的框架，请参阅支持的框架。
可选：如果显示配置参数部分，请完成以下操作：
1. 点击修改配置。
2. 在配置参数窗口中，为云控制措施添加所需的参数。如需详细了解这些参数，请参阅合规性管理器云控制参考文档和 Assured Workloads 云控制。
3. 点击保存。
可选：在查看评估计划部分中，您可以下载一个 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，请参阅 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 端点的位置。如需查看可用端点的列表，请参阅 Audit Manager 位置。例如：us-central1。
FRAMEWORK：要审核的框架的 ID。例如：builtin-cis-v8。如需查找框架的 ID，请参阅 Google Cloud 控制台中的查看评估页面。
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

安排审核

gcloud audit-manager audit-schedules create 命令用于创建审核时间表。

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

RESOURCE_TYPE：资源类型。有效值为 organization、folder 和 project。
RESOURCE_ID：组织、项目或文件夹的资源 ID。例如：8767234。
LOCATION：Audit Manager API 端点的位置。如需查看可用端点的列表，请参阅 Audit Manager 位置。例如：us-central1。
AUDIT_SCHEDULE_ID：审核时间表的 ID。例如：my-schedule-id。如需查找现有时间表的 ID，请参阅 Google Cloud 控制台中的审核管理页面。
FRAMEWORK：要审核的框架的 ID。例如：builtin-cis-v8。如需查找框架的 ID，请参阅 Google Cloud 控制台中的查看评估页面。
AUDIT_REPORT_FORMAT：输出审核报告的格式。仅支持 OpenDocument 格式 (ODF)：odf。
BUCKET_URI：Cloud Storage 存储桶的 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 格式）。Audit Manager 会使用此值来解读开始时间和结束时间。如果未指定，则默认值为 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 端点的位置。如需查看可用端点的列表，请参阅 Audit Manager 位置。例如：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

注意：以下命令假定您已使用您的用户账号通过运行 gcloud init 或 gcloud auth login 登录 gcloud CLI，或者使用了 Cloud Shell，这会使您自动登录 gcloud CLI。您可以运行 gcloud auth list 来检查当前活跃的账号。

将请求正文保存在名为 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

注意：以下命令假定您已使用您的用户账号通过运行 gcloud init 或 gcloud auth login 登录 gcloud CLI。您可以运行 gcloud auth list 来检查当前活跃的账号。

将请求正文保存在名为 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：适用资源的唯一字符串标识符。

运行按需审核

如需运行按需审核，请向 auditReport:generate 端点发送 POST 请求。

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

RESOURCE_TYPE：资源类型。有效值为 organizations、folders 和 projects。
RESOURCE_ID：组织、项目或文件夹的资源 ID。例如：8767234。
LOCATION：Audit Manager API 端点的位置。如需查看可用端点的列表，请参阅 Audit Manager 位置。例如：us-central1。
FRAMEWORK：要审核的框架的 ID。例如：builtin-cis-v8。如需查找框架的 ID，请参阅 Google Cloud 控制台中的查看评估页面。
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

注意：以下命令假定您已使用您的用户账号通过运行 gcloud init 或 gcloud auth login 登录 gcloud CLI。您可以运行 gcloud auth list 来检查当前活跃的账号。

将请求正文保存在名为 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：审核评估操作请求的唯一字符串标识符。使用此标识符跟踪审核评估的进度。例如 projects/PROJECT_ID/locations/LOCATION/operations/098234UNIQUE_ID。
done：一个布尔值标志，用于指示审核评估是否已完成。此标志在流程开始时设置为 false，并在审核评估完成后更改为 true。

安排审核

如需安排定期审核，请向 auditSchedules 端点发送 POST 请求。

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

RESOURCE_TYPE：资源类型。有效值为 organizations、folders 和 projects。
RESOURCE_ID：组织、项目或文件夹的资源 ID。例如：8767234。
LOCATION：Audit Manager API 端点的位置。如需查看可用端点的列表，请参阅 Audit Manager 位置。例如：us-central1。
AUDIT_SCHEDULE_ID：审核时间表的 ID。例如：my-schedule-id。如需查找现有时间表的 ID，请参阅 Google Cloud 控制台中的审核管理页面。
FRAMEWORK：要审核的框架的 ID。例如：builtin-cis-v8。如需查找框架的 ID，请参阅 Google Cloud 控制台中的查看评估页面。
BUCKET_URI：Cloud Storage 存储桶的 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 格式）。Audit Manager 会使用此值来解读开始时间和结束时间。如果未指定，则默认值为 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

注意：以下命令假定您已使用您的用户账号通过运行 gcloud init 或 gcloud auth login 登录 gcloud CLI。您可以运行 gcloud auth list 来检查当前活跃的账号。

将请求正文保存在名为 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"
}

查看预定审核

您可以查看有关预定审核的详细信息，包括范围、框架和时间表配置。

控制台

在 Google Cloud 控制台中，前往 Audit Manager 中的审核管理页面。

前往 Audit Manager
在时间表标签页中，查看已安排的审核列表。

gcloud

查看预定审核列表

如需查看预定审核的列表，请运行 gcloud audit-manager audit-schedules list 命令。

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

RESOURCE_TYPE：资源类型。有效值为 organization、folder 和 project。
RESOURCE_ID：组织、项目或文件夹的资源 ID。例如：8767234。
LOCATION：Audit Manager API 端点的位置。如需查看可用端点的列表，请参阅 Audit Manager 位置。例如：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 端点的位置。如需查看可用端点的列表，请参阅 Audit Manager 位置。例如：us-central1。
AUDIT_SCHEDULE_ID：审核时间表的 ID。例如：my-schedule-id。如需查找现有时间表的 ID，请参阅 Google Cloud 控制台中的审核管理页面。

执行以下命令：

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 端点的位置。如需查看可用端点的列表，请参阅 Audit Manager 位置。例如：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

注意：以下命令假定您已使用您的用户账号通过运行 gcloud init 或 gcloud auth login 登录 gcloud CLI。您可以运行 gcloud auth list 来检查当前活跃的账号。

执行以下命令：

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

查看有关预定审核的详细信息

如需查看特定预定审核的详细信息，请向 auditSchedules 端点发送 GET 请求，并指定预定 ID。

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

RESOURCE_TYPE：资源类型。有效值为 organizations、folders 和 projects。
RESOURCE_ID：组织、项目或文件夹的资源 ID。例如：8767234。
LOCATION：Audit Manager API 端点的位置。如需查看可用端点的列表，请参阅 Audit Manager 位置。例如：us-central1。
AUDIT_SCHEDULE_ID：审核时间表的 ID。例如：my-schedule-id。如需查找现有时间表的 ID，请参阅 Google Cloud 控制台中的审核管理页面。

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

注意：以下命令假定您已使用您的用户账号通过运行 gcloud init 或 gcloud auth login 登录 gcloud CLI。您可以运行 gcloud auth list 来检查当前活跃的账号。

执行以下命令：

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

更新预定审核

您可以暂停、恢复和停止周期性审核。如需更改时间表，您必须删除现有预定审核，然后创建新的预定审核。

控制台

在 Google Cloud 控制台中，前往 Audit Manager 中的审核管理页面。

前往 Audit Manager
在时间表标签页中，找到要更新的预定审核。
执行下列其中一项操作：
- 如需暂停审核时间表，请点击 暂停时间表。
- 如需重启已暂停的审核，请点击 恢复时间表。
- 如需删除预定的审核，请点击 停止预定。

gcloud

如需暂停、恢复或删除审核时间表，请运行 gcloud audit-manager audit-schedules update 命令以更新时间表的状态。

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

RESOURCE_TYPE：资源类型。有效值为 organizations、folders 和 projects。
RESOURCE_ID：组织、项目或文件夹的资源 ID。例如：8767234。
LOCATION：Audit Manager API 端点的位置。如需查看可用端点的列表，请参阅 Audit Manager 位置。例如：us-central1。
AUDIT_SCHEDULE_ID：审核时间表的 ID。例如：my-schedule-id。如需查找现有时间表的 ID，请参阅 Google Cloud 控制台中的审核管理页面。
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 端点的位置。如需查看可用端点的列表，请参阅 Audit Manager 位置。例如：us-central1。
AUDIT_SCHEDULE_ID：审核时间表的 ID。例如：my-schedule-id。如需查找现有时间表的 ID，请参阅 Google Cloud 控制台中的审核管理页面。
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

注意：以下命令假定您已使用您的用户账号通过运行 gcloud init 或 gcloud auth login 登录 gcloud CLI。您可以运行 gcloud auth list 来检查当前活跃的账号。

将请求正文保存在名为 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"
}

安排或运行审核 使用集合让一切井井有条 根据您的偏好保存内容并对其进行分类。

准备工作

安排和运行审核

控制台

gcloud

可选：生成审核评估

Linux、macOS 或 Cloud Shell

Windows (PowerShell)

Windows (cmd.exe)

运行按需审核

Linux、macOS 或 Cloud Shell

Windows (PowerShell)

Windows (cmd.exe)

安排审核

Linux、macOS 或 Cloud Shell

Windows (PowerShell)

Windows (cmd.exe)

REST

可选：生成审核评估

curl

PowerShell

运行按需审核

curl

PowerShell

安排审核

curl

PowerShell

查看预定审核

控制台

gcloud

查看预定审核列表

Linux、macOS 或 Cloud Shell

Windows (PowerShell)

Windows (cmd.exe)

查看有关预定审核的详细信息

Linux、macOS 或 Cloud Shell

Windows (PowerShell)

Windows (cmd.exe)

REST

查看预定审核列表

curl

PowerShell

查看有关预定审核的详细信息

curl

PowerShell

更新预定审核

控制台

gcloud

Linux、macOS 或 Cloud Shell

Windows (PowerShell)

Windows (cmd.exe)

REST

curl

PowerShell

后续步骤

安排或运行审核