Integrar o Compute Engine ao Google SecOps

Neste documento, explicamos como integrar o Compute Engine ao Google Security Operations.

Importante: na plataforma do Google SecOps, a integração para o Compute Engine é chamada de Google Cloud Compute.

Casos de uso

A integração do Compute Engine usa os recursos do Google SecOps para oferecer suporte aos seguintes casos de uso:

• Resposta automatizada a incidentes: isole automaticamente da rede uma instância comprometida do Compute Engine. A contenção automatizada limita a disseminação do ataque, acelera o tempo de resposta e reduz a carga de trabalho da equipe de segurança.

• Busca e investigação de ameaças: automatize a coleta de registros e telemetria de segurança de instâncias do Compute Engine em vários projetos. A análise desses dados consolidados permite a busca proativa de ameaças e acelera as investigações ao automatizar a coleta de dados.

• Gestão de vulnerabilidades: integre ferramentas de verificação de vulnerabilidades ao Google SecOps para verificar automaticamente se há vulnerabilidades conhecidas nas instâncias do Compute Engine. Gere tíquetes de correção ou corrija vulnerabilidades diretamente para reduzir o risco de exploração e melhorar a postura de segurança.

• Automação de compliance: automatize a coleta de registros de auditoria e dados de configuração de instâncias do Compute Engine para obedecer aos requisitos regulatórios. Gere relatórios e painéis para que os auditores simplifiquem os relatórios de compliance e reduzam o esforço manual.

• Orquestração de segurança: orquestre fluxos de trabalho de segurança em vários serviços doGoogle Cloud , incluindo o Compute Engine. Por exemplo, acionar a criação de uma nova regra de firewall em resposta a uma ocorrência de segurança detectada em uma instância, levando a uma postura de segurança mais coordenada e automatizada.

Antes de começar

Antes de configurar a integração do Compute Engine no Google SecOps, conclua as seguintes etapas de pré-requisito:

1. Criar e configurar um papel personalizado do Identity and Access Management.

2. Crie uma conta de serviço.

3. Escolha e configure um dos seguintes métodos de autenticação:

   • Opção 1: Identidade da carga de trabalho (recomendado): esse método usa tokens de acesso temporários e de curta duração usando a identidade temporária de conta de serviço.

   • Opção 2: chave JSON da conta de serviço: esse método depende de um arquivo de chave secreta estático e de longa duração.

Criar um papel personalizado do IAM

Para fornecer à integração as permissões específicas necessárias para gerenciar suas instâncias, crie um papel personalizado:

1. No console do Google Cloud , acesse IAM e administrador > Papéis.

   Acessar "Papéis"

2. Clique em addCriar papel personalizado.

3. Forneça um Título (por exemplo, SecOps Compute Engine Integration), uma Descrição e um ID exclusivo.

4. Defina o Estágio de lançamento do papel como Disponibilidade geral.

5. Clique em Adicionar permissões e adicione o seguinte:

   • 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. Clique em Criar.

Criar uma conta de serviço

1. No console do Google Cloud , acesse IAM e administrador > Contas de serviço.

   Acessar a página "Contas de serviço"

2. Clique em addCriar conta de serviço.

3. Insira um nome e uma descrição e clique em Criar e continuar.

4. Na etapa Conceder a essa conta de serviço acesso ao projeto, atribua o papel personalizado que você criou.

5. Clique em Concluído. Anote o endereço de e-mail da conta de serviço.

Configurar credenciais da Identidade da carga de trabalho

A Identidade da carga de trabalho é a abordagem recomendada porque usa tokens de acesso de curta duração que usam a identidade temporária de conta de serviço.

Identificar a identidade exclusiva da instância

Para estabelecer uma conexão, é necessário conceder à instância do Google SecOps permissão para personificar sua conta de serviço.

1. No Google SecOps, acesse Hub de conteúdo > Integrações de resposta.

2. Selecione a integração do Compute Engine e insira o e-mail da conta de serviço em Workload Identity Email.

3. Clique em Salvar > Testar. O teste deve falhar.

4. Clique no botão close_small ao lado de Teste e localize o e-mail de identidade que começa com gke-init-python@... ou soar-python@....

5. Copie esse endereço de e-mail exclusivo.

Autorize a identidade da instância em Google Cloud

1. No console do Google Cloud , acesse IAM e administrador > Contas de serviço.

   Acessar a página "Contas de serviço"

2. Selecione a conta de serviço de destino e acesse Permissões > Conceder acesso.

3. Cole o endereço de e-mail exclusivo no campo Novos principais e atribua o papel Criador de token da conta de serviço (roles/iam.serviceAccountTokenCreator).

Configurar uma chave JSON

Os arquivos de chave secreta estáticos e de longa duração exigem rotação manual. Use esse método somente se a autenticação da Identidade da carga de trabalho não estiver disponível.

1. No console do Google Cloud , acesse IAM e administrador > Contas de serviço e selecione sua conta de serviço.

   Acessar a página "Contas de serviço"

2. Acesse a guia Chaves e clique em Adicionar chave > Criar nova chave.

3. Selecione JSON e clique em Criar. O download do arquivo é feito automaticamente no seu computador.

Configurar parâmetros individuais manuais

Se você optar por inserir as credenciais manualmente, mantenha o arquivo de chave JSON salvo aberto em um editor de texto para copiar os valores individuais necessários nas configurações de integração.

Parâmetros de integração

Para estabelecer uma conexão entre o Google SecOps e o Compute Engine, configure os parâmetros a seguir. A integração é compatível com três caminhos de autenticação distintos. Escolha um dos métodos a seguir para fornecer credenciais:

• Identidade da carga de trabalho: usa Workload Identity Email.
• Arquivo JSON da conta de serviço: usa Service Account Json File Content para fornecer a chave inteira de uma só vez.
• Parâmetros individuais manuais: usa campos separados copiados manualmente de uma chave JSON.

Parâmetro	Descrição
API Root	Opcional. O URL de base da API Compute Engine. O valor padrão é https://compute.googleapis.com.
OS Config API Root	Opcional. O URL de base da API Cloud OS Config. O valor padrão é https://osconfig.googleapis.com.
Workload Identity Email	Opcional. O endereço de e-mail do cliente da sua conta de serviço. Use isso para autenticação da Identidade da carga de trabalho.
Service Account Json File Content	Opcional. O conteúdo completo do arquivo JSON da chave da conta de serviço. Se configurada, a integração ignora os parâmetros de credenciais individuais.
Project ID	Opcional. O ID do projeto do Google Cloud a ser segmentado. Se nenhum valor for fornecido, a integração vai recuperar o ID das credenciais da conta de serviço.
Verify SSL	Obrigatório. Valida o certificado SSL da conexão. Ativado por padrão.

Parâmetros de credenciais individuais

Use os parâmetros a seguir apenas se estiver inserindo credenciais manualmente, em vez de usar o conteúdo completo do arquivo JSON ou uma Identidade da carga de trabalho.

Parâmetro	Descrição
Account Type	Opcional. O valor encontrado no campo type da chave JSON (geralmente service_account).
Private Key ID	Opcional. O valor encontrado no campo private_key_id da chave JSON.
Private Key	Opcional. O valor encontrado no campo private_key da chave JSON.
Client Email	Opcional. O valor encontrado no campo client_email da chave JSON.
Client ID	Opcional. O valor encontrado no campo client_id da chave JSON.
Auth URI	Opcional. O valor encontrado no campo auth_uri da chave JSON. O valor padrão é https://accounts.google.com/o/oauth2/auth.
Token URI	Opcional. O valor encontrado no campo token_uri da chave JSON. O padrão é https://oauth2.googleapis.com/token.
Auth Provider X509 URL	Opcional. O valor encontrado no campo auth_provider_x509_cert_url da sua chave JSON.
Client X509 URL	Opcional. O valor encontrado no campo client_x509_cert_url da chave JSON.

Para instruções sobre como configurar uma integração no Google SecOps, consulte Configurar integrações.

Se necessário, você pode fazer mudanças depois. Depois de configurar uma instância de integração, é possível usá-la em playbooks. Para mais informações sobre como configurar e oferecer suporte a várias instâncias, consulte Como oferecer suporte a várias instâncias.

Ações

Para mais informações sobre ações, consulte Responder a ações pendentes na sua mesa de trabalho e Executar uma ação manual no seu caso.

Adicionar IP à regra de firewall

Use a ação Adicionar intervalo de IP à regra de firewall para anexar um intervalo de IP a uma regra de firewall atual em uma instância do Compute Engine.

Essa ação não é executada em entidades do Google SecOps.

Observação: essa ação é executada de forma assíncrona. Ajuste o valor do tempo limite do script no ambiente de desenvolvimento integrado do Google SecOps conforme necessário para garantir que a ação tenha tempo suficiente para concluir a solicitação.

Entradas da ação

A ação Adicionar IP à regra de firewall requer os seguintes parâmetros:

Parâmetro	Descrição
Resource Name	Opcional. O nome completo do recurso da instância do Compute Engine, no formato /projects/PROJECT_ID/global/ firewallsFIREWALL. Esse parâmetro tem prioridade sobre Project ID e Firewall Rule.
Project ID	Opcional. O nome do projeto associado à instância do Compute Engine. Se nenhum valor for fornecido, a ação usará o ID do projeto da configuração de integração.
Firewall Rule	Opcional. O nome da regra de firewall específica a ser atualizada.
Type	Obrigatório. A direção do tráfego para o intervalo de IP que está sendo adicionado. Os valores possíveis são os seguintes: Source Destination O valor padrão é Source.
IP Ranges	Obrigatório. Uma lista separada por vírgulas de intervalos de endereços IP (notação CIDR) para adicionar à regra de firewall.

Saídas da ação

A ação Adicionar IP à regra de firewall fornece as seguintes saídas:

Tipo de saída da ação	Disponibilidade
Anexo do Painel de Casos	Indisponível
Link do Painel de Casos	Indisponível
Tabela do painel de casos	Indisponível
Tabela de enriquecimento	Indisponível
Resultado JSON	Disponível
Mensagens de saída	Disponível
Resultado do script	Disponível

Resultado JSON

O exemplo a seguir mostra a saída do resultado JSON recebida ao usar a ação Adicionar IP à regra 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": "[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"
  }
}

Mensagens de saída

A ação Adicionar IP à regra de firewall pode retornar as seguintes mensagens de saída:

Mensagem de resposta	Descrição da mensagem
Successfully updated firewall rule in Google Cloud Compute. Waiting for the operation to finish execution on the RESOURCE_PATH instance in Google Cloud Compute.	A ação foi concluída.
Error executing action "Add IP To Firewall Rule". Reason: ERROR_REASON	A ação falhou. Verifique a conexão com o servidor, os parâmetros de entrada ou as credenciais.

Resultado do script

A tabela a seguir lista o valor da saída do resultado do script ao usar a ação Adicionar IP à regra de firewall:

Nome do resultado do script	Valor
is_success	true ou false

Adicionar rótulos à instância

Use a ação Adicionar rótulos à instância para adicionar ou atualizar rótulos em uma instância específica do Compute Engine.

Essa ação não é executada em entidades do Google SecOps.

Entradas da ação

A ação Adicionar rótulos à instância requer os seguintes parâmetros:

Parâmetro	Descrição
Resource Name	Opcional. O nome completo do recurso da instância do Compute Engine, no formato /project/PROJECT_ID/zone/ ZONE_ID/instances/ INSTANCE_ID. Esse parâmetro tem prioridade sobre Project ID, Instance Zone e Instance ID.
Project ID	Opcional. O ID do projeto associado à instância do Compute Engine. Se nenhum valor for fornecido, a ação vai recuperar o ID do projeto da configuração da integração.
Instance Zone	Opcional. A zona específica em que a instância está localizada. Esse parâmetro é obrigatório se você estiver identificando a instância usando Instance Zone e Instance ID.
Instance ID	Opcional. O ID exclusivo da instância do Compute Engine. Esse parâmetro é obrigatório se você estiver identificando a instância usando Instance Zone e Instance ID.
Instance Labels	Obrigatório. Uma lista de rótulos separados por vírgulas a serem aplicados à instância, no formato key:value (como vm_label_key:label1).

Saídas da ação

A ação Adicionar rótulos à instância fornece as seguintes saídas:

Tipo de saída da ação	Disponibilidade
Anexo do Painel de Casos	Indisponível
Link do Painel de Casos	Indisponível
Tabela do painel de casos	Indisponível
Tabela de enriquecimento	Indisponível
Resultado JSON	Disponível
Mensagens de saída	Disponível
Resultado do script	Disponível

Resultado JSON

O exemplo a seguir descreve a saída do resultado JSON recebida ao usar a ação Adicionar rótulos à instância:

{
   "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"
}

Mensagens de saída

A ação Adicionar rótulos à instância pode retornar as seguintes mensagens de saída:

Mensagem de resposta	Descrição da mensagem
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.	A ação foi concluída.
Error executing action "Add Labels to Instance". Reason: ERROR_REASON	A ação falhou. Verifique a conexão com o servidor, os parâmetros de entrada ou as credenciais.

Resultado do script

A tabela a seguir lista o valor da saída do resultado do script ao usar a ação Adicionar rótulos à instância:

Nome do resultado do script	Valor
is_success	true ou false

Adicionar tags de rede

Use a ação Adicionar tags de rede para anexar uma ou mais tags de rede a uma instância específica do Compute Engine.

Essa ação não é executada em entidades do Google SecOps.

Observação: essa ação é executada de forma assíncrona. Ajuste o valor do tempo limite do script no ambiente de desenvolvimento integrado do Google SecOps conforme necessário para garantir que a ação tenha tempo suficiente para concluir a solicitação.

Entradas da ação

A ação Adicionar tags de rede requer os seguintes parâmetros:

Parâmetro	Descrição
Resource Name	Opcional. O nome completo do recurso da instância do Compute Engine, no formato /project/PROJECT_ID/zone/ ZONE_ID/instances/ INSTANCE_ID. Esse parâmetro tem prioridade sobre Project ID, Instance Zone e Instance ID.
Project ID	Opcional. O ID do projeto associado à instância do Compute Engine. Se nenhum valor for fornecido, a ação vai recuperar o ID do projeto da configuração da integração.
Instance Zone	Opcional. A zona específica em que a instância está localizada. Esse parâmetro é obrigatório se você estiver identificando a instância usando Instance Zone e Instance ID.
Instance ID	Opcional. O ID exclusivo da instância do Compute Engine. Esse parâmetro é obrigatório se você estiver identificando a instância usando Instance Zone e Instance ID.
Network Tags	Obrigatório. Uma lista separada por vírgulas de tags de rede para adicionar à instância. Todas as tags precisam conter apenas letras minúsculas, números e hífens.

Saídas da ação

A ação Adicionar tags de rede fornece as seguintes saídas:

Tipo de saída da ação	Disponibilidade
Anexo do Painel de Casos	Indisponível
Link do Painel de Casos	Indisponível
Tabela do painel de casos	Indisponível
Tabela de enriquecimento	Indisponível
Resultado JSON	Disponível
Mensagens de saída	Disponível
Resultado do script	Disponível

Resultado JSON

O exemplo a seguir mostra a saída do resultado JSON recebida ao usar a ação Adicionar tags de rede:

{
  "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
  }
}

Mensagens de saída

A ação Adicionar tags de rede pode retornar as seguintes mensagens de saída:

Mensagem de resposta	Descrição da mensagem
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.	A ação foi concluída.
Error executing action "Add Network Tags". Reason: ERROR_REASON	A ação falhou. Verifique a conexão com o servidor, os parâmetros de entrada ou as credenciais.

Resultado do script

A tabela a seguir lista o valor da saída do resultado do script ao usar a ação Adicionar tags de rede:

Nome do resultado do script	Valor
is_success	true ou false

Excluir instância

Use a ação Excluir instância para excluir instâncias do Compute Engine.

Essa ação não é executada em entidades do Google SecOps.

Entradas da ação

A ação Excluir instância requer os seguintes parâmetros:

Parâmetro	Descrição
Resource Name	Opcional. O nome completo do recurso da instância do Compute Engine, no formato /project/PROJECT_ID/zone/ ZONE_ID/instances/ INSTANCE_ID. Esse parâmetro tem prioridade sobre Project ID, Instance Zone e Instance ID.
Project ID	Opcional. O ID do projeto associado à instância do Compute Engine. Se nenhum valor for fornecido, a ação vai recuperar o ID do projeto da configuração da integração.
Instance Zone	Opcional. A zona específica em que a instância está localizada. Esse parâmetro é obrigatório se você estiver identificando a instância usando Instance Zone e Instance ID.
Instance ID	Opcional. O ID exclusivo da instância que você quer iniciar. É possível recuperar esse valor usando a ação Listar instâncias. Esse parâmetro é obrigatório se você estiver identificando a instância usando Instance Zone e Instance ID.

Saídas da ação

A ação Excluir instância fornece as seguintes saídas:

Tipo de saída da ação	Disponibilidade
Anexo do Painel de Casos	Indisponível
Link do Painel de Casos	Indisponível
Tabela do painel de casos	Indisponível
Tabela de enriquecimento	Indisponível
Resultado JSON	Disponível
Mensagens de saída	Disponível
Resultado do script	Disponível

Resultado JSON

O exemplo a seguir descreve a saída do resultado JSON recebida ao usar a ação Excluir instância:

{
   "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"
}

Mensagens de saída

A ação Excluir instância pode retornar as seguintes mensagens de saída:

Mensagem de resposta	Descrição da mensagem
Compute Engine instance INSTANCE_ID was deleted successfully. Provided instance zone ZONE_ID is not valid. Provided instance ID is not valid.	A ação foi concluída.
Error executing action "Start Instance". Reason: ERROR_REASON Provided resource RESOURCE_PATH is not valid	A ação falhou. Verifique a conexão com o servidor, os parâmetros de entrada ou as credenciais.

Resultado do script

A tabela a seguir lista o valor da saída do resultado do script ao usar a ação Excluir instância:

Nome do resultado do script	Valor
is_success	true ou false

Enriquecer entidades

Use a ação Enriquecer entidades para enriquecer as entidades do Google SecOps IP Address com as informações da instância do Compute Engine.

Essa ação é executada nas seguintes entidades do Google SecOps:

• IP Address

Entradas da ação

A ação Enriquecer entidades requer os seguintes parâmetros:

Parâmetros	Descrição
Project ID	Opcional. O ID do projeto associado à instância do Compute Engine. Se nenhum valor for fornecido, a ação vai recuperar o ID do projeto da configuração da integração.
Instance Zone	Opcional. A zona específica em que a instância está localizada.

Saídas da ação

A ação Enriquecer entidades fornece as seguintes saídas:

Tipo de saída da ação	Disponibilidade
Anexo do Painel de Casos	Indisponível
Link do Painel de Casos	Indisponível
Tabela do painel de casos	Disponível
Tabela de enriquecimento	Disponível
Resultado JSON	Disponível
Mensagens de saída	Disponível
Resultado do script	Disponível

Tabela do painel de casos

Depois de concluir a execução, a ação Enriquecer entidades fornece a seguinte tabela:

Nome da tabela: Tabela de enriquecimento de ENTITY

Colunas:

• Campo de entidade
• Valor

Tabela de enriquecimento

A ação Enriquecer entidades é compatível com o seguinte enriquecimento de entidade:

Campo de enriquecimento	Origem (chave JSON)	Lógica
Google_Compute_instance_id	id	Indisponível
Google_Compute_creation_timestamp	creationTimestamp	Indisponível
Google_Compute_instance_name	name	Indisponível
Google_Compute_description	description	Indisponível
Google_Compute_tags	tags	Forneça as tags em uma lista CSV
Google_Compute_machine_type	machineType	Indisponível
Google_Compute_instance_status	status	Indisponível
Google_Compute_instance_zone	zone	Indisponível
Google_Compute_can_ip_forward	canIpForward	Indisponível
Google_Compute_instance_network_interfaces_name_INDEX	networkInterfaces.name	Abrir se houver mais interfaces de rede disponíveis
Google_Compute_instance_network_interfaces_name_access_configs_type_INDEX	networkInterfaces.accessConfigs.type	Abrir se houver mais interfaces de rede disponíveis
Google_Compute_instance_network_interfaces_name_access_configs_name_INDEX	networkInterfaces.accessConfigs.name	Abrir se houver mais interfaces de rede disponíveis
Google_Compute_instance_network_interfaces_name_access_configs_natIP_INDEX	networkInterfaces.accessConfigs.natIP	Expanda se houver mais interfaces de rede disponíveis
Google_Compute_instance_metadata	metadata	Lista CSV de valores dos metadados da instância
Google_Compute_service_account_INDEX	serviceAccounts.email	Abra se houver mais contas de serviço disponíveis.
Google_Compute_service_account_scopes_INDEX	serviceAccounts.scopes	Abra se houver mais contas de serviço disponíveis.
Google_Compute_link_to_Google_Compute	selfLink	Indisponível
Google_Compute_labels	labels	Fornecer uma lista de valores em CSV
Google_Compute_instance_last_start_timestamp	lastStartTimestamp	Indisponível
Google_Compute_instance_last_stop_timestamp	lastStopTimestamp	Indisponível

Resultado JSON

O exemplo a seguir descreve a saída do resultado JSON recebida ao usar a ação 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"
}

Mensagens de saída

A ação Enrich Entities pode retornar as seguintes mensagens de saída:

Mensagem de resposta	Descrição da mensagem
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.	A ação foi concluída.
Error executing action "Enrich Entities". Reason: ERROR_REASON	A ação falhou. Verifique a conexão com o servidor, os parâmetros de entrada ou as credenciais.

Resultado do script

A tabela a seguir lista o valor da saída do resultado do script ao usar a ação Enriquecer entidades:

Nome do resultado do script	Valor
is_success	true ou false

Executar job de patch de VM

Use a ação Executar job de patch de VM para executar um job de patch de VM em instâncias do Compute Engine.

Essa ação não é executada em entidades do Google SecOps.

Observação: essa ação é executada de forma assíncrona. Ajuste o valor do tempo limite do script no ambiente de desenvolvimento integrado do Google SecOps conforme necessário para garantir que a ação tenha tempo suficiente para concluir a solicitação.

Importante: a ação Executar job de patch de VM exige que você ative a API OS Config.

Entradas da ação

A ação Executar job de patch de VM requer os seguintes parâmetros:

Parâmetro	Descrição
Instance Filter Object	Obrigatório. O objeto JSON usado para segmentar instâncias específicas para aplicação de patches. O valor padrão segmenta todas as instâncias: { "all": "true" }
Name	Obrigatório. O nome exclusivo do job de aplicação de patch.
Description	Opcional. Uma breve descrição da finalidade do job de aplicação de patch.
Patching Config Object	Opcional. Um objeto JSON que define as etapas e configurações de atualização específicas para diferentes sistemas operacionais. Se nenhum valor for fornecido, a ação vai usar o seguinte valor padrão: { "rebootConfig": "DEFAULT", "apt": { "type": "DIST" }, "yum": { "security": true }, "zypper": { "withUpdate": true }, "windowsUpdate": { "classifications": ["CRITICAL", "SECURITY"] } }
Patch Duration Timeout	Obrigatório. O tempo máximo, em minutos, permitido para a execução do job de aplicação de patch. O valor padrão é 60.
Rollout Strategy	Opcional. O método usado para implantar o patch em várias zonas. Os valores possíveis são os seguintes: Zone By Zone: os patches são aplicados a uma zona por vez para minimizar o risco. Concurrent Zones: os patches são aplicados a todas as zonas visadas simultaneamente para reduzir a janela de manutenção total. O valor padrão é Zone By Zone.
Disruption Budget	Obrigatório. O número ou a porcentagem de instâncias que podem ficar off-line ao mesmo tempo (por exemplo, 5 ou 10%). O valor padrão é 10%.
Wait For Completion	Obrigatório. Se selecionada, a ação vai permanecer ativa até que o job de aplicação de patch seja concluído. Ativado por padrão.
Fail If Completed With Errors	Obrigatório. Se selecionada, a ação falhará se o status do job for Completed with errors ou se atingir o limite de tempo limite. Esse parâmetro será ignorado se Wait For Completion estiver desativado. Ativado por padrão.

Saídas da ação

A ação Executar job de patch de VM fornece as seguintes saídas:

Tipo de saída da ação	Disponibilidade
Anexo do Painel de Casos	Indisponível
Link do Painel de Casos	Indisponível
Tabela do painel de casos	Indisponível
Tabela de enriquecimento	Indisponível
Resultado JSON	Disponível
Mensagens de saída	Disponível
Resultado do script	Disponível

Resultado JSON

O exemplo a seguir mostra a saída do resultado JSON recebida ao usar a ação Executar job de patch 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
                }
            }
        }

Mensagens de saída

A ação Executar job de patch de VM pode retornar as seguintes mensagens de saída:

Mensagem de resposta	Descrição da mensagem
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	A ação foi concluída.
Error executing action "Execute VM Patch Job". Reason: ERROR_REASON	A ação falhou. Verifique a conexão com o servidor, os parâmetros de entrada ou as credenciais.

Resultado do script

A tabela a seguir lista o valor da saída do resultado do script ao usar a ação Executar job de patch de VM:

Nome do resultado do script	Valor
is_success	true ou false

Receber política do IAM da instância

Use a ação Get Instance IAM Policy para recuperar a política de controle de acesso do Identity and Access Management (iam_name_short) para um recurso específico do Compute Engine.

Essa ação não é executada em entidades do Google SecOps.

Observação : se nenhuma política tiver sido explicitamente definida para o recurso, a ação retornará um objeto de política vazio.

Entradas da ação

A ação Get Instance IAM Policy requer os seguintes parâmetros:

Parâmetro	Descrição
Resource Name	Opcional. O nome completo do recurso da instância do Compute Engine, no formato /project/PROJECT_ID/zone/ ZONE_ID/instances/ INSTANCE_ID. Esse parâmetro tem prioridade sobre Project ID, Instance Zone e Instance ID.
Project ID	Opcional. O ID do projeto associado à instância do Compute Engine. Se nenhum valor for fornecido, a ação vai recuperar o ID do projeto da configuração da integração.
Instance Zone	Opcional. A zona específica em que a instância está localizada. Esse parâmetro é obrigatório se você estiver identificando a instância usando Instance Zone e Instance ID.
Instance ID	Opcional. O ID exclusivo da instância que você quer iniciar. É possível recuperar esse valor usando a ação Listar instâncias. Esse parâmetro é obrigatório se você estiver identificando a instância usando Instance Zone e Instance ID.

Saídas da ação

A ação Get Instance IAM Policy fornece as seguintes saídas:

Tipo de saída da ação	Disponibilidade
Anexo do Painel de Casos	Indisponível
Link do Painel de Casos	Indisponível
Tabela do painel de casos	Indisponível
Tabela de enriquecimento	Indisponível
Resultado JSON	Disponível
Mensagens de saída	Disponível
Resultado do script	Disponível

Resultado JSON

O exemplo a seguir descreve a saída do resultado JSON recebida ao usar a ação Get Instance IAM Policy:

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

Mensagens de saída

A ação Get Instance IAM Policy pode retornar as seguintes mensagens de saída:

Mensagem de resposta	Descrição da mensagem
Compute Engine instance INSTANCE_ID IAM policy was fetched successfully. Provided instance zone ZONE_ID is not valid. Provided instance ID is not valid.	A ação foi concluída.
Error executing action "Get Instance IAM Policy". Reason: ERROR_REASON	A ação falhou. Verifique a conexão com o servidor, os parâmetros de entrada ou as credenciais.

Resultado do script

A tabela a seguir lista o valor da saída do resultado do script ao usar a ação Get Instance IAM Policy:

Nome do resultado do script	Valor
is_success	true ou false

Listar instâncias

Use a ação Listar instâncias para listar instâncias do Compute Engine com base em critérios de pesquisa especificados.

Essa ação não é executada em entidades do Google SecOps.

Entradas da ação

A ação Listar instâncias requer os seguintes parâmetros:

Parâmetro	Descrição
Project ID	Opcional. O ID do projeto em que as instâncias serão listadas. Se nenhum valor for fornecido, a ação vai recuperar o ID do projeto da conta de serviço Google Cloud usada na configuração da integração.
Instance Zone	Opcional. A zona específica em que as instâncias serão pesquisadas. Se nenhum valor for fornecido, a ação vai pesquisar em todas as zonas disponíveis.
Instance Name	Opcional. O nome da instância a ser pesquisada. Esse parâmetro aceita vários valores como uma string separada por vírgulas.
Instance Status	Opcional. O estado atual das instâncias a serem incluídas nos resultados da pesquisa, como RUNNING ou TERMINATED. Esse parâmetro aceita vários valores como uma string separada por vírgulas.
Instance Labels	Opcional. Os rótulos usados para filtrar os resultados da instância, fornecidos no formato key:value (como env:production). Esse parâmetro aceita vários valores como uma string separada por vírgulas.
Max Rows to Return	Opcional. O número máximo de instâncias a serem retornadas nos resultados. O valor padrão é 50.

Saídas da ação

A ação Listar instâncias fornece as seguintes saídas:

Tipo de saída da ação	Disponibilidade
Anexo do Painel de Casos	Indisponível
Link do Painel de Casos	Indisponível
Tabela do painel de casos	Disponível
Tabela de enriquecimento	Indisponível
Resultado JSON	Disponível
Mensagens de saída	Disponível
Resultado do script	Disponível

Tabela do painel de casos

A ação Listar instâncias fornece a seguinte tabela:

Nome da tabela: Instâncias do Compute Engine

Colunas da tabela:

• Nome da instância
• ID da instância
• Horário de criação da instância
• Descrição da instância
• Tipo de instância
• Status da instância
• Rótulos de instância

Resultado JSON

O exemplo a seguir descreve a saída do resultado JSON recebida ao usar a ação Listar instâncias:

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

Mensagens de saída

A ação Listar instâncias pode retornar as seguintes mensagens de saída:

Mensagem de resposta	Descrição da mensagem
Successfully fetched Compute Engine instances. Provided instance zone ZONE_ID is not valid. No instances were found in Compute Engine.	A ação foi concluída.
Error executing action "List Instances". Reason: ERROR_REASON	A ação falhou. Verifique a conexão com o servidor, os parâmetros de entrada ou as credenciais.

Resultado do script

A tabela a seguir lista o valor da saída do resultado do script ao usar a ação Listar instâncias:

Nome do resultado do script	Valor
is_success	true ou false

Ping

Use a ação Ping para testar a conectividade com o Compute Engine.

Essa ação não é executada em entidades do Google SecOps.

Entradas da ação

Nenhuma.

Saídas da ação

A ação Ping fornece as seguintes saídas:

Tipo de saída da ação	Disponibilidade
Anexo do Painel de Casos	Indisponível
Link do Painel de Casos	Indisponível
Tabela do painel de casos	Indisponível
Tabela de enriquecimento	Indisponível
Resultado JSON	Indisponível
Mensagens de saída	Disponível
Resultado do script	Disponível

Mensagens de saída

A ação Ping pode retornar as seguintes mensagens de saída:

Mensagem de resposta	Descrição da mensagem
Successfully connected to the Compute Engine service with the provided connection parameters!	A ação foi concluída.
Failed to connect to the Compute Engine service! Error is ERROR_REASON	A ação falhou. Verifique a conexão com o servidor, os parâmetros de entrada ou as credenciais.

Resultado do script

A tabela a seguir lista o valor da saída do resultado do script ao usar a ação Ping:

Nome do resultado do script	Valor
is_success	true ou false

Remover endereços IP externos

Use a ação Remover endereços IP externos para remover endereços IP externo em uma instância do Compute Engine.

Essa ação não é executada em entidades do Google SecOps.

Observação: essa ação é executada de forma assíncrona. Ajuste o valor do tempo limite do script no ambiente de desenvolvimento integrado do Google SecOps conforme necessário para garantir que a ação tenha tempo suficiente para concluir a solicitação.

Entradas da ação

A ação Remover endereços IP externos requer os seguintes parâmetros:

Parâmetros	Descrição
Resource Name	Opcional. O nome completo do recurso da instância do Compute Engine, no formato /project/PROJECT_ID/zone/ ZONE_ID/instances/ INSTANCE_ID. Esse parâmetro tem prioridade sobre Project ID, Instance Zone e Instance ID.
Project ID	Opcional. O ID do projeto associado à instância do Compute Engine. Se nenhum valor for fornecido, a ação vai recuperar o ID do projeto da configuração da integração.
Instance Zone	Opcional. A zona específica em que a instância está localizada. Esse parâmetro será obrigatório se você estiver identificando a instância usando Instance Zone e Instance ID.
Instance ID	Opcional. O ID exclusivo da instância que você quer iniciar. É possível recuperar esse valor usando a ação Listar instâncias. Esse parâmetro será obrigatório se você estiver identificando a instância usando Instance Zone e Instance ID.
Network Interfaces	Opcional. Uma lista separada por vírgulas das interfaces de rede específicas a serem modificadas. Se nenhum valor for fornecido ou se você usar o caractere curinga *, a ação vai atualizar todas as interfaces de rede. O valor padrão é *.

Saídas da ação

A ação Remover endereços IP externos fornece as seguintes saídas:

Tipo de saída da ação	Disponibilidade
Anexo do Painel de Casos	Indisponível
Link do Painel de Casos	Indisponível
Tabela do painel de casos	Indisponível
Tabela de enriquecimento	Indisponível
Resultado JSON	Disponível
Mensagens de saída	Disponível
Resultado do script	Disponível

Resultado JSON

O exemplo a seguir descreve a saída do resultado JSON recebida ao usar a ação Remover endereços IP externos:

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

Mensagens de saída

A ação Remover endereços IP externos pode retornar as seguintes mensagens de saída:

Mensagem de resposta	Descrição da mensagem
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.	A ação foi concluída.
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.	A ação falhou. Verifique a conexão com o servidor, os parâmetros de entrada ou as credenciais.

Resultado do script

A tabela a seguir lista o valor da saída do resultado do script ao usar a ação Remover endereços IP externos:

Nome do resultado do script	Valor
is_success	true ou false

Remover IP da regra de firewall

Use a ação Remover IP da regra de firewall para excluir intervalos de endereços IP específicos de uma regra de firewall do Compute Engine.

Essa ação não é executada em entidades do Google SecOps.

Observação: essa ação é executada de forma assíncrona. Ajuste o valor do tempo limite do script no ambiente de desenvolvimento integrado do Google SecOps conforme necessário para garantir que a ação tenha tempo suficiente para concluir a solicitação.

Entradas da ação

A ação Remover IP da regra de firewall requer os seguintes parâmetros:

Parâmetro	Descrição
Resource Name	Opcional. O nome completo do recurso da instância do Compute Engine, no formato /projects/PROJECT_ID/global/ firewallsFIREWALL. Esse parâmetro tem prioridade sobre Project ID e Firewall Rule.
Project ID	Opcional. O ID do projeto associado à instância do Compute Engine. Se nenhum valor for fornecido, a ação vai recuperar o ID do projeto da configuração da integração.
Firewall Rule	Opcional. O nome da regra de firewall específica a ser atualizada.
Type	Obrigatório. A direção do tráfego para o intervalo de IP que está sendo adicionado. Os valores possíveis são os seguintes: Source Destination O valor padrão é Source.
IP Ranges	Obrigatório. Uma lista separada por vírgulas de intervalos de endereços IP (notação CIDR) para adicionar à regra de firewall.

Saídas da ação

A ação Remover IP da regra de firewall fornece as seguintes saídas:

Tipo de saída da ação	Disponibilidade
Anexo do Painel de Casos	Indisponível
Link do Painel de Casos	Indisponível
Tabela do painel de casos	Indisponível
Tabela de enriquecimento	Indisponível
Resultado JSON	Disponível
Mensagens de saída	Disponível
Resultado do script	Disponível

Resultado JSON

O exemplo a seguir mostra a saída do resultado JSON recebida ao usar a ação Remover IP da regra 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": "[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"
  }
}

Mensagens de saída

A ação Remover IP da regra de firewall pode retornar as seguintes mensagens de saída:

Mensagem de resposta	Descrição da mensagem
Successfully updated firewall rule in Google Cloud Compute. Waiting for the operation to finish execution on the RESOURCE_PATH instance in Google Cloud Compute.	A ação foi concluída.
Error executing action "Remove IP From Firewall Rule". Reason: ERROR_REASON	A ação falhou. Verifique a conexão com o servidor, os parâmetros de entrada ou as credenciais.

Resultado do script

A tabela a seguir lista o valor da saída do resultado do script ao usar a ação Remover IP da regra de firewall:

Nome do resultado do script	Valor
is_success	true ou false

Remover tags de rede

Use a ação Remover tags de rede para remover tags de rede da instância do Compute Engine.

Essa ação não é executada em entidades do Google SecOps.

Observação: essa ação é executada de forma assíncrona. Ajuste o valor do tempo limite do script no ambiente de desenvolvimento integrado do Google SecOps conforme necessário para garantir que a ação tenha tempo suficiente para concluir a solicitação.

Entradas da ação

A ação Remover tags de rede requer os seguintes parâmetros:

Parâmetro	Descrição
Resource Name	Opcional. O nome completo do recurso da instância do Compute Engine, no formato /project/PROJECT_ID/zone/ ZONE_ID/instances/ INSTANCE_ID. Esse parâmetro tem prioridade sobre Project ID, Instance Zone e Instance ID.
Project ID	Opcional. O ID do projeto associado à instância do Compute Engine. Se nenhum valor for fornecido, a ação vai recuperar o ID do projeto da configuração da integração.
Instance Zone	Opcional. A zona específica em que a instância está localizada. Esse parâmetro será obrigatório se você estiver identificando a instância usando Instance Zone e Instance ID.
Instance ID	Opcional. O ID exclusivo da instância que você quer iniciar. É possível recuperar esse valor usando a ação Listar instâncias. Esse parâmetro será obrigatório se você estiver identificando a instância usando Instance Zone e Instance ID.
Network Tags	Obrigatório. Uma lista separada por vírgulas de tags de rede para adicionar à instância. Todas as tags precisam conter apenas letras minúsculas, números e hífens.

Saídas da ação

A ação Remover tags de rede fornece as seguintes saídas:

Tipo de saída da ação	Disponibilidade
Anexo do Painel de Casos	Indisponível
Link do Painel de Casos	Indisponível
Tabela do painel de casos	Indisponível
Tabela de enriquecimento	Indisponível
Resultado JSON	Disponível
Mensagens de saída	Disponível
Resultado do script	Disponível

Resultado JSON

O exemplo a seguir mostra a saída do resultado JSON recebida ao usar a ação Exemplo:

{
  "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
  }
}

Mensagens de saída

A ação Remover tags de rede pode retornar as seguintes mensagens de saída:

Mensagem de resposta	Descrição da mensagem
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.	A ação foi concluída.
Error executing action "Remove Network Tags". Reason: ERROR_REASON	A ação falhou. Verifique a conexão com o servidor, os parâmetros de entrada ou as credenciais.

Resultado do script

A tabela a seguir lista o valor da saída do resultado do script ao usar a ação Remover tags de rede:

Nome do resultado do script	Valor
is_success	true ou false

Definir política de IAM da instância

Use a ação Definir política de IAM da instância para definir a política de controle de acesso do recurso especificado. A política fornecida na ação substitui qualquer política atual.

Essa ação não é executada em entidades do Google SecOps.

Entradas da ação

A ação Definir política de IAM da instância requer os seguintes parâmetros:

Parâmetros	Descrição
Resource Name	Opcional. O nome completo do recurso da instância do Compute Engine, no formato /project/PROJECT_ID/zone/ ZONE_ID/instances/ INSTANCE_ID. Esse parâmetro tem prioridade sobre Project ID, Instance Zone e Instance ID.
Project ID	Opcional. O ID do projeto associado à instância do Compute Engine. Se nenhum valor for fornecido, a ação vai recuperar o ID do projeto da configuração da integração.
Instance Zone	Opcional. A zona específica em que a instância está localizada. Esse parâmetro será obrigatório se você estiver identificando a instância usando Instance Zone e Instance ID.
Instance ID	Opcional. O ID exclusivo da instância que você quer iniciar. É possível recuperar esse valor usando a ação Listar instâncias. Esse parâmetro será obrigatório se você estiver identificando a instância usando Instance Zone e Instance ID.
Policy	Obrigatório. O documento de política do IAM a ser aplicado à instância, fornecido como um objeto JSON.

Saídas da ação

A ação Definir política do IAM da instância fornece as seguintes saídas:

Tipo de saída da ação	Disponibilidade
Anexo do Painel de Casos	Indisponível
Link do Painel de Casos	Indisponível
Tabela do painel de casos	Indisponível
Tabela de enriquecimento	Indisponível
Resultado JSON	Disponível
Mensagens de saída	Disponível
Resultado do script	Disponível

Resultado JSON

O exemplo a seguir descreve a saída do resultado JSON recebida ao usar a ação Definir política de IAM da instância:

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

Mensagens de saída

A ação Definir política de IAM da instância pode retornar as seguintes mensagens de saída:

Mensagem de resposta	Descrição da mensagem
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.	A ação foi concluída.
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.	A ação falhou. Verifique a conexão com o servidor, os parâmetros de entrada ou as credenciais.

Resultado do script

A tabela a seguir lista o valor da saída do resultado do script ao usar a ação Definir política de IAM da instância:

Nome do resultado do script	Valor
is_success	true ou false

Iniciar instância

Use a ação Iniciar instância para ligar uma instância do Compute Engine que esteja em um estado interrompido ou encerrado.

Essa ação não é executada em entidades do Google SecOps.

Observação: essa ação é executada de forma assíncrona. Ajuste o valor do tempo limite do script no ambiente de desenvolvimento integrado do Google SecOps conforme necessário para garantir que a ação tenha tempo suficiente para concluir a solicitação.

Entradas da ação

A ação Iniciar instância requer os seguintes parâmetros:

Parâmetros	Descrição
Resource Name	Opcional. O nome completo do recurso da instância do Compute Engine, no formato /project/PROJECT_ID/zone/ ZONE_ID/instances/ INSTANCE_ID. Esse parâmetro tem prioridade sobre Project ID, Instance Zone e Instance ID.
Project ID	Opcional. O ID do projeto associado à instância do Compute Engine. Se nenhum valor for fornecido, a ação vai recuperar o ID do projeto da configuração da integração.
Instance Zone	Opcional. A zona específica em que a instância está localizada. Esse parâmetro será obrigatório se você estiver identificando a instância usando Instance Zone e Instance ID.
Instance ID	Opcional. O ID exclusivo da instância que você quer iniciar. É possível recuperar esse valor usando a ação Listar instâncias. Esse parâmetro será obrigatório se você estiver identificando a instância usando Instance Zone e Instance ID.

Saídas da ação

A ação Iniciar instância fornece as seguintes saídas:

Tipo de saída da ação	Disponibilidade
Anexo do Painel de Casos	Indisponível
Link do Painel de Casos	Indisponível
Tabela do painel de casos	Indisponível
Tabela de enriquecimento	Indisponível
Resultado JSON	Disponível
Mensagens de saída	Disponível
Resultado do script	Disponível

Resultado JSON

O exemplo a seguir descreve a saída do resultado JSON recebida ao usar a ação Iniciar instância:

{
   "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"
}

Mensagens de saída

A ação Iniciar instância pode retornar as seguintes mensagens de saída:

Mensagem de resposta	Descrição da mensagem
Compute Engine instance RESOURCE_PATH was started successfully. Provided instance zone ZONE_ID is not valid. Provided instance ID is not valid.	A ação foi concluída.
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.	A ação falhou. Verifique a conexão com o servidor, os parâmetros de entrada ou as credenciais.

Resultado do script

A tabela a seguir lista o valor da saída do resultado do script ao usar a ação Iniciar instância:

Nome do resultado do script	Valor
is_success	true ou false

Interromper instância

Use a ação Interromper instância para encerrar uma instância do Compute Engine em execução. É possível reiniciar uma instância interrompida a qualquer momento.

A interrupção de uma instância interrompe as cobranças de uso da VM, mas as cobranças continuam sendo aplicadas aos recursos associados, como discos permanentes e endereços IP estáticos, a menos que esses recursos sejam excluídos.

Essa ação não é executada em entidades do Google SecOps.

Observação: essa ação é executada de forma assíncrona. Ajuste o valor do tempo limite do script no ambiente de desenvolvimento integrado do Google SecOps conforme necessário para garantir que a ação tenha tempo suficiente para concluir a solicitação.

Entradas da ação

A ação Interromper instância requer os seguintes parâmetros:

Parâmetros	Descrição
Resource Name	Opcional. O nome completo do recurso da instância do Compute Engine, no formato /project/PROJECT_ID/zone/ ZONE_ID/instances/ INSTANCE_ID. Esse parâmetro tem prioridade sobre Project ID, Instance Zone e Instance ID.
Project ID	Opcional. O ID do projeto associado à instância do Compute Engine. Se nenhum valor for fornecido, a ação vai recuperar o ID do projeto da configuração da integração.
Instance Zone	Opcional. A zona específica em que a instância está localizada. Esse parâmetro será obrigatório se você estiver identificando a instância usando Instance Zone e Instance ID.
Instance ID	Opcional. O ID exclusivo da instância que você quer iniciar. É possível recuperar esse valor usando a ação Listar instâncias. Esse parâmetro será obrigatório se você estiver identificando a instância usando Instance Zone e Instance ID.

Saídas da ação

A ação Interromper instância fornece as seguintes saídas:

Tipo de saída da ação	Disponibilidade
Anexo do Painel de Casos	Indisponível
Link do Painel de Casos	Indisponível
Tabela do painel de casos	Indisponível
Tabela de enriquecimento	Indisponível
Resultado JSON	Disponível
Mensagens de saída	Disponível
Resultado do script	Disponível

Resultado JSON

O exemplo a seguir descreve a saída do resultado JSON recebida ao usar a ação Interromper instância:

{
   "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"
}

Mensagens de saída

A ação Interromper instância pode retornar as seguintes mensagens de saída:

Mensagem de resposta	Descrição da mensagem
Compute Engine instance INSTANCE_ID was stopped successfully. Provided instance zone ZONE_ID is not valid. Provided instance ID is not valid.	A ação foi concluída.
Error executing action "Stop Instance". Reason: ERROR_REASON	A ação falhou. Verifique a conexão com o servidor, os parâmetros de entrada ou as credenciais.

Resultado do script

A tabela a seguir lista o valor da saída do resultado do script ao usar a ação Interromper instância:

Nome do resultado do script	Valor
is_success	true ou false

Atualizar regra de firewall

Use a ação Atualizar regra de firewall para modificar a configuração de uma regra de firewall do Compute Engine. Essa ação permite atualizar parâmetros específicos, mantendo a identidade da regra.

Essa ação não é executada em entidades do Google SecOps.

Observação: essa ação é executada de forma assíncrona. Ajuste o valor do tempo limite do script no ambiente de desenvolvimento integrado do Google SecOps conforme necessário para garantir que a ação tenha tempo suficiente para concluir a solicitação.

Entradas da ação

A ação Atualizar regra de firewall requer os seguintes parâmetros:

Parâmetros	Descrição
Firewall Rule	Opcional. O nome da regra de firewall específica a ser atualizada.
Project ID	Opcional. O ID do projeto associado à instância do Compute Engine. Se nenhum valor for fornecido, a ação vai recuperar o ID do projeto da configuração da integração.
Resource Name	Opcional. O nome completo do recurso da instância do Compute Engine, no formato /projects/PROJECT_ID/global/ firewallsFIREWALL. Esse parâmetro tem prioridade sobre Project ID e Firewall Rule.
Source IP Ranges	Opcional. Uma lista separada por vírgulas dos intervalos de endereços IP de origem para a regra de firewall. Se o valor none estiver definido, a ação excluirá todos os intervalos de IP de origem da regra. Se nenhum valor for fornecido, os valores atuais vão permanecer inalterados.
Source Tags	Opcional. Uma lista separada por vírgulas de tags de rede de origem para aplicar à regra. Se o valor none estiver definido, a ação vai excluir todas as tags de origem da regra. Se nenhum valor for fornecido, os valores atuais vão permanecer inalterados.
Source Service Accounts	Opcional. Uma lista separada por vírgulas de contas de serviço de origem a serem aplicadas à regra. Se o valor none estiver definido, a ação excluirá todas as contas de serviço de origem da regra. Se nenhum valor for fornecido, os valores atuais vão permanecer inalterados.
TCP Ports	Opcional. Uma lista separada por vírgulas de portas TCP ou intervalos de portas para permitir ou negar. Esse parâmetro é compatível com os valores all e none. Se configurada, a ação atualiza o protocolo e a lista de portas da regra de firewall com esse valor.
UDP Ports	Opcional. Uma lista separada por vírgulas de portas ou intervalos de portas UDP para permitir ou negar. Esse parâmetro é compatível com os valores all e none. Se configurada, a ação atualiza o protocolo e a lista de portas da regra de firewall com esse valor.
Other Protocols	Opcional. Uma lista separada por vírgulas de protocolos diferentes de TCP e UDP para incluir na regra. Se o valor none estiver definido, a ação atualizará a lista de protocolos da regra de firewall com esse valor.
Destination IP Ranges	Opcional. Uma lista separada por vírgulas dos intervalos de endereços IP de destino para a regra de firewall. Se o valor none for definido, a ação vai excluir todos os intervalos de IP de destino da regra. Se nenhum valor for fornecido, os valores atuais vão permanecer inalterados.

Saídas da ação

A ação Atualizar regra de firewall fornece as seguintes saídas:

Tipo de saída da ação	Disponibilidade
Anexo do Painel de Casos	Indisponível
Link do Painel de Casos	Indisponível
Tabela do painel de casos	Indisponível
Tabela de enriquecimento	Indisponível
Resultado JSON	Disponível
Mensagens de saída	Disponível
Resultado do script	Disponível

Resultado JSON

O exemplo a seguir descreve a saída do resultado JSON recebida ao usar a ação Atualizar regra 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": "[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"
  }
}

Mensagens de saída

A ação Atualizar regra de firewall pode retornar as seguintes mensagens de saída:

Mensagem de resposta	Descrição da mensagem
Successfully updated firewall rule in Cloud Compute. Updating firewall rule in Cloud Compute.	A ação foi concluída.
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.	A ação falhou. Verifique a conexão com o servidor, os parâmetros de entrada ou as credenciais.

Resultado do script

A tabela a seguir lista o valor da saída do resultado do script ao usar a ação Atualizar regra de firewall:

Nome do resultado do script	Valor
is_success	true ou false

Precisa de mais ajuda? Receba respostas de membros da comunidade e profissionais do Google SecOps.