Exportar (0) Imprimir
Expandir todo

Create Queue

Actualizado: febrero de 2015

La operación Create Queue crea una cola en la cuenta especificada.

La solicitud Create Queue se puede construir como sigue. Se recomienda HTTPS. Reemplace myaccount por el nombre de la cuenta de almacenamiento:

 

Método URI de solicitud Versión de HTTP

PUT

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

HTTP/1.1

Al realizar una solicitud en el servicio de almacenamiento emulado, especifique el nombre de host del emulador y el puerto del servicio Cola como 127.0.0.1:10001, seguido del nombre de la cuenta de almacenamiento emulado:

 

Método URI de solicitud Versión de HTTP

PUT

http://127.0.0.1:10001/devstoreaccount1/myqueue

HTTP/1.1

Se pueden especificar los parámetros adicionales siguientes en el URI de solicitud.

 

Parámetro Descripción

timeout

Opcional. El parámetro timeout se expresa en segundos. Para obtener más información, vea Establecer los tiempos de espera para las operaciones del servicio Cola.

En la tabla siguiente se describen los encabezados de solicitud requeridos y opcionales.

 

Encabezado de solicitud Descripción

Authorization

Requerido. Especifica el esquema de autenticación, el nombre de la cuenta y la firma. Para obtener más información, vea Autenticación para los servicios de almacenamiento de Azure.

Date o x-ms-date

Requerido. Especifica la hora universal coordinada (UTC) para la solicitud. Para obtener más información, vea Autenticación para los servicios de almacenamiento de Azure.

x-ms-version

Opcional. Especifica la versión de la operación que se utiliza para esta solicitud. Para obtener más información, vea Versiones de los servicios Blob, Cola y Tabla de Windows Azure.

x-ms-meta-name:value

Opcional. Par nombre-valor que se va a asociar a la cola como metadatos.

Tenga en cuenta que, a partir de la versión 2009-09-19, los nombres de los metadatos deben cumplir las reglas de nomenclatura para los Identificadores de C#.

x-ms-client-request-id

Opcional. Proporciona un valor opaco generado por el cliente con un límite de caracteres de 1 KB que se graba en los registros de análisis cuando el registro de análisis de almacenamiento está habilitado. Se recomienda encarecidamente usar este encabezado para correlacionar las actividades del lado cliente con las solicitudes recibidas por el servidor. Para obtener más información, vea Acerca del registro del análisis de almacenamiento y Registro de Azure: usar registros para realizar el seguimiento de las solicitudes de almacenamiento.

La respuesta incluye un código de estado HTTP y un conjunto de encabezados de respuesta.

Una operación correcta devuelve el código de estado 201 (Creado).

Para obtener información acerca de los códigos de estado, vea Códigos de estado y de error.

La respuesta para esta operación incluye los encabezados siguientes. La respuesta también puede incluir otros encabezados HTTP estándar. Todos los encabezados estándar cumplen la especificación del protocolo HTTP/1.1.

 

Encabezado de respuesta Descripción

ms-request-id

Este encabezado identifica de forma única la solicitud que se realizó y se puede utilizar para solucionar problemas relacionados con esta. Para obtener más información, vea Solucionar problemas relacionados con las operaciones de la API.

x-ms-version

Indica la versión del servicio Cola utilizada para ejecutar la solicitud. Este encabezado se devuelve para las solicitudes realizadas en la versión 2009-09-19 y versiones posteriores.

Date

Valor de fecha y hora UTC generado por el servicio que indica la hora a la que se inició la respuesta.

Response Status:
HTTP/1.1 201 Created

Response Headers:
Transfer-Encoding: chunked
Date: Fri, 16 Sep 2011 01:20:22 GMT
x-ms-version: 2011-08-18
Server: Windows-Azure-Queue/1.0 Microsoft-HTTPAPI/2.0

Solo el propietario de la cuenta puede llamar a esta operación.

Puede especificar metadatos definidos por el usuario como pares nombre-valor en la cola en el momento en que se crea esta.

Si ya existe una cola con el nombre especificado, el servicio Cola comprueba los metadatos asociados a dicha cola. Si los metadatos existentes son idénticos a los especificados en la solicitud Create Queue, se devuelve el código de estado 204 (Sin contenido). Si los metadatos existentes no coinciden con los proporcionados con la solicitud Create Queue, la operación produce un error y se devuelve el código de estado 409 (Conflicto). Los clientes pueden beneficiarse de este comportamiento para evitar una llamada adicional que compruebe si ya existe una cola con nombre.

Para obtener información sobre los nombres de cola válidos, vea Asignar nombres a colas y metadatos. Si el nombre de cola especificado no es un nombre válido, la operación Create Queue devuelve el código de estado 400 (Solicitud incorrecta), junto con información adicional sobre el error, como se muestra en el ejemplo siguiente.

HTTP/1.1 400 One of the request inputs is out of range.
Connection: Keep-Alive
Content-Length: 226
Via: 1.1 TK5-PRXY-22
Date: Wed, 02 May 2012 17:47:54 GMT
Content-Type: application/xml
Server: Windows-Azure-Queue/1.0 Microsoft-HTTPAPI/2.0
x-ms-request-id: fda2babe-ffbb-4f0e-a11b-2bfbd871ba9f
x-ms-version: 2011-08-18

<?xml version="1.0" encoding="utf-8"?>
<Error>
   <Code>OutOfRangeInput</Code>
   <Message>One of the request inputs is out of range.
   RequestId:fda2babe-ffbb-4f0e-a11b-2bfbd871ba9f
   Time:2012-05-02T17:47:55.4334169Z</Message>
</Error>

Mostrar:
© 2015 Microsoft