Etablera en ny prenumeration

Artikel
08/24/2015

Gäller för: Windows Azure Pack

Etablerar en ny prenumeration.

Förfrågan

Ersätt <ServiceMgmt> med din Service Management API-slutpunktsadress.

Metod	URI för förfrågan	HTTP-version
POST	<https:// ServiceMgmt>:30004/subscriptions	HTTP/1.1

Rubriker för begäran

I följande tabell beskrivs obligatoriska och valfria begärandehuvuden.

Begärandehuvud	Beskrivning
Auktorisering: Ägarna	Krävs. Ägartoken för auktorisering.
x-ms-principal-id	Krävs. Huvudidentifieraren.
x-ms-client-request-id	Valfritt. Identifierare för klientbegäran.
x-ms-client-session-id	Valfritt. Klientsessionsidentifieraren.
x-ms-principal-liveid	Valfritt. Live-huvudidentifieraren.

Begärandetext

I följande tabell beskrivs elementen i begärandetexten.

Elementnamn	Beskrivning
AccountAdminLiveId	Kontoadministratörens Microsoft-kontoidentifierare. Krävs inte för prenumerationsetablering. Använd null.
AccountAdminLivePuid	Kontoadministratörens Passport-kontoidentifierare. Detta måste vara ett befintligt användarkonto. Du kan använda Hämta en användare för att avgöra om kontot finns.
AccountId	Kontoidentifieraren. Använd Guid.Empty.
FriendlyName	Det egna namnet på prenumerationen.
OfferCategory	Erbjudandekategorin. Använd null.
OfferInfo	Erbjudandeinformationen. Använd null.
OfferType	Erbjudandetypen. Använd 0.
ReasonCode	Orsakskoden. Använd null.
ServiceAdminLiveEmailId	Tjänstadministratörens Microsoft-kontoidentifierare. Det här värdet används inte av Windows Azure Pack och krävs endast i konsekvenssyfte. Använd null.
ServiceAdminLivePuid	Passkonto-ID för tjänstadministratören. Krävs inte för prenumerationsetablering. Använd null.
SubscriptionId	Prenumerationsidentifieraren. Det uttrycks som en GUID-sträng. Använd Guid.NewGuid(). ToString() för att skapa ett lämpligt GUID-strängvärde.
Status	Prenumerationsstatus. Använd null.
PlanId	Planidentifieraren för planen som prenumereras på. Det här är egenskapen Plan (administratörsobjekt)Id .
CoAdminNames	En lista över medadministratörer. Använd null om det inte finns några medadministratörer. Medadministratörerna behöver inte vara kända för systemet. När medadministratörskontot skapas tillämpas prenumerationen automatiskt på medadministratören.

Svarsåtgärder

Svaret innehåller en HTTP-statuskod, en uppsättning svarshuvuden och en svarstext.

Statuskod

En lyckad åtgärd returnerar statuskod 200 (OK).

Information om statuskoder finns i Status- och felkoder (Windows Azure Pack Service Management).

Svarsrubriker

Svaret för den här åtgärden innehåller HTTP-standardhuvuden. Alla standardhuvuden överensstämmer med http/1.1-protokollspecifikationen.

Svarstext

I följande tabell beskrivs nyckelelementen i svarstexten.

Elementnamn	Beskrivning
AdminSubscription	Den etablerade prenumerationen. Mer information finns i AdminSubscription (administratörsobjekt).

Exempel

I följande kodexempel visas en begäran om etableringsprenumeration .

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
}

I följande exempel visas svarstexten För etableringsprenumeration.

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

Kommentarer

När en användare skapas i Windows Azure Pack för Windows Server-administratörshanteringsportalen etableras en prenumeration på en plan. Proceduren är följande.

Samla in användarinformation och önskad plan. För användaren krävs en e-postadress och ett lösenord. Användaren prenumererar först på en plan. En lista över tillgängliga planer hämtas genom att anropa Hämta tillgängliga planer. ID-egenskapen för det önskade planobjektet (administratörsobjektet) behövs för att anropa Etablera en ny prenumeration.
Anropa Hämta en användare för att avgöra om den begärda användaren redan finns.
Etablera prenumerationen med hjälp av Etablera en ny prenumeration.

Se även

Administratörsprenumerationsgränssnitt

Dela via