Criar uma assinatura para uma notificação

Artigo
08/24/2015

Aplica-se a: Windows Azure Pack

Usado pela API de Gerenciamento de Serviços para notificar o provedor de recursos de que uma assinatura de um plano está sendo criada. O objeto Subscription fornecido fornece informações que podem ser usadas pelo provedor de recursos para processar internamente a nova assinatura.

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
POST	<http:// NotificationEndpoint>/subscriptions	HTTP/1.1

Parâmetros de URI

Nenhum.

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 de sessão do cliente.
x-ms-principal-liveid	Opcional. O principal identificador ao vivo.

Corpo da solicitação

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

Nome do elemento	Descrição
Subscription	A assinatura a ser criada. Para obter mais informações, consulte Assinatura (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

Retorne o código de status 201 (Criado) se a criação da assinatura interna do provedor de recursos for bem-sucedida. O código de status 202 (Aceito) poderá ser retornado se a operação estiver sendo executada de forma assíncrona.

Para obter informações sobre códigos de status, consulte Status e Códigos de Erro (Windows Gerenciamento de Serviços 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 do protocolo HTTP/1.1.

Corpo da resposta

A tabela a seguir descreve os principais elementos do corpo da resposta:

Nome do elemento	Descrição
Subscription	A nova assinatura. Para obter mais informações, consulte Assinatura (Objeto de Ponto de Extremidade de Notificação).

Exemplo

O exemplo de código a seguir mostra uma solicitação Criar Assinatura .

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 Criar Assinatura JSON.

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

  ]
}

Comentários

Ao chamar o TBD, a API de Gerenciamento de Serviço aguarda um minuto por uma resposta. Se nenhuma resposta for recebida, a assinatura será marcada como fora de sincronização.

Há suporte para operações assíncronas. Se a operação de criação levar mais de um minuto para ser concluída, o provedor de recursos poderá retornar 202 (Aceito) e definir sua representação interna de Assinatura (Objeto de Ponto de Extremidade de Notificação). LifecycleState to Provisioning. Depois que o provedor de recursos tiver concluído a operação de criação, ele deverá definir sua representação de Assinatura (Objeto ponto de extremidade de notificação). LifecycleState para Provisionado. A API de Gerenciamento de Serviço verificará a Assinatura (Objeto ponto de extremidade de notificação). LifecycleState para conclusão da operação a cada 10 segundos usando TBD.

Consulte Também

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

Compartilhar via