Compartilhar via


Endereçando recursos do serviço Fila

O serviço Fila expõe os seguintes recursos pela API de REST:

  • Conta. A conta de armazenamento é uma entidade identificada de forma exclusiva no sistema de armazenamento. A conta é o namespace pai do serviço Fila. Todas as filas são associadas a uma conta.

  • Fila. Uma fila armazena as mensagens que podem ser recuperadas por um aplicativo cliente ou por um serviço.

  • Mensagens As mensagens são texto codificado com UTF-8 que pode ser o valor de um elemento XML. Uma mensagem pode ter 64 KiB de tamanho.

Sintaxe do URI de recurso

Cada recurso tem um URI base correspondente, que se refere ao próprio recurso.

Para a conta de armazenamento, o URI de base para operações de fila inclui apenas o nome da conta:

https://myaccount.queue.core.windows.net  

Para uma fila, o URI de base inclui o nome da conta e o nome da fila:

https://myaccount.queue.core.windows.net/myqueue  

Para mensagens em uma fila, o URI de base inclui o nome da conta, o nome da fila e o conjunto de mensagens na fila:

https://myaccount.queue.core.windows.net/myqueue/messages  

É possível atualizar ou excluir uma mensagem individual fazendo referência à ID da mensagem. Observe que essa sintaxe está disponível apenas para a operação Atualizar Mensagem e Excluir Mensagem e requer um popreceipt parâmetro para verificação:

https://myaccount.queue.core.windows.net/myqueue/messages/messageid?popreceipt=string-value  

Cada recurso também pode ter componentes, que são expressos como parte da cadeia de caracteres de consulta no URI de base. A sintaxe da cadeia de caracteres de consulta é ?comp=<component_name>. Atualmente, os seguintes componentes de recursos estão disponíveis para recursos de fila, como parâmetros no URI.

Componente Recursos compatíveis Descrição
list Conta Enumera as entidades abaixo desse recurso. Na conta, retorna a lista de filas.
metadata Fila Define ou retorna propriedades da fila, incluindo metadados definidos pelo usuário.

Observe que todos os valores para os parâmetros de consulta devem ser codificados por URL antes de serem enviados aos serviços de armazenamento do Azure.

Operações HTTP com suporte

Cada recurso dá suporte a operações baseadas nos verbos HTTP GET, PUT, HEAD e DELETE. O verbo, a sintaxe e a versão HTTP com suporte para cada operação aparecem na página de referência para cada operação. Para obter uma lista completa de páginas de referência de operação, consulte API REST do Serviço de Fila.

Confira também

Nomeação de filas e de metadados
Operações em filas
Operações em mensagens
API REST do serviço Fila