Access Control - List Users

Riferimento

Service:: Azure Sphere Public API

API Version:: v2

Ottenere tutte le entità (utente) che hanno ruoli assegnati all'interno dell'ambito di un tenant.

GET https://prod.core.sphere.azure.net/v2/tenants/{tenantId}/users

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
tenantId	path	True	string uuid	ID tenant in cui ottenere ruoli.

Risposte

Nome	Tipo	Descrizione
200 OK	AccessControlPrincipalsResponse	Operazione completata.

Esempio

List users

Sample Request

GET https://prod.core.sphere.azure.net/v2/tenants/768c2cd6-1bf0-4521-9f53-084a331d81cb/users

Sample Response

Status code:: 200

{
  "TenantId": "768c2cd6-1bf0-4521-9f53-084a331d81cb",
  "Principals": [
    {
      "PrincipalId": "474dfa25-a681-4bda-9932-7d42354c944d",
      "DisplayName": "Avery Howard",
      "Mail": "avery@contoso.com",
      "Roles": [
        "Administrator",
        "Contributor"
      ]
    },
    {
      "PrincipalId": "599c0db8-e54a-4ccf-9c39-67cc22038597",
      "DisplayName": "Parker Jones",
      "Mail": "parker@contoso.com",
      "Roles": [
        "Contributor"
      ]
    }
  ]
}

Definizioni

Nome	Descrizione
AccessControlPrincipal
AccessControlPrincipalsResponse

AccessControlPrincipal

Nome	Tipo	Descrizione
DisplayName	string	Ottiene o imposta il nome visualizzato associato dell'utente.
Mail	string	Ottiene o imposta il messaggio di posta elettronica associato dell'utente.
PrincipalId	string	Ottiene o imposta l'ID principale dell'entità utente/servizio.
Roles	string[]	Ottiene o imposta i ruoli assegnati ad altri PrincipalId

AccessControlPrincipalsResponse

Nome	Tipo	Descrizione
Principals	AccessControlPrincipal[]	Ottiene o imposta la raccolta di entità con ruoli assegnati in questo tenant.
TenantId	string	Ottiene o imposta l'ID del tenant di Azure Sphere.