Spec-Zone.ru › AWS CLI v2

[ aws . mediaconnect ]

update-flow-output

Описание

Обновляет существующий выходной поток.

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

Синтаксис

  update-flow-output
[--cidr-allow-list <value>]
[--description <value>]
[--destination <value>]
[--encryption <value>]
--flow-arn <value>
[--max-latency <value>]
[--media-stream-output-configurations <value>]
[--min-latency <value>]
--output-arn <value>
[--port <value>]
[--protocol <value>]
[--remote-id <value>]
[--sender-control-port <value>]
[--sender-ip-address <value>]
[--smoothing-latency <value>]
[--stream-id <value>]
[--vpc-interface-attachment <value>]
[--output-status <value>]
[--ndi-program-name <value>]
[--ndi-speed-hq-quality <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]

Параметры

--cidr-allow-list (список)

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

(строка)

Синтаксис:

"string" "string" ...

--description (строка)

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

--destination (строка)

IP-адрес, куда вы хотите направить вывод.

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

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

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"
}

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

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

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

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

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

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

(структура)

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

DestinationConfigurations -> (список)

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

(структура)

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

DestinationIp -> (строка)

IP-адрес, куда MediaConnect хочет отправить содержимое потока медиа.

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

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

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

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

Name -> (строка)

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

EncodingName -> (строка)

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

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

Коллекция параметров, определяющих, как MediaConnect преобразует контент. Эти поля применяются только к выводам в потоках, имеющих источник CDI.

CompressionFactor -> (дробное число)

Значение, используемое для расчета сжатия для вывода. Битрейт вывода рассчитывается следующим образом: Output bitrate = (1 / compressionFactor) * (source bitrate). Это свойство применяется только к выводам, использующим протокол ST 2110 JPEG XS, с источником потока, использующим протокол CDI. Допустимые значения - это числа с плавающей запятой в диапазоне от 3,0 до 10,0 включительно.

EncoderProfile -> (строка)

Настройка кодера, определяющая параметры сжатия. Это свойство применяется только к потокам видеомедиа, связанным с выводами, использующими протокол ST 2110 JPEG XS, если хотя бы один источник в потоке использует протокол CDI.

MediaStreamName -> (строка)

Имя потока медиа, связанного с выводом.

Синтаксис JSON:

[
  {
    "DestinationConfigurations": [
      {
        "DestinationIp": "string",
        "DestinationPort": integer,
        "Interface": {
          "Name": "string"
        }
      }
      ...
    ],
    "EncodingName": "jxsv"|"raw"|"smpte291"|"pcm",
    "EncodingParameters": {
      "CompressionFactor": double,
      "EncoderProfile": "main"|"high"
    },
    "MediaStreamName": "string"
  }
  ...
]

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

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

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

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

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

Порт, используемый при распределении содержимого на этот вывод.

--protocol (строка)

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

Примечание

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

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

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

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

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

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

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

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

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

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

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

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

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

--vpc-interface-attachment (структура)

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

VpcInterfaceName -> (строка)

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

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

VpcInterfaceName=string

Синтаксис JSON:

{
  "VpcInterfaceName": "string"
}

--output-status (строка)

Указание, должен ли вывод передавать данные или нет. Если вы не укажете поле outputStatus в своем запросе, MediaConnect оставит значение без изменения.

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

  • ENABLED
  • DISABLED

--ndi-program-name (строка)

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

--ndi-speed-hq-quality (целое число)

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

--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)

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

--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 версии 1, и двоичные значения должны быть переданы буквально. При предоставлении содержимого из файла, сопоставляющегося с двоичным блоком, 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-output пример обновляет вывод на указанном потоке.

aws mediaconnect update-flow-output \
    --flow-arn arn:aws:mediaconnect:us-east-1:111122223333:flow:1-23aBC45dEF67hiJ8-12AbC34DE5fG:BaseballGame \
    --output-arn arn:aws:mediaconnect:us-east-1:111122223333:output:2-3aBC45dEF67hiJ89-c34de5fG678h:NYC \
    --port 3331

Вывод:

{
    "FlowArn": "arn:aws:mediaconnect:us-east-1:111122223333:flow:1-23aBC45dEF67hiJ8-12AbC34DE5fG:BaseballGame",
    "Output": {
        "Name": "NYC",
        "Port": 3331,
        "Description": "NYC stream",
        "Transport": {
            "Protocol": "rtp-fec",
            "SmoothingLatency": 100
        },
        "OutputArn": "arn:aws:mediaconnect:us-east-1:111122223333:output:2-3aBC45dEF67hiJ89-c34de5fG678h:NYC",
        "Destination": "192.0.2.12"
    }
}

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

Вывод

FlowArn -> (строка)

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

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

Новые настройки обновлённого вывода.

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

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

Description -> (строка)

Описание вывода.

Destination -> (строка)

Адрес, куда вы хотите направить вывод.

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

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

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 и недопустимо для шифрования с использованием статического ключа.

EntitlementArn -> (строка)

Идентификатор ресурса (ARN) права доступа на потоке отправителя. Это значение актуально только для потоков с правами доступа.

ListenerAddress -> (строка)

IP-адрес, необходимый получателю для установления соединения с потоком. Для публичной сети ListenerAddress представлен эластичным IP-адресом потока. Для частной сети ListenerAddress представлен IP-адресом эластичного сетевого интерфейса VPC. Это поле применяется только к выводам, использующим протокол прослушивателя Zixi pull или SRT.

MediaLiveInputArn -> (строка)

Идентификатор ресурса (ARN) входящего потока канала MediaLive. Этот параметр актуален только для выводов, добавленных путём создания входящего потока MediaLive.

MediaStreamOutputConfigurations -> (список)

Настройка для каждого медиапотока, связанного с выводом.

(структура)

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

DestinationConfigurations -> (список)

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

(структура)

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

DestinationIp -> (строка)

IP-адрес, куда MediaConnect должен отправлять содержимое медиапотока.

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

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

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

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

Name -> (строка)

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

OutboundIp -> (строка)

IP-адрес, необходимый получателю для установления соединения с потоком. Это значение представлено IP-адресом эластичного сетевого интерфейса VPC. Это поле применяется только к выводам, использующим протокол CDI или ST 2110 JPEG XS.

EncodingName -> (строка)

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

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

Набор параметров, определяющих, как MediaConnect преобразует содержимое. Эти поля применяются только к выводам на потоках с источником CDI.

CompressionFactor -> (дробное число)

Значение, используемое для расчёта сжатия для вывода. Битрейт вывода рассчитывается следующим образом: Битрейт вывода = (1 / compressionFactor) * (битрейт источника). Это свойство применяется только к выводам, использующим протокол ST 2110 JPEG XS с источником потока, использующим протокол CDI. Допустимые значения — дробные числа в диапазоне от 3,0 до 10,0 включительно.

EncoderProfile -> (строка)

Настройка кодера, управляющая настройками сжатия. Это свойство применяется только к видеопотокам, связанным с выводами, использующими протокол ST 2110 JPEG XS с источником потока, использующим протокол CDI.

MediaStreamName -> (строка)

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

Name -> (строка)

Имя вывода. Это значение должно быть уникальным в рамках текущего потока.

OutputArn -> (строка)

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

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

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

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

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

CidrAllowList -> (список)

Диапазон IP-адресов, которые должны быть разрешены для инициирования запросов вывода в этот поток. Эти IP-адреса должны быть в формате блока CIDR (например, 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 использует имя вывода.

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

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

VpcInterfaceName -> (строка)

Имя интерфейса VPC для данного ресурса.

BridgeArn -> (строка)

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

BridgePorts -> (список)

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

(целое число)

OutputStatus -> (строка)

Указание о том, передаёт ли вывод данные или нет.

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

END_OF_DOCUMENT_MARKER

Spec-Zone.ru

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