Spec-Zone.ru › AWS CLI v2

[ aws . kinesisvideo ]

create-stream

Описание

Создаёт новый поток Kinesis видео.

При создании нового потока Kinesis Video Streams присваивает ему номер версии. При изменении метаданных потока Kinesis Video Streams обновляет версию.

CreateStream является асинхронной операцией.

Дополнительную информацию о работе сервиса см. в разделе Как это работает.

У вас должны быть разрешения на действие KinesisVideo:CreateStream.

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

Синтаксис

  create-stream
[--device-name <value>]
--stream-name <value>
[--media-type <value>]
[--kms-key-id <value>]
[--data-retention-in-hours <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]

Параметры

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

Имя устройства, которое записывает в поток.

Примечание

В текущей реализации Kinesis Video Streams не использует это имя.

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

Имя потока, который вы создаёте.

Имя потока — это идентификатор потока и должно быть уникальным для каждой учётной записи и региона.

--media-type (строка)

Тип медиа потока. Потребители потока могут использовать эту информацию при обработке потока. Дополнительную информацию о типах медиа см. в разделе Типы медиа. Если вы выберите указать MediaType, см. Требования к именованию для руководства.

Примеры допустимых значений включают “video/h264” и “video/h264,audio/aac”.

Этот параметр необязателен; значение по умолчанию — null (или пустое в JSON).

--kms-key-id (строка)

Идентификатор ключа Управления ключами служб (KMS), который вы хотите использовать Kinesis Video Streams для шифрования данных потока.

Если идентификатор ключа не указан, используется значение по умолчанию — управляемый Kinesis Video ключ (Amazon Web Services/kinesisvideo).

Дополнительную информацию см. в разделе DescribeKey.

--data-retention-in-hours (целое число)

Количество часов, в течение которого вы хотите сохранить данные в потоке. Kinesis Video Streams сохраняет данные в хранилище, связанном с потоком.

Значение по умолчанию — 0, что означает, что данные в потоке не сохраняются.

Когда значение DataRetentionInHours равно 0, потребители по-прежнему могут потреблять фрагменты, которые остаются в буфере хоста службы, который имеет ограничение по времени хранения 5 минут и ограничение по памяти 200 МБ. Фрагменты удаляются из буфера, когда достигается любое из ограничений.

--tags (массив)

Список тегов для сопоставления с указанным потоком. Каждый тег — это пара ключ-значение (значение необязательно).

ключ -> (строка)

значение -> (строка)

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

KeyName1=string,KeyName2=string

Синтаксис JSON:

{"string": "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
  • text
  • table
  • yaml
  • yaml-stream

--query (строка)

Запрос JMESPath для фильтрации данных ответа.

--profile (строка)

Использовать определённый профиль из файла учетных данных.

--region (строка)

Регион для использования. Переопределяет настройки конфигурации/среды.

--version (строка)

Отобразить версию данного инструмента.

--color (строка)

Включить/отключить цветной вывод.

  • on
  • off
  • auto

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

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

--no-cli-auto-prompt (логическое значение)

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

Вывод

StreamARN -> (строка)

Amazon Resource Name (ARN) потока.

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

Spec-Zone.ru

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