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

このページでは、Audit Manager または Compliance Manager を使用して開始した進行中の監査のステータスを取得する方法について説明します。監査は長時間実行オペレーションであり、オペレーションの実行中に監査のステータスを取得すると役立ちます。

始める前に

  • 次のいずれかの IAM ロールがあることを確認します。

  • ステータスを取得する監査を特定します。

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

コンソール

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

    [監査を表示] に移動

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

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

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 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 メソッドと 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 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"
  }
}

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

次のステップ