Spec-Zone.ru › AWS CLI v2

[ 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 (логическое значение)

Если значение true, дополнительная статистическая информация о хранилище данных включается в ответ. Эта функция не может использоваться с хранилищем данных, чьё хранилище S3 управляется клиентом.

--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 -> (структура)

Используется для хранения данных в ведре Amazon S3, управляемом IoT Analytics. После создания хранилища данных выбрать хранилище Amazon S3 нельзя.

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

S3-управляемое пользователем; при выборе хранилища, управляемого пользователем, параметр retentionPeriod игнорируется. После создания хранилища данных выбрать хранилище Amazon S3 нельзя.

bucket -> (строка)

Имя ведра Amazon S3, в котором хранятся данные.

keyPrefix -> (строка)

(Необязательно) Префикс, используемый для создания ключей объектов данных хранилища. Каждый объект в ведре Amazon S3 имеет ключ, являющийся его уникальным идентификатором в ведре. Каждый объект в ведре имеет ровно один ключ. Префикс должен заканчиваться слешем (/).

roleArn -> (строка)

ARN роли, предоставляющей IoT Analytics разрешения на взаимодействие с вашими ресурсами Amazon S3.

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

Используется для хранения данных, используемых IoT SiteWise, в управляемом вами ведре Amazon S3. После создания хранилища данных выбрать хранилище Amazon S3 нельзя.

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

Используется для хранения данных, используемых IoT SiteWise, в управляемом вами ведре Amazon S3.

bucket -> (строка)

Имя ведра Amazon S3, в котором хранятся данные.

keyPrefix -> (строка)

(Необязательно) Префикс, используемый для создания ключей объектов данных хранилища. Каждый объект в ведре Amazon S3 имеет ключ, являющийся его уникальным идентификатором в ведре. Каждый объект в ведре имеет ровно один ключ. Префикс должен заканчиваться слешем (/).

arn -> (строка)

ARN хранилища данных.

status -> (строка)

Состояние хранилища данных:

CREATING

Хранилище данных создается.

ACTIVE

Хранилище данных создано и доступно для использования.

DELETING

Хранилище данных удаляется.

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

Срок хранения данных сообщений в днях для хранилища данных. При выборе хранилища customerManagedS3 этот параметр игнорируется.

unlimited -> (булево)

Если true, данные сообщений хранятся неограниченно.

numberOfDays -> (целое число)

Количество дней, в течение которых сохраняются данные сообщений. Параметр unlimited должен быть false.

creationTime -> (временная метка)

Время создания хранилища данных.

lastUpdateTime -> (временная метка)

Последнее время обновления хранилища данных.

lastMessageArrivalTime -> (временная метка)

Последнее время поступления нового сообщения в хранилище данных.

IoT Analytics обновляет это значение не чаще, чем один раз в минуту для одного хранилища данных Amazon Simple Storage Service. Следовательно, значение lastMessageArrivalTime является приблизительным.

Данная функция применима только к сообщениям, которые поступили в хранилище данных после 23 октября 2020 года.

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

Содержит конфигурационную информацию о форматах файлов. Хранилища данных IoT Analytics поддерживают JSON и Parquet.

По умолчанию используется формат JSON. Вы можете указать только один формат.

После создания хранилища данных изменить формат файлов нельзя.

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

Содержит конфигурационную информацию о формате JSON.

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

Содержит конфигурационную информацию о формате Parquet.

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

Информация, необходимая для определения схемы.

columns -> (список)

Указывает один или несколько столбцов, в которых хранятся ваши данные.

В каждой схеме может быть до 100 столбцов. Каждый столбец может иметь до 100 вложенных типов.

(структура)

Содержит информацию о столбце, в котором хранятся ваши данные.

name -> (строка)

Имя столбца.

type -> (строка)

Тип данных. Дополнительную информацию о поддерживаемых типах данных см. в разделе "Общие типы данных" в Руководстве разработчика Glue.

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

Содержит информацию о размерностях разделения в хранилище данных.

partitions -> (список)

Список размерностей разделения в хранилище данных.

(структура)

Одна размерность разделения хранилища данных. Размеры должны быть AttributePartition или TimestampPartition.

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

Размерность разделения, определенная attributeName.

attributeName -> (строка)

Имя атрибута, определяющего размерность разделения.

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

Размерность разделения, определенная атрибутом даты и времени.

attributeName -> (строка)

Имя атрибута, определяющего размерность разделения по дате и времени.

timestampFormat -> (строка)

Формат временной метки для разделения по дате и времени. По умолчанию используется формат количества секунд с эпохи (с 00:00:00 1 января 1970 года по UTC).

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

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

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

Оценочный размер хранилища данных.

estimatedSizeInBytes -> (двойное)

Оценочный размер ресурса в байтах.

estimatedOn -> (временная метка)

Время, когда была сделана оценка размера ресурса.

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

END_OF_DOCUMENT_MARKER

Spec-Zone.ru

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