Sdílet prostřednictvím


Manage account profiles - Get all available roles

Získá všechny dostupné role.

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

Parametry identifikátoru URI

Name V Vyžadováno Typ Description
version
path True

string

Verze rozhraní API.

Hlavička požadavku

Name Vyžadováno Typ Description
Authorization True

string

Nosný token autorizace

Accept True

string

Přijatelný typ obsahu; široce přístupný typ application/json

ms-correlationid

string

Používá se pro interní sledování požadavků. Pokud ms-correlationid není zadaný, server pro každý požadavek vygeneruje nový.

ms-requestid

string

Používá se pro idempotenci požadavků. Pokud ms-requestid není zadaný, server pro každý požadavek vygeneruje nový.

Odpovědi

Name Typ Description
200 OK

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

Žádost byla úspěšná. Text odpovědi obsahuje seznam podporovaných rolí.

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

400 Bad Request

Chybí nebo je neplatný vstup. Text odpovědi poskytne podrobnosti o chybě.

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

401 Unauthorized

Požadavek nebyl ověřen. Klient se musí nejprve ověřit ve službě partnerského rozhraní API.

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

403 Forbidden

Požadavek byl ověřen, ale byl odmítnut, protože volající nemá oprávnění k jejímu vyvolání.

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

404 Not Found

Prostředek nebyl nalezen nebo není k dispozici s danými vstupními parametry.

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

500 Internal Server Error

Službě partnerského rozhraní API nebo některé z jejích závislostí se nepodařilo požadavek splnit. Volající to můžou zkusit znovu.

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

Definice

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

Obsahuje kolekci prostředků s vlastnostmi JSON, které představují výstup.

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

Odkaz představuje identifikátor URI a metodu HTTP, která označuje požadovanou akci pro přístup k prostředku.

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

Odkazuje na společné atributy objektů.

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

Navigační odkazy pro prostředek

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

Představuje objekt role, který se používá jako kontrakt pro operace rolí.

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

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

Obsahuje kolekci prostředků s vlastnostmi JSON, které představují výstup.

Name Typ Description
attributes

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

Získá atributy.

items

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

Získá položky kolekce.

links

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

Získá nebo nastaví odkazy.

totalCount

integer

Získá celkový počet.

Odkaz představuje identifikátor URI a metodu HTTP, která označuje požadovanou akci pro přístup k prostředku.

Name Typ Description
headers

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

Získá záhlaví odkazu.

method

string

Metoda.

uri

string

Identifikátor URI.

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

Odkazuje na společné atributy objektů.

Name Typ Description
etag

string

Získá nebo nastaví etag. Verze objektu v zprostředkovatelích.

objectType

string

Typ objektu.

Navigační odkazy pro prostředek

Name Typ Description
next

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

Další stránka položek

previous

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

Předchozí stránka položek.

self

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

Identifikátor URI sebe sama.

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

Představuje objekt role, který se používá jako kontrakt pro operace rolí.

Name Typ Description
attributes

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

Získá atributy.

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

Získá nebo nastaví kategorii role.

id

string

Získá nebo nastaví ID role.

links

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

Získá nebo nastaví odkazy.

name

string

Získá nebo nastaví název role.

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

Name Typ Description
key

string

value

string