Integra Compute Engine con Google SecOps

En este documento, se explica cómo integrar Compute Engine con Google Security Operations.

Importante: En la plataforma de Google SecOps, la integración para Compute Engine se llama Google Cloud Compute.

Casos de uso

La integración de Compute Engine usa las capacidades de Google SecOps para admitir los siguientes casos de uso:

• Respuesta automatizada ante incidentes: Aísla automáticamente de la red una instancia de Compute Engine vulnerada. La contención automatizada limita la propagación del ataque, acelera el tiempo de respuesta y reduce la carga de trabajo del equipo de seguridad.

• Búsqueda e investigación de amenazas: Automatiza la recopilación de registros y telemetría de seguridad de las instancias de Compute Engine en varios proyectos. El análisis de estos datos consolidados permite la búsqueda proactiva de amenazas y acelera las investigaciones mediante la automatización de la recopilación de datos.

• Gestión de vulnerabilidades: Integra herramientas de análisis de vulnerabilidades en Google SecOps para analizar automáticamente las instancias de Compute Engine en busca de vulnerabilidades conocidas. Genera tickets de corrección o parches de vulnerabilidades directamente para reducir el riesgo de explotación y mejorar la postura de seguridad.

• Automatización del cumplimiento: Automatiza la recopilación de registros de auditoría y datos de configuración de las instancias de Compute Engine para cumplir con los requisitos reglamentarios. Genera informes y paneles para que los auditores simplifiquen los informes de cumplimiento y reduzcan el esfuerzo manual.

• Orquestación de seguridad: Orquesta flujos de trabajo de seguridad en varios servicios deGoogle Cloud , incluido Compute Engine. Por ejemplo, puedes activar la creación de una nueva regla de firewall en respuesta a un evento de seguridad detectado en una instancia, lo que genera una postura de seguridad más coordinada y automatizada.

Antes de comenzar

Antes de configurar la integración de Compute Engine en Google SecOps, completa los siguientes pasos previos:

1. Crea y configura un rol personalizado de Identity and Access Management.

2. Crea una cuenta de servicio.

3. Elige y configura uno de los siguientes métodos de autenticación:

   • Opción 1: Workload Identity (recomendada): Este método usa tokens de acceso temporales de corta duración a través de la suplantación de identidad de la cuenta de servicio.

   • Opción 2: Clave JSON de cuenta de servicio: Este método se basa en un archivo de claves secretas estático y de larga duración.

Crea un rol de IAM personalizado

Para proporcionar a la integración los permisos específicos necesarios para administrar tus instancias, crea un rol personalizado:

1. En la consola de Google Cloud , ve a IAM y administración > Roles.

   Ir a Funciones

2. Haz clic en agregarCrear rol personalizado.

3. Proporciona un título (por ejemplo, SecOps Compute Engine Integration), una descripción y un ID único.

4. Establece la etapa de lanzamiento del rol en Disponibilidad general.

5. Haz clic en Agregar permisos y agrega lo siguiente:

   • 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. Haz clic en Crear.

Crea una cuenta de servicio

1. En la consola de Google Cloud , ve a IAM y administración > Cuentas de servicio.

   Ir a Cuentas de servicio

2. Haz clic en addCrear cuenta de servicio.

3. Ingresa un nombre y una descripción, y haz clic en Crear y continuar.

4. En el paso Otorga a esta cuenta de servicio acceso al proyecto, asigna el rol personalizado que creaste.

5. Haz clic en Listo. Toma nota de la dirección de correo electrónico de la cuenta de servicio.

Configura credenciales de Workload Identity

Se recomienda usar Workload Identity porque utiliza tokens de acceso de corta duración que usan la identidad temporal como cuenta de servicio.

Identifica la identidad única de la instancia

Para establecer una conexión, debes otorgar permiso a tu instancia de Google SecOps para suplantar tu cuenta de servicio.

1. En Google SecOps, ve a Content Hub > Integraciones de respuesta.

2. Selecciona la integración de Compute Engine y, luego, ingresa el correo electrónico de tu cuenta de servicio en Workload Identity Email.

3. Haz clic en Guardar > Prueba. Se espera que la prueba falle.

4. Haz clic en el botón close_small junto a Test y busca el correo electrónico de identidad que comienza con gke-init-python@... o soar-python@....

5. Copia esta dirección de correo electrónico única.

Autoriza la identidad de la instancia en Google Cloud

1. En la consola de Google Cloud , ve a IAM y administración > Cuentas de servicio.

   Ir a Cuentas de servicio

2. Selecciona la cuenta de servicio de destino y ve a Permisos > Otorgar acceso.

3. Pega la dirección de correo electrónico única en el campo Principales nuevas y asigna el rol de Creador de tokens de cuenta de servicio (roles/iam.serviceAccountTokenCreator).

Configura una clave JSON

Los archivos de claves secretas estáticas y de larga duración requieren rotación manual. Usa este método solo si la autenticación de Workload Identity no está disponible.

1. En la consola de Google Cloud , ve a IAM y administración > Cuentas de servicio y selecciona tu cuenta de servicio.

   Ir a Cuentas de servicio

2. Ve a la pestaña Claves y haz clic en Agregar clave > Crear clave nueva.

3. Selecciona JSON y haz clic en Crear. El archivo se descargará automáticamente en tu computadora.

Cómo configurar parámetros individuales de forma manual

Si decides ingresar las credenciales de forma manual, mantén abierto el archivo de claves JSON descargado en un editor de texto para copiar los valores individuales que se requieren en la configuración de la integración.

Parámetros de integración

Para establecer una conexión entre Google SecOps y Compute Engine, debes configurar los siguientes parámetros. La integración admite tres rutas de autenticación distintas. Elige uno de los siguientes métodos para proporcionar credenciales:

• Workload Identity: Usa Workload Identity Email.
• Archivo JSON de cuenta de servicio: Usa Service Account Json File Content para proporcionar la clave completa de una vez.
• Parámetros individuales manuales: Usa campos separados copiados manualmente de una clave JSON.

Parámetro	Descripción
API Root	Es opcional. Es la URL base de la API de Compute Engine. El valor predeterminado es https://compute.googleapis.com.
OS Config API Root	Es opcional. Es la URL base de la API de Cloud OS Config. El valor predeterminado es https://osconfig.googleapis.com.
Workload Identity Email	Es opcional. Es la dirección de correo electrónico del cliente de tu cuenta de servicio. Úsalo para la autenticación de Workload Identity.
Service Account Json File Content	Es opcional. Es el contenido completo del archivo JSON de la clave de la cuenta de servicio. Si se configura, la integración ignora los parámetros de credenciales individuales.
Project ID	Es opcional. Es el ID del proyecto Google Cloud al que se segmenta. Si no se proporciona ningún valor, la integración recupera el ID de las credenciales de la cuenta de servicio.
Verify SSL	Obligatorio. Valida el certificado SSL para la conexión. Habilitada de forma predeterminada.

Parámetros de credenciales individuales

Solo usa los siguientes parámetros si ingresas las credenciales de forma manual en lugar de usar el contenido completo del archivo JSON o una identidad para Workload Identity.

Parámetro	Descripción
Account Type	Es opcional. El valor que se encuentra en el campo type de tu clave JSON (por lo general, service_account)
Private Key ID	Es opcional. Es el valor que se encuentra en el campo private_key_id de tu clave JSON.
Private Key	Es opcional. Es el valor que se encuentra en el campo private_key de tu clave JSON.
Client Email	Es opcional. Es el valor que se encuentra en el campo client_email de tu clave JSON.
Client ID	Es opcional. Es el valor que se encuentra en el campo client_id de tu clave JSON.
Auth URI	Es opcional. Es el valor que se encuentra en el campo auth_uri de tu clave JSON. El valor predeterminado es https://accounts.google.com/o/oauth2/auth.
Token URI	Es opcional. Es el valor que se encuentra en el campo token_uri de tu clave JSON. El valor predeterminado es https://oauth2.googleapis.com/token.
Auth Provider X509 URL	Es opcional. Es el valor que se encuentra en el campo auth_provider_x509_cert_url de tu clave JSON.
Client X509 URL	Es opcional. Es el valor que se encuentra en el campo client_x509_cert_url de tu clave JSON.

Si quieres obtener instrucciones para configurar una integración en Google SecOps, consulta Configura integraciones.

Si es necesario, puedes hacer cambios más adelante. Después de configurar una instancia de integración, puedes usarla en los playbooks. Para obtener más información sobre cómo configurar y admitir varias instancias, consulta Compatibilidad con varias instancias.

Acciones

Para obtener más información sobre las acciones, consulta Cómo responder a las acciones pendientes desde Tu escritorio y Cómo realizar una acción manual.

Agrega una IP a la regla de firewall

Usa la acción Add IP Range to Firewall Rule para agregar un rango de IP a una regla de firewall existente dentro de una instancia de Compute Engine.

Esta acción no se ejecuta en las entidades de Google SecOps.

Nota: Esta acción se ejecuta de forma asíncrona. Ajusta el valor de tiempo de espera del script en el IDE de Google SecOps según sea necesario para garantizar que la acción tenga tiempo suficiente para completar la solicitud.

Entradas de acción

La acción Add IP To Firewall Rule requiere los siguientes parámetros:

Parámetro	Descripción
Resource Name	Es opcional. Es el nombre completo del recurso de la instancia de Compute Engine, con el formato /projects/PROJECT_ID/global/ firewallsFIREWALL. Este parámetro tiene prioridad sobre Project ID y Firewall Rule.
Project ID	Es opcional. Es el nombre del proyecto asociado con la instancia de Compute Engine. Si no se proporciona ningún valor, la acción usa el ID del proyecto de la configuración de la integración.
Firewall Rule	Es opcional. Es el nombre de la regla de firewall específica que se actualizará.
Type	Obligatorio. Es la dirección del tráfico para el rango de IP que se agrega. Los valores posibles son los siguientes: Source Destination El valor predeterminado es Source.
IP Ranges	Obligatorio. Es una lista separada por comas de rangos de direcciones IP (notación CIDR) que se agregarán a la regla de firewall.

Resultados de la acción

La acción Add IP To Firewall Rule proporciona los siguientes resultados:

Tipo de salida de la acción	Disponibilidad
Adjunto del muro de casos	No disponible
Vínculo al muro de casos	No disponible
Tabla del muro de casos	No disponible
Tabla de enriquecimiento	No disponible
Resultado de JSON	Disponible
Mensajes de salida	Disponible
Resultado de secuencia de comandos	Disponible

Resultado de JSON

En el siguiente ejemplo, se muestra el resultado JSON que se recibe cuando se usa la acción 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": "[e-mail]",
  "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"
  }
}

Mensajes de salida

La acción Add IP To Firewall Rule puede devolver los siguientes mensajes de salida:

Mensaje de salida	Descripción del mensaje
Successfully updated firewall rule in Google Cloud Compute. Waiting for the operation to finish execution on the RESOURCE_PATH instance in Google Cloud Compute.	La acción se realizó correctamente.
Error executing action "Add IP To Firewall Rule". Reason: ERROR_REASON	No se pudo realizar la acción. Verifica la conexión al servidor, los parámetros de entrada o las credenciales.

Resultado de secuencia de comandos

En la siguiente tabla, se indica el valor del resultado del script cuando se usa la acción Add IP To Firewall Rule:

Nombre del resultado de la secuencia de comandos	Valor
is_success	true o false

Agregar etiquetas a la instancia

Usa la acción Add Labels to Instance para agregar o actualizar etiquetas en una instancia específica de Compute Engine.

Esta acción no se ejecuta en las entidades de Google SecOps.

Entradas de acción

La acción Add Labels to Instance requiere los siguientes parámetros:

Parámetro	Descripción
Resource Name	Es opcional. Es el nombre completo del recurso de la instancia de Compute Engine, con el formato /project/PROJECT_ID/zone/ ZONE_ID/instances/ INSTANCE_ID. Este parámetro tiene prioridad sobre Project ID, Instance Zone y Instance ID.
Project ID	Es opcional. Es el ID del proyecto asociado con la instancia de Compute Engine. Si no se proporciona ningún valor, la acción recupera el ID del proyecto de la configuración de la integración.
Instance Zone	Es opcional. Es la zona específica en la que se encuentra la instancia. Este parámetro es obligatorio si identificas la instancia con Instance Zone y Instance ID.
Instance ID	Es opcional. Es el ID único de la instancia de Compute Engine. Este parámetro es obligatorio si identificas la instancia con Instance Zone y Instance ID.
Instance Labels	Obligatorio. Es una lista de etiquetas separadas por comas que se aplicarán a la instancia, en el formato key:value (como vm_label_key:label1).

Resultados de la acción

La acción Add Labels to Instance proporciona los siguientes resultados:

Tipo de salida de la acción	Disponibilidad
Adjunto del muro de casos	No disponible
Vínculo al muro de casos	No disponible
Tabla del muro de casos	No disponible
Tabla de enriquecimiento	No disponible
Resultado de JSON	Disponible
Mensajes de salida	Disponible
Resultado de secuencia de comandos	Disponible

Resultado de JSON

En el siguiente ejemplo, se describe el resultado JSON que se recibe cuando se usa la acción 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": "[e-mail]",
   "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"
}

Mensajes de salida

La acción Add Labels to Instance puede devolver los siguientes mensajes de salida:

Mensaje de salida	Descripción del mensaje
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.	La acción se realizó correctamente.
Error executing action "Add Labels to Instance". Reason: ERROR_REASON	No se pudo realizar la acción. Verifica la conexión al servidor, los parámetros de entrada o las credenciales.

Resultado de secuencia de comandos

En la siguiente tabla, se indica el valor del resultado del script cuando se usa la acción Add Labels to Instance:

Nombre del resultado de la secuencia de comandos	Valor
is_success	true o false

Agrega etiquetas de red

Usa la acción Agregar etiquetas de red para agregar una o más etiquetas de red a una instancia específica de Compute Engine.

Esta acción no se ejecuta en las entidades de Google SecOps.

Nota: Esta acción se ejecuta de forma asíncrona. Ajusta el valor de tiempo de espera del script en el IDE de Google SecOps según sea necesario para garantizar que la acción tenga tiempo suficiente para completar la solicitud.

Entradas de acción

La acción Add Network Tags requiere los siguientes parámetros:

Parámetro	Descripción
Resource Name	Es opcional. Es el nombre completo del recurso de la instancia de Compute Engine, con el formato /project/PROJECT_ID/zone/ ZONE_ID/instances/ INSTANCE_ID. Este parámetro tiene prioridad sobre Project ID, Instance Zone y Instance ID.
Project ID	Es opcional. Es el ID del proyecto asociado con la instancia de Compute Engine. Si no se proporciona ningún valor, la acción recupera el ID del proyecto de la configuración de la integración.
Instance Zone	Es opcional. Es la zona específica en la que se encuentra la instancia. Este parámetro es obligatorio si identificas la instancia con Instance Zone y Instance ID.
Instance ID	Es opcional. Es el ID único de la instancia de Compute Engine. Este parámetro es obligatorio si identificas la instancia con Instance Zone y Instance ID.
Network Tags	Obligatorio. Es una lista de etiquetas de red separadas por comas que se agregarán a la instancia. Todas las etiquetas solo deben contener letras minúsculas, números y guiones.

Resultados de la acción

La acción Agregar etiquetas de red proporciona los siguientes resultados:

Tipo de salida de la acción	Disponibilidad
Adjunto del muro de casos	No disponible
Vínculo al muro de casos	No disponible
Tabla del muro de casos	No disponible
Tabla de enriquecimiento	No disponible
Resultado de JSON	Disponible
Mensajes de salida	Disponible
Resultado de secuencia de comandos	Disponible

Resultado de JSON

En el siguiente ejemplo, se muestra el resultado JSON que se recibe cuando se usa la acción 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": "[e-mail]",
      "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
  }
}

Mensajes de salida

La acción Add Network Tags puede devolver los siguientes mensajes de salida:

Mensaje de salida	Descripción del mensaje
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.	La acción se realizó correctamente.
Error executing action "Add Network Tags". Reason: ERROR_REASON	No se pudo realizar la acción. Verifica la conexión al servidor, los parámetros de entrada o las credenciales.

Resultado de secuencia de comandos

En la siguiente tabla, se indica el valor del resultado del script cuando se usa la acción Add Network Tags:

Nombre del resultado de la secuencia de comandos	Valor
is_success	true o false

Borrar instancia

Usa la acción Borrar instancia para borrar instancias de Compute Engine.

Esta acción no se ejecuta en las entidades de Google SecOps.

Entradas de acción

La acción Delete Instance requiere los siguientes parámetros:

Parámetro	Descripción
Resource Name	Es opcional. Es el nombre completo del recurso de la instancia de Compute Engine, con el formato /project/PROJECT_ID/zone/ ZONE_ID/instances/ INSTANCE_ID. Este parámetro tiene prioridad sobre Project ID, Instance Zone y Instance ID.
Project ID	Es opcional. Es el ID del proyecto asociado con la instancia de Compute Engine. Si no se proporciona ningún valor, la acción recupera el ID del proyecto de la configuración de la integración.
Instance Zone	Es opcional. Es la zona específica en la que se encuentra la instancia. Este parámetro es obligatorio si identificas la instancia con Instance Zone y Instance ID.
Instance ID	Es opcional. Es el ID único de la instancia que deseas iniciar. Puedes recuperar este valor con la acción List Instances. Este parámetro es obligatorio si identificas la instancia con Instance Zone y Instance ID.

Resultados de la acción

La acción Delete Instance proporciona los siguientes resultados:

Tipo de salida de la acción	Disponibilidad
Adjunto del muro de casos	No disponible
Vínculo al muro de casos	No disponible
Tabla del muro de casos	No disponible
Tabla de enriquecimiento	No disponible
Resultado de JSON	Disponible
Mensajes de salida	Disponible
Resultado de secuencia de comandos	Disponible

Resultado de JSON

En el siguiente ejemplo, se describe el resultado JSON que se recibe cuando se usa la acción 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": "[e-mail]",
   "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"
}

Mensajes de salida

La acción Delete Instance puede devolver los siguientes mensajes de salida:

Mensaje de salida	Descripción del mensaje
Compute Engine instance INSTANCE_ID was deleted successfully. Provided instance zone ZONE_ID is not valid. Provided instance ID is not valid.	La acción se realizó correctamente.
Error executing action "Start Instance". Reason: ERROR_REASON Provided resource RESOURCE_PATH is not valid	No se pudo realizar la acción. Verifica la conexión al servidor, los parámetros de entrada o las credenciales.

Resultado de secuencia de comandos

En la siguiente tabla, se indica el valor del resultado del script cuando se usa la acción Delete Instance:

Nombre del resultado de la secuencia de comandos	Valor
is_success	true o false

Enriquece entidades

Usa la acción Enrich Entities para enriquecer las entidades de IP Address de Google SecOps con la información de la instancia de Compute Engine.

Esta acción se ejecuta en las siguientes entidades de Google SecOps:

• IP Address

Entradas de acción

La acción Enrich Entities requiere los siguientes parámetros:

Parámetros	Descripción
Project ID	Es opcional. Es el ID del proyecto asociado con la instancia de Compute Engine. Si no se proporciona ningún valor, la acción recupera el ID del proyecto de la configuración de la integración.
Instance Zone	Es opcional. Es la zona específica en la que se encuentra la instancia.

Resultados de la acción

La acción Enrich Entities proporciona los siguientes resultados:

Tipo de salida de la acción	Disponibilidad
Adjunto del muro de casos	No disponible
Vínculo al muro de casos	No disponible
Tabla del muro de casos	Disponible
Tabla de enriquecimiento	Disponible
Resultado de JSON	Disponible
Mensajes de salida	Disponible
Resultado de secuencia de comandos	Disponible

Tabla del muro de casos

Después de completar la ejecución, la acción Enrich Entities proporciona la siguiente tabla:

Nombre de la tabla: Tabla de enriquecimiento de ENTITY

Columnas:

• Campo de entidad
• Valor

Tabla de enriquecimiento

La acción Enrich Entities admite el siguiente enriquecimiento de entidades:

Campo de enriquecimiento	Fuente (clave JSON)	Lógica
Google_Compute_instance_id	id	No disponible
Google_Compute_creation_timestamp	creationTimestamp	No disponible
Google_Compute_instance_name	name	No disponible
Google_Compute_description	description	No disponible
Google_Compute_tags	tags	Proporciona las etiquetas en una lista CSV
Google_Compute_machine_type	machineType	No disponible
Google_Compute_instance_status	status	No disponible
Google_Compute_instance_zone	zone	No disponible
Google_Compute_can_ip_forward	canIpForward	No disponible
Google_Compute_instance_network_interfaces_name_INDEX	networkInterfaces.name	Expande si hay más interfaces de red disponibles
Google_Compute_instance_network_interfaces_name_access_configs_type_INDEX	networkInterfaces.accessConfigs.type	Expande si hay más interfaces de red disponibles
Google_Compute_instance_network_interfaces_name_access_configs_name_INDEX	networkInterfaces.accessConfigs.name	Expande si hay más interfaces de red disponibles
Google_Compute_instance_network_interfaces_name_access_configs_natIP_INDEX	networkInterfaces.accessConfigs.natIP	Expande si hay más interfaces de red disponibles
Google_Compute_instance_metadata	metadata	Lista de valores separados por comas de los metadatos de la instancia
Google_Compute_service_account_INDEX	serviceAccounts.email	Expande si hay más cuentas de servicio disponibles
Google_Compute_service_account_scopes_INDEX	serviceAccounts.scopes	Expande si hay más cuentas de servicio disponibles
Google_Compute_link_to_Google_Compute	selfLink	No disponible
Google_Compute_labels	labels	Proporciona una lista de valores en formato CSV
Google_Compute_instance_last_start_timestamp	lastStartTimestamp	No disponible
Google_Compute_instance_last_stop_timestamp	lastStopTimestamp	No disponible

Resultado de JSON

En el siguiente ejemplo, se describe el resultado JSON que se recibe cuando se usa la acción 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": "[e-mail]",
            "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"
}

Mensajes de salida

La acción Enrich Entities puede devolver los siguientes mensajes de salida:

Mensaje de salida	Descripción del mensaje
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.	La acción se realizó correctamente.
Error executing action "Enrich Entities". Reason: ERROR_REASON	No se pudo realizar la acción. Verifica la conexión al servidor, los parámetros de entrada o las credenciales.

Resultado de secuencia de comandos

En la siguiente tabla, se muestra el valor del resultado del script cuando se usa la acción Enrich Entities:

Nombre del resultado de la secuencia de comandos	Valor
is_success	true o false

Ejecuta el trabajo de aplicación de parches de la VM

Usa la acción Ejecutar trabajo de aplicación de parche de VM para ejecutar un trabajo de aplicación de parche de VM en instancias de Compute Engine.

Esta acción no se ejecuta en las entidades de Google SecOps.

Nota: Esta acción se ejecuta de forma asíncrona. Ajusta el valor de tiempo de espera del script en el IDE de Google SecOps según sea necesario para garantizar que la acción tenga tiempo suficiente para completar la solicitud.

Importante: La acción Ejecutar trabajo de parche de VM requiere que habilites la API de OS Config.

Entradas de acción

La acción Ejecutar trabajo de parche de VM requiere los siguientes parámetros:

Parámetro	Descripción
Instance Filter Object	Obligatorio. Es el objeto JSON que se usa para segmentar instancias específicas para la aplicación de parches. El valor predeterminado segmenta todas las instancias: { "all": "true" }
Name	Obligatorio. Es el nombre único del trabajo de aplicación de parches.
Description	Es opcional. Es una breve descripción del propósito del trabajo de aplicación de parches.
Patching Config Object	Es opcional. Es un objeto JSON que define los pasos y la configuración específicos de la actualización para diferentes sistemas operativos. Si no se proporciona ningún valor, la acción usa el siguiente valor predeterminado: { "rebootConfig": "DEFAULT", "apt": { "type": "DIST" }, "yum": { "security": true }, "zypper": { "withUpdate": true }, "windowsUpdate": { "classifications": ["CRITICAL", "SECURITY"] } }
Patch Duration Timeout	Obligatorio. Es el tiempo máximo, en minutos, que se permite para que se ejecute el trabajo de aplicación de parches. El valor predeterminado es 60.
Rollout Strategy	Es opcional. Es el método que se usa para implementar el parche en varias zonas. Los valores posibles son los siguientes: Zone By Zone: Los parches se aplican a una zona a la vez para minimizar el riesgo. Concurrent Zones: Los parches se aplican a todas las zonas objetivo de forma simultánea para reducir el período de mantenimiento total. El valor predeterminado es Zone By Zone.
Disruption Budget	Obligatorio. Es la cantidad o el porcentaje de instancias que pueden estar sin conexión al mismo tiempo (por ejemplo, 5 o 10%). El valor predeterminado es 10%.
Wait For Completion	Obligatorio. Si se selecciona, la acción permanece activa hasta que finaliza el trabajo de aplicación de parches. Habilitada de forma predeterminada.
Fail If Completed With Errors	Obligatorio. Si se selecciona esta opción, la acción fallará si el estado del trabajo es Completed with errors o si alcanza el límite de tiempo de espera. Este parámetro se ignora si Wait For Completion está inhabilitado. Habilitada de forma predeterminada.

Resultados de la acción

La acción Ejecutar trabajo de parche de VM proporciona los siguientes resultados:

Tipo de salida de la acción	Disponibilidad
Adjunto del muro de casos	No disponible
Vínculo al muro de casos	No disponible
Tabla del muro de casos	No disponible
Tabla de enriquecimiento	No disponible
Resultado de JSON	Disponible
Mensajes de salida	Disponible
Resultado de secuencia de comandos	Disponible

Resultado de JSON

En el siguiente ejemplo, se muestra el resultado JSON que se recibe cuando se usa la acción Ejecutar trabajo de parche de 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
                }
            }
        }

Mensajes de salida

La acción Ejecutar trabajo de parche de VM puede devolver los siguientes mensajes de salida:

Mensaje de salida	Descripción del mensaje
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	La acción se realizó correctamente.
Error executing action "Execute VM Patch Job". Reason: ERROR_REASON	No se pudo realizar la acción. Verifica la conexión al servidor, los parámetros de entrada o las credenciales.

Resultado de secuencia de comandos

En la siguiente tabla, se muestra el valor del resultado de la secuencia de comandos cuando se usa la acción Ejecutar trabajo de parche de VM:

Nombre del resultado de la secuencia de comandos	Valor
is_success	true o false

Obtener política de IAM de la instancia

Usa la acción Get Instance IAM Policy para recuperar la política de control de acceso de Identity and Access Management (iam_name_short) para un recurso específico de Compute Engine.

Esta acción no se ejecuta en las entidades de Google SecOps.

Nota: Si no se definió explícitamente ninguna política para el recurso, la acción devuelve un objeto de política vacío.

Entradas de acción

La acción Get Instance IAM Policy requiere los siguientes parámetros:

Parámetro	Descripción
Resource Name	Es opcional. Es el nombre completo del recurso de la instancia de Compute Engine, con el formato /project/PROJECT_ID/zone/ ZONE_ID/instances/ INSTANCE_ID. Este parámetro tiene prioridad sobre Project ID, Instance Zone y Instance ID.
Project ID	Es opcional. Es el ID del proyecto asociado con la instancia de Compute Engine. Si no se proporciona ningún valor, la acción recupera el ID del proyecto de la configuración de la integración.
Instance Zone	Es opcional. Es la zona específica en la que se encuentra la instancia. Este parámetro es obligatorio si identificas la instancia con Instance Zone y Instance ID.
Instance ID	Es opcional. Es el ID único de la instancia que deseas iniciar. Puedes recuperar este valor con la acción List Instances. Este parámetro es obligatorio si identificas la instancia con Instance Zone y Instance ID.

Resultados de la acción

La acción Get Instance IAM Policy proporciona los siguientes resultados:

Tipo de salida de la acción	Disponibilidad
Adjunto del muro de casos	No disponible
Vínculo al muro de casos	No disponible
Tabla del muro de casos	No disponible
Tabla de enriquecimiento	No disponible
Resultado de JSON	Disponible
Mensajes de salida	Disponible
Resultado de secuencia de comandos	Disponible

Resultado de JSON

En el siguiente ejemplo, se describe el resultado JSON que se recibe cuando se usa la acción Get Instance IAM Policy:

{
    "version": 1,
    "etag": "BwXBfsc47MI=",
    "bindings": [
        {
            "role": "roles/compute.networkViewer_withcond_2f0c00",
            "members": [
                "user:[e-mail]"
            ]
        }
    ]
}

Mensajes de salida

La acción Get Instance IAM Policy puede devolver los siguientes mensajes de salida:

Mensaje de salida	Descripción del mensaje
Compute Engine instance INSTANCE_ID IAM policy was fetched successfully. Provided instance zone ZONE_ID is not valid. Provided instance ID is not valid.	La acción se realizó correctamente.
Error executing action "Get Instance IAM Policy". Reason: ERROR_REASON	No se pudo realizar la acción. Verifica la conexión al servidor, los parámetros de entrada o las credenciales.

Resultado de secuencia de comandos

En la siguiente tabla, se indica el valor del resultado de la secuencia de comandos cuando se usa la acción Get Instance IAM Policy:

Nombre del resultado de la secuencia de comandos	Valor
is_success	true o false

Enumerar instancias

Usa la acción List Instances para enumerar las instancias de Compute Engine según los criterios de búsqueda especificados.

Esta acción no se ejecuta en las entidades de Google SecOps.

Entradas de acción

La acción List Instances requiere los siguientes parámetros:

Parámetro	Descripción
Project ID	Es opcional. Es el ID del proyecto desde el que se enumerarán las instancias. Si no se proporciona ningún valor, la acción recupera el ID del proyecto de la cuenta de servicio de Google Cloud que se usa en la configuración de la integración.
Instance Zone	Es opcional. Es la zona específica en la que se buscarán instancias. Si no se proporciona ningún valor, la acción buscará en todas las zonas disponibles.
Instance Name	Es opcional. Es el nombre de la instancia que se buscará. Este parámetro acepta varios valores como una cadena separada por comas.
Instance Status	Es opcional. Es el estado actual de las instancias que se incluirán en los resultados de la búsqueda, como RUNNING o TERMINATED. Este parámetro acepta varios valores como una cadena separada por comas.
Instance Labels	Es opcional. Son las etiquetas que se usan para filtrar los resultados de la instancia, proporcionadas en formato key:value (como env:production). Este parámetro acepta varios valores como una cadena separada por comas.
Max Rows to Return	Es opcional. Es la cantidad máxima de instancias que se devolverán en los resultados. El valor predeterminado es 50.

Resultados de la acción

La acción List Instances proporciona los siguientes resultados:

Tipo de salida de la acción	Disponibilidad
Adjunto del muro de casos	No disponible
Vínculo al muro de casos	No disponible
Tabla del muro de casos	Disponible
Tabla de enriquecimiento	No disponible
Resultado de JSON	Disponible
Mensajes de salida	Disponible
Resultado de secuencia de comandos	Disponible

Tabla del muro de casos

La acción List Instances proporciona la siguiente tabla:

Nombre de la tabla: Instancias de Compute Engine

Columnas de la tabla:

• Nombre de la instancia
• ID de instancia
• Fecha y hora de creación de la instancia
• Descripción de la instancia
• Tipo de instancia
• Estado de la instancia
• Etiquetas de instancias

Resultado de JSON

En el siguiente ejemplo, se describe el resultado en JSON que se recibe cuando se usa la acción 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": "[e-mail]",
                   "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"
       }
   ]
}

Mensajes de salida

La acción List Instances puede devolver los siguientes mensajes de salida:

Mensaje de salida	Descripción del mensaje
Successfully fetched Compute Engine instances. Provided instance zone ZONE_ID is not valid. No instances were found in Compute Engine.	La acción se realizó correctamente.
Error executing action "List Instances". Reason: ERROR_REASON	No se pudo realizar la acción. Verifica la conexión al servidor, los parámetros de entrada o las credenciales.

Resultado de secuencia de comandos

En la siguiente tabla, se indica el valor del resultado del script cuando se usa la acción List Instances:

Nombre del resultado de la secuencia de comandos	Valor
is_success	true o false

Ping

Usa la acción Ping para probar la conectividad a Compute Engine.

Esta acción no se ejecuta en las entidades de Google SecOps.

Entradas de acción

Ninguno

Resultados de la acción

La acción Ping proporciona los siguientes resultados:

Tipo de salida de la acción	Disponibilidad
Adjunto del muro de casos	No disponible
Vínculo al muro de casos	No disponible
Tabla del muro de casos	No disponible
Tabla de enriquecimiento	No disponible
Resultado de JSON	No disponible
Mensajes de salida	Disponible
Resultado de secuencia de comandos	Disponible

Mensajes de salida

La acción Ping puede devolver los siguientes mensajes de salida:

Mensaje de salida	Descripción del mensaje
Successfully connected to the Compute Engine service with the provided connection parameters!	La acción se realizó correctamente.
Failed to connect to the Compute Engine service! Error is ERROR_REASON	No se pudo realizar la acción. Verifica la conexión al servidor, los parámetros de entrada o las credenciales.

Resultado de secuencia de comandos

En la siguiente tabla, se indica el valor del resultado de la secuencia de comandos cuando se usa la acción Ping:

Nombre del resultado de la secuencia de comandos	Valor
is_success	true o false

Cómo quitar direcciones IP externas

Usa la acción Quitar direcciones IP externas para quitar direcciones IP externas en una instancia de Compute Engine.

Esta acción no se ejecuta en las entidades de Google SecOps.

Nota: Esta acción se ejecuta de forma asíncrona. Ajusta el valor de tiempo de espera del script en el IDE de Google SecOps según sea necesario para garantizar que la acción tenga tiempo suficiente para completar la solicitud.

Entradas de acción

La acción Remove External IP Addresses requiere los siguientes parámetros:

Parámetros	Descripción
Resource Name	Es opcional. Es el nombre completo del recurso de la instancia de Compute Engine, con el formato /project/PROJECT_ID/zone/ ZONE_ID/instances/ INSTANCE_ID. Este parámetro tiene prioridad sobre Project ID, Instance Zone y Instance ID.
Project ID	Es opcional. Es el ID del proyecto asociado con la instancia de Compute Engine. Si no se proporciona ningún valor, la acción recupera el ID del proyecto de la configuración de la integración.
Instance Zone	Es opcional. Es la zona específica en la que se encuentra la instancia. Este parámetro es obligatorio si identificas la instancia con Instance Zone y Instance ID.
Instance ID	Es opcional. Es el ID único de la instancia que deseas iniciar. Puedes recuperar este valor con la acción List Instances. Este parámetro es obligatorio si identificas la instancia con Instance Zone y Instance ID.
Network Interfaces	Es opcional. Es una lista separada por comas de las interfaces de red específicas que se modificarán. Si no se proporciona ningún valor o si usas el comodín *, la acción actualiza todas las interfaces de red. El valor predeterminado es *.

Resultados de la acción

La acción Remove External IP Addresses proporciona los siguientes resultados:

Tipo de salida de la acción	Disponibilidad
Adjunto del muro de casos	No disponible
Vínculo al muro de casos	No disponible
Tabla del muro de casos	No disponible
Tabla de enriquecimiento	No disponible
Resultado de JSON	Disponible
Mensajes de salida	Disponible
Resultado de secuencia de comandos	Disponible

Resultado de JSON

En el siguiente ejemplo, se describe el resultado JSON que se recibe cuando se usa la acción 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": "[e-mail]",
        "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": "[e-mail]",
        "zone": "us-west1-a",
        "networkInterface": "example"
    }
]

Mensajes de salida

La acción Remove External IP Addresses puede devolver los siguientes mensajes de salida:

Mensaje de salida	Descripción del mensaje
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.	La acción se realizó correctamente.
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.	No se pudo realizar la acción. Verifica la conexión al servidor, los parámetros de entrada o las credenciales.

Resultado de secuencia de comandos

En la siguiente tabla, se indica el valor del resultado de la secuencia de comandos cuando se usa la acción Remove External IP Addresses:

Nombre del resultado de la secuencia de comandos	Valor
is_success	true o false

Quita la IP de la regla de firewall

Usa la acción Remove IP From Firewall Rule para borrar rangos de direcciones IP específicos de una regla de firewall existente de Compute Engine.

Esta acción no se ejecuta en las entidades de Google SecOps.

Nota: Esta acción se ejecuta de forma asíncrona. Ajusta el valor de tiempo de espera del script en el IDE de Google SecOps según sea necesario para garantizar que la acción tenga tiempo suficiente para completar la solicitud.

Entradas de acción

La acción Remove IP From Firewall Rule requiere los siguientes parámetros:

Parámetro	Descripción
Resource Name	Es opcional. Es el nombre completo del recurso de la instancia de Compute Engine, con el formato /projects/PROJECT_ID/global/ firewallsFIREWALL. Este parámetro tiene prioridad sobre Project ID y Firewall Rule.
Project ID	Es opcional. Es el ID del proyecto asociado con la instancia de Compute Engine. Si no se proporciona ningún valor, la acción recupera el ID del proyecto de la configuración de la integración.
Firewall Rule	Es opcional. Es el nombre de la regla de firewall específica que se actualizará.
Type	Obligatorio. Es la dirección del tráfico para el rango de IP que se agrega. Los valores posibles son los siguientes: Source Destination El valor predeterminado es Source.
IP Ranges	Obligatorio. Es una lista separada por comas de rangos de direcciones IP (notación CIDR) que se agregarán a la regla de firewall.

Resultados de la acción

La acción Remove IP From Firewall Rule proporciona los siguientes resultados:

Tipo de salida de la acción	Disponibilidad
Adjunto del muro de casos	No disponible
Vínculo al muro de casos	No disponible
Tabla del muro de casos	No disponible
Tabla de enriquecimiento	No disponible
Resultado de JSON	Disponible
Mensajes de salida	Disponible
Resultado de secuencia de comandos	Disponible

Resultado de JSON

En el siguiente ejemplo, se muestra el resultado JSON que se recibe cuando se usa la acción 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": "[e-mail]",
  "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"
  }
}

Mensajes de salida

La acción Remove IP From Firewall Rule puede devolver los siguientes mensajes de salida:

Mensaje de salida	Descripción del mensaje
Successfully updated firewall rule in Google Cloud Compute. Waiting for the operation to finish execution on the RESOURCE_PATH instance in Google Cloud Compute.	La acción se realizó correctamente.
Error executing action "Remove IP From Firewall Rule". Reason: ERROR_REASON	No se pudo realizar la acción. Verifica la conexión al servidor, los parámetros de entrada o las credenciales.

Resultado de secuencia de comandos

En la siguiente tabla, se indica el valor del resultado del script cuando se usa la acción Remove IP From Firewall Rule:

Nombre del resultado de la secuencia de comandos	Valor
is_success	true o false

Cómo quitar etiquetas de red

Usa la acción Remove Network Tags para quitar etiquetas de red de la instancia de Compute Engine.

Esta acción no se ejecuta en las entidades de Google SecOps.

Nota: Esta acción se ejecuta de forma asíncrona. Ajusta el valor de tiempo de espera del script en el IDE de Google SecOps según sea necesario para garantizar que la acción tenga tiempo suficiente para completar la solicitud.

Entradas de acción

La acción Remove Network Tags requiere los siguientes parámetros:

Parámetro	Descripción
Resource Name	Es opcional. Es el nombre completo del recurso de la instancia de Compute Engine, con el formato /project/PROJECT_ID/zone/ ZONE_ID/instances/ INSTANCE_ID. Este parámetro tiene prioridad sobre Project ID, Instance Zone y Instance ID.
Project ID	Es opcional. Es el ID del proyecto asociado con la instancia de Compute Engine. Si no se proporciona ningún valor, la acción recupera el ID del proyecto de la configuración de la integración.
Instance Zone	Es opcional. Es la zona específica en la que se encuentra la instancia. Este parámetro es obligatorio si identificas la instancia con Instance Zone y Instance ID.
Instance ID	Es opcional. Es el ID único de la instancia que deseas iniciar. Puedes recuperar este valor con la acción List Instances. Este parámetro es obligatorio si identificas la instancia con Instance Zone y Instance ID.
Network Tags	Obligatorio. Es una lista de etiquetas de red separadas por comas que se agregarán a la instancia. Todas las etiquetas solo deben contener letras minúsculas, números y guiones.

Resultados de la acción

La acción Remove Network Tags proporciona los siguientes resultados:

Tipo de salida de la acción	Disponibilidad
Adjunto del muro de casos	No disponible
Vínculo al muro de casos	No disponible
Tabla del muro de casos	No disponible
Tabla de enriquecimiento	No disponible
Resultado de JSON	Disponible
Mensajes de salida	Disponible
Resultado de secuencia de comandos	Disponible

Resultado de JSON

En el siguiente ejemplo, se muestra el resultado JSON que se recibe cuando se usa la acción 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": "[e-mail]",
      "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
  }
}

Mensajes de salida

La acción Remove Network Tags puede devolver los siguientes mensajes de salida:

Mensaje de salida	Descripción del mensaje
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.	La acción se realizó correctamente.
Error executing action "Remove Network Tags". Reason: ERROR_REASON	No se pudo realizar la acción. Verifica la conexión al servidor, los parámetros de entrada o las credenciales.

Resultado de secuencia de comandos

En la siguiente tabla, se indica el valor del resultado de la secuencia de comandos cuando se usa la acción Remove Network Tags:

Nombre del resultado de la secuencia de comandos	Valor
is_success	true o false

Configurar política de IAM de la instancia

Usa la acción Set Instance IAM Policy para establecer la política de control de acceso para el recurso especificado. La política que proporcionas en la acción reemplaza cualquier política existente.

Esta acción no se ejecuta en las entidades de Google SecOps.

Entradas de acción

La acción Set Instance IAM Policy requiere los siguientes parámetros:

Parámetros	Descripción
Resource Name	Es opcional. Es el nombre completo del recurso de la instancia de Compute Engine, con el formato /project/PROJECT_ID/zone/ ZONE_ID/instances/ INSTANCE_ID. Este parámetro tiene prioridad sobre Project ID, Instance Zone y Instance ID.
Project ID	Es opcional. Es el ID del proyecto asociado con la instancia de Compute Engine. Si no se proporciona ningún valor, la acción recupera el ID del proyecto de la configuración de la integración.
Instance Zone	Es opcional. Es la zona específica en la que se encuentra la instancia. Este parámetro es obligatorio si identificas la instancia con Instance Zone y Instance ID.
Instance ID	Es opcional. Es el ID único de la instancia que deseas iniciar. Puedes recuperar este valor con la acción List Instances. Este parámetro es obligatorio si identificas la instancia con Instance Zone y Instance ID.
Policy	Obligatorio. Documento de política de IAM que se aplicará a la instancia, proporcionado como un objeto JSON.

Resultados de la acción

La acción Set Instance IAM Policy proporciona los siguientes resultados:

Tipo de salida de la acción	Disponibilidad
Adjunto del muro de casos	No disponible
Vínculo al muro de casos	No disponible
Tabla del muro de casos	No disponible
Tabla de enriquecimiento	No disponible
Resultado de JSON	Disponible
Mensajes de salida	Disponible
Resultado de secuencia de comandos	Disponible

Resultado de JSON

En el siguiente ejemplo, se describe el resultado JSON que se recibe cuando se usa la acción Set Instance IAM Policy:

{
    "version": 1,
    "etag": "BwXBftu99FE=",
    "bindings": [
        {
            "role": "roles/compute.networkViewer",
            "members": [
                "user:[e-mail]"
            ]
        }
    ]
}

Mensajes de salida

La acción Set Instance IAM Policy puede devolver los siguientes mensajes de salida:

Mensaje de salida	Descripción del mensaje
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.	La acción se realizó correctamente.
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.	No se pudo realizar la acción. Verifica la conexión al servidor, los parámetros de entrada o las credenciales.

Resultado de secuencia de comandos

En la siguiente tabla, se indica el valor del resultado del script cuando se usa la acción Set Instance IAM Policy:

Nombre del resultado de la secuencia de comandos	Valor
is_success	true o false

Iniciar instancia

Usa la acción Iniciar instancia para encender una instancia de Compute Engine que se encuentre en estado detenido o finalizado.

Esta acción no se ejecuta en las entidades de Google SecOps.

Nota: Esta acción se ejecuta de forma asíncrona. Ajusta el valor de tiempo de espera del script en el IDE de Google SecOps según sea necesario para garantizar que la acción tenga tiempo suficiente para completar la solicitud.

Entradas de acción

La acción Start Instance requiere los siguientes parámetros:

Parámetros	Descripción
Resource Name	Es opcional. Es el nombre completo del recurso de la instancia de Compute Engine, con el formato /project/PROJECT_ID/zone/ ZONE_ID/instances/ INSTANCE_ID. Este parámetro tiene prioridad sobre Project ID, Instance Zone y Instance ID.
Project ID	Es opcional. Es el ID del proyecto asociado con la instancia de Compute Engine. Si no se proporciona ningún valor, la acción recupera el ID del proyecto de la configuración de la integración.
Instance Zone	Es opcional. Es la zona específica en la que se encuentra la instancia. Este parámetro es obligatorio si identificas la instancia con Instance Zone y Instance ID.
Instance ID	Es opcional. Es el ID único de la instancia que deseas iniciar. Puedes recuperar este valor con la acción List Instances. Este parámetro es obligatorio si identificas la instancia con Instance Zone y Instance ID.

Resultados de la acción

La acción Start Instance proporciona los siguientes resultados:

Tipo de salida de la acción	Disponibilidad
Adjunto del muro de casos	No disponible
Vínculo al muro de casos	No disponible
Tabla del muro de casos	No disponible
Tabla de enriquecimiento	No disponible
Resultado de JSON	Disponible
Mensajes de salida	Disponible
Resultado de secuencia de comandos	Disponible

Resultado de JSON

En el siguiente ejemplo, se describe el resultado en formato JSON que se recibe cuando se usa la acción 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": "[e-mail]",
   "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"
}

Mensajes de salida

La acción Start Instance puede devolver los siguientes mensajes de salida:

Mensaje de salida	Descripción del mensaje
Compute Engine instance RESOURCE_PATH was started successfully. Provided instance zone ZONE_ID is not valid. Provided instance ID is not valid.	La acción se realizó correctamente.
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.	No se pudo realizar la acción. Verifica la conexión al servidor, los parámetros de entrada o las credenciales.

Resultado de secuencia de comandos

En la siguiente tabla, se indica el valor del resultado de la secuencia de comandos cuando se usa la acción Start Instance:

Nombre del resultado de la secuencia de comandos	Valor
is_success	true o false

Detener instancia

Usa la acción Detener instancia para cerrar una instancia de Compute Engine en ejecución. Puedes reiniciar una instancia detenida en cualquier momento.

Detener una instancia detiene los cargos por uso de la VM, pero se siguen aplicando cargos por los recursos asociados, como los discos persistentes y las direcciones IP estáticas, a menos que se borren esos recursos.

Esta acción no se ejecuta en las entidades de Google SecOps.

Nota: Esta acción se ejecuta de forma asíncrona. Ajusta el valor de tiempo de espera del script en el IDE de Google SecOps según sea necesario para garantizar que la acción tenga tiempo suficiente para completar la solicitud.

Entradas de acción

La acción Detener instancia requiere los siguientes parámetros:

Parámetros	Descripción
Resource Name	Es opcional. Es el nombre completo del recurso de la instancia de Compute Engine, con el formato /project/PROJECT_ID/zone/ ZONE_ID/instances/ INSTANCE_ID. Este parámetro tiene prioridad sobre Project ID, Instance Zone y Instance ID.
Project ID	Es opcional. Es el ID del proyecto asociado con la instancia de Compute Engine. Si no se proporciona ningún valor, la acción recupera el ID del proyecto de la configuración de la integración.
Instance Zone	Es opcional. Es la zona específica en la que se encuentra la instancia. Este parámetro es obligatorio si identificas la instancia con Instance Zone y Instance ID.
Instance ID	Es opcional. Es el ID único de la instancia que deseas iniciar. Puedes recuperar este valor con la acción List Instances. Este parámetro es obligatorio si identificas la instancia con Instance Zone y Instance ID.

Resultados de la acción

La acción Detener instancia proporciona los siguientes resultados:

Tipo de salida de la acción	Disponibilidad
Adjunto del muro de casos	No disponible
Vínculo al muro de casos	No disponible
Tabla del muro de casos	No disponible
Tabla de enriquecimiento	No disponible
Resultado de JSON	Disponible
Mensajes de salida	Disponible
Resultado de secuencia de comandos	Disponible

Resultado de JSON

En el siguiente ejemplo, se describe el resultado JSON que se recibe cuando se usa la acción Detener instancia:

{
   "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": "[e-mail]",
   "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"
}

Mensajes de salida

La acción Detener instancia puede devolver los siguientes mensajes de salida:

Mensaje de salida	Descripción del mensaje
Compute Engine instance INSTANCE_ID was stopped successfully. Provided instance zone ZONE_ID is not valid. Provided instance ID is not valid.	La acción se realizó correctamente.
Error executing action "Stop Instance". Reason: ERROR_REASON	No se pudo realizar la acción. Verifica la conexión al servidor, los parámetros de entrada o las credenciales.

Resultado de secuencia de comandos

En la siguiente tabla, se indica el valor del resultado de la secuencia de comandos cuando se usa la acción Detener instancia:

Nombre del resultado de la secuencia de comandos	Valor
is_success	true o false

Actualizar regla de firewall

Usa la acción Update Firewall Rule para modificar la configuración de una regla de firewall de Compute Engine existente. Esta acción te permite actualizar parámetros específicos y, al mismo tiempo, mantener la identidad de la regla.

Esta acción no se ejecuta en las entidades de Google SecOps.

Nota: Esta acción se ejecuta de forma asíncrona. Ajusta el valor de tiempo de espera del script en el IDE de Google SecOps según sea necesario para garantizar que la acción tenga tiempo suficiente para completar la solicitud.

Entradas de acción

La acción Update Firewall Rule requiere los siguientes parámetros:

Parámetros	Descripción
Firewall Rule	Es opcional. Es el nombre de la regla de firewall específica que se actualizará.
Project ID	Es opcional. Es el ID del proyecto asociado con la instancia de Compute Engine. Si no se proporciona ningún valor, la acción recupera el ID del proyecto de la configuración de la integración.
Resource Name	Es opcional. Es el nombre completo del recurso de la instancia de Compute Engine, con el formato /projects/PROJECT_ID/global/ firewallsFIREWALL. Este parámetro tiene prioridad sobre Project ID y Firewall Rule.
Source IP Ranges	Es opcional. Es una lista separada por comas de los rangos de direcciones IP de origen para la regla de firewall. Si se establece el valor none, la acción borra todos los rangos de IP de origen existentes de la regla. Si no se proporciona ningún valor, los valores existentes no se modifican.
Source Tags	Es opcional. Es una lista separada por comas de etiquetas de red de origen que se aplicarán a la regla. Si se establece el valor none, la acción borra todas las etiquetas fuente existentes de la regla. Si no se proporciona ningún valor, los valores existentes no se modifican.
Source Service Accounts	Es opcional. Es una lista separada por comas de las cuentas de servicio de origen que se aplicarán a la regla. Si se establece el valor none, la acción borra todas las cuentas de servicio de origen existentes de la regla. Si no se proporciona ningún valor, los valores existentes no se modifican.
TCP Ports	Es opcional. Es una lista separada por comas de puertos TCP o rangos de puertos que se pueden permitir o rechazar. Este parámetro admite los valores all y none. Si se configura, la acción actualiza el protocolo y la lista de puertos de la regla de firewall con este valor.
UDP Ports	Es opcional. Es una lista separada por comas de puertos o rangos de puertos UDP que se pueden permitir o rechazar. Este parámetro admite los valores all y none. Si se configura, la acción actualiza el protocolo y la lista de puertos de la regla de firewall con este valor.
Other Protocols	Es opcional. Lista de protocolos separados por comas que no sean TCP ni UDP para incluir en la regla. Si se establece el valor de none, la acción actualiza la lista de protocolos de la regla de firewall con este valor.
Destination IP Ranges	Es opcional. Es una lista separada por comas de los rangos de direcciones IP de destino para la regla de firewall. Si se establece el valor none, la acción borra todos los rangos de IP de destino existentes de la regla. Si no se proporciona ningún valor, los valores existentes no se modifican.

Resultados de la acción

La acción Update Firewall Rule proporciona los siguientes resultados:

Tipo de salida de la acción	Disponibilidad
Adjunto del muro de casos	No disponible
Vínculo al muro de casos	No disponible
Tabla del muro de casos	No disponible
Tabla de enriquecimiento	No disponible
Resultado de JSON	Disponible
Mensajes de salida	Disponible
Resultado de secuencia de comandos	Disponible

Resultado de JSON

En el siguiente ejemplo, se describe el resultado JSON que se recibe cuando se usa la acción 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": "[e-mail]",
  "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"
  }
}

Mensajes de salida

La acción Update Firewall Rule puede devolver los siguientes mensajes de salida:

Mensaje de salida	Descripción del mensaje
Successfully updated firewall rule in Cloud Compute. Updating firewall rule in Cloud Compute.	La acción se realizó correctamente.
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.	No se pudo realizar la acción. Verifica la conexión al servidor, los parámetros de entrada o las credenciales.

Resultado de secuencia de comandos

En la siguiente tabla, se indica el valor del resultado del script cuando se usa la acción Update Firewall Rule:

Nombre del resultado de la secuencia de comandos	Valor
is_success	true o false

¿Necesitas más ayuda? Obtén respuestas de miembros de la comunidad y profesionales de Google SecOps.