Freigeben über


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.Partner.Sdk.Contracts.V1.Contracts.RoleManagement.UserMember

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.Partner.Sdk.Contracts.V1.Common.ResourceAttributes

Verweist auf die allgemeinen Objektattribute.

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

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.Partner.Sdk.Contracts.V1.Common.ResourceAttributes

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.