Google Cloud コンピューティング

統合バージョン: 4.0

ユースケース

Compute Engine でオンデマンド VM を管理します。

プロダクトの権限

サービス アカウントを作成する

  1. Google Cloud ポータルを開き、左側のペインで [IAM と管理] > [ロール] をクリックします。
  2. [ロールを作成] をクリックして、統合に必要な権限を持つカスタムロールを作成します。
  3. 開いたページで、ロールのタイトル、説明、ID、一般提供までのロールのリリース ステージを指定します。

  4. 作成したロールに次の権限を付与します。

    • compute.instances.list
    • compute.instances.start
    • compute.instances.stop
    • compute.instances.delete
    • compute.instances.setLabels
    • compute.instances.getIamPolicy
    • compute.instances.setIamPolicy
    • compute.instances.get
    • compute.zones.list

  5. [作成] をクリックして、新しいカスタムロールを作成します。

  6. 次に、Google のドキュメントに移動し、サービス アカウントの作成のセクションの手順に従います。サービス アカウントを作成すると、サービス アカウントの秘密鍵ファイルがダウンロードされます。

  7. 以前に作成したロールをサービス アカウントに付与して、サービス アカウントが統合に必要な権限を持つようにします。

  8. 手順 1 でダウンロードしたファイルの JSON 内容と Compute Engine の統合を構成します。

Chronicle SOAR で Google Cloud コンピューティングの統合を構成する

Chronicle SOAR で統合を構成する方法の詳細については、統合を構成するをご覧ください。

統合のパラメータ

次のパラメータを使用して統合を構成します。

パラメータの表示名 種類 デフォルト値 必須 説明
アカウントの種類 文字列 service_account いいえ Google Cloud アカウントの種類。認証 JSON ファイルの「type」パラメータにあります。値をコピーして、この統合構成パラメータに配置する必要があります。
プロジェクト ID 文字列 なし いいえ Google Cloud アカウントのプロジェクト ID。認証 JSON ファイルの「project_id」パラメータにあります。値をコピーして、この統合構成パラメータに配置する必要があります。
秘密鍵 ID パスワード なし いいえ Google Cloud アカウントの秘密鍵 ID。認証 JSON ファイルの「private_key_id」パラメータにあります。値をコピーして、この統合構成パラメータに配置する必要があります。
秘密鍵 パスワード なし いいえ Google Cloud アカウントの秘密鍵。認証 JSON ファイルの「private_key」パラメータにあります。値をコピーして、この統合構成パラメータに配置する必要があります。
クライアントのメール。 文字列 なし いいえ Google Cloud アカウントのクライアント メール。認証 JSON ファイルの「client_email」パラメータにあります。値をコピーして、この統合構成パラメータに配置する必要があります。
クライアント ID 文字列 なし いいえ Google Cloud アカウントのクライアント ID。認証 JSON ファイルの「client_id」パラメータにあります。値をコピーして、この統合構成パラメータに配置する必要があります。
認証 URI いいえ https://accounts.google.com/o/oauth2/auth いいえ Google Cloud アカウントの認証 URI。認証 JSON ファイルの「auth_uri」パラメータにあります。値をコピーして、この統合構成パラメータに配置する必要があります。
トークン URI 文字列 https://oauth2.googleapis.com/token いいえ Google Cloud アカウントのトークン URI。認証 JSON ファイルの「token_uri」パラメータにあります。値をコピーして、この統合構成パラメータに配置する必要があります。
認証プロバイダ X509 URL いいえ https://www.googleapis.com/oauth2/v1/certs いいえ Google Cloud アカウントの 認証プロバイダ X509 URL。認証 JSON ファイルの「auth_provider_x509_cert_url」パラメータにあります。値をコピーして、この統合構成パラメータに配置する必要があります。
クライアント X509 URL 文字列 なし いいえ Google Cloud アカウントのクライアント X509 URL。認証 JSON ファイルの「client_x509_cert_url」パラメータにあります。値をコピーして、この統合構成パラメータに配置する必要があります。
サービス アカウント JSON ファイルの内容 文字列 なし いいえ 省略可: 秘密鍵 ID、秘密鍵、その他のパラメータを指定する代わりに、サービス アカウント ファイルの完全な JSON コンテンツをここで指定します。このパラメータを指定すると、他の接続パラメータは無視されます。
SSL を確認 チェックボックス オン いいえ 有効になっている場合は、統合で、Google Cloud サービスへの接続用の SSL 証明書が有効かどうかが確認されます。

アクション

Ping

説明

[Chronicle Marketplace] タブの統合構成ページで指定されるパラメータを使用して、Compute Engine サービスへの接続をテストします。

実行

このアクションはエンティティに対して実行されません。

アクションの結果

スクリプトの結果
スクリプトの結果名 値のオプション
is_success is_success=False
is_success is_success=True
ケースウォール
結果のタイプ 値 / 説明 種類
出力メッセージ *

アクションが失敗したり、ハンドブックの実行を停止したりすることはありません。

  • 成功した場合:「指定された接続パラメータで Compute Engine サービスに正常に接続しました。」

アクションが失敗し、ハンドブックの実行を停止します: 認証情報の誤りや接続の切断などの重大なエラーの場合:「Compute Engine サービスに接続できませんでした。エラー: {0}」.format(exception.stacktrace)

 一般

インスタンスの一覧表示

説明

指定した検索条件に基づいて Compute Engine インスタンスを一覧表示します。Chronicle SOAR エンティティではアクションが機能しません。

パラメータ

パラメータの表示名 種類 デフォルト値 必須 説明
インスタンス ゾーン 文字列 なし ○ インスタンスを検索するインスタンス ゾーン名を指定します。
インスタンス名 CSV なし いいえ 検索するインスタンス名を指定します。パラメータには複数の値をカンマ区切りの文字列として指定できます。
インスタンスのステータス CSV なし いいえ 検索するインスタンスのステータスを指定します。パラメータには複数の値をカンマ区切りの文字列として指定できます。
インスタンス ラベル CSV なし いいえ 検索するインスタンス ラベルを label_key_name:label_value の形式で指定します（例: vm_label_key:label1）。パラメータには複数の値をカンマ区切りの文字列として指定できます。
返される最大行数 整数 50 いいえ 返されるインスタンス アクションの数を指定します。

実行

このアクションはエンティティに対して実行されません。

アクションの結果

スクリプトの結果
スクリプトの結果名 値のオプション
is_success is_success=False
is_success is_success=True
JSON の結果
{ "id": "projects/silver-shift-275007/zones/us-central1-a/instances",
   "items": [
       {
           "id": "5150223389518432640",
           "creationTimestamp": "2021-04-28T21:34:57.369-07:00",
           "name": "instance-1",
           "description": "",
           "tags": {
               "fingerprint": "42WmSpB8rSM="
           },
           "machineType": "https://www.googleapis.com/compute/v1/projects/silver-shift-275007/zones/us-central1-a/machineTypes/f1-micro",
           "status": "RUNNING",
           "zone": "https://www.googleapis.com/compute/v1/projects/silver-shift-275007/zones/us-central1-a",
           "canIpForward": false,
           "networkInterfaces": [
               {
                   "network": "https://www.googleapis.com/compute/v1/projects/silver-shift-275007/global/networks/default",
                   "subnetwork": "https://www.googleapis.com/compute/v1/projects/silver-shift-275007/regions/us-central1/subnetworks/default",
                   "networkIP": "10.128.0.2",
                   "name": "nic0",
                   "accessConfigs": [
                       {
                           "type": "ONE_TO_ONE_NAT",
                           "name": "External NAT",
                           "natIP": "34.66.156.59",
                           "networkTier": "PREMIUM",
                           "kind": "compute#accessConfig"
                       }
                   ],
                   "fingerprint": "xXUN4Zp4Dgs=",
                   "kind": "compute#networkInterface"
               }
           ],
           "disks": [
               {
                   "type": "PERSISTENT",
                   "mode": "READ_WRITE",
                   "source": "https://www.googleapis.com/compute/v1/projects/silver-shift-275007/zones/us-central1-a/disks/instance-1",
                   "deviceName": "instance-1",
                   "index": 0,
                   "boot": true,
                   "autoDelete": true,
                   "licenses": [
                       "https://www.googleapis.com/compute/v1/projects/debian-cloud/global/licenses/debian-10-buster"
                   ],
                   "interface": "SCSI",
                   "guestOsFeatures": [
                       {
                           "type": "UEFI_COMPATIBLE"
                       },
                       {
                           "type": "VIRTIO_SCSI_MULTIQUEUE"
                       }
                   ],
                   "diskSizeGb": "10",
                   "kind": "compute#attachedDisk"
               }
           ],
           "metadata": {
               "fingerprint": "qkn_HJrWq3Y=",
               "kind": "compute#metadata"
           },
           "serviceAccounts": [
               {
                   "email": "881112408707-compute@developer.gserviceaccount.com",
                   "scopes": [
                       "https://www.googleapis.com/auth/devstorage.read_only",
                       "https://www.googleapis.com/auth/logging.write",
                       "https://www.googleapis.com/auth/monitoring.write",
                       "https://www.googleapis.com/auth/servicecontrol",
                       "https://www.googleapis.com/auth/service.management.readonly",
                       "https://www.googleapis.com/auth/trace.append"
                   ]
               }
           ],
           "selfLink": "https://www.googleapis.com/compute/v1/projects/silver-shift-275007/zones/us-central1-a/instances/instance-1",
           "scheduling": {
               "onHostMaintenance": "MIGRATE",
               "automaticRestart": true,
               "preemptible": false
           },
           "cpuPlatform": "Intel Haswell",
           "labels": {
               "vm_test_tag": "tag1"
           },
           "labelFingerprint": "barkrAmUbk0=",
           "startRestricted": false,
           "deletionProtection": false,
           "reservationAffinity": {
               "consumeReservationType": "ANY_RESERVATION"
           },
           "displayDevice": {
               "enableDisplay": false
           },
           "shieldedInstanceConfig": {
               "enableSecureBoot": false,
               "enableVtpm": true,
               "enableIntegrityMonitoring": true
           },
           "shieldedInstanceIntegrityPolicy": {
               "updateAutoLearnPolicy": true
           },
           "confidentialInstanceConfig": {
               "enableConfidentialCompute": false
           },
           "fingerprint": "9e4oFnAOVio=",
           "lastStartTimestamp": "2021-04-28T21:35:07.865-07:00",
           "kind": "compute#instance"
       }
   ]
}
ケースウォール
結果のタイプ 値 / 説明 種類
出力メッセージ *

アクションが失敗したり、ハンドブックの実行が停止したりすることはありません。

  • インスタンスが正常に一覧表示された場合（is_success = true）:「Compute Engine インスタンスが正常に取得されました。」

  • 指定されたゾーンが無効（is_success =false）の場合「指定されたインスタンス ゾーン <zone_id> が無効です。」

  • 使用可能な値がない場合（is_success = false）:「Compute Engine にインスタンスが見つかりませんでした」

    • アクションが失敗し、ハンドブックの実行が停止します。

    間違った認証情報、サーバーへの接続なし、その他など、致命的なエラー、SDK エラーの場合::「アクション「インスタンスの一覧表示」の実行エラー。理由: {0}」.format(error.Stacktrace)

    		 一般
    Table

    テーブル名: Compute Engine インスタンス

    テーブル列:

    インスタンス名

    インスタンス ID

    インスタンス作成時刻

    インスタンスの説明

    インスタンス タイプ

    インスタンスのステータス

    インスタンス ラベル

    		 一般

    インスタンスの開始

    説明

    以前に停止した Compute Engine インスタンスを開始します。インスタンスが実行中のステータスになるまで数分かかることがあります。

    パラメータ

    パラメータの表示名 種類 デフォルト値 必須 説明
    インスタンス ゾーン 文字列 なし ○ インスタンスを検索するインスタンス ゾーン名を指定します。
    インスタンス ID 文字列 なし ○ 開始するインスタンス ID を指定します。インスタンス ID は「インスタンスの一覧表示」アクションで確認できます。

    実行

    このアクションはエンティティに対して実行されません。

    アクションの結果

    スクリプトの結果
    スクリプトの結果名 値のオプション
    is_success is_success=False
    is_success is_success=True
    JSON の結果
    {
   "id": "440218233881490774",
   "name": "operation-1619676088845-5c11639ed45b4-4516e708-330d214a",
   "zone": "https://www.googleapis.com/compute/v1/projects/silver-shift-275007/zones/us-central1-a",
   "operationType": "start",
   "targetLink": "https://www.googleapis.com/compute/v1/projects/silver-shift-275007/zones/us-central1-a/instances/5150223389518432640",
   "targetId": "5150223389518432640",
   "status": "DONE",
   "user": "dana@example.com",
   "progress": 100,
   "insertTime": "2021-04-28T23:01:29.395-07:00",
   "startTime": "2021-04-28T23:01:29.397-07:00",
   "endTime": "2021-04-28T23:01:29.397-07:00",
   "selfLink": "https://www.googleapis.com/compute/v1/projects/silver-shift-275007/zones/us-central1-a/operations/operation-1619676088845-5c11639ed45b4-4516e708-330d214a",
   "kind": "compute#operation"
}
    ケースウォール
    結果のタイプ 値 / 説明 種類
    出力メッセージ *

    アクションが失敗したり、ハンドブックの実行が停止したりすることはありません。

    • アクションが正常に実行された場合:(is_success=true)

      「Compute Engine インスタンス <instance id> が正常に開始されました。」

    • 指定されたゾーンが有効でない場合（is_success =false）

      「指定されたインスタンス ゾーン <zone_id> が無効です。」

    • 指定されたインスタンス ID が有効でない場合（is_success =false）

      「指定されたインスタンス ID <instance_id> が無効です。」

    アクションが失敗し、ハンドブックの実行を停止します。

    間違った認証情報、サーバーへの接続なし、その他など、致命的なエラー、SDK エラーの場合::「アクション「インスタンスの開始」の実行エラー。理由: {0}」.format(error.Stacktrace)

    		 一般

    インスタンスの停止

    説明

    実行中のインスタンスを停止して、完全にシャットダウンし、後でインスタンスを再起動できるようにします。停止したインスタンスは、停止中に VM の使用料金が発生しません。ただし、永続ディスクや静的 IP アドレスなど、VM が使用しているリソースは、削除されるまで課金され続けます。

    パラメータ

    パラメータの表示名 種類 デフォルト値 必須 説明
    インスタンス ゾーン 文字列 なし ○ インスタンスを検索するインスタンス ゾーン名を指定します。
    インスタンス ID 文字列 なし ○ 停止するインスタンス ID を指定します。インスタンス ID は「インスタンスの一覧表示」アクションで確認できます。

    実行

    このアクションはエンティティに対して実行されません。

    アクションの結果

    スクリプトの結果
    スクリプトの結果名 値のオプション
    is_success is_success=False
    is_success is_success=True
    JSON の結果
     {
   "id": "6634560676812026585",
   "name": "operation-1619676214361-5c11641687bca-60e48370-0f66e056",
   "zone": "https://www.googleapis.com/compute/v1/projects/silver-shift-275007/zones/us-central1-a",
   "operationType": "stop",
   "targetLink": "https://www.googleapis.com/compute/v1/projects/silver-shift-275007/zones/us-central1-a/instances/2702854851349968946",
   "targetId": "2702854851349968946",
   "status": "RUNNING",
   "user": "dana@example.com",
   "progress": 0,
   "insertTime": "2021-04-28T23:03:34.736-07:00",
   "startTime": "2021-04-28T23:03:34.776-07:00",
   "selfLink": "https://www.googleapis.com/compute/v1/projects/silver-shift-275007/zones/us-central1-a/operations/operation-1619676214361-5c11641687bca-60e48370-0f66e056",
   "kind": "compute#operation"
}
    ケースウォール
    結果のタイプ 値 / 説明 種類
    出力メッセージ *

    アクションが失敗したり、ハンドブックの実行が停止したりすることはありません。

    • アクションが正常に実行された場合:（is_success=true）「Compute Engine インスタンス <instance id> が正常に停止しました。」
    • 指定されたゾーンが無効（is_success =false）の場合「指定されたインスタンス ゾーン <zone_id> が無効です。」
    • 指定されたインスタンス ID が有効でない場合（is_success =false）
    • 「指定されたインスタンス ID <instance_id> が無効です。」

    アクションが失敗し、ハンドブックの実行を停止します。

    間違った認証情報、サーバーへの接続なし、その他など、致命的なエラー、SDK エラーの場合::「アクション「インスタンスの停止」の実行エラー。理由: {0}」.format(error.Stacktrace)

    		 一般

    インスタンスの削除

    説明

    指定した Compute Engine インスタンスを削除します。

    パラメータ

    パラメータの表示名 種類 デフォルト値 必須 説明
    インスタンス ゾーン 文字列 なし ○ インスタンスを検索するインスタンス ゾーン名を指定します。
    インスタンス ID 文字列 なし ○ 削除するインスタンス ID を指定します。インスタンス ID は「インスタンスの一覧表示」アクションで確認できます。

    実行

    このアクションはエンティティに対して実行されません。

    アクションの結果

    スクリプトの結果
    スクリプトの結果名 値のオプション
    is_success is_success=False
    is_success is_success=True
    JSON の結果
    {
   "id": "6229049230731244493",
   "name": "operation-1619676450530-5c1164f7c243b-52ae4f6e-ab78128a",
   "zone": "https://www.googleapis.com/compute/v1/projects/silver-shift-275007/zones/us-central1-a",
   "operationType": "delete",
   "targetLink": "https://www.googleapis.com/compute/v1/projects/silver-shift-275007/zones/us-central1-a/instances/2702854851349968946",
   "targetId": "2702854851349968946",
   "status": "RUNNING",
   "user": "dana@example.com",
   "progress": 0,
   "insertTime": "2021-04-28T23:07:30.902-07:00",
   "startTime": "2021-04-28T23:07:30.943-07:00",
   "selfLink": "https://www.googleapis.com/compute/v1/projects/silver-shift-275007/zones/us-central1-a/operations/operation-1619676450530-5c1164f7c243b-52ae4f6e-ab78128a",
   "kind": "compute#operation"
}
    ケースウォール
    結果のタイプ 値 / 説明 種類
    出力メッセージ *

    アクションが失敗したり、ハンドブックの実行が停止したりすることはありません。

    • アクションが正常に実行された場合:（is_success=true）「Compute Engine インスタンス <instance id> が正常に削除されました。」
    • 指定されたゾーンが無効（is_success =false）の場合「指定されたインスタンス ゾーン <zone_id> が無効です。」
    • 指定されたインスタンス ID が有効でない場合（is_success =false）「指定されたインスタンス ID <instance_id> が無効です。」

    アクションが失敗し、ハンドブックの実行を停止します。

    間違った認証情報、サーバーへの接続なし、その他など、致命的なエラー、SDK エラーの場合::「アクション「インスタンスの削除」の実行エラー。理由: {0}」.format(error.Stacktrace)

    		 一般

    インスタンスへのラベルの追加

    説明

    Compute Engine インスタンスにラベルを追加します。

    パラメータ

    パラメータの表示名 種類 デフォルト値 必須 説明
    インスタンス ゾーン 文字列 なし ○ インスタンスを検索するインスタンス ゾーン名を指定します。
    インスタンス ID 文字列 なし ○ ラベルを追加するインスタンス ID を指定します。インスタンス ID は「インスタンスの一覧表示」アクションで確認できます。
    インスタンス ラベル CSV なし ○ インスタンスに追加するインスタンス ラベルを指定します。ラベルは label_key_name:label_value の形式で指定する必要があります（例: vm_label_key:label1）。パラメータには複数の値をカンマ区切りの文字列として指定できます。

    実行

    このアクションはエンティティに対して実行されません。

    アクションの結果

    スクリプトの結果
    スクリプトの結果名 値のオプション
    is_success is_success=False
    is_success is_success=True
    JSON の結果
    {
   "id": "7839725575198354144",
   "name": "operation-1620284431406-5c1a3ddf814e1-a6b50fe4-ebf65d96",
   "zone": "https://www.googleapis.com/compute/v1/projects/silver-shift-275007/zones/us-central1-a",
   "operationType": "setLabels",
   "targetLink": "https://www.googleapis.com/compute/v1/projects/silver-shift-275007/zones/us-central1-a/instances/5150223389518432640",
   "targetId": "5150223389518432640",
   "status": "RUNNING",
   "user": "dana@example.com",
   "progress": 0,
   "insertTime": "2021-05-06T00:00:31.858-07:00",
   "startTime": "2021-05-06T00:00:31.867-07:00",
   "selfLink": "https://www.googleapis.com/compute/v1/projects/silver-shift-275007/zones/us-central1-a/operations/operation-1620284431406-5c1a3ddf814e1-a6b50fe4-ebf65d96",
   "kind": "compute#operation"
}
    ケースウォール
    結果のタイプ 値 / 説明 種類
    出力メッセージ *

    アクションが失敗したり、ハンドブックの実行が停止したりすることはありません。

    • アクションが正常に実行された場合:（is_success=true）「ラベル <label list> が Compute Engine インスタンス <instance id> に正常に追加されました。」
    • 指定されたゾーンが無効（is_success =false）の場合「指定されたインスタンス ゾーン <zone_id> が無効です。」
    • 指定されたインスタンス ID が有効でない場合（is_success =false）「指定されたインスタンス ID <instance_id> が無効です。」
    • 指定されたラベルがすでに存在する場合（特に同じラベルキーが存在する場合）（is_success =false）「指定されたラベル <failed_label_id> に Compute Engine インスタンス <instance id> のキーがすでに存在するため、ラベルは追加されませんでした。」

    アクションが失敗し、ハンドブックの実行を停止します。

    間違った認証情報、サーバーへの接続なし、その他など、致命的なエラー、SDK エラーの場合::「アクション「ラベルへのインスタンスの追加」の実行エラー。理由: {0}」.format(error.Stacktrace)

    		 一般

    インスタンスの IAM ポリシーの取得

    説明

    リソースのアクセス制御ポリシーを取得します。リソースにポリシーが割り当てられていない場合、ポリシーは空になることがあります。

    パラメータ

    パラメータの表示名 種類 デフォルト値 必須 説明
    インスタンス ゾーン 文字列 なし ○ インスタンスを検索するインスタンス ゾーン名を指定します。
    インスタンス ID 文字列 なし ○ ポリシーを取得するインスタンス ID を指定します。インスタンス ID は「インスタンスの一覧表示」アクションで確認できます。

    実行

    このアクションはエンティティに対して実行されません。

    アクションの結果

    スクリプトの結果
    スクリプトの結果名 値のオプション
    is_success is_success=False
    is_success is_success=True
    JSON の結果
    {
    "version": 1,
    "etag": "BwXBfsc47MI=",
    "bindings": [
        {
            "role": "roles/compute.networkViewer_withcond_2f0c003401ba9aa6235f",
            "members": [
                "user:dana@example.com"
            ]
        }
    ]
}
    ケースウォール
    結果のタイプ 値 / 説明 種類
    出力メッセージ *

    アクションが失敗したり、ハンドブックの実行が停止したりすることはありません。

    • アクションが正常に実行された場合:（is_success=true）「Compute Engine インスタンス <instance id> の IAM ポリシーが正常に取得されました。」
    • 指定されたゾーンが無効（is_success =false）の場合「指定されたインスタンス ゾーン <zone_id> が無効です。」
    • 指定されたインスタンス ID が有効でない場合（is_success =false）「指定されたインスタンス ID <instance_id> が無効です。」

    アクションが失敗し、ハンドブックの実行を停止します。

    間違った認証情報、サーバーへの接続なし、その他など、致命的なエラー、SDK エラーの場合::「アクション「インスタンスの IAM ポリシーの取得」の実行エラー。理由: {0}」.format(error.Stacktrace)

    		 一般

    インスタンスの IAM ポリシーの設定

    説明

    指定したリソースにアクセス制御ポリシーを設定します。実際に提供されたポリシーによって、既存のポリシーが置き換えられます。

    パラメータ

    パラメータの表示名 種類 デフォルト値 必須 説明
    インスタンス ゾーン 文字列 なし ○ インスタンスを検索するインスタンス ゾーン名を指定します。
    インスタンス ID 文字列 なし ○ ポリシーを設定するインスタンス ID を指定します。インスタンス ID は「インスタンスの一覧表示」アクションで確認できます。
    ポリシー 文字列 なし ○ インスタンスに対して設定する JSON ポリシー ドキュメントを指定します。

    実行

    このアクションはエンティティに対して実行されません。

    アクションの結果

    スクリプトの結果
    スクリプトの結果名 値のオプション
    is_success is_success=False
    is_success is_success=True
    JSON の結果
    {
    "version": 1,
    "etag": "BwXBftu99FE=",
    "bindings": [
        {
            "role": "roles/compute.networkViewer",
            "members": [
                "user:dana@example.com"
            ]
        }
    ]
}
    ケースウォール
    結果のタイプ 値 / 説明 種類
    出力メッセージ *

    アクションが失敗したり、ハンドブックの実行が停止したりすることはありません。

    • アクションが正常に実行された場合:（is_success=true）「Compute Engine インスタンス <instance id> に新しい IAM ポリシーが正常に設定されました。」
    • 指定されたゾーンが無効（is_success =false）の場合「指定されたインスタンス ゾーン <zone_id> が無効です。」
    • 指定されたインスタンス ID が有効でない場合（is_success =false）「指定されたインスタンス ID <instance_id> が無効です。」
    • 指定されたポリシー JSON が有効でない場合（is_success =false）「指定されたポリシー JSON ドキュメント <policy> が無効です。」

    アクションが失敗し、ハンドブックの実行を停止します。

    間違った認証情報、サーバーへの接続なし、その他など、致命的なエラー、SDK エラーの場合::「アクション「インスタンスの IAM ポリシーの設定」の実行エラー。理由: {0}」.format(error.Stacktrace)

    		 一般

    エンティティの拡充

    説明

    Google Cloud Compute のインスタンス情報を使用して Chronicle SOAR IP エンティティを拡充します。

    パラメータ

    パラメータの表示名 種類 デフォルト値 必須 説明
    インスタンス ゾーン 文字列 なし ○ インスタンスを検索するインスタンス ゾーン名を指定します。

    実行

    このアクションは IP アドレス エンティティに対して実行されます。

    アクションの結果

    スクリプトの結果
    スクリプトの結果名 値のオプション
    is_success is_success=False
    is_success is_success=True
    JSON の結果
    {
    "id": "5150223389518432640",
    "creationTimestamp": "2021-04-28T21:34:57.369-07:00",
    "name": "instance-1",
    "description": "",
    "tags": {
        "fingerprint": "42WmSpB8rSM="
    },
    "machineType": "https://www.googleapis.com/compute/v1/projects/silver-shift-275007/zones/us-central1-a/machineTypes/f1-micro",
    "status": "RUNNING",
    "zone": "https://www.googleapis.com/compute/v1/projects/silver-shift-275007/zones/us-central1-a",
    "canIpForward": false,
    "networkInterfaces": [
        {
            "network": "https://www.googleapis.com/compute/v1/projects/silver-shift-275007/global/networks/default",
            "subnetwork": "https://www.googleapis.com/compute/v1/projects/silver-shift-275007/regions/us-central1/subnetworks/default",
            "networkIP": "10.128.0.2",
            "name": "nic0",
            "accessConfigs": [
                {
                    "type": "ONE_TO_ONE_NAT",
                    "name": "External NAT",
                    "natIP": "34.66.156.59",
                    "networkTier": "PREMIUM",
                    "kind": "compute#accessConfig"
                }
            ],
            "fingerprint": "xXUN4Zp4Dgs=",
            "kind": "compute#networkInterface"
        }
    ],
    "disks": [
        {
            "type": "PERSISTENT",
            "mode": "READ_WRITE",
            "source": "https://www.googleapis.com/compute/v1/projects/silver-shift-275007/zones/us-central1-a/disks/instance-1",
            "deviceName": "instance-1",
            "index": 0,
            "boot": true,
            "autoDelete": true,
            "licenses": [
                "https://www.googleapis.com/compute/v1/projects/debian-cloud/global/licenses/debian-10-buster"
            ],
            "interface": "SCSI",
            "guestOsFeatures": [
                {
                    "type": "UEFI_COMPATIBLE"
                },
                {
                    "type": "VIRTIO_SCSI_MULTIQUEUE"
                }
            ],
            "diskSizeGb": "10",
            "kind": "compute#attachedDisk"
        }
    ],
    "metadata": {
        "fingerprint": "qkn_HJrWq3Y=",
        "kind": "compute#metadata"
    },
    "serviceAccounts": [
        {
            "email": "881112408707-compute@developer.gserviceaccount.com",
            "scopes": [
                "https://www.googleapis.com/auth/devstorage.read_only",
                "https://www.googleapis.com/auth/logging.write",
                "https://www.googleapis.com/auth/monitoring.write",
                "https://www.googleapis.com/auth/servicecontrol",
                "https://www.googleapis.com/auth/service.management.readonly",
                "https://www.googleapis.com/auth/trace.append"
            ]
        }
    ],
    "selfLink": "https://www.googleapis.com/compute/v1/projects/silver-shift-275007/zones/us-central1-a/instances/instance-1",
    "scheduling": {
        "onHostMaintenance": "MIGRATE",
        "automaticRestart": true,
        "preemptible": false
    },
    "cpuPlatform": "Intel Haswell",
    "labels": {
        "vm_test_tag": "tag1"
    },
    "labelFingerprint": "barkrAmUbk0=",
    "startRestricted": false,
    "deletionProtection": false,
    "reservationAffinity": {
        "consumeReservationType": "ANY_RESERVATION"
    },
    "displayDevice": {
        "enableDisplay": false
    },
    "shieldedInstanceConfig": {
        "enableSecureBoot": false,
        "enableVtpm": true,
        "enableIntegrityMonitoring": true
    },
    "shieldedInstanceIntegrityPolicy": {
        "updateAutoLearnPolicy": true
    },
    "confidentialInstanceConfig": {
        "enableConfidentialCompute": false
    },
    "fingerprint": "9e4oFnAOVio=",
    "lastStartTimestamp": "2021-04-28T21:35:07.865-07:00",
    "kind": "compute#instance"
}
    エンティティ拡充
    拡充フィールド名 ロジック - 適用対象
    Google_Compute_instance_id
    Google_Compute_creation_timestamp
    Google_Compute_instance_name
    Google_Compute_description
    Google_Compute_tags タグの CSV リスト
    Google_Compute_machine_type
    Google_Compute_instance_status
    Google_Compute_instance_zone
    Google_Compute_can_ip_forward

    Google_Compute_instance_network_
    interfaces_name_<index>

    		 利用可能なネットワーク インターフェースがさらにある場合は、さらに追加する必要があります

    Google_Compute_instance_network_interfaces_
    name_access_configs_type_<index>

    		 利用可能なネットワーク インターフェースがさらにある場合は、さらに追加する必要があります

    Google_Compute_instance_network_interfaces_
    name_access_configs_name_<index>

    		 利用可能なネットワーク インターフェースがさらにある場合は、さらに追加する必要があります

    Google_Compute_instance_network_interfaces_
    name_access_configs_natIP_<index>

    		 利用可能なネットワーク インターフェースがさらにある場合は、さらに追加する必要があります
    Google_Compute_instance_metadata インスタンス メタデータの値の CSV リスト
    Google_Compute_service_account_ 利用可能なサービス アカウントがさらにある場合は、さらに追加する必要があります
    Google_Compute_service_account_scopes_ 利用可能なサービス アカウントがさらにある場合は、さらに追加する必要があります
    Google_Compute_link_to_Google_Compute
    Google_Compute_labels 値の CSV リスト
    Google_Compute_instance_last_start_timestamp
    Google_Compute_instance_last_stop_timestamp
    ケースウォール
    結果のタイプ 値 / 説明 種類
    出力メッセージ *

    アクションが失敗したり、ハンドブックの実行が停止したりすることはありません。

    • 成功し、指定されたエンティティの少なくとも 1 つが拡充された場合:「エンティティが正常に拡充されました: {0}」.format([entity.Identifier])。
    • 指定されたエンティティをすべて拡充できない場合:「拡充されたエンティティはありません」
    • Compute Engine で特定のエンティティを拡充するデータが見つからない場合:「アクションは、指定されたエンティティを拡充するために一致する Compute Engine を見つけることができませんでした: {0}」.format([entity.identifier])
    • 指定されたゾーンが無効（is_success =false）の場合「指定されたインスタンス ゾーン <zone_id> が無効です。」

    アクションが失敗し、ハンドブックの実行を停止します。

    間違った認証情報、サーバーへの接続なし、その他など、致命的なエラー、SDK エラーの場合::「アクション「エンティティの拡充」の実行エラー。理由: {0}」.format(error.Stacktrace)

    		 一般
    テーブル（拡充）

    アクションでエンティティ拡充を行う場合。
    テーブル名: {entity} 拡充テーブル

    列:

    • エンティティ フィールド
    • 値
    		 エンティティ