Spec-Zone.ru › AWS CLI v2

[ aws . mediaconnect ]

обновить-источник-потока

Описание

Обновляет источник потока.

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

Синтаксис

  update-flow-source
[--decryption <value>]
[--description <value>]
[--entitlement-arn <value>]
--flow-arn <value>
[--ingest-port <value>]
[--max-bitrate <value>]
[--max-latency <value>]
[--max-sync-buffer <value>]
[--media-stream-source-configurations <value>]
[--min-latency <value>]
[--protocol <value>]
[--sender-control-port <value>]
[--sender-ip-address <value>]
--source-arn <value>
[--source-listener-address <value>]
[--source-listener-port <value>]
[--stream-id <value>]
[--vpc-interface-name <value>]
[--whitelist-cidr <value>]
[--gateway-bridge-source <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]

Параметры

--decryption (структура)

Тип шифрования, используемого для контента, поступающего из источника.

Algorithm -> (строка)

Тип алгоритма шифрования (например, aes128, aes192 или aes256).

ConstantInitializationVector -> (строка)

128-битовое, 16-байтовое шестнадцатеричное значение, представленное строкой из 32 символов, используемое с ключом для шифрования контента. Этот параметр недействителен для шифрования статическим ключом.

DeviceId -> (строка)

Значение одного из устройств, которое вы настроили с помощью поставщика ключей вашей платформы управления цифровыми правами (DRM). Этот параметр обязателен для шифрования SPEKE и недействителен для шифрования статическим ключом.

KeyType -> (строка)

Тип ключа, используемого для шифрования. Если keyType не указан, служба использует значение по умолчанию (static-key).

Region -> (строка)

Регион Amazon Web Services, в котором был создан конечная точка прокси-сервера API Gateway. Этот параметр обязателен для шифрования SPEKE и недействителен для шифрования статическим ключом.

ResourceId -> (строка)

Идентификатор контента. Служба отправляет это значение на сервер ключей для идентификации текущей конечной точки. Идентификатор ресурса также известен как идентификатор контента. Этот параметр обязателен для шифрования SPEKE и недействителен для шифрования статическим ключом.

RoleArn -> (строка)

ARN роли, которую вы создали во время настройки (при настройке MediaConnect в качестве доверенного субъекта).

SecretArn -> (строка)

ARN секрета, который вы создали в Secrets Manager для хранения ключа шифрования. Этот параметр обязателен для шифрования статическим ключом и недействителен для шифрования SPEKE.

Url -> (строка)

URL из прокси-сервера API Gateway, который вы настроили для взаимодействия с сервером ключей. Этот параметр обязателен для шифрования SPEKE и недействителен для шифрования статическим ключом.

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

Algorithm=string,ConstantInitializationVector=string,DeviceId=string,KeyType=string,Region=string,ResourceId=string,RoleArn=string,SecretArn=string,Url=string

Синтаксис JSON:

{
  "Algorithm": "aes128"|"aes192"|"aes256",
  "ConstantInitializationVector": "string",
  "DeviceId": "string",
  "KeyType": "speke"|"static-key"|"srt-password",
  "Region": "string",
  "ResourceId": "string",
  "RoleArn": "string",
  "SecretArn": "string",
  "Url": "string"
}

--description (строка)

Описание источника. Это описание не видно за пределами текущей учетной записи Amazon Web Services.

--entitlement-arn (строка)

Amazon Resource Name (ARN) права доступа, которое позволяет вам подписываться на поток. Право доступа устанавливается создателем контента, а ARN генерируется в рамках потока создателя.

--flow-arn (строка)

ARN потока, который вы хотите обновить.

--ingest-port (целое число)

Порт, на котором поток прослушивает входящий контент. Если протокол источника — Zixi, порт должен быть установлен на 2088.

--max-bitrate (целое число)

Максимальная скорость передачи данных для потоков RIST, RTP и RTP-FEC.

--max-latency (целое число)

Максимальная задержка в миллисекундах. Этот параметр применим только к потокам на основе RIST и Zixi.

--max-sync-buffer (целое число)

Размер буфера (в миллисекундах), используемого для синхронизации входящих данных источника.

--media-stream-source-configurations (список)

Поток медиа, связанный с источником, и параметры этого связывания.

(структура)

Поток медиа, который вы хотите связать с источником, и параметры этого связывания.

EncodingName -> (строка)

Формат, используемый для кодирования данных. Для вспомогательных потоков данных установите имя кодирования на smpte291. Для аудиопотоков установите имя кодирования на pcm. Для потоков видео 2110 установите имя кодирования на raw. Для потоков видео JPEG XS установите имя кодирования на jxsv.

InputConfigurations -> (список)

Потоки медиа, которые вы хотите связать с источником.

(структура)

Параметры транспорта, которые вы хотите связать с входящим потоком медиа.

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

Порт, на котором поток должен прослушивать входящий поток медиа.

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

Интерфейс VPC, который вы хотите использовать для входящего потока медиа.

Name -> (строка)

Имя интерфейса VPC.

MediaStreamName -> (строка)

Имя потока медиа.

Синтаксис JSON:

[
  {
    "EncodingName": "jxsv"|"raw"|"smpte291"|"pcm",
    "InputConfigurations": [
      {
        "InputPort": integer,
        "Interface": {
          "Name": "string"
        }
      }
      ...
    ],
    "MediaStreamName": "string"
  }
  ...
]

--min-latency (целое число)

Минимальная задержка в миллисекундах для потоков на основе SRT. В потоках, использующих протокол SRT, это значение, которое вы устанавливаете в источнике или выводе MediaConnect, представляет собой минимальную потенциальную задержку этого подключения. Задержка потока устанавливается в наибольшее значение между минимальной задержкой отправителя и минимальной задержкой получателя.

--protocol (строка)

Протокол, используемый источником для передачи контента в MediaConnect.

Примечание

Elemental MediaConnect больше не поддерживает протокол Fujitsu QoS. Эта ссылка сохраняется только для обратной совместимости.

Возможные значения:

  • zixi-push
  • rtp-fec
  • rtp
  • zixi-pull
  • rist
  • st2110-jpegxs
  • cdi
  • srt-listener
  • srt-caller
  • fujitsu-qos
  • udp
  • ndi-speed-hq

--sender-control-port (целое число)

Порт, который поток использует для отправки исходящих запросов для установления подключения с отправителем.

--sender-ip-address (строка)

IP-адрес, с которым общается поток для установления подключения с отправителем.

--source-arn (строка)

ARN источника, который вы хотите обновить.

--source-listener-address (строка)

IP-адрес или доменное имя источника для протокола SRT-caller.

--source-listener-port (целое число)

Порт источника для протокола SRT-caller.

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

Идентификатор потока, который вы хотите использовать для этого транспорта. Этот параметр применим только к потокам Zixi и SRT caller.

--vpc-interface-name (строка)

Имя интерфейса VPC, в который вы хотите направить свой вывод.

--whitelist-cidr (строка)

Диапазон IP-адресов, которым разрешено вносить контент в ваш источник. Форматируйте IP-адреса как блок CIDR (Classless Inter-Domain Routing); например, 10.0.0.0/16.

--gateway-bridge-source (структура)

Настройка источника для облачных потоков, принимающих поток со шлюза.

BridgeArn -> (строка)

ARN шлюза, питающего этот поток.

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

Имя прикрепления интерфейса VPC, которое следует использовать для этого источника шлюза.

VpcInterfaceName -> (строка)

Имя интерфейса VPC, которое следует использовать для этого ресурса.

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

BridgeArn=string,VpcInterfaceAttachment={VpcInterfaceName=string}

Синтаксис JSON:

{
  "BridgeArn": "string",
  "VpcInterfaceAttachment": {
    "VpcInterfaceName": "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 (boolean)

Включить отладку логирования.

--endpoint-url (string)

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

--no-verify-ssl (boolean)

По умолчанию AWS CLI использует SSL при взаимодействии с AWS-сервисами. Для каждого SSL-соединения AWS CLI будет проверять SSL-сертификаты. Этот параметр переопределяет поведение проверки SSL-сертификатов по умолчанию.

--no-paginate (boolean)

Отключить автоматическую постраничность. Если автоматическая постраничность отключена, AWS CLI выполнит только один вызов для первой страницы результатов.

--output (string)

Стиль форматирования вывода команды.

  • json
  • text
  • table
  • yaml
  • yaml-stream

--query (string)

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

--profile (string)

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

--region (string)

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

--version (string)

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

--color (string)

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

  • on
  • off
  • auto

--no-sign-request (boolean)

Не подписывать запросы. Учетные данные не будут загружены, если этот аргумент указан.

--ca-bundle (string)

Файл с сертификатами CA для проверки SSL-сертификатов. Переопределяет настройки конфигурации/среды.

--cli-read-timeout (int)

Максимальное время чтения сокета в секундах. Если значение равно 0, чтение сокета будет блокирующим и не будет иметь таймаут. Значение по умолчанию — 60 секунд.

--cli-connect-timeout (int)

Максимальное время подключения сокета в секундах. Если значение равно 0, подключение сокета будет блокирующим и не будет иметь таймаут. Значение по умолчанию — 60 секунд.

--cli-binary-format (string)

Стиль форматирования для двоичных блоков. Формат по умолчанию — 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 (boolean)

Отключить пейджер CLI для вывода.

--cli-auto-prompt (boolean)

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

--no-cli-auto-prompt (boolean)

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

Примеры

Примечание

Для использования следующих примеров необходимо установить и настроить AWS CLI. Дополнительную информацию см. в руководстве по началу работы в Руководстве пользователя AWS CLI.

Если не указано иное, все примеры используют правила цитирования, аналогичные Unix. Эти примеры необходимо адаптировать к правилам цитирования вашей оболочки. См. Раздел Использование кавычек со строками в Руководстве пользователя AWS CLI.

Для обновления источника существующего потока

Следующий update-flow-source пример обновляет источник существующего потока.

aws mediaconnect update-flow-source \
    --flow-arn arn:aws:mediaconnect:us-east-1:111122223333:flow:1-23aBC45dEF67hiJ8-12AbC34DE5fG:AwardsShow \
    --source-arn arn:aws:mediaconnect:us-east-1:111122223333:source:3-4aBC56dEF78hiJ90-4de5fG6Hi78Jk:ShowSource \
    --description 'Friday night show' \
    --ingest-port 3344 \
    --protocol rtp-fec \
    --whitelist-cidr 10.24.34.0/23

Вывод:

{
    "FlowArn": "arn:aws:mediaconnect:us-east-1:111122223333:flow:1-23aBC45dEF67hiJ8-12AbC34DE5fG:AwardsShow",
    "Source": {
        "IngestIp": "34.210.136.56",
        "WhitelistCidr": "10.24.34.0/23",
        "Transport": {
            "Protocol": "rtp-fec"
        },
        "IngestPort": 3344,
        "Name": "ShowSource",
        "Description": "Friday night show",
        "SourceArn": "arn:aws:mediaconnect:us-east-1:111122223333:source:3-4aBC56dEF78hiJ90-4de5fG6Hi78Jk:ShowSource"
    }
}

Дополнительную информацию см. в разделе Обновление источника потока в Руководстве пользователя AWS Elemental MediaConnect.

Выходные данные

FlowArn -> (строка)

Идентификатор ресурса (ARN) потока, который был обновлен.

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

Детали источников, назначенных потоку.

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

Процент стоимости передачи данных, взимаемый с подписчика (от 0 до 100).

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

Тип шифрования, используемого для контента, поступающего из этого источника.

Algorithm -> (строка)

Тип алгоритма шифрования (например, aes128, aes192 или aes256).

ConstantInitializationVector -> (строка)

Значение 128-битного 16-байтового шестнадцатеричного ключа, представленное 32-символьной строкой. Используется с ключом для шифрования контента. Этот параметр недействителен для шифрования с использованием статического ключа.

DeviceId -> (строка)

Значение одного из устройств, которое вы настроили с помощью поставщика ключей платформы цифровых прав (DRM). Требуется для шифрования SPEKE и недействительно для шифрования с использованием статического ключа.

KeyType -> (строка)

Тип ключа, используемого для шифрования. Если keyType не указан, служба использует значение по умолчанию (static-key).

Region -> (строка)

Регион Amazon Web Services, в котором был создан прокси-точку API Gateway. Требуется для шифрования SPEKE и недействительно для шифрования с использованием статического ключа.

ResourceId -> (строка)

Идентификатор контента. Служба отправляет это значение на сервер ключей для идентификации текущей точки доступа. Идентификатор ресурса также известен как идентификатор контента. Требуется для шифрования SPEKE и недействительно для шифрования с использованием статического ключа.

RoleArn -> (строка)

Идентификатор ресурса (ARN) роли, которую вы создали во время настройки (при настройке MediaConnect в качестве доверенного субъекта).

SecretArn -> (строка)

Идентификатор ресурса (ARN) секрета, созданного в Secrets Manager для хранения ключа шифрования. Требуется для шифрования с использованием статического ключа и недействительно для шифрования SPEKE.

Url -> (строка)

URL из прокси-сервера API Gateway, который вы настроили для взаимодействия с сервером ключей. Требуется для шифрования SPEKE и недействительно для шифрования с использованием статического ключа.

Description -> (строка)

Описание источника. Это значение не используется и не отображается за пределами текущей учетной записи MediaConnect.

EntitlementArn -> (строка)

Идентификатор ресурса (ARN) права доступа, которое позволяет вам подписываться на контент, поступающий из другой учетной записи Amazon Web Services. Право доступа устанавливается создателем контента, а ARN генерируется в рамках потока создателя.

IngestIp -> (строка)

IP-адрес, на котором поток будет прослушивать входящий контент.

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

Порт, на котором поток будет прослушивать входящий контент.

MediaStreamSourceConfigurations -> (список)

Медиапотоки, связанные с источником, и параметры этих связей.

(структура)

Медиапоток, связанный с источником, и параметры этой связи.

EncodingName -> (строка)

Формат, используемый для кодирования данных. Для вспомогательных потоков данных установите имя кодирования в smpte291. Для аудиопотоков установите имя кодирования в pcm. Для потоков видео 2110 установите имя кодирования в raw. Для потоков видео JPEG XS установите имя кодирования в jxsv.

InputConfigurations -> (список)

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

(структура)

Параметры передачи, связанные с входящим медиапотоком.

InputIp -> (строка)

IP-адрес, на котором поток прослушивает входящий контент для медиапотока.

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

Порт, на котором поток прослушивает входящий медиапоток.

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

Интерфейс VPC, откуда поступает медиапоток.

Name -> (строка)

Имя интерфейса VPC.

MediaStreamName -> (строка)

Имя, которое помогает различать один медиапоток от другого.

Name -> (строка)

Имя источника.

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

IP-адрес, с которым поток связывается для инициации соединения с отправителем.

SenderIpAddress -> (строка)

Порт, который поток использует для отправки исходящих запросов для инициации соединения с отправителем.

SourceArn -> (строка)

Идентификатор ресурса (ARN) источника.

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

Атрибуты, относящиеся к потоку передачи данных, используемому в источнике.

CidrAllowList -> (список)

Диапазон IP-адресов, которые должны быть разрешены для инициации запросов вывода в этот поток. Эти IP-адреса должны быть представлены блоком CIDR (Classless Inter-Domain Routing); например, 10.0.0.0/16

(строка)

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

Максимальная битрейт-скорость сглаживания (в битах в секунду) для потоков RIST, RTP и RTP-FEC.

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

Максимальное время задержки в миллисекундах. Этот параметр применим только к потокам на основе RIST и Zixi.

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

Размер буфера (в миллисекундах) для синхронизации входящих данных источника.

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

Минимальное время задержки в миллисекундах для потоков на основе SRT. В потоках, использующих протокол SRT, это значение, которое вы устанавливаете на своем источнике или выходе MediaConnect, представляет собой минимальную потенциальную задержку этого соединения. Задержка потока устанавливается в соответствии с наибольшим значением между минимальной задержкой отправителя и минимальной задержкой получателя.

Protocol -> (строка)

Протокол, используемый источником или выводом.

Примечание

Elemental MediaConnect больше не поддерживает протокол Fujitsu QoS. Эта ссылка сохранена только для совместимости с предыдущими версиями.

RemoteId -> (строка)

Удаленный идентификатор для потока Zixi-pull.

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

Порт, который поток использует для отправки исходящих запросов для инициации соединения с отправителем.

SenderIpAddress -> (строка)

IP-адрес, с которым поток связывается для инициации соединения с отправителем.

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

Время задержки сглаживания в миллисекундах для потоков RIST, RTP и RTP-FEC.

SourceListenerAddress -> (строка)

IP-адрес или доменное имя источника для протокола SRT-caller.

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

Порт источника для протокола SRT-caller.

StreamId -> (строка)

Идентификатор потока, который вы хотите использовать для этой передачи. Этот параметр применим только к потокам Zixi и SRT caller-based.

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

Настройка качества для кодера NDI Speed HQ.

NdiProgramName -> (строка)

Суффикс для имен NDI-источников, которые создает поток. Если не указано другое имя, MediaConnect использует имя выхода.

VpcInterfaceName -> (строка)

Имя интерфейса VPC, используемого для этого источника.

WhitelistCidr -> (строка)

Диапазон IP-адресов, которые должны быть разрешены для предоставления контента вашему источнику. Эти IP-адреса должны быть представлены блоком CIDR (Classless Inter-Domain Routing); например, 10.0.0.0/16.

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

Настройка источника для облачных потоков, получающих поток с моста.

BridgeArn -> (строка)

Идентификатор ресурса (ARN) моста, который подключает этот поток.

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

Имя прикрепления к интерфейсу VPC, которое следует использовать для этого источника моста.

VpcInterfaceName -> (строка)

Имя интерфейса VPC, которое следует использовать для этого ресурса.

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

Spec-Zone.ru

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