擷取使用者
適用于：Windows Azure Pack
擷取使用者。
要求
以您的服務管理 API 端點位址取代 < ServiceMgmt > 。 將埠 > 取代 < 為租使用者 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 (OK)。
如需狀態碼的相關資訊，請參閱狀態和錯誤碼 (Windows Azure Pack Service Management) 。
回應標頭
此作業的回應包括標準 HTTP 標頭。 所有標準標頭都符合 HTTP/1.1 通訊協定規格。
回應本文
下表描述回應主體的重要元素：
元素名稱 |
描述 |
|---|---|
User |
擷取的使用者。 如需詳細資訊，請參閱 使用者 (Common 物件) 。 |
範例
下列程式碼範例顯示 取得使用者 要求。
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
}