Users - List

Service:

IoT Central

API Version:

2022-07-31

Obter a lista de usuários em um aplicativo

GET https://{subdomain}.{baseDomain}/api/users?api-version=2022-07-31

Parâmetros de URI

Nome	Em	Obrigatório	Tipo	Description
baseDomain	path	True	string	O domínio base para todas as solicitações de serviço do Azure IoT Central.
subdomain	path	True	string	O subdomínio do aplicativo.
api-version	query	True	string	A versão da API que está sendo chamada.

Respostas

Nome	Tipo	Description
200 OK	UserCollection	Êxito
Other Status Codes	Error	Uma resposta de erro recebida do Serviço do IoT Central. Headers x-ms-error-code: string

Segurança

azure_auth

Fluxo do OAuth2 do Azure Active Directory

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Nome	Description
user_impersonation	representar sua conta de usuário

Exemplos

List users

Sample Request

HTTP

GET https://appsubdomain.azureiotcentral.com/api/users?api-version=2022-07-31

Sample Response

Status code:

200

{
  "value": [
    {
      "id": "af0d5b8f-7a69-4521-868e-19745fae353f",
      "type": "email",
      "roles": [
        {
          "role": "ca310b8d-2f4a-44e0-a36e-957c202cd8d4"
        }
      ],
      "email": "alice@contoso.com"
    },
    {
      "id": "123",
      "type": "servicePrincipal",
      "roles": [
        {
          "role": "c495eb57-eb18-489e-9802-62c474e5645c",
          "organization": "seattle"
        }
      ],
      "tenantId": "72f988bf-86f1-41af-91ab-2d7cd011db47",
      "objectId": "9071c899-bce0-4862-b208-75dabae226a9"
    }
  ]
}

Definições

Nome	Description
ADGroupUser	A definição de usuário do grupo do Active Directory.
EmailUser	A definição do usuário de email.
Error	A definição de erro de resposta.
ErrorDetails	As informações detalhadas do erro.
RoleAssignment	A definição de atribuição de função.
ServicePrincipalUser	A definição de usuário da entidade de serviço.
UserCollection	Os resultados paginado dos usuários.

ADGroupUser

A definição de usuário do grupo do Active Directory.

Nome	Tipo	Description
id	string	ID exclusiva do usuário.
objectId	string	A ID do objeto do AAD do Grupo do AD.
roles	RoleAssignment[]	Lista de atribuições de função que especificam as permissões para acessar o aplicativo.
tenantId	string	A ID de locatário do AAD do Grupo do AD.
type	string: adGroup	Tipo do usuário.

EmailUser

A definição do usuário de email.

Nome	Tipo	Description
email	string	Endereço de email do usuário.
id	string	ID exclusiva do usuário.
roles	RoleAssignment[]	Lista de atribuições de função que especificam as permissões para acessar o aplicativo.
type	string: email	Tipo do usuário.

Error

A definição de erro de resposta.

Nome	Tipo	Description
error	ErrorDetails	Detalhes do erro da solicitação atual.

ErrorDetails

As informações detalhadas do erro.

Nome	Tipo	Description
code	string	Código do erro.
message	string	Detalhes da mensagem de erro.
requestId	string	ID de correlação da solicitação atual.
time	string	A hora em que a solicitação de erro falhou.

RoleAssignment

A definição de atribuição de função.

Nome	Tipo	Description
organization	string	ID da organização para essa atribuição de função.
role	string	ID da função para essa atribuição de função.

ServicePrincipalUser

A definição de usuário da entidade de serviço.

Nome	Tipo	Description
id	string	ID exclusiva do usuário.
objectId	string	A ID do objeto do AAD da entidade de serviço.
roles	RoleAssignment[]	Lista de atribuições de função que especificam as permissões para acessar o aplicativo.
tenantId	string	A ID de locatário do AAD da entidade de serviço.
type	string: servicePrincipal	Tipo do usuário.

UserCollection

Os resultados paginado dos usuários.

Nome	Tipo	Description
nextLink	string	URL para obter a próxima página de usuários.
value	User[]: ADGroupUser[] EmailUser[] ServicePrincipalUser[]	A coleção de usuários.