你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

Users - Create

服务:

IoT Central

API 版本:

2022-07-31

在应用程序中创建用户

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

URI 参数

名称	在	必需	类型	说明
baseDomain	path	True	string	所有 Azure IoT Central 服务请求的基域。
subdomain	path	True	string	应用程序子域。
userId	path	True	string	用户的唯一 ID。 正则表达式模式: ^[a-zA-Z0-9-_]*$
api-version	query	True	string	正在调用的 API 的版本。

请求正文

请求正文可以为下列任一内容：

名称	说明
ADGroupUser	Active Directory 组用户定义。
EmailUser	电子邮件用户定义。
ServicePrincipalUser	服务主体用户定义。

ADGroupUser

Active Directory 组用户定义。

名称	必需	类型	说明
objectId	True	string	AD 组的 AAD 对象 ID。
roles	True	RoleAssignment[]	指定访问应用程序的权限的角色分配列表。
tenantId	True	string	AD 组的 AAD 租户 ID。
type	True	string: adGroup	用户的类型。

EmailUser

电子邮件用户定义。

名称	必需	类型	说明
email	True	string	用户的电子邮件地址。
roles	True	RoleAssignment[]	指定访问应用程序的权限的角色分配列表。
type	True	string: email	用户的类型。

ServicePrincipalUser

服务主体用户定义。

名称	必需	类型	说明
objectId	True	string	服务主体的 AAD 对象 ID。
roles	True	RoleAssignment[]	指定访问应用程序的权限的角色分配列表。
tenantId	True	string	服务主体的 AAD 租户 ID。
type	True	string: servicePrincipal	用户的类型。

响应

名称	类型	说明
200 OK	User: ADGroupUser EmailUser ServicePrincipalUser	成功
Other Status Codes	Error	从 IoT Central 服务收到的错误响应。 标头 x-ms-error-code: string

安全性

azure_auth

Azure Active Directory OAuth2 流

类型: oauth2
流向: implicit
授权 URL: https://login.microsoftonline.com/common/oauth2/authorize

作用域

名称	说明
user_impersonation	模拟用户帐户

示例

Add or update a service principal user

Add or update an email user

Add or update a service principal user

示例请求

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

示例响应

状态代码:

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

示例请求

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

示例响应

状态代码:

200

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

定义

名称	说明
ADGroupUser	Active Directory 组用户定义。
EmailUser	电子邮件用户定义。
Error	响应错误定义。
ErrorDetails	错误的详细信息。
RoleAssignment	角色分配定义。
ServicePrincipalUser	服务主体用户定义。

ADGroupUser

Active Directory 组用户定义。

名称	类型	说明
id	string	用户的唯一 ID。
objectId	string	AD 组的 AAD 对象 ID。
roles	RoleAssignment[]	指定访问应用程序的权限的角色分配列表。
tenantId	string	AD 组的 AAD 租户 ID。
type	string: adGroup	用户的类型。

EmailUser

电子邮件用户定义。

名称	类型	说明
email	string	用户的电子邮件地址。
id	string	用户的唯一 ID。
roles	RoleAssignment[]	指定访问应用程序的权限的角色分配列表。
type	string: email	用户的类型。

Error

响应错误定义。

名称	类型	说明
error	ErrorDetails	当前请求的错误详细信息。

ErrorDetails

错误的详细信息。

名称	类型	说明
code	string	错误代码。
message	string	错误消息详细信息。
requestId	string	当前请求的相关 ID。
time	string	错误请求失败的时间。

RoleAssignment

角色分配定义。

名称	类型	说明
organization	string	此角色分配的组织 ID。
role	string	此角色分配的角色 ID。

ServicePrincipalUser

服务主体用户定义。

名称	类型	说明
id	string	用户的唯一 ID。
objectId	string	服务主体的 AAD 对象 ID。
roles	RoleAssignment[]	指定访问应用程序的权限的角色分配列表。
tenantId	string	服务主体的 AAD 租户 ID。
type	string: servicePrincipal	用户的类型。