Receber e Eliminar Mensagem (Leitura Destrutiva)

Esta operação recebe uma mensagem de uma fila ou subscrição e remove a mensagem dessa fila ou subscrição numa operação atómica.

Pedir

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

A tabela seguinte descreve os cabeçalhos de pedido obrigatórios e opcionais. Além das propriedades listadas, o cabeçalho pode conter propriedades personalizadas. Veja o exemplo.

Cabeçalho do Pedido

Description

Autorização

Especifique um dos seguintes valores de token: Token Web JSON (JWT) do Azure Active Directory (Azure AD). Exemplo: Authorization: Bearer <Azure AD JWT token>. Para obter informações sobre como gerar um token de Azure AD, veja Authenticate from an application (Autenticar a partir de uma aplicação). Um token de 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 de SAS, veja Gerar um token de Assinatura de Acesso Partilhado e Gerar token de SAS.

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	Mensagem obtida e eliminada com êxito.
204	Não existem mensagens disponíveis dentro do período de tempo limite especificado.
400	Pedido incorreto.
401	Falha de autorização.
410	A fila ou subscrição especificada não existe.
500	Erro interno.

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

Cabeçalhos de Resposta

A resposta para esta operação inclui os seguintes cabeçalhos. A resposta também pode incluir cabeçalhos HTTP padrão 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 obtida.

Exemplo

O seguinte pedido HTTP recebe e elimina 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 Service Bus devolve a seguinte resposta. A mensagem contém as propriedades personalizadas "Prioridade" e "Cliente":

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 do Service Bus