Intégrer Compute Engine à Google SecOps

Ce document explique comment intégrer Compute Engine à Google Security Operations.

Cas d'utilisation

L'intégration Compute Engine utilise les fonctionnalités Google SecOps pour prendre en charge les cas d'utilisation suivants :

  • Réponse automatisée aux incidents : isolez automatiquement une instance Compute Engine compromise du réseau. Le confinement automatisé limite la propagation de l'attaque, accélère le temps de réponse et réduit la charge de travail de l'équipe de sécurité.

  • Chasse et investigation des menaces : automatisez la collecte des journaux et des données de télémétrie de sécurité des instances Compute Engine dans plusieurs projets. L'analyse de ces données consolidées permet de traquer les menaces de manière proactive et d'accélérer les investigations en automatisant la collecte de données.

  • Gestion des failles : intégrez des outils d'analyse des failles à Google SecOps pour analyser automatiquement les instances Compute Engine et détecter les failles connues. Générez des tickets de correction ou corrigez directement les failles pour réduire le risque d'exploitation et améliorer votre niveau de sécurité.

  • Automatisation de la conformité : automatisez la collecte des journaux d'audit et des données de configuration des instances Compute Engine pour respecter les exigences réglementaires. Générez des rapports et des tableaux de bord pour les auditeurs afin de simplifier les rapports de conformité et de réduire les efforts manuels.

  • Orchestration de la sécurité : orchestrez les workflows de sécurité sur plusieurs servicesGoogle Cloud , y compris Compute Engine. Par exemple, déclenchez la création d'une règle de pare-feu en réponse à un événement de sécurité détecté sur une instance, ce qui permet d'adopter une posture de sécurité plus coordonnée et automatisée.

Avant de commencer

Avant de configurer l'intégration Compute Engine dans Google SecOps, effectuez les étapes préalables suivantes :

  1. Créez et configurez un rôle Identity and Access Management personnalisé.

  2. Créez un compte de service.

  3. Choisissez et configurez l'une des méthodes d'authentification suivantes :

    • Option 1 : Workload Identity (recommandée) : cette méthode utilise des jetons d'accès temporaires de courte durée grâce à l'emprunt d'identité d'un compte de service.

    • Option 2 : clé JSON du compte de service : cette méthode repose sur un fichier de clé secrète statique et durable.

Créer un rôle IAM personnalisé

Pour fournir à l'intégration les autorisations spécifiques requises pour gérer vos instances, créez un rôle personnalisé :

  1. Dans la console Google Cloud , accédez à IAM et administration > Rôles.

    Accéder à la page "Rôles"

  2. Cliquez sur Ajouter > Créer un rôle personnalisé.

  3. Indiquez un titre (par exemple, SecOps Compute Engine Integration), une description et un ID unique.

  4. Définissez l'étape de lancement du rôle sur Disponibilité générale.

  5. Cliquez sur Ajouter des autorisations, puis ajoutez les éléments suivants :

    • 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. Cliquez sur Créer.

Créer un compte de service

  1. Dans la console Google Cloud , accédez à IAM et administration > Comptes de service.

    Accéder à la page "Comptes de service"

  2. Cliquez sur add Créer un compte de service.

  3. Saisissez un nom et une description, puis cliquez sur Créer et continuer.

  4. À l'étape Autoriser ce compte de service à accéder au projet, attribuez le rôle personnalisé que vous avez créé.

  5. Cliquez sur OK. Notez l'adresse e-mail du compte de service.

Configurer les identifiants Workload Identity

Workload Identity est l'approche recommandée, car elle utilise des jetons d'accès éphémères qui empruntent l'identité d'un compte de service.

Identifier l'identité unique de l'instance

Pour établir une connexion, vous devez autoriser votre instance Google SecOps à emprunter l'identité de votre compte de service.

  1. Dans Google SecOps, accédez à Plate-forme de contenu > Intégrations de réponse.

  2. Sélectionnez l'intégration Compute Engine et saisissez l'adresse e-mail de votre compte de service dans Workload Identity Email.

  3. Cliquez sur Enregistrer > Tester. Le test devrait échouer.

  4. Cliquez sur le bouton close_small à côté de Test, puis recherchez l'adresse e-mail de l'identité commençant par gke-init-python@... ou soar-python@....

  5. Copiez cette adresse e-mail unique.

Autoriser l'identité de l'instance dans Google Cloud

  1. Dans la console Google Cloud , accédez à IAM et administration > Comptes de service.

    Accéder à la page "Comptes de service"

  2. Sélectionnez le compte de service cible, puis accédez à Autorisations > Accorder l'accès.

  3. Collez l'adresse e-mail unique dans le champ Nouveaux comptes principaux, puis attribuez le rôle Créateur de jetons du compte de service (roles/iam.serviceAccountTokenCreator).

Configurer une clé JSON

Les fichiers de clés secrètes statiques et de longue durée nécessitent une rotation manuelle. N'utilisez cette méthode que si l'authentification Workload Identity n'est pas disponible.

  1. Dans la console Google Cloud , accédez à IAM et administration > Comptes de service, puis sélectionnez votre compte de service.

    Accéder à la page "Comptes de service"

  2. Accédez à l'onglet Clés, puis cliquez sur Ajouter une clé > Créer une clé.

  3. Sélectionnez JSON, puis cliquez sur Créer. Le fichier est automatiquement téléchargé sur votre ordinateur.

Configurer manuellement des paramètres individuels

Si vous choisissez de saisir les identifiants manuellement, gardez le fichier de clé JSON téléchargé ouvert dans un éditeur de texte pour copier les valeurs individuelles requises dans les paramètres d'intégration.

Paramètres d'intégration

Pour établir une connexion entre Google SecOps et Compute Engine, vous devez configurer les paramètres suivants. L'intégration est compatible avec trois chemins d'authentification distincts. Choisissez l'une des méthodes suivantes pour fournir les identifiants :

  • Workload Identity : utilise Workload Identity Email.
  • Fichier JSON du compte de service : utilise Service Account Json File Content pour fournir l'intégralité de la clé en une seule fois.
  • Paramètres individuels manuels : utilise des champs distincts copiés manuellement à partir d'une clé JSON.
Paramètre Description
API Root

Facultatif.

URL de base de l'API Compute Engine.

La valeur par défaut est https://compute.googleapis.com.
OS Config API Root

Facultatif.

URL de base de l'API Cloud OS Config.

La valeur par défaut est https://osconfig.googleapis.com.
Workload Identity Email

Facultatif.

Adresse e-mail du client de votre compte de service. Utilisez-le pour l'authentification Workload Identity.
Service Account Json File Content

Facultatif.

Contenu complet du fichier JSON de clé de compte de service.

Si elle est configurée, l'intégration ignore les paramètres d'identifiants individuels.
Project ID

Facultatif.

ID du projet Google Cloud à cibler.

Si aucune valeur n'est fournie, l'intégration récupère l'ID à partir des identifiants du compte de service.
Verify SSL

Obligatoire.

Valide le certificat SSL pour la connexion. Cette option est activée par défaut.

Paramètres des identifiants individuels

N'utilisez les paramètres suivants que si vous saisissez manuellement les identifiants au lieu d'utiliser le contenu complet du fichier JSON ou une Workload Identity.

Paramètre Description
Account Type

Facultatif.

Valeur trouvée dans le champ type de votre clé JSON (généralement service_account).
Private Key ID

Facultatif.

Valeur trouvée dans le champ private_key_id de votre clé JSON.
Private Key

Facultatif.

Valeur trouvée dans le champ private_key de votre clé JSON.
Client Email

Facultatif.

Valeur trouvée dans le champ client_email de votre clé JSON.
Client ID

Facultatif.

Valeur trouvée dans le champ client_id de votre clé JSON.
Auth URI

Facultatif.

Valeur trouvée dans le champ auth_uri de votre clé JSON.

La valeur par défaut est https://accounts.google.com/o/oauth2/auth.
Token URI

Facultatif.

Valeur trouvée dans le champ token_uri de votre clé JSON.

La valeur par défaut est https://oauth2.googleapis.com/token.
Auth Provider X509 URL

Facultatif.

Valeur trouvée dans le champ auth_provider_x509_cert_url de votre clé JSON.
Client X509 URL

Facultatif.

Valeur trouvée dans le champ client_x509_cert_url de votre clé JSON.

Pour obtenir des instructions sur la configuration d'une intégration dans Google SecOps, consultez Configurer des intégrations.

Vous pourrez apporter des modifications ultérieurement, si nécessaire. Une fois que vous avez configuré une instance d'intégration, vous pouvez l'utiliser dans des playbooks. Pour savoir comment configurer et prendre en charge plusieurs instances, consultez Prise en charge de plusieurs instances.

Actions

Pour en savoir plus sur les actions, consultez Répondre aux actions en attente dans Votre bureau et Effectuer une action manuelle.

Ajouter une adresse IP à une règle de pare-feu

Utilisez l'action Ajouter une plage d'adresses IP à une règle de pare-feu pour ajouter une plage d'adresses IP à une règle de pare-feu existante dans une instance Compute Engine.

Cette action ne s'applique pas aux entités Google SecOps.

Entrées d'action

L'action Ajouter une adresse IP à une règle de pare-feu nécessite les paramètres suivants :

Paramètre Description
Resource Name

Facultatif.

Nom complet de la ressource de l'instance Compute Engine, au format /projects/PROJECT_ID/global/ firewallsFIREWALL.

Ce paramètre est prioritaire sur Project ID et Firewall Rule.
Project ID

Facultatif.

Nom du projet associé à l'instance Compute Engine.

Si aucune valeur n'est fournie, l'action utilise l'ID du projet de la configuration de l'intégration.
Firewall Rule

Facultatif.

Nom de la règle de pare-feu spécifique à mettre à jour.
Type

Obligatoire.

Sens du trafic pour la plage d'adresses IP ajoutée.

Les valeurs possibles sont les suivantes :

  • Source
  • Destination

La valeur par défaut est Source.
IP Ranges

Obligatoire.

Liste de plages d'adresses IP (notation CIDR) à ajouter à la règle de pare-feu, séparées par une virgule.

Sorties d'action

L'action Ajouter une adresse IP à une règle de pare-feu fournit les sorties suivantes :

Type de sortie de l'action Disponibilité
Pièce jointe du mur des cas Non disponible
Lien vers le mur des cas Non disponible
Tableau du mur des cas Non disponible
Table d'enrichissement Non disponible
Résultat JSON Disponible
Messages de sortie Disponible
Résultat du script Disponible
Résultat JSON

L'exemple suivant montre le résultat JSON reçu lors de l'utilisation de l'action Ajouter une adresse IP à une règle de pare-feu :

{
  "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"
  }
}
Messages de sortie

L'action Ajouter une adresse IP à une règle de pare-feu peut renvoyer les messages de sortie suivants :

Message de sortie Description du message

Successfully updated firewall rule in Google Cloud Compute.

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

 L'action a réussi.
Error executing action "Add IP To Firewall Rule". Reason: ERROR_REASON

Échec de l'action.

Vérifiez la connexion au serveur, les paramètres d'entrée ou les identifiants.
Résultat du script

Le tableau suivant répertorie la valeur de la sortie du résultat du script lorsque vous utilisez l'action Ajouter une adresse IP à une règle de pare-feu :

Nom du résultat du script Valeur
is_success true ou false

Ajouter des libellés à une instance

Utilisez l'action Ajouter des libellés à l'instance pour ajouter ou mettre à jour des libellés sur une instance Compute Engine spécifique.

Cette action ne s'applique pas aux entités Google SecOps.

Entrées d'action

L'action Ajouter des libellés à l'instance nécessite les paramètres suivants :

Paramètre Description
Resource Name

Facultatif.

Nom complet de la ressource de l'instance Compute Engine, au format /project/PROJECT_ID/zone/ ZONE_ID/instances/ INSTANCE_ID.

Ce paramètre est prioritaire sur Project ID, Instance Zone et Instance ID.
Project ID

Facultatif.

ID du projet associé à l'instance Compute Engine.

Si aucune valeur n'est fournie, l'action récupère l'ID du projet à partir de la configuration de l'intégration.
Instance Zone

Facultatif.

Zone spécifique dans laquelle se trouve l'instance.

Ce paramètre est obligatoire si vous identifiez l'instance à l'aide de Instance Zone et Instance ID.
Instance ID

Facultatif.

Identifiant unique de l'instance Compute Engine.

Ce paramètre est obligatoire si vous identifiez l'instance à l'aide de Instance Zone et Instance ID.
Instance Labels

Obligatoire.

Liste de libellés séparés par une virgule à appliquer à l'instance, au format key:value (par exemple, vm_label_key:label1).

Sorties d'action

L'action Ajouter des libellés à l'instance fournit les sorties suivantes :

Type de sortie de l'action Disponibilité
Pièce jointe du mur des cas Non disponible
Lien vers le mur des cas Non disponible
Tableau du mur des cas Non disponible
Table d'enrichissement Non disponible
Résultat JSON Disponible
Messages de sortie Disponible
Résultat du script Disponible
Résultat JSON

L'exemple suivant décrit le résultat JSON reçu lors de l'utilisation de l'action Ajouter des libellés à l'instance :

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

L'action Ajouter des libellés à l'instance peut renvoyer les messages de sortie suivants :

Message de sortie Description du message

Labels LABEL_LIST were successfully added to Compute Engine instance INSTANCE_ID.

Provided instance zone ZONE_ID is not valid.

Provided instance ID is not valid.

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

 L'action a réussi.
Error executing action "Add Labels to Instance". Reason: ERROR_REASON

Échec de l'action.

Vérifiez la connexion au serveur, les paramètres d'entrée ou les identifiants.
Résultat du script

Le tableau suivant répertorie la valeur de la sortie des résultats du script lorsque vous utilisez l'action Ajouter des libellés à l'instance :

Nom du résultat du script Valeur
is_success true ou false

Ajouter des tags réseau

Utilisez l'action Ajouter des tags réseau pour ajouter un ou plusieurs tags réseau à une instance Compute Engine spécifique.

Cette action ne s'applique pas aux entités Google SecOps.

Entrées d'action

L'action Ajouter des tags réseau nécessite les paramètres suivants :

Paramètre Description
Resource Name

Facultatif.

Nom complet de la ressource de l'instance Compute Engine, au format /project/PROJECT_ID/zone/ ZONE_ID/instances/ INSTANCE_ID.

Ce paramètre est prioritaire sur Project ID, Instance Zone et Instance ID.
Project ID

Facultatif.

ID du projet associé à l'instance Compute Engine.

Si aucune valeur n'est fournie, l'action récupère l'ID du projet à partir de la configuration de l'intégration.
Instance Zone

Facultatif.

Zone spécifique dans laquelle se trouve l'instance.

Ce paramètre est obligatoire si vous identifiez l'instance à l'aide de Instance Zone et Instance ID.
Instance ID

Facultatif.

Identifiant unique de l'instance Compute Engine.

Ce paramètre est obligatoire si vous identifiez l'instance à l'aide de Instance Zone et Instance ID.
Network Tags

Obligatoire.

Liste de tags réseau à ajouter à l'instance, séparés par une virgule.

Tous les tags ne doivent contenir que des lettres minuscules, des chiffres et des traits d'union.

Sorties d'action

L'action Ajouter des tags réseau fournit les sorties suivantes :

Type de sortie de l'action Disponibilité
Pièce jointe du mur des cas Non disponible
Lien vers le mur des cas Non disponible
Tableau du mur des cas Non disponible
Table d'enrichissement Non disponible
Résultat JSON Disponible
Messages de sortie Disponible
Résultat du script Disponible
Résultat JSON

L'exemple suivant montre le résultat JSON reçu lors de l'utilisation de l'action Ajouter des tags réseau :

{
  "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
  }
}
Messages de sortie

L'action Ajouter des tags réseau peut renvoyer les messages de sortie suivants :

Message de sortie Description du message

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

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

 L'action a réussi.
Error executing action "Add Network Tags". Reason: ERROR_REASON

Échec de l'action.

Vérifiez la connexion au serveur, les paramètres d'entrée ou les identifiants.
Résultat du script

Le tableau suivant répertorie la valeur de la sortie du résultat du script lorsque vous utilisez l'action Ajouter des tags réseau :

Nom du résultat du script Valeur
is_success true ou false

Supprimer l'instance

Utilisez l'action Supprimer une instance pour supprimer des instances Compute Engine.

Cette action ne s'applique pas aux entités Google SecOps.

Entrées d'action

L'action Supprimer l'instance nécessite les paramètres suivants :

Paramètre Description
Resource Name

Facultatif.

Nom complet de la ressource de l'instance Compute Engine, au format /project/PROJECT_ID/zone/ ZONE_ID/instances/ INSTANCE_ID.

Ce paramètre est prioritaire sur Project ID, Instance Zone et Instance ID.
Project ID

Facultatif.

ID du projet associé à l'instance Compute Engine.

Si aucune valeur n'est fournie, l'action récupère l'ID du projet à partir de la configuration de l'intégration.
Instance Zone

Facultatif.

Zone spécifique dans laquelle se trouve l'instance.

Ce paramètre est obligatoire si vous identifiez l'instance à l'aide de Instance Zone et Instance ID.
Instance ID

Facultatif.

ID unique de l'instance que vous souhaitez démarrer.

Vous pouvez récupérer cette valeur à l'aide de l'action Lister les instances.

Ce paramètre est obligatoire si vous identifiez l'instance à l'aide de Instance Zone et Instance ID.

Sorties d'action

L'action Supprimer l'instance fournit les résultats suivants :

Type de sortie de l'action Disponibilité
Pièce jointe du mur des cas Non disponible
Lien vers le mur des cas Non disponible
Tableau du mur des cas Non disponible
Table d'enrichissement Non disponible
Résultat JSON Disponible
Messages de sortie Disponible
Résultat du script Disponible
Résultat JSON

L'exemple suivant décrit le résultat JSON reçu lors de l'utilisation de l'action Supprimer l'instance :

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

L'action Delete Instance (Supprimer l'instance) peut renvoyer les messages de sortie suivants :

Message de sortie Description du message

Compute Engine instance INSTANCE_ID was deleted successfully.

Provided instance zone ZONE_ID is not valid.

Provided instance ID is not valid.

 L'action a réussi.

Error executing action "Start Instance". Reason: ERROR_REASON

Provided resource RESOURCE_PATH is not valid

Échec de l'action.

Vérifiez la connexion au serveur, les paramètres d'entrée ou les identifiants.
Résultat du script

Le tableau suivant répertorie la valeur de la sortie du résultat du script lorsque vous utilisez l'action Supprimer l'instance :

Nom du résultat du script Valeur
is_success true ou false

Enrichir les entités

Utilisez l'action Enrichir les entités pour enrichir les entités Google SecOps IP Address avec les informations sur les instances de Compute Engine.

Cette action s'exécute sur les entités Google SecOps suivantes :

  • IP Address

Entrées d'action

L'action Enrichir les entités nécessite les paramètres suivants :

Paramètres Description
Project ID

Facultatif.

ID du projet associé à l'instance Compute Engine.

Si aucune valeur n'est fournie, l'action récupère l'ID du projet à partir de la configuration de l'intégration.
Instance Zone

Facultatif.

Zone spécifique dans laquelle se trouve l'instance.

Sorties d'action

L'action Enrichir les entités fournit les résultats suivants :

Type de sortie de l'action Disponibilité
Pièce jointe du mur des cas Non disponible
Lien vers le mur des cas Non disponible
Tableau du mur des cas Disponible
Table d'enrichissement Disponible
Résultat JSON Disponible
Messages de sortie Disponible
Résultat du script Disponible
Tableau du mur des cas

Une fois l'exécution terminée, l'action Enrichir les entités fournit le tableau suivant :

Nom de la table : Table d'enrichissement ENTITY

Colonnes :

  • Champ d'entité
  • Valeur
Table d'enrichissement

L'action Enrichir les entités est compatible avec l'enrichissement d'entités suivant :

Champ d'enrichissement Source (clé JSON) Logique
Google_Compute_instance_id id Non disponible
Google_Compute_creation_timestamp creationTimestamp Non disponible
Google_Compute_instance_name name Non disponible
Google_Compute_description description Non disponible
Google_Compute_tags tags Fournissez les tags dans une liste CSV.
Google_Compute_machine_type machineType Non disponible
Google_Compute_instance_status status Non disponible
Google_Compute_instance_zone zone Non disponible
Google_Compute_can_ip_forward canIpForward Non disponible
Google_Compute_instance_network_interfaces_name_INDEX networkInterfaces.name Développer si d'autres interfaces réseau sont disponibles
Google_Compute_instance_network_interfaces_name_access_configs_type_INDEX networkInterfaces.accessConfigs.type Développer si d'autres interfaces réseau sont disponibles
Google_Compute_instance_network_interfaces_name_access_configs_name_INDEX networkInterfaces.accessConfigs.name Développer si d'autres interfaces réseau sont disponibles
Google_Compute_instance_network_interfaces_name_access_configs_natIP_INDEX networkInterfaces.accessConfigs.natIP Développer si d'autres interfaces réseau sont disponibles
Google_Compute_instance_metadata metadata Liste CSV des valeurs issues des métadonnées d'instance
Google_Compute_service_account_INDEX serviceAccounts.email Développer si d'autres comptes de service sont disponibles
Google_Compute_service_account_scopes_INDEX serviceAccounts.scopes Développer si d'autres comptes de service sont disponibles
Google_Compute_link_to_Google_Compute selfLink Non disponible
Google_Compute_labels labels Fournissez une liste de valeurs au format CSV.
Google_Compute_instance_last_start_timestamp lastStartTimestamp Non disponible
Google_Compute_instance_last_stop_timestamp lastStopTimestamp Non disponible
Résultat JSON

L'exemple suivant décrit le résultat JSON reçu lors de l'utilisation de l'action Enrich Entities (Enrichir les entités) :

{
    "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"
}
Messages de sortie

L'action Enrichir les entités peut renvoyer les messages de sortie suivants :

Message de sortie Description du message

Successfully enriched entities: ENTITY_ID.

Provided instance zone ZONE_ID is not valid.

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

No entities were enriched.

 L'action a réussi.
Error executing action "Enrich Entities". Reason: ERROR_REASON

Échec de l'action.

Vérifiez la connexion au serveur, les paramètres d'entrée ou les identifiants.
Résultat du script

Le tableau suivant répertorie la valeur de la sortie du résultat du script lorsque vous utilisez l'action Enrichir les entités :

Nom du résultat du script Valeur
is_success true ou false

Exécuter un job d'application de correctifs de VM

Utilisez l'action Exécuter un job d'application de correctifs de VM pour exécuter un job d'application de correctifs de VM sur des instances Compute Engine.

Cette action ne s'applique pas aux entités Google SecOps.

Entrées d'action

L'action Exécuter la tâche de correctif de VM nécessite les paramètres suivants :

Paramètre Description
Instance Filter Object

Obligatoire.

Objet JSON utilisé pour cibler des instances spécifiques à corriger.

La valeur par défaut cible toutes les instances :

{
  "all": "true"
}
Name

Obligatoire.

Nom unique du job de correction.
Description

Facultatif.

Brève description de l'objectif de la tâche d'application de correctifs.
Patching Config Object

Facultatif.

Objet JSON qui définit les étapes et les configurations spécifiques de la mise à jour pour différents systèmes d'exploitation.

Si aucune valeur n'est fournie, l'action utilise la valeur par défaut suivante :

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

Obligatoire.

Temps maximal autorisé pour l'exécution du job de correction, en minutes.

La valeur par défaut est 60.
Rollout Strategy

Facultatif.

Méthode utilisée pour déployer le correctif dans plusieurs zones.

Les valeurs possibles sont les suivantes :

  • Zone By Zone : les correctifs sont appliqués à une zone à la fois pour minimiser les risques.
  • Concurrent Zones : les correctifs sont appliqués simultanément à toutes les zones cibles pour réduire la durée totale de l'intervalle de maintenance.

La valeur par défaut est Zone By Zone.
Disruption Budget

Obligatoire.

Nombre ou pourcentage d'instances pouvant être hors connexion en même temps (par exemple, 5 ou 10%).

La valeur par défaut est 10%.
Wait For Completion

Obligatoire.

Si cette option est sélectionnée, l'action reste active jusqu'à la fin du job de correction.

Cette option est activée par défaut.
Fail If Completed With Errors

Obligatoire.

Si cette option est sélectionnée, l'action échoue si l'état du job est Completed with errors ou si le délai avant expiration est atteint.

Ce paramètre est ignoré si Wait For Completion est désactivé.

Cette option est activée par défaut.

Sorties d'action

L'action Exécuter la tâche de correctif de VM fournit les sorties suivantes :

Type de sortie de l'action Disponibilité
Pièce jointe du mur des cas Non disponible
Lien vers le mur des cas Non disponible
Tableau du mur des cas Non disponible
Table d'enrichissement Non disponible
Résultat JSON Disponible
Messages de sortie Disponible
Résultat du script Disponible
Résultat JSON

L'exemple suivant montre le résultat JSON reçu lors de l'utilisation de l'action Exécuter le job de correctif 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
                }
            }
        }
Messages de sortie

L'action Exécuter le job de correctif de VM peut renvoyer les messages de sortie suivants :

Message de sortie Description du message

Successfully executed VM patching job in Google Cloud Compute.

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

The executed patching job was canceled in Google Cloud Compute.

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

 L'action a réussi.
Error executing action "Execute VM Patch Job". Reason: ERROR_REASON

Échec de l'action.

Vérifiez la connexion au serveur, les paramètres d'entrée ou les identifiants.
Résultat du script

Le tableau suivant répertorie la valeur de la sortie du résultat du script lorsque vous utilisez l'action Exécuter une tâche de correctif de VM :

Nom du résultat du script Valeur
is_success true ou false

Obtenir la stratégie IAM de l'instance

Utilisez l'action Obtenir la stratégie IAM de l'instance pour récupérer la stratégie de contrôle des accès Identity and Access Management (iam_name_short) d'une ressource Compute Engine spécifique.

Cette action ne s'applique pas aux entités Google SecOps.

Entrées d'action

L'action Get Instance IAM Policy nécessite les paramètres suivants :

Paramètre Description
Resource Name

Facultatif.

Nom complet de la ressource de l'instance Compute Engine, au format /project/PROJECT_ID/zone/ ZONE_ID/instances/ INSTANCE_ID.

Ce paramètre est prioritaire sur Project ID, Instance Zone et Instance ID.
Project ID

Facultatif.

ID du projet associé à l'instance Compute Engine.

Si aucune valeur n'est fournie, l'action récupère l'ID du projet à partir de la configuration de l'intégration.
Instance Zone

Facultatif.

Zone spécifique dans laquelle se trouve l'instance.

Ce paramètre est obligatoire si vous identifiez l'instance à l'aide de Instance Zone et Instance ID.
Instance ID

Facultatif.

ID unique de l'instance que vous souhaitez démarrer.

Vous pouvez récupérer cette valeur à l'aide de l'action Lister les instances.

Ce paramètre est obligatoire si vous identifiez l'instance à l'aide de Instance Zone et Instance ID.

Sorties d'action

L'action Obtenir la stratégie IAM de l'instance fournit les sorties suivantes :

Type de sortie de l'action Disponibilité
Pièce jointe du mur des cas Non disponible
Lien vers le mur des cas Non disponible
Tableau du mur des cas Non disponible
Table d'enrichissement Non disponible
Résultat JSON Disponible
Messages de sortie Disponible
Résultat du script Disponible
Résultat JSON

L'exemple suivant décrit le résultat JSON reçu lors de l'utilisation de l'action Get Instance IAM Policy (Obtenir la stratégie IAM de l'instance) :

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

L'action Get Instance IAM Policy (Obtenir la stratégie IAM de l'instance) peut renvoyer les messages de sortie suivants :

Message de sortie Description du message

Compute Engine instance INSTANCE_ID IAM policy was fetched successfully.

Provided instance zone ZONE_ID is not valid.

Provided instance ID is not valid.

 L'action a réussi.
Error executing action "Get Instance IAM Policy". Reason: ERROR_REASON

Échec de l'action.

Vérifiez la connexion au serveur, les paramètres d'entrée ou les identifiants.
Résultat du script

Le tableau suivant répertorie la valeur de la sortie du résultat du script lorsque vous utilisez l'action Obtenir le règlement IAM de l'instance :

Nom du résultat du script Valeur
is_success true ou false

Répertorier les instances

Utilisez l'action Lister les instances pour lister les instances Compute Engine en fonction des critères de recherche spécifiés.

Cette action ne s'applique pas aux entités Google SecOps.

Entrées d'action

L'action Lister les instances nécessite les paramètres suivants :

Paramètre Description
Project ID

Facultatif.

ID du projet à partir duquel lister les instances.

Si aucune valeur n'est fournie, l'action récupère l'ID du projet à partir du compte de service Google Cloud utilisé dans la configuration de l'intégration.
Instance Zone

Facultatif.

Zone spécifique dans laquelle rechercher des instances.

Si aucune valeur n'est fournie, l'action effectue une recherche dans toutes les zones disponibles.
Instance Name

Facultatif.

Nom de l'instance à rechercher.

Ce paramètre accepte plusieurs valeurs sous forme de chaîne séparée par une virgule.
Instance Status

Facultatif.

État actuel des instances à inclure dans les résultats de recherche, par exemple RUNNING ou TERMINATED.

Ce paramètre accepte plusieurs valeurs sous forme de chaîne séparée par une virgule.
Instance Labels

Facultatif.

Libellés utilisés pour filtrer les résultats des instances, fournis au format key:value (par exemple, env:production).

Ce paramètre accepte plusieurs valeurs sous forme de chaîne séparée par une virgule.
Max Rows to Return

Facultatif.

Nombre maximal d'instances à renvoyer dans les résultats.

La valeur par défaut est 50.

Sorties d'action

L'action Lister les instances fournit les résultats suivants :

Type de sortie de l'action Disponibilité
Pièce jointe du mur des cas Non disponible
Lien vers le mur des cas Non disponible
Tableau du mur des cas Disponible
Table d'enrichissement Non disponible
Résultat JSON Disponible
Messages de sortie Disponible
Résultat du script Disponible
Tableau du mur des cas

L'action Lister les instances fournit le tableau suivant :

Nom de la table : Instances Compute Engine

Colonnes du tableau :

  • Nom de l'instance
  • ID d'instance
  • Heure de création de l'instance
  • Description de l'instance
  • Type d'instance
  • État de l'instance
  • Libellés d'instance
Résultat JSON

L'exemple suivant décrit le résultat JSON reçu lors de l'utilisation de l'action Lister les 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"
       }
   ]
}
Messages de sortie

L'action Lister les instances peut renvoyer les messages de sortie suivants :

Message de sortie Description du message

Successfully fetched Compute Engine instances.

Provided instance zone ZONE_ID is not valid.

No instances were found in Compute Engine.

 L'action a réussi.
Error executing action "List Instances". Reason: ERROR_REASON

Échec de l'action.

Vérifiez la connexion au serveur, les paramètres d'entrée ou les identifiants.
Résultat du script

Le tableau suivant répertorie la valeur de la sortie du résultat du script lorsque vous utilisez l'action Lister les instances :

Nom du résultat du script Valeur
is_success true ou false

Ping

Utilisez l'action Ping pour tester la connectivité à Compute Engine.

Cette action ne s'applique pas aux entités Google SecOps.

Entrées d'action

Aucune.

Sorties d'action

L'action Ping fournit les résultats suivants :

Type de sortie de l'action Disponibilité
Pièce jointe du mur des cas Non disponible
Lien vers le mur des cas Non disponible
Tableau du mur des cas Non disponible
Table d'enrichissement Non disponible
Résultat JSON Non disponible
Messages de sortie Disponible
Résultat du script Disponible
Messages de sortie

L'action Ping peut renvoyer les messages de résultat suivants :

Message de sortie Description du message
Successfully connected to the Compute Engine service with the provided connection parameters! L'action a réussi.
Failed to connect to the Compute Engine service! Error is ERROR_REASON

Échec de l'action.

Vérifiez la connexion au serveur, les paramètres d'entrée ou les identifiants.
Résultat du script

Le tableau suivant répertorie la valeur du résultat du script lorsque vous utilisez l'action Ping :

Nom du résultat du script Valeur
is_success true ou false

Supprimer les adresses IP externes

Utilisez l'action Supprimer les adresses IP externes pour supprimer les adresses IP externes d'une instance Compute Engine.

Cette action ne s'applique pas aux entités Google SecOps.

Entrées d'action

L'action Supprimer les adresses IP externes nécessite les paramètres suivants :

Paramètres Description
Resource Name

Facultatif.

Nom complet de la ressource de l'instance Compute Engine, au format /project/PROJECT_ID/zone/ ZONE_ID/instances/ INSTANCE_ID.

Ce paramètre est prioritaire sur Project ID, Instance Zone et Instance ID.
Project ID

Facultatif.

ID du projet associé à l'instance Compute Engine.

Si aucune valeur n'est fournie, l'action récupère l'ID du projet à partir de la configuration de l'intégration.
Instance Zone

Facultatif.

Zone spécifique dans laquelle se trouve l'instance.

Ce paramètre est obligatoire si vous identifiez l'instance à l'aide de Instance Zone et Instance ID.
Instance ID

Facultatif.

ID unique de l'instance que vous souhaitez démarrer.

Vous pouvez récupérer cette valeur à l'aide de l'action Lister les instances.

Ce paramètre est obligatoire si vous identifiez l'instance à l'aide de Instance Zone et Instance ID.
Network Interfaces

Facultatif.

Liste des interfaces réseau spécifiques à modifier, séparées par une virgule.

Si aucune valeur n'est fournie ou si vous utilisez le caractère générique *, l'action met à jour toutes les interfaces réseau.

La valeur par défaut est *.

Sorties d'action

L'action Supprimer les adresses IP externes fournit les sorties suivantes :

Type de sortie de l'action Disponibilité
Pièce jointe du mur des cas Non disponible
Lien vers le mur des cas Non disponible
Tableau du mur des cas Non disponible
Table d'enrichissement Non disponible
Résultat JSON Disponible
Messages de sortie Disponible
Résultat du script Disponible
Résultat JSON

L'exemple suivant décrit le résultat JSON reçu lors de l'utilisation de l'action Supprimer les adresses IP externes :

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

L'action Supprimer les adresses IP externes peut renvoyer les messages de sortie suivants :

Message de sortie Description du message

Successfully removed external IP addresses from RESOURCE_PATH instance in INTEGRATION_NAME.

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

 L'action a réussi.

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.

Échec de l'action.

Vérifiez la connexion au serveur, les paramètres d'entrée ou les identifiants.
Résultat du script

Le tableau suivant indique la valeur de la sortie du résultat du script lorsque vous utilisez l'action Supprimer les adresses IP externes :

Nom du résultat du script Valeur
is_success true ou false

Supprimer une adresse IP d'une règle de pare-feu

Utilisez l'action Supprimer une adresse IP d'une règle de pare-feu pour supprimer des plages d'adresses IP spécifiques d'une règle de pare-feu Compute Engine existante.

Cette action ne s'applique pas aux entités Google SecOps.

Entrées d'action

L'action Supprimer une adresse IP d'une règle de pare-feu nécessite les paramètres suivants :

Paramètre Description
Resource Name

Facultatif.

Nom complet de la ressource de l'instance Compute Engine, au format /projects/PROJECT_ID/global/ firewallsFIREWALL.

Ce paramètre est prioritaire sur Project ID et Firewall Rule.
Project ID

Facultatif.

ID du projet associé à l'instance Compute Engine.

Si aucune valeur n'est fournie, l'action récupère l'ID du projet à partir de la configuration de l'intégration.
Firewall Rule

Facultatif.

Nom de la règle de pare-feu spécifique à mettre à jour.
Type

Obligatoire.

Sens du trafic pour la plage d'adresses IP ajoutée.

Les valeurs possibles sont les suivantes :

  • Source
  • Destination

La valeur par défaut est Source.
IP Ranges

Obligatoire.

Liste de plages d'adresses IP (notation CIDR) à ajouter à la règle de pare-feu, séparées par une virgule.

Sorties d'action

L'action Supprimer une adresse IP d'une règle de pare-feu fournit les sorties suivantes :

Type de sortie de l'action Disponibilité
Pièce jointe du mur des cas Non disponible
Lien vers le mur des cas Non disponible
Tableau du mur des cas Non disponible
Table d'enrichissement Non disponible
Résultat JSON Disponible
Messages de sortie Disponible
Résultat du script Disponible
Résultat JSON

L'exemple suivant montre le résultat JSON reçu lors de l'utilisation de l'action Supprimer une adresse IP d'une règle de pare-feu :

{
  "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"
  }
}
Messages de sortie

L'action Supprimer l'adresse IP de la règle de pare-feu peut renvoyer les messages de sortie suivants :

Message de sortie Description du message

Successfully updated firewall rule in Google Cloud Compute.

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

 L'action a réussi.
Error executing action "Remove IP From Firewall Rule". Reason: ERROR_REASON

Échec de l'action.

Vérifiez la connexion au serveur, les paramètres d'entrée ou les identifiants.
Résultat du script

Le tableau suivant répertorie la valeur de la sortie du résultat du script lorsque vous utilisez l'action Supprimer l'adresse IP de la règle de pare-feu :

Nom du résultat du script Valeur
is_success true ou false

Supprimer des tags réseau

Utilisez l'action Supprimer les tags réseau pour supprimer les tags réseau de l'instance Compute Engine.

Cette action ne s'applique pas aux entités Google SecOps.

Entrées d'action

L'action Supprimer les tags réseau nécessite les paramètres suivants :

Paramètre Description
Resource Name

Facultatif.

Nom complet de la ressource de l'instance Compute Engine, au format /project/PROJECT_ID/zone/ ZONE_ID/instances/ INSTANCE_ID.

Ce paramètre est prioritaire sur Project ID, Instance Zone et Instance ID.
Project ID

Facultatif.

ID du projet associé à l'instance Compute Engine.

Si aucune valeur n'est fournie, l'action récupère l'ID du projet à partir de la configuration de l'intégration.
Instance Zone

Facultatif.

Zone spécifique dans laquelle se trouve l'instance.

Ce paramètre est obligatoire si vous identifiez l'instance à l'aide de Instance Zone et Instance ID.
Instance ID

Facultatif.

ID unique de l'instance que vous souhaitez démarrer.

Vous pouvez récupérer cette valeur à l'aide de l'action Lister les instances.

Ce paramètre est obligatoire si vous identifiez l'instance à l'aide de Instance Zone et Instance ID.
Network Tags

Obligatoire.

Liste de tags réseau à ajouter à l'instance, séparés par une virgule.

Tous les tags ne doivent contenir que des lettres minuscules, des chiffres et des traits d'union.

Sorties d'action

L'action Supprimer les tags réseau fournit les sorties suivantes :

Type de sortie de l'action Disponibilité
Pièce jointe du mur des cas Non disponible
Lien vers le mur des cas Non disponible
Tableau du mur des cas Non disponible
Table d'enrichissement Non disponible
Résultat JSON Disponible
Messages de sortie Disponible
Résultat du script Disponible
Résultat JSON

L'exemple suivant montre le résultat JSON reçu lors de l'utilisation de l'action 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
  }
}
Messages de sortie

L'action Supprimer les tags réseau peut renvoyer les messages de sortie suivants :

Message de sortie Description du message

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

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

 L'action a réussi.
Error executing action "Remove Network Tags". Reason: ERROR_REASON

Échec de l'action.

Vérifiez la connexion au serveur, les paramètres d'entrée ou les identifiants.
Résultat du script

Le tableau suivant répertorie la valeur de la sortie du résultat du script lorsque vous utilisez l'action Supprimer les tags réseau :

Nom du résultat du script Valeur
is_success true ou false

Définir la stratégie IAM de l'instance

Utilisez l'action Définir la stratégie IAM de l'instance pour définir la stratégie de contrôle des accès de la ressource spécifiée. La stratégie que vous fournissez dans l'action remplace toute stratégie existante.

Cette action ne s'applique pas aux entités Google SecOps.

Entrées d'action

L'action Définir la règle IAM de l'instance requiert les paramètres suivants :

Paramètres Description
Resource Name

Facultatif.

Nom complet de la ressource de l'instance Compute Engine, au format /project/PROJECT_ID/zone/ ZONE_ID/instances/ INSTANCE_ID.

Ce paramètre est prioritaire sur Project ID, Instance Zone et Instance ID.
Project ID

Facultatif.

ID du projet associé à l'instance Compute Engine.

Si aucune valeur n'est fournie, l'action récupère l'ID du projet à partir de la configuration de l'intégration.
Instance Zone

Facultatif.

Zone spécifique dans laquelle se trouve l'instance.

Ce paramètre est obligatoire si vous identifiez l'instance à l'aide de Instance Zone et Instance ID.
Instance ID

Facultatif.

ID unique de l'instance que vous souhaitez démarrer.

Vous pouvez récupérer cette valeur à l'aide de l'action Lister les instances.

Ce paramètre est obligatoire si vous identifiez l'instance à l'aide de Instance Zone et Instance ID.
Policy

Obligatoire.

Document de stratégie IAM à appliquer à l'instance, fourni sous la forme d'un objet JSON.

Sorties d'action

L'action Définir la stratégie IAM de l'instance fournit les sorties suivantes :

Type de sortie de l'action Disponibilité
Pièce jointe du mur des cas Non disponible
Lien vers le mur des cas Non disponible
Tableau du mur des cas Non disponible
Table d'enrichissement Non disponible
Résultat JSON Disponible
Messages de sortie Disponible
Résultat du script Disponible
Résultat JSON

L'exemple suivant décrit le résultat JSON reçu lors de l'utilisation de l'action Définir la stratégie IAM de l'instance :

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

L'action Définir la stratégie IAM de l'instance peut renvoyer les messages de sortie suivants :

Message de sortie Description du message

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

Provided instance zone ZONE_ID is not valid.

Provided instance ID INSTANCE_ID is not valid.

Provided policy JSON document POLICY is not valid.

 L'action a réussi.
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.

Échec de l'action.

Vérifiez la connexion au serveur, les paramètres d'entrée ou les identifiants.
Résultat du script

Le tableau suivant indique la valeur de la sortie du résultat du script lorsque vous utilisez l'action Définir la règle IAM de l'instance :

Nom du résultat du script Valeur
is_success true ou false

Démarrer l'instance

Utilisez l'action Démarrer l'instance pour mettre sous tension une instance Compute Engine à l'état arrêté ou arrêté.

Cette action ne s'applique pas aux entités Google SecOps.

Entrées d'action

L'action Démarrer l'instance nécessite les paramètres suivants :

Paramètres Description
Resource Name

Facultatif.

Nom complet de la ressource de l'instance Compute Engine, au format /project/PROJECT_ID/zone/ ZONE_ID/instances/ INSTANCE_ID.

Ce paramètre est prioritaire sur Project ID, Instance Zone et Instance ID.
Project ID

Facultatif.

ID du projet associé à l'instance Compute Engine.

Si aucune valeur n'est fournie, l'action récupère l'ID du projet à partir de la configuration de l'intégration.
Instance Zone

Facultatif.

Zone spécifique dans laquelle se trouve l'instance.

Ce paramètre est obligatoire si vous identifiez l'instance à l'aide de Instance Zone et Instance ID.
Instance ID

Facultatif.

ID unique de l'instance que vous souhaitez démarrer.

Vous pouvez récupérer cette valeur à l'aide de l'action Lister les instances.

Ce paramètre est obligatoire si vous identifiez l'instance à l'aide de Instance Zone et Instance ID.

Sorties d'action

L'action Démarrer l'instance fournit les sorties suivantes :

Type de sortie de l'action Disponibilité
Pièce jointe du mur des cas Non disponible
Lien vers le mur des cas Non disponible
Tableau du mur des cas Non disponible
Table d'enrichissement Non disponible
Résultat JSON Disponible
Messages de sortie Disponible
Résultat du script Disponible
Résultat JSON

L'exemple suivant décrit le résultat JSON reçu lors de l'utilisation de l'action Démarrer l'instance :

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

L'action Démarrer l'instance peut renvoyer les messages de résultat suivants :

Message de sortie Description du message

Compute Engine instance RESOURCE_PATH was started successfully.

Provided instance zone ZONE_ID is not valid.

Provided instance ID is not valid.

 L'action a réussi.

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.

Échec de l'action.

Vérifiez la connexion au serveur, les paramètres d'entrée ou les identifiants.
Résultat du script

Le tableau suivant répertorie la valeur de la sortie du résultat du script lorsque vous utilisez l'action Start Instance (Démarrer l'instance) :

Nom du résultat du script Valeur
is_success true ou false

Arrêter l'instance

Utilisez l'action Arrêter l'instance pour arrêter une instance Compute Engine en cours d'exécution. Vous pouvez redémarrer une instance arrêtée à tout moment.

L'arrêt d'une instance suspend les frais d'utilisation de la VM, mais les frais continuent de s'appliquer aux ressources associées, telles que les disques persistants et les adresses IP statiques, sauf si ces ressources sont supprimées.

Cette action ne s'applique pas aux entités Google SecOps.

Entrées d'action

L'action Arrêter l'instance nécessite les paramètres suivants :

Paramètres Description
Resource Name

Facultatif.

Nom complet de la ressource de l'instance Compute Engine, au format /project/PROJECT_ID/zone/ ZONE_ID/instances/ INSTANCE_ID.

Ce paramètre est prioritaire sur Project ID, Instance Zone et Instance ID.
Project ID

Facultatif.

ID du projet associé à l'instance Compute Engine.

Si aucune valeur n'est fournie, l'action récupère l'ID du projet à partir de la configuration de l'intégration.
Instance Zone

Facultatif.

Zone spécifique dans laquelle se trouve l'instance.

Ce paramètre est obligatoire si vous identifiez l'instance à l'aide de Instance Zone et Instance ID.
Instance ID

Facultatif.

ID unique de l'instance que vous souhaitez démarrer.

Vous pouvez récupérer cette valeur à l'aide de l'action Lister les instances.

Ce paramètre est obligatoire si vous identifiez l'instance à l'aide de Instance Zone et Instance ID.

Sorties d'action

L'action Arrêter l'instance fournit les résultats suivants :

Type de sortie de l'action Disponibilité
Pièce jointe du mur des cas Non disponible
Lien vers le mur des cas Non disponible
Tableau du mur des cas Non disponible
Table d'enrichissement Non disponible
Résultat JSON Disponible
Messages de sortie Disponible
Résultat du script Disponible
Résultat JSON

L'exemple suivant décrit le résultat JSON reçu lors de l'utilisation de l'action Arrêter l'instance :

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

L'action Arrêter l'instance peut renvoyer les messages de sortie suivants :

Message de sortie Description du message

Compute Engine instance INSTANCE_ID was stopped successfully.

Provided instance zone ZONE_ID is not valid.

Provided instance ID is not valid.

 L'action a réussi.
Error executing action "Stop Instance". Reason: ERROR_REASON

Échec de l'action.

Vérifiez la connexion au serveur, les paramètres d'entrée ou les identifiants.
Résultat du script

Le tableau suivant répertorie la valeur de la sortie du résultat du script lorsque vous utilisez l'action Arrêter l'instance :

Nom du résultat du script Valeur
is_success true ou false

Mettre à jour une règle de pare-feu

Utilisez l'action Mettre à jour la règle de pare-feu pour modifier la configuration d'une règle de pare-feu Compute Engine existante. Cette action vous permet de mettre à jour des paramètres spécifiques tout en conservant l'identité de la règle.

Cette action ne s'applique pas aux entités Google SecOps.

Entrées d'action

L'action Mettre à jour la règle de pare-feu nécessite les paramètres suivants :

Paramètres Description
Firewall Rule

Facultatif.

Nom de la règle de pare-feu spécifique à mettre à jour.
Project ID

Facultatif.

ID du projet associé à l'instance Compute Engine.

Si aucune valeur n'est fournie, l'action récupère l'ID du projet à partir de la configuration de l'intégration.
Resource Name

Facultatif.

Nom complet de la ressource de l'instance Compute Engine, au format /projects/PROJECT_ID/global/ firewallsFIREWALL.

Ce paramètre est prioritaire sur Project ID et Firewall Rule.
Source IP Ranges

Facultatif.

Liste des plages d'adresses IP sources pour la règle de pare-feu, séparées par une virgule.

Si la valeur none est définie, l'action supprime toutes les plages d'adresses IP sources existantes de la règle.

Si aucune valeur n'est fournie, les valeurs existantes restent inchangées.
Source Tags

Facultatif.

Liste de tags réseau sources séparés par une virgule à appliquer à la règle.

Si la valeur none est définie, l'action supprime toutes les balises sources existantes de la règle.

Si aucune valeur n'est fournie, les valeurs existantes restent inchangées.
Source Service Accounts

Facultatif.

Liste de comptes de service sources séparés par une virgule auxquels appliquer la règle.

Si la valeur none est définie, l'action supprime tous les comptes de service sources existants de la règle.

Si aucune valeur n'est fournie, les valeurs existantes restent inchangées.
TCP Ports

Facultatif.

Liste de ports ou de plages de ports TCP séparés par une virgule à autoriser ou refuser.

Ce paramètre accepte les valeurs all et none. Si elle est configurée, l'action met à jour le protocole et la liste des ports de la règle de pare-feu avec cette valeur.
UDP Ports

Facultatif.

Liste de ports ou de plages de ports UDP séparés par une virgule, à autoriser ou à refuser.

Ce paramètre accepte les valeurs all et none. Si elle est configurée, l'action met à jour le protocole et la liste des ports de la règle de pare-feu avec cette valeur.
Other Protocols

Facultatif.

Liste de protocoles autres que TCP et UDP, séparés par une virgule, à inclure dans la règle.

Si la valeur none est définie, l'action met à jour la liste des protocoles de la règle de pare-feu avec cette valeur.
Destination IP Ranges

Facultatif.

Liste des plages d'adresses IP de destination pour la règle de pare-feu, séparées par une virgule.

Si la valeur none est définie, l'action supprime toutes les plages d'adresses IP de destination existantes de la règle.

Si aucune valeur n'est fournie, les valeurs existantes restent inchangées.

Sorties d'action

L'action Mettre à jour la règle de pare-feu fournit les sorties suivantes :

Type de sortie de l'action Disponibilité
Pièce jointe du mur des cas Non disponible
Lien vers le mur des cas Non disponible
Tableau du mur des cas Non disponible
Table d'enrichissement Non disponible
Résultat JSON Disponible
Messages de sortie Disponible
Résultat du script Disponible
Résultat JSON

L'exemple suivant décrit le résultat JSON reçu lors de l'utilisation de l'action Mettre à jour la règle de pare-feu :

{
  "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"
  }
}
Messages de sortie

L'action Mettre à jour la règle de pare-feu peut renvoyer les messages de sortie suivants :

Message de sortie Description du message
Successfully updated firewall rule in Cloud Compute.

Updating firewall rule in Cloud Compute.

 L'action a réussi.
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.

Échec de l'action.

Vérifiez la connexion au serveur, les paramètres d'entrée ou les identifiants.
Résultat du script

Le tableau suivant indique la valeur de la sortie du résultat du script lorsque vous utilisez l'action Mettre à jour la règle de pare-feu :

Nom du résultat du script Valeur
is_success true ou false

Vous avez encore besoin d'aide ? Obtenez des réponses auprès des membres de la communauté et des professionnels Google SecOps.