Criar uma Subscrição para uma Notificação

Artigo
08/24/2015

Aplica-se a: Windows Azure Pack

Utilizado pela API de Gestão de Serviços para notificar o fornecedor de recursos de que está a ser criada uma subscrição de um plano. O objeto de subscrição fornecido fornece informações que podem ser usadas pelo fornecedor de recursos para processar internamente a nova subscrição.

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
POST	<http:// NotificationEndpoint>/subscrições	HTTP/1.1

Parâmetros do URI

Nenhum.

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
Subscrição	A subscrição para criar. Para mais informações, consulte Subscrição (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

Código de estado de devolução 201 (Criado) se a criação interna de subscrição do fornecedor de recursos for bem sucedida. O código de estado 202 (Aceito) pode ser devolvido se a operação estiver a funcionar de forma assíncrona.

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

A tabela a seguir descreve os elementos-chave do organismo de resposta:

Nome do elemento	Descrição
Subscrição	A nova assinatura. Para mais informações, consulte Subscrição (Objeto endpoint de notificação).

Exemplo

O seguinte exemplo de código mostra um pedido de Subscrição Create .

POST https://<NotificationEndpoint>/subscriptions HTTP/1.1
Referer: https://<Computer>:30004/subscriptions
Accept-Language: en-US
x-ms-client-request-id: 4abcdb02-cf03-4b07-a1e1-d43c4fe06a8b-2013-07-25 06:09:39Z
x-ms-client-session-id: be02e255-38de-4e86-9690-b3a3e3037e4c
x-ms-principal-id: <COMPUTER>\Administrator
x-ms-principal-liveid: <COMPUTER>\Administrator
x-ms-request-id: 60668356a6204f269a455cc3f3901a84.2013-07-25T06:09:42.8465532Z
Authorization: Basic <encoded username and password>
Content-Type: application/json; charset=utf-8
Host: <Computer>:30010
Content-Length: 438
Expect: 100-continue
{
  "SubscriptionId": "685a05ed-3a6f-4c3a-b70c-924a1307834f",
  "SubscriptionName": "Hosting Plan One",
  "State": 0,
  "LifecycleState": 0,
  "LastErrorMessage": null,
  "QuotaSettings": [
    {
      "Key": "Editions",
      "Value": "[{\"displayName\":\"Default\",\"groupName\":\"Default\",\"resourceCount\":\"10\",\"resourceSize\":\"1024\",\"resourceSizeLimit\":\"1024\",\"offerEditionId\":\"070913050037\",\"groupType\":null}]"
    }
  ],
  "AdminId": "egghead@contoso.com",
  "CoAdminIds": [

  ]
}

O exemplo de código a seguir mostra uma resposta JSON de subscrição create .

{
  "SubscriptionId": "685a05ed-3a6f-4c3a-b70c-924a1307834f",
  "SubscriptionName": "Hosting Plan One",
  "State": 0,
  "LifecycleState": 0,
  "LastErrorMessage": null,
  "QuotaSettings": [
    {
      "Key": "Editions",
      "Value": "[{\"displayName\":\"Default\",\"groupName\":\"Default\",\"resourceCount\":\"10\",\"resourceSize\":\"1024\",\"resourceSizeLimit\":\"1024\",\"offerEditionId\":\"070913050037\",\"groupType\":null}]"
    }
  ],
  "AdminId": "egghead@contoso.com",
  "CoAdminIds": [

  ]
}

Observações

Ao ligar para a TBD, a API de Gestão de Serviços aguarda um minuto para obter uma resposta. Se não for recebida qualquer resposta, a subscrição está marcada como estando fora de sincronização.

As operações assíncronos são apoiadas. Se a operação de criação demorar mais de um minuto a ser concluída, o fornecedor de recursos pode devolver 202 (Aceito) e definir a sua representação interna de Subscrição (Objeto endpoint de notificação). Ciclo de vida Estado para Provisionamento. Uma vez concluída a operação de criação, deverá definir a sua representação de Subscrição (Objeto de Ponto Final de Notificação). Ciclo de vida Estado a Provisionado . A API de Gestão de Serviços verificará a Subscrição (Objeto endpoint de notificação). Ciclo de vida Estado para conclusão de funcionamento a cada 10 segundos utilizando TBD.

Consulte também

Windows Azure Pack Custom Resource Provider Notification API Reference

Partilhar via