Das Load Balancing eines DNS-Eintrags ändern¶

Note

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

Note

Stellen Sie sicher, dass die ID des DNS-Eintrags im Pfad der Anfrage mit dem Wert des Attributs id im Body übereinstimmt.

Note

Sie können die Einstellungen für Load Balancing zusammen mit der Erstellung eines DNS-Eintrags festlegen. Fügen Sie dazu lediglich das Objekt UpstreamOptionsVO unter upstreamOptions hinzu.

Senden einer PUT-Anfrage an den Endpunkt /domain/{domainId}/dns-records/{id}/load-balancing.

Beschreibung¶

Mit der Change-Load-Balancing-Anfrage ändern Sie das Load Balancing eines DNS-Eintrags der Organisation.

Voraussetzungen¶

Werte der Anfrage: Domain-ID {domainId}, DNS-Record-ID {id}

Objekte: UpstreamOptionsVO

Anfrage¶

Um die Einstellung für das Load Balancing eines DNS-Eintrags zu ändern, fügen Sie die Domain-ID {domainId} und die DNS-Record-ID {id} dem Pfad der Anfrage hinzu.

Für eine detaillierte Spezifikation, welche Informationen zum Ändern des Load Balancings eines DNS-Eintrags erforderlich sind, muss im Body das Objekt UpstreamOptionsVO mit den folgenden Attributen definiert werden:

Attribut	Beschreibung	Werte
`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
`weight`	Die Gewichtung des SRV-Records.	`integer`
`mxFails`	Die Anzahl der Fehler, die vorliegen müssen, damit das Load Balancing startet.	`integer`
`failTimeout`	Der Maximalwert in Sekunden für Verbindungsfehler, bis das Load Balancing aktiviert wird.	`1` `10` `60` `600` `900` `1800` `3600`
`backup`	Legt fest, ob der Eintrag ein Backup-Server ist oder nicht.	`true` `false`
`down`	Legt fest, ob der Server verfügbar ist.	`true` `false`

Das System gibt das Objekt UpstreamOptionsVO mit den geänderten Informationen zurück.

Beispiel¶

Beispiel-Request-Body:

{
  "objectType": "string",
  "name": "string",
  "value": "string",
  "priority": 0,
  "ttl": 0,
  "vhostId": 0,
  "recordType": "string",
  "weight": 0,
  "port": 0,
  "active": true,
  "paused": true,
  "sslCertTemplate": "string",
  "upstreamOptions": "string",
  "alternativeCname": "string",
  "environment": "string",
  "caaFlags": 0,
  "caaTag": "string",
  "endpoints": "string",
  "serviceType": 0,
  "encryption": "string",
  "identificationNumber": "string",
  "hashType": "string",
  "enabled": true,
  "comment": "string"
}

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.