REST Resource: organizations.locations.firewallEndpoints

Ressource: FirewallEndpoint

Nachricht, die das Endpunktobjekt beschreibt

JSON-Darstellung
{
  "name": string,
  "description": string,
  "createTime": string,
  "updateTime": string,
  "labels": {
    string: string,
    ...
  },
  "state": enum (State),
  "reconciling": boolean,
  "associatedNetworks": [
    string
  ],
  "associations": [
    {
      object (AssociationReference)
    }
  ],
  "billingProjectId": string,
  "type": enum (Type),

  // Union field settings can be only one of the following:
  "firstPartyEndpointSettings": {
    object (FirstPartyEndpointSettings)
  },
  "thirdPartyEndpointSettings": {
    object (ThirdPartyEndpointSettings)
  }
  // End of list of possible types for union field settings.
}
Felder
name

string

Nicht veränderbar. Kennzeichnungsname der Ressource

description

string

Optional. Beschreibung des Firewall-Endpunkts. Maximale Länge: 2.048 Zeichen

createTime

string (Timestamp format)

Nur Ausgabe. Zeitstempel erstellen

Ein Zeitstempel im Format RFC3339 UTC "Zulu" mit einer Auflösung im Nanosekundenbereich und bis zu neun Nachkommastellen. Beispiele: "2014-10-02T15:01:23Z" und "2014-10-02T15:01:23.045123456Z".

updateTime

string (Timestamp format)

Nur Ausgabe. Zeitstempel aktualisieren

Ein Zeitstempel im Format RFC3339 UTC "Zulu" mit einer Auflösung im Nanosekundenbereich und bis zu neun Nachkommastellen. Beispiele: "2014-10-02T15:01:23Z" und "2014-10-02T15:01:23.045123456Z".

labels

map (key: string, value: string)

Optional. Labels als Schlüssel/Wert-Paare

Ein Objekt, das eine Liste von "key": value-Paaren enthält. Beispiel: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

state

enum (State)

Nur Ausgabe. Aktueller Status des Endpunkts.

reconciling

boolean

Nur Ausgabe. Ob ein Abgleich läuft, empfohlen gemäß https://google.aip.dev/128.

associatedNetworks[]
(deprecated)

string

Nur Ausgabe. Liste der Netzwerke, die mit diesem Endpunkt in der lokalen Zone verknüpft sind. Dies ist eine Projektion der FirewallEndpointAssociations, die auf diesen Endpunkt verweist. Ein Netzwerk wird erst in dieser Liste angezeigt, wenn das Traffic-Routing vollständig konfiguriert ist. Format: projects/{project}/global/networks/{name}.

associations[]

object (AssociationReference)

Nur Ausgabe. Liste der FirewallEndpointAssociations, die mit diesem Endpunkt verknüpft sind. Eine Verknüpfung wird erst in dieser Liste angezeigt, wenn das Traffic-Routing vollständig konfiguriert ist.

billingProjectId

string

Erforderlich. Projekt zur Abrechnung der Nutzung der Endpunktbetriebszeit.

type

enum (Type)

Optional. Endpunkttyp.

Union-Feld settings. Spezifische Einstellungen für den Endpunkttyp. Für settings ist nur einer der folgenden Werte zulässig:
firstPartyEndpointSettings

object (FirstPartyEndpointSettings)

Optional. Firewall-Endpunkteinstellungen für eigene Firewall-Endpunkte.

thirdPartyEndpointSettings

object (ThirdPartyEndpointSettings)

Optional. Firewall-Endpunkteinstellungen für Firewall-Endpunkte von Drittanbietern

FirstPartyEndpointSettings

Dieser Typ hat keine Felder.

Nächste ID: 1.

ThirdPartyEndpointSettings

Nächste ID: 2.

JSON-Darstellung
{
  "targetFirewallAttachment": string
}
Felder
targetFirewallAttachment

string

Optional. URL des Ziel-Firewallanhangs.

Status

Endpunktstatus.

Enums
STATE_UNSPECIFIED Nicht definiert.
CREATING Wird erstellt.
ACTIVE Konfigurationsaktualisierungen werden verarbeitet.
DELETING Wird gelöscht.
INACTIVE Nicht verfügbar oder fehlerhaft.

AssociationReference

Dies ist eine Teilmenge der FirewallEndpointAssociation-Nachricht, die Felder enthält, die vom Nutzer verwendet werden sollen.

JSON-Darstellung
{
  "name": string,
  "network": string
}
Felder
name

string

Nur Ausgabe. Der Ressourcenname der FirewallEndpointAssociation. Format: projects/{project}/locations/{location}/firewallEndpointAssociations/{id}

network

string

Nur Ausgabe. Das zugehörige VPC-Netzwerk. Format: projects/{project}/global/networks/{name}.

Typ

Typ des Firewall-Endpunkts.

Enums
TYPE_UNSPECIFIED Nicht definiert.
FIRST_PARTY Eigener Firewall-Endpunkt.
THIRD_PARTY Firewall-Endpunkt eines Drittanbieters.

Methoden

create

Erstellt einen neuen FirewallEndpoint in einem bestimmten Projekt und an einem bestimmten Standort.

delete

Löscht einen einzelnen Endpunkt.

get

Ruft Details zu einem einzelnen Endpunkt ab.

list

Listet FirewallEndpunkte in einem bestimmten Projekt und an einem bestimmten Standort auf.

patch

Einzelnen Endpunkt aktualisieren.