監査のスケジュール設定または実行

監査では、サポートされているフレームワークに照らしてGoogle Cloud 組織を評価するために必要な証拠を収集できます。監査を定期的に実行するようにスケジュール設定することも、オンデマンドで監査を実行することもできます。

監査は長時間実行オペレーションであり、数時間かかることがあります。所要時間は、監査スコープ(以前に登録した組織、プロジェクト、フォルダ)内のリソースの数によって異なります。

特定のフレームワークとリソースの組み合わせのスケジュールを作成できるのは、その組み合わせのアクティブなスケジュールまたは一時停止されたスケジュールがまだ存在しない場合のみです。

始める前に

監査のスケジュールを設定して実行する

監査を定期的に実行するスケジュールを作成することも、オンデマンド監査を実行することもできます。

コンソール

  1. Google Cloud コンソールで、Audit Manager の [評価を実行] ページに移動します。

    [監査マネージャー] に移動

  2. [リソースとリージョンを選択] セクションで、次の操作を行います。

    1. 監査する組織、フォルダ、またはプロジェクトを選択します。

    2. 監査評価を処理するロケーションを選択します。サポートされているロケーションの一覧については、Audit Manager のロケーションをご覧ください。

    3. [次へ] をクリックします。

  3. [規制を選択] セクションで、リソースの監査に使用するフレームワークを選択し、[次へ] をクリックします。サポートされているフレームワークについては、サポートされているフレームワークをご覧ください。

  4. 省略可: [パラメータの構成] セクションが表示されたら、次の操作を行います。

    1. [構成を変更] をクリックします。

    2. [パラメータを構成する] ウィンドウで、クラウド コントロールに必要なパラメータを追加します。パラメータの詳細については、Compliance Manager クラウド コントロール リファレンスと Assured Workloads クラウド コントロールをご覧ください。

    3. [保存] をクリックします。

  5. 省略可: [評価プランを表示] セクションで、選択したフレームワークに基づく監査範囲に関する情報を含む ODS ファイルをダウンロードできます。ファイルをダウンロードするには、リンクをクリックして [次へ] をクリックします。

  6. [ストレージ バケットを選択] セクションで、監査レポートと証拠を保存するストレージ バケットを選択し、[完了] をクリックします。バケットが一覧に表示されない場合は、管理者に、ストレージ バケットにリソースを登録するよう依頼してください。

  7. 省略可: [スケジュール] セクションで、次のいずれかを設定します。

    • 監査を繰り返す頻度(毎日、毎週、毎月、四半期ごと、毎年)。

    • 監査に含める期間。[終了しない] を選択すると、指定した開始日から手動で停止するまで監査が継続されます。

  8. 監査を開始するには、[監査を実行] または [スケジュール設定された監査を実行] をクリックします。

    オンデマンド監査のステータスは、[評価を表示] ページで確認できます。また、スケジュールされた監査は、[監査管理] ページの [スケジュール] タブで確認できます。

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 メソッドと URL:

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

レスポンスには次の情報が含まれます。

  • 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 メソッドと URL:

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: 監査評価オペレーション リクエストの一意の文字列識別子。この ID を使用して、監査評価の進捗状況を追跡します。例: 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 メソッドと URL:

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

リクエスト本文を 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"
}

スケジュールされた監査を表示する

スコープ、フレームワーク、スケジュール構成など、スケジュール設定された監査の詳細を表示できます。

コンソール

  1. Google Cloud コンソールで、Audit Manager の [監査管理] ページに移動します。

    [監査マネージャー] に移動

  2. [スケジュール] タブで、スケジュールされた監査のリストを表示します。

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 メソッドと URL:

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

次のコマンドを実行します。

$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 メソッドと URL:

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

次のコマンドを実行します。

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

スケジュールされた監査を更新する

繰り返しの監査を一時停止、再開、停止できます。スケジュールを変更するには、既存のスケジュール設定された監査を削除してから、新しいスケジュール設定された監査を作成する必要があります。

コンソール

  1. Google Cloud コンソールで、Audit Manager の [監査管理] ページに移動します。

    [監査マネージャー] に移動

  2. [スケジュール] タブで、更新するスケジュール設定された監査を見つけます。

  3. 次のいずれかを行います。

    • 監査スケジュールを一時停止するには、 [スケジュールを一時停止] をクリックします。

    • 一時停止した監査を再開するには、 [スケジュールを再開] をクリックします。

    • スケジュール設定された監査を削除するには、 [スケジュールを停止] をクリックします。

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 メソッドと URL:

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

次のステップ