REST Resource: projects.locations.multicastGroupRanges

Ressource: MulticastGroupRange

Ressource für den Multicast-Gruppenbereich.

JSON-Darstellung
{
  "name": string,
  "createTime": string,
  "updateTime": string,
  "state": {
    object (MulticastResourceState)
  },
  "labels": {
    string: string,
    ...
  },
  "reservedInternalRange": string,
  "multicastDomain": string,
  "ipCidrRange": string,
  "description": string,
  "uniqueId": string,
  "consumerAcceptList": [
    string
  ],
  "requireExplicitAccept": boolean,
  "logConfig": {
    object (MulticastLogConfig)
  },
  "distributionScope": enum (DistributionScope)
}
Felder
name

string

ID. Der Ressourcenname des Multicast-Gruppenbereichs. Verwenden Sie das folgende Format: projects/*/locations/global/multicastGroupRanges/*.

createTime

string (Timestamp format)

Nur Ausgabe. [Nur Ausgabe] Der Zeitstempel, zu dem der Multicastgruppenbereich erstellt wurde.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30"

updateTime

string (Timestamp format)

Nur Ausgabe. [Nur Ausgabe] Der Zeitstempel, der angibt, wann der Multicastgruppenbereich zuletzt aktualisiert wurde.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30"

state

object (MulticastResourceState)

Nur Ausgabe. [Nur Ausgabe] Der Status der Ressource.

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" }.

reservedInternalRange

string

Erforderlich. Der Ressourcenname des internen Bereichs, der für diesen Multicast-Gruppenbereich reserviert ist.

Der interne Bereich muss eine Klasse D-Adresse (224.0.0.0 bis 239.255.255.255) mit einer Präfixlänge von mindestens 23 sein.

Verwenden Sie das folgende Format: projects/*/locations/global/internalRanges/*.

multicastDomain

string

Erforderlich. Der Ressourcenname der Multicast-Domain, in der dieser Multicast-Gruppenbereich erstellt werden soll. Verwenden Sie das folgende Format: projects/*/locations/global/multicastDomains/*.

ipCidrRange

string

Nur Ausgabe. [Nur Ausgabe] Der IP-Adressbereich der Multicast-Gruppe.

description

string

Optional. Eine optionale Textbeschreibung des Multicast-Gruppenbereichs.

uniqueId

string

Nur Ausgabe. [Nur Ausgabe] Die von Google generierte UUID für die Ressource. Dieser Wert ist für alle Multicast-Gruppenbereichsressourcen eindeutig. Wenn ein Gruppenbereich gelöscht und ein anderer mit demselben Namen erstellt wird, erhält der neue Gruppenbereich eine andere uniqueId.

consumerAcceptList[]

string

Optional. Eine Liste von Nutzerprojekten, die die Multicast-IP-Adressen im Bereich abonnieren dürfen, der durch diesen MulticastGroupRange definiert wird. Das Projekt kann über seine Projekt-ID oder Projektnummer angegeben werden. Wenn dieses Feld leer gelassen wird, sind alle Nutzerprojekte zulässig (sofern „requireExplicitAccept“ nicht auf „true“ gesetzt ist), sobald ihnen VPC-Netzwerke zugeordnet sind. Die aktuelle maximale Länge der Akzeptanzliste beträgt 100.

requireExplicitAccept

boolean

Optional. Gibt an, ob alle Nutzerprojekte abgelehnt werden, wenn „consumerAcceptList“ leer ist.

logConfig

object (MulticastLogConfig)

Optional. Gibt die Protokollierungsoptionen für die Aktivitäten an, die im Zusammenhang mit allen Aktivierungen des Multicast-Gruppenbereichs ausgeführt werden, die dem Multicast-Gruppenbereich zugeordnet sind. Die Standardeinstellung ist „false“. Wenn das Logging aktiviert ist, werden Logs nach Cloud Logging exportiert.

distributionScope

enum (DistributionScope)

Optional. Verteilungsbereich des Multicast-Gruppenbereichs. Zonenübergreifend innerhalb einer Zone oder Region wird unterstützt. Der Standardwert ist „innerhalb einer Region“. Die regionenübergreifende Verteilung wird nicht unterstützt.

DistributionScope

Verteilungsbereich des Multicast-Gruppenbereichs.

Enums
DISTRIBUTION_SCOPE_UNSPECIFIED Ein nicht angegebener Wert bedeutet keine Einschränkung. Es wird also der vom System unterstützte breiteste Bereich angewendet.
INTRA_ZONE Multicast-Traffic wird von der Quelle nur an Abonnenten in derselben Zone verteilt.
INTRA_REGION Multicast-Traffic wird von der Quelle an Abonnenten in einer beliebigen Zone in derselben Region verteilt.

Methoden

create

Erstellt einen neuen Multicast-Gruppenbereich in einem bestimmten Projekt und an einem bestimmten Standort.

delete

Löscht einen einzelnen Multicast-Gruppenbereich.

get

Ruft Details zu einem einzelnen Multicast-Gruppenbereich ab.

list

Listet Multicast-Gruppenbereiche in einem bestimmten Projekt und an einem bestimmten Standort auf.

patch

Aktualisiert die Parameter eines einzelnen Multicast-Gruppenbereichs.