Obter feedback dos Serviços de Notificação da Plataforma (PNS)

Artigo
05/26/2023

Obtém um URL de contentor do Armazenamento do Azure. O contentor tem dados de comentários para o hub de notificação. Em seguida, o autor da chamada pode utilizar a API REST dos Serviços de Armazenamento do Azure para obter o conteúdo do contentor.

Pedir

Método	URI do pedido	Versão HTTP
GET	`https://{namespace}.servicebus.windows.net/{Notification Hub}/feedbackcontainer?api-version=2015-01`	HTTP/1.1

Cabeçalhos do pedido

A tabela seguinte descreve os cabeçalhos de pedido obrigatórios e opcionais.

Cabeçalho do pedido	Descrição
Content-Type	`application/xml;type=entry;charset=utf-8`
Autorização	Token de SAS gerado conforme especificado em Autenticação de Assinatura de Acesso Partilhado com o Service Bus.
x-ms-version	2015-01

Corpo do pedido

Nenhum.

Resposta

A resposta inclui um código de estado HTTP e um conjunto de cabeçalhos de resposta.

Códigos de resposta

Código	Descrição
200	Obteve o URL do contentor.
401	Falha de autorização. A chave de acesso estava incorreta.
403	Pedido rejeitado porque a funcionalidade não está ativada para o SKU. Atualize para Standard.

Para obter informações sobre códigos de estado, veja Códigos de Estado e Erro.

Cabeçalhos de resposta

Nenhum.

Corpo da resposta

Após o êxito, é devolvido um URL do Contentor de Armazenamento do Azure, completo com o token de autenticação.

Por exemplo:

https://pushpnsfb5702abf7f71e31.blob.core.windows.net/00000000000297200840?sv=2014-02-14&sr=c&sig=XXxxxxxxxxxxxxx%xxxx%2xxxxxxxxxxxxxxxxxxxxxxxxxx%3D&se=2015-05-01T00%3A00%3A22Z&sp=rl

O URL devolvido pode ser utilizado para navegar no contentor e obter os conteúdos com a API REST dos Serviços de Armazenamento do Azure

Segue-se um exemplo de feedback PNS, que indica canais WNS expirados associados a dois IDs de mensagens de notificação diferentes:

<EnumerationResults ServiceEndpoint="---Removed---" ContainerName="00000000002001061088">
  <Blobs>
    <Blob>
      <Name>07272016</Name>
      <Properties>
        <Last-Modified>Wed, 27 Jul 2016 20:57:07 GMT</Last-Modified>
        <Etag>---Removed---</Etag>
        <Content-Length>7150</Content-Length>
        <Content-Type>application/octet-stream</Content-Type>
        <Content-Encoding />
        <Content-Language />
        <Content-MD5 />
        <Cache-Control />
        <Content-Disposition />
        <BlobType>BlockBlob</BlobType>
        <LeaseStatus>unlocked</LeaseStatus>
        <LeaseState>available</LeaseState>
      </Properties>
    </Blob>
  </Blobs>
  <NextMarker />
</EnumerationResults>

Get Blob named : 07272016

<?xml version="1.0" encoding="utf-16"?>
<PnsFeedback xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.microsoft.com/netservices/2010/10/servicebus/connect">
  <FeedbackTime>2016-07-27T20:47:10.8905532Z</FeedbackTime>
  <NotificationSystemError>ExpiredChannel</NotificationSystemError>
  <Platform>windows</Platform>
  <PnsHandle>---Removed---</PnsHandle>
  <NotificationId>215e3aba529b49da9b6d35c134147952-20160727204710-2001061088-1</NotificationId>
</PnsFeedback>

<?xml version="1.0" encoding="utf-16"?>
<PnsFeedback xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.microsoft.com/netservices/2010/10/servicebus/connect">
  <FeedbackTime>2016-07-27T20:56:34.1588971Z</FeedbackTime>
  <NotificationSystemError>ExpiredChannel</NotificationSystemError>
  <Platform>windows</Platform>
  <PnsHandle>---Removed---</PnsHandle>
  <NotificationId>82d1e0626bd14221be7298341ae9a7b3-20160727205634-2001061088-1</NotificationId>
</PnsFeedback>

Código de exemplo

O código de exemplo que demonstra esta API REST está disponível no repositório do GitHub azure-notificationhubs-samples.

Partilhar via