REST Resource: projects.locations.networkPolicies.externalAccessRules

Recurso: ExternalAccessRule

Regras de firewall de acesso externo para filtrar o tráfego de entrada destinado a recursos ExternalAddress.

Representação 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
}
Campos
name

string

Apenas saída. O nome do recurso dessa regra de acesso externo. Os nomes de recursos são URIs sem esquema que seguem as convenções em https://cloud.google.com/apis/design/resource_names. Por exemplo: projects/my-project/locations/us-central1/networkPolicies/my-policy/externalAccessRules/my-rule
createTime

string (Timestamp format)

Apenas saída. Hora de criação deste recurso.

Usa o padrão RFC 3339, em que a saída gerada é sempre convertida em Z e tem 0, 3, 6 ou 9 dígitos fracionários. Além de Z, outros ajustes também são aceitos. Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
updateTime

string (Timestamp format)

Apenas saída. A última atualização deste recurso.

Usa o padrão RFC 3339, em que a saída gerada é sempre convertida em Z e tem 0, 3, 6 ou 9 dígitos fracionários. Além de Z, outros ajustes também são aceitos. Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
description

string

Descrição fornecida pelo usuário para essa regra de acesso externo.
priority

integer

Prioridade da regra de acesso externo, que determina qual regra usar quando várias regras são aplicáveis. Se várias regras tiverem a mesma prioridade, a ordem delas não será determinística. Se uma ordenação específica for necessária, atribua prioridades exclusivas para impor essa ordenação. A prioridade da regra de acesso externo é um número inteiro de 100 a 4096, incluindo esses dois valores. Os números inteiros mais baixos indicam maior precedência. Por exemplo, uma regra com prioridade 100 tem precedência maior do que uma regra com prioridade 101.
action

enum (Action)

A ação que a regra de acesso externo realiza.
ipProtocol

string

O protocolo IP a que a regra de acesso externo se aplica. Esse valor pode ser uma das três strings de protocolo a seguir (sem diferenciação entre maiúsculas e minúsculas): tcp, udp ou icmp.
sourceIpRanges[]

object (IpRange)

Se os intervalos de origem forem especificados, a regra de acesso externo será aplicada apenas ao tráfego que tiver um endereço IP de origem nesses intervalos. Esses intervalos podem ser expressos no formato CIDR ou como um endereço IP. Como apenas regras de entrada são aceitas, os recursos ExternalAddress não podem ser os endereços IP de origem de uma regra de acesso externo. Para corresponder a todos os endereços de origem, especifique 0.0.0.0/0.
sourcePorts[]

string

Uma lista de portas de origem a que a regra de acesso externo se aplica. Esse campo só é aplicável aos protocolos UDP ou TCP. Cada entrada precisa ser um número inteiro ou um intervalo. Por exemplo, ["22"], ["80","443"] ou ["12345-12349"]. Para corresponder a todas as portas de origem, especifique ["0-65535"].
destinationIpRanges[]

object (IpRange)

Se os intervalos de destino forem especificados, a regra de acesso externo será aplicada apenas ao tráfego que tiver um endereço IP de destino nesses intervalos. Os endereços IP especificados precisam ter endereços IP externo reservados no escopo da política de rede principal. Para corresponder a todos os endereços IP externo no escopo da política de rede principal, especifique 0.0.0.0/0. Para corresponder a um endereço IP externo específico, especifique-o usando a propriedade IpRange.external_address.
destinationPorts[]

string

Uma lista de portas de destino a que a regra de acesso externo se aplica. Esse campo só é aplicável aos protocolos UDP ou TCP. Cada entrada precisa ser um número inteiro ou um intervalo. Por exemplo, ["22"], ["80","443"] ou ["12345-12349"]. Para corresponder a todas as portas de destino, especifique ["0-65535"].
state

enum (State)

Apenas saída. O estado do recurso.
uid

string

Apenas saída. Identificador exclusivo gerado pelo sistema para o recurso.

Ação

A ação determina se a regra de acesso externo permite ou bloqueia o tráfego, sujeito aos outros componentes da regra que correspondem ao tráfego.

Tipos enumerados
ACTION_UNSPECIFIED O padrão é "permitir".
ALLOW Permite conexões que correspondem aos outros componentes especificados.
DENY Bloqueia conexões que correspondem aos outros componentes especificados.

IpRange

Um intervalo de IP fornecido em um dos formatos compatíveis.

Representação 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.
}
Campos

Campo de união ip_range.

ip_range pode ser apenas de um dos tipos a seguir:
ipAddress

string

Um único endereço IP. Por exemplo, 10.0.0.5.
ipAddressRange

string

Um intervalo de endereços IP no formato CIDR. Por exemplo, 10.0.0.0/24.
externalAddress

string

O nome de um recurso ExternalAddress. O endereço externo precisa ter sido reservado no escopo da política de rede mãe dessa regra de acesso externo. Forneça o nome do endereço externo no formato projects/{project}/locations/{location}/privateClouds/{privateCloud}/externalAddresses/{externalAddress}. Por exemplo: projects/my-project/locations/us-central1-a/privateClouds/my-cloud/externalAddresses/my-address.

Estado

Define os possíveis estados das regras de firewall de acesso externo.

Tipos enumerados
STATE_UNSPECIFIED O valor padrão. Esse valor é usado se o estado for omitido.
ACTIVE A regra está pronta.
CREATING A regra está sendo criada.
UPDATING A regra está sendo atualizada.
DELETING A regra está sendo excluída.

Métodos

create

 Cria uma regra de acesso externo em uma determinada política de rede.

delete

 Exclui uma única regra de acesso externo.

get

 Recebe detalhes de uma única regra de acesso externo.

list

 Lista recursos ExternalAccessRule na política de rede especificada.

patch

 Atualiza os parâmetros de uma única regra de acesso externo.