Einen Weiterleitungseintrag für eine Subdomain hinzufügen¶

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 Eintrags gesetzt.

Senden einer POST-Anfrage an den Endpunkt /domain/{domainId}/redirects/{name}.

Beschreibung¶

Mit der Add-Redirect-Anfrage fügen Sie einer Subdomain der Organisation einen oder mehrere Weiterleitungseinträge hinzu.

Voraussetzungen¶

Werte der Anfrage: Domain-ID {domainId}, Subdomain name {name}

Objekte: DnsRedirectVO

Anfrage¶

Um einer Subdomain einen oder mehrere Weiterleitungseinträge hinzuzufügen, fügen Sie die Domain-ID {domainId} und den Subdomain name {name} dem Pfad der Anfrage hinzu.

Für eine detaillierte Spezifikation, welche Informationen zum Hinzufügen eines Weiterleitungseintrags erforderlich sind, müssen im Body ein oder mehrere Objekte DnsRedirectVO mit den folgenden Attributen definiert werden:

Attribut	Beschreibung	Werte
`source`	Der Pfad einer Domain oder Subdomain, die weitergeleitet werden soll.	`string`
`destination`	Das Ziel, auf das die Weiterleitung zeigt.	`string`
`type`	Der Typ der Weiterleitung.	`permanent` -> HTTP-Code 301 `redirect` -> HTTP-Code 302
`subDomainName`	Der Name der Subdomain.	`string`

Die folgenden Attribute sind optional:

Attribut	Beschreibung	Werte
`matchingType`	Die Bedingung für den Abgleich.	`exact` `prefix` `suffix`
`expertMode`	Legt fest, ob der Expertenmodus aktiviert oder deaktiviert ist. Wenn der Expertenmodus aktiviert ist, überspringt Myra die Prüfung der Regel auf Endlosschleifen.	`true` `false`
`sort`	Die aufsteigende Reihenfolge des Eintrags.	`integer`
`comment`	Ein individueller Kommentar für den Eintrag.	`string`
`enabled`	Die Verfügbarkeit des Eintrags.	`true` `false`

Das System gibt als Antwort das Objekt DnsRedirectVO mit den Informationen zum neuen Eintrag zurück.

Beispiel¶

Beispiel-Request-Body:

{
  "objectType": "string",
  "source": "string",
  "destination": "string",
  "type": "string",
  "subDomainName": "string",
  "matchingType": "string",
  "expertMode": true,
  "sort": 0,
  "comment": "string",
  "enabled": true
}

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.