Direccionamiento de recursos de Queue Service

  • Artículo

El servicio Cola expone los recursos siguientes a través de la API de REST:

  • Cuenta. La cuenta de almacenamiento es una entidad identificada de forma única dentro del sistema de almacenamiento. La cuenta es el espacio de nombres primario para el servicio Cola. Todas las colas están asociadas a una cuenta.

  • Cola. Una cola almacena los mensajes que se pueden recuperar mediante una aplicación cliente o un servicio.

  • Mensajes. Los mensajes son texto con codificación UTF-8 que puede ser el valor de un elemento XML. Un mensaje puede tener un tamaño de 64 KiB.

Sintaxis del URI de recurso

Cada recurso tiene un URI base que le corresponde, el cual hace referencia al recurso en sí.

En lo que respecta a la cuenta de almacenamiento, el URI base para las operaciones en la cola incluye solamente el nombre de la cuenta:

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

Si se trata de una cola, el URI base incluye el nombre de la cuenta y el nombre de la cola:

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

Para los mensajes de una cola, el URI base incluye el nombre de la cuenta, el nombre de la cola y el conjunto de mensajes existentes en dicha cola:

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

Un mensaje se puede actualizar o eliminar haciendo referencia al identificador de mensaje. Tenga en cuenta que esta sintaxis solo está disponible para la operación Actualizar mensaje y Eliminar mensaje y requiere un popreceipt parámetro para la comprobación:

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

Todos los recursos pueden tener componentes, que se expresan como parte de la cadena de consulta en el URI base. La sintaxis de la cadena de consulta es ?comp=<component_name>. En la actualidad, los recursos de cola disponen de los componentes de recurso siguientes como parámetros del URI.

Componente Recursos compatibles Descripción
list Cuenta Enumera las entidades existentes en el recurso. En la cuenta, devuelve la lista de colas.
metadata Cola Establece o devuelve propiedades de cola, incluidos los metadatos definidos por el usuario.

Tenga en cuenta que todos los valores para los parámetros de consulta deben estar codificados en para URL antes de enviarlos a los servicios de almacenamiento de Azure.

Operaciones HTTP admitidas

Cada recurso admite operaciones basadas en los verbos HTTP GET, PUT, HEAD y DELETE. El verbo, la sintaxis y las versiones compatibles de HTTP para cada operación aparecen en la página de referencia de cada operación. Para obtener una lista completa de las páginas de referencia de operaciones, consulte Queue Service REST API( API REST de Queue Service).

Consulte también

Asignar nombres a colas y metadatos
Operaciones con colas
Operaciones con mensajes
Queue Service REST API (API REST de Queue service)