擷取附加元件 (租使用者附加元件)

發行項
08/24/2015

適用於：Windows Azure Pack

擷取附加元件。

要求

以您的服務管理 API 端點位址取代 <ServiceMgmt> 。將 AddonId> 取代<為附加元件的附加元件標識碼。

方法	要求 URI	HTTP 版本
GET	<https:// ServiceMgmt>：30005/addons/<AddonId>	HTTP/1.1

URI 參數

無。

要求標頭

下表描述必要的和選用的要求標頭。

要求標頭	描述
授權：持有人	必要。授權持有人令牌。
x-ms-principal-id	必要。主體識別碼。
x-ms-client-request-id	選擇性。用戶端要求標識碼。
x-ms-client-session-id	選擇性。用戶端會話標識碼。
x-ms-principal-liveid	選擇性。主體 Live 識別碼。

要求本文

下表說明要求主體的元素。

元素名稱	Description
includePrice	選擇性。附加元件包含價格。
區域	選擇性。附加元件區域。
subscriptionId	選擇性。訂用帳戶識別碼。
username	選擇性。附加元件用戶名稱。

有 4 個呼叫選項。如果使用任何其他選項組合，作業就不會有要求本文。

選項	需求
僅限呼叫 URI 中的 AddonID	沒有要求本文。
includeprice、region、username & SubscriptionId。	提供的用戶名稱和 subscriptionId。
Includeprice，區域 & 用戶名稱	提供的用戶名稱。
includeprice、region and subscriptionId	提供的 subscriptionId。

回應

回應包括 HTTP 狀態碼、一組回應標頭和回應主體。

狀態碼

成功的作業會傳回狀態碼 200 (OK)。

如需狀態代碼的相關信息，請參閱 (Windows Azure Pack Service Management) 的狀態和錯誤碼。

回應標頭

此作業的回應包括標準 HTTP 標頭。所有標準標頭都符合 HTTP/1.1 通訊協議規格。

回應本文

下表描述回應主體的重要元素：

元素名稱	Description
PlanAddOn	已擷取的附加元件。如需詳細資訊，請參閱 PlanAddon (Administrator 物件) 。

範例

下列程式代碼範例顯示 取得附加元件 要求。

GET https://<computer>:30004/addons/MyTeshixk1xiz HTTP/1.1
Authorization: Bearer 
x-ms-client-request-id: 5f7abeba-03fd-41ab-92f1-1ef4ee5507f3-2013-07-09 22:02:35Z
x-ms-client-session-id: 4d317dde-d7c1-495e-a819-9802dc021e2f
x-ms-principal-id: <computer>\Administrator
Accept-Language: en-US
x-ms-principal-liveid: <computer>\Administrator
Host: <computer>:30004

下列程式代碼範例顯示 取得附加元件 回應。

{
  "Id": "MyTeshixk1xiz",
  "DisplayName": "My Test Addon",
  "State": 0,
  "ConfigState": 1,
  "QuotaSyncState": 0,
  "LastErrorMessage": null,
  "Advertisements": [
    {
      "LanguageCode": "en-us",
      "DisplayName": "My Test Addon",
      "Description": null
    }
  ],
  "ServiceQuotas": [
    {
      "ServiceName": "sqlservers",
      "ServiceInstanceId": "85D94D4A-6ADF-47A6-BAEF-A01975742308",
      "ServiceDisplayName": "SQL Servers",
      "ServiceInstanceDisplayName": "SQL Servers",
      "ConfigState": 1,
      "QuotaSyncState": 0,
      "Settings": [
        {
          "Key": "Editions",
          "Value": "[{\"groupName\":\"Default\",\"resourceCount\":\"1\",\"resourceSize\":\"10\",\"offerEditionId\":\"1373402022182\"}]"
        }
      ]
    }
  ],
  "SubscriptionCount": 0,
  "AssociatedPlans": [

  ],
  "MaxOccurrencesPerPlan": 1,
  "Price": null
}

另請參閱

系統管理員計劃介面

共用方式為