Delen via


Manage account profiles - Get all available roles

Hiermee haalt u alle beschikbare rollen op.

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

URI-parameters

Name In Vereist Type Description
version
path True

string

Api-versie.

Aanvraagkoptekst

Name Vereist Type Description
Authorization True

string

Bearer-token voor autorisatie

Accept True

string

Acceptabel inhoudstype; breed accepeted type application/json

ms-correlationid

string

Wordt intern gebruikt voor het bijhouden van aanvragen. Als er geen ms-correlationid is opgegeven, genereert de server een nieuwe voor elke aanvraag

ms-requestid

string

Wordt gebruikt voor idempotentie van aanvragen. Als er geen ms-requestid is opgegeven, genereert de server een nieuwe voor elke aanvraag

Antwoorden

Name Type Description
200 OK

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

De aanvraag is geslaagd. De hoofdtekst van het antwoord bevat de lijst met ondersteunde rollen.

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

400 Bad Request

Er is een ontbrekende of ongeldige invoer. De hoofdtekst van het antwoord bevat de foutdetails.

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

401 Unauthorized

De aanvraag is niet geverifieerd. De client moet eerst worden geverifieerd met de partner-API-service.

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

403 Forbidden

De aanvraag is geverifieerd, maar is geweigerd omdat de beller niet over de rechten beschikt om deze aan te roepen.

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

404 Not Found

De resource is niet gevonden of niet beschikbaar met de opgegeven invoerparameters.

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

500 Internal Server Error

De partner-API-service of een van de bijbehorende afhankelijkheden kan niet voldoen aan de aanvraag. Bellers kunnen dit opnieuw proberen.

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

Definities

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

Bevat een verzameling resources met JSON-eigenschappen die de uitvoer vertegenwoordigen

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

Koppeling vertegenwoordigt een URI en de HTTP-methode die de gewenste actie aangeeft voor toegang tot de resource.

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

Verwijst naar de algemene objectkenmerken

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

Navigatiekoppelingen voor de resource

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

Vertegenwoordigt een rolobject dat wordt gebruikt als contract voor rolbewerkingen.

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

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

Bevat een verzameling resources met JSON-eigenschappen die de uitvoer vertegenwoordigen

Name Type Description
attributes

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

Haalt de kenmerken op.

items

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

Hiermee haalt u de verzamelingsitems op.

links

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

Hiermee haalt u de koppelingen op of stelt u deze in.

totalCount

integer

Hiermee haalt u het totale aantal op.

Koppeling vertegenwoordigt een URI en de HTTP-methode die de gewenste actie aangeeft voor toegang tot de resource.

Name Type Description
headers

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

Haalt de koppelingsheaders op.

method

string

De methode.

uri

string

De URI.

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

Verwijst naar de algemene objectkenmerken

Name Type Description
etag

string

Hiermee haalt u de etag op of stelt u deze in. De objectversie in providers.

objectType

string

Het type object.

Navigatiekoppelingen voor de resource

Name Type Description
next

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

De volgende pagina met items.

previous

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

De vorige pagina met items.

self

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

De zelf-URI.

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

Vertegenwoordigt een rolobject dat wordt gebruikt als contract voor rolbewerkingen.

Name Type Description
attributes

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

Haalt de kenmerken op.

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

Hiermee haalt u de categorie van de rol op of stelt u deze in.

id

string

Hiermee haalt u de id van de rol op of stelt u deze in.

links

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

Hiermee haalt u de koppelingen op of stelt u deze in.

name

string

Hiermee haalt u de naam van de rol op of stelt u deze in.

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

Name Type Description
key

string

value

string