Recuperar 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 recuperar informações de 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. Substitua <a ID> pelo identificador da assinatura a ser recuperada.

Método	URI da solicitação	Versão HTTP
GET	<http:// NotificationEndpoint>/subscriptions/<Id>	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 da sessão do cliente.
x-ms-principal-liveid	Opcional. O identificador live principal.

Corpo da solicitação

Nenhum.

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

Retornar o código de status 200 (OK) se a operação for bem-sucedida.

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

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

Nome do elemento	Descrição
Subscription	A assinatura recuperada. Para obter mais informações, consulte Assinatura (Objeto ponto de extremidade de notificação).

Exemplo

O exemplo a seguir mostra a recuperação de uma assinatura para uma solicitação de notificação .

GET https://<NotificationEndpoint>:30010/subscriptions/ec66ec96-8edd-4916-be45-607959155c2a HTTP/1.1
Referer: https://<Computer>:30004/subscriptions/ec66ec96-8edd-4916-be45-607959155c2a
Accept-Language: en-US
x-ms-client-request-id: ef2c5d93-a957-439b-9210-de52107322c1-2014-07-09 23:45:22Z
x-ms-client-session-id: a519f0aa-53e9-4522-94fd-3c55607a6b65
x-ms-principal-id: <Computer>%5cAdministrator
x-ms-request-id: 684b6822d29e4aac96fe45110881e525.2014-07-09T23:45:24.2267567Z
Authorization: Basic <encoded username and password>
Content-Type: application/json; charset=utf-8
Host: <Computer>:30010
Content-Length: 0
Expect: 100-continue

O exemplo de código a seguir mostra a resposta JSON para recuperar uma assinatura para uma notificação.

{
  "SubscriptionId": "ec66ec96-8edd-4916-be45-607959155c2a",
  "SubscriptionName": null,
  "State": 1,
  "LifecycleState": 0,
  "LastErrorMessage": null,
  "QuotaSettings": [
    {
      "Key": "Editions",
      "Value": "[{\"displayName\":\"Default\",\"groupName\":\"Default\",\"resourceCount\":\"10\",\"resourceSize\":\"1024\",\"resourceSizeLimit\":\"0\",\"offerEditionId\":\"32814080310\",\"groupType\":\"Shared\"}]"
    }
  ],
  "AdminId": "notauser@contoso.com",
  "CoAdminIds": [

  ]
}

Comentários

A propriedade QuotaSettings deve ser preenchida na resposta.

Se um provedor de recursos estiver usando uma operação de assinatura assíncrona, o provedor de recursos retornará 202 da operação assíncrona, o TBD será chamado a cada 10 segundos pela API de Gerenciamento de Serviços para determinar se a operação está concluída.

O TBD é usado durante uma atualização do sistema do Windows Azure Pack Versão 1.

Consulte Também

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

Compartilhar via