Een abonnement maken voor een melding

Artikel
08/24/2015

Van toepassing op: Windows Azure Pack

Wordt gebruikt door de Service Management-API om de resourceprovider op de hoogte te stellen dat er een abonnement op een plan wordt gemaakt. Het opgegeven abonnementsobject biedt informatie die door de resourceprovider kan worden gebruikt om het nieuwe abonnement intern te verwerken.

Aanvraag

Vervang <NotificationEndpoint> door het eindpuntadres voor de Windows Azure Pack Custom Resource Provider Notification REST API.

Methode	Aanvraag-URI	HTTP-versie
POST	<http:// NotificationEndpoint>/subscriptions	HTTP/1.1

URI-parameters

Geen.

Aanvraagheaders

In de volgende tabel worden de vereiste en optionele aanvraagheaders beschreven.

Aanvraagheader	Beschrijving
Autorisatie: Basic	Vereist. Het basisautorisatietoken.
x-ms-principal-id	Vereist. De principal-id.
x-ms-client-request-id	Optioneel. De clientaanvraag-id.
x-ms-client-session-id	Optioneel. De clientsessie-id.
x-ms-principal-liveid	Optioneel. De principal Live-id.

Aanvraagbody

In de volgende tabel worden de elementen van de aanvraagbody beschreven.

Elementnaam	Beschrijving
Abonnement	Het abonnement dat moet worden gemaakt. Zie Abonnement (Notification Endpoint Object) voor meer informatie.

Antwoord

Het antwoord bevat een HTTP-statuscode, een set antwoordheaders en een antwoordtekst.

Statuscode

Retourneer statuscode 201 (gemaakt) als het maken van het interne abonnement van de resourceprovider is geslaagd. Statuscode 202 (Geaccepteerd) kan worden geretourneerd als de bewerking asynchroon wordt uitgevoerd.

Zie Status- en Foutcodes (Windows Azure Pack Service Management) voor informatie over statuscodes.

Antwoordheaders

Het antwoord voor deze bewerking bevat standaard HTTP-headers. Alle standaardheaders voldoen aan de http/1.1-protocolspecificatie.

Hoofdtekst van antwoord

In de volgende tabel worden de belangrijkste elementen van de hoofdtekst van het antwoord beschreven:

Elementnaam	Beschrijving
Abonnement	Het nieuwe abonnement. Zie Abonnement (Notification Endpoint Object) voor meer informatie.

Voorbeeld

In het volgende codevoorbeeld ziet u een abonnementsaanvraag maken .

POST https://<NotificationEndpoint>/subscriptions HTTP/1.1
Referer: https://<Computer>:30004/subscriptions
Accept-Language: en-US
x-ms-client-request-id: 4abcdb02-cf03-4b07-a1e1-d43c4fe06a8b-2013-07-25 06:09:39Z
x-ms-client-session-id: be02e255-38de-4e86-9690-b3a3e3037e4c
x-ms-principal-id: <COMPUTER>\Administrator
x-ms-principal-liveid: <COMPUTER>\Administrator
x-ms-request-id: 60668356a6204f269a455cc3f3901a84.2013-07-25T06:09:42.8465532Z
Authorization: Basic <encoded username and password>
Content-Type: application/json; charset=utf-8
Host: <Computer>:30010
Content-Length: 438
Expect: 100-continue
{
  "SubscriptionId": "685a05ed-3a6f-4c3a-b70c-924a1307834f",
  "SubscriptionName": "Hosting Plan One",
  "State": 0,
  "LifecycleState": 0,
  "LastErrorMessage": null,
  "QuotaSettings": [
    {
      "Key": "Editions",
      "Value": "[{\"displayName\":\"Default\",\"groupName\":\"Default\",\"resourceCount\":\"10\",\"resourceSize\":\"1024\",\"resourceSizeLimit\":\"1024\",\"offerEditionId\":\"070913050037\",\"groupType\":null}]"
    }
  ],
  "AdminId": "egghead@contoso.com",
  "CoAdminIds": [

  ]
}

In het volgende codevoorbeeld ziet u een JSON-antwoord voor abonnement maken .

{
  "SubscriptionId": "685a05ed-3a6f-4c3a-b70c-924a1307834f",
  "SubscriptionName": "Hosting Plan One",
  "State": 0,
  "LifecycleState": 0,
  "LastErrorMessage": null,
  "QuotaSettings": [
    {
      "Key": "Editions",
      "Value": "[{\"displayName\":\"Default\",\"groupName\":\"Default\",\"resourceCount\":\"10\",\"resourceSize\":\"1024\",\"resourceSizeLimit\":\"1024\",\"offerEditionId\":\"070913050037\",\"groupType\":null}]"
    }
  ],
  "AdminId": "egghead@contoso.com",
  "CoAdminIds": [

  ]
}

Opmerkingen

Bij het aanroepen van TBD wacht de Service Management-API één minuut voor een antwoord. Als er geen antwoord wordt ontvangen, wordt het abonnement gemarkeerd als niet meer gesynchroniseerd.

Asynchrone bewerkingen worden ondersteund. Als het maken langer dan een minuut duurt, kan de resourceprovider 202 (geaccepteerd) retourneren en de interne weergave van het abonnement (Notification Endpoint Object) instellen. LifecycleState voor inrichting. Once the resource provider has completed the create operation, it should set its representation of Subscription (Notification Endpoint Object).LifecycleState to Provisioned .The Service Management API will check Subscription (Notification Endpoint Object).LifecycleState for operation completion every 10 seconds using TBD.

Zie ook

naslaginformatie over de REST API voor aangepaste resourceprovidermeldingen in Azure Pack Windows

Delen via