Users - Create

Service:

IoT Central

API Version:

2022-07-31

Créer un utilisateur dans l’application

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

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
baseDomain	path	True	string	Domaine de base pour toutes les demandes de service Azure IoT Central.
subdomain	path	True	string	Sous-domaine d’application.
userId	path	True	string	ID unique de l’utilisateur. Regex pattern: ^[a-zA-Z0-9-_]*$
api-version	query	True	string	Version de l’API appelée.

Corps de la demande

Le corps de la requête peut être l’un des suivants :

Nom	Description
ADGroupUser	Définition d’utilisateur du groupe Active Directory.
EmailUser	Définition de l’utilisateur de messagerie.
ServicePrincipalUser	Définition de l’utilisateur principal de service.

ADGroupUser

Définition d’utilisateur du groupe Active Directory.

Nom	Obligatoire	Type	Description
objectId	True	string	ID d’objet AAD du groupe AD.
roles	True	RoleAssignment[]	Liste des attributions de rôles qui spécifient les autorisations d’accès à l’application.
tenantId	True	string	ID de locataire AAD du groupe AD.
type	True	string: adGroup	Type de l’utilisateur.

EmailUser

Définition de l’utilisateur de messagerie.

Nom	Obligatoire	Type	Description
email	True	string	Adresse e-mail de l’utilisateur.
roles	True	RoleAssignment[]	Liste des attributions de rôles qui spécifient les autorisations d’accès à l’application.
type	True	string: email	Type de l’utilisateur.

ServicePrincipalUser

Définition de l’utilisateur principal de service.

Nom	Obligatoire	Type	Description
objectId	True	string	ID d’objet AAD du principal de service.
roles	True	RoleAssignment[]	Liste des attributions de rôles qui spécifient les autorisations d’accès à l’application.
tenantId	True	string	ID de locataire AAD du principal de service.
type	True	string: servicePrincipal	Type de l’utilisateur.

Réponses

Nom	Type	Description
200 OK	User: ADGroupUser EmailUser ServicePrincipalUser	Succès
Other Status Codes	Error	Réponse d’erreur reçue du service IoT Central. Headers x-ms-error-code: string

Sécurité

azure_auth

Flux OAuth2 Azure Active Directory

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

Scopes

Nom	Description
user_impersonation	Emprunter l’identité de votre compte d’utilisateur

Exemples

Add or update a service principal user

Add or update an email user

Add or update a service principal user

Sample Request

HTTP

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

{
  "type": "servicePrincipal",
  "tenantId": "027fdad7-cf0f-470a-a26a-272197813322",
  "objectId": "65e13aac-1443-4c49-9d49-57b87197cfff",
  "roles": [
    {
      "role": "c7be2c6b-797e-4551-bb24-33709f6b2e20"
    },
    {
      "role": "c495eb57-eb18-489e-9802-62c474e5645c",
      "organization": "seattle"
    }
  ]
}

Sample Response

Status code:

200

{
  "id": "123",
  "type": "servicePrincipal",
  "tenantId": "027fdad7-cf0f-470a-a26a-272197813322",
  "objectId": "65e13aac-1443-4c49-9d49-57b87197cfff",
  "roles": [
    {
      "role": "c7be2c6b-797e-4551-bb24-33709f6b2e20"
    },
    {
      "role": "c495eb57-eb18-489e-9802-62c474e5645c",
      "organization": "seattle"
    }
  ]
}

Add or update an email user

Sample Request

HTTP

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

{
  "type": "email",
  "roles": [
    {
      "role": "ca310b8d-2f4a-44e0-a36e-957c202cd8d4"
    },
    {
      "role": "c495eb57-eb18-489e-9802-62c474e5645c",
      "organization": "seattle"
    }
  ],
  "email": "bob@contoso.com"
}

Sample Response

Status code:

200

{
  "type": "email",
  "roles": [
    {
      "role": "ca310b8d-2f4a-44e0-a36e-957c202cd8d4"
    },
    {
      "role": "c495eb57-eb18-489e-9802-62c474e5645c",
      "organization": "seattle"
    }
  ],
  "email": "bob@contoso.com"
}

Définitions

Nom	Description
ADGroupUser	Définition d’utilisateur du groupe Active Directory.
EmailUser	Définition de l’utilisateur de messagerie.
Error	Définition de l’erreur de réponse.
ErrorDetails	Informations détaillées de l’erreur.
RoleAssignment	Définition d’attribution de rôle.
ServicePrincipalUser	Définition de l’utilisateur principal de service.

ADGroupUser

Définition d’utilisateur du groupe Active Directory.

Nom	Type	Description
id	string	ID unique de l’utilisateur.
objectId	string	ID d’objet AAD du groupe AD.
roles	RoleAssignment[]	Liste des attributions de rôles qui spécifient les autorisations d’accès à l’application.
tenantId	string	ID de locataire AAD du groupe AD.
type	string: adGroup	Type de l’utilisateur.

EmailUser

Définition de l’utilisateur de messagerie.

Nom	Type	Description
email	string	Adresse e-mail de l’utilisateur.
id	string	ID unique de l’utilisateur.
roles	RoleAssignment[]	Liste des attributions de rôles qui spécifient les autorisations d’accès à l’application.
type	string: email	Type de l’utilisateur.

Error

Définition de l’erreur de réponse.

Nom	Type	Description
error	ErrorDetails	Détails de l’erreur pour la demande actuelle.

ErrorDetails

Informations détaillées de l’erreur.

Nom	Type	Description
code	string	Code d’erreur.
message	string	Détails du message d’erreur.
requestId	string	ID de corrélation pour la requête actuelle.
time	string	Heure à laquelle la demande d’erreur a échoué.

RoleAssignment

Définition d’attribution de rôle.

Nom	Type	Description
organization	string	ID du organization pour cette attribution de rôle.
role	string	ID du rôle pour cette attribution de rôle.

ServicePrincipalUser

Définition de l’utilisateur principal de service.

Nom	Type	Description
id	string	ID unique de l’utilisateur.
objectId	string	ID d’objet AAD du principal de service.
roles	RoleAssignment[]	Liste des attributions de rôles qui spécifient les autorisations d’accès à l’application.
tenantId	string	ID de locataire AAD du principal de service.
type	string: servicePrincipal	Type de l’utilisateur.