Atualizar uma assinatura para uma notificação

Artigo
08/24/2015

Aplica-se a: Windows Azure Pack

Atualiza o estado da assinatura para uma notificação.

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 atualizada.

Método	URI da solicitação	Versão HTTP
PUT	<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

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

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

Uma operação bem-sucedida retorna o código de status 200 (OK).

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 atualizada. Para obter mais informações, consulte Assinatura (Objeto ponto de extremidade de notificação).

Exemplo

O exemplo a seguir mostra uma atualização de uma assinatura para uma solicitação 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 exemplo de código a seguir mostra a resposta JSON para atualizar uma assinatura 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": [

  ]
}

Comentários

Essa API só pode ser usada para atualizar os elementos de Estado de uma assinatura.

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

Consulte Também

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

Compartilhar via