REST Resource: projects.locations.networkPolicies.externalAccessRules

Recurso: ExternalAccessRule

Son reglas de firewall de acceso externo para filtrar el tráfico entrante destinado a los recursos de ExternalAddress.

Representación 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

Solo salida. Es el nombre del recurso de esta regla de acceso externo. Los nombres de recursos son URIs sin esquema que siguen las convenciones que se indican en https://cloud.google.com/apis/design/resource_names. Por ejemplo: projects/my-project/locations/us-central1/networkPolicies/my-policy/externalAccessRules/my-rule.
createTime

string (Timestamp format)

Solo salida. Es la fecha y hora de creación de este recurso.

Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
updateTime

string (Timestamp format)

Solo salida. Es la fecha y hora de la última actualización de este recurso.

Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
description

string

Es la descripción proporcionada por el usuario para esta regla de acceso externo.
priority

integer

Es la prioridad de la regla de acceso externo, que determina qué regla de acceso externo se debe usar cuando se aplican varias reglas. Si varias reglas tienen la misma prioridad, su orden no es determinístico. Si se requiere un orden específico, asigna prioridades únicas para aplicarlo. La prioridad de la regla de acceso externo es un número entero del 100 al 4096, ambos incluidos. Los números enteros más bajos indican una mayor precedencia. Por ejemplo, una regla con prioridad 100 tiene mayor precedencia que una regla con prioridad 101.
action

enum (Action)

Es la acción que realiza la regla de acceso externo.
ipProtocol

string

Es el protocolo IP al que se aplica la regla de acceso externo. Este valor puede ser una de las siguientes tres cadenas de protocolo (sin distinción entre mayúsculas y minúsculas): tcp, udp o icmp.
sourceIpRanges[]

object (IpRange)

Si se especifican rangos de origen, la regla de acceso externo solo se aplica al tráfico que tiene una dirección IP de origen en estos rangos. Estos rangos se pueden expresar en formato CIDR o como una dirección IP. Como solo se admiten reglas de entrada, los recursos ExternalAddress no pueden ser las direcciones IP de origen de una regla de acceso externo. Para que coincidan todas las direcciones de origen, especifica 0.0.0.0/0.
sourcePorts[]

string

Es una lista de puertos de origen a los que se aplica la regla de acceso externo. Este campo solo se aplica al protocolo UDP o TCP. Cada entrada debe ser un número entero o un rango. Por ejemplo, ["22"], ["80","443"] o ["12345-12349"]. Para que coincidan todos los puertos de origen, especifica ["0-65535"].
destinationIpRanges[]

object (IpRange)

Si se especifican rangos de destino, la regla de acceso externo solo se aplica al tráfico que tiene una dirección IP de destino en estos rangos. Las direcciones IP especificadas deben tener direcciones IP externas reservadas en el alcance de la política de red principal. Para que coincidan todas las direcciones IP externas en el alcance de la política de red principal, especifica 0.0.0.0/0. Para que coincida con una dirección IP externa específica, especifícala con la propiedad IpRange.external_address.
destinationPorts[]

string

Es una lista de puertos de destino a los que se aplica la regla de acceso externo. Este campo solo se aplica al protocolo UDP o TCP. Cada entrada debe ser un número entero o un rango. Por ejemplo, ["22"], ["80","443"] o ["12345-12349"]. Para que coincidan todos los puertos de destino, especifica ["0-65535"].
state

enum (State)

Solo salida. Es el estado del recurso.
uid

string

Solo salida. Es el identificador único generado por el sistema para el recurso.

Acción

La acción determina si la regla de acceso externo permite o bloquea el tráfico, sujeto a que los demás componentes de la regla coincidan con el tráfico.

Enums
ACTION_UNSPECIFIED El valor predeterminado es permitir.
ALLOW Permite las conexiones que coinciden con los otros componentes especificados.
DENY Bloquea las conexiones que coinciden con los otros componentes especificados.

IpRange

Es un rango de IP proporcionado en cualquiera de los formatos admitidos.

Representación 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ón ip_range.

ip_range puede ser una de las siguientes opciones:
ipAddress

string

Una sola dirección IP Por ejemplo: 10.0.0.5.
ipAddressRange

string

Es un rango de direcciones IP en formato CIDR. Por ejemplo: 10.0.0.0/24.
externalAddress

string

Es el nombre de un recurso ExternalAddress. La dirección externa debe haberse reservado en el alcance de la política de red principal de esta regla de acceso externo. Proporciona el nombre de la dirección externa en el formato projects/{project}/locations/{location}/privateClouds/{privateCloud}/externalAddresses/{externalAddress}. Por ejemplo: projects/my-project/locations/us-central1-a/privateClouds/my-cloud/externalAddresses/my-address.

Estado

Define los posibles estados de las reglas de firewall de acceso externo.

Enums
STATE_UNSPECIFIED Es el valor predeterminado. Este valor se usa si se omite el estado.
ACTIVE La regla está lista.
CREATING Se está creando la regla.
UPDATING Se está actualizando la regla.
DELETING Se está borrando la regla.

Métodos

create

 Crea una regla de acceso externo nueva en una política de red determinada.

delete

 Borra una sola regla de acceso externo.

get

 Obtiene detalles de una sola regla de acceso externo.

list

 Enumera los recursos ExternalAccessRule en la política de red especificada.

patch

 Actualiza los parámetros de una sola regla de acceso externo.