获取审核的状态

本页面介绍了如何获取使用 Audit Manager 或 Compliance Manager 启动的正在进行的审核的状态。审核是长时间运行的操作，在操作运行时获取审核的状态可能会很有帮助。

准备工作

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

  • 确定要获取其状态的审核。

获取正在进行的审核的状态

控制台

  1. 在 Google Cloud 控制台中，前往 查看审核 页面。

    前往“查看审核”页面

  2. 在查看评估 页面上，您可以查看正在进行的审核的当前状态，或获取有关已完成审核的更多信息。

  3. 如需查看有关审核的更多信息，请点击状态 列中的链接。

gcloud

The gcloud audit-manager operations describe 命令用于描述审核操作。

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

  • RESOURCE_TYPE：资源类型，可以是项目或文件夹。例如：folders 或 projects。
  • RESOURCE_ID：项目或文件夹的资源 ID。例如：8767234。
  • LOCATION：Audit Manager API 端点的位置。如需查看 可用端点的列表，请参阅Audit Manager 位置。例如：us-central1。
  • AUDIT_OPERATION_ID：运行审核时包含在响应正文中的正在进行的操作的唯一 ID。例如：098234。

执行以下命令：

Linux、macOS 或 Cloud Shell

gcloud audit-manager operations describe AUDIT_OPERATION_ID \
    --RESOURCE_TYPE=RESOURCE_ID \
    --location=LOCATION

Windows (PowerShell)

gcloud audit-manager operations describe AUDIT_OPERATION_ID `
    --RESOURCE_TYPE=RESOURCE_ID `
    --location=LOCATION

Windows (cmd.exe)

gcloud audit-manager operations describe AUDIT_OPERATION_ID ^
    --RESOURCE_TYPE=RESOURCE_ID ^
    --location=LOCATION

成功的响应包含以下执行状态类型之一：

状态类型 说明
OPERATION_STATE_UNSPECIFIED 无效状态。
OPERATION_STATE_NOT_STARTED 审核报告生成流程尚未开始。
OPERATION_STATE_EVALUATION_IN_PROGRESS Audit Manager 正在根据合规性控制措施评估资源。
OPERATION_STATE_EVALUATION_DONE Audit Manager 已完成合规性评估。
OPERATION_STATE_EVIDENCE_REPORT_GENERATION_IN_PROGRESS Audit Manager 正在根据评估的数据创建审核报告。
OPERATION_STATE_EVIDENCE_REPORT_GENERATION_DONE Audit Manager 已完成审核报告的生成。
OPERATION_STATE_EVIDENCE_UPLOAD_IN_PROGRESS Audit Manager 正在将审核报告和证据上传到目标位置。
OPERATION_STATE_DONE 审核报告生成流程已完成。
OPERATION_STATE_FAILED 审核报告生成流程失败。

每种执行状态类型都可能会提供以下任何附加信息（如果适用）：

附加状态 说明
failure_reason 如果审核评估失败，此字段会提供失败原因。
evaluation_percent_complete 如果评估已开始，此字段会提供进度百分比。如果流程尚未开始，此字段将从 0 开始。如果流程已结束，此字段将设置为 100。
report_generation_percent_complete 如果报告生成已开始，此字段会提供进度百分比。如果流程尚未开始，此字段将从 0 开始。如果流程已结束，此字段将设置为 100。
report_uploading_percent_complete 如果报告上传已开始，此字段会提供进度百分比。如果流程尚未开始，此字段将从 0 开始。如果流程已结束，此字段将设置为 100。

成功的 gcloud 响应类似于以下内容：

done: true
name: projects/PROJECT_ID/locations/LOCATION/operationDetails/AUDIT_OPERATION_ID
response:
  '@type': type.googleapis.com/google.cloud.auditmanager.v1.AuditReport
  gcsUri: gs://testbucketauditmanager

REST

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

  • RESOURCE_TYPE：资源类型，可以是项目或文件夹。例如：folders 或 projects。
  • RESOURCE_ID：项目或文件夹的资源 ID。例如：8767234。
  • LOCATION：Audit Manager API 端点的位置。如需查看 可用端点的列表，请参阅Audit Manager 位置。例如：us-central1。
  • AUDIT_OPERATION_ID：运行审核时包含在响应正文中的正在进行的操作的唯一 ID。例如：098234。

HTTP 方法和网址： 

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

如需发送请求，请选择以下方式之一：

curl

执行以下命令： 

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://auditmanager.googleapis.com/v1/RESOURCE_TYPE/RESOURCE_ID/locations/LOCATION//operationDetails/AUDIT_OPERATION_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//operationDetails/AUDIT_OPERATION_ID" | Select-Object -Expand Content

成功的响应包含以下执行状态类型之一：

状态类型 说明
OPERATION_STATE_UNSPECIFIED 无效状态。
OPERATION_STATE_NOT_STARTED 审核报告生成流程尚未开始。
OPERATION_STATE_EVALUATION_IN_PROGRESS Audit Manager 正在根据合规性控制措施评估资源。
OPERATION_STATE_EVALUATION_DONE Audit Manager 已完成合规性评估。
OPERATION_STATE_EVIDENCE_REPORT_GENERATION_IN_PROGRESS Audit Manager 正在根据评估的数据创建审核报告。
OPERATION_STATE_EVIDENCE_REPORT_GENERATION_DONE Audit Manager 已完成审核报告的生成。
OPERATION_STATE_EVIDENCE_UPLOAD_IN_PROGRESS Audit Manager 正在将审核报告和证据上传到目标位置。
OPERATION_STATE_DONE 审核报告生成流程已完成。
OPERATION_STATE_FAILED 审核报告生成流程失败。

每种执行状态类型都可能会提供以下任何附加信息（如果适用）：

附加状态 说明
failure_reason 如果审核评估失败，此字段会提供失败原因。
evaluation_percent_complete 如果评估已开始，此字段会提供进度百分比。如果流程尚未开始，此字段将从 0 开始。如果流程已结束，此字段将设置为 100。
report_generation_percent_complete 如果报告生成已开始，此字段会提供进度百分比。如果流程尚未开始，此字段将从 0 开始。如果流程已结束，此字段将设置为 100。
report_uploading_percent_complete 如果报告上传已开始，此字段会提供进度百分比。如果流程尚未开始，此字段将从 0 开始。如果流程已结束，此字段将设置为 100。

成功的 REST 响应类似于以下内容：

{
  "name": "projects/PROJECT_ID/locations/LOCATION/operationDetails/AUDIT_OPERATION_ID",
  "done": true,
  "response": {
    "@type": "type.googleapis.com/google.cloud.auditmanager.v1.AuditReport",
    "gcsUri": "gs://testbucketauditmanager"
  }
}

审核报告完成并上传后，系统会返回指向该报告的链接。

后续步骤