Validar a quota de serviço para um Fornecedor de Recursos

Artigo
08/24/2015

Aplica-se a: Windows Azure Pack

Valida a quota de serviço para um fornecedor de recursos.

Pedir

Substitua <o Ponto de NotificaçãoEndpoint> pelo endereço de ponto final para o Windows Azure Pack Custom Resource Provider Notification REST API.

Método	URI do pedido	Versão HTTP
PUT	<http:// NotificationEndpoint>/quota?validateOnly=true	HTTP/1.1

Parâmetros do URI

A tabela seguinte descreve os parâmetros URI.

Parâmetro URI	Description
validarOnly	Definido como verdadeiro para validar a quota.

Pedido cabeçalhos

A tabela seguinte descreve os cabeçalhos de pedido necessários e opcionais.

Cabeçalho do pedido	Description
Autorização: Básico	Obrigatório. O sinal de autorização básica.
x-ms-principal-id	Obrigatório. O identificador principal.
x-ms-cliente-pedido-id	Opcional. O identificador de pedido do cliente.
x-ms-cliente-sessão-id	Opcional. O identificador da sessão do cliente.
x-ms-principal-liveid	Opcional. O principal identificador ao vivo.

Corpo do Pedido

A tabela seguinte descreve os elementos do corpo de pedido.

Nome do elemento	Descrição
QuotaUpdateBatchSubscription	Um lote de definições de quota que deve ser ignorado por validação. Para obter mais informações, consulte QuotaUpdateBatch (Objeto endpoint de notificação).

Resposta

A resposta inclui um código de estado HTTP, um conjunto de cabeçalhos de resposta e um corpo de resposta.

Código de Estado

Uma operação bem sucedida devolve o código de estado 200 (OK) se a quota for válida. Se a quota for inválida, 400 é devolvido com um objeto ResourceProviderError (Objeto endpoint de notificação) contendo uma mensagem de erro localizada que explica o motivo do erro de validação.

Para obter informações sobre códigos de estado, consulte Códigos de Estado e de Erro (Windows Gestão de Serviços de Pacote Azure).

Cabeçalhos de Resposta

A resposta para esta operação inclui cabeçalhos HTTP padrão. Todos os cabeçalhos standard estão de acordo com a especificação do protocolo HTTP/1.1.

Corpo de Resposta

Nenhum.

Exemplo

O exemplo a seguir mostra uma Validação da Quota de Serviço para um pedido de Fornecedor de Recursos .

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": [

  ]
}

O exemplo de código que se segue mostra a resposta JSON para validar a quota de serviço para um Fornecedor de Recursos.

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

  ],
  "SubscriptionIdsToUpdate": [

  ]
}

Resumo

Sempre que houver uma alteração na quota , é chamada a confirmar que a nova quota é válida. A chamada é feita antes de atualizar o Definições de quota para um Fornecedor de Recursos é chamado em cada subscrição existente.

Consulte também

Windows Azure Pack Custom Resource Provider Notification API Reference

Partilhar via