Recuperar 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 recuperar informações de 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. Substitua <o ID> pelo identificador da subscrição para recuperar.

Método	URI do pedido	Versão HTTP
GET	<http:// NotificationEndpoint>/subscrições/<Id>	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

Nenhum.

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 200 (OK) se a operação for bem sucedida.

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 assinatura recuperada. Para mais informações, consulte Subscrição (Objeto endpoint de notificação).

Exemplo

O exemplo a seguir mostra uma Assinatura De Recuperar uma Subscrição para um pedido 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 seguinte exemplo de código mostra a resposta JSON para Recuperar uma Subscrição 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": [

  ]
}

Observações

A propriedade QuotaSettings deve ser povoada na resposta.

Se um fornecedor de recursos estiver a utilizar uma operação de subscrição assíncrona, o fornecedor de recursos devolve 202 da operação assíncrona, a TBD é então chamada a cada 10 segundos pela API de Gestão de Serviços para determinar se a operação está concluída.

O TBD é utilizado durante uma atualização do sistema a partir do Windows Azure Pack Version 1.

Consulte também

Windows Azure Pack Custom Resource Provider Notification API Reference

Partilhar via