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

Очереди списков

 

Эта операция перечисляет все очереди в заданной учетной записи хранилища.

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

Метод

URI запроса

Версия HTTP

GET

https://myaccount.queue.core.windows.net?comp=list

HTTP/1.1

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

Метод

URI запроса

Версия HTTP

GET

http://127.0.0.1:10001/devstoreaccount1?comp=list

HTTP/1.1

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

Параметр

Описание

prefix

Фильтрует результаты для возвращения только очередей с именами, начинающимися с указанного префикса.

marker

Строковое значение, которое определяет часть списка для возвращения со следующей операцией списка. Операция возвращает NextMarker элемент в тексте ответа, если возвращаемый список неполон. Это значение впоследствии может использоваться как параметр запроса в последующем вызове для запроса следующей части списка очередей.

Значение маркера непрозрачно для клиента.

maxresults

Указывает максимальное количество возвращаемых очередей. Если maxresults не указан, сервер возвращает до 5000 элементов.

include=metadata

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

Обратите внимание, что запрошенные этим параметром метаданные должны сохраняться в соответствии с ограничениями на именование, введенными в версии 2009-09-19 службы очередей. Начиная с этой версии, все имена метаданных должны соответствовать соглашениям об именах для идентификаторов C#.

timeout

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

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

Заголовок запроса

Описание

Authorization

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

Date или x-ms-date

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

x-ms-version

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

x-ms-client-request-id

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

Отсутствуют.

См. ниже пример запроса в разделе "Образец запроса и ответа".

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

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

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

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

Заголовок ответа

Описание

x-ms-request-id

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

x-ms-version

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

Date

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

Текст ответа имеет следующий формат. Обратите внимание, что Prefix, Marker, и MaxResults присутствуют, только если они указаны в URI. NextMarker Элемент имеет значение только в том случае, если результаты списка неполны.

Для версии 2013-08-15 и более поздних версиях AccountName для атрибута EnumerationResults элемент был переименован в ServiceEndpoint. Кроме того Url в элементе Queue был удален.

<?xml version="1.0" encoding="utf-8"?> <EnumerationResults ServiceEndpoint="https://myaccount.queue.core.windows.net/"> <Prefix>string-value</Prefix> <Marker>string-value</Marker> <MaxResults>int-value</MaxResults> <Queues> <Queue> <Name>string-value</Name> <Metadata> <metadata-name>value</metadata-name> <Metadata> </Queue> <NextMarker /> </EnumerationResults>

Metadata Присутствует элемент только если include=metadata параметр был указан в URI. В Metadata элемент, значение каждой пары имя значение, указанные в элемент, соответствующий имени в паре.

Если пара имя значение метаданных нарушает ограничения, введенные в версии 2009-09-19, текст ответа показывает проблемное имя в x-ms-invalid-name элемент, как показано в следующем фрагменте XML:


… <Metadata> <MyMetadata1>first value</MyMetadata1> <MyMetadata2>second value</MyMetadata2> <x-ms-invalid-name>invalid-metadata-name</x-ms-invalid-name> <Metadata> …

См. ниже пример ответа в разделе "Образец запроса и ответа".

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

При указании значения для maxresults и количество очередей для возврата превышает это значение или превышает значение по умолчанию для maxresults, текст ответа будет содержать NextMarker элемент, указывающий на следующую очередь для возврата в последующем запросе. Чтобы вернуть следующий набор элементов, укажите значение NextMarker в качестве параметра маркера в URI в последующем запросе.

Обратите внимание, что значение NextMarker должно обрабатываться как непрозрачное.

Очереди в тексте ответа перечисляются в алфавитном порядке.

Это пример URI, который запрашивает список очередей для учетной записи, устанавливая максимальное количество возвращаемых результатов для начальной операции, равное 3.

GET https://myaccount.queue.core.windows.net?comp=list&maxresults=3&include=metadata HTTP/1.1

Запрос отправлен с такими заголовками.

x-ms-version: 2013-08-15 x-ms-date: Wed, 23 Oct 2013 00:55:16 GMT Authorization: SharedKey myaccount:Q7tar7qqM2LD/Wey7OQNPP3hMNap9wjg+g9AlAYeFls=

Возвращены следующие код состояния и заголовки ответа.

HTTP/1.1 200 OK Transfer-Encoding: chunked Content-Type: application/xml Date: Wed, 23 Oct 2013 00:56:38 GMT x-ms-version: 2013-08-15 Server: Windows-Azure-Queue/1.0 Microsoft-HTTPAPI/2.0

XML ответа для этого запроса будет следующим. Обратите внимание, что NextMarker следует за набором очередей и включает имя следующей очереди должны быть возвращены.

<?xml version="1.0" encoding="utf-8"?> <EnumerationResults ServiceEndpoint="https://myaccount.queue.core.windows.net/"> <Prefix>q</Prefix> <MaxResults>3</MaxResults> <Queues> <Queue> <Name>q1</Name> <Metadata> <Color>red</Color> <SomeMetadataName>SomeMetadataValue</SomeMetadataName> <Metadata> </Queue> <Queue> <Name>q2</Name> <Metadata> <Color>blue</Color> <SomeMetadataName>SomeMetadataValue</SomeMetadataName> <Metadata> </Queue> <Queue> <Name>q3</Name> <Metadata> <Color>yellow</Color> <SomeMetadataName>SomeMetadataValue</SomeMetadataName> <Metadata> </Queue> </Queues> <NextMarker>q4</NextMarker> </EnumerationResults>

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

https://myaccount.queue.core.windows.net?comp=list&maxresults=3&include=metadata&prefix=q&marker=q4

Текст ответа для этой операции будет таким:

<?xml version="1.0" encoding="utf-8"?> <EnumerationResults ServiceEndpoint="https://myaccount.queue.core.windows.net/"> <Prefix>q</Prefix> <Marker>q4</Marker> <MaxResults>3</MaxResults> <Queues> <Queue> <Name>q4</Name> <Metadata> <Color>green</Color> <SomeMetadataName>SomeMetadataValue</SomeMetadataName> <Metadata> </Queue> <Queue> <Name>q5</Name> <Metadata> <Color>violet</Color> <SomeMetadataName>SomeMetadataValue</SomeMetadataName> <Metadata> </Queue> </Queues> <NextMarker /> </EnumerationResults>
Показ:
© 2016 Microsoft