检索用户

项目
08/24/2015

适用于：Windows Azure Pack

检索用户。

请求

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

方法	请求 URI	HTTP 版本
GET	<https:// ServiceMgmt>：<Port>/users/<UserName>	HTTP/1.1

URI 参数

无。

请求标头

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

请求标头	说明
授权：持有者	必需。授权持有者令牌。
x-ms-principal-id	必需。主体标识符。
x-ms-client-request-id	可选。客户端请求标识符。
x-ms-client-session-id	可选。客户端会话标识符。
x-ms-principal-liveid	可选。主体 Live 标识符。

请求正文

无。

响应

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

状态代码

此操作成功后返回状态代码 200（正常）。

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

响应标头

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

响应正文

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

元素名称	说明
用户	检索到的用户。有关详细信息，请参阅用户 (Common 对象) 。

示例

下面的代码示例演示 了 Get User 请求。

GET https://<computer>:30004/users/tom@tommy.com HTTP/1.1
Authorization: Bearer <token>
x-ms-client-request-id: 137c6d49-4740-42c0-a8a2-db24f34d9da1-2013-06-19 20:55:55Z
x-ms-client-session-id: d7401833-b959-4ac7-adba-c8b9d5c26326
x-ms-principal-id: <computer>\Administrator
Accept-Language: en-US
x-ms-principal-liveid: <computer>\Administrator
Host: <computer>:30004

下面的代码示例演示 了“获取用户” 响应。

{
  "Name": "tom@tommy.com",
  "Email": "Tom@tommy.com",
  "State": 1,
  "CreatedTime": "2013-06-19T17:09:45.387",
  "SubscriptionCount": 1,
  "ActivationSyncState": 0,
  "LastErrorMessage": null
}

另请参阅

常见用户界面

通过