擷取使用者

發行項
08/24/2015

適用于：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
}

另請參閱

常見的使用者介面

共用方式為