Condividi tramite


Manage account profiles - Add new user member to role

Aggiunge un nuovo membro utente al ruolo specificato.

POST https://api.partnercenter.microsoft.com/v{version}/roles/{role_id}/usermembers

Parametri dell'URI

Nome In Necessario Tipo Descrizione
role_id
path True

string

Identificatore del ruolo.

version
path True

string

Versione dell'API.

Intestazione della richiesta

Media Types: "application/json", "application/xml", "text/xml", "application/x-www-form-urlencoded", "text/json"

Nome Necessario Tipo Descrizione
Authorization True

string

Token di connessione dell'autorizzazione

Accept True

string

Tipo di contenuto accettabile; applicazione/json di tipo ampiamente accepeted

ms-correlationid

string

Usato per il rilevamento delle richieste internamente. Se non viene specificato un ms-correlationid, il server genererà un nuovo oggetto per ogni richiesta

ms-requestid

string

Usato per la idempotenza delle richieste. Se non viene fornito un ms-requestid, il server genererà un nuovo oggetto per ogni richiesta

Corpo della richiesta

Media Types: "application/json", "application/xml", "text/xml", "application/x-www-form-urlencoded", "text/json"

Nome Tipo Descrizione
accountId

string

Ottiene o imposta l'ID dell'account in cui l'assegnazione di ruolo è associata.

displayName

string

Ottiene o imposta il nome visualizzato per l'utente.

id

string

Identificatore del membro.

roleId

string

Identificatore del ruolo dell'utente.

userPrincipalName

string

Ottiene o imposta il nome dell'entità utente.

Risposte

Nome Tipo Descrizione
200 OK

object

OK

Media Types: "application/json", "application/xml", "text/xml", "text/json"

201 Created

Microsoft.Partner.Sdk.Contracts.V1.Contracts.RoleManagement.UserMember

OK

Media Types: "application/json", "application/xml", "text/xml", "text/json"

400 Bad Request

Non è stato presente un input mancante o non valido. Il corpo della risposta fornirà i dettagli dell'errore.

Media Types: "application/json", "application/xml", "text/xml", "text/json"

401 Unauthorized

La richiesta non è stata autenticata. Per prima cosa, il client deve eseguire l'autenticazione con il servizio API partner.

Media Types: "application/json", "application/xml", "text/xml", "text/json"

403 Forbidden

La richiesta è stata autenticata, ma è stata rifiutata perché il chiamante non ha i diritti per richiamarlo.

Media Types: "application/json", "application/xml", "text/xml", "text/json"

404 Not Found

La risorsa non viene trovata o non disponibile con i parametri di input specificati.

Media Types: "application/json", "application/xml", "text/xml", "text/json"

500 Internal Server Error

Il servizio API partner o una delle relative dipendenze non è riuscita a soddisfare la richiesta. I chiamanti possono riprovare.

Media Types: "application/json", "application/xml", "text/xml", "text/json"

Definizioni

Nome Descrizione
Microsoft.Partner.Sdk.Contracts.V1.Common.ResourceAttributes

Si riferisce agli attributi comuni degli oggetti

Microsoft.Partner.Sdk.Contracts.V1.Contracts.RoleManagement.UserMember

Descrive le informazioni del membro di un utente.

Microsoft.Partner.Sdk.Contracts.V1.Common.ResourceAttributes

Si riferisce agli attributi comuni degli oggetti

Nome Tipo Descrizione
etag

string

Ottiene o imposta l'etag. Versione dell'oggetto nei provider.

objectType

string

Tipo di oggetto.

Microsoft.Partner.Sdk.Contracts.V1.Contracts.RoleManagement.UserMember

Descrive le informazioni del membro di un utente.

Nome Tipo Descrizione
accountId

string

Ottiene o imposta l'ID dell'account in cui l'assegnazione di ruolo è associata.

attributes

Microsoft.Partner.Sdk.Contracts.V1.Common.ResourceAttributes

Ottiene gli attributi.

displayName

string

Ottiene o imposta il nome visualizzato per l'utente.

id

string

Identificatore del membro.

roleId

string

Identificatore del ruolo dell'utente.

userPrincipalName

string

Ottiene o imposta il nome dell'entità utente.