Receba e Excluir Mensagem (Leitura Destrutiva)

Artigo
08/05/2023

Esta operação recebe uma mensagem de uma fila ou assinatura e remove a mensagem dessa fila ou assinatura em uma operação atômica.

Solicitação

Método	URI da solicitação	Versão de HTTP
Delete (excluir)	`http{s}://{serviceNamespace}.servicebus.windows.net/{queuePath}/messages/head` ou `http{s}://{serviceNamespace}.servicebus.windows.net/{topicPath}/subscriptions/{subscriptionName}/messages/head\|HTTP/1.1`

Cabeçalhos de solicitação

A tabela a seguir descreve os cabeçalhos de solicitação obrigatórios e opcionais. Além das propriedades mencionadas, o cabeçalho pode conter propriedades personalizadas. Consulte o exemplo.

Cabeçalho da solicitação Descrição

Autorização

Cabeçalho da solicitação	Descrição
Autorização	Especifique um dos seguintes valores de token: Token JWT (Token Web JSON) do Azure Active Directory (Azure AD). Exemplo: `Authorization: Bearer <Azure AD JWT token>`. Para obter informações sobre como gerar um token Azure AD, consulte Autenticar de um aplicativo. Um token SAS. Exemplo: `Authorization: SharedAccessSignature sr=<NAMESPACE NAME>.servicebus.windows.net&sig=<SHARED ACCESS KEY>&se=<TOKEN EXPIRY INSTANT>&skn=<SHARED KEY NAME>`. Para obter informações sobre como gerar um token SAS, consulte Gerar um token de Assinatura de Acesso Compartilhado e Gerar token SAS.

Especifique um dos seguintes valores de token:

Token JWT (Token Web JSON) do Azure Active Directory (Azure AD).
Exemplo: Authorization: Bearer <Azure AD JWT token>.
Para obter informações sobre como gerar um token Azure AD, consulte Autenticar de um aplicativo.
Um token SAS.
Exemplo: Authorization: SharedAccessSignature sr=<NAMESPACE NAME>.servicebus.windows.net&sig=<SHARED ACCESS KEY>&se=<TOKEN EXPIRY INSTANT>&skn=<SHARED KEY NAME>.
Para obter informações sobre como gerar um token SAS, consulte Gerar um token de Assinatura de Acesso Compartilhado e Gerar token SAS.

Corpo da solicitação

Nenhum.

Resposta

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

Códigos de resposta

Código	Descrição
200	Mensagem recuperada e excluída com êxito.
204	Não há mensagens disponíveis no período de tempo limite especificado.
400	Solicitação inválida.
401	Falha de autorização.
410	A fila ou assinatura especificada não existe.
500	Erro interno.

Para obter informações sobre códigos de status, consulte Códigos de status e de erro.

Cabeçalhos de resposta

A resposta para esta operação inclui os cabeçalhos a seguir. A resposta também pode incluir cabeçalhos padrão HTTP adicionais. Todos os cabeçalhos padrão estão em conformidade com a especificação do protocolo HTTP/1.1.

Corpo da resposta

O corpo da resposta é o corpo da mensagem recuperada.

Exemplo

A seguinte solicitação HTTP recebe e exclui uma mensagem de uma fila:

DELETE https://your-namespace.servicebus.windows.net/HttpClientSampleQueue/messages/head?timeout=60 HTTP/1.1  
Authorization: SharedAccessSignature sr=your-namespace&sig=Fg8yUyR4MOmXfHfj55f5hY4jGb8x2Yc%2b3%2fULKZYxKZk%3d&se=1404256819&skn=RootManageSharedAccessKey  
Host: your-namespace.servicebus.windows.net  
Content-Length: 0

O Barramento de Serviço retorna a resposta a seguir. A mensagem contém as propriedades personalizadas "Priority" e "Customer":

HTTP/1.1 200 OK  
Transfer-Encoding: chunked  
Content-Type: application/atom+xml;type=entry;charset=utf-8  
Server: Microsoft-HTTPAPI/2.0  
BrokerProperties: {"DeliveryCount":1,"EnqueuedSequenceNumber":0,"EnqueuedTimeUtc":"Tue, 01 Jul 2014 23:00:23 GMT","Label":"M1","MessageId":"3a146f76afee41648677887ffced72d8","SequenceNumber":1,"State":"Active","TimeToLive":10}  
Priority: "High"  
Customer: "12345,ABC"  
Date: Tue, 01 Jul 2014 23:00:23 GMT  
  
12  
This is a message.  
0

Consulte Também

Exemplo de Cliente HTTP de Barramento de Serviço

Compartilhar via