Exportar (0) Imprimir
Expandir Tudo

Abordando recursos do serviço Fila

Atualizado: novembro de 2013

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 UTF-8 que pode ser o valor de um elemento XML. Uma mensagem pode ter 64 KB.

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 as operações Atualizar Mensagem (REST API) e Mensagem de exclusão (REST API) e requer um parâmetro popreceipt para a 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 com suporte 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 Windows 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 da operação, consulte API REST do serviço Fila.

Consulte Também

A Microsoft está realizando uma pesquisa online para saber sua opinião sobre o site do MSDN. Se você optar por participar, a pesquisa online lhe será apresentada quando você sair do site do MSDN.

Deseja participar?
Mostrar:
© 2014 Microsoft