创建用户

 

适用于:Windows Azure Pack

创建用户。

请求

将 <ServiceMgmt> 替换为服务管理 API 终结点地址。 . 将端口>替换为<租户 API 的 30005 或管理员 API 的 30004。

方法

请求 URI

HTTP 版本

POST

<https:// ServiceMgmt>:<Port>/users

HTTP/1.1

URI 参数

无。

请求标头

下表介绍必需的和可选的请求标头。

请求标头

说明

授权:持有者

必需。 授权持有者令牌。

x-ms-principal-id

必需。 主体标识符。

x-ms-client-request-id

可选。 客户端请求标识符。

x-ms-client-session-id

可选。 客户端会话标识符。

x-ms-principal-liveid

可选。 主体 Live 标识符。

请求正文

下表说明了请求正文的元素。

元素名称

说明

用户

用于创建用户的信息。 有关详细信息,请参阅 用户 (Common 对象)

响应

响应包括 HTTP 状态代码、一组响应标头和响应正文。

状态代码

此操作成功后返回状态代码 201(已创建)。

有关状态代码的信息,请参阅“状态”和“错误代码” (Windows Azure Pack 服务管理)

响应标头

此操作的响应包括标准 HTTP 标头。 所有标准标头都符合 HTTP/1.1 协议规范

响应正文

下表介绍了响应正文中的主要元素:

元素名称

说明

用户

创建的用户。 有关详细信息,请参阅 用户 (Common 对象)

示例

下面的代码示例演示 了创建用户 请求。

POST https://<Computer>:30004/users HTTP/1.1
Authorization: Bearer <token>
x-ms-client-request-id: 1557497f-2f4c-45b1-a42d-416fff7641a2-2013-06-27 21:15:30Z
x-ms-client-session-id: 9ff600b4-0c8b-4110-9eab-4228ce92aa4d
x-ms-principal-id: <COMPUTER>\Administrator
Accept-Language: en-US
x-ms-principal-liveid: <COMPUTER>\Administrator
Content-Type: application/json; charset=utf-8
Host: <Computer>:30004
Content-Length: 160
Expect: 100-continue

{
  "Name": "aaa@bbb.com",
  "Email": "aaa@bbb.com",
  "State": 1,
  "CreatedTime": "0001-01-01T00:00:00",
  "SubscriptionCount": 0,
  "ActivationSyncState": 0,
  "LastErrorMessage": null
}

下面的代码示例演示 了创建用户 响应。

{
  "Name": "aaa@bbb.com",
  "Email": "aaa@bbb.com",
  "State": 1,
  "CreatedTime": "2013-06-27T21:15:30.787",
  "SubscriptionCount": 0,
  "ActivationSyncState": 0,
  "LastErrorMessage": null
}

另请参阅

常见用户界面