Een abonnement voor een melding ophalen

Artikel
08/24/2015

Van toepassing op: Windows Azure Pack

Wordt gebruikt door de Service Management-API om abonnementsgegevens op te halen.

Aanvraag

Vervang <NotificationEndpoint> door het eindpuntadres voor de Windows Azure Pack Custom Resource Provider Notification REST API. Vervang <id> door de id van het abonnement dat u wilt ophalen.

Methode	Aanvraag-URI	HTTP-versie
GET	<http:// NotificationEndpoint>/subscriptions/<Id>	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

Geen.

Antwoord

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

Statuscode

Retourneer statuscode 200 (OK) als de bewerking is geslaagd.

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 opgehaalde abonnement. Zie Abonnement (Notification Endpoint Object) voor meer informatie.

Voorbeeld

In het volgende voorbeeld ziet u een abonnement ophalen voor een meldingsaanvraag .

GET https://<NotificationEndpoint>:30010/subscriptions/ec66ec96-8edd-4916-be45-607959155c2a HTTP/1.1
Referer: https://<Computer>:30004/subscriptions/ec66ec96-8edd-4916-be45-607959155c2a
Accept-Language: en-US
x-ms-client-request-id: ef2c5d93-a957-439b-9210-de52107322c1-2014-07-09 23:45:22Z
x-ms-client-session-id: a519f0aa-53e9-4522-94fd-3c55607a6b65
x-ms-principal-id: <Computer>%5cAdministrator
x-ms-request-id: 684b6822d29e4aac96fe45110881e525.2014-07-09T23:45:24.2267567Z
Authorization: Basic <encoded username and password>
Content-Type: application/json; charset=utf-8
Host: <Computer>:30010
Content-Length: 0
Expect: 100-continue

In het volgende codevoorbeeld ziet u het JSON-antwoord voor het ophalen van een abonnement voor een melding.

{
  "SubscriptionId": "ec66ec96-8edd-4916-be45-607959155c2a",
  "SubscriptionName": null,
  "State": 1,
  "LifecycleState": 0,
  "LastErrorMessage": null,
  "QuotaSettings": [
    {
      "Key": "Editions",
      "Value": "[{\"displayName\":\"Default\",\"groupName\":\"Default\",\"resourceCount\":\"10\",\"resourceSize\":\"1024\",\"resourceSizeLimit\":\"0\",\"offerEditionId\":\"32814080310\",\"groupType\":\"Shared\"}]"
    }
  ],
  "AdminId": "notauser@contoso.com",
  "CoAdminIds": [

  ]
}

Opmerkingen

De eigenschap QuotaSettings moet worden ingevuld in het antwoord.

Als een resourceprovider een asynchrone abonnementsbewerking gebruikt, retourneert de resourceprovider 202 van de asynchrone bewerking. TBD wordt vervolgens elke 10 seconden aangeroepen door de Service Management-API om te bepalen of de bewerking is voltooid.

TBD wordt gebruikt tijdens een systeemupgrade van Windows Azure Pack versie 1.

Zie ook

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

Delen via