Freigeben über


Manage account profiles - Get all available roles

Ruft alle verfügbaren Rollen ab.

GET https://api.partnercenter.microsoft.com/v{version}/roles

URI-Parameter

Name In Erforderlich Typ Beschreibung
version
path True

string

API-Version.

Anforderungsheader

Name Erforderlich Typ Beschreibung
Authorization True

string

Autorisierungs-Bearertoken

Accept True

string

Zulässiger Inhaltstyp; anwendung/json des weit verbreiteten Typs

ms-correlationid

string

Wird intern zum Nachverfolgen von Anforderungen verwendet. Wenn keine ms-correlationid angegeben wird, generiert der Server für jede Anforderung eine neue.

ms-requestid

string

Wird für die Idempotenz von Anforderungen verwendet. Wenn keine ms-requestid angegeben wird, generiert der Server für jede Anforderung eine neue anforderung.

Antworten

Name Typ Beschreibung
200 OK

Microsoft.Partner.Sdk.Contracts.V1.Collections.ResourceCollection[Microsoft.Partner.Sdk.Contracts.V1.Contracts.RoleManagement.Role]

Die Anforderung war erfolgreich. Der Antworttext enthält die Liste der unterstützten Rollen.

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

400 Bad Request

Es fehlte eine oder eine ungültige Eingabe. Der Antworttext enthält die Fehlerdetails.

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

401 Unauthorized

Die Anforderung wurde nicht authentifiziert. Der Client muss sich zuerst beim Partner-API-Dienst authentifizieren.

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

403 Forbidden

Die Anforderung wurde authentifiziert, wurde aber abgelehnt, da der Aufrufer nicht über die Rechte zum Aufrufen verfügt.

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

404 Not Found

Die Ressource wurde mit den angegebenen Eingabeparametern nicht gefunden oder nicht verfügbar.

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

500 Internal Server Error

Der Partner-API-Dienst oder eine seiner Abhängigkeiten konnte die Anforderung nicht erfüllen. Anrufer versuchen dies möglicherweise erneut.

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

Definitionen

Name Beschreibung
Microsoft.Partner.Sdk.Contracts.V1.Collections.ResourceCollection[Microsoft.Partner.Sdk.Contracts.V1.Contracts.RoleManagement.Role]

Enthält eine Auflistung von Ressourcen mit JSON-Eigenschaften zur Darstellung der Ausgabe

Microsoft.Partner.Sdk.Contracts.V1.Common.Link

Link stellt einen URI und die HTTP-Methode dar, die die gewünschte Aktion für den Zugriff auf die Ressource angibt.

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

Bezieht sich auf die allgemeinen Objektattribute

Microsoft.Partner.Sdk.Contracts.V1.Common.ResourceLinks

Navigationslinks für die Ressource

Microsoft.Partner.Sdk.Contracts.V1.Contracts.RoleManagement.Role

Stellt ein Rollenobjekt dar, das als Vertrag für Rollenvorgänge verwendet wird.

System.Collections.Generic.KeyValuePair[System.String,System.String]

Microsoft.Partner.Sdk.Contracts.V1.Collections.ResourceCollection[Microsoft.Partner.Sdk.Contracts.V1.Contracts.RoleManagement.Role]

Enthält eine Auflistung von Ressourcen mit JSON-Eigenschaften zur Darstellung der Ausgabe

Name Typ Beschreibung
attributes

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

Ruft die Attribute ab.

items

Microsoft.Partner.Sdk.Contracts.V1.Contracts.RoleManagement.Role[]

Ruft die Auflistungselemente ab.

links

Microsoft.Partner.Sdk.Contracts.V1.Common.ResourceLinks

Ruft die Verknüpfungen ab oder legt sie fest.

totalCount

integer

Ruft die Gesamtanzahl ab.

Link stellt einen URI und die HTTP-Methode dar, die die gewünschte Aktion für den Zugriff auf die Ressource angibt.

Name Typ Beschreibung
headers

System.Collections.Generic.KeyValuePair[System.String,System.String][]

Ruft die Verknüpfungsheader ab.

method

string

Die Methode.

uri

string

Der URI.

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

Bezieht sich 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.

Navigationslinks für die Ressource

Name Typ Beschreibung
next

Microsoft.Partner.Sdk.Contracts.V1.Common.Link

Die nächste Seite mit Elementen.

previous

Microsoft.Partner.Sdk.Contracts.V1.Common.Link

Die vorherige Seite mit Elementen.

self

Microsoft.Partner.Sdk.Contracts.V1.Common.Link

Der Selbst-URI.

Microsoft.Partner.Sdk.Contracts.V1.Contracts.RoleManagement.Role

Stellt ein Rollenobjekt dar, das als Vertrag für Rollenvorgänge verwendet wird.

Name Typ Beschreibung
attributes

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

Ruft die Attribute ab.

category enum:
  • account_admin
  • developer
  • incentive
  • marketing
  • mpn
  • partner_agent
  • publisher
  • referrals
  • tenant

Ruft die Kategorie der Rolle ab oder legt sie fest.

id

string

Ruft die ID der Rolle ab oder legt sie fest.

links

Microsoft.Partner.Sdk.Contracts.V1.Common.ResourceLinks

Ruft die Verknüpfungen ab oder legt sie fest.

name

string

Dient zum Abrufen oder Festlegen des Namens der Rolle.

System.Collections.Generic.KeyValuePair[System.String,System.String]

Name Typ Beschreibung
key

string

value

string