Zum Hauptinhalt springen
PUT
Abrechnungsorganisationen der Nutzer festlegen
Legt die Abrechnungsorganisation für bis zu 100 Nutzer in einer einzigen Anfrage fest. Geändert werden nur die von Ihnen übermittelten Nutzer; alle übrigen Nutzer der Enterprise bleiben unverändert. Für einzelne Nutzer akzeptiert auch der Endpunkt für Nutzereinstellungen (Beta) den Parameter billing_org_id.

Teilweiser Erfolg

Gültige Zuweisungen werden gespeichert, auch wenn andere Zeilen derselben Anfrage ungültig sind. Eine 200-Antwort kann daher Fehlschläge enthalten. Werten Sie immer failed aus: Jeder Eintrag nennt den Nutzer, die angeforderte Organisation und einen reason. Die Abrechnungsorganisationen dieser Nutzer wurden nicht geändert. Korrigieren Sie die betroffenen Zeilen und senden Sie sie erneut. Künftig können weitere Gründe hinzukommen. Behandeln Sie unbekannte Werte daher als Fehlschlag und nicht als Fehler. Eine Fehlerantwort (4xx oder 5xx) bedeutet, dass nichts aus der Anfrage gespeichert wurde. Anfragen ohne Zuweisungen, mit mehr als 100 Zuweisungen oder mit mehrfach vorkommender user_id werden mit 422 abgelehnt. Wird eine Zuweisung erneut gesendet, überschreibt sie die aktuelle Abrechnungsorganisation des Nutzers und erzeugt einen weiteren Eintrag im Audit-Protokoll. Wiederholte Aufrufe sind daher unbedenklich, aber nicht folgenlos.

Berechtigungen

Erfordert einen Service-Benutzer oder ein persönliches Zugriffstoken mit den beiden Berechtigungen ManageBilling und ViewOrganizations auf Enterprise-Ebene. Alternativ zu ViewOrganizations genügt auch ManageOrganizations, da diese Berechtigung ViewOrganizations einschließt.

Autorisierungen

Authorization
string
header
erforderlich

Servicebenutzer-Anmeldedaten (Präfix: cog_)

Body

application/json
assignments
UserBillingOrgAssignmentRequest · object[]
erforderlich

Abrechnungsorganisation, die für jeden Nutzer festgelegt werden soll. Ein Nutzer darf nur einmal vorkommen.

Required array length: 1 - 100 elements

Antwort

Erfolgreiche Antwort

assigned
UserBillingOrgAssignmentResponse · object[]
erforderlich

Angewendete Zuweisungen.

failed
UserBillingOrgFailureResponse · object[]
erforderlich

Übersprungene Zuweisungen mit Begründung. Die Abrechnungsorganisationen dieser Nutzer wurden nicht geändert.