[ aws . iotanalytics ]
describe-datastore
Описание
Получает информацию о хранилище данных.
См. также: Документацию API AWS
Синтаксис
describe-datastore
--datastore-name <value>
[--include-statistics | --no-include-statistics]
[--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]
Параметры
--datastore-name (строка)
--include-statistics | --no-include-statistics (логическое значение)
--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 V1, и двоичные значения должны передаваться буквально. При предоставлении содержимого из файла, сопоставленного с двоичным блоком 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.
Чтобы получить информацию о хранилище данных
Следующий describe-datastore пример отображает подробности, включая статистику, для указанного хранилища данных.
aws iotanalytics describe-datastore \
--datastore-name mydatastore \
--include-statistics
Вывод:
{
"datastore": {
"status": "ACTIVE",
"name": "mydatastore",
"lastUpdateTime": 1557858971.02,
"creationTime": 1557858971.02,
"retentionPeriod": {
"unlimited": true
},
"arn": "arn:aws:iotanalytics:us-west-2:123456789012:datastore/mydatastore"
},
"statistics": {
"size": {
"estimatedSizeInBytes": 397.0,
"estimatedOn": 1561592040.0
}
}
}
Дополнительную информацию см. в разделе DescribeDatastore в Справочнике по API AWS IoT Analytics.
Вывод
datastore -> (структура)
Информация о хранилище данных.
name -> (строка)
storage -> (структура)
Место хранения данных в хранилище данных. Вы можете выбрать хранилище serviceManagedS3, хранилище customerManagedS3 или хранилище iotSiteWiseMultiLayerStorage. По умолчанию используется serviceManagedS3. После создания хранилища данных выбрать хранилище Amazon S3 нельзя.
serviceManagedS3 -> (структура)
customerManagedS3 -> (структура)
S3-управляемое пользователем; при выборе хранилища, управляемого пользователем, параметр retentionPeriod игнорируется. После создания хранилища данных выбрать хранилище Amazon S3 нельзя.
bucket -> (строка)
keyPrefix -> (строка)
roleArn -> (строка)
iotSiteWiseMultiLayerStorage -> (структура)
Используется для хранения данных, используемых IoT SiteWise, в управляемом вами ведре Amazon S3. После создания хранилища данных выбрать хранилище Amazon S3 нельзя.
customerManagedS3Storage -> (структура)
Используется для хранения данных, используемых IoT SiteWise, в управляемом вами ведре Amazon S3.
bucket -> (строка)
keyPrefix -> (строка)
arn -> (строка)
status -> (строка)
Состояние хранилища данных:
Хранилище данных создается.
Хранилище данных создано и доступно для использования.
Хранилище данных удаляется.
retentionPeriod -> (структура)
Срок хранения данных сообщений в днях для хранилища данных. При выборе хранилища customerManagedS3 этот параметр игнорируется.
unlimited -> (булево)
numberOfDays -> (целое число)
unlimited должен быть false.creationTime -> (временная метка)
lastUpdateTime -> (временная метка)
lastMessageArrivalTime -> (временная метка)
Последнее время поступления нового сообщения в хранилище данных.
IoT Analytics обновляет это значение не чаще, чем один раз в минуту для одного хранилища данных Amazon Simple Storage Service. Следовательно, значение lastMessageArrivalTime является приблизительным.
Данная функция применима только к сообщениям, которые поступили в хранилище данных после 23 октября 2020 года.
fileFormatConfiguration -> (структура)
Содержит конфигурационную информацию о форматах файлов. Хранилища данных IoT Analytics поддерживают JSON и Parquet.
По умолчанию используется формат JSON. Вы можете указать только один формат.
После создания хранилища данных изменить формат файлов нельзя.
jsonConfiguration -> (структура)
parquetConfiguration -> (структура)
Содержит конфигурационную информацию о формате Parquet.
schemaDefinition -> (структура)
Информация, необходимая для определения схемы.
columns -> (список)
Указывает один или несколько столбцов, в которых хранятся ваши данные.
В каждой схеме может быть до 100 столбцов. Каждый столбец может иметь до 100 вложенных типов.
(структура)
Содержит информацию о столбце, в котором хранятся ваши данные.
name -> (строка)
type -> (строка)
datastorePartitions -> (структура)
Содержит информацию о размерностях разделения в хранилище данных.
partitions -> (список)
Список размерностей разделения в хранилище данных.
(структура)
Одна размерность разделения хранилища данных. Размеры должны быть AttributePartition или TimestampPartition.
attributePartition -> (структура)
Размерность разделения, определенная attributeName.
attributeName -> (строка)
timestampPartition -> (структура)
Размерность разделения, определенная атрибутом даты и времени.
attributeName -> (строка)
timestampFormat -> (строка)
statistics -> (структура)
Дополнительная статистическая информация о хранилище данных. Включается, если параметр includeStatistics задан как true в запросе.
size -> (структура)
Оценочный размер хранилища данных.
estimatedSizeInBytes -> (двойное)
estimatedOn -> (временная метка)
© Copyright 2025, Amazon Web Services. Created using Sphinx.