監査のステータスを取得する

Audit Manager または Compliance Manager を使用して開始した進行中の監査のステータスを取得できます。監査の完了には時間がかかることがあるため、このステータスを追跡することで、監査の進行状況を把握できます。

始める前に

進行中の監査のステータスを取得する

コンソール

  1. Google Cloud コンソールで、[監査を表示] ページに移動します。

    [監査を表示] に移動

  2. [評価を表示] ページでは、進行中の監査の現在のステータスを確認したり、完了した監査の詳細を確認したりできます。

  3. 監査の詳細を表示するには、[ステータス] 列のリンクをクリックします。

  4. （プレビュー）省略可: 新しいコンソール エクスペリエンスを使用して監査のステータスを表示するには、次の操作を行います。

    1. [新しいエクスペリエンスに切り替える] をクリックします。

    2. 監査の詳細を表示するには、監査の名前をクリックします。

gcloud

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 監査マネージャーはコンプライアンス評価が完了しました。
OPERATION_STATE_EVIDENCE_REPORT_GENERATION_IN_PROGRESS 監査マネージャーが、評価されたデータから監査レポートを作成しています。
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 エンドポイントのロケーション。使用可能なエンドポイントの一覧については、監査マネージャーのロケーションをご覧ください。例: us-central1。
  • AUDIT_OPERATION_ID: 監査の実行時にレスポンス本文に含まれていた、進行中のオペレーションの一意の ID。例: 098234

HTTP メソッドと URL:

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 監査マネージャーはコンプライアンス評価が完了しました。
OPERATION_STATE_EVIDENCE_REPORT_GENERATION_IN_PROGRESS 監査マネージャーが、評価されたデータから監査レポートを作成しています。
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"
  }
}

監査レポートが完了してアップロードされると、レポートへのリンクが返されます。

次のステップ