Spec-Zone.ru › AWS CLI v2

[ aws . managedblockchain-query ]

list-token-balances

Описание

Этот параметр возвращает следующее для заданной сети блокчейна:

  • Список всех балансов токенов, принадлежащих адресу (либо адресу контракта, либо адресу кошелька).
  • Список всех балансов токенов для всех токенов, созданных контрактом.
  • Список всех балансов токенов для заданного токена.

Примечание

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

См. также: Документацию API AWS

list-token-balances является постраничной операцией. Для получения всего набора результатов могут быть выполнены несколько API-вызовов. Вы можете отключить постраничность, указав аргумент --no-paginate. При использовании --output text и аргумента --query в ответе с постраничной передачей, аргумент --query должен извлекать данные из результатов следующих выражений запросов: tokenBalances

Синтаксис

  list-token-balances
[--owner-filter <value>]
--token-filter <value>
[--cli-input-json | --cli-input-yaml]
[--starting-token <value>]
[--page-size <value>]
[--max-items <value>]
[--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]

Параметры

--owner-filter (структура)

Адрес контракта или кошелька в сети блокчейна, по которому нужно отфильтровать запрос. При перечислении балансов токенов, принадлежащих адресу, необходимо указать свойство address контейнера ownerFilter.

address -> (строка)

Адрес контракта или кошелька.

Сокращенный синтаксис:

address=string

Синтаксис JSON:

{
  "address": "string"
}

--token-filter (структура)

Адрес контракта или идентификатор токена в сети блокчейна, по которому нужно отфильтровать запрос. При перечислении токенов, отчеканенных контрактом, необходимо указать свойство contractAddress этого контейнера.

Примечание

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

network -> (строка)

Сеть блокчейна токена.

contractAddress -> (строка)

Адрес контракта.

tokenId -> (строка)

Уникальный идентификатор токена.

Сокращенный синтаксис:

network=string,contractAddress=string,tokenId=string

Синтаксис JSON:

{
  "network": "ETHEREUM_MAINNET"|"ETHEREUM_SEPOLIA_TESTNET"|"BITCOIN_MAINNET"|"BITCOIN_TESTNET",
  "contractAddress": "string",
  "tokenId": "string"
}

--cli-input-json | --cli-input-yaml (строка) Считывает аргументы из предоставленной JSON-строки. JSON-строка следует формату, указанному в --generate-cli-skeleton. Если другие аргументы предоставляются в командной строке, эти значения переопределят значения, предоставленные в JSON. Невозможно передавать произвольные двоичные значения с помощью значения, предоставленного в JSON, так как строка будет взята буквально. Это не может быть указано вместе с --cli-input-yaml.

--starting-token (строка)

Токен, указывающий, где начать постраничную передачу. Это NextToken из ранее обрывочного ответа.

Примеры использования см. в разделе Постраничная передача в Руководстве пользователя командной строки AWS.

--page-size (целое число)

Размер каждой страницы для получения в вызове AWS-службы. Это не влияет на количество элементов, возвращаемых в выводе команды. Установка меньшего размера страницы приводит к большему количеству вызовов AWS-службы, получая меньше элементов в каждом вызове. Это может помочь предотвратить таймаут вызовов AWS-службы.

Примеры использования см. в разделе Постраничная передача в Руководстве пользователя командной строки AWS.

--max-items (целое число)

Общее количество элементов, которые нужно вернуть в выводе команды. Если доступное общее количество элементов больше указанного значения, в выводе команды предоставляется NextToken. Чтобы продолжить постраничную передачу, укажите значение NextToken в аргументе starting-token последующей команды. Не используйте элемент ответа NextToken непосредственно вне AWS CLI.

Примеры использования см. в разделе Постраничная передача в Руководстве пользователя командной строки AWS.

--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
  • текст
  • таблица
  • 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 V1, и двоичные значения должны быть переданы буквально. При предоставлении содержимого из файла, отображающего двоичный блок, fileb:// всегда будет обрабатываться как двоичный и использовать содержимое файла непосредственно независимо от настройки cli-binary-format. При использовании file:// содержимое файла должно быть должным образом отформатировано для настроенного cli-binary-format.

  • base64
  • raw-in-base64-out

--no-cli-pager (булево)

Отключить пейджер командной строки для вывода.

--cli-auto-prompt (булево)

Автоматически запросить параметры командной строки.

--no-cli-auto-prompt (булево)

Отключить автоматический запрос параметров командной строки.

Вывод

tokenBalances -> (список)

Массив объектов TokenBalance. Каждый объект содержит подробности о балансе токена.

(структура)

Баланс токена.

ownerIdentifier -> (структура)

Контейнер для идентификатора владельца.

address -> (строка)

Адрес контракта или кошелька владельца.

tokenIdentifier -> (структура)

Идентификатор токена, включающий уникальный идентификатор токена и его сеть блокчейна.

network -> (строка)

Сеть блокчейна токена.

contractAddress -> (строка)

Адрес контракта токена.

tokenId -> (строка)

Уникальный идентификатор токена.

Примечание

Для нативных токенов используйте 3-буквенное сокращение, которое лучше всего соответствует вашему токену. Например, btc для Bitcoin, eth для Ether и т. д. Для всех других типов токенов необходимо указать tokenId в формате шестнадцатеричной строки из 64 символов tokenid.

balance -> (строка)

Контейнер баланса токена.

atBlockchainInstant -> (структура)

Время, когда запрашивается TokenBalance, или текущее время, если время не указано в запросе.

Примечание

Это время будет фиксироваться только до секунд.

time -> (метка времени)

Контейнер Timestamp момента в блокчейне.

Примечание

Это timestamp будет фиксироваться только до секунд.

lastUpdatedTime -> (структура)

Timestamp последней транзакции, в которой баланс токена в кошельке был обновлён.

time -> (метка времени)

Контейнер Timestamp момента в блокчейне.

Примечание

Это timestamp будет фиксироваться только до секунд.

nextToken -> (строка)

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

© Copyright 2025, Amazon Web Services. Created using Sphinx.

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API