Method: projects.locations.addressGroups.addItems

Fügt einer Adressgruppe Elemente hinzu.

HTTP-Anfrage

POST https://networksecurity.googleapis.com/v1beta1/{addressGroup=projects/*/locations/*/addressGroups/*}:addItems

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
addressGroup

string

Erforderlich. Der Name der Adressgruppe, der Elemente hinzugefügt werden sollen. Muss im Format projects|organization/*/locations/{location}/addressGroups/* vorliegen.

Für die Autorisierung ist die folgende IAM-Berechtigung für die angegebene Ressource addressGroup erforderlich:

  • networksecurity.addressGroups.update

Anfragetext

Der Anfragetext enthält Daten mit folgender Struktur:

JSON-Darstellung 
{
  "items": [
    string
  ],
  "requestId": string
}
Felder
items[]

string

Erforderlich. Liste der Elemente, die hinzugefügt werden sollen.
requestId

string

Optional. Eine optionale Anfrage-ID zur Identifizierung von Anfragen. Geben Sie eine eindeutige Anfrage-ID an, damit der Server die Anfrage ignoriert, falls sie bereits abgeschlossen wurde, falls Sie Ihre Anfrage wiederholen müssen. Der Server gewährleistet dies für mindestens 60 Minuten nach der ersten Anfrage.

Stellen Sie sich beispielsweise eine Situation vor, in der Sie eine erste Anfrage stellen und diese das Zeitlimit überschreitet. Wenn Sie die Anfrage mit derselben Anfrage-ID noch einmal senden, kann der Server prüfen, ob der ursprüngliche Vorgang mit derselben Anfrage-ID empfangen wurde. Ist dies der Fall, wird die zweite Anfrage ignoriert. Dadurch wird verhindert, dass Clients versehentlich doppelte Zusicherungen erstellen.

Die Anfrage-ID muss eine gültige UUID sein, mit der Ausnahme, dass null UUID nicht unterstützt wird (00000000-0000-0000-0000-000000000000).

Antworttext

Wenn der Vorgang erfolgreich abgeschlossen wurde, enthält der Antworttext eine Instanz von Operation.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/cloud-platform

Weitere Informationen finden Sie in der Authentifizierungsübersicht.