Uppdatera en prenumeration för ett meddelande

Artikel
08/24/2015

Gäller för: Windows Azure Pack

Uppdateringar tillståndet för prenumerationen för ett meddelande.

Förfrågan

Ersätt <NotificationEndpoint> med slutpunktsadressen för rest-API:et Windows Azure Pack Custom Resource Provider Notification. Ersätt <ID> med identifieraren för prenumerationen som ska uppdateras.

Metod	URI för förfrågan	HTTP-version
PUT	<http:// NotificationEndpoint>/subscriptions/<Id>	HTTP/1.1

URI-parametrar

Inga.

Rubriker för begäran

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

Begärandehuvud	Beskrivning
Auktorisering: Basic	Krävs. Den grundläggande auktoriseringstoken.
x-ms-principal-id	Krävs. Huvudidentifieraren.
x-ms-client-request-id	Valfritt. Identifieraren för klientbegäran.
x-ms-client-session-id	Valfritt. Klientsessionsidentifieraren.
x-ms-principal-liveid	Valfritt. Huvudidentifieraren live.

Begärandetext

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

Elementnamn	Beskrivning
Prenumeration	Prenumerationen som ska uppdateras. Mer information finns i Prenumeration (Meddelandeslutpunktsobjekt).

Svarsåtgärder

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

Statuskod

En lyckad åtgärd returnerar statuskoden 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 de viktigaste elementen i svarstexten:

Elementnamn	Beskrivning
Prenumeration	Den uppdaterade prenumerationen. Mer information finns i Prenumeration (Meddelandeslutpunktsobjekt).

Exempel

I följande exempel visas en Uppdatera en prenumeration för en meddelandebegäran .

PUT 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: 219
Expect: 100-continue

I följande kodexempel visas JSON-svaret för Uppdatera en prenumeration för ett meddelande.

{
  "SubscriptionId": "ec66ec96-8edd-4916-be45-607959155c2a",
  "SubscriptionName": "My very cool plan",
  "State": 1,
  "LifecycleState": 0,
  "LastErrorMessage": null,
  "QuotaSettings": null,
  "AdminId": "notauser@contoso.com",
  "CoAdminIds": [

  ]
}

Kommentarer

Det här API:et kan bara användas för att uppdatera tillståndselementen i en prenumeration.

När du anropar TBD väntar Service Management-API:et en minut på ett svar. Om inget svar tas emot markeras prenumerationen som osynkroniserad.

Se även

Windows REST API-referens för meddelande för anpassad resursprovider i Azure Pack

Dela via