Verifiera tjänstkvoten för en resursprovider

Artikel
08/24/2015

Gäller för: Windows Azure Pack

Verifierar tjänstkvoten för en resursprovider.

Förfrågan

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

Metod	URI för förfrågan	HTTP-version
PUT	<http:// NotificationEndpoint>/quota?validateOnly=true	HTTP/1.1

URI-parametrar

I följande tabell beskrivs URI-parametrarna.

URI-parameter	Beskrivning
validateOnly	Ange till true för att verifiera kvoten.

Rubriker för begäran

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

Begärandehuvud	Beskrivning
Auktorisering: Grundläggande	Krävs. Den grundläggande auktoriseringstoken.
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
QuotaUpdateBatchSubscription	En batch med kvotinställningar som ska ignoreras av valideringen. Mer information finns i QuotaUpdateBatch (Notification Endpoint Object).

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) om kvoten är giltig. Om kvoten är ogiltig returneras 400 med ett ResourceProviderError-objekt (Notification Endpoint Object) som innehåller ett lokaliserat felmeddelande som förklarar orsaken till verifieringsfelet.

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

Inga.

Exempel

I följande exempel visas en Verifiera tjänstkvoten för en resursproviderbegäran .

PUT https://<NotificationEndpoint>:30012/quota?validateOnly=true HTTP/1.1
Referer: https://<Computer>:30004/plans/MyServicePlanX18aa6bac-5e8d-439e-b4d9-4a7dea4e843a/quota
Accept-Language: en-US
x-ms-client-request-id: 0ee49d13-7b86-4840-b0e1-046106a8d813-2014-07-09 23:16:21Z
x-ms-client-session-id: a519f0aa-53e9-4522-94fd-3c55607a6b65
x-ms-principal-id: <Computer>%5cAdministrator
x-ms-request-id: 840de34d9d9a484a8ddd7255a44cb1fd.2014-07-09T23:16:22.6545190Z
Authorization: Basic <encoded username and password>
Content-Type: application/json; charset=utf-8
Host: <Computer>:30012
Content-Length: 273
Expect: 100-continue

{
  "BaseQuota": [
    {
      "Key": "Editions",
      "Value": "[{\"displayName\":\"Default\",\"groupName\":\"Default\",\"resourceCount\":11,\"resourceSize\":1024,\"offerEditionId\":\"040814101717\",\"groupType\":null,\"resourceSizeLimit\":null}]"
    }
  ],
  "AddOnQuotas": [

  ],
  "SubscriptionIdsToUpdate": [

  ]
}

I följande kodexempel visas JSON-svaret för Verifiera tjänstkvoten för en resursprovider.

{
  "BaseQuota": [
    {
      "Key": "Editions",
      "Value": "[{\"displayName\":\"Default\",\"groupName\":\"Default\",\"resourceCount\":11,\"resourceSize\":1024,\"offerEditionId\":\"040814101717\",\"groupType\":null,\"resourceSizeLimit\":null}]"
    }
  ],
  "AddOnQuotas": [

  ],
  "SubscriptionIdsToUpdate": [

  ]
}

Sammanfattning

När det sker en ändring i kvoten verifierar du att tjänstkvoten för en resursprovider anropas för att bekräfta att den nya kvoten är giltig. Anropet görs innan Uppdatera Inställningar för en resursprovider anropas för varje befintlig prenumeration.

Se även

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

Dela via