Die Konfiguration einer Domain ändern¶

Note

Wenn das automatische Update deaktiviert ist, werden Änderungen an Ihrer Konfiguration erst übernommen, wenn Sie das automatische Update wieder aktivieren. Die Deaktivierung des automatischen Updates dient in erster Linie dazu, viele Einstellungen auf einmal zu ändern, damit Myra keine halbfertige Konfiguration ausrollt. In einigen Fällen deaktiviert auch der Myra-Support diese Option, um zu verhindern, dass das Myra-System spezielle Konfigurationseinstellungen entfernt. Beachten Sie, dass das Deaktivieren von autoUpdate nicht mit Datenbanktransaktionen zusammenhängt. Alle vorgenommenen Änderungen werden gespeichert, aber nicht ausgerollt.

Note

Um weitere Informationen zu ändern, muss der Domain-Eintrag gelöscht und neu erstellt werden.

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.

Senden einer PUT-Anfrage an den Endpunkt /domains/{id}.

Beschreibung¶

Mit der Change-Domain-Configuration-Anfrage aktivieren oder deaktivieren Sie das automatische Update und ändern den Umgebungstyp einer Domain der Organisation.

Voraussetzungen¶

Werte der Anfrage: Domain-ID {id}

Objekte: DomainVO

Anfrage¶

Um das automatische Update zu aktivieren bzw. zu deaktivieren und den Umgebungstyp einer Domain zu ändern, fügen Sie die Domain-ID {id} dem Pfad der Anfrage hinzu.

Für eine detaillierte Spezifikation, welche Informationen zum Aktivieren bzw. Deaktivieren des automatischen Updates und zum Ändern des Umgebungstyps erforderlich sind, muss im Body das Objekt DomainVO mit den folgenden Attributen definiert werden:

Attribut	Beschreibung	Werte
`autoUpdate`	Die Verfügbarkeit des automatischen Updates für die Domain.	`true` `false`
`environment`	Der Umgebungstyp der Domain. Der Umgebungstyp `test` kann verwendet werden, um eine Konfiguration einzurichten und sie gemeinsam mit dem Myra-Support zu prüfen, bevor sie ausgerollt wird.	`live` `test`
`id`	Die ID des Eintrags.	`integer`
`modified`	Das Datum der letzten Änderung im ISO-8601-Format.	`string($date-time)`

Alle anderen Attribute und ihre Änderungen werden ignoriert.

Beispiel¶

Beispiel-Request-Body:

{
  "objectType": "string",
  "name": "string",
  "organizationId": 0,
  "autoDns": true,
  "autoUpdate": true,
  "maintenance": true,
  "paused": true,
  "pausedUntil": "string",
  "template": "string",
  "dnsRecords": [
    {
      "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"
    }
  ],
  "reversed": true,
  "environment": "string",
  "locked": true,
  "tagId": 0,
  "permissions": "string",
  "label": "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.