Aprowizuj nową subskrypcję

Artykuł
08/24/2015

Dotyczy: Windows Azure Pack

Aprowizuje nową subskrypcję.

Żądanie

Zastąp ciąg <ServiceMgmt> adresem punktu końcowego interfejsu API zarządzania usługami.

Metoda	Identyfikator URI żądania	Wersja PROTOKOŁU HTTP
POST	<https:// ServiceMgmt>:30004/subscriptions	HTTP/1.1

Nagłówki żądań

W poniższej tabeli opisano wymagane i opcjonalne nagłówki żądań.

Nagłówek żądania	Opis
Autoryzacja: elementu nośnego	Wymagane. Token elementu nośnego autoryzacji.
x-ms-principal-id	Wymagane. Identyfikator podmiotu zabezpieczeń.
x-ms-client-request-id	Opcjonalny. Identyfikator żądania klienta.
x-ms-client-session-id	Opcjonalny. Identyfikator sesji klienta.
x-ms-principal-liveid	Opcjonalny. Główny identyfikator na żywo.

Treść żądania

W poniższej tabeli opisano elementy treści żądania.

Nazwa elementu	Opis
AccountAdminLiveId	Identyfikator konta Microsoft administratora konta. Nie jest wymagane do aprowizacji subskrypcji. Użyj wartości null.
AccountAdminLivePuid	Identyfikator konta usługi Passport administratora konta. Musi to być istniejące konto użytkownika. Aby określić, czy konto istnieje, możesz użyć opcji Pobierz użytkownika .
AccountId	Identyfikator konta. Użyj identyfikatora GUID.Empty.
FriendlyName	Przyjazna nazwa subskrypcji.
Kategoria oferty	Kategoria oferty. Użyj wartości null.
OfferInfo	Informacje o ofercie. Użyj wartości null.
OfferType	Typ oferty. Użyj 0.
ReasonCode	Kod przyczyny. Użyj wartości null.
ServiceAdminLiveEmailId	Identyfikator konta Microsoft administratora usługi. Ta wartość nie jest używana przez Windows Azure Pack i jest wymagana tylko do celów spójności. Użyj wartości null.
ServiceAdminLivePuid	Identyfikator konta usługi Passport administratora usługi. Nie jest wymagane do aprowizacji subskrypcji. Użyj wartości null.
SubscriptionId	Identyfikator subskrypcji. Jest on wyrażony jako ciąg GUID. Użyj identyfikatora Guid.NewGuid(). ToString() w celu utworzenia odpowiedniej wartości ciągu identyfikatora GUID.
Stan	Stan subskrypcji. Użyj wartości null.
Identyfikator planu	Identyfikator planu subskrybowanego planu. Jest to właściwość Plan (obiekt administratora)Id .
CoAdminNames	Lista współadministratorów. Użyj wartości null, jeśli nie istnieją współadministratorzy. Współadministratorzy nie muszą być znani systemowi. Po utworzeniu konta współadministratora subskrypcja zostanie automatycznie zastosowana do współadministratora.

Reakcja

Odpowiedź zawiera kod stanu HTTP, zestaw nagłówków odpowiedzi i treść odpowiedzi.

Kod stanu

Operacja zakończona powodzeniem zwraca kod stanu 200 (OK).

Aby uzyskać informacje o kodach stanu, zobacz Status and Error Codes (Windows Azure Pack Service Management).

Nagłówki odpowiedzi

Odpowiedź na tę operację obejmuje standardowe nagłówki HTTP. Wszystkie nagłówki standardowe są zgodne ze specyfikacją protokołu HTTP/1.1.

Treść odpowiedzi

W poniższej tabeli opisano kluczowe elementy treści odpowiedzi.

Nazwa elementu	Opis
AdminSubscription	Aprowizowana subskrypcja. Aby uzyskać więcej informacji, zobacz AdminSubscription (obiekt administratora).

Przykład

Poniższy przykład kodu przedstawia żądanie aprowizacji subskrypcji .

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
}

W poniższym przykładzie przedstawiono treść odpowiedzi Aprowizuj subskrypcję.

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

Uwagi

Po utworzeniu użytkownika w Windows Azure Pack for Windows Server administrator portalu zarządzania subskrypcja planu jest aprowizowana. Procedura jest następująca.

Zbierz informacje o użytkowniku i żądany plan. W przypadku użytkownika wymagany będzie adres e-mail i hasło. Użytkownik jest początkowo subskrybowany do jednego planu. Lista dostępnych planów jest uzyskiwana przez wywołanie polecenia Pobierz dostępne plany. Właściwość id żądanego planu (obiektu administratora) będzie potrzebna do wywołania aprowizacji nowej subskrypcji.
Wywołaj polecenie Pobierz użytkownika, aby określić, czy żądany użytkownik już istnieje.
Aprowizuj subskrypcję przy użyciu aprowizacji nowej subskrypcji.

Zobacz też

Interfejsy subskrypcji administratora

Udostępnij za pośrednictwem