создание-потока

Описание

Создаёт новый поток. В запросе должен быть указан один источник. Запрос может также включать в себя выходы (до 50) и права (до 50).

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

Синтаксис

  create-flow
[--availability-zone <value>]
[--entitlements <value>]
[--media-streams <value>]
--name <value>
[--outputs <value>]
[--source <value>]
[--source-failover-config <value>]
[--sources <value>]
[--vpc-interfaces <value>]
[--maintenance <value>]
[--source-monitoring-config <value>]
[--flow-size <value>]
[--ndi-config <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]

Параметры

--availability-zone (строка)

Зона доступности, в которой вы хотите создать поток. Эти параметры ограничены зонами доступности в текущем регионе Amazon Web Services.

--entitlements (список)

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

(структура)

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

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

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

Description -> (строка)

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

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

Тип шифрования, который будет использоваться для выхода, связанного с этими правами. Допустимые типы шифрования: static-key, speke.

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

EntitlementStatus -> (строка)

Указание о том, должен ли новый набор прав быть включён или выключен сразу после его создания. Если вы не указываете поле entitlementStatus в запросе, MediaConnect устанавливает его в ENABLED.

Name -> (строка)

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

Subscribers -> (список)

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

(строка)

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

DataTransferSubscriberFeePercent=integer,Description=string,Encryption={Algorithm=string,ConstantInitializationVector=string,DeviceId=string,KeyType=string,Region=string,ResourceId=string,RoleArn=string,SecretArn=string,Url=string},EntitlementStatus=string,Name=string,Subscribers=string,string ...

Синтаксис JSON:

[
  {
    "DataTransferSubscriberFeePercent": integer,
    "Description": "string",
    "Encryption": {
      "Algorithm": "aes128"|"aes192"|"aes256",
      "ConstantInitializationVector": "string",
      "DeviceId": "string",
      "KeyType": "speke"|"static-key"|"srt-password",
      "Region": "string",
      "ResourceId": "string",
      "RoleArn": "string",
      "SecretArn": "string",
      "Url": "string"
    },
    "EntitlementStatus": "ENABLED"|"DISABLED",
    "Name": "string",
    "Subscribers": ["string", ...]
  }
  ...
]

--media-streams (список)

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

(структура)

Поток медиа, который вы хотите добавить в поток.

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

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

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

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

ChannelOrder -> (строка)

Формат аудиоканала.

Colorimetry -> (строка)

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

ExactFramerate -> (строка)

Частота кадров для видеопотока в кадрах/секунду. Например: 60000/1001. Если вы указываете целое число, MediaConnect использует отношение N/1. Например, если вы указываете 60, MediaConnect использует 60/1 как exactFramerate.

Par -> (строка)

Соотношение сторон пикселя (PAR).

Range -> (строка)

Диапазон кодирования видео.

ScanMode -> (строка)

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

Tcs -> (строка)

Система характеристик передачи (TCS), используемая в видео.

Lang -> (строка)

Язык аудио в формате, распознаваемом приёмником.

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

Частота дискретизации (в Гц) для потока. Если тип потока медиа — видео или вспомогательные данные, установите это значение в 90000. Если тип потока медиа — аудио, установите это значение в 48000 или 96000.

Description -> (строка)

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

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

Уникальный идентификатор потока медиа.

MediaStreamName -> (строка)

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

MediaStreamType -> (строка)

Тип потока медиа.

VideoFormat -> (строка)

Разрешение видео.

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

Attributes={Fmtp={ChannelOrder=string,Colorimetry=string,ExactFramerate=string,Par=string,Range=string,ScanMode=string,Tcs=string},Lang=string},ClockRate=integer,Description=string,MediaStreamId=integer,MediaStreamName=string,MediaStreamType=string,VideoFormat=string ...

Синтаксис JSON:

[
  {
    "Attributes": {
      "Fmtp": {
        "ChannelOrder": "string",
        "Colorimetry": "BT601"|"BT709"|"BT2020"|"BT2100"|"ST2065-1"|"ST2065-3"|"XYZ",
        "ExactFramerate": "string",
        "Par": "string",
        "Range": "NARROW"|"FULL"|"FULLPROTECT",
        "ScanMode": "progressive"|"interlace"|"progressive-segmented-frame",
        "Tcs": "SDR"|"PQ"|"HLG"|"LINEAR"|"BT2100LINPQ"|"BT2100LINHLG"|"ST2065-1"|"ST428-1"|"DENSITY"
      },
      "Lang": "string"
    },
    "ClockRate": integer,
    "Description": "string",
    "MediaStreamId": integer,
    "MediaStreamName": "string",
    "MediaStreamType": "video"|"audio"|"ancillary-data",
    "VideoFormat": "string"
  }
  ...
]

--name (строка)

Имя потока.

--outputs (список)

Выходные данные, которые вы хотите добавить в этот поток.

(структура)

Запрос на добавление выходного порта в поток.

CidrAllowList -> (список)

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

(строка)

Description -> (строка)

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

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

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

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

MediaStreamOutputConfigurations -> (список)

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

(структура)

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

DestinationConfigurations -> (список)

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

(структура)

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

DestinationIp -> (строка)

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

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

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

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

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

Name -> (строка)

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

EncodingName -> (строка)

Формат, который будет использоваться для кодирования данных. Для вспомогательных потоков данных установите имя кодирования в smpte291. Для аудиопотоков установите имя кодирования в pcm. Для видеопотоков 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 -> (строка)

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

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

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

Name -> (строка)

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

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

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

Protocol -> (строка)

Протокол, который нужно использовать для выходного порта.

Примечание

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

RemoteId -> (строка)

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

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

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

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

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

StreamId -> (строка)

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

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

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

VpcInterfaceName -> (строка)

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

OutputStatus -> (строка)

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

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

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

NdiProgramName -> (строка)

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

Синтаксис JSON:

[
  {
    "CidrAllowList": ["string", ...],
    "Description": "string",
    "Destination": "string",
    "Encryption": {
      "Algorithm": "aes128"|"aes192"|"aes256",
      "ConstantInitializationVector": "string",
      "DeviceId": "string",
      "KeyType": "speke"|"static-key"|"srt-password",
      "Region": "string",
      "ResourceId": "string",
      "RoleArn": "string",
      "SecretArn": "string",
      "Url": "string"
    },
    "MaxLatency": integer,
    "MediaStreamOutputConfigurations": [
      {
        "DestinationConfigurations": [
          {
            "DestinationIp": "string",
            "DestinationPort": integer,
            "Interface": {
              "Name": "string"
            }
          }
          ...
        ],
        "EncodingName": "jxsv"|"raw"|"smpte291"|"pcm",
        "EncodingParameters": {
          "CompressionFactor": double,
          "EncoderProfile": "main"|"high"
        },
        "MediaStreamName": "string"
      }
      ...
    ],
    "MinLatency": integer,
    "Name": "string",
    "Port": integer,
    "Protocol": "zixi-push"|"rtp-fec"|"rtp"|"zixi-pull"|"rist"|"st2110-jpegxs"|"cdi"|"srt-listener"|"srt-caller"|"fujitsu-qos"|"udp"|"ndi-speed-hq",
    "RemoteId": "string",
    "SenderControlPort": integer,
    "SmoothingLatency": integer,
    "StreamId": "string",
    "VpcInterfaceAttachment": {
      "VpcInterfaceName": "string"
    },
    "OutputStatus": "ENABLED"|"DISABLED",
    "NdiSpeedHqQuality": integer,
    "NdiProgramName": "string"
  }
  ...
]

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

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

Шифрование -> (структура)

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

Алгоритм -> (строка)

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

ConstantInitializationVector -> (строка)

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

DeviceId -> (строка)

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

KeyType -> (строка)

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

Регион -> (строка)

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

ResourceId -> (строка)

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

RoleArn -> (строка)

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

SecretArn -> (строка)

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

Url -> (строка)

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

Описание -> (строка)

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

EntitlementArn -> (строка)

ARN разрешения, которое позволяет вам подписаться на этот поток. Разрешение устанавливается инициатором потока, а ARN генерируется в рамках потока инициатора.

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

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

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

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

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

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

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

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

MediaStreamSourceConfigurations -> (список)

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

(структура)

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

EncodingName -> (строка)

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

InputConfigurations -> (список)

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

(структура)

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

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

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

Интерфейс -> (структура)

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

Имя -> (строка)

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

MediaStreamName -> (строка)

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

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

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

Имя -> (строка)

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

Протокол -> (строка)

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

Примечание

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

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

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

SenderIpAddress -> (строка)

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

SourceListenerAddress -> (строка)

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

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

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

StreamId -> (строка)

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

VpcInterfaceName -> (строка)

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

WhitelistCidr -> (строка)

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

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

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

BridgeArn -> (строка)

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

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

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

VpcInterfaceName -> (строка)

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

Синтаксис JSON:

{
  "Decryption": {
    "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": "string",
  "EntitlementArn": "string",
  "IngestPort": integer,
  "MaxBitrate": integer,
  "MaxLatency": integer,
  "MaxSyncBuffer": integer,
  "MediaStreamSourceConfigurations": [
    {
      "EncodingName": "jxsv"|"raw"|"smpte291"|"pcm",
      "InputConfigurations": [
        {
          "InputPort": integer,
          "Interface": {
            "Name": "string"
          }
        }
        ...
      ],
      "MediaStreamName": "string"
    }
    ...
  ],
  "MinLatency": integer,
  "Name": "string",
  "Protocol": "zixi-push"|"rtp-fec"|"rtp"|"zixi-pull"|"rist"|"st2110-jpegxs"|"cdi"|"srt-listener"|"srt-caller"|"fujitsu-qos"|"udp"|"ndi-speed-hq",
  "SenderControlPort": integer,
  "SenderIpAddress": "string",
  "SourceListenerAddress": "string",
  "SourceListenerPort": integer,
  "StreamId": "string",
  "VpcInterfaceName": "string",
  "WhitelistCidr": "string",
  "GatewayBridgeSource": {
    "BridgeArn": "string",
    "VpcInterfaceAttachment": {
      "VpcInterfaceName": "string"
    }
  }
}

--source-failover-config (структура)

Настройки для резервного копирования источника.

FailoverMode -> (строка)

Тип резервного копирования, который вы выбираете для этого потока. MERGE объединяет потоки источника в один поток, что позволяет плавно восстанавливаться при потере любого одного источника. FAILOVER позволяет переключаться между различными потоками.

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

Время окна поиска для поиска пакетов dash-7.

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

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

PrimarySource -> (строка)

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

Состояние -> (строка)

Состояние резервного копирования источника в потоке. Если состояние неактивно, поток может иметь только один источник. Если состояние активно, поток может иметь один или два источника.

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

FailoverMode=string,RecoveryWindow=integer,SourcePriority={PrimarySource=string},State=string

Синтаксис JSON:

{
  "FailoverMode": "MERGE"|"FAILOVER",
  "RecoveryWindow": integer,
  "SourcePriority": {
    "PrimarySource": "string"
  },
  "State": "ENABLED"|"DISABLED"
}

--sources (список)

Источники, назначенные потоку.

(структура)

Настройки источника потока.

Расшифровка -> (структура)

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

Алгоритм -> (строка)

Тип алгоритма, используемого для шифрования (например, 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 права доступа, позволяющего вам подписаться на этот поток. Право доступа устанавливается автором потока, а ARN генерируется в рамках потока автора.

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

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

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

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

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

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

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

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

MediaStreamSourceConfigurations -> (список)

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

(структура)

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

EncodingName -> (строка)

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

InputConfigurations -> (список)

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

(структура)

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

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

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

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

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

Name -> (строка)

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

MediaStreamName -> (строка)

Имя мультимедийного потока.

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

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

Name -> (строка)

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

Protocol -> (строка)

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

Примечание

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

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

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

SenderIpAddress -> (строка)

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

SourceListenerAddress -> (строка)

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

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

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

StreamId -> (строка)

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

VpcInterfaceName -> (строка)

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

WhitelistCidr -> (строка)

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

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

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

BridgeArn -> (строка)

ARN моста, подающего этот поток.

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

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

VpcInterfaceName -> (строка)

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

Синтаксис JSON:

[
  {
    "Decryption": {
      "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": "string",
    "EntitlementArn": "string",
    "IngestPort": integer,
    "MaxBitrate": integer,
    "MaxLatency": integer,
    "MaxSyncBuffer": integer,
    "MediaStreamSourceConfigurations": [
      {
        "EncodingName": "jxsv"|"raw"|"smpte291"|"pcm",
        "InputConfigurations": [
          {
            "InputPort": integer,
            "Interface": {
              "Name": "string"
            }
          }
          ...
        ],
        "MediaStreamName": "string"
      }
      ...
    ],
    "MinLatency": integer,
    "Name": "string",
    "Protocol": "zixi-push"|"rtp-fec"|"rtp"|"zixi-pull"|"rist"|"st2110-jpegxs"|"cdi"|"srt-listener"|"srt-caller"|"fujitsu-qos"|"udp"|"ndi-speed-hq",
    "SenderControlPort": integer,
    "SenderIpAddress": "string",
    "SourceListenerAddress": "string",
    "SourceListenerPort": integer,
    "StreamId": "string",
    "VpcInterfaceName": "string",
    "WhitelistCidr": "string",
    "GatewayBridgeSource": {
      "BridgeArn": "string",
      "VpcInterfaceAttachment": {
        "VpcInterfaceName": "string"
      }
    }
  }
  ...
]

--vpc-interfaces (список)

Интерфейсы VPC, которые вы хотите в потоке.

(структура)

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

Name -> (строка)

Имя интерфейса VPC. Это имя должно быть уникальным в рамках потока.

NetworkInterfaceType -> (строка)

Тип сетевого интерфейса.

RoleArn -> (строка)

Amazon Resource Name (ARN) роли, которую вы создали при настройке MediaConnect в качестве доверенной службы.

SecurityGroupIds -> (список)

Виртуальный брандмауэр для управления входящим и исходящим трафиком.

(строка)

SubnetId -> (строка)

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

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

Name=string,NetworkInterfaceType=string,RoleArn=string,SecurityGroupIds=string,string,SubnetId=string ...

Синтаксис JSON:

[
  {
    "Name": "string",
    "NetworkInterfaceType": "ena"|"efa",
    "RoleArn": "string",
    "SecurityGroupIds": ["string", ...],
    "SubnetId": "string"
  }
  ...
]

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

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

MaintenanceDay -> (строка)

День недели, когда произойдёт техническое обслуживание.

MaintenanceStartHour -> (строка)

Время UTC, когда произойдёт техническое обслуживание.

Используйте 24-часовой формат ЧЧ:ММ.

Минуты должны быть 00.

Пример: 13:00.

Значение по умолчанию: 02:00.

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

MaintenanceDay=string,MaintenanceStartHour=string

Синтаксис JSON:

{
  "MaintenanceDay": "Monday"|"Tuesday"|"Wednesday"|"Thursday"|"Friday"|"Saturday"|"Sunday",
  "MaintenanceStartHour": "string"
}

--source-monitoring-config (структура)

Настройки мониторинга источника.

ThumbnailState -> (строка)

Указывает, включены или отключены миниатюры.

AudioMonitoringSettings -> (список)

Содержит настройки мониторинга метрик аудиопотока.

(структура)

Указывает конфигурацию для мониторинга метрик аудиопотока.

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

Обнаруживает периоды тишины.

State -> (строка)

Указывает, включена или отключена метрика SilentAudio.

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

Указывает количество последовательных секунд тишины, которые запускают событие или предупреждение.

ContentQualityAnalysisState -> (строка)

Указывает, включен или отключен анализ качества содержимого.

VideoMonitoringSettings -> (список)

Содержит настройки мониторинга метрик видеопотока.

(структура)

Указывает конфигурацию для мониторинга метрик видеопотока.

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

Обнаруживает видеокадры, которые являются чёрными.

State -> (строка)

Указывает, включена или отключена метрика BlackFrames.

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

Указывает количество последовательных секунд чёрных кадров, которые запускают событие или предупреждение.

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

Обнаруживает видеокадры, которые не изменились.

State -> (строка)

Указывает, включена или отключена метрика FrozenFrames.

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

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

Синтаксис JSON:

{
  "ThumbnailState": "ENABLED"|"DISABLED",
  "AudioMonitoringSettings": [
    {
      "SilentAudio": {
        "State": "ENABLED"|"DISABLED",
        "ThresholdSeconds": integer
      }
    }
    ...
  ],
  "ContentQualityAnalysisState": "ENABLED"|"DISABLED",
  "VideoMonitoringSettings": [
    {
      "BlackFrames": {
        "State": "ENABLED"|"DISABLED",
        "ThresholdSeconds": integer
      },
      "FrozenFrames": {
        "State": "ENABLED"|"DISABLED",
        "ThresholdSeconds": integer
      }
    }
    ...
  ]
}

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

Определяет обрабатывающую способность и набор функций потока. Установите этот необязательный параметр в LARGE, если вы хотите включить выходы NDI в потоке.

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

MEDIUM
LARGE

--ndi-config (структура)

Указывает параметры конфигурации для выходов NDI. Требуется, если поток включает выходы NDI.

NdiState -> (строка)

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

MachineName -> (строка)

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

NdiDiscoveryServers -> (список)

Список из до трёх конфигураций серверов обнаружения NDI. Хотя не требуется API, эта конфигурация необходима для корректной работы функциональности NDI.

(структура)

Указывает параметры конфигурации для отдельных серверов обнаружения NDI. Разрешено не более 3 серверов.

DiscoveryServerAddress -> (строка)

Уникальный сетевой адрес сервера обнаружения NDI.

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

Порт сервера обнаружения NDI. По умолчанию 5959, если не указан пользовательский порт.

VpcInterfaceAdapter -> (строка)

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

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

NdiState=string,MachineName=string,NdiDiscoveryServers=[{DiscoveryServerAddress=string,DiscoveryServerPort=integer,VpcInterfaceAdapter=string},{DiscoveryServerAddress=string,DiscoveryServerPort=integer,VpcInterfaceAdapter=string}]

Синтаксис JSON:

{
  "NdiState": "ENABLED"|"DISABLED",
  "MachineName": "string",
  "NdiDiscoveryServers": [
    {
      "DiscoveryServerAddress": "string",
      "DiscoveryServerPort": integer,
      "VpcInterfaceAdapter": "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-flow пример создаёт поток с указанной конфигурацией.

aws mediaconnect create-flow \
    --availability-zone us-west-2c \
    --name ExampleFlow \
    --source Description='Example source, backup',IngestPort=1055,Name=BackupSource,Protocol=rtp,WhitelistCidr=10.24.34.0/23

Вывод:

{
    "Flow": {
        "FlowArn": "arn:aws:mediaconnect:us-east-1:123456789012:flow:1-23aBC45dEF67hiJ8-12AbC34DE5fG:ExampleFlow",
        "AvailabilityZone": "us-west-2c",
        "EgressIp": "54.245.71.21",
        "Source": {
            "IngestPort": 1055,
            "SourceArn": "arn:aws:mediaconnect:us-east-1:123456789012:source:2-3aBC45dEF67hiJ89-c34de5fG678h:BackupSource",
            "Transport": {
                "Protocol": "rtp",
                "MaxBitrate": 80000000
            },
            "Description": "Example source, backup",
            "IngestIp": "54.245.71.21",
            "WhitelistCidr": "10.24.34.0/23",
            "Name": "mySource"
        },
        "Entitlements": [],
        "Name": "ExampleFlow",
        "Outputs": [],
        "Status": "STANDBY",
        "Description": "Example source, backup"
    }
}

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

Вывод

Поток -> (структура)

Созданный вами поток.

AvailabilityZone -> (строка)

Описание -> (строка)

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

EgressIp -> (строка)

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

Права -> (список)

Права в этом потоке.

(структура)

Настройки прав потока.

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

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

Описание -> (строка)

Описание права.

Шифрование -> (структура)

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

Алгоритм -> (строка)

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

Постоянный вектор инициализации -> (строка)

DeviceId -> (строка)

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

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

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

Регион -> (строка)

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

ResourceId -> (строка)

RoleArn -> (строка)

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

SecretArn -> (строка)

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

Url -> (строка)

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

EntitlementArn -> (строка)

ARN права.

EntitlementStatus -> (строка)

Указание, включено ли право.

Имя -> (строка)

Имя права.

Подписчики -> (список)

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

(строка)

FlowArn -> (строка)

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

MediaStreams -> (список)

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

(структура)

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

Атрибуты -> (структура)

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

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

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

ChannelOrder -> (строка)

Формат аудиоканалов.

Colorimetry -> (строка)

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

ExactFramerate -> (строка)

Частота кадров для потока видео в кадрах/секунду. Например: 60000/1001.

Par -> (строка)

Соотношение сторон пикселей (PAR) видео.

Диапазон -> (строка)

Диапазон кодирования видео.

ScanMode -> (строка)

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

Tcs -> (строка)

Система характеристик передачи (TCS), используемая в видео.

Язык -> (строка)

Язык аудио в формате, распознаваемом приемником.

Частота -> (целое число)

Частота дискретизации потока. Это значение измеряется в Гц.

Описание -> (строка)

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

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

Номер типа формата (иногда называемый типом полезной нагрузки RTP) потока мультимедиа. MediaConnect назначает это значение потоку мультимедиа. Для выводов ST 2110 JPEG XS вам необходимо предоставить это значение приемнику.

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

Уникальный идентификатор потока мультимедиа.

MediaStreamName -> (строка)

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

ТипMediaStream -> (строка)

Тип потока мультимедиа.

ВидеоФормат -> (строка)

Разрешение видео.

Имя -> (строка)

Имя потока.

Выходы -> (список)

Выходные данные в этом потоке.

(структура)

Настройки для вывода.

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

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

Описание -> (строка)

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

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

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

Шифрование -> (структура)

Алгоритм -> (строка)

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

ConstantInitializationVector -> (строка)

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

DeviceId -> (строка)

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

KeyType -> (строка)

Регион -> (строка)

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

ResourceId -> (строка)

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

RoleArn -> (строка)

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

SecretArn -> (строка)

Url -> (строка)

URL из API-шлюза, который вы настроили для связи с вашим сервером ключей. Этот параметр обязателен для шифрования 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, который вы хотите использовать для потока медиа, связанного с выводом.

Имя -> (строка)

Название интерфейса 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.

Имя потока медиа -> (строка)

Название потока медиа.

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

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

OutputArn -> (строка)

ARN вывода.

Порт -> (целое число)

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

Транспорт -> (структура)

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

CidrAllowList -> (список)

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

(строка)

Максимальный битрейт -> (целое число)

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

Максимальная задержка -> (целое число)

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

Максимальный буфер синхронизации -> (целое число)

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

Минимальная задержка -> (целое число)

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

Протокол -> (строка)

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

Примечание

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

Удаленный идентификатор -> (строка)

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

Порт управления отправителем -> (целое число)

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

IP-адрес отправителя -> (строка)

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

Задержка сглаживания -> (целое число)

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

Адрес слушателя источника -> (строка)

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

Порт слушателя источника -> (целое число)

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

Идентификатор потока -> (строка)

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

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

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

NdiProgramName -> (строка)

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

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

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

VpcInterfaceName -> (строка)

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

BridgeArn -> (строка)

ARN моста, добавленного к этому выводу.

BridgePorts -> (список)

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

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

OutputStatus -> (строка)

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

Источник -> (структура)

Источник потока.

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

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

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

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

Algorithm -> (строка)

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

ConstantInitializationVector -> (строка)

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

DeviceId -> (строка)

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

KeyType -> (строка)

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

Region -> (строка)

ResourceId -> (строка)

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

RoleArn -> (строка)

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

SecretArn -> (строка)

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

Url -> (строка)

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

Description -> (строка)

EntitlementArn -> (строка)

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

IngestIp -> (строка)

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

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

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

MediaStreamSourceConfigurations -> (список)

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

(структура)

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

EncodingName -> (строка)

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

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

Примечание

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, используемого для этого ресурса.

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

Настройки резервного копирования источника.

FailoverMode -> (строка)

Тип резервного копирования, который вы выбираете для этого потока. MERGE объединяет потоки источника в один поток, что позволяет обеспечить плавное восстановление при потере одного источника. FAILOVER позволяет переключаться между разными потоками.

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

Время поиска окна для поиска пакетов dash-7.

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

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

PrimarySource -> (строка)

Имя источника, выбранного в качестве основного для этого потока.

State -> (строка)

Sources -> (список)

Настройки источников, назначенных потоку.

(структура)

Настройки источника потока.

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

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

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

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

Algorithm -> (строка)

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

ConstantInitializationVector -> (строка)

DeviceId -> (строка)

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

KeyType -> (строка)

Region -> (строка)

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

ResourceId -> (строка)

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

RoleArn -> (строка)

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

SecretArn -> (строка)

Url -> (строка)

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

Description -> (строка)

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 больше не поддерживает протокол QoS Fujitsu. Эта ссылка поддерживается только для целей обратной совместимости.

RemoteId -> (строка)

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

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

SenderIpAddress -> (строка)

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

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

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

SourceListenerAddress -> (строка)

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

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

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

StreamId -> (строка)

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

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

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

NdiProgramName -> (строка)

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

VpcInterfaceName -> (строка)

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

WhitelistCidr -> (строка)

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

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

BridgeArn -> (строка)

ARN моста, подающего этот поток.

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

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

VpcInterfaceName -> (строка)

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

Status -> (строка)

Текущий статус потока.

VpcInterfaces -> (список)

Интерфейсы VPC для этого потока.

(структура)

Настройки источника VPC.

Name -> (строка)

Неизменяемое и должно быть уникальным по отношению к другим VpcInterfaces в этом потоке.

NetworkInterfaceIds -> (список)

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

(строка)

NetworkInterfaceType -> (строка)

Тип сетевого интерфейса.

RoleArn -> (строка)

ARN роли, которую MediaConnect может использовать для создания ENI в вашей учетной записи.

SecurityGroupIds -> (список)

Идентификаторы групп безопасности, которые будут использоваться на ENI.

(строка)

SubnetId -> (строка)

Подсеть должна находиться в той же зоне доступности (AZ), что и поток.

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

Настройки обслуживания для потока.

MaintenanceDay -> (строка)

День недели, когда произойдет техническое обслуживание. Используйте Monday/Tuesday/Wednesday/Thursday/Friday/Saturday/Sunday.

MaintenanceDeadline -> (строка)

Техническое обслуживание должно быть выполнено до этого срока в формате UTC ISO. Пример: 2021-01-30T08:30:00Z.

MaintenanceScheduledDate -> (строка)

Дата запланированного технического обслуживания в формате UTC ISO. Используйте формат YYYY-MM-DD. Пример: 2021-01-30.

MaintenanceStartHour -> (строка)

Время начала технического обслуживания в формате UTC. Используйте формат 24-часовых часов HH:MM. Минуты должны быть 00. Пример: 13:00. Значение по умолчанию — 02:00.

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

Настройки мониторинга источника.

ThumbnailState -> (строка)

Указывает, включены или отключены миниатюры.

AudioMonitoringSettings -> (список)

Содержит настройки мониторинга метрик аудиопотока.

(структура)

Определяет конфигурацию мониторинга метрик аудиопотока.

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

Обнаруживает периоды беззвучия.

State -> (строка)

Указывает, включена или отключена метрика SilentAudio.

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

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

ContentQualityAnalysisState -> (строка)

Указывает, включен или выключен анализ качества контента.

VideoMonitoringSettings -> (список)

Содержит настройки мониторинга метрик видеопотока.

(структура)

Определяет конфигурацию мониторинга метрик видеопотока.

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

Обнаруживает кадры видео, которые являются чёрными.

State -> (строка)

Указывает, включена или отключена метрика BlackFrames.

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

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

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

Обнаруживает кадры видео, которые не изменились.

State -> (строка)

Указывает, включена или отключена метрика FrozenFrames.

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

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

FlowSize -> (строка)

Определяет вычислительную мощность и набор функций потока. Установите этот необязательный параметр в LARGE, если вы хотите включить NDI выводы в потоке.

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

Указывает параметры конфигурации выходов NDI. Требуется, если поток включает выходы NDI.

NdiState -> (строка)

Настройка, определяющая возможность использования выходов NDI в потоке. Должно быть установлено значение ENABLED для добавления выходов NDI. По умолчанию значение DISABLED.

MachineName -> (строка)

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

NdiDiscoveryServers -> (список)

Список из до трёх конфигураций серверов обнаружения NDI. Хотя API не требует этого, эта конфигурация необходима для корректной работы функциональности NDI.

(структура)

Указывает параметры конфигурации отдельных серверов обнаружения NDI. Допускается максимум 3 сервера.

DiscoveryServerAddress -> (строка)

Уникальный сетевой адрес сервера обнаружения NDI.

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

Порт сервера обнаружения NDI. По умолчанию равен 5959, если пользовательский порт не указан.

VpcInterfaceAdapter -> (строка)

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

END_OF_DOCUMENT_MARKER