创建用户
适用于: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
}