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. |
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. |
Si riferisce agli attributi comuni degli oggetti |
Microsoft. |
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. |
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. |