[ aws . dynamodbstreams ]
list-streams
Описание
Возвращает массив ARNs потоков, связанных с текущей учетной записью и конечной точкой. Если параметр TableName присутствует, то ListStreams вернёт только ARNs потоков для указанной таблицы.
Примечание
Вы можете вызыватьListStreams не чаще, чем 5 раз в секунду.См. также: Документация API AWS
Синтаксис
list-streams
[--table-name <value>]
[--limit <value>]
[--exclusive-start-stream-arn <value>]
[--cli-input-json | --cli-input-yaml]
[--generate-cli-skeleton <value>]
[--debug]
[--endpoint-url <value>]
[--no-verify-ssl]
[--no-paginate]
[--output <value>]
[--query <value>]
[--profile <value>]
[--region <value>]
[--version <value>]
[--color <value>]
[--no-sign-request]
[--ca-bundle <value>]
[--cli-read-timeout <value>]
[--cli-connect-timeout <value>]
[--cli-binary-format <value>]
[--no-cli-pager]
[--cli-auto-prompt]
[--no-cli-auto-prompt]
Параметры
--table-name (строка)
--limit (целое число)
--exclusive-start-stream-arn (строка)
LastEvaluatedStreamArn в предыдущей операции.--cli-input-json | --cli-input-yaml (строка) Читает аргументы из предоставленной JSON-строки. JSON-строка соответствует формату, предоставленному --generate-cli-skeleton. Если на командной строке указаны другие аргументы, эти значения переопределят значения, полученные из JSON. Невозможно передать произвольные двоичные значения с помощью значения, предоставленного в формате JSON, так как строка будет взята буквально. Этот параметр нельзя указывать вместе с --cli-input-yaml.
--generate-cli-skeleton (строка) Выводит JSON-скелет в стандартный вывод, не отправляя запрос к API. Если указано без значения или со значением input, выводит JSON-пример входных данных, который можно использовать в качестве аргумента для --cli-input-json. Аналогично, при указании yaml-input он выведет пример входных данных YAML, которые можно использовать с --cli-input-yaml. При указании значения output он валидирует входные данные команды и возвращает пример JSON-вывода для данной команды. Сгенерированный JSON-скелет не стабилен между версиями AWS CLI, и нет гарантий обратной совместимости в сгенерированном JSON-скелете.
Общие параметры
--debug (булево)
Включить отладочную запись в журнал.
--endpoint-url (строка)
Переопределить URL по умолчанию команды указанным URL.
--no-verify-ssl (булево)
По умолчанию AWS CLI использует SSL при общении с AWS-сервисами. Для каждого SSL-соединения AWS CLI будет проверять SSL-сертификаты. Этот параметр переопределяет поведение проверки SSL-сертификатов по умолчанию.
--no-paginate (булево)
Отключить автоматическую постраничную навигацию. Если автоматическая постраничная навигация отключена, AWS CLI выполнит только один вызов для первой страницы результатов.
--output (строка)
Стиль форматирования вывода команды.
- json
- text
- таблица
- yaml
- yaml-поток
--query (строка)
Запрос JMESPath для фильтрации данных ответа.
--profile (строка)
Использовать определённый профиль из файла ключей.
--region (строка)
Регион для использования. Переопределяет настройки конфигурации/среды.
--version (строка)
Отобразить версию этого инструмента.
--color (строка)
Включение/выключение цветного вывода.
- включено
- выключено
- автоматически
--no-sign-request (булево)
Не подписывать запросы. Ключи не будут загружены, если этот аргумент указан.
--ca-bundle (строка)
Файл с набором сертификатов CA для проверки SSL-сертификатов. Переопределяет настройки конфигурации/среды.
--cli-read-timeout (целое число)
Максимальное время чтения сокета в секундах. Если значение установлено в 0, чтение сокета будет блокирующим и не будет иметь тайм-аута. Значение по умолчанию — 60 секунд.
--cli-connect-timeout (целое число)
Максимальное время подключения сокета в секундах. Если значение установлено в 0, подключение сокета будет блокирующим и не будет иметь тайм-аута. Значение по умолчанию — 60 секунд.
--cli-binary-format (строка)
Стиль форматирования для двоичных блоков. Формат по умолчанию — base64. Формат base64 ожидает, что двоичные блоки будут предоставлены как закодированная в base64 строка. Формат raw-in-base64-out сохраняет совместимость с поведением AWS CLI версии 1, и двоичные значения должны быть переданы буквально. При предоставлении содержимого из файла, которое соответствует двоичному блоку, fileb:// всегда будет обрабатываться как двоичное и использовать содержимое файла непосредственно независимо от настройки cli-binary-format. При использовании file:// содержимое файла должно быть должным образом отформатировано для настроенного cli-binary-format.
- base64
- raw-in-base64-out
--no-cli-pager (булево)
Отключить вывод пэйджера CLI.
--cli-auto-prompt (булево)
Автоматически запрашивать параметры ввода CLI.
--no-cli-auto-prompt (булево)
Отключить автоматическое запросы параметров ввода CLI.
Примеры
Примечание
Для использования следующих примеров необходимо установить и настроить AWS CLI. Подробнее см. руководство по началу работы в руководстве пользователя AWS CLI.
Если не указано иное, все примеры используют правила цитирования Unix-подобных систем. Эти примеры необходимо адаптировать к правилам цитирования вашей оболочки. См. раздел Использование кавычек со строками в руководстве пользователя AWS CLI.
Для перечисления потоков DynamoDB
Следующая команда list-streams перечисляет все существующие потоки Amazon DynamoDB в регионе AWS по умолчанию.
aws dynamodbstreams list-streams
Вывод:
{
"Streams": [
{
"StreamArn": "arn:aws:dynamodb:us-west-1:123456789012:table/Music/stream/2019-10-22T18:02:01.576",
"TableName": "Music",
"StreamLabel": "2019-10-22T18:02:01.576"
}
]
}
Дополнительную информацию см. в разделе Capturing Table Activity with DynamoDB Streams в Руководстве разработчика Amazon DynamoDB.
Вывод
Потоки -> (список)
Список описателей потоков, связанных с текущей учетной записью и конечной точкой.
(структура)
Представляет все данные, описывающие определённый поток.
StreamArn -> (строка)
TableName -> (строка)
StreamLabel -> (строка)
Отметка времени, в формате ISO 8601, для этого потока.
Обратите внимание, что LatestStreamLabel не является уникальным идентификатором потока, так как возможно, что поток из другой таблицы может иметь ту же отметку времени. Однако комбинация следующих трёх элементов гарантированно уникальна:
- Идентификатор клиента Amazon Web Services.
- Имя таблицы
StreamLabel
LastEvaluatedStreamArn -> (строка)
ARN потока элемента, где операция остановилась, включая предыдущий набор результатов. Используйте это значение для запуска новой операции, исключая это значение в новом запросе.
Если LastEvaluatedStreamArn пусто, то «последняя страница» результатов обработана, и больше данных для извлечения нет.
Если LastEvaluatedStreamArn не пусто, это не обязательно означает, что в наборе результатов есть дополнительные данные. Единственный способ узнать, когда вы достигли конца набора результатов, — это когда LastEvaluatedStreamArn пусто.
© Copyright 2025, Amazon Web Services. Created using Sphinx.