Passer au contenu principal
PUT
Définir les organisations de facturation des utilisateurs
Définit l’organisation de facturation d’un maximum de 100 utilisateurs en une seule requête. Seuls les utilisateurs envoyés sont modifiés ; le reste de l’Enterprise reste inchangé. Pour modifier un seul utilisateur à la fois, l’endpoint des paramètres utilisateur, en bêta, accepte également billing_org_id.

Réussite partielle

Les attributions valides sont enregistrées ensemble même lorsque d’autres lignes de la même requête sont invalides ; une réponse 200 peut donc contenir des échecs. Consultez toujours failed : chaque entrée indique l’utilisateur, l’organisation demandée et une reason. L’organisation de facturation de ces utilisateurs n’a pas été modifiée ; corrigez les lignes concernées et renvoyez-les. De nouveaux motifs pourront être ajoutés à l’avenir ; traitez donc les valeurs inconnues comme un échec plutôt que comme une erreur. Une réponse d’erreur (4xx ou 5xx) signifie qu’aucun élément de la requête n’a été enregistré. Les requêtes sans attribution, avec plus de 100 attributions ou contenant plusieurs fois le même user_id sont rejetées avec une erreur 422. Renvoyer une attribution écrase l’organisation de facturation actuelle de l’utilisateur et ajoute une nouvelle entrée au journal d’audit : les appels répétés sont donc sans risque, mais pas sans effet.

Autorisations

Nécessite un utilisateur de service ou un jeton d’accès personnel disposant à la fois des autorisations ManageBilling et ViewOrganizations au niveau Enterprise. L’autorisation ManageOrganizations suffit également à la place de ViewOrganizations, puisqu’elle l’inclut.

Autorisations

Authorization
string
header
requis

Identifiant de compte de service (préfixe : cog_)

Corps

application/json
assignments
UserBillingOrgAssignmentRequest · object[]
requis

Organisation de facturation à définir pour chaque utilisateur. Un utilisateur ne peut apparaître qu’une seule fois.

Required array length: 1 - 100 elements

Réponse

Réponse réussie

assigned
UserBillingOrgAssignmentResponse · object[]
requis

Attributions appliquées.

failed
UserBillingOrgFailureResponse · object[]
requis

Attributions ignorées, avec le motif correspondant. Les organisations de facturation de ces utilisateurs restent inchangées.