REST Resource: projects.locations.networkPolicies.externalAccessRules

Ressource : ExternalAccessRule

Règles de pare-feu d'accès externe pour filtrer le trafic entrant destiné aux ressources ExternalAddress.

Représentation JSON 
{
  "name": string,
  "createTime": string,
  "updateTime": string,
  "description": string,
  "priority": integer,
  "action": enum (Action),
  "ipProtocol": string,
  "sourceIpRanges": [
    {
      object (IpRange)
    }
  ],
  "sourcePorts": [
    string
  ],
  "destinationIpRanges": [
    {
      object (IpRange)
    }
  ],
  "destinationPorts": [
    string
  ],
  "state": enum (State),
  "uid": string
}
Champs
name

string

Uniquement en sortie. Nom de ressource de cette règle d'accès externe. Les noms de ressources sont des URI sans schéma qui suivent les conventions décrites sur https://cloud.google.com/apis/design/resource_names. Par exemple : projects/my-project/locations/us-central1/networkPolicies/my-policy/externalAccessRules/my-rule
createTime

string (Timestamp format)

Uniquement en sortie. Heure de création de cette ressource.

Utilise la norme RFC 3339, où la sortie générée utilise toujours le format UTC (indiqué par "Z" pour le temps universel coordonné) avec des secondes fractionnaires de 0, 3, 6 ou 9 chiffres décimaux. Des décalages horaires autres que "Z" (UTC) sont également acceptés. Exemples : "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
updateTime

string (Timestamp format)

Uniquement en sortie. Heure de la dernière mise à jour de cette ressource.

Utilise la norme RFC 3339, où la sortie générée utilise toujours le format UTC (indiqué par "Z" pour le temps universel coordonné) avec des secondes fractionnaires de 0, 3, 6 ou 9 chiffres décimaux. Des décalages horaires autres que "Z" (UTC) sont également acceptés. Exemples : "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
description

string

Description de cette règle d'accès externe fournie par l'utilisateur.
priority

integer

Priorité de la règle d'accès externe, qui détermine la règle d'accès externe à utiliser lorsque plusieurs règles s'appliquent. Si plusieurs règles ont la même priorité, leur ordre n'est pas déterministe. Si un ordre spécifique est requis, attribuez des priorités uniques pour l'appliquer. La priorité de la règle d'accès externe est un entier compris entre 100 et 4 096 (inclus). Des entiers plus petits indiquent une priorité plus élevée. Par exemple, une règle de priorité 100 est prioritaire par rapport à une règle de priorité 101.
action

enum (Action)

Action effectuée par la règle d'accès externe.
ipProtocol

string

Protocole IP auquel s'applique la règle d'accès externe. Cette valeur peut être l'une des trois chaînes de protocole suivantes (non sensibles à la casse) : tcp, udp ou icmp.
sourceIpRanges[]

object (IpRange)

Si des plages sources sont spécifiées, la règle d'accès externe ne s'applique qu'au trafic dont l'adresse IP source se trouve dans ces plages. Ces plages peuvent être exprimées au format CIDR ou sous forme d'adresse IP. Étant donné que seules les règles entrantes sont acceptées, les ressources ExternalAddress ne peuvent pas être les adresses IP sources d'une règle d'accès externe. Pour faire correspondre toutes les adresses sources, spécifiez 0.0.0.0/0.
sourcePorts[]

string

Liste des ports sources auxquels la règle d'accès externe s'applique. Ce champ ne s'applique qu'au protocole UDP ou TCP. Chaque entrée doit être un nombre entier ou une plage. Par exemple : ["22"], ["80","443"] ou ["12345-12349"]. Pour faire correspondre tous les ports sources, spécifiez ["0-65535"].
destinationIpRanges[]

object (IpRange)

Si des plages de destination sont spécifiées, la règle d'accès externe ne s'applique qu'au trafic dont l'adresse IP de destination se trouve dans ces plages. Les adresses IP spécifiées doivent avoir des adresses IP externes réservées dans le champ d'application de la règle de réseau parente. Pour faire correspondre toutes les adresses IP externes dans le champ d'application de la règle de réseau parente, spécifiez 0.0.0.0/0. Pour faire correspondre une adresse IP externe spécifique, spécifiez-la à l'aide de la propriété IpRange.external_address.
destinationPorts[]

string

Liste des ports de destination auxquels la règle d'accès externe s'applique. Ce champ ne s'applique qu'au protocole UDP ou TCP. Chaque entrée doit être un nombre entier ou une plage. Par exemple : ["22"], ["80","443"] ou ["12345-12349"]. Pour faire correspondre tous les ports de destination, spécifiez ["0-65535"].
state

enum (State)

Uniquement en sortie. État de la ressource.
uid

string

Uniquement en sortie. Identifiant unique généré par le système pour la ressource.

Action

L'action détermine si la règle d'accès externe autorise ou bloque le trafic, en fonction des autres composants de la règle correspondant au trafic.

Enums
ACTION_UNSPECIFIED La valeur par défaut est "Autoriser".
ALLOW Autorise les connexions correspondant aux autres composants spécifiés.
DENY Bloque les connexions correspondant aux autres composants spécifiés.

IpRange

Plage d'adresses IP fournie dans l'un des formats acceptés.

Représentation JSON 
{

  // Union field ip_range can be only one of the following:
  "ipAddress": string,
  "ipAddressRange": string,
  "externalAddress": string
  // End of list of possible types for union field ip_range.
}
Champs

Champ d'union ip_range.

ip_range ne peut être qu'un des éléments suivants :
ipAddress

string

Une seule adresse IP. Exemple : 10.0.0.5.
ipAddressRange

string

Plage d'adresses IP au format CIDR. Exemple : 10.0.0.0/24.
externalAddress

string

Nom d'une ressource ExternalAddress. L'adresse externe doit avoir été réservée dans le champ d'application de la règle de réseau parente de cette règle d'accès externe. Indiquez le nom de l'adresse externe au format projects/{project}/locations/{location}/privateClouds/{privateCloud}/externalAddresses/{externalAddress}. Par exemple : projects/my-project/locations/us-central1-a/privateClouds/my-cloud/externalAddresses/my-address.

État

Définit les états possibles des règles de pare-feu d'accès externe.

Enums
STATE_UNSPECIFIED Valeur par défaut. Cette valeur est utilisée si l'état est omis.
ACTIVE La règle est prête.
CREATING La règle est en cours de création.
UPDATING La règle est en cours de mise à jour.
DELETING La règle est en cours de suppression.

Méthodes

create

 Crée une règle d'accès externe dans une règle de réseau donnée.

delete

 Supprime une seule règle d'accès externe.

get

 Récupère les détails d'une seule règle d'accès externe.

list

 Liste les ressources ExternalAccessRule dans la règle de réseau spécifiée.

patch

 Met à jour les paramètres d'une seule règle d'accès externe.