Partilhar via


Excluir uma Subscrição para uma Notificação

 

Aplica-se a: Windows Azure Pack

Utilizado pela API de Gestão de Serviços para notificar um fornecedor de recursos de que uma subscrição de um plano deve ser eliminada. Isto permite ao fornecedor de recursos fazer qualquer trabalho interno necessário para eliminar a subscrição antes que a API de Gestão de Serviços elimine a subscrição. Todos os fornecedores de recursos que utilizarem a subscrição receberão o pedido de eliminação. A API de Gestão de Serviços não apagará a subscrição até que todos os fornecedores de recursos completem as suas operações de eliminação 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 eliminar.

Método

URI do pedido

Versão HTTP

DELETE

<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. O código de estado 202 pode ser devolvido se a operação estiver a funcionar de forma assíncrona.

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

Nenhum.

Exemplo

O seguinte exemplo de código mostra um pedido de Subscrição de Eliminação .

DELETE https://<NotificationEndpoint>/subscriptions/685a05ed-3a6f-4c3a-b70c-924a1307834f HTTP/1.1
Referer: https://<Computer>:30004/subscriptions/685a05ed-3a6f-4c3a-b70c-924a1307834f
Accept-Language: en-US
x-ms-client-request-id: d736255e-1e94-4193-b91c-858ff2ab2094-2013-07-25 06:15:02Z
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: 4df159a4ade947f784b8547f7f073c6b.2013-07-25T06:15:04.0804669Z
Authorization: Basic <encoded username and password>
Host: <Computer>:30010
Content-Length: 0

Observações

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.

As operações assíncronos são apoiadas. Se a operação de eliminação demorar mais de um minuto a ser concluída, o fornecedor de recursos pode devolver 202 (Aceito) e definir a sua representação interna de Subscrição (Objeto de Ponto final de notificação). Ciclo de vida Estado para Apagar. Uma vez concluída a operação de eliminação, o fornecedor de recursos deverá definir a sua representação de Subscrição (Objeto de Ponto Final de Notificação). Ciclo de vida Estado a Eliminado. A API de Gestão de Serviços verificará a Subscrição (Objeto endpoint de notificação). Ciclo de vida Estado para conclusão de funcionamento a cada 10 segundos utilizando TBD.

Consulte também

Windows Azure Pack Custom Resource Provider Notification API Reference