Partilhar via

Endereçar Recursos do Serviço de Fila

  • Artigo

O serviço Fila expõe os seguintes recursos através da API REST:

  • Conta. A conta de armazenamento é uma entidade identificada exclusivamente no sistema de armazenamento. A conta é o espaço de nomes principal do serviço Fila. Todas as filas estão associadas a uma conta.

  • Fila. Uma fila armazena mensagens que podem ser obtidas por uma aplicação ou serviço cliente.

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

Sintaxe do URI do Recurso

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

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

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

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

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

Para mensagens numa fila, o URI base inclui o nome da conta, o nome da fila e o conjunto de mensagens nessa fila:

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

Uma mensagem individual pode ser atualizada ou eliminada ao referir-se ao ID da mensagem. Tenha em atenção que esta sintaxe está disponível apenas para a operação Atualizar Mensagem e Eliminar 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 consulta no URI base. A sintaxe da cadeia 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 suportados Description
list Conta Enumera as entidades abaixo deste recurso. Na conta, devolve a lista de filas.
metadata Fila Define ou devolve propriedades da fila, incluindo metadados definidos pelo utilizador.

Tenha em atenção que todos os valores dos parâmetros de consulta têm de ser codificados com URL antes de serem enviados para os serviços de armazenamento do Azure.

Operações HTTP Suportadas

Cada recurso suporta operações com base nos verbos HTTP GET, PUT, HEAD e DELETE. O verbo, a sintaxe e as versões HTTP suportadas para cada operação são apresentados na página de referência de cada operação. Para obter uma lista completa das páginas de referência da operação, veja API REST do Serviço de Fila.

Ver também

Nomenclatura para Filas e Metadados
Operações em Filas
Operações em Mensagens
API REST de Serviço de Filas