Integra Compute Engine con Google SecOps

Questo documento spiega come integrare Compute Engine con Google Security Operations.

Casi d'uso

L'integrazione di Compute Engine utilizza le funzionalità di Google SecOps per supportare i seguenti casi d'uso:

  • Risposta automatica agli incidenti: isola automaticamente un'istanza Compute Engine compromessa dalla rete. Il contenimento automatizzato limita la diffusione dell'attacco, accelera i tempi di risposta e riduce il carico di lavoro del team di sicurezza.

  • Ricerca e indagine sulle minacce: automatizza la raccolta di log e telemetria di sicurezza dalle istanze Compute Engine in più progetti. L'analisi di questi dati consolidati consente la ricerca proattiva delle minacce e accelera le indagini automatizzando la raccolta dei dati.

  • Gestione delle vulnerabilità: integra gli strumenti di analisi delle vulnerabilità con Google SecOps per analizzare automaticamente le istanze di Compute Engine alla ricerca di vulnerabilità note. Genera ticket di correzione o applica patch alle vulnerabilità direttamente per ridurre il rischio di exploit e migliorare la security posture.

  • Automazione della conformità: automatizza la raccolta degli audit log e dei dati di configurazione dalle istanze Compute Engine per rispettare i requisiti normativi. Genera report e dashboard per i revisori per semplificare i report sulla conformità e ridurre il lavoro manuale.

  • Orchestrazione della sicurezza: orchestra i workflow di sicurezza su più serviziGoogle Cloud , tra cui Compute Engine. Ad esempio, attiva la creazione di una nuova regola firewall in risposta a un evento di sicurezza rilevato su un'istanza, per una security posture più coordinata e automatizzata.

Prima di iniziare

Prima di configurare l'integrazione di Compute Engine in Google SecOps, completa i seguenti passaggi preliminari:

  1. Crea e configura un ruolo personalizzato di Identity and Access Management.

  2. Crea un account di servizio.

  3. Scegli e configura uno dei seguenti metodi di autenticazione:

    • Opzione 1: Workload Identity (consigliata): questo metodo utilizza token di accesso temporanei di breve durata tramite la simulazione dell'identità dei account di servizio.

    • Opzione 2: chiave JSON del service account. Questo metodo si basa su un file di chiave secret statico e di lunga durata.

Crea un ruolo IAM personalizzato

Per fornire all'integrazione le autorizzazioni specifiche necessarie per gestire le tue istanze, crea un ruolo personalizzato:

  1. Nella console Google Cloud , vai a IAM e amministrazione > Ruoli.

    Vai a Ruoli.

  2. Fai clic su addCrea ruolo personalizzato.

  3. Fornisci un Titolo (ad esempio SecOps Compute Engine Integration), una Descrizione e un ID univoco.

  4. Imposta Fase di lancio del ruolo su Disponibilità generale.

  5. Fai clic su Aggiungi autorizzazioni e aggiungi quanto segue:

    • 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. Fai clic su Crea.

Crea un account di servizio

  1. Nella console Google Cloud , vai a IAM e amministrazione > Account di servizio.

    Vai a Service account

  2. Fai clic su addCrea service account.

  3. Inserisci un nome e una descrizione, quindi fai clic su Crea e continua.

  4. Nel passaggio Concedi a questo account di servizio l'accesso al progetto, assegna il ruolo personalizzato che hai creato.

  5. Fai clic su Fine. Prendi nota dell'indirizzo email del account di servizio.

Configura le credenziali di Workload Identity

Workload Identity è l'approccio consigliato perché utilizza token di accesso di breve durata che utilizzano la simulazione dell'identità dei account di servizio.

Identifica l'identità univoca dell'istanza

Per stabilire una connessione, devi concedere alla tua istanza Google SecOps l'autorizzazione per simulare l'identità del tuo account di servizio.

  1. In Google SecOps, vai a Content Hub > Integrazioni di risposta.

  2. Seleziona l'integrazione di Compute Engine e inserisci l'indirizzo email del service account in Workload Identity Email.

  3. Fai clic su Salva > Verifica. Il test dovrebbe non riuscire.

  4. Fai clic sul pulsante close_small accanto a Test e individua l'email di identità che inizia con gke-init-python@... o soar-python@....

  5. Copia questo indirizzo email univoco.

Autorizza l'identità dell'istanza in Google Cloud

  1. Nella console Google Cloud , vai a IAM e amministrazione > Account di servizio.

    Vai a Service account

  2. Seleziona il account di servizio di destinazione e vai a Autorizzazioni > Concedi l'accesso.

  3. Incolla l'indirizzo email univoco nel campo Nuove entità e assegna il ruolo Creatore token account di servizio (roles/iam.serviceAccountTokenCreator).

Configura una chiave JSON

I file di chiavi secret statici e di lunga durata richiedono la rotazione manuale. Utilizza questo metodo solo se l'autenticazione di Workload Identity non è disponibile.

  1. Nella console Google Cloud , vai a IAM e amministrazione > Account di servizio e seleziona il tuo service account.

    Vai a Service account

  2. Vai alla scheda Chiavi e fai clic su Aggiungi chiave > Crea nuova chiave.

  3. Seleziona JSON e fai clic su Crea. Il file viene scaricato automaticamente sul computer.

Configura i singoli parametri manuali

Se scegli di inserire le credenziali manualmente, tieni aperto il file della chiave JSON scaricato in un editor di testo per copiare i singoli valori richiesti nelle impostazioni di integrazione.

Parametri di integrazione

Per stabilire una connessione tra Google SecOps e Compute Engine, devi configurare i seguenti parametri. L'integrazione supporta tre percorsi di autenticazione distinti. Scegli uno dei seguenti metodi per fornire le credenziali:

  • Workload Identity: utilizza Workload Identity Email.
  • File JSON del service account: utilizza Service Account Json File Content per fornire l'intera chiave in una sola volta.
  • Parametri individuali manuali: utilizza campi separati copiati manualmente da una chiave JSON.
Parametro Descrizione
API Root

Facoltativo.

L'URL di base per l'API Compute Engine.

Il valore predefinito è https://compute.googleapis.com.
OS Config API Root

Facoltativo.

L'URL di base per l'API Cloud OS Config.

Il valore predefinito è https://osconfig.googleapis.com.
Workload Identity Email

Facoltativo.

L'indirizzo email client del tuo account di servizio. Utilizzalo per l'autenticazione di Workload Identity.
Service Account Json File Content

Facoltativo.

I contenuti completi del file JSON della chiave del account di servizio.

Se configurata, l'integrazione ignora i singoli parametri delle credenziali.
Project ID

Facoltativo.

L'ID del progetto Google Cloud da scegliere come target.

Se non viene fornito alcun valore, l'integrazione recupera l'ID dalle credenziali dell'account di servizio.
Verify SSL

Obbligatorio.

Convalida il certificato SSL per la connessione. Abilitato per impostazione predefinita.

Parametri delle credenziali individuali

Utilizza i seguenti parametri solo se inserisci manualmente le credenziali anziché utilizzare i contenuti completi del file JSON o un'Workload Identity.

Parametro Descrizione
Account Type

Facoltativo.

Il valore trovato nel campo type della chiave JSON (in genere service_account).
Private Key ID

Facoltativo.

Il valore trovato nel campo private_key_id della chiave JSON.
Private Key

Facoltativo.

Il valore trovato nel campo private_key della chiave JSON.
Client Email

Facoltativo.

Il valore trovato nel campo client_email della chiave JSON.
Client ID

Facoltativo.

Il valore trovato nel campo client_id della chiave JSON.
Auth URI

Facoltativo.

Il valore trovato nel campo auth_uri della chiave JSON.

Il valore predefinito è https://accounts.google.com/o/oauth2/auth.
Token URI

Facoltativo.

Il valore trovato nel campo token_uri della chiave JSON.

Il valore predefinito è https://oauth2.googleapis.com/token.
Auth Provider X509 URL

Facoltativo.

Il valore trovato nel campo auth_provider_x509_cert_url della chiave JSON.
Client X509 URL

Facoltativo.

Il valore trovato nel campo client_x509_cert_url della chiave JSON.

Per istruzioni su come configurare un'integrazione in Google SecOps, consulta Configura le integrazioni.

Se necessario, puoi apportare modifiche in un secondo momento. Dopo aver configurato un'istanza di integrazione, puoi utilizzarla nei playbook. Per saperne di più su come configurare e supportare più istanze, consulta Supporto di più istanze.

Azioni

Per saperne di più sulle azioni, consulta Rispondi alle azioni in attesa dalla scrivania di lavoro ed Esegui un'azione manuale nel tuo caso.

Aggiungi IP alla regola firewall

Utilizza l'azione Aggiungi intervallo IP alla regola firewall per aggiungere un intervallo IP a una regola firewall esistente all'interno di un'istanza Compute Engine.

Questa azione non viene eseguita sulle entità Google SecOps.

Input azione

L'azione Aggiungi IP alla regola firewall richiede i seguenti parametri:

Parametro Descrizione
Resource Name

Facoltativo.

Il nome completo della risorsa dell'istanza Compute Engine, nel formato /projects/PROJECT_ID/global/ firewallsFIREWALL.

Questo parametro ha la priorità su Project ID e Firewall Rule.
Project ID

Facoltativo.

Il nome del progetto associato all'istanza Compute Engine.

Se non viene fornito alcun valore, l'azione utilizza l'ID progetto della configurazione dell'integrazione.
Firewall Rule

Facoltativo.

Il nome della regola firewall specifica da aggiornare.
Type

Obbligatorio.

La direzione del traffico per l'intervallo IP che stai aggiungendo.

I valori possibili sono:

  • Source
  • Destination

Il valore predefinito è Source.
IP Ranges

Obbligatorio.

Un elenco separato da virgole di intervalli di indirizzi IP (notazione CIDR) da aggiungere alla regola firewall.

Output azione

L'azione Aggiungi IP alla regola firewall fornisce i seguenti output:

Tipo di output dell'azione Disponibilità
Allegato della bacheca richieste Non disponibile
Link alla bacheca casi Non disponibile
Tabella della bacheca casi Non disponibile
Tabella di arricchimento Non disponibile
Risultato JSON Disponibile
Messaggi di output Disponibile
Risultato dello script Disponibile
Risultato JSON

L'esempio seguente mostra l'output del risultato JSON ricevuto quando utilizzi l'azione Aggiungi IP alla regola firewall:

{
  "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"
  }
}
Messaggi di output

L'azione Aggiungi IP alla regola firewall può restituire i seguenti messaggi di output:

Messaggio di output Descrizione del messaggio

Successfully updated firewall rule in Google Cloud Compute.

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

 L'azione è andata a buon fine.
Error executing action "Add IP To Firewall Rule". Reason: ERROR_REASON

L'azione non è andata a buon fine.

Controlla la connessione al server, i parametri di input o le credenziali.
Risultato dello script

La tabella seguente elenca il valore per l'output del risultato dello script quando utilizzi l'azione Aggiungi IP alla regola firewall:

Nome del risultato dello script Valore
is_success true o false

Aggiungi etichette all'istanza

Utilizza l'azione Aggiungi etichette all'istanza per aggiungere o aggiornare le etichette su un'istanza Compute Engine specifica.

Questa azione non viene eseguita sulle entità Google SecOps.

Input azione

L'azione Aggiungi etichette all'istanza richiede i seguenti parametri:

Parametro Descrizione
Resource Name

Facoltativo.

Il nome completo della risorsa dell'istanza Compute Engine, nel formato /project/PROJECT_ID/zone/ ZONE_ID/instances/ INSTANCE_ID.

Questo parametro ha la priorità su Project ID, Instance Zone e Instance ID.
Project ID

Facoltativo.

L'ID del progetto associato all'istanza Compute Engine.

Se non viene fornito alcun valore, l'azione recupera l'ID progetto dalla configurazione dell'integrazione.
Instance Zone

Facoltativo.

La zona specifica in cui si trova l'istanza.

Questo parametro è obbligatorio se identifichi l'istanza utilizzando Instance Zone e Instance ID.
Instance ID

Facoltativo.

L'ID univoco dell'istanza Compute Engine.

Questo parametro è obbligatorio se identifichi l'istanza utilizzando Instance Zone e Instance ID.
Instance Labels

Obbligatorio.

Un elenco separato da virgole di etichette da applicare all'istanza, nel formato key:value (ad esempio vm_label_key:label1).

Output azione

L'azione Aggiungi etichette all'istanza fornisce i seguenti output:

Tipo di output dell'azione Disponibilità
Allegato della bacheca richieste Non disponibile
Link alla bacheca casi Non disponibile
Tabella della bacheca casi Non disponibile
Tabella di arricchimento Non disponibile
Risultato JSON Disponibile
Messaggi di output Disponibile
Risultato dello script Disponibile
Risultato JSON

L'esempio seguente descrive l'output del risultato JSON ricevuto quando utilizzi l'azione Aggiungi etichette all'istanza:

{
   "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"
}
Messaggi di output

L'azione Aggiungi etichette all'istanza può restituire i seguenti messaggi di output:

Messaggio di output Descrizione del messaggio

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.

 L'azione è andata a buon fine.
Error executing action "Add Labels to Instance". Reason: ERROR_REASON

L'azione non è andata a buon fine.

Controlla la connessione al server, i parametri di input o le credenziali.
Risultato dello script

La tabella seguente elenca il valore per l'output del risultato dello script quando utilizzi l'azione Aggiungi etichette all'istanza:

Nome del risultato dello script Valore
is_success true o false

Aggiungi tag di rete

Utilizza l'azione Aggiungi tag di rete per aggiungere uno o più tag di rete a un'istanza Compute Engine specifica.

Questa azione non viene eseguita sulle entità Google SecOps.

Input azione

L'azione Aggiungi tag di rete richiede i seguenti parametri:

Parametro Descrizione
Resource Name

Facoltativo.

Il nome completo della risorsa dell'istanza Compute Engine, nel formato /project/PROJECT_ID/zone/ ZONE_ID/instances/ INSTANCE_ID.

Questo parametro ha la priorità su Project ID, Instance Zone e Instance ID.
Project ID

Facoltativo.

L'ID del progetto associato all'istanza Compute Engine.

Se non viene fornito alcun valore, l'azione recupera l'ID progetto dalla configurazione dell'integrazione.
Instance Zone

Facoltativo.

La zona specifica in cui si trova l'istanza.

Questo parametro è obbligatorio se identifichi l'istanza utilizzando Instance Zone e Instance ID.
Instance ID

Facoltativo.

L'ID univoco dell'istanza Compute Engine.

Questo parametro è obbligatorio se identifichi l'istanza utilizzando Instance Zone e Instance ID.
Network Tags

Obbligatorio.

Un elenco separato da virgole di tag di rete da aggiungere all'istanza.

Tutti i tag devono contenere solo lettere minuscole, numeri e trattini.

Output azione

L'azione Aggiungi tag di rete fornisce i seguenti output:

Tipo di output dell'azione Disponibilità
Allegato della bacheca richieste Non disponibile
Link alla bacheca casi Non disponibile
Tabella della bacheca casi Non disponibile
Tabella di arricchimento Non disponibile
Risultato JSON Disponibile
Messaggi di output Disponibile
Risultato dello script Disponibile
Risultato JSON

L'esempio seguente mostra l'output del risultato JSON ricevuto quando utilizzi l'azione Aggiungi tag di rete:

{
  "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
  }
}
Messaggi di output

L'azione Aggiungi tag di rete può restituire i seguenti messaggi di output:

Messaggio di output Descrizione del messaggio

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.

 L'azione è andata a buon fine.
Error executing action "Add Network Tags". Reason: ERROR_REASON

L'azione non è andata a buon fine.

Controlla la connessione al server, i parametri di input o le credenziali.
Risultato dello script

La tabella seguente elenca il valore per l'output del risultato dello script quando utilizzi l'azione Aggiungi tag di rete:

Nome del risultato dello script Valore
is_success true o false

Elimina istanza

Utilizza l'azione Elimina istanza per eliminare le istanze Compute Engine.

Questa azione non viene eseguita sulle entità Google SecOps.

Input azione

L'azione Elimina istanza richiede i seguenti parametri:

Parametro Descrizione
Resource Name

Facoltativo.

Il nome completo della risorsa dell'istanza Compute Engine, nel formato /project/PROJECT_ID/zone/ ZONE_ID/instances/ INSTANCE_ID.

Questo parametro ha la priorità su Project ID, Instance Zone e Instance ID.
Project ID

Facoltativo.

L'ID del progetto associato all'istanza Compute Engine.

Se non viene fornito alcun valore, l'azione recupera l'ID progetto dalla configurazione dell'integrazione.
Instance Zone

Facoltativo.

La zona specifica in cui si trova l'istanza.

Questo parametro è obbligatorio se identifichi l'istanza utilizzando Instance Zone e Instance ID.
Instance ID

Facoltativo.

L'ID univoco dell'istanza che vuoi avviare.

Puoi recuperare questo valore utilizzando l'azione Elenca istanze.

Questo parametro è obbligatorio se identifichi l'istanza utilizzando Instance Zone e Instance ID.

Output azione

L'azione Elimina istanza fornisce i seguenti output:

Tipo di output dell'azione Disponibilità
Allegato della bacheca richieste Non disponibile
Link alla bacheca casi Non disponibile
Tabella della bacheca casi Non disponibile
Tabella di arricchimento Non disponibile
Risultato JSON Disponibile
Messaggi di output Disponibile
Risultato dello script Disponibile
Risultato JSON

L'esempio seguente descrive l'output del risultato JSON ricevuto quando utilizzi l'azione Elimina istanza:

{
   "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"
}
Messaggi di output

L'azione Elimina istanza può restituire i seguenti messaggi di output:

Messaggio di output Descrizione del messaggio

Compute Engine instance INSTANCE_ID was deleted successfully.

Provided instance zone ZONE_ID is not valid.

Provided instance ID is not valid.

 L'azione è andata a buon fine.

Error executing action "Start Instance". Reason: ERROR_REASON

Provided resource RESOURCE_PATH is not valid

L'azione non è andata a buon fine.

Controlla la connessione al server, i parametri di input o le credenziali.
Risultato dello script

La tabella seguente elenca il valore per l'output del risultato dello script quando utilizzi l'azione Elimina istanza:

Nome del risultato dello script Valore
is_success true o false

Arricchisci le entità

Utilizza l'azione Arricchisci entità per arricchire le entità Google SecOps IP Address con le informazioni sull'istanza di Compute Engine.

Questa azione viene eseguita sulle seguenti entità Google SecOps:

  • IP Address

Input azione

L'azione Arricchisci entità richiede i seguenti parametri:

Parametri Descrizione
Project ID

Facoltativo.

L'ID del progetto associato all'istanza Compute Engine.

Se non viene fornito alcun valore, l'azione recupera l'ID progetto dalla configurazione dell'integrazione.
Instance Zone

Facoltativo.

La zona specifica in cui si trova l'istanza.

Output azione

L'azione Arricchisci entità fornisce i seguenti output:

Tipo di output dell'azione Disponibilità
Allegato della bacheca richieste Non disponibile
Link alla bacheca casi Non disponibile
Tabella della bacheca casi Disponibile
Tabella di arricchimento Disponibile
Risultato JSON Disponibile
Messaggi di output Disponibile
Risultato dello script Disponibile
Tabella della bacheca casi

Al termine dell'esecuzione, l'azione Arricchisci entità fornisce la seguente tabella:

Nome tabella: Tabella di arricchimento ENTITY

Colonne:

  • Campo entità
  • Valore
Tabella di arricchimento

L'azione Enrich Entities supporta il seguente arricchimento delle entità:

Campo di arricchimento Origine (chiave JSON) Logica
Google_Compute_instance_id id Non disponibile
Google_Compute_creation_timestamp creationTimestamp Non disponibile
Google_Compute_instance_name name Non disponibile
Google_Compute_description description Non disponibile
Google_Compute_tags tags Fornisci i tag in un elenco CSV
Google_Compute_machine_type machineType Non disponibile
Google_Compute_instance_status status Non disponibile
Google_Compute_instance_zone zone Non disponibile
Google_Compute_can_ip_forward canIpForward Non disponibile
Google_Compute_instance_network_interfaces_name_INDEX networkInterfaces.name Espandi se sono disponibili più interfacce di rete
Google_Compute_instance_network_interfaces_name_access_configs_type_INDEX networkInterfaces.accessConfigs.type Espandi se sono disponibili più interfacce di rete
Google_Compute_instance_network_interfaces_name_access_configs_name_INDEX networkInterfaces.accessConfigs.name Espandi se sono disponibili più interfacce di rete
Google_Compute_instance_network_interfaces_name_access_configs_natIP_INDEX networkInterfaces.accessConfigs.natIP Espandi se sono disponibili più interfacce di rete
Google_Compute_instance_metadata metadata Elenco CSV di valori dai metadati dell'istanza
Google_Compute_service_account_INDEX serviceAccounts.email Espandi se sono disponibili altri service account
Google_Compute_service_account_scopes_INDEX serviceAccounts.scopes Espandi se sono disponibili altri service account
Google_Compute_link_to_Google_Compute selfLink Non disponibile
Google_Compute_labels labels Fornisci un elenco di valori in formato CSV
Google_Compute_instance_last_start_timestamp lastStartTimestamp Non disponibile
Google_Compute_instance_last_stop_timestamp lastStopTimestamp Non disponibile
Risultato JSON

L'esempio seguente descrive l'output del risultato JSON ricevuto quando utilizzi l'azione Arricchisci entità:

{
    "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"
}
Messaggi di output

L'azione Arricchisci entità può restituire i seguenti messaggi di output:

Messaggio di output Descrizione del messaggio

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.

 L'azione è andata a buon fine.
Error executing action "Enrich Entities". Reason: ERROR_REASON

L'azione non è andata a buon fine.

Controlla la connessione al server, i parametri di input o le credenziali.
Risultato dello script

La tabella seguente elenca il valore per l'output del risultato dello script quando utilizzi l'azione Arricchisci entità:

Nome del risultato dello script Valore
is_success true o false

Esegui job di applicazione patch della VM

Utilizza l'azione Esegui job di applicazione patch VM per eseguire un job di applicazione patch VM sulle istanze di Compute Engine.

Questa azione non viene eseguita sulle entità Google SecOps.

Input azione

L'azione Esegui job di applicazione patch alla VM richiede i seguenti parametri:

Parametro Descrizione
Instance Filter Object

Obbligatorio.

L'oggetto JSON utilizzato per scegliere come target istanze specifiche per l'applicazione di patch.

Il valore predefinito ha come target tutte le istanze:

{
  "all": "true"
}
Name

Obbligatorio.

Il nome univoco del job di applicazione patch.
Description

Facoltativo.

Una breve descrizione dello scopo del job di applicazione patch.
Patching Config Object

Facoltativo.

Un oggetto JSON che definisce i passaggi e le configurazioni di aggiornamento specifici per i diversi sistemi operativi.

Se non viene fornito alcun valore, l'azione utilizza il seguente valore predefinito:

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

Obbligatorio.

Il tempo massimo, in minuti, consentito per l'esecuzione del job di applicazione patch.

Il valore predefinito è 60.
Rollout Strategy

Facoltativo.

Il metodo utilizzato per eseguire il deployment della patch in più zone.

I valori possibili sono:

  • Zone By Zone: Le patch vengono applicate a una zona alla volta per ridurre al minimo il rischio.
  • Concurrent Zones: Le patch vengono applicate simultaneamente a tutte le zone interessate per ridurre il periodo di manutenzione totale.

Il valore predefinito è Zone By Zone.
Disruption Budget

Obbligatorio.

Il numero o la percentuale di istanze che possono essere offline contemporaneamente (ad esempio, 5 o 10%).

Il valore predefinito è 10%.
Wait For Completion

Obbligatorio.

Se selezionata, l'azione rimane attiva fino al termine del job di applicazione patch.

Abilitato per impostazione predefinita.
Fail If Completed With Errors

Obbligatorio.

Se selezionata, l'azione non va a buon fine se lo stato del job è Completed with errors o se raggiunge il limite di timeout.

Questo parametro viene ignorato se Wait For Completion è disattivato.

Abilitato per impostazione predefinita.

Output azione

L'azione Esegui job di applicazione patch VM fornisce i seguenti output:

Tipo di output dell'azione Disponibilità
Allegato della bacheca richieste Non disponibile
Link alla bacheca casi Non disponibile
Tabella della bacheca casi Non disponibile
Tabella di arricchimento Non disponibile
Risultato JSON Disponibile
Messaggi di output Disponibile
Risultato dello script Disponibile
Risultato JSON

L'esempio seguente mostra l'output del risultato JSON ricevuto quando utilizzi l'azione Esegui job di applicazione patch della VM:

{
            "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
                }
            }
        }
Messaggi di output

L'azione Esegui job di applicazione patch alla VM può restituire i seguenti messaggi di output:

Messaggio di output Descrizione del messaggio

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

 L'azione è andata a buon fine.
Error executing action "Execute VM Patch Job". Reason: ERROR_REASON

L'azione non è andata a buon fine.

Controlla la connessione al server, i parametri di input o le credenziali.
Risultato dello script

La tabella seguente elenca il valore per l'output del risultato dello script quando utilizzi l'azione Esegui job di applicazione patch VM:

Nome del risultato dello script Valore
is_success true o false

Ottieni policy IAM dell'istanza

Utilizza l'azione Ottieni policy IAM dell'istanza per recuperare la policy di controllo dell'accesso di Identity and Access Management (iam_name_short) per una risorsa Compute Engine specifica.

Questa azione non viene eseguita sulle entità Google SecOps.

Input azione

L'azione Recupera policy IAM dell'istanza richiede i seguenti parametri:

Parametro Descrizione
Resource Name

Facoltativo.

Il nome completo della risorsa dell'istanza Compute Engine, nel formato /project/PROJECT_ID/zone/ ZONE_ID/instances/ INSTANCE_ID.

Questo parametro ha la priorità su Project ID, Instance Zone e Instance ID.
Project ID

Facoltativo.

L'ID del progetto associato all'istanza Compute Engine.

Se non viene fornito alcun valore, l'azione recupera l'ID progetto dalla configurazione dell'integrazione.
Instance Zone

Facoltativo.

La zona specifica in cui si trova l'istanza.

Questo parametro è obbligatorio se identifichi l'istanza utilizzando Instance Zone e Instance ID.
Instance ID

Facoltativo.

L'ID univoco dell'istanza che vuoi avviare.

Puoi recuperare questo valore utilizzando l'azione Elenca istanze.

Questo parametro è obbligatorio se identifichi l'istanza utilizzando Instance Zone e Instance ID.

Output azione

L'azione Recupera policy IAM dell'istanza fornisce i seguenti output:

Tipo di output dell'azione Disponibilità
Allegato della bacheca richieste Non disponibile
Link alla bacheca casi Non disponibile
Tabella della bacheca casi Non disponibile
Tabella di arricchimento Non disponibile
Risultato JSON Disponibile
Messaggi di output Disponibile
Risultato dello script Disponibile
Risultato JSON

L'esempio seguente descrive l'output del risultato JSON ricevuto quando utilizzi l'azione Recupera policy IAM dell'istanza:

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

L'azione Recupera policy IAM dell'istanza può restituire i seguenti messaggi di output:

Messaggio di output Descrizione del messaggio

Compute Engine instance INSTANCE_ID IAM policy was fetched successfully.

Provided instance zone ZONE_ID is not valid.

Provided instance ID is not valid.

 L'azione è andata a buon fine.
Error executing action "Get Instance IAM Policy". Reason: ERROR_REASON

L'azione non è andata a buon fine.

Controlla la connessione al server, i parametri di input o le credenziali.
Risultato dello script

La tabella seguente elenca il valore per l'output del risultato dello script quando utilizzi l'azione Recupera policy IAM dell'istanza:

Nome del risultato dello script Valore
is_success true o false

Elenco istanze

Utilizza l'azione Elenca istanze per elencare le istanze di Compute Engine in base ai criteri di ricerca specificati.

Questa azione non viene eseguita sulle entità Google SecOps.

Input azione

L'azione Elenca istanze richiede i seguenti parametri:

Parametro Descrizione
Project ID

Facoltativo.

L'ID del progetto da cui elencare le istanze.

Se non viene fornito alcun valore, l'azione recupera l'ID progetto dal service account Google Cloud utilizzato nella configurazione dell'integrazione.
Instance Zone

Facoltativo.

La zona specifica in cui cercare le istanze.

Se non viene fornito alcun valore, l'azione esegue la ricerca in tutte le zone disponibili.
Instance Name

Facoltativo.

Il nome dell'istanza da cercare.

Questo parametro accetta più valori sotto forma di stringa separata da virgole.
Instance Status

Facoltativo.

Lo stato attuale delle istanze da includere nei risultati di ricerca, ad esempio RUNNING o TERMINATED.

Questo parametro accetta più valori sotto forma di stringa separata da virgole.
Instance Labels

Facoltativo.

Le etichette utilizzate per filtrare i risultati dell'istanza, fornite nel formato key:value (ad esempio env:production).

Questo parametro accetta più valori sotto forma di stringa separata da virgole.
Max Rows to Return

Facoltativo.

Il numero massimo di istanze da restituire nei risultati.

Il valore predefinito è 50.

Output azione

L'azione Elenca istanze fornisce i seguenti output:

Tipo di output dell'azione Disponibilità
Allegato della bacheca richieste Non disponibile
Link alla bacheca casi Non disponibile
Tabella della bacheca casi Disponibile
Tabella di arricchimento Non disponibile
Risultato JSON Disponibile
Messaggi di output Disponibile
Risultato dello script Disponibile
Tabella della bacheca casi

L'azione Elenca istanze fornisce la seguente tabella:

Nome tabella: Istanze di Compute Engine

Colonne della tabella:

  • Nome istanza
  • ID istanza
  • Data/ora di creazione dell'istanza
  • Descrizione dell'istanza
  • Tipo di istanza
  • Stato dell'istanza
  • Etichette delle istanze
Risultato JSON

L'esempio seguente descrive l'output del risultato JSON ricevuto quando utilizzi l'azione Elenca istanze:

{ "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"
       }
   ]
}
Messaggi di output

L'azione Elenca istanze può restituire i seguenti messaggi di output:

Messaggio di output Descrizione del messaggio

Successfully fetched Compute Engine instances.

Provided instance zone ZONE_ID is not valid.

No instances were found in Compute Engine.

 L'azione è andata a buon fine.
Error executing action "List Instances". Reason: ERROR_REASON

L'azione non è andata a buon fine.

Controlla la connessione al server, i parametri di input o le credenziali.
Risultato dello script

La tabella seguente elenca il valore per l'output del risultato dello script quando utilizzi l'azione Elenca istanze:

Nome del risultato dello script Valore
is_success true o false

Dindin

Utilizza l'azione Ping per testare la connettività a Compute Engine.

Questa azione non viene eseguita sulle entità Google SecOps.

Input azione

Nessuno.

Output azione

L'azione Ping fornisce i seguenti output:

Tipo di output dell'azione Disponibilità
Allegato della bacheca richieste Non disponibile
Link alla bacheca casi Non disponibile
Tabella della bacheca casi Non disponibile
Tabella di arricchimento Non disponibile
Risultato JSON Non disponibile
Messaggi di output Disponibile
Risultato dello script Disponibile
Messaggi di output

L'azione Ping può restituire i seguenti messaggi di output:

Messaggio di output Descrizione del messaggio
Successfully connected to the Compute Engine service with the provided connection parameters! L'azione è andata a buon fine.
Failed to connect to the Compute Engine service! Error is ERROR_REASON

L'azione non è andata a buon fine.

Controlla la connessione al server, i parametri di input o le credenziali.
Risultato dello script

La tabella seguente elenca il valore per l'output del risultato dello script quando utilizzi l'azione Ping:

Nome del risultato dello script Valore
is_success true o false

Rimuovi indirizzi IP esterni

Utilizza l'azione Rimuovi indirizzi IP esterni per rimuovere gli indirizzi IP esterni su un'istanza Compute Engine.

Questa azione non viene eseguita sulle entità Google SecOps.

Input azione

L'azione Rimuovi indirizzi IP esterni richiede i seguenti parametri:

Parametri Descrizione
Resource Name

Facoltativo.

Il nome completo della risorsa dell'istanza Compute Engine, nel formato /project/PROJECT_ID/zone/ ZONE_ID/instances/ INSTANCE_ID.

Questo parametro ha la priorità su Project ID, Instance Zone e Instance ID.
Project ID

Facoltativo.

L'ID del progetto associato all'istanza Compute Engine.

Se non viene fornito alcun valore, l'azione recupera l'ID progetto dalla configurazione dell'integrazione.
Instance Zone

Facoltativo.

La zona specifica in cui si trova l'istanza.

Questo parametro è obbligatorio se identifichi l'istanza utilizzando Instance Zone e Instance ID.
Instance ID

Facoltativo.

L'ID univoco dell'istanza che vuoi avviare.

Puoi recuperare questo valore utilizzando l'azione Elenca istanze.

Questo parametro è obbligatorio se identifichi l'istanza utilizzando Instance Zone e Instance ID.
Network Interfaces

Facoltativo.

Un elenco separato da virgole delle interfacce di rete specifiche da modificare.

Se non viene fornito alcun valore o se utilizzi il carattere jolly *, l'azione aggiorna tutte le interfacce di rete.

Il valore predefinito è *.

Output azione

L'azione Rimuovi indirizzi IP esterni fornisce i seguenti output:

Tipo di output dell'azione Disponibilità
Allegato della bacheca richieste Non disponibile
Link alla bacheca casi Non disponibile
Tabella della bacheca casi Non disponibile
Tabella di arricchimento Non disponibile
Risultato JSON Disponibile
Messaggi di output Disponibile
Risultato dello script Disponibile
Risultato JSON

L'esempio seguente descrive l'output del risultato JSON ricevuto quando utilizzi l'azione Rimuovi indirizzi IP esterni:

[
    {
        "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"
    }
]
Messaggi di output

L'azione Rimuovi indirizzi IP esterni può restituire i seguenti messaggi di output:

Messaggio di output Descrizione del messaggio

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.

 L'azione è andata a buon fine.

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.

L'azione non è andata a buon fine.

Controlla la connessione al server, i parametri di input o le credenziali.
Risultato dello script

La tabella seguente elenca il valore per l'output del risultato dello script quando utilizzi l'azione Rimuovi indirizzi IP esterni:

Nome del risultato dello script Valore
is_success true o false

Rimuovi IP dalla regola firewall

Utilizza l'azione Rimuovi IP dalla regola firewall per eliminare intervalli di indirizzi IP specifici da una regola firewall di Compute Engine esistente.

Questa azione non viene eseguita sulle entità Google SecOps.

Input azione

L'azione Rimuovi IP dalla regola firewall richiede i seguenti parametri:

Parametro Descrizione
Resource Name

Facoltativo.

Il nome completo della risorsa dell'istanza Compute Engine, nel formato /projects/PROJECT_ID/global/ firewallsFIREWALL.

Questo parametro ha la priorità su Project ID e Firewall Rule.
Project ID

Facoltativo.

L'ID del progetto associato all'istanza Compute Engine.

Se non viene fornito alcun valore, l'azione recupera l'ID progetto dalla configurazione dell'integrazione.
Firewall Rule

Facoltativo.

Il nome della regola firewall specifica da aggiornare.
Type

Obbligatorio.

La direzione del traffico per l'intervallo IP che stai aggiungendo.

I valori possibili sono:

  • Source
  • Destination

Il valore predefinito è Source.
IP Ranges

Obbligatorio.

Un elenco separato da virgole di intervalli di indirizzi IP (notazione CIDR) da aggiungere alla regola firewall.

Output azione

L'azione Rimuovi IP dalla regola firewall fornisce i seguenti output:

Tipo di output dell'azione Disponibilità
Allegato della bacheca richieste Non disponibile
Link alla bacheca casi Non disponibile
Tabella della bacheca casi Non disponibile
Tabella di arricchimento Non disponibile
Risultato JSON Disponibile
Messaggi di output Disponibile
Risultato dello script Disponibile
Risultato JSON

L'esempio seguente mostra l'output del risultato JSON ricevuto quando utilizzi l'azione Rimuovi IP dalla regola firewall:

{
  "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"
  }
}
Messaggi di output

L'azione Rimuovi IP dalla regola firewall può restituire i seguenti messaggi di output:

Messaggio di output Descrizione del messaggio

Successfully updated firewall rule in Google Cloud Compute.

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

 L'azione è andata a buon fine.
Error executing action "Remove IP From Firewall Rule". Reason: ERROR_REASON

L'azione non è andata a buon fine.

Controlla la connessione al server, i parametri di input o le credenziali.
Risultato dello script

La tabella seguente elenca il valore per l'output del risultato dello script quando utilizzi l'azione Rimuovi IP dalla regola firewall:

Nome del risultato dello script Valore
is_success true o false

Rimuovi tag di rete

Utilizza l'azione Rimuovi tag di rete per rimuovere i tag di rete dall'istanza Compute Engine.

Questa azione non viene eseguita sulle entità Google SecOps.

Input azione

L'azione Rimuovi tag di rete richiede i seguenti parametri:

Parametro Descrizione
Resource Name

Facoltativo.

Il nome completo della risorsa dell'istanza Compute Engine, nel formato /project/PROJECT_ID/zone/ ZONE_ID/instances/ INSTANCE_ID.

Questo parametro ha la priorità su Project ID, Instance Zone e Instance ID.
Project ID

Facoltativo.

L'ID del progetto associato all'istanza Compute Engine.

Se non viene fornito alcun valore, l'azione recupera l'ID progetto dalla configurazione dell'integrazione.
Instance Zone

Facoltativo.

La zona specifica in cui si trova l'istanza.

Questo parametro è obbligatorio se identifichi l'istanza utilizzando Instance Zone e Instance ID.
Instance ID

Facoltativo.

L'ID univoco dell'istanza che vuoi avviare.

Puoi recuperare questo valore utilizzando l'azione Elenca istanze.

Questo parametro è obbligatorio se identifichi l'istanza utilizzando Instance Zone e Instance ID.
Network Tags

Obbligatorio.

Un elenco separato da virgole di tag di rete da aggiungere all'istanza.

Tutti i tag devono contenere solo lettere minuscole, numeri e trattini.

Output azione

L'azione Rimuovi tag di rete fornisce i seguenti output:

Tipo di output dell'azione Disponibilità
Allegato della bacheca richieste Non disponibile
Link alla bacheca casi Non disponibile
Tabella della bacheca casi Non disponibile
Tabella di arricchimento Non disponibile
Risultato JSON Disponibile
Messaggi di output Disponibile
Risultato dello script Disponibile
Risultato JSON

L'esempio seguente mostra l'output del risultato JSON ricevuto quando utilizzi l'azione Example:

{
  "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
  }
}
Messaggi di output

L'azione Rimuovi tag di rete può restituire i seguenti messaggi di output:

Messaggio di output Descrizione del messaggio

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.

 L'azione è andata a buon fine.
Error executing action "Remove Network Tags". Reason: ERROR_REASON

L'azione non è andata a buon fine.

Controlla la connessione al server, i parametri di input o le credenziali.
Risultato dello script

La tabella seguente elenca il valore per l'output del risultato dello script quando utilizzi l'azione Rimuovi tag di rete:

Nome del risultato dello script Valore
is_success true o false

Imposta policy IAM dell'istanza

Utilizza l'azione Imposta policy IAM dell'istanza per impostare la policy di controllo degli accessi per la risorsa specificata. La policy fornita nell'azione sostituisce qualsiasi policy esistente.

Questa azione non viene eseguita sulle entità Google SecOps.

Input azione

L'azione Imposta policy IAM dell'istanza richiede i seguenti parametri:

Parametri Descrizione
Resource Name

Facoltativo.

Il nome completo della risorsa dell'istanza Compute Engine, nel formato /project/PROJECT_ID/zone/ ZONE_ID/instances/ INSTANCE_ID.

Questo parametro ha la priorità su Project ID, Instance Zone e Instance ID.
Project ID

Facoltativo.

L'ID del progetto associato all'istanza Compute Engine.

Se non viene fornito alcun valore, l'azione recupera l'ID progetto dalla configurazione dell'integrazione.
Instance Zone

Facoltativo.

La zona specifica in cui si trova l'istanza.

Questo parametro è obbligatorio se identifichi l'istanza utilizzando Instance Zone e Instance ID.
Instance ID

Facoltativo.

L'ID univoco dell'istanza che vuoi avviare.

Puoi recuperare questo valore utilizzando l'azione Elenca istanze.

Questo parametro è obbligatorio se identifichi l'istanza utilizzando Instance Zone e Instance ID.
Policy

Obbligatorio.

Il documento della policy IAM da applicare all'istanza, fornito come oggetto JSON.

Output azione

L'azione Imposta policy IAM dell'istanza fornisce i seguenti output:

Tipo di output dell'azione Disponibilità
Allegato della bacheca richieste Non disponibile
Link alla bacheca casi Non disponibile
Tabella della bacheca casi Non disponibile
Tabella di arricchimento Non disponibile
Risultato JSON Disponibile
Messaggi di output Disponibile
Risultato dello script Disponibile
Risultato JSON

L'esempio seguente descrive l'output del risultato JSON ricevuto quando utilizzi l'azione Imposta policy IAM dell'istanza:

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

L'azione Imposta policy IAM dell'istanza può restituire i seguenti messaggi di output:

Messaggio di output Descrizione del messaggio

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.

 L'azione è andata a buon fine.
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.

L'azione non è andata a buon fine.

Controlla la connessione al server, i parametri di input o le credenziali.
Risultato dello script

La tabella seguente elenca il valore per l'output del risultato dello script quando utilizzi l'azione Imposta policy IAM dell'istanza:

Nome del risultato dello script Valore
is_success true o false

Avvia istanza

Utilizza l'azione Avvia istanza per accendere un'istanza Compute Engine che si trova in uno stato di arresto o terminazione.

Questa azione non viene eseguita sulle entità Google SecOps.

Input azione

L'azione Avvia istanza richiede i seguenti parametri:

Parametri Descrizione
Resource Name

Facoltativo.

Il nome completo della risorsa dell'istanza Compute Engine, nel formato /project/PROJECT_ID/zone/ ZONE_ID/instances/ INSTANCE_ID.

Questo parametro ha la priorità su Project ID, Instance Zone e Instance ID.
Project ID

Facoltativo.

L'ID del progetto associato all'istanza Compute Engine.

Se non viene fornito alcun valore, l'azione recupera l'ID progetto dalla configurazione dell'integrazione.
Instance Zone

Facoltativo.

La zona specifica in cui si trova l'istanza.

Questo parametro è obbligatorio se identifichi l'istanza utilizzando Instance Zone e Instance ID.
Instance ID

Facoltativo.

L'ID univoco dell'istanza che vuoi avviare.

Puoi recuperare questo valore utilizzando l'azione Elenca istanze.

Questo parametro è obbligatorio se identifichi l'istanza utilizzando Instance Zone e Instance ID.

Output azione

L'azione Avvia istanza fornisce i seguenti output:

Tipo di output dell'azione Disponibilità
Allegato della bacheca richieste Non disponibile
Link alla bacheca casi Non disponibile
Tabella della bacheca casi Non disponibile
Tabella di arricchimento Non disponibile
Risultato JSON Disponibile
Messaggi di output Disponibile
Risultato dello script Disponibile
Risultato JSON

L'esempio seguente descrive l'output del risultato JSON ricevuto quando utilizzi l'azione Avvia istanza:

{
   "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"
}
Messaggi di output

L'azione Avvia istanza può restituire i seguenti messaggi di output:

Messaggio di output Descrizione del messaggio

Compute Engine instance RESOURCE_PATH was started successfully.

Provided instance zone ZONE_ID is not valid.

Provided instance ID is not valid.

 L'azione è andata a buon fine.

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.

L'azione non è andata a buon fine.

Controlla la connessione al server, i parametri di input o le credenziali.
Risultato dello script

La tabella seguente elenca il valore per l'output del risultato dello script quando utilizzi l'azione Avvia istanza:

Nome del risultato dello script Valore
is_success true o false

Arresta istanza

Utilizza l'azione Arresta istanza per arrestare un'istanza Compute Engine in esecuzione. Puoi riavviare un'istanza arrestata in qualsiasi momento.

L'arresto di un'istanza interrompe gli addebiti per l'utilizzo della VM, ma continuano a essere applicati gli addebiti per le risorse associate, come i Persistent Disk e gli indirizzi IP statici, a meno che queste risorse non vengano eliminate.

Questa azione non viene eseguita sulle entità Google SecOps.

Input azione

L'azione Arresta istanza richiede i seguenti parametri:

Parametri Descrizione
Resource Name

Facoltativo.

Il nome completo della risorsa dell'istanza Compute Engine, nel formato /project/PROJECT_ID/zone/ ZONE_ID/instances/ INSTANCE_ID.

Questo parametro ha la priorità su Project ID, Instance Zone e Instance ID.
Project ID

Facoltativo.

L'ID del progetto associato all'istanza Compute Engine.

Se non viene fornito alcun valore, l'azione recupera l'ID progetto dalla configurazione dell'integrazione.
Instance Zone

Facoltativo.

La zona specifica in cui si trova l'istanza.

Questo parametro è obbligatorio se identifichi l'istanza utilizzando Instance Zone e Instance ID.
Instance ID

Facoltativo.

L'ID univoco dell'istanza che vuoi avviare.

Puoi recuperare questo valore utilizzando l'azione Elenca istanze.

Questo parametro è obbligatorio se identifichi l'istanza utilizzando Instance Zone e Instance ID.

Output azione

L'azione Arresta istanza fornisce i seguenti output:

Tipo di output dell'azione Disponibilità
Allegato della bacheca richieste Non disponibile
Link alla bacheca casi Non disponibile
Tabella della bacheca casi Non disponibile
Tabella di arricchimento Non disponibile
Risultato JSON Disponibile
Messaggi di output Disponibile
Risultato dello script Disponibile
Risultato JSON

L'esempio seguente descrive l'output del risultato JSON ricevuto quando utilizzi l'azione Arresta istanza:

{
   "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"
}
Messaggi di output

L'azione Arresta istanza può restituire i seguenti messaggi di output:

Messaggio di output Descrizione del messaggio

Compute Engine instance INSTANCE_ID was stopped successfully.

Provided instance zone ZONE_ID is not valid.

Provided instance ID is not valid.

 L'azione è andata a buon fine.
Error executing action "Stop Instance". Reason: ERROR_REASON

L'azione non è andata a buon fine.

Controlla la connessione al server, i parametri di input o le credenziali.
Risultato dello script

La tabella seguente elenca il valore per l'output del risultato dello script quando utilizzi l'azione Arresta istanza:

Nome del risultato dello script Valore
is_success true o false

Aggiorna regola firewall

Utilizza l'azione Aggiorna regola firewall per modificare la configurazione di una regola firewall di Compute Engine esistente. Questa azione ti consente di aggiornare parametri specifici mantenendo l'identità della regola.

Questa azione non viene eseguita sulle entità Google SecOps.

Input azione

L'azione Aggiorna regola firewall richiede i seguenti parametri:

Parametri Descrizione
Firewall Rule

Facoltativo.

Il nome della regola firewall specifica da aggiornare.
Project ID

Facoltativo.

L'ID del progetto associato all'istanza Compute Engine.

Se non viene fornito alcun valore, l'azione recupera l'ID progetto dalla configurazione dell'integrazione.
Resource Name

Facoltativo.

Il nome completo della risorsa dell'istanza Compute Engine, nel formato /projects/PROJECT_ID/global/ firewallsFIREWALL.

Questo parametro ha la priorità su Project ID e Firewall Rule.
Source IP Ranges

Facoltativo.

Un elenco separato da virgole degli intervalli di indirizzi IP di origine per la regola firewall.

Se il valore none è impostato, l'azione elimina tutti gli intervalli IP di origine esistenti dalla regola.

Se non viene fornito alcun valore, i valori esistenti rimangono invariati.
Source Tags

Facoltativo.

Un elenco separato da virgole di tag di rete di origine da applicare alla regola.

Se il valore none è impostato, l'azione elimina tutti i tag di origine esistenti dalla regola.

Se non viene fornito alcun valore, i valori esistenti rimangono invariati.
Source Service Accounts

Facoltativo.

Un elenco separato da virgole di service account di origine da applicare alla regola.

Se il valore none è impostato, l'azione elimina tutti i service account di origine esistenti dalla regola.

Se non viene fornito alcun valore, i valori esistenti rimangono invariati.
TCP Ports

Facoltativo.

Un elenco separato da virgole di porte o intervalli di porte TCP da consentire o negare.

Questo parametro supporta i valori all e none. Se configurata, l'azione aggiorna l'elenco di protocolli e porte della regola firewall con questo valore.
UDP Ports

Facoltativo.

Un elenco separato da virgole di porte o intervalli di porte UDP da consentire o negare.

Questo parametro supporta i valori all e none. Se configurata, l'azione aggiorna l'elenco di protocolli e porte della regola firewall con questo valore.
Other Protocols

Facoltativo.

Un elenco separato da virgole di protocolli diversi da TCP e UDP da includere nella regola.

Se il valore none è impostato, l'azione aggiorna l'elenco dei protocolli della regola firewall con questo valore.
Destination IP Ranges

Facoltativo.

Un elenco separato da virgole degli intervalli di indirizzi IP di destinazione per la regola firewall.

Se il valore none è impostato, l'azione elimina tutti gli intervalli IP di destinazione esistenti dalla regola.

Se non viene fornito alcun valore, i valori esistenti rimangono invariati.

Output azione

L'azione Aggiorna regola firewall fornisce i seguenti output:

Tipo di output dell'azione Disponibilità
Allegato della bacheca richieste Non disponibile
Link alla bacheca casi Non disponibile
Tabella della bacheca casi Non disponibile
Tabella di arricchimento Non disponibile
Risultato JSON Disponibile
Messaggi di output Disponibile
Risultato dello script Disponibile
Risultato JSON

L'esempio seguente descrive l'output del risultato JSON ricevuto quando utilizzi l'azione Aggiorna regola firewall:

{
  "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"
  }
}
Messaggi di output

L'azione Aggiorna regola firewall può restituire i seguenti messaggi di output:

Messaggio di output Descrizione del messaggio
Successfully updated firewall rule in Cloud Compute.

Updating firewall rule in Cloud Compute.

 L'azione è andata a buon fine.
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.

L'azione non è andata a buon fine.

Controlla la connessione al server, i parametri di input o le credenziali.
Risultato dello script

La tabella seguente elenca il valore per l'output del risultato dello script quando utilizzi l'azione Aggiorna regola firewall:

Nome del risultato dello script Valore
is_success true o false

Hai bisogno di ulteriore assistenza? Ricevi risposte dai membri della community e dai professionisti di Google SecOps.