预配新订阅

项目
08/24/2015

适用于：Windows Azure Pack

预配新订阅。

请求

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

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

请求标头

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

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

请求正文

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

元素名称	说明
AccountAdminLiveId	帐户管理员的 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 字符串。使用 Guid.NewGuid () 。ToString () 以创建合适的 GUID 字符串值。
状态	订阅状态。使用 null。
PlanId	要订阅的计划的计划标识符。这是 Plan (Administrator 对象) Id 属性。
CoAdminNames	共同管理员的列表。如果没有共同管理员，请使用 null。不需要系统知道共同管理员。随后创建共同管理员帐户时，订阅将自动应用于共同管理员。

响应

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

状态代码

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

有关状态代码的信息，请参阅状态和错误代码 (Windows Azure Pack Service Management) 。

响应标头

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

响应正文

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

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

示例

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

POST https://<Computer>:30004/subscriptions HTTP/1.1
Authorization: Bearer 
x-ms-client-request-id: cf5bca16-e945-42ab-a934-af462fd70aca-2014-04-15 20:37:33Z
x-ms-client-session-id: b5488aa5-137e-443e-be88-407ab0db068d
x-ms-principal-id: <COMPUTER>Administrator
Accept-Language: en-US
Content-Type: application/json; charset=utf-8
Host: <COMPUTER>:30004
Content-Length: 428
Expect: 100-continue
{
  "AccountAdminLiveEmailId": "User@Contoso.com",
  "AccountAdminLivePuid": "user@contoso.com",
  "AccountId": "00000000-0000-0000-0000-000000000000",
  "FriendlyName": "c23",
  "OfferCategory": null,
  "OfferInfo": null,
  "OfferType": 0,
  "ReasonCode": null,
  "ServiceAdminLiveEmailId": "User@Contoso.com",
  "ServiceAdminLivePuid": "user@contoso.com",
  "SubscriptionId": "2ad337ed-c99f-40d1-9645-670b4bdb5016",
  "Status": null,
  "PlanId": "chtm4uwen",
  "CoAdminNames": null
}

以下示例显示了预配订阅响应正文。

{
  "SubscriptionID": "2ad337ed-c99f-40d1-9645-670b4bdb5016",
  "SubscriptionName": "c23",
  "AccountAdminLiveEmailId": "user@contoso.com",
  "ServiceAdminLiveEmailId": null,
  "CoAdminNames": [

  ],
  "AddOnReferences": [

  ],
  "AddOns": [

  ],
  "State": 1,
  "QuotaSyncState": 0,
  "ActivationSyncState": 1,
  "PlanId": "chtm4uwen",
  "Services": [
    {
      "Type": "sqlservers",
      "State": "registered",
      "QuotaSyncState": 0,
      "ActivationSyncState": 1,
      "BaseQuotaSettings": [
        {
          "Key": "Editions",
          "Value": "[{\"displayName\":\"Default\",\"groupName\":\"Default\",\"resourceCount\":\"10\",\"resourceSize\":\"1024\",\"resourceSizeLimit\":\"1024\",\"offerEditionId\":\"032814080310\",\"groupType\":null}]"
        }
      ]
    }
  ],
  "LastErrorMessage": null,
  "Features": null,
  "OfferFriendlyName": "c23",
  "OfferCategory": null,
  "Created": "2014-04-15T20:37:39.223"
}

备注

Windows Azure Pack for Windows 服务器管理员管理门户创建用户时，会预配计划订阅。该过程如下。

收集用户信息和所需计划。对于用户，需要电子邮件地址和密码。用户最初订阅了一个计划。通过调用 “检索可用计划”获取可用计划获取可用计划的列表。需要所需计划 (管理员对象的 id 属性) 才能调用“预配新订阅”。
调用 “检索用户 ”以确定请求的用户是否已存在。
使用 预配新订阅预配订阅。

另请参阅

管理员订阅接口

通过