Integra Compute Engine en Google SecOps

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

Casos de uso

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

  • Respuesta automatizada ante incidentes: Aísla automáticamente una instancia de Compute Engine comprometida de la red. 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 de amenazas e investigación: 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 automatizando la recopilación de datos.

  • Gestión de vulnerabilidades: Integra herramientas de análisis de vulnerabilidades con Google SecOps para analizar automáticamente las instancias de Compute Engine en busca de vulnerabilidades conocidas. Genera tickets de corrección o aplica parches a las 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 regulatorios. Genera informes y paneles para que los auditores simplifiquen los informes de cumplimiento y reduzcan el esfuerzo manual.

  • Organización de la seguridad: Organiza los flujos de trabajo de seguridad en varios servicios deGoogle Cloud , incluido Compute Engine. Por ejemplo, activa 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 de requisitos 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 (recomendado): Este método usa tokens de acceso temporales de corta duración con la identidad temporal como cuenta de servicio.

    • Opción 2: Clave JSON de la cuenta de servicio: Este método se basa en un archivo de clave secreta 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 addCrear 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 acceso al proyecto a esta cuenta de servicio, 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 las credenciales de Workload Identity

Workload Identity es el enfoque recomendado porque usa 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 que use la identidad de tu cuenta de servicio.

  1. En Google SecOps, ve a Centro de contenido > 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 > Probar. Se espera que la prueba falle.

  4. Haz clic en el botón close_small junto a Prueba 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 una 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.

Configura parámetros individuales de forma manual

Si eliges 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 la cuenta de servicio: Usa Service Account Json File Content para proporcionar la clave completa de una sola 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. Usa esto 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 de Google Cloud al que se orientará.

Si no se proporciona ningún valor, la integración recupera el ID de las credenciales de cuenta de servicio.
Verify SSL

Obligatorio.

Valida el certificado SSL para la conexión. Habilitada de forma predeterminada.

Parámetros de credenciales individuales

Usa los siguientes parámetros solo si ingresas las credenciales de forma manual, en lugar de usar el contenido completo del archivo JSON o una Workload Identity.

Parámetro Descripción
Account Type

Es opcional.

Es 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.

Para obtener instrucciones sobre cómo configurar una integración en Google SecOps, consulta Configura integraciones.

Si es necesario, puedes realizar cambios más adelante. Después de configurar una instancia de integración, puedes usarla en las guías. Para obtener más información sobre cómo configurar y admitir varias instancias, consulta Cómo admitir varias instancias.

Acciones

Para obtener más información sobre las acciones, consulta Responde a las acciones pendientes desde tu escritorio y Ejecuta una acción manual en tu caso.

Agrega una IP a la regla de firewall

Usa la acción Agregar rango de IP a la regla de firewall 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.

Entradas de acción

La acción Agregar IP a la regla de firewall 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, en 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.

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 Agregar IP a la regla de firewall proporciona los siguientes resultados:

Tipo de resultado de la acción Disponibilidad
Archivo 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 Agregar IP a la regla de 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"
  }
}
Mensajes de salida

La acción Agregar IP a la regla de firewall 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 con el servidor, los parámetros de entrada o las credenciales.
Resultado de secuencia de comandos

En la siguiente tabla, se muestra el valor de la salida del resultado de la secuencia de comandos cuando se usa la acción Agregar IP a la regla de firewall:

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

Agrega etiquetas a la instancia

Usa la acción Agregar etiquetas a la instancia 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 Agregar etiquetas a la instancia 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, en 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.

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 separada por comas de etiquetas 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 Agregar etiquetas a la instancia proporciona los siguientes resultados:

Tipo de resultado de la acción Disponibilidad
Archivo 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 Agregar etiquetas a la instancia:

{
   "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"
}
Mensajes de salida

La acción Agregar etiquetas a la instancia 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 con el 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 Agregar etiquetas a la instancia:

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 de Compute Engine específica.

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

Entradas de acción

La acción Agregar etiquetas de red 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, en 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.

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 separada por comas de etiquetas de red 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 resultado de la acción Disponibilidad
Archivo 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 Agregar etiquetas de red:

{
  "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
  }
}
Mensajes de salida

La acción Agregar etiquetas de red 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 con el 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 Agregar etiquetas de red:

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 Borrar instancia 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, en 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.

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 quieres 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 Borrar instancia proporciona los siguientes resultados:

Tipo de resultado de la acción Disponibilidad
Archivo 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 Borrar instancia:

{
   "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"
}
Mensajes de salida

La acción Borrar instancia 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 con el 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 Borrar instancia:

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 Google SecOps IP Address 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.

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 resultado de la acción Disponibilidad
Archivo 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 Enriquecer entidades 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 de 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 en formato CSV de los metadatos de la instancia
Google_Compute_service_account_INDEX serviceAccounts.email Expandir si hay más cuentas de servicio disponibles
Google_Compute_service_account_scopes_INDEX serviceAccounts.scopes Expandir 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": "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"
}
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 con el 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 Enrich Entities:

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

Ejecuta un trabajo de aplicación de parches de VM

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

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

Entradas de acción

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

Parámetro Descripción
Instance Filter Object

Obligatorio.

Es el objeto JSON que se usa para orientar instancias específicas para la aplicación de parches.

El valor predeterminado se aplica a todas las instancias:

{
  "all": "true"
}
Name

Obligatorio.

Es el nombre único del trabajo de aplicación de parches.
Description

Es opcional.

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 las configuraciones de actualización específicos 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, permitido 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 de destino 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, la acción falla 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 aplicación de parches de VM proporciona los siguientes resultados:

Tipo de resultado de la acción Disponibilidad
Archivo 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 aplicación de parches 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 aplicación de parches 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 con el 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 aplicación de parches de VM:

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

Obtener la política de IAM de la instancia

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

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

Entradas de acción

La acción Obtener la política de IAM de la instancia 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, en 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.

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 quieres 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 Obtener la política de IAM de la instancia proporciona los siguientes resultados:

Tipo de resultado de la acción Disponibilidad
Archivo 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 Obtener la política de IAM de la instancia:

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

La acción Obtener la política de IAM de la instancia 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 con el servidor, los parámetros de entrada o las credenciales.
Resultado de secuencia de comandos

En la siguiente tabla, se muestra el valor de la salida del resultado de la secuencia de comandos cuando se usa la acción Obtener la política de IAM de la instancia:

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

Enumerar instancias

Usa la acción Enumerar instancias 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 del 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 las instancias.

Si no se proporciona ningún valor, la acción busca 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 mostrará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 resultado de la acción Disponibilidad
Archivo 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
  • Tiempo 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": "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"
       }
   ]
}
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 con el 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 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 resultado de la acción Disponibilidad
Archivo 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 resultado:

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 con el 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

Quita las 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.

Entradas de acción

La acción Quita las direcciones IP externas 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, en 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.

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 quieres 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 Quita las direcciones IP externas proporciona los siguientes resultados:

Tipo de resultado de la acción Disponibilidad
Archivo 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 Quitar direcciones IP externas:

[
    {
        "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"
    }
]
Mensajes de salida

La acción Quitar direcciones IP externas 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 con el 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 Quitar direcciones IP externas:

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 Quitar IP de la regla de firewall para borrar rangos de direcciones IP específicos de una regla de firewall de Compute Engine existente.

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

Entradas de acción

La acción Quitar IP de la regla de firewall 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, en 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.

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 Quitar IP de la regla de firewall proporciona los siguientes resultados:

Tipo de resultado de la acción Disponibilidad
Archivo 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 Quitar IP de la regla de 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"
  }
}
Mensajes de salida

La acción Quitar IP de la regla de firewall 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 con el 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 Quitar IP de la regla de firewall:

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

Quita etiquetas de red

Usa la acción Quitar etiquetas de red para quitar las etiquetas de red de la instancia de Compute Engine.

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

Entradas de acción

La acción Quitar etiquetas de red 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, en 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.

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 quieres 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 separada por comas de etiquetas de red 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 Quitar etiquetas de red proporciona los siguientes resultados:

Tipo de resultado de la acción Disponibilidad
Archivo 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": "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
  }
}
Mensajes de salida

La acción Quitar etiquetas de red 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 con el 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 Quitar etiquetas de red:

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

Establece la política de IAM de la instancia

Usa la acción Establecer política de IAM de la instancia para configurar la política de control de acceso del 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 Establecer la política de IAM de la 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, en 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.

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 quieres 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.

Es el documento de la política de IAM que se aplicará a la instancia, proporcionado como un objeto JSON.

Resultados de la acción

La acción Establecer la política de IAM de la instancia proporciona los siguientes resultados:

Tipo de resultado de la acción Disponibilidad
Archivo 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 Establecer la política de IAM de la instancia:

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

La acción Establecer política de IAM de la instancia 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 con el 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 Establecer la política de IAM de la instancia:

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.

Entradas de acción

La acción Iniciar 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, en 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.

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 quieres 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 Iniciar instancia proporciona los siguientes resultados:

Tipo de resultado de la acción Disponibilidad
Archivo 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 Iniciar instancia:

{
   "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"
}
Mensajes de salida

La acción Iniciar instancia 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 con el 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 Iniciar instancia:

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.

Cuando detienes una instancia, se detienen 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.

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, en 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.

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 quieres 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 resultado de la acción Disponibilidad
Archivo 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": "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"
}
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 con el 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 Detener instancia:

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

Actualiza la regla de firewall

Usa la acción Actualizar regla de firewall para modificar la configuración de una regla de firewall de Compute Engine existente. Esta acción te permite actualizar parámetros específicos mientras mantienes la identidad de la regla.

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

Entradas de acción

La acción Actualizar regla de firewall 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, en 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 las 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 de origen 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 o rangos de puertos TCP que se permitirán o denegarán.

Este parámetro admite los valores all y none. Si se configura, la acción actualiza la lista de protocolos y 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 deben permitir o denegar.

Este parámetro admite los valores all y none. Si se configura, la acción actualiza la lista de protocolos y puertos de la regla de firewall con este valor.
Other Protocols

Es opcional.

Es una lista separada por comas de protocolos que no sean TCP ni UDP para incluir en la regla.

Si se establece el valor 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 Actualizar regla de firewall proporciona los siguientes resultados:

Tipo de resultado de la acción Disponibilidad
Archivo 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 Actualizar regla de 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"
  }
}
Mensajes de salida

La acción Actualizar regla de firewall 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 con el 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 Actualizar regla de firewall:

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.