Validar a cota de serviço para um provedor de recursos

Artigo
08/24/2015

Aplica-se a: Windows Azure Pack

Valida a cota de serviço para um provedor de recursos.

Solicitação

Substitua <NotificationEndpoint> pelo endereço do ponto de extremidade do Windows API REST de Notificação do Provedor de Recursos Personalizado do Azure Pack.

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

Parâmetros de URI

A tabela a seguir descreve os parâmetros de URI.

Parâmetro do URI	Descrição
Validateonly	Defina como true para validar a cota.

Cabeçalhos de solicitação

A tabela a seguir descreve os cabeçalhos de solicitação obrigatórios e opcionais.

Cabeçalho da solicitação	Descrição
Autorização: Básico	Obrigatórios. O token de autorização básico.
x-ms-principal-id	Obrigatórios. O identificador principal.
x-ms-client-request-id	Opcional. O identificador de solicitação do cliente.
x-ms-client-session-id	Opcional. O identificador da sessão do cliente.
x-ms-principal-liveid	Opcional. O identificador live principal.

Corpo da solicitação

A tabela a seguir descreve os elementos do corpo da solicitação.

Nome do elemento	Descrição
QuotaUpdateBatchSubscription	Um lote de configurações de cota que deve ser ignorado pela validação. Para obter mais informações, consulte QuotaUpdateBatch (Objeto De ponto de extremidade de notificação).

Resposta

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

Código de status

Uma operação bem-sucedida retornará o código de status 200 (OK) se a cota for válida. Se a cota for inválida, 400 serão retornados com um objeto ResourceProviderError (Objeto Ponto de Extremidade 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 status, consulte Status e Códigos de Erro (Windows Gerenciamento de Serviço do Azure Pack).

Cabeçalhos de resposta

A resposta para essa operação inclui cabeçalhos HTTP padrão. Todos os cabeçalhos padrão estão em conformidade com a especificação de protocolo HTTP/1.1.

Corpo da resposta

Nenhum.

Exemplo

O exemplo a seguir mostra uma validação da cota de serviço para uma solicitação do Provedor 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 a seguir mostra a resposta JSON para validar a cota de serviço de um provedor 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 cota , valide a Cota de Serviço para um Provedor de Recursos para confirmar se a nova cota é válida. A chamada é feita antes de Atualizar o Configurações de Cota para um Provedor de Recursos é chamado em cada assinatura existente.

Consulte Também

Windows Referência da API REST de Notificação do Provedor de Recursos Personalizado do Azure Pack

Compartilhar via