Manage account profiles - Add new user member to role
Fügt der angegebenen Rolle ein neues Benutzermitglied hinzu.
POST https://api.partnercenter.microsoft.com/v{version}/roles/{role_id}/usermembers
URI-Parameter
Name | In | Erforderlich | Typ | Beschreibung |
---|---|---|---|---|
role_id
|
path | True |
string |
Der Rollenbezeichner. |
version
|
path | True |
string |
API-Version. |
Anforderungsheader
Media Types: "application/json", "application/xml", "text/xml", "application/x-www-form-urlencoded", "text/json"
Name | Erforderlich | Typ | Beschreibung |
---|---|---|---|
Authorization | True |
string |
Autorisierungs-Bearertoken |
Accept | True |
string |
Akzeptabler Inhaltstyp; Weit verbreiteter Typ application/json |
ms-correlationid |
string |
Wird für die interne Nachverfolgung von Anforderungen verwendet. Wenn keine ms-correlationid angegeben wird, generiert der Server für jede Anforderung eine neue. |
|
ms-requestid |
string |
Wird für Idempotenz von Anforderungen verwendet. Wenn keine ms-requestid angegeben wird, generiert der Server für jede Anforderung eine neue. |
Anforderungstext
Media Types: "application/json", "application/xml", "text/xml", "application/x-www-form-urlencoded", "text/json"
Name | Typ | Beschreibung |
---|---|---|
accountId |
string |
Ruft die Konto-ID ab, in der die Rollenzuweisung gebunden ist, oder legt diese fest. |
displayName |
string |
Ruft den Anzeigenamen für den Benutzer ab oder legt diese fest. |
id |
string |
Der Bezeichner des Elements. |
roleId |
string |
Der Bezeichner der Rolle des Benutzers. |
userPrincipalName |
string |
Ruft den Namen des Benutzerprinzipals ab oder legt diese fest. |
Antworten
Name | Typ | Beschreibung |
---|---|---|
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 |
Es fehlte eine oder eine ungültige Eingabe. Der Antworttext enthält die Fehlerdetails. Media Types: "application/json", "application/xml", "text/xml", "text/json" |
|
401 Unauthorized |
Die Anforderung wurde nicht authentifiziert. Der Client muss sich zuerst beim Partner-API-Dienst authentifizieren. Media Types: "application/json", "application/xml", "text/xml", "text/json" |
|
403 Forbidden |
Die Anforderung wurde authentifiziert, aber abgelehnt, da der Aufrufer nicht über die Rechte zum Aufrufen verfügt. Media Types: "application/json", "application/xml", "text/xml", "text/json" |
|
404 Not Found |
Die Ressource ist mit den angegebenen Eingabeparametern nicht gefunden oder nicht verfügbar. Media Types: "application/json", "application/xml", "text/xml", "text/json" |
|
500 Internal Server Error |
Der Partner-API-Dienst oder eine seiner Abhängigkeiten konnte die Anforderung nicht erfüllen. Anrufer können dies wiederholen. Media Types: "application/json", "application/xml", "text/xml", "text/json" |
Definitionen
Name | Beschreibung |
---|---|
Microsoft. |
Verweist auf die allgemeinen Objektattribute. |
Microsoft. |
Beschreibt die Memberinformationen eines Benutzers. |
Microsoft.Partner.Sdk.Contracts.V1.Common.ResourceAttributes
Verweist auf die allgemeinen Objektattribute.
Name | Typ | Beschreibung |
---|---|---|
etag |
string |
Ruft das etag ab oder legt es fest. Die Objektversion in Anbietern. |
objectType |
string |
Der Objekttyp. |
Microsoft.Partner.Sdk.Contracts.V1.Contracts.RoleManagement.UserMember
Beschreibt die Memberinformationen eines Benutzers.
Name | Typ | Beschreibung |
---|---|---|
accountId |
string |
Ruft die Konto-ID ab, in der die Rollenzuweisung gebunden ist, oder legt diese fest. |
attributes |
Microsoft. |
Ruft die Attribute ab. |
displayName |
string |
Ruft den Anzeigenamen für den Benutzer ab oder legt diese fest. |
id |
string |
Der Bezeichner des Elements. |
roleId |
string |
Der Bezeichner der Rolle des Benutzers. |
userPrincipalName |
string |
Ruft den Namen des Benutzerprinzipals ab oder legt diese fest. |