Ein Tag kopieren¶

Note

Wenn die optionalen Attribute nicht gesetzt sind, setzt das System einen Standardwert ein.

Note

Der Body enthält die Attribute id, created und modified nicht. Die Werte dieser Attribute werden vom System nach dem Erstellen des Tags gesetzt.

Senden einer POST-Anfrage an den Endpunkt /tags/{id}.

Beschreibung¶

Mit der Copy-Tag-Anfrage kopieren Sie ein Tag der Organisation und weisen es einer oder mehreren Domains und Subdomains zu.

Voraussetzungen¶

Werte der Anfrage: Tag-ID {id}

Objekte: TagVO, TagAssignmentVO

Anfrage¶

Um ein Tag zu kopieren, fügen Sie die Tag-ID {id} dem Pfad der HTTP-Anfrage hinzu.

Optional können die Objekte TagVO und TagAssignmentVO dem Body der Copy-Tag-Anfrage hinzugefügt werden, um den Namen zu ändern oder die zugewiesenen Domains oder Subdomains anzupassen.

Werden die Objekte TagVO und TagAssignmentVO nicht mit der Anfrage gesendet, erstellt das System nur eine Kopie des Tags und fügt dem Namen des kopierten Tags (Copy) hinzu.

Die folgenden Attribute der Objekte TagVO und TagAssignmentVO sind optional:

TagVO¶

Attribut	Beschreibung	Werte
`name`	Der Name des Tags.	`string`
`assignments`	Ein oder mehrere Objekte `TagAssignmentVO`.
`label`	Ein Schlagwort für das Tag.	`string`
`comment`	Ein individueller Kommentar für den Eintrag.	`string`

TagAssignmentVO¶

Attribut	Beschreibung	Werte
`type`	Der Typ der Tag-Zuweisung.	`DOMAIN` `SUBDOMAIN`
`subDomainName`	Der Name der Subdomain, wenn der Wert des Attributs `type` gleich `SUBDOMAIN` ist.	`string`
`title`	Der Titel der Tag-Zuweisung.	`string`
`comment`	Ein individueller Kommentar für den Eintrag.	`string`

Das System gibt als Antwort die Objekte TagVO und TagAssignmentVO mit den Informationen zum neuen Eintrag zurück.

Beispiel¶

Beispiel-Request-Body:

{
  "name": "string",
  "assignments": "string",
  "label": "string",
  "comment": "string",
  "type": "DOMAIN",
  "subDomainName": "string",
  "title": "string"
}

Antworten¶

Die folgenden Antworten sind möglich:

STATUSCODE	BESCHREIBUNG
201	Die Anfrage war erfolgreich und ein neues Objekt wurde erstellt.
400	Die Anfrage war nicht erfolgreich. Die Anfrage war fehlerhaft oder es fehlen Informationen.
401	Die Anfrage war nicht erfolgreich, da die Authentifizierung fehlerhaft war.
403	Die Anfrage war nicht erfolgreich, da die erforderlichen Berechtigungen fehlen.