Ein Traffic-Report-Abonnement ändern¶

Note

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

Note

Im Body muss mindestens eines der Attribute domains oder vhosts definiert sein.

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

Beschreibung¶

Mit der Change-Subscription-Anfrage ändern Sie die Einstellungen eines Traffic-Report-Abonnements.

Voraussetzungen¶

Werte der Anfrage: Subscription-ID {id}

Objekte: UpdateSubscriptionVO

Anfrage¶

Um ein Traffic-Report-Abonnement zu ändern, fügen Sie die Subscription-ID {id} dem Pfad der Anfrage hinzu.

Für eine detaillierte Spezifikation, welche Informationen zum Ändern eines Traffic-Report-Abonnements erforderlich sind, muss im Body das Objekt UpdateSubscriptionVO mit den folgenden Attributen definiert werden:

Attribut	Beschreibung	Werte
`id`	Die ID des Abonnements.	`integer`
`modified`	Das Datum der letzten Änderung des Abonnements im ISO-8601-Format.	`string($date-time)`

Die folgenden Attribute sind optional. Geben Sie nur die Attribute an, die geändert werden sollen. Lassen Sie alle Attribute weg, die unverändert bleiben sollen:

Attribut	Beschreibung	Werte
`name`	Der Name des Abonnements.	`string`
`domains`	Ein Array von Domainnamen, die in den Traffic-Report aufgenommen werden sollen. Das System erweitert jede Domain bei der Erstellung um ihre Subdomains.HinweisUm eine Domain mit allen ihren Virtual Hosts aufzunehmen, muss das Attribut `vhosts` leer sein.	`array[string]`
`vhosts`	Ein Array von Subdomainnamen, die in den Traffic-Report aufgenommen werden sollen.HinweisUm nur bestimmte Virtual Hosts aufzunehmen, kann das Attribut `domains` leer sein.	`array[string]`
`language`	Die Sprache der von diesem Abonnement erzeugten Reports.	`string`
`active`	Legt fest, ob das Abonnement aktiv ist.	`true` `false`
`comments`	Ein Kommentar für das Abonnement.	`string`

Das System gibt als Antwort das aktualisierte Abonnement-Objekt zurück.

Beispiel¶

Beispiel-Request-Body:

{
  "name": "string",
  "domains": [
    "string"
  ],
  "vhosts": [
    "string"
  ],
  "language": "string",
  "active": true,
  "comments": "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.