Atualizar uma subscrição para uma notificação

Artigo
08/24/2015

Aplica-se a: Windows Azure Pack

Atualizações o estado de subscrição para uma notificaçã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 atualizar.

Método	URI do pedido	Versão HTTP
PUT	<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

A tabela seguinte descreve os elementos do corpo de pedido.

Nome do elemento	Descrição
Subscrição	A subscrição para atualizar. 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

Uma operação bem sucedida devolve o código de estado 200 (OK).

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

Exemplo

O exemplo a seguir mostra uma Atualização de uma Subscrição para um pedido de Notificação .

PUT 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: 219
Expect: 100-continue

O seguinte exemplo de código mostra a resposta JSON para atualizar uma subscrição para uma notificação.

{
  "SubscriptionId": "ec66ec96-8edd-4916-be45-607959155c2a",
  "SubscriptionName": "My very cool plan",
  "State": 1,
  "LifecycleState": 0,
  "LastErrorMessage": null,
  "QuotaSettings": null,
  "AdminId": "notauser@contoso.com",
  "CoAdminIds": [

  ]
}

Observações

Esta API só pode ser utilizada para atualizar os elementos estatais de uma subscrição.

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.

Consulte também

Windows Azure Pack Custom Resource Provider Notification API Reference

Partilhar via