布建新的訂用帳戶

發行項
08/24/2015

適用于：Windows Azure Pack

布建新的訂用帳戶。

要求

以您的服務管理 API 端點位址取代 < ServiceMgmt > 。

方法	要求 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 (OK)。

如需狀態碼的相關資訊，請參閱狀態和錯誤碼 (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 Server 系統管理員管理入口網站中建立使用者時，會布建方案的訂用帳戶。此程序如下所示。

收集使用者資訊和所需的計畫。對於使用者，將需要電子郵件地址和密碼。使用者一開始訂閱一個方案。呼叫 [擷取可用方案] 即可取得可用方案的清單。需要所需方案 (Administrator 物件的id屬性，) 呼叫布建新訂閱。
呼叫擷取使用者，以判斷要求的使用者是否已存在。
使用布建 新的訂用帳戶來布建訂用帳戶。

另請參閱

系統管理員訂用帳戶介面

共用方式為