检索加载项 (租户加载项)

项目
08/24/2015

适用于：Windows Azure Pack

检索加载项。

请求

将 ServiceMgmt> 替换为<服务管理 API 终结点地址。将 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	可选。主体实时标识符。

请求正文

下表说明了请求正文的元素。

元素名称	说明
includePrice	可选。加载项包含价格。
region	可选。加载项区域。
subscriptionId	可选。订阅标识符。
username	可选。加载项用户名。

有 4 个调用选项。如果使用任何其他选项组合，则操作将没有请求正文。

选项	要求
仅调用 URI 中的 AddonID	无请求正文。
includeprice、region、username & SubscriptionId。	提供的用户名和 subscriptionId。
包括价格、区域 & 用户名	提供的用户名。
includeprice、region 和 subscriptionId	提供的 subscriptionId。

响应

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

状态代码

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

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

响应标头

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

响应正文

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

元素名称	说明
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

下面的代码示例演示 了 Get Add-on 响应。

{
  "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
}

另请参阅

管理员计划接口

通过