Die Einstellungen eines Weiterleitungseintrags einer Subdomain ändern¶

Note

Der Body muss die Attribute id und modified enthalten, um den entsprechenden Eintrag zu identifizieren.

Note

Die ID des Eintrags im Pfad der Anfrage muss mit dem Wert des Attributs id im Body übereinstimmen.

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

Beschreibung¶

Mit der Change-Redirect-Anfrage ändern Sie die Einstellungen eines Weiterleitungseintrags einer Subdomain der Organisation.

Voraussetzungen¶

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

Objekte: DnsRedirectVO

Anfrage¶

Um die Einstellung eines Weiterleitungseintrags einer Subdomain zu ändern, fügen Sie die Domain-ID {domainId}, den Subdomain name {name} und die Redirect-ID {id} dem Pfad der Anfrage hinzu.

Für eine detaillierte Spezifikation, welche Informationen zum Ändern der Einstellungen eines Weiterleitungseintrags erforderlich sind, muss im Body das Objekt 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`
`id`	Die ID des Eintrags.	`integer`
`modified`	Das Datum der letzten Änderung im ISO-8601-Format.	`string($date-time)`

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 das Objekt DnsRedirectVO mit den geänderten Informationen 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
200	Die Anfrage war erfolgreich.
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.