Spec-Zone.ru › AWS CLI v2

[ aws . iotevents ]

создание-ввода

Описание

Создает ввод.

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

Синтаксис

  create-input
--input-name <value>
[--input-description <value>]
--input-definition <value>
[--tags <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]

Параметры

--input-name (строка)

Имя ввода, которое вы хотите задать.

--input-description (строка)

Краткое описание ввода.

--input-definition (структура)

Определение ввода.

attributes -> (список)

Атрибуты из JSON-загрузки, которые предоставляются вводом. Вводы основаны на сообщениях, отправленных в систему AWS IoT Events с использованием BatchPutMessage. Каждое такое сообщение содержит JSON-загрузку, и эти атрибуты (и их соответствующие значения), указанные здесь, доступны для использования в выражениях condition, используемых детекторами, отслеживающими этот ввод.

(структура)

Атрибуты из JSON-загрузки, которые предоставляются вводом. Вводы основаны на сообщениях, отправленных в систему AWS IoT Events с использованием BatchPutMessage. Каждое такое сообщение содержит JSON-загрузку. Эти атрибуты (и их соответствующие значения), указанные здесь, доступны для использования в выражениях condition, используемых детекторами.

jsonPath -> (строка)

Выражение, которое определяет пару «атрибут-значение» в JSON-структуре. Используйте его для указания атрибута из JSON-загрузки, предоставляемого вводом. Вводы основаны на сообщениях, отправленных в AWS IoT Events (BatchPutMessage). Каждое такое сообщение содержит JSON-загрузку. Этот атрибут (и его соответствующее значение), указанный здесь, доступен для использования в выражениях condition, используемых детекторами.

Синтаксис: <field-name>.<field-name>...

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

attributes=[{jsonPath=string},{jsonPath=string}]

Синтаксис JSON:

{
  "attributes": [
    {
      "jsonPath": "string"
    }
    ...
  ]
}

--tags (список)

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

(структура)

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

key -> (строка)

Ключ тега.

value -> (строка)

Значение тега.

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

key=string,value=string ...

Синтаксис JSON:

[
  {
    "key": "string",
    "value": "string"
  }
  ...
]

--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
  • текст
  • таблица
  • 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.

Для создания ввода

Следующий create-input пример создает ввод.

aws iotevents create-input  \
    --cli-input-json file://pressureInput.json

Содержимое pressureInput.json:

{
    "inputName": "PressureInput",
    "inputDescription": "Pressure readings from a motor",
    "inputDefinition": {
        "attributes": [
            { "jsonPath": "sensorData.pressure" },
            { "jsonPath": "motorid" }
        ]
    }
}

Вывод:

{
    "inputConfiguration": {
        "status": "ACTIVE",
        "inputArn": "arn:aws:iotevents:us-west-2:123456789012:input/PressureInput",
        "lastUpdateTime": 1560795312.542,
        "creationTime": 1560795312.542,
        "inputName": "PressureInput",
        "inputDescription": "Pressure readings from a motor"
    }
}

Дополнительную информацию см. в разделе CreateInput в Справочнике по API AWS IoT Events.

Вывод

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

Информация о конфигурации ввода.

inputName -> (строка)

Имя ввода.

inputDescription -> (строка)

Краткое описание ввода.

inputArn -> (строка)

ARN ввода.

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

Время создания ввода.

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

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

status -> (строка)

Статус ввода.

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

Spec-Zone.ru

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