Mengintegrasikan Compute Engine dengan Google SecOps

Dokumen ini menjelaskan cara mengintegrasikan Compute Engine dengan Google Security Operations.

Kasus penggunaan

Integrasi Compute Engine menggunakan kemampuan Google SecOps untuk mendukung kasus penggunaan berikut:

  • Respons insiden otomatis: Mengisolasi instance Compute Engine yang disusupi dari jaringan secara otomatis. Pembatasan otomatis membatasi penyebaran serangan, mempercepat waktu respons, dan mengurangi beban kerja tim keamanan.

  • Perburuan dan investigasi ancaman: Mengotomatiskan pengumpulan log dan telemetri keamanan dari instance Compute Engine di beberapa project. Menganalisis data gabungan ini memungkinkan perburuan ancaman secara proaktif dan mempercepat investigasi dengan mengotomatiskan pengumpulan data.

  • Manajemen kerentanan: Integrasikan alat pemindaian kerentanan dengan Google SecOps untuk otomatis memindai instance Compute Engine guna menemukan kerentanan yang diketahui. Buat tiket perbaikan atau patch kerentanan secara langsung untuk mengurangi risiko eksploitasi dan meningkatkan postur keamanan.

  • Otomatisasi kepatuhan: Otomatiskan pengumpulan log audit dan data konfigurasi dari instance Compute Engine untuk mematuhi persyaratan peraturan. Membuat laporan dan dasbor bagi auditor untuk menyederhanakan pelaporan kepatuhan dan mengurangi upaya manual.

  • Orkestrasi keamanan: Mengorkestrasi alur kerja keamanan di beberapa layananGoogle Cloud , termasuk Compute Engine. Misalnya, memicu pembuatan aturan firewall baru sebagai respons terhadap peristiwa keamanan yang terdeteksi pada instance, sehingga menghasilkan postur keamanan yang lebih terkoordinasi dan otomatis.

Sebelum memulai

Sebelum mengonfigurasi integrasi Compute Engine di Google SecOps, selesaikan langkah-langkah prasyarat berikut:

  1. Buat dan konfigurasi peran pengelolaan akses dan identitas pelanggan (CIAM) kustom.

  2. Membuat akun layanan:

  3. Pilih dan konfigurasi salah satu metode autentikasi berikut:

    • Opsi 1: Workload Identity (direkomendasikan): Metode ini menggunakan token akses sementara yang berumur pendek menggunakan peniruan akun layanan.

    • Opsi 2: Kunci JSON akun layanan: Metode ini mengandalkan file kunci rahasia statis yang berumur panjang.

Membuat peran IAM khusus

Untuk memberikan integrasi dengan izin khusus yang diperlukan untuk mengelola instance Anda, buat peran khusus:

  1. Di konsol Google Cloud , buka IAM & Admin > Roles.

    Buka Peran

  2. Klik addCreate custom role.

  3. Berikan Title (misalnya, SecOps Compute Engine Integration), Description, dan ID yang unik.

  4. Tetapkan Role Launch Stage ke Ketersediaan Umum.

  5. Klik Add Permissions dan tambahkan hal berikut:

    • 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

  6. Klik Create.

Membuat akun layanan

  1. Di konsol Google Cloud , buka IAM & Admin > Service Accounts.

    Buka Akun Layanan

  2. Klik addCreate Service Account.

  3. Masukkan nama dan deskripsi, lalu klik Create and Continue.

  4. Pada langkah Grant this service account access to project, tetapkan peran khusus yang Anda buat.

  5. Klik Done. Catat Alamat email akun layanan.

Mengonfigurasi kredensial Workload Identity

Workload Identity adalah pendekatan yang direkomendasikan karena menggunakan token akses berumur pendek yang menggunakan peniruan akun layanan.

Mengidentifikasi identitas instance yang unik

Untuk membuat koneksi, Anda harus memberikan izin kepada instance Google SecOps untuk meniru identitas akun layanan Anda.

  1. Di Google SecOps, buka Content Hub > Response Integrations.

  2. Pilih integrasi Compute Engine dan masukkan email akun layanan Anda di Workload Identity Email.

  3. Klik Save > Test. Pengujian diperkirakan akan gagal.

  4. Klik tombol close_small di samping Test dan temukan email identitas yang diawali dengan gke-init-python@... atau soar-python@....

  5. Salin alamat email unik ini.

Mengizinkan identitas instance di Google Cloud

  1. Di konsol Google Cloud , buka IAM & Admin > Service Accounts.

    Buka Akun Layanan

  2. Pilih akun layanan target dan buka Permissions > Grant Access.

  3. Tempelkan alamat email unik ke kolom New principals dan tetapkan peran Service Account Token Creator (roles/iam.serviceAccountTokenCreator).

Mengonfigurasi kunci JSON

File kunci rahasia statis yang berumur panjang memerlukan rotasi manual. Gunakan metode ini hanya jika autentikasi Workload Identity tidak tersedia.

  1. Di konsol Google Cloud , buka IAM & Admin > Service Accounts, lalu pilih akun layanan Anda.

    Buka Akun Layanan

  2. Buka tab Keys dan klik Add key > Create new key.

  3. Pilih JSON dan klik Create. File akan otomatis didownload ke komputer Anda.

Mengonfigurasi parameter individual manual

Jika Anda memilih untuk memasukkan kredensial secara manual, biarkan file kunci JSON yang didownload tetap terbuka di editor teks untuk menyalin setiap nilai yang diperlukan dalam setelan integrasi.

Parameter integrasi

Untuk membuat koneksi antara Google SecOps dan Compute Engine, Anda harus mengonfigurasi parameter berikut. Integrasi ini mendukung tiga jalur autentikasi yang berbeda. Pilih salah satu metode berikut untuk memberikan kredensial:

  • Workload Identity: Menggunakan Workload Identity Email.
  • File JSON akun layanan: Menggunakan Service Account Json File Content untuk menyediakan seluruh kunci sekaligus.
  • Parameter individual manual: Menggunakan kolom terpisah yang disalin secara manual dari kunci JSON.
Parameter Deskripsi
API Root

Opsional.

URL dasar untuk Compute Engine API.

Nilai defaultnya adalah https://compute.googleapis.com.
OS Config API Root

Opsional.

URL dasar untuk Cloud OS Config API.

Nilai defaultnya adalah https://osconfig.googleapis.com.
Workload Identity Email

Opsional.

Alamat email klien akun layanan Anda. Gunakan ini untuk autentikasi Workload Identity.
Service Account Json File Content

Opsional.

Konten lengkap file JSON kunci akun layanan.

Jika dikonfigurasi, integrasi akan mengabaikan parameter kredensial individual.
Project ID

Opsional.

ID project Google Cloud yang akan ditargetkan.

Jika tidak ada nilai yang diberikan, integrasi akan mengambil ID dari kredensial akun layanan.
Verify SSL

Wajib.

Memvalidasi sertifikat SSL untuk koneksi. Diaktifkan secara default.

Parameter kredensial individual

Hanya gunakan parameter berikut jika Anda memasukkan kredensial secara manual, bukan menggunakan konten file JSON lengkap atau Workload Identity.

Parameter Deskripsi
Account Type

Opsional.

Nilai yang ditemukan di kolom type pada kunci JSON Anda (biasanya service_account).
Private Key ID

Opsional.

Nilai yang ditemukan di kolom private_key_id pada kunci JSON Anda.
Private Key

Opsional.

Nilai yang ditemukan di kolom private_key kunci JSON Anda.
Client Email

Opsional.

Nilai yang ditemukan di kolom client_email pada kunci JSON Anda.
Client ID

Opsional.

Nilai yang ditemukan di kolom client_id kunci JSON Anda.
Auth URI

Opsional.

Nilai yang ditemukan di kolom auth_uri pada kunci JSON Anda.

Nilai defaultnya adalah https://accounts.google.com/o/oauth2/auth.
Token URI

Opsional.

Nilai yang ditemukan di kolom token_uri kunci JSON Anda.

Nilai defaultnya adalah https://oauth2.googleapis.com/token.
Auth Provider X509 URL

Opsional.

Nilai yang ditemukan di kolom auth_provider_x509_cert_url pada kunci JSON Anda.
Client X509 URL

Opsional.

Nilai yang ditemukan di kolom client_x509_cert_url pada kunci JSON Anda.

Untuk mendapatkan petunjuk tentang cara mengonfigurasi integrasi di Google SecOps, lihat Mengonfigurasi integrasi.

Anda dapat melakukan perubahan pada tahap selanjutnya, jika diperlukan. Setelah mengonfigurasi instance integrasi, Anda dapat menggunakannya dalam playbook. Untuk mengetahui informasi selengkapnya tentang cara mengonfigurasi dan mendukung beberapa instance, lihat Mendukung beberapa instance.

Tindakan

Untuk mengetahui informasi selengkapnya tentang tindakan, lihat Merespons tindakan yang tertunda dari meja kerja Anda dan Menjalankan tindakan manual dalam kasus Anda.

Menambahkan IP ke Aturan Firewall

Gunakan tindakan Add IP Range to Firewall Rule untuk menambahkan rentang IP ke aturan firewall yang ada dalam instance Compute Engine.

Tindakan ini tidak berjalan di entity Google SecOps.

Input tindakan

Tindakan Add IP To Firewall Rule memerlukan parameter berikut:

Parameter Deskripsi
Resource Name

Opsional.

Nama resource lengkap instance Compute Engine, dalam format /projects/PROJECT_ID/global/ firewallsFIREWALL.

Parameter ini lebih diprioritaskan daripada Project ID dan Firewall Rule.
Project ID

Opsional.

Nama project yang terkait dengan instance Compute Engine.

Jika tidak ada nilai yang diberikan, tindakan akan menggunakan project ID dari konfigurasi integrasi.
Firewall Rule

Opsional.

Nama aturan firewall tertentu yang akan diupdate.
Type

Wajib.

Arah traffic untuk rentang IP yang ditambahkan.

Kemungkinan nilainya adalah sebagai berikut:

  • Source
  • Destination

Nilai defaultnya adalah Source.
IP Ranges

Wajib.

Daftar rentang alamat IP yang dipisahkan koma (notasi CIDR) untuk ditambahkan ke aturan firewall.

Output tindakan

Tindakan Add IP To Firewall Rule memberikan output berikut:

Jenis output tindakan Ketersediaan
Lampiran repositori kasus Tidak tersedia
Link repositori kasus Tidak tersedia
Tabel repositori kasus Tidak tersedia
Tabel pengayaan Tidak tersedia
Hasil JSON Tersedia
Pesan output Tersedia
Hasil skrip Tersedia
Hasil JSON

Contoh berikut menunjukkan output hasil JSON yang diterima saat menggunakan tindakan Add IP To Firewall Rule:

{
  "kind": "compute#operation",
  "id": "0000000000000000000",
  "name": "operation-1716223324528-618e5619d1f93-174eac81-6b38200d",
  "operationType": "patch",
  "targetLink": "https://www.googleapis.com/compute/v1/projects/project-id/global/firewalls/firewall-name",
  "targetId": "7886634413370691799",
  "status": "DONE",
  "user": "compute-admin@project-id.iam.gserviceaccount.com",
  "progress": 100,
  "insertTime": "2024-05-20T09:42:05.150-07:00",
  "startTime": "2024-05-20T09:42:05.164-07:00",
  "endTime": "2024-05-20T09:42:09.381-07:00",
  "selfLink": "https://www.googleapis.com/compute/v1/projects/project-id/global/operations/operation-1234567890",
  "firewall": {
    "kind": "compute#firewall",
    "id": "6297155974506248217",
    "creationTimestamp": "2023-09-13T07:28:06.690-07:00",
    "name": "firewall-name",
    "description": "",
    "network": "https://www.googleapis.com/compute/v1/projects/project-id/global/networks/vpc-network",
    "priority": 1000,
    "sourceRanges": [
      "0.0.0.0/0"
    ],
    "destinationRanges": [
      "0.0.0.0/21"
    ],
    "allowed": [
      {
        "IPProtocol": "tcp",
        "ports": [
          "22"
        ]
      }
    ],
    "direction": "INGRESS",
    "logConfig": {
      "enable": false
    },
    "disabled": false,
    "selfLink": "https://www.googleapis.com/compute/v1/projects/project-id/global/firewalls/firewall-name"
  }
}
Pesan output

Tindakan Add IP To Firewall Rule dapat menampilkan pesan output berikut:

Pesan output Deskripsi pesan

Successfully updated firewall rule in Google Cloud Compute.

Waiting for the operation to finish execution on the RESOURCE_PATH instance in Google Cloud Compute.

 Tindakan berhasil.
Error executing action "Add IP To Firewall Rule". Reason: ERROR_REASON

Tindakan gagal.

Periksa koneksi ke server, parameter input, atau kredensial.
Hasil skrip

Tabel berikut mencantumkan nilai untuk output hasil skrip saat menggunakan tindakan Add IP To Firewall Rule:

Nama hasil skrip Nilai
is_success true atau false

Menambahkan Label ke Instance

Gunakan tindakan Add Labels to Instance untuk menambahkan atau memperbarui label pada instance Compute Engine tertentu.

Tindakan ini tidak berjalan di entity Google SecOps.

Input tindakan

Tindakan Add Labels to Instance memerlukan parameter berikut:

Parameter Deskripsi
Resource Name

Opsional.

Nama resource lengkap instance Compute Engine, dalam format /project/PROJECT_ID/zone/ ZONE_ID/instances/ INSTANCE_ID.

Parameter ini lebih diprioritaskan daripada Project ID, Instance Zone, dan Instance ID.
Project ID

Opsional.

ID project yang terkait dengan instance Compute Engine.

Jika tidak ada nilai yang diberikan, tindakan akan mengambil project ID dari konfigurasi integrasi.
Instance Zone

Opsional.

Zona spesifik tempat instance berada.

Parameter ini diperlukan jika Anda mengidentifikasi instance menggunakan Instance Zone dan Instance ID.
Instance ID

Opsional.

ID unik instance Compute Engine.

Parameter ini diperlukan jika Anda mengidentifikasi instance menggunakan Instance Zone dan Instance ID.
Instance Labels

Wajib.

Daftar label yang dipisahkan koma untuk diterapkan ke instance, dalam format key:value (seperti vm_label_key:label1).

Output tindakan

Tindakan Add Labels to Instance memberikan output berikut:

Jenis output tindakan Ketersediaan
Lampiran repositori kasus Tidak tersedia
Link repositori kasus Tidak tersedia
Tabel repositori kasus Tidak tersedia
Tabel pengayaan Tidak tersedia
Hasil JSON Tersedia
Pesan output Tersedia
Hasil skrip Tersedia
Hasil JSON

Contoh berikut menjelaskan output hasil JSON yang diterima saat menggunakan tindakan Add Labels to Instance:

{
   "id": "ID",
   "name": "operation-OPERATION_ID",
   "zone": "https://www.googleapis.com/compute/v1/projects/PROJECT_ID/zones/us-central1-a",
   "operationType": "setLabels",
   "targetLink": "https://www.googleapis.com/compute/v1/projects/PROJECT_ID/zones/us-central1-a/instances/INSTANCE_ID",
   "targetId": "INSTANCE_ID",
   "status": "RUNNING",
   "user": "user@example.com",
   "progress": 0,
   "insertTime": "2021-04-28T23:01:29.395-07:00",
   "startTime": "2021-04-28T23:01:29.397-07:00",
   "selfLink": "https://www.googleapis.com/compute/v1/projects/PROJECT_ID/zones/us-central1-a/operations/operation-OPERATION_ID",
   "kind": "compute#operation"
}
Pesan output

Tindakan Add Labels to Instance dapat menampilkan pesan output berikut:

Pesan output Deskripsi pesan

Labels LABEL_LIST were successfully added to Compute Engine instance INSTANCE_ID.

Provided instance zone ZONE_ID is not valid.

Provided instance ID is not valid.

Labels were not added because provided label LABEL_ID has the key that already exist for the Compute Engine instance INSTANCE_ID.

 Tindakan berhasil.
Error executing action "Add Labels to Instance". Reason: ERROR_REASON

Tindakan gagal.

Periksa koneksi ke server, parameter input, atau kredensial.
Hasil skrip

Tabel berikut mencantumkan nilai untuk output hasil skrip saat menggunakan tindakan Add Labels to Instance:

Nama hasil skrip Nilai
is_success true atau false

Menambahkan Tag Jaringan

Gunakan tindakan Add Network Tags untuk menambahkan satu atau beberapa tag jaringan ke instance Compute Engine tertentu.

Tindakan ini tidak berjalan di entity Google SecOps.

Input tindakan

Tindakan Add Network Tags memerlukan parameter berikut:

Parameter Deskripsi
Resource Name

Opsional.

Nama resource lengkap instance Compute Engine, dalam format /project/PROJECT_ID/zone/ ZONE_ID/instances/ INSTANCE_ID.

Parameter ini lebih diprioritaskan daripada Project ID, Instance Zone, dan Instance ID.
Project ID

Opsional.

ID project yang terkait dengan instance Compute Engine.

Jika tidak ada nilai yang diberikan, tindakan akan mengambil project ID dari konfigurasi integrasi.
Instance Zone

Opsional.

Zona spesifik tempat instance berada.

Parameter ini diperlukan jika Anda mengidentifikasi instance menggunakan Instance Zone dan Instance ID.
Instance ID

Opsional.

ID unik instance Compute Engine.

Parameter ini diperlukan jika Anda mengidentifikasi instance menggunakan Instance Zone dan Instance ID.
Network Tags

Wajib.

Daftar tag jaringan yang dipisahkan koma untuk ditambahkan ke instance.

Semua tag hanya boleh berisi huruf kecil, angka, dan tanda hubung.

Output tindakan

Tindakan Add Network Tags memberikan output berikut:

Jenis output tindakan Ketersediaan
Lampiran repositori kasus Tidak tersedia
Link repositori kasus Tidak tersedia
Tabel repositori kasus Tidak tersedia
Tabel pengayaan Tidak tersedia
Hasil JSON Tersedia
Pesan output Tersedia
Hasil skrip Tersedia
Hasil JSON

Contoh berikut menunjukkan output hasil JSON yang diterima saat menggunakan tindakan Add Network Tags:

{
  "kind": "compute#instance",
  "id": "1459671903146615834",
  "creationTimestamp": "2023-09-13T04:20:21.993-07:00",
  "name": "instance-2",
  "description": "",
  "tags": {
    "items": [
      "another-tag",
      "tag"
    ],
    "fingerprint": "BCeEINC7Ths="
  },
  "machineType": "https://www.googleapis.com/compute/v1/projects/project-id/zones/us-central1-a/machineTypes/e2-micro",
  "status": "RUNNING",
  "zone": "https://www.googleapis.com/compute/v1/projects/project-id/zones/us-central1-a",
  "canIpForward": false,
  "networkInterfaces": [
    {
      "kind": "compute#networkInterface",
      "network": "https://www.googleapis.com/compute/v1/projects/project-id/global/networks/default",
      "subnetwork": "https://www.googleapis.com/compute/v1/projects/project-id/regions/us-central1/subnetworks/default",
      "networkIP": "10.128.0.3",
      "name": "nic0",
      "fingerprint": "-ZnnV7hiDfs=",
      "stackType": "IPV4_ONLY"
    }
  ],
  "disks": [
    {
      "kind": "compute#attachedDisk",
      "type": "PERSISTENT",
      "mode": "READ_WRITE",
      "source": "https://www.googleapis.com/compute/v1/projects/project-id/zones/us-central1-a/disks/instance-2",
      "deviceName": "instance-2",
      "index": 0,
      "boot": true,
      "autoDelete": true,
      "licenses": [
        "https://www.googleapis.com/compute/v1/projects/centos-cloud/global/licenses/centos-7"
      ],
      "interface": "SCSI",
      "guestOsFeatures": [
        { "type": "UEFI_COMPATIBLE" },
        { "type": "GVNIC" }
      ],
      "diskSizeGb": "20",
      "architecture": "X86_64"
    }
  ],
  "metadata": {
    "kind": "compute#metadata",
    "fingerprint": "NBmH4-7Jw9U=",
    "items": []
  },
  "serviceAccounts": [
    {
      "email": "1111111111-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/project-id/zones/us-central1-a/instances/instance-2",
  "scheduling": {
    "onHostMaintenance": "MIGRATE",
    "automaticRestart": true,
    "preemptible": false,
    "provisioningModel": "STANDARD"
  },
  "cpuPlatform": "Intel Broadwell",
  "deletionProtection": false,
  "shieldedInstanceConfig": {
    "enableSecureBoot": false,
    "enableVtpm": true,
    "enableIntegrityMonitoring": true
  }
}
Pesan output

Tindakan Add Network Tags dapat menampilkan pesan output berikut:

Pesan output Deskripsi pesan

Successfully added network tags to the instance RESOURCE_PATH in Compute Engine.

Waiting for the operation to finish execution on the RESOURCE_PATH instance in Compute Engine.

 Tindakan berhasil.
Error executing action "Add Network Tags". Reason: ERROR_REASON

Tindakan gagal.

Periksa koneksi ke server, parameter input, atau kredensial.
Hasil skrip

Tabel berikut mencantumkan nilai untuk output hasil skrip saat menggunakan tindakan Add Network Tags:

Nama hasil skrip Nilai
is_success true atau false

Hapus Instance

Gunakan tindakan Delete Instance untuk menghapus instance Compute Engine.

Tindakan ini tidak berjalan di entity Google SecOps.

Input tindakan

Tindakan Delete Instance memerlukan parameter berikut:

Parameter Deskripsi
Resource Name

Opsional.

Nama resource lengkap instance Compute Engine, dalam format /project/PROJECT_ID/zone/ ZONE_ID/instances/ INSTANCE_ID.

Parameter ini lebih diprioritaskan daripada Project ID, Instance Zone, dan Instance ID.
Project ID

Opsional.

ID project yang terkait dengan instance Compute Engine.

Jika tidak ada nilai yang diberikan, tindakan akan mengambil project ID dari konfigurasi integrasi.
Instance Zone

Opsional.

Zona spesifik tempat instance berada.

Parameter ini diperlukan jika Anda mengidentifikasi instance menggunakan Instance Zone dan Instance ID.
Instance ID

Opsional.

ID unik instance yang ingin Anda mulai.

Anda dapat mengambil nilai ini menggunakan tindakan List Instances.

Parameter ini diperlukan jika Anda mengidentifikasi instance menggunakan Instance Zone dan Instance ID.

Output tindakan

Tindakan Delete Instance memberikan output berikut:

Jenis output tindakan Ketersediaan
Lampiran repositori kasus Tidak tersedia
Link repositori kasus Tidak tersedia
Tabel repositori kasus Tidak tersedia
Tabel pengayaan Tidak tersedia
Hasil JSON Tersedia
Pesan output Tersedia
Hasil skrip Tersedia
Hasil JSON

Contoh berikut menjelaskan output hasil JSON yang diterima saat menggunakan tindakan Delete Instance:

{
   "id": "ID",
   "name": "operation-OPERATION_ID",
   "zone": "https://www.googleapis.com/compute/v1/projects/PROJECT_ID/zones/us-central1-a",
   "operationType": "delete",
   "targetLink": "https://www.googleapis.com/compute/v1/projects/PROJECT_ID/zones/us-central1-a/instances/INSTANCE_ID",
   "targetId": "INSTANCE_ID",
   "status": "RUNNING",
   "user": "user@example.com",
   "progress": 0,
   "insertTime": "2021-04-28T23:01:29.395-07:00",
   "startTime": "2021-04-28T23:01:29.397-07:00",
   "selfLink": "https://www.googleapis.com/compute/v1/projects/PROJECT_ID/zones/us-central1-a/operations/operation-OPERATION_ID",
   "kind": "compute#operation"
}
Pesan output

Tindakan Delete Instance dapat menampilkan pesan output berikut:

Pesan output Deskripsi pesan

Compute Engine instance INSTANCE_ID was deleted successfully.

Provided instance zone ZONE_ID is not valid.

Provided instance ID is not valid.

 Tindakan berhasil.

Error executing action "Start Instance". Reason: ERROR_REASON

Provided resource RESOURCE_PATH is not valid

Tindakan gagal.

Periksa koneksi ke server, parameter input, atau kredensial.
Hasil skrip

Tabel berikut mencantumkan nilai untuk output hasil skrip saat menggunakan tindakan Delete Instance:

Nama hasil skrip Nilai
is_success true atau false

Memperkaya Entity

Gunakan tindakan Enrich Entities untuk memperkaya entity IP Address Google SecOps dengan informasi instance dari Compute Engine.

Tindakan ini berjalan di entity Google SecOps berikut:

  • IP Address

Input tindakan

Tindakan Enrich Entities memerlukan parameter berikut:

Parameter Deskripsi
Project ID

Opsional.

ID project yang terkait dengan instance Compute Engine.

Jika tidak ada nilai yang diberikan, tindakan akan mengambil project ID dari konfigurasi integrasi.
Instance Zone

Opsional.

Zona spesifik tempat instance berada.

Output tindakan

Tindakan Enrich Entities memberikan output berikut:

Jenis output tindakan Ketersediaan
Lampiran repositori kasus Tidak tersedia
Link repositori kasus Tidak tersedia
Tabel repositori kasus Tersedia
Tabel pengayaan Tersedia
Hasil JSON Tersedia
Pesan output Tersedia
Hasil skrip Tersedia
Tabel repositori kasus

Setelah menyelesaikan eksekusi, tindakan Enrich Entities akan menyediakan tabel berikut:

Nama tabel: ENTITY Enrichment Table

Kolom:

  • Kolom Entity
  • Nilai
Tabel pengayaan

Tindakan Enrich Entities mendukung pengayaan entity berikut:

Kolom pengayaan Sumber (kunci JSON) Logika
Google_Compute_instance_id id Tidak tersedia
Google_Compute_creation_timestamp creationTimestamp Tidak tersedia
Google_Compute_instance_name name Tidak tersedia
Google_Compute_description description Tidak tersedia
Google_Compute_tags tags Berikan tag dalam daftar CSV
Google_Compute_machine_type machineType Tidak tersedia
Google_Compute_instance_status status Tidak tersedia
Google_Compute_instance_zone zone Tidak tersedia
Google_Compute_can_ip_forward canIpForward Tidak tersedia
Google_Compute_instance_network_interfaces_name_INDEX networkInterfaces.name Luaskan jika ada lebih banyak antarmuka jaringan yang tersedia
Google_Compute_instance_network_interfaces_name_access_configs_type_INDEX networkInterfaces.accessConfigs.type Luaskan jika ada lebih banyak antarmuka jaringan yang tersedia
Google_Compute_instance_network_interfaces_name_access_configs_name_INDEX networkInterfaces.accessConfigs.name Luaskan jika ada lebih banyak antarmuka jaringan yang tersedia
Google_Compute_instance_network_interfaces_name_access_configs_natIP_INDEX networkInterfaces.accessConfigs.natIP Luaskan jika ada lebih banyak antarmuka jaringan yang tersedia
Google_Compute_instance_metadata metadata Daftar nilai CSV dari metadata instance
Google_Compute_service_account_INDEX serviceAccounts.email Luaskan jika ada lebih banyak akun layanan yang tersedia
Google_Compute_service_account_scopes_INDEX serviceAccounts.scopes Luaskan jika ada lebih banyak akun layanan yang tersedia
Google_Compute_link_to_Google_Compute selfLink Tidak tersedia
Google_Compute_labels labels Berikan daftar nilai CSV
Google_Compute_instance_last_start_timestamp lastStartTimestamp Tidak tersedia
Google_Compute_instance_last_stop_timestamp lastStopTimestamp Tidak tersedia
Hasil JSON

Contoh berikut menjelaskan output hasil JSON yang diterima saat menggunakan tindakan Enrich Entities:

{
    "id": "ID",
    "creationTimestamp": "2021-04-28T21:34:57.369-07:00",
    "name": "instance-1",
    "description": "",
    "tags": {
        "fingerprint": "VALUE"
    },
    "machineType": "https://www.googleapis.com/compute/v1/projects/PROJECT_ID/zones/us-central1-a/machineTypes/f1-micro",
    "status": "RUNNING",
    "zone": "https://www.googleapis.com/compute/v1/projects/PROJECT_ID/zones/us-central1-a",
    "canIpForward": false,
    "networkInterfaces": [
        {
            "network": "https://www.googleapis.com/compute/v1/projects/PROJECT_ID/global/networks/default",
            "subnetwork": "https://www.googleapis.com/compute/v1/projects/PROJECT_ID/regions/us-central1/subnetworks/default",
            "networkIP": "203.0.113.2",
            "name": "example",
            "accessConfigs": [
                {
                    "type": "ONE_TO_ONE_NAT",
                    "name": "External NAT",
                    "natIP": "198.51.100.59",
                    "networkTier": "PREMIUM",
                    "kind": "compute#accessConfig"
                }
            ],
            "fingerprint": "VALUE",
            "kind": "compute#networkInterface"
        }
    ],
    "disks": [
        {
            "type": "PERSISTENT",
            "mode": "READ_WRITE",
            "source": "https://www.googleapis.com/compute/v1/PROJECT_ID/zones/us-central1-a/disks/instance-1",
            "deviceName": "instance-1",
            "index": 0,
            "boot": true,
            "autoDelete": true,
            "licenses": [
                "https://www.googleapis.com/compute/v1/projects/PROJECT_ID/global/licenses/LICENSE"
            ],
            "interface": "SCSI",
            "guestOsFeatures": [
                {
                    "type": "UEFI_COMPATIBLE"
                },
                {
                    "type": "VIRTIO_SCSI_MULTIQUEUE"
                }
            ],
            "diskSizeGb": "10",
            "kind": "compute#attachedDisk"
        }
    ],
    "metadata": {
        "fingerprint": "VALUE",
        "kind": "compute#metadata"
    },
    "serviceAccounts": [
        {
            "email": "user@example.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/PROJECT_ID/zones/us-central1-a/instances/instance-1",
    "scheduling": {
        "onHostMaintenance": "MIGRATE",
        "automaticRestart": true,
        "preemptible": false
    },
    "cpuPlatform": "Intel Haswell",
    "labels": {
        "vm_test_tag": "tag1"
    },
    "labelFingerprint": "VALUE",
    "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": "VALUE",
    "lastStartTimestamp": "2021-04-28T21:35:07.865-07:00",
    "kind": "compute#instance"
}
Pesan output

Tindakan Enrich Entities dapat menampilkan pesan output berikut:

Pesan output Deskripsi pesan

Successfully enriched entities: ENTITY_ID.

Provided instance zone ZONE_ID is not valid.

Action was not able to find a match Compute Engine to enrich provided entities: ENTITY_ID.

No entities were enriched.

 Tindakan berhasil.
Error executing action "Enrich Entities". Reason: ERROR_REASON

Tindakan gagal.

Periksa koneksi ke server, parameter input, atau kredensial.
Hasil skrip

Tabel berikut mencantumkan nilai untuk output hasil skrip saat menggunakan tindakan Enrich Entities:

Nama hasil skrip Nilai
is_success true atau false

Menjalankan Tugas Patch VM

Gunakan tindakan Execute VM Patch Job untuk menjalankan tugas patch VM di instance Compute Engine.

Tindakan ini tidak berjalan di entity Google SecOps.

Input tindakan

Tindakan Execute VM Patch Job memerlukan parameter berikut:

Parameter Deskripsi
Instance Filter Object

Wajib.

Objek JSON yang digunakan untuk menargetkan instance tertentu untuk di-patch.

Nilai default menargetkan semua instance:

{
  "all": "true"
}
Name

Wajib.

Nama unik untuk tugas patching.
Description

Opsional.

Deskripsi singkat tentang tujuan tugas patching.
Patching Config Object

Opsional.

Objek JSON yang menentukan langkah-langkah dan konfigurasi update tertentu untuk berbagai sistem operasi.

Jika tidak ada nilai yang diberikan, tindakan akan menggunakan nilai default berikut:

{
  "rebootConfig": "DEFAULT",
  "apt": {
    "type": "DIST"
  },
  "yum": {
    "security": true
  },
  "zypper": {
    "withUpdate": true
  },
  "windowsUpdate": {
    "classifications": ["CRITICAL", "SECURITY"]
  }
}
Patch Duration Timeout

Wajib.

Waktu maksimum, dalam menit, yang diizinkan untuk menjalankan tugas patching.

Nilai defaultnya adalah 60.
Rollout Strategy

Opsional.

Metode yang digunakan untuk men-deploy patch di beberapa zona.

Kemungkinan nilainya adalah sebagai berikut:

  • Zone By Zone: Patch diterapkan ke satu zona pada satu waktu untuk meminimalkan risiko.
  • Concurrent Zones: Patch diterapkan ke semua zona yang ditargetkan secara bersamaan untuk mengurangi total masa pemeliharaan.

Nilai defaultnya adalah Zone By Zone.
Disruption Budget

Wajib.

Jumlah atau persentase instance yang dapat offline pada saat yang sama (misalnya, 5 atau 10%).

Nilai defaultnya adalah 10%.
Wait For Completion

Wajib.

Jika dipilih, tindakan akan tetap aktif hingga tugas patching selesai.

Diaktifkan secara default.
Fail If Completed With Errors

Wajib.

Jika dipilih, tindakan akan gagal jika status tugas adalah Completed with errors atau jika mencapai batas waktu tunggu.

Parameter ini diabaikan jika Wait For Completion dinonaktifkan.

Diaktifkan secara default.

Output tindakan

Tindakan Execute VM Patch Job memberikan output berikut:

Jenis output tindakan Ketersediaan
Lampiran repositori kasus Tidak tersedia
Link repositori kasus Tidak tersedia
Tabel repositori kasus Tidak tersedia
Tabel pengayaan Tidak tersedia
Hasil JSON Tersedia
Pesan output Tersedia
Hasil skrip Tersedia
Hasil JSON

Contoh berikut menunjukkan output hasil JSON yang diterima saat menggunakan tindakan Execute VM Patch Job:

{
            "name": "projects/PROJECT_ID/patchJobs/JOB_ID",
            "createTime": "2024-09-24T16:00:43.354907Z",
            "updateTime": "2024-09-24T16:00:44.626050Z",
            "state": "PATCHING",
            "patchConfig": {
                "rebootConfig": "DEFAULT",
                "apt": {
                    "type": "UPGRADE"
                },
                "yum": {},
                "zypper": {},
                "windowsUpdate": {}
            },
            "duration": "3600s",
            "instanceDetailsSummary": {
                "startedInstanceCount": "1"
            },
            "percentComplete": 20,
            "instanceFilter": {
                "instances": [
                    "zones/us-central1-a/instances/INSTANCE_ID"
                ]
            },
            "displayName": "test",
            "rollout": {
                "mode": "ZONE_BY_ZONE",
                "disruptionBudget": {
                    "percent": 25
                }
            }
        }
Pesan output

Tindakan Execute VM Patch Job dapat menampilkan pesan output berikut:

Pesan output Deskripsi pesan

Successfully executed VM patching job in Google Cloud Compute.

Successfully executed and completed VM patching job in Google Cloud Compute.

The executed patching job was canceled in Google Cloud Compute.

The executed patching job was completed, but with errors in Compute Engine. Errors: ERROR_DESCRIPTION

 Tindakan berhasil.
Error executing action "Execute VM Patch Job". Reason: ERROR_REASON

Tindakan gagal.

Periksa koneksi ke server, parameter input, atau kredensial.
Hasil skrip

Tabel berikut mencantumkan nilai untuk output hasil skrip saat menggunakan tindakan Execute VM Patch Job:

Nama hasil skrip Nilai
is_success true atau false

Mendapatkan Kebijakan IAM Instance

Gunakan tindakan Get Instance IAM Policy untuk mengambil kebijakan kontrol akses Identity and Access Management (iam_name_short) untuk resource Compute Engine tertentu.

Tindakan ini tidak berjalan di entity Google SecOps.

Input tindakan

Tindakan Get Instance IAM Policy memerlukan parameter berikut:

Parameter Deskripsi
Resource Name

Opsional.

Nama resource lengkap instance Compute Engine, dalam format /project/PROJECT_ID/zone/ ZONE_ID/instances/ INSTANCE_ID.

Parameter ini lebih diprioritaskan daripada Project ID, Instance Zone, dan Instance ID.
Project ID

Opsional.

ID project yang terkait dengan instance Compute Engine.

Jika tidak ada nilai yang diberikan, tindakan akan mengambil project ID dari konfigurasi integrasi.
Instance Zone

Opsional.

Zona spesifik tempat instance berada.

Parameter ini diperlukan jika Anda mengidentifikasi instance menggunakan Instance Zone dan Instance ID.
Instance ID

Opsional.

ID unik instance yang ingin Anda mulai.

Anda dapat mengambil nilai ini menggunakan tindakan List Instances.

Parameter ini diperlukan jika Anda mengidentifikasi instance menggunakan Instance Zone dan Instance ID.

Output tindakan

Tindakan Get Instance IAM Policy memberikan output berikut:

Jenis output tindakan Ketersediaan
Lampiran repositori kasus Tidak tersedia
Link repositori kasus Tidak tersedia
Tabel repositori kasus Tidak tersedia
Tabel pengayaan Tidak tersedia
Hasil JSON Tersedia
Pesan output Tersedia
Hasil skrip Tersedia
Hasil JSON

Contoh berikut menjelaskan output hasil JSON yang diterima saat menggunakan tindakan Get Instance IAM Policy:

{
    "version": 1,
    "etag": "BwXBfsc47MI=",
    "bindings": [
        {
            "role": "roles/compute.networkViewer_withcond_2f0c00",
            "members": [
                "user:user@example.com"
            ]
        }
    ]
}
Pesan output

Tindakan Get Instance IAM Policy dapat menampilkan pesan output berikut:

Pesan output Deskripsi pesan

Compute Engine instance INSTANCE_ID IAM policy was fetched successfully.

Provided instance zone ZONE_ID is not valid.

Provided instance ID is not valid.

 Tindakan berhasil.
Error executing action "Get Instance IAM Policy". Reason: ERROR_REASON

Tindakan gagal.

Periksa koneksi ke server, parameter input, atau kredensial.
Hasil skrip

Tabel berikut mencantumkan nilai untuk output hasil skrip saat menggunakan tindakan Get Instance IAM Policy:

Nama hasil skrip Nilai
is_success true atau false

Mencantumkan Instance

Gunakan tindakan List Instances untuk mencantumkan instance Compute Engine berdasarkan kriteria penelusuran yang ditentukan.

Tindakan ini tidak berjalan di entity Google SecOps.

Input tindakan

Tindakan List Instances memerlukan parameter berikut:

Parameter Deskripsi
Project ID

Opsional.

ID project yang akan menampilkan daftar instance.

Jika tidak ada nilai yang diberikan, tindakan akan mengambil project ID dari Google Cloud akun layanan yang digunakan dalam konfigurasi integrasi.
Instance Zone

Opsional.

Zona tertentu untuk menelusuri instance.

Jika tidak ada nilai yang diberikan, tindakan akan menelusuri semua zona yang tersedia.
Instance Name

Opsional.

Nama instance yang akan ditelusuri.

Parameter ini menerima beberapa nilai sebagai string yang dipisahkan koma.
Instance Status

Opsional.

Status instance saat ini yang akan disertakan dalam hasil penelusuran, seperti RUNNING atau TERMINATED.

Parameter ini menerima beberapa nilai sebagai string yang dipisahkan koma.
Instance Labels

Opsional.

Label yang digunakan untuk memfilter hasil instance, yang disediakan dalam format key:value (seperti env:production).

Parameter ini menerima beberapa nilai sebagai string yang dipisahkan koma.
Max Rows to Return

Opsional.

Jumlah maksimum instance yang akan ditampilkan dalam hasil.

Nilai defaultnya adalah 50.

Output tindakan

Tindakan List Instances memberikan output berikut:

Jenis output tindakan Ketersediaan
Lampiran repositori kasus Tidak tersedia
Link repositori kasus Tidak tersedia
Tabel repositori kasus Tersedia
Tabel pengayaan Tidak tersedia
Hasil JSON Tersedia
Pesan output Tersedia
Hasil skrip Tersedia
Tabel repositori kasus

Tindakan List Instances menyediakan tabel berikut:

Nama tabel: Instance Compute Engine

Kolom tabel:

  • Instance Name
  • Instance ID
  • Waktu Pembuatan Instance
  • Deskripsi Instance
  • Jenis Instance
  • Status Instance
  • Label Instance
Hasil JSON

Contoh berikut menjelaskan output hasil JSON yang diterima saat menggunakan tindakan List Instances:

{ "id": "projects/PROJECT_ID/zones/us-central1-a/instances",
   "items": [
       {
           "id": "ID",
           "creationTimestamp": "2021-04-28T21:34:57.369-07:00",
           "name": "instance-1",
           "description": "",
           "tags": {
               "fingerprint": "VALUE"
           },
           "machineType": "https://www.googleapis.com/compute/v1/projects/PROJECT_ID/zones/us-central1-a/machineTypes/f1-micro",
           "status": "RUNNING",
           "zone": "https://www.googleapis.com/compute/v1/projects/PROJECT_ID/zones/us-central1-a",
           "canIpForward": false,
           "networkInterfaces": [
               {
                   "network": "https://www.googleapis.com/compute/v1/projects/PROJECT_ID/global/networks/default",
                   "subnetwork": "https://www.googleapis.com/compute/v1/projects/PROJECT_ID/regions/us-central1/subnetworks/default",
                   "networkIP": "192.0.2.2",
                   "name": "example",
                   "accessConfigs": [
                       {
                           "type": "ONE_TO_ONE_NAT",
                           "name": "External NAT",
                           "natIP": "203.0.113.59",
                           "networkTier": "PREMIUM",
                           "kind": "compute#accessConfig"
                       }
                   ],
                   "fingerprint": "VALUE",
                   "kind": "compute#networkInterface"
               }
           ],
           "disks": [
               {
                   "type": "PERSISTENT",
                   "mode": "READ_WRITE",
                   "source": "https://www.googleapis.com/compute/v1/projects/PROJECT_ID/zones/us-central1-a/disks/instance-1",
                   "deviceName": "instance-1",
                   "index": 0,
                   "boot": true,
                   "autoDelete": true,
                   "licenses": [
                       "https://www.googleapis.com/compute/v1/projects/PROJECT_ID/global/licenses/LICENSE"
                   ],
                   "interface": "SCSI",
                   "guestOsFeatures": [
                       {
                           "type": "UEFI_COMPATIBLE"
                       },
                       {
                           "type": "VIRTIO_SCSI_MULTIQUEUE"
                       }
                   ],
                   "diskSizeGb": "10",
                   "kind": "compute#attachedDisk"
               }
           ],
           "metadata": {
               "fingerprint": "VALUE",
               "kind": "compute#metadata"
           },
           "serviceAccounts": [
               {
                   "email": "user@example.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/PROJECT_IDzones/us-central1-a/instances/instance-1",
           "scheduling": {
               "onHostMaintenance": "MIGRATE",
               "automaticRestart": true,
               "preemptible": false
           },
           "cpuPlatform": "Intel Haswell",
           "labels": {
               "vm_test_tag": "tag1"
           },
           "labelFingerprint": "VALUE",
           "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": "VALUE",
           "lastStartTimestamp": "2021-04-28T21:35:07.865-07:00",
           "kind": "compute#instance"
       }
   ]
}
Pesan output

Tindakan List Instances dapat menampilkan pesan output berikut:

Pesan output Deskripsi pesan

Successfully fetched Compute Engine instances.

Provided instance zone ZONE_ID is not valid.

No instances were found in Compute Engine.

 Tindakan berhasil.
Error executing action "List Instances". Reason: ERROR_REASON

Tindakan gagal.

Periksa koneksi ke server, parameter input, atau kredensial.
Hasil skrip

Tabel berikut mencantumkan nilai untuk output hasil skrip saat menggunakan tindakan List Instances:

Nama hasil skrip Nilai
is_success true atau false

Ping

Gunakan tindakan Ping untuk menguji konektivitas ke Compute Engine.

Tindakan ini tidak berjalan di entity Google SecOps.

Input tindakan

Tidak ada.

Output tindakan

Tindakan Ping memberikan output berikut:

Jenis output tindakan Ketersediaan
Lampiran repositori kasus Tidak tersedia
Link repositori kasus Tidak tersedia
Tabel repositori kasus Tidak tersedia
Tabel pengayaan Tidak tersedia
Hasil JSON Tidak tersedia
Pesan output Tersedia
Hasil skrip Tersedia
Pesan output

Tindakan Ping dapat menampilkan pesan output berikut:

Pesan output Deskripsi pesan
Successfully connected to the Compute Engine service with the provided connection parameters! Tindakan berhasil.
Failed to connect to the Compute Engine service! Error is ERROR_REASON

Tindakan gagal.

Periksa koneksi ke server, parameter input, atau kredensial.
Hasil skrip

Tabel berikut mencantumkan nilai untuk output hasil skrip saat menggunakan tindakan Ping:

Nama hasil skrip Nilai
is_success true atau false

Menghapus Alamat IP Eksternal

Gunakan tindakan Remove External IP Addresses untuk menghapus alamat IP eksternal pada instance Compute Engine.

Tindakan ini tidak berjalan di entity Google SecOps.

Input tindakan

Tindakan Remove External IP Addresses memerlukan parameter berikut:

Parameter Deskripsi
Resource Name

Opsional.

Nama resource lengkap instance Compute Engine, dalam format /project/PROJECT_ID/zone/ ZONE_ID/instances/ INSTANCE_ID.

Parameter ini lebih diprioritaskan daripada Project ID, Instance Zone, dan Instance ID.
Project ID

Opsional.

ID project yang terkait dengan instance Compute Engine.

Jika tidak ada nilai yang diberikan, tindakan akan mengambil project ID dari konfigurasi integrasi.
Instance Zone

Opsional.

Zona spesifik tempat instance berada.

Parameter ini diperlukan jika Anda mengidentifikasi instance menggunakan Instance Zone dan Instance ID.
Instance ID

Opsional.

ID unik instance yang ingin Anda mulai.

Anda dapat mengambil nilai ini menggunakan tindakan List Instances.

Parameter ini diperlukan jika Anda mengidentifikasi instance menggunakan Instance Zone dan Instance ID.
Network Interfaces

Opsional.

Daftar yang dipisahkan koma dari antarmuka jaringan tertentu yang akan diubah.

Jika tidak ada nilai yang diberikan atau jika Anda menggunakan karakter pengganti *, tindakan ini akan memperbarui semua antarmuka jaringan.

Nilai defaultnya adalah *.

Output tindakan

Tindakan Remove External IP Addresses memberikan output berikut:

Jenis output tindakan Ketersediaan
Lampiran repositori kasus Tidak tersedia
Link repositori kasus Tidak tersedia
Tabel repositori kasus Tidak tersedia
Tabel pengayaan Tidak tersedia
Hasil JSON Tersedia
Pesan output Tersedia
Hasil skrip Tersedia
Hasil JSON

Contoh berikut menjelaskan output hasil JSON yang diterima saat menggunakan tindakan Remove External IP Addresses:

[
    {
        "endTime": "2024-05-21T04:28:05.371-07:00",
        "id": "ID",
        "insertTime": "2024-05-21T04:28:04.176-07:00",
        "kind": "compute#operation",
        "name": "operation-OPERATION_ID",
        "operationType": "updateNetworkInterface",
        "progress": 100,
        "selfLink": "https://www.googleapis.com/compute/v1/projects/PROJECT_ID/zones/us-west1-a/operations/operation-OPERATION_ID",
        "startTime": "2024-05-21T04:28:04.190-07:00",
        "status": "DONE",
        "targetId": "TARGET_ID",
        "targetLink": "https://www.googleapis.com/compute/v1/projects/PROJECT_ID/zones/us-west1-a/instances/INSTANCE_ID",
        "user": "user@example.com",
        "zone": "us-west1-a",
        "networkInterface": "example"
    },
    {
        "endTime": "2024-05-21T04:28:06.549-07:00",
        "id": "2531200345768541098",
        "insertTime": "2024-05-21T04:28:05.419-07:00",
        "kind": "compute#operation",
        "name": "operation-OPERATION_ID",
        "operationType": "deleteAccessConfig",
        "progress": 100,
        "selfLink": "https://www.googleapis.com/compute/v1/projects/PROJECT_ID/zones/us-west1-a/operations/operation-OPERATION_ID",
        "startTime": "2024-05-21T04:28:05.430-07:00",
        "status": "DONE",
        "targetId": "3905740668247239013",
        "targetLink": "https://www.googleapis.com/compute/v1/projects/PROJECT_ID/zones/us-west1-a/instances/INSTANCE_ID",
        "user": "user@example.com",
        "zone": "us-west1-a",
        "networkInterface": "example"
    }
]
Pesan output

Tindakan Remove External IP Addresses dapat menampilkan pesan output berikut:

Pesan output Deskripsi pesan

Successfully removed external IP addresses from RESOURCE_PATH instance in INTEGRATION_NAME.

Waiting for the operation to finish execution on the RESOURCE_PATH instance in INTEGRATION_NAME.

 Tindakan berhasil.

Error executing action "Remove External IP Addresses". Reason: ERROR_REASON

Action ran into a timeout during execution. Pending operations: PENDING_OPERATIONS. Please increase the timeout in IDE.

The following network interfaces were not found: INTERFACES on the RESOURCE_PATH in INTEGRATION_NAME. Please check the spelling.

Provided instance zone is not valid.

Provided instance ID is not valid.

Tindakan gagal.

Periksa koneksi ke server, parameter input, atau kredensial.
Hasil skrip

Tabel berikut mencantumkan nilai untuk output hasil skrip saat menggunakan tindakan Remove External IP Addresses:

Nama hasil skrip Nilai
is_success true atau false

Menghapus IP Dari Aturan Firewall

Gunakan tindakan Remove IP From Firewall Rule untuk menghapus rentang alamat IP tertentu dari aturan firewall Compute Engine yang ada.

Tindakan ini tidak berjalan di entity Google SecOps.

Input tindakan

Tindakan Remove IP From Firewall Rule memerlukan parameter berikut:

Parameter Deskripsi
Resource Name

Opsional.

Nama resource lengkap instance Compute Engine, dalam format /projects/PROJECT_ID/global/ firewallsFIREWALL.

Parameter ini lebih diprioritaskan daripada Project ID dan Firewall Rule.
Project ID

Opsional.

ID project yang terkait dengan instance Compute Engine.

Jika tidak ada nilai yang diberikan, tindakan akan mengambil project ID dari konfigurasi integrasi.
Firewall Rule

Opsional.

Nama aturan firewall tertentu yang akan diupdate.
Type

Wajib.

Arah traffic untuk rentang IP yang ditambahkan.

Kemungkinan nilainya adalah sebagai berikut:

  • Source
  • Destination

Nilai defaultnya adalah Source.
IP Ranges

Wajib.

Daftar rentang alamat IP yang dipisahkan koma (notasi CIDR) untuk ditambahkan ke aturan firewall.

Output tindakan

Tindakan Remove IP From Firewall Rule memberikan output berikut:

Jenis output tindakan Ketersediaan
Lampiran repositori kasus Tidak tersedia
Link repositori kasus Tidak tersedia
Tabel repositori kasus Tidak tersedia
Tabel pengayaan Tidak tersedia
Hasil JSON Tersedia
Pesan output Tersedia
Hasil skrip Tersedia
Hasil JSON

Contoh berikut menunjukkan output hasil JSON yang diterima saat menggunakan tindakan Remove IP From Firewall Rule:

{
  "kind": "compute#operation",
  "id": "9160761312385876914",
  "name": "operation-1716223324528-618e5619d1f93-174eac81-6b38200d",
  "operationType": "patch",
  "targetLink": "https://www.googleapis.com/compute/v1/projects/project-id/global/firewalls/firewall-name",
  "targetId": "7886634413370691799",
  "status": "DONE",
  "user": "compute-admin@project-id.iam.gserviceaccount.com",
  "progress": 100,
  "insertTime": "2024-05-20T09:42:05.150-07:00",
  "startTime": "2024-05-20T09:42:05.164-07:00",
  "endTime": "2024-05-20T09:42:09.381-07:00",
  "selfLink": "https://www.googleapis.com/compute/v1/projects/project-id/global/operations/operation-1716223324528-618e5619d1f93-174eac81-6b38200d",
  "firewall": {
    "kind": "compute#firewall",
    "id": "6297155974506248217",
    "creationTimestamp": "2023-09-13T07:28:06.690-07:00",
    "name": "firewall-name",
    "description": "",
    "network": "https://www.googleapis.com/compute/v1/projects/project-id/global/networks/vpc-network",
    "priority": 1000,
    "sourceRanges": [
      "0.0.0.0/0"
    ],
    "destinationRanges": [
      "0.0.0.0/21"
    ],
    "allowed": [
      {
        "IPProtocol": "tcp",
        "ports": [
          "22"
        ]
      }
    ],
    "direction": "INGRESS",
    "logConfig": {
      "enable": false
    },
    "disabled": false,
    "selfLink": "https://www.googleapis.com/compute/v1/projects/project-id/global/firewalls/firewall-name"
  }
}
Pesan output

Tindakan Remove IP From Firewall Rule dapat menampilkan pesan output berikut:

Pesan output Deskripsi pesan

Successfully updated firewall rule in Google Cloud Compute.

Waiting for the operation to finish execution on the RESOURCE_PATH instance in Google Cloud Compute.

 Tindakan berhasil.
Error executing action "Remove IP From Firewall Rule". Reason: ERROR_REASON

Tindakan gagal.

Periksa koneksi ke server, parameter input, atau kredensial.
Hasil skrip

Tabel berikut mencantumkan nilai untuk output hasil skrip saat menggunakan tindakan Remove IP From Firewall Rule:

Nama hasil skrip Nilai
is_success true atau false

Menghapus Tag Jaringan

Gunakan tindakan Remove Network Tags untuk menghapus tag jaringan dari instance Compute Engine.

Tindakan ini tidak berjalan di entity Google SecOps.

Input tindakan

Tindakan Remove Network Tags memerlukan parameter berikut:

Parameter Deskripsi
Resource Name

Opsional.

Nama resource lengkap instance Compute Engine, dalam format /project/PROJECT_ID/zone/ ZONE_ID/instances/ INSTANCE_ID.

Parameter ini lebih diprioritaskan daripada Project ID, Instance Zone, dan Instance ID.
Project ID

Opsional.

ID project yang terkait dengan instance Compute Engine.

Jika tidak ada nilai yang diberikan, tindakan akan mengambil project ID dari konfigurasi integrasi.
Instance Zone

Opsional.

Zona spesifik tempat instance berada.

Parameter ini diperlukan jika Anda mengidentifikasi instance menggunakan Instance Zone dan Instance ID.
Instance ID

Opsional.

ID unik instance yang ingin Anda mulai.

Anda dapat mengambil nilai ini menggunakan tindakan List Instances.

Parameter ini diperlukan jika Anda mengidentifikasi instance menggunakan Instance Zone dan Instance ID.
Network Tags

Wajib.

Daftar tag jaringan yang dipisahkan koma untuk ditambahkan ke instance.

Semua tag hanya boleh berisi huruf kecil, angka, dan tanda hubung.

Output tindakan

Tindakan Remove Network Tags memberikan output berikut:

Jenis output tindakan Ketersediaan
Lampiran repositori kasus Tidak tersedia
Link repositori kasus Tidak tersedia
Tabel repositori kasus Tidak tersedia
Tabel pengayaan Tidak tersedia
Hasil JSON Tersedia
Pesan output Tersedia
Hasil skrip Tersedia
Hasil JSON

Contoh berikut menunjukkan output hasil JSON yang diterima saat menggunakan tindakan Contoh:

{
  "kind": "compute#instance",
  "id": "1459671903146615834",
  "creationTimestamp": "2023-09-13T04:20:21.993-07:00",
  "name": "instance-2",
  "description": "",
  "tags": {
    "items": [
      "another-tag",
      "tag"
    ],
    "fingerprint": "BCeEINC7Ths="
  },
  "machineType": "https://www.googleapis.com/compute/v1/projects/project-id/zones/us-central1-a/machineTypes/e2-micro",
  "status": "RUNNING",
  "zone": "https://www.googleapis.com/compute/v1/projects/project-id/zones/us-central1-a",
  "canIpForward": false,
  "networkInterfaces": [
    {
      "kind": "compute#networkInterface",
      "network": "https://www.googleapis.com/compute/v1/projects/project-id/global/networks/default",
      "subnetwork": "https://www.googleapis.com/compute/v1/projects/project-id/regions/us-central1/subnetworks/default",
      "networkIP": "10.128.0.3",
      "name": "nic0",
      "fingerprint": "-ZnnV7hiDfs=",
      "stackType": "IPV4_ONLY"
    }
  ],
  "disks": [
    {
      "kind": "compute#attachedDisk",
      "type": "PERSISTENT",
      "mode": "READ_WRITE",
      "source": "https://www.googleapis.com/compute/v1/projects/project-id/zones/us-central1-a/disks/instance-2",
      "deviceName": "instance-2",
      "index": 0,
      "boot": true,
      "autoDelete": true,
      "licenses": [
        "https://www.googleapis.com/compute/v1/projects/centos-cloud/global/licenses/centos-7"
      ],
      "interface": "SCSI",
      "guestOsFeatures": [
        {
          "type": "UEFI_COMPATIBLE"
        },
        {
          "type": "GVNIC"
        }
      ],
      "diskSizeGb": "20",
      "architecture": "X86_64"
    }
  ],
  "metadata": {
    "kind": "compute#metadata",
    "fingerprint": "NBmH4-7Jw9U=",
    "items": []
  },
  "serviceAccounts": [
    {
      "email": "1111111111-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/project-id/zones/us-central1-a/instances/instance-2",
  "scheduling": {
    "onHostMaintenance": "MIGRATE",
    "automaticRestart": true,
    "preemptible": false,
    "provisioningModel": "STANDARD"
  },
  "cpuPlatform": "Intel Broadwell",
  "deletionProtection": false,
  "shieldedInstanceConfig": {
    "enableSecureBoot": false,
    "enableVtpm": true,
    "enableIntegrityMonitoring": true
  }
}
Pesan output

Tindakan Remove Network Tags dapat menampilkan pesan output berikut:

Pesan output Deskripsi pesan

Successfully removed network tags from the instance RESOURCE_PATH in Compute Engine.

Waiting for the operation to finish execution on the RESOURCE_PATH instance in Compute Engine.

 Tindakan berhasil.
Error executing action "Remove Network Tags". Reason: ERROR_REASON

Tindakan gagal.

Periksa koneksi ke server, parameter input, atau kredensial.
Hasil skrip

Tabel berikut mencantumkan nilai untuk output hasil skrip saat menggunakan tindakan Remove Network Tags:

Nama hasil skrip Nilai
is_success true atau false

Menetapkan Kebijakan IAM Instance

Gunakan tindakan Set Instance IAM Policy untuk menetapkan kebijakan kontrol akses untuk resource yang ditentukan. Kebijakan yang Anda berikan dalam tindakan akan menggantikan kebijakan yang ada.

Tindakan ini tidak berjalan di entity Google SecOps.

Input tindakan

Tindakan Set Instance IAM Policy memerlukan parameter berikut:

Parameter Deskripsi
Resource Name

Opsional.

Nama resource lengkap instance Compute Engine, dalam format /project/PROJECT_ID/zone/ ZONE_ID/instances/ INSTANCE_ID.

Parameter ini lebih diprioritaskan daripada Project ID, Instance Zone, dan Instance ID.
Project ID

Opsional.

ID project yang terkait dengan instance Compute Engine.

Jika tidak ada nilai yang diberikan, tindakan akan mengambil project ID dari konfigurasi integrasi.
Instance Zone

Opsional.

Zona spesifik tempat instance berada.

Parameter ini diperlukan jika Anda mengidentifikasi instance menggunakan Instance Zone dan Instance ID.
Instance ID

Opsional.

ID unik instance yang ingin Anda mulai.

Anda dapat mengambil nilai ini menggunakan tindakan List Instances.

Parameter ini diperlukan jika Anda mengidentifikasi instance menggunakan Instance Zone dan Instance ID.
Policy

Wajib.

Dokumen kebijakan IAM yang akan diterapkan ke instance, yang disediakan sebagai objek JSON.

Output tindakan

Tindakan Set Instance IAM Policy memberikan output berikut:

Jenis output tindakan Ketersediaan
Lampiran repositori kasus Tidak tersedia
Link repositori kasus Tidak tersedia
Tabel repositori kasus Tidak tersedia
Tabel pengayaan Tidak tersedia
Hasil JSON Tersedia
Pesan output Tersedia
Hasil skrip Tersedia
Hasil JSON

Contoh berikut menjelaskan output hasil JSON yang diterima saat menggunakan tindakan Set Instance IAM Policy:

{
    "version": 1,
    "etag": "BwXBftu99FE=",
    "bindings": [
        {
            "role": "roles/compute.networkViewer",
            "members": [
                "user:user@example.com"
            ]
        }
    ]
}
Pesan output

Tindakan Set Instance IAM Policy dapat menampilkan pesan output berikut:

Pesan output Deskripsi pesan

Successfully set new IAM policy for the Compute Engine instance INSTANCE_ID.

Provided instance zone ZONE_ID is not valid.

Provided instance ID INSTANCE_ID is not valid.

Provided policy JSON document POLICY is not valid.

 Tindakan berhasil.
Error executing action "Set Instance IAM Policy". Reason: ERROR_REASON

Provided resource RESOURCE is not valid.

Error executing action "Set Instance IAM Policy". Reason: "Resource Name" or "Instance Zone" and "Instance ID" needs to be provided.

Tindakan gagal.

Periksa koneksi ke server, parameter input, atau kredensial.
Hasil skrip

Tabel berikut mencantumkan nilai untuk output hasil skrip saat menggunakan tindakan Set Instance IAM Policy:

Nama hasil skrip Nilai
is_success true atau false

Memulai Instance

Gunakan tindakan Start Instance untuk mengaktifkan instance Compute Engine yang berada dalam status dihentikan atau dihentikan.

Tindakan ini tidak berjalan di entity Google SecOps.

Input tindakan

Tindakan Start Instance memerlukan parameter berikut:

Parameter Deskripsi
Resource Name

Opsional.

Nama resource lengkap instance Compute Engine, dalam format /project/PROJECT_ID/zone/ ZONE_ID/instances/ INSTANCE_ID.

Parameter ini lebih diprioritaskan daripada Project ID, Instance Zone, dan Instance ID.
Project ID

Opsional.

ID project yang terkait dengan instance Compute Engine.

Jika tidak ada nilai yang diberikan, tindakan akan mengambil project ID dari konfigurasi integrasi.
Instance Zone

Opsional.

Zona spesifik tempat instance berada.

Parameter ini diperlukan jika Anda mengidentifikasi instance menggunakan Instance Zone dan Instance ID.
Instance ID

Opsional.

ID unik instance yang ingin Anda mulai.

Anda dapat mengambil nilai ini menggunakan tindakan List Instances.

Parameter ini diperlukan jika Anda mengidentifikasi instance menggunakan Instance Zone dan Instance ID.

Output tindakan

Tindakan Start Instance memberikan output berikut:

Jenis output tindakan Ketersediaan
Lampiran repositori kasus Tidak tersedia
Link repositori kasus Tidak tersedia
Tabel repositori kasus Tidak tersedia
Tabel pengayaan Tidak tersedia
Hasil JSON Tersedia
Pesan output Tersedia
Hasil skrip Tersedia
Hasil JSON

Contoh berikut menjelaskan output hasil JSON yang diterima saat menggunakan tindakan Start Instance:

{
   "id": "ID",
   "name": "operation-OPERATION_ID",
   "zone": "https://www.googleapis.com/compute/v1/projects/PROJECT_ID/zones/us-central1-a",
   "operationType": "start",
   "targetLink": "https://www.googleapis.com/compute/v1/projects/PROJECT_ID/zones/us-central1-a/instances/INSTANCE_ID",
   "targetId": "INSTANCE_ID",
   "status": "DONE",
   "user": "user@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/PROJECT_ID/zones/us-central1-a/operations/operation-OPERATION_ID",
   "kind": "compute#operation"
}
Pesan output

Tindakan Start Instance dapat menampilkan pesan output berikut:

Pesan output Deskripsi pesan

Compute Engine instance RESOURCE_PATH was started successfully.

Provided instance zone ZONE_ID is not valid.

Provided instance ID is not valid.

 Tindakan berhasil.

Error executing action "Start Instance". Reason: ERROR_REASON

Error executing action "Start Instance". Reason: You should provide either "Resource name" or "Instance Zone" and "Instance ID" parameters.

Error executing action "Start Instance". Reason: Given resource name string does not match expected pattern.

Tindakan gagal.

Periksa koneksi ke server, parameter input, atau kredensial.
Hasil skrip

Tabel berikut mencantumkan nilai untuk output hasil skrip saat menggunakan tindakan Start Instance:

Nama hasil skrip Nilai
is_success true atau false

Menghentikan Instance

Gunakan tindakan Stop Instance untuk menonaktifkan instance Compute Engine yang sedang berjalan. Anda dapat memulai ulang instance yang dihentikan kapan saja.

Menghentikan instance akan menghentikan biaya penggunaan VM, tetapi biaya akan terus berlaku untuk resource terkait seperti persistent disk dan alamat IP statis, kecuali jika resource tersebut dihapus.

Tindakan ini tidak berjalan di entity Google SecOps.

Input tindakan

Tindakan Stop Instance memerlukan parameter berikut:

Parameter Deskripsi
Resource Name

Opsional.

Nama resource lengkap instance Compute Engine, dalam format /project/PROJECT_ID/zone/ ZONE_ID/instances/ INSTANCE_ID.

Parameter ini lebih diprioritaskan daripada Project ID, Instance Zone, dan Instance ID.
Project ID

Opsional.

ID project yang terkait dengan instance Compute Engine.

Jika tidak ada nilai yang diberikan, tindakan akan mengambil project ID dari konfigurasi integrasi.
Instance Zone

Opsional.

Zona spesifik tempat instance berada.

Parameter ini diperlukan jika Anda mengidentifikasi instance menggunakan Instance Zone dan Instance ID.
Instance ID

Opsional.

ID unik instance yang ingin Anda mulai.

Anda dapat mengambil nilai ini menggunakan tindakan List Instances.

Parameter ini diperlukan jika Anda mengidentifikasi instance menggunakan Instance Zone dan Instance ID.

Output tindakan

Tindakan Stop Instance memberikan output berikut:

Jenis output tindakan Ketersediaan
Lampiran repositori kasus Tidak tersedia
Link repositori kasus Tidak tersedia
Tabel repositori kasus Tidak tersedia
Tabel pengayaan Tidak tersedia
Hasil JSON Tersedia
Pesan output Tersedia
Hasil skrip Tersedia
Hasil JSON

Contoh berikut menjelaskan output hasil JSON yang diterima saat menggunakan tindakan Stop Instance:

{
   "id": "ID",
   "name": "operation-OPERATION_ID",
   "zone": "https://www.googleapis.com/compute/v1/projects/PROJECT_ID/zones/us-central1-a",
   "operationType": "stop",
   "targetLink": "https://www.googleapis.com/compute/v1/projects/PROJECT_ID/zones/us-central1-a/instances/INSTANCE_ID",
   "targetId": "INSTANCE_ID",
   "status": "RUNNING",
   "user": "user@example.com",
   "progress": 100,
   "insertTime": "2021-04-28T23:01:29.395-07:00",
   "startTime": "2021-04-28T23:01:29.397-07:00",
   "selfLink": "https://www.googleapis.com/compute/v1/projects/PROJECT_ID/zones/us-central1-a/operations/operation-OPERATION_ID",
   "kind": "compute#operation"
}
Pesan output

Tindakan Stop Instance dapat menampilkan pesan output berikut:

Pesan output Deskripsi pesan

Compute Engine instance INSTANCE_ID was stopped successfully.

Provided instance zone ZONE_ID is not valid.

Provided instance ID is not valid.

 Tindakan berhasil.
Error executing action "Stop Instance". Reason: ERROR_REASON

Tindakan gagal.

Periksa koneksi ke server, parameter input, atau kredensial.
Hasil skrip

Tabel berikut mencantumkan nilai untuk output hasil skrip saat menggunakan tindakan Stop Instance:

Nama hasil skrip Nilai
is_success true atau false

Memperbarui Aturan Firewall

Gunakan tindakan Update Firewall Rule untuk mengubah konfigurasi aturan firewall Compute Engine yang ada. Tindakan ini memungkinkan Anda memperbarui parameter tertentu sambil mempertahankan identitas aturan.

Tindakan ini tidak berjalan di entity Google SecOps.

Input tindakan

Tindakan Update Firewall Rule memerlukan parameter berikut:

Parameter Deskripsi
Firewall Rule

Opsional.

Nama aturan firewall tertentu yang akan diupdate.
Project ID

Opsional.

ID project yang terkait dengan instance Compute Engine.

Jika tidak ada nilai yang diberikan, tindakan akan mengambil project ID dari konfigurasi integrasi.
Resource Name

Opsional.

Nama resource lengkap instance Compute Engine, dalam format /projects/PROJECT_ID/global/ firewallsFIREWALL.

Parameter ini lebih diprioritaskan daripada Project ID dan Firewall Rule.
Source IP Ranges

Opsional.

Daftar rentang alamat IP sumber yang dipisahkan koma untuk aturan firewall.

Jika nilai none ditetapkan, tindakan ini akan menghapus semua rentang IP sumber yang ada dari aturan.

Jika tidak ada nilai yang diberikan, nilai yang ada tidak akan berubah.
Source Tags

Opsional.

Daftar tag jaringan sumber yang dipisahkan koma untuk diterapkan ke aturan.

Jika nilai none ditetapkan, tindakan ini akan menghapus semua tag sumber yang ada dari aturan.

Jika tidak ada nilai yang diberikan, nilai yang ada tidak akan berubah.
Source Service Accounts

Opsional.

Daftar akun layanan sumber yang dipisahkan koma untuk diterapkan ke aturan.

Jika nilai none ditetapkan, tindakan ini akan menghapus semua akun layanan sumber yang ada dari aturan.

Jika tidak ada nilai yang diberikan, nilai yang ada tidak akan berubah.
TCP Ports

Opsional.

Daftar port TCP atau rentang port yang dipisahkan koma untuk diizinkan atau ditolak.

Parameter ini mendukung nilai all dan none. Jika dikonfigurasi, tindakan ini akan memperbarui daftar protokol dan port aturan firewall dengan nilai ini.
UDP Ports

Opsional.

Daftar port atau rentang port UDP yang dipisahkan koma untuk diizinkan atau ditolak.

Parameter ini mendukung nilai all dan none. Jika dikonfigurasi, tindakan ini akan memperbarui protokol dan daftar port aturan firewall dengan nilai ini.
Other Protocols

Opsional.

Daftar protokol yang dipisahkan koma selain TCP dan UDP untuk disertakan dalam aturan.

Jika nilai none ditetapkan, tindakan akan memperbarui daftar protokol aturan firewall dengan nilai ini.
Destination IP Ranges

Opsional.

Daftar rentang alamat IP tujuan yang dipisahkan koma untuk aturan firewall.

Jika nilai none ditetapkan, tindakan akan menghapus semua rentang IP tujuan yang ada dari aturan.

Jika tidak ada nilai yang diberikan, nilai yang ada tidak akan berubah.

Output tindakan

Tindakan Update Firewall Rule memberikan output berikut:

Jenis output tindakan Ketersediaan
Lampiran repositori kasus Tidak tersedia
Link repositori kasus Tidak tersedia
Tabel repositori kasus Tidak tersedia
Tabel pengayaan Tidak tersedia
Hasil JSON Tersedia
Pesan output Tersedia
Hasil skrip Tersedia
Hasil JSON

Contoh berikut menjelaskan output hasil JSON yang diterima saat menggunakan tindakan Update Firewall Rule:

{
  "kind": "compute#operation",
  "id": "9160761312385876914",
  "name": "operation-1716223324528-618e5619d1f93-174eac81-6b38200d",
  "operationType": "patch",
  "targetLink": "https://www.googleapis.com/compute/v1/projects/project-id/global/firewalls/firewall-name",
  "targetId": "7886634413370691799",
  "status": "DONE",
  "user": "compute-admin@project-id.iam.gserviceaccount.com",
  "progress": 100,g
  "insertTime": "2024-05-20T09:42:05.150-07:00",
  "startTime": "2024-05-20T09:42:05.164-07:00",
  "endTime": "2024-05-20T09:42:09.381-07:00",
  "selfLink": "https://www.googleapis.com/compute/v1/projects/project-id/global/operations/operation-1716223324528-618e5619d1f93-174eac81-6b38200d",
  "firewall": {
    "kind": "compute#firewall",
    "id": "6297155974506248217",
    "creationTimestamp": "2023-09-13T07:28:06.690-07:00",
    "name": "firewall-name",
    "description": "",
    "network": "https://www.googleapis.com/compute/v1/projects/project-id/global/networks/vpc-network",
    "priority": 1000,
    "sourceRanges": [
      "0.0.0.0/0"
    ],
    "destinationRanges": [
      "0.0.0.0/21"
    ],
    "allowed": [
      {
        "IPProtocol": "tcp",
        "ports": [
          "22"
        ]
      }
    ],
    "direction": "INGRESS",
    "logConfig": {
      "enable": false
    },
    "disabled": false,
    "selfLink": "https://www.googleapis.com/compute/v1/projects/project-id/global/firewalls/firewall-name"
  }
}
Pesan output

Tindakan Update Firewall Rule dapat menampilkan pesan output berikut:

Pesan output Deskripsi pesan
Successfully updated firewall rule in Cloud Compute.

Updating firewall rule in Cloud Compute.

 Tindakan berhasil.
Error executing action "Update Firewall Rule". Reason: ERROR_REASON

Provided firewall name is not valid.

Action ran into a timeout during execution. Please increase the timeout in IDE.

You must provide at least some parameter to update the firewall rule with.

Tindakan gagal.

Periksa koneksi ke server, parameter input, atau kredensial.
Hasil skrip

Tabel berikut mencantumkan nilai untuk output hasil skrip saat menggunakan tindakan Update Firewall Rule:

Nama hasil skrip Nilai
is_success true atau false

Perlu bantuan lain? Dapatkan jawaban dari anggota Komunitas dan profesional Google SecOps.