Zřízení nového předplatného

Článek
08/24/2015

Platí pro: Windows Azure Pack

Zřídí nové předplatné.

Žádost

Nahraďte <ServiceMgmt> adresou koncového bodu rozhraní API služby Service Management.

Metoda	Identifikátor URI žádosti	Verze PROTOKOLU HTTP
POST	<https:// ServiceMgmt>:30004/subscriptions	HTTP/1.1

Hlavičky požadavku

Následující tabulka popisuje povinné a volitelné hlavičky požadavku.

Hlavička požadavku	Popis
Autorizace: Nosný	Povinná hodnota. Autorizační nosný token.
x-ms-principal-id	Povinná hodnota. Identifikátor objektu zabezpečení.
x-ms-client-request-id	Nepovinný parametr. Identifikátor požadavku klienta.
x-ms-client-session-id	Nepovinný parametr. Identifikátor relace klienta.
x-ms-principal-liveid	Nepovinný parametr. Hlavní živý identifikátor.

Text požadavku

Následující tabulka popisuje prvky textu požadavku.

Název elementu	Popis
AccountAdminLiveId	Identifikátor účtu Microsoft správce účtu. Pro zřizování předplatného se nevyžaduje. Použijte hodnotu null.
AccountAdminLivePuid	Identifikátor účtu Passport správce účtu. Musí se jednat o existující uživatelský účet. Pomocí funkce Načíst uživatele můžete určit, jestli účet existuje.
AccountId	Identifikátor účtu. Použijte guid.empty.
Friendlyname	Popisný název předplatného.
OfferCategory	Kategorie nabídky. Použijte hodnotu null.
OfferInfo	Informace o nabídce. Použijte hodnotu null.
OfferType	Typ nabídky. Použijte 0.
ReasonCode	Kód důvodu. Použijte hodnotu null.
ServiceAdminLiveEmailId	Identifikátor účtu Microsoft správce služeb. Tuto hodnotu nepoužívá Windows Azure Pack a vyžaduje se pouze pro účely konzistence. Použijte hodnotu null.
ServiceAdminLivePuid	Identifikátor účtu Passport správce služby. Pro zřizování předplatného se nevyžaduje. Použijte hodnotu null.
SubscriptionId	Identifikátor předplatného. Vyjadřuje se jako řetězec GUID. Použijte guid.NewGuid(). ToString() pro vytvoření vhodné hodnoty řetězce GUID.
Stav	Stav předplatného. Použijte hodnotu null.
PlanId	Identifikátor plánu, ke který se plán přihlašuje. Toto je vlastnostId plánu (objektu správce).
CoAdminNames	Seznam spolusprávce. Pokud neexistují žádní spolusprávci, použijte hodnotu null. Spolusprávci nemusí být v systému známi. Po následném vytvoření účtu spolusprávce se předplatné automaticky použije na spolusprávce.

Odpověď

Odpověď obsahuje stavový kód HTTP, sadu hlaviček odpovědí a text odpovědi.

Stavový kód

Úspěšná operace vrátí stavový kód 200 (OK).

Informace o stavových kódech najdete v tématu Stav a kódy chyb (Windows Service Management sady Azure Pack).

Hlavičky odpovědi

Odpověď pro tuto operaci zahrnuje standardní hlavičky HTTP. Všechny standardní hlavičky odpovídají specifikaci protokolu HTTP/1.1.

Text odpovědi

Následující tabulka popisuje klíčové prvky textu odpovědi.

Název elementu	Popis
AdminSubscription	Zřízené předplatné. Další informace naleznete v tématu AdminSubscription (objekt správce).

Příklad

Následující příklad kódu ukazuje požadavek na zřízení předplatného .

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
}

Následující příklad ukazuje text odpovědi na zřízení předplatného.

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

Poznámky

Když se uživatel vytvoří v Windows Azure Packu pro portál pro správu serveru Windows Server, zřídí se předplatné plánu. Postup je následující.

Shromážděte informace o uživateli a požadovaný plán. Pro uživatele bude vyžadována e-mailová adresa a heslo. Uživatel se na začátku přihlásí k odběru jednoho plánu. Seznam dostupných plánů se získá voláním Načíst dostupné plány. Vlastnost ID požadovaného plánu (objekt správce) bude potřeba k volání zřízení nového předplatného.
Volání načíst uživatele k určení, jestli požadovaný uživatel již existuje.
Zřízení předplatného pomocí zřízení nového předplatného

Viz také

Rozhraní předplatného správce

Sdílet prostřednictvím