Vai al contenuto principale
PUT
Imposta le organizzazioni di fatturazione degli utenti
Imposta l’organizzazione di fatturazione per un massimo di 100 utenti con un’unica richiesta. Vengono modificati solo gli utenti inviati, mentre il resto dell’azienda rimane invariato. Per aggiornare un solo utente alla volta, puoi usare anche l’endpoint delle impostazioni utente, in beta, che accetta billing_org_id.

Esito parziale

Le assegnazioni valide vengono salvate comunque, anche se altre righe della stessa richiesta non sono valide: una risposta 200 può quindi contenere errori. Controlla sempre failed: ogni voce indica l’utente, l’organizzazione richiesta e un reason. Per questi utenti l’organizzazione di fatturazione non è stata modificata; correggi le righe e inviale di nuovo. In futuro potrebbero essere aggiunti nuovi motivi: tratta quindi i valori sconosciuti come un’assegnazione non riuscita e non come un errore della richiesta. Una risposta di errore (4xx o 5xx) indica che nessun elemento della richiesta è stato salvato. Le richieste senza assegnazioni, con più di 100 assegnazioni o con lo stesso user_id ripetuto più volte vengono rifiutate con 422. Inviare di nuovo un’assegnazione sovrascrive l’organizzazione di fatturazione attuale dell’utente e aggiunge un’ulteriore voce al registro di audit: le chiamate ripetute sono quindi sicure, ma non prive di effetti.

Autorizzazioni

Richiede un utente di servizio o un token di accesso personale con entrambe le autorizzazioni ManageBilling e ViewOrganizations a livello aziendale. Anche ManageOrganizations soddisfa il requisito di ViewOrganizations, poiché lo include.

Autorizzazioni

Authorization
string
header
obbligatorio

Credenziale dell'utente del servizio (prefisso: cog_)

Corpo

application/json
assignments
UserBillingOrgAssignmentRequest · object[]
obbligatorio

Organizzazione di fatturazione da impostare per ciascun utente. Un utente può comparire una sola volta.

Required array length: 1 - 100 elements

Risposta

Risposta riuscita

assigned
UserBillingOrgAssignmentResponse · object[]
obbligatorio

Assegnazioni applicate.

failed
UserBillingOrgFailureResponse · object[]
obbligatorio

Assegnazioni saltate, con il relativo motivo. Le organizzazioni di fatturazione di questi utenti non sono cambiate.