監査では、サポートされているフレームワークに照らしてGoogle Cloud 組織を評価するために必要な証拠を収集できます。監査を定期的に実行するようにスケジュール設定することも、オンデマンドで監査を実行することもできます。
監査は長時間実行オペレーションであり、数時間かかることがあります。所要時間は、監査スコープ(以前に登録した組織、プロジェクト、フォルダ)内のリソースの数によって異なります。
特定のフレームワークとリソースの組み合わせのスケジュールを作成できるのは、その組み合わせのアクティブなスケジュールまたは一時停止されたスケジュールがまだ存在しない場合のみです。
始める前に
監査の実行またはスケジュール設定に必要な権限を取得するには、次のいずれかの Identity and Access Management(IAM)ロールを付与するよう管理者に依頼してください。
- Audit Manager 管理者(
roles/auditmanager.admin) - Audit Manager 監査者(
roles/auditmanager.auditor)
- Audit Manager 管理者(
監査対象の組織、プロジェクト、フォルダを登録します。
監査のスケジュールを設定して実行する
監査を定期的に実行するスケジュールを作成することも、オンデマンド監査を実行することもできます。
コンソール
Google Cloud コンソールで、Audit Manager の [評価を実行] ページに移動します。
[リソースとリージョンを選択] セクションで、次の操作を行います。
監査する組織、フォルダ、またはプロジェクトを選択します。
監査評価を処理するロケーションを選択します。サポートされているロケーションの一覧については、Audit Manager のロケーションをご覧ください。
[次へ] をクリックします。
[規制を選択] セクションで、リソースの監査に使用するフレームワークを選択し、[次へ] をクリックします。サポートされているフレームワークについては、サポートされているフレームワークをご覧ください。
省略可: [パラメータの構成] セクションが表示されたら、次の操作を行います。
[構成を変更] をクリックします。
[パラメータを構成する] ウィンドウで、クラウド コントロールに必要なパラメータを追加します。パラメータの詳細については、Compliance Manager クラウド コントロール リファレンスと Assured Workloads クラウド コントロールをご覧ください。
[保存] をクリックします。
省略可: [評価プランを表示] セクションで、選択したフレームワークに基づく監査範囲に関する情報を含む 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 メソッドと 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"
}
スケジュールされた監査を表示する
スコープ、フレームワーク、スケジュール構成など、スケジュール設定された監査の詳細を表示できます。
コンソール
Google Cloud コンソールで、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 メソッドと 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"
}
スケジュールされた監査を更新する
繰り返しの監査を一時停止、再開、停止できます。スケジュールを変更するには、既存のスケジュール設定された監査を削除してから、新しいスケジュール設定された監査を作成する必要があります。
コンソール
Google Cloud コンソールで、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 メソッドと 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"
}