预配新订阅 (租户订阅)

项目
08/24/2015

适用于：Windows Azure Pack

预配具有指定信息的新订阅。

请求

将 <ServiceMgmt> 替换为服务管理 API 终结点地址。

方法	请求 URI	HTTP 版本
POST	<https:// ServiceMgmt>：30005/subscriptions	HTTP/1.1

URI 参数

无。

请求标头

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

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

请求正文

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

元素名称	说明
AccountAdminLiveEmailId	帐户管理员的 Microsoft 帐户标识符。订阅预配不需要。使用 null。
AccountAdminLivePuid	帐户管理员的 Passport 帐户标识符。这必须是现有的用户帐户。可以使用检索用户来确定帐户是否存在。
AccountId	帐户标识符。使用 Guid.Empty。
FriendlyName	订阅的友好名称。
OfferCategory	产品/服务类别。使用 null。
OfferInfo	产品/服务信息。使用 null。
OfferType	产品/服务类型。使用 0。
ReasonCode	原因代码。使用 null。
ServiceAdminLiveEmailId	服务管理员的 Microsoft 帐户标识符。 Windows Azure Pack 不使用此值，并且仅用于一致性目的。使用 null。
ServiceAdminLivePuid	服务管理员的 Passport 帐户标识符。订阅预配不需要。使用 null。
SubscriptionId	订阅标识符。使用 Guid.NewGuid () 。ToString () 以创建 GUID。
状态	订阅状态。使用 null。
PlanId	要订阅的计划的计划标识符。
CoAdminNames	共同管理员的列表。如果不存在共同管理员，请使用 null。共同管理员不需要知道系统。创建共同管理员帐户后，会自动将订阅应用于共同管理员。

响应

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

状态代码

此操作成功后返回状态代码 200（正常）。如果达到计划允许的最大订阅数，则返回 MaxSubscriptionsPerPlanReached。

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

响应标头

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

响应正文

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

元素名称	说明
订阅	预配的订阅。有关详细信息，请参阅订阅 (Common 对象) 。

示例

下面的代码示例显示了 预配订阅 请求。

POST https://<Computer>:30005/subscriptions HTTP/1.1
Authorization: Bearer <Token>
x-ms-client-request-id: 02130fee-13b7-4b93-b618-3a8830dbe611-2014-04-15 20:00:55Z
x-ms-client-session-id: eec98428-7dd5-4033-8a2c-77946f61a2f6
x-ms-principal-id: NewUser%40contoso.com
Accept-Language: en-US
Content-Type: application/json; charset=utf-8
Host: <computer>:30005
Content-Length: 458
Expect: 100-continue
{
  "AccountAdminLiveEmailId": null,
  "AccountAdminLivePuid": "newuser@contoso.com",
  "AccountId": "00000000-0000-0000-0000-000000000000",
  "FriendlyName": "MyServicePlanX",
  "OfferCategory": null,
  "OfferInfo": null,
  "OfferType": 0,
  "ReasonCode": null,
  "ServiceAdminLiveEmailId": null,
  "ServiceAdminLivePuid": "newuser@contoso.com",
  "SubscriptionId": "da506abb-1658-4abf-971c-e0e5a9c47b83",
  "Status": null,
  "PlanId": "MyServicePlanX18aa6bac",
  "CoAdminNames": null
}

下面的代码示例显示了 预配订阅 响应正文。

{
  "SubscriptionID": "da506abb-1658-4abf-971c-e0e5a9c47b83",
  "SubscriptionName": "MyServicePlanX",
  "AccountAdminLiveEmailId": "newuser@contoso.com",
  "ServiceAdminLiveEmailId": null,
  "CoAdminNames": [

  ],
  "AddOnReferences": [

  ],
  "AddOns": [

  ],
  "State": 1,
  "QuotaSyncState": 0,
  "ActivationSyncState": 1,
  "PlanId": "MyServicePlanX18aa6bac",
  "Services": [
    {
      "Type": "mysqlservers",
      "State": "registered",
      "QuotaSyncState": 0,
      "ActivationSyncState": 1,
      "BaseQuotaSettings": [
        {
          "Key": "Editions",
          "Value": "[{\"displayName\":\"Default\",\"groupName\":\"Default\",\"resourceCount\":\"10\",\"resourceSize\":\"1024\",\"offerEditionId\":\"040814101717\",\"groupType\":null}]"
        }
      ]
    }
  ],
  "LastErrorMessage": null,
  "Features": null,
  "OfferFriendlyName": "MyServicePlanX",
  "OfferCategory": null,
  "Created": "2014-04-15T20:00:59.187"
}

备注

预配订阅时，租户的管理门户会进行以下 REST 调用。

检索可用计划。这用于显示用户可以订阅的计划。计划 (管理员对象) 返回的对象都有 ID 属性。选择计划后， ID 值用于标识调用 中对预配新订阅的所选计划。
检索用户。由于无法为不存在的用户创建订阅，因此此调用确认用户确实存在。
预配新订阅。使用提供的信息预配订阅。

另请参阅

租户订阅接口

通过