Экспорт (0) Печать
Развернуть все

Создание очереди

Обновлено: Ноябрь 2013 г.

Операция Create Queue создает очередь в данной учетной записи.

Запрос Create Queue можно составить следующим образом. Рекомендуется использовать протокол HTTPS. Замените myaccount именем нужной учетной записи хранения.

 

Метод URI запроса Версия HTTP

PUT

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

HTTP/1.1

При построении запроса к эмулированной службе хранилища укажите имя узла эмулятора и порт службы очередей в виде 127.0.0.1:10001, затем укажите имя эмулированной учетной записи хранилища.

 

Метод URI запроса Версия HTTP

PUT

http://127.0.0.1:10001/devstoreaccount1/myqueue

HTTP/1.1

Дополнительные сведения см. в About Development Storage.

В URI запроса могут быть заданы следующие дополнительные параметры.

 

Параметр Описание

timeout

Необязательно. Параметр timeout указывается в секундах. Дополнительные сведения см. в Задание времени ожидания для операций службы очередей.

В следующей таблице перечислены обязательные и необязательные заголовки запросов.

 

Заголовок запроса Описание

Authorization

Обязательно. Указывает схему проверки подлинности, имя учетной записи и подпись. Дополнительные сведения см. в Проверка подлинности для служб хранения Azure.

Date или x-ms-date

Обязательно. Задает время в формате UTC для запроса. Дополнительные сведения см. в Проверка подлинности для служб хранения Azure.

x-ms-version

Необязательно. Задает версию операции, используемой для этого запроса. Дополнительные сведения см. в Управление версиями для служб хранилища Azure.

x-ms-meta-name:value

Необязательно. Пары «имя-значение», которые будут связаны с очередью как метаданные.

Обратите внимание: начиная с версии 2009-09-19, имена метаданных должны соответствовать правилам именования для идентификаторов C#.

x-ms-client-request-id

Необязательно. Предоставляет сформированное клиентом непрозрачное значение с ограничением в 1 КБ, которое записывается в журналы аналитики, когда включено ведение журналов аналитики хранилища. Этот заголовок настоятельно рекомендуется использовать для соотнесения действий, выполняемых на стороне клиента, с запросами, получаемыми сервером. Дополнительные сведения см. в разделах Сведения о ведении журнала службы аналитики хранилища и Ведение журналов в Azure: использование журналов для отслеживания запросов к хранилищу.

Ответ включает код состояния HTTP и набор заголовков ответа.

Успешная операция возвращает код состояния 201 (создано).

Сведения о кодах состояния см. в разделе Коды состояний и ошибок.

Ответ для этой операции включает следующие заголовки. Ответ может также включать дополнительные стандартные заголовки HTTP. Все стандартные заголовки соответствуют Спецификации протокола HTTP/1.1.

 

Заголовок ответа Описание

ms-request-id

Этот заголовок однозначно определяет выполненный запрос, его также можно использовать для устранения связанных с запросом неполадок. Дополнительные сведения см. в Устранение неполадок при API-операциях.

x-ms-version

Указывает версию службы очередей, которая используется для выполнения запроса. Этот заголовок возвращается для запросов к версии 2009-09-19 и более поздним версиям.

Date

Значение даты и времени в формате UTC, сформированное службой и указывающее время, когда был инициирован ответ.

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

Вызов этой операции доступен только владельцу учетной записи.

Определяемые пользователем метаданные для очереди можно задать в виде пар «имя-значение» при ее создании.

Если очередь с указанным именем уже существует, то служба очередей проверяет метаданные, сопоставленные с этой очередью. Если существующие метаданные идентичны указанным в запросе Create Queue, то возвращается код состояния 204 (нет контента). Если существующие метаданных не совпадают с метаданными, переданными в запросе Create Queue, то операция завершится ошибкой и кодом состояния 409 (конфликт). Благодаря этому клиенту нет необходимости выполнять дополнительный вызов, чтобы узнать, существует ли уже именованная очередь.

Рекомендации по допустимым именам очередей см. в разделе Именование очередей и метаданных. Если указанное имя очереди не является допустимым, то операция Create Queue возвращает код состояния 400 (неверный запрос) вместе с дополнительными сведениями об ошибке, как показано в следующем примере.

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>

Показ:
© 2014 Microsoft