Access Control - List Users

Service:

Azure Sphere Public API

API Version:

v2

Haal alle principals (gebruiker) op waaraan rollen zijn toegewezen binnen het bereik van een tenant.

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

URI-parameters

Name	In	Vereist	Type	Description
tenantId	path	True	string uuid	De tenant-id waarin rollen moeten worden opgehaald.

Antwoorden

Name	Type	Description
200 OK	AccessControlPrincipalsResponse	Voltooid.

Voorbeelden

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"
      ]
    }
  ]
}

Definities

Name	Description
AccessControlPrincipal
AccessControlPrincipalsResponse

AccessControlPrincipal

Name	Type	Description
DisplayName	string	Hiermee wordt de bijbehorende weergavenaam van de gebruiker opgehaald of ingesteld.
Mail	string	Hiermee wordt het bijbehorende e-mailadres van de gebruiker opgehaald of ingesteld.
PrincipalId	string	Hiermee wordt de principal-id van de gebruiker/service-principal opgehaald of ingesteld.
Roles	string[]	Hiermee worden de rollen opgehaald of ingesteld waaraan andere PrincipalId is toegewezen

AccessControlPrincipalsResponse

Name	Type	Description
Principals	AccessControlPrincipal[]	Hiermee wordt de verzameling principals opgehaald of ingesteld met rollen die zijn toegewezen in deze tenant.
TenantId	string	Hiermee wordt de id van de Azure Sphere-tenant opgehaald of ingesteld.