Condividi tramite


Manage account profiles - Get all available roles

Ottiene tutti i ruoli disponibili.

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

Parametri dell'URI

Nome In Necessario Tipo Descrizione
version
path True

string

Versione api.

Intestazione della richiesta

Nome Necessario Tipo Descrizione
Authorization True

string

Token di connessione dell'autorizzazione

Accept True

string

Tipo di contenuto accettabile; tipo ampiamente accepeted application/json

ms-correlationid

string

Usato per tenere traccia delle richieste internamente. Se non viene specificato un ms-correlationid, il server genererà un nuovo elemento per ogni richiesta

ms-requestid

string

Usato per l'idempotenza delle richieste. Se non viene specificato un ms-requestid, il server genererà un nuovo per ogni richiesta

Risposte

Nome Tipo Descrizione
200 OK

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

La richiesta ha avuto esito positivo. Il corpo della risposta contiene l'elenco dei ruoli supportati.

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

400 Bad Request

Non è presente un input mancante o non valido. Il corpo della risposta fornirà i dettagli dell'errore.

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

401 Unauthorized

La richiesta non è stata autenticata. Il client deve prima eseguire l'autenticazione con il servizio API partner.

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

403 Forbidden

La richiesta è stata autenticata ma è stata rifiutata perché il chiamante non dispone dei diritti per richiamarlo.

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

404 Not Found

La risorsa non viene trovata o non è disponibile con i parametri di input specificati.

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

500 Internal Server Error

Il servizio API partner o una delle relative dipendenze non è riuscito a soddisfare la richiesta. I chiamanti possono riprovare.

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

Definizioni

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

Contiene una raccolta di risorse con proprietà JSON per rappresentare l'output

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

Il collegamento rappresenta un URI e il metodo HTTP che indica l'azione desiderata per l'accesso alla risorsa.

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

Fa riferimento agli attributi comuni dell'oggetto

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

Collegamenti di spostamento per la risorsa

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

Rappresenta un oggetto ruolo utilizzato come contratto per le operazioni del ruolo.

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

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

Contiene una raccolta di risorse con proprietà JSON per rappresentare l'output

Nome Tipo Descrizione
attributes

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

Ottiene gli attributi.

items

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

Ottiene gli elementi della raccolta.

links

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

Ottiene o imposta i collegamenti.

totalCount

integer

Ottiene il conteggio totale.

Il collegamento rappresenta un URI e il metodo HTTP che indica l'azione desiderata per l'accesso alla risorsa.

Nome Tipo Descrizione
headers

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

Ottiene le intestazioni di collegamento.

method

string

Metodo .

uri

string

The URI.

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

Fa riferimento agli attributi comuni dell'oggetto

Nome Tipo Descrizione
etag

string

Ottiene o imposta l'etag. Versione dell'oggetto nei provider.

objectType

string

Tipo di oggetto.

Collegamenti di spostamento per la risorsa

Nome Tipo Descrizione
next

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

Pagina successiva di elementi.

previous

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

Pagina precedente di elementi.

self

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

URI autonomo.

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

Rappresenta un oggetto ruolo utilizzato come contratto per le operazioni del ruolo.

Nome Tipo Descrizione
attributes

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

Ottiene gli attributi.

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

Ottiene o imposta la categoria del ruolo.

id

string

Ottiene o imposta l'ID del ruolo.

links

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

Ottiene o imposta i collegamenti.

name

string

Ottiene o imposta il nome del ruolo.

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

Nome Tipo Descrizione
key

string

value

string