[ 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.
|
|