VK Cloud Solutions logo

ListQueues

Возвращает список ваших очередей в текущем регионе. Ответ включает не более 1000 результатов. Если вы укажете значение для необязательного QueueNamePrefix параметра, будут возвращены только очереди с именем, которое начинается с указанного значения.

Метод поддерживает разбиение на страницы. Задайте параметр MaxResults  в запросе, чтобы указать максимальное количество результатов, возвращаемых в ответе. Если не установить MaxResults, ответ будет содержать не более 1000 результатов. Если вы установили MaxResults  и есть дополнительные результаты для отображения, ответ будет содержать значение для NextToken. Используйте NextToken в качестве параметра в следующем запросе, listQueues,  чтобы получить следующую страницу результатов.

Параметры запроса

MaxResults

Максимальное количество результатов для включения в ответ. Диапазон значений от 1 до 1000. Вы должны установить, MaxResultsчтобы получить значение NextTokenв ответе.

Тип: целое число

Обязательно: Нет

NextToken

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

Тип: Строка

Обязательно: Нет

QueueNamePrefix

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

URL-адреса и имена очередей чувствительны к регистру.

Тип: Строка

Обязательно: Нет

Элементы ответа

Следующие элементы возвращаются службой.

NextToken

Токен разбиения на страницы для включения в следующий запрос. Значение токена - это nullесли нет дополнительных результатов для запроса или если вы не указали MaxResultsв запросе.

Тип: Строка

QueueUrl.N

Список URL-адресов очереди, до 1000 записей или значение MaxResults, отправленное вами в запросе.

Тип: массив строк

Примеры

Следующий пример запроса запроса возвращает очереди, имена которых начинаются с буквы t. Структура AUTHPARAMS зависит от подписи запроса API. 

Образец запроса

https://sqs.ru-east-2.mcs.mail.ru/
?Action=ListQueues
&QueueNamePrefix=M
&Expires=2020-04-18T22:52:43PST
&Version=2012-11-05
&AUTHPARAMS

Образец ответа

<ListQueuesResponse>
    <ListQueuesResult>
        <QueueUrl>https://sqs.us-east-2.amazonaws.com/123456789012/MyQueue</QueueUrl>
    </ListQueuesResult>
    <ResponseMetadata>
        <RequestId>725275ae-0b9b-4762-b238-436d7c65a1ac</RequestId>
    </ResponseMetadata>
</ListQueuesResponse>