Zřízení nového předplatného (předplatné tenanta)

Článek
08/24/2015

Platí pro: Windows Azure Pack

Zřídí nové předplatné se zadanými informacemi.

Žá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>:30005/subscriptions	HTTP/1.1

Parametry identifikátoru URI

Žádné

Hlavičky požadavku

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

Hlavička požadavku	Popis
x-ms-principal-id:	Povinná hodnota. Identifikátor objektu zabezpečení.
Autorizace: Nosný	Povinná hodnota. Autorizační nosný token.
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 prvku	Description
AccountAdminLiveEmailId	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. Použijte guid.NewGuid(). ToString() pro vytvoření identifikátoru GUID.
Stav	Stav předplatného. Použijte hodnotu null.
PlanId	Identifikátor plánu, ke který se plán přihlašuje.
CoAdminNames	Seznam spolusprávce. Pokud neexistují žádní spolusprávci, použijte hodnotu null. Spolusprávci nemusí být v systému známi. Při 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). MaxSubscriptionsPerPlanReached se vrátí, pokud dosáhnete maximálního počtu povolených předplatných pro daný plán.

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
Předplatné	Zřízená předplatná. Další informace najdete v tématu Předplatné (společný objekt).

Příklad

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

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
}

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

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

Poznámky

Portál pro správu pro tenanty provádí při zřizování předplatného následující volání REST.

Načtěte dostupné plány. Používá se k zobrazení plánů, které může uživatel přihlásit k odběru. Objekty Plan (Object Administrator) vrácené každou z nich mají vlastnost ID . Po zvolení plánu se hodnota ID použije k identifikaci zvoleného plánu ve volání pro zřízení nového předplatného.
Načtěte uživatele. Vzhledem k tomu, že předplatné nelze vytvořit pro uživatele, který neexistuje, toto volání potvrzuje, že uživatel skutečně existuje.
Zřízení nového předplatného Zřídí předplatné pomocí zadaných informací.

Viz také

Rozhraní předplatného tenanta

Sdílet prostřednictvím