[ aws . mediaconnect ]
describe-flow
Описание
Отображает подробную информацию о потоке. Ответ включает Amazon Resource Name (ARN), имя и зону доступности потока, а также данные о источнике, выходах и правах доступа.
См. также: Документация AWS API
Синтаксис
describe-flow
--flow-arn <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]
Параметры
--flow-arn (строка)
--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.
Для просмотра подробностей о потоке
Следующий describe-flow пример отображает подробности указанного потока, такие как ARN, зона доступности, состояние, источник, права доступа и выходы.
aws mediaconnect describe-flow \
--flow-arn arn:aws:mediaconnect:us-east-1:123456789012:flow:1-23aBC45dEF67hiJ8-12AbC34DE5fG:AwardsShow
Вывод:
{
"Flow": {
"EgressIp": "54.201.4.39",
"AvailabilityZone": "us-west-2c",
"Status": "ACTIVE",
"FlowArn": "arn:aws:mediaconnect:us-east-1:123456789012:flow:1-23aBC45dEF67hiJ8-12AbC34DE5fG:AwardsShow",
"Entitlements": [
{
"EntitlementArn": "arn:aws:mediaconnect:us-west-2:123456789012:entitlement:1-AaBb11CcDd22EeFf-34DE5fG12AbC:MyEntitlement",
"Description": "Assign to this account",
"Name": "MyEntitlement",
"Subscribers": [
"444455556666"
]
}
],
"Description": "NYC awards show",
"Name": "AwardsShow",
"Outputs": [
{
"Port": 2355,
"Name": "NYC",
"Transport": {
"SmoothingLatency": 0,
"Protocol": "rtp-fec"
},
"OutputArn": "arn:aws:mediaconnect:us-east-1:123456789012:output:2-3aBC45dEF67hiJ89-c34de5fG678h:NYC",
"Destination": "192.0.2.0"
},
{
"Port": 3025,
"Name": "LA",
"Transport": {
"SmoothingLatency": 0,
"Protocol": "rtp-fec"
},
"OutputArn": "arn:aws:mediaconnect:us-east-1:123456789012:output:2-987655dEF67hiJ89-c34de5fG678h:LA",
"Destination": "192.0.2.0"
}
],
"Source": {
"IngestIp": "54.201.4.39",
"SourceArn": "arn:aws:mediaconnect:us-east-1:123456789012:source:3-4aBC56dEF78hiJ90-4de5fG6Hi78Jk:ShowSource",
"Transport": {
"MaxBitrate": 80000000,
"Protocol": "rtp"
},
"IngestPort": 1069,
"Description": "Saturday night show",
"Name": "ShowSource",
"WhitelistCidr": "10.24.34.0/23"
}
}
}
Дополнительную информацию см. в разделе «Просмотр подробностей потока» в руководстве пользователя AWS Elemental MediaConnect.
Вывод
Поток -> (структура)
Поток, для которого запрашивалось описание.
AvailabilityZone -> (строка)
Описание -> (строка)
EgressIp -> (строка)
Права доступа -> (список)
Права доступа в этом потоке.
(структура)
Настройки права доступа к потоку.
DataTransferSubscriberFeePercent -> (целое число)
Описание -> (строка)
Шифрование -> (структура)
Тип шифрования, который будет использоваться для вывода, связанного с этим правом доступа.
Алгоритм -> (строка)
ConstantInitializationVector -> (строка)
DeviceId -> (строка)
KeyType -> (строка)
Регион -> (строка)
ResourceId -> (строка)
RoleArn -> (строка)
SecretArn -> (строка)
Url -> (строка)
EntitlementArn -> (строка)
EntitlementStatus -> (строка)
Имя -> (строка)
Подписчики -> (список)
Идентификаторы учетных записей Amazon Web Services, с которыми вы хотите поделиться своим контентом. Получающим учетным записям (подписчикам) будет разрешено создавать свои потоки, используя ваш контент в качестве источника.
(строка)
FlowArn -> (строка)
MediaStreams -> (список)
Потоки мультимедиа, связанные с потоком. После того, как вы связали поток мультимедиа с источником, вы также можете связать его с выходами в потоке.
(структура)
Поток мультимедиа представляет собой один компонент вашего контента, например, видео, аудио или вспомогательные данные. После добавления потока мультимедиа в поток вы можете связать его с источниками и выходами, использующими протокол ST 2110 JPEG XS или CDI.
Атрибуты -> (структура)
Атрибуты, связанные с потоком мультимедиа.
Fmtp -> (структура)
Настройки, которые вы хотите использовать для определения потока мультимедиа.
ChannelOrder -> (строка)
Colorimetry -> (строка)
ExactFramerate -> (строка)
Par -> (строка)
Диапазон -> (строка)
ScanMode -> (строка)
Tcs -> (строка)
Lang -> (строка)
ClockRate -> (целое число)
Описание -> (строка)
Fmt -> (целое число)
MediaStreamId -> (целое число)
MediaStreamName -> (строка)
MediaStreamType -> (строка)
VideoFormat -> (строка)
Имя -> (строка)
Выходы -> (список)
Выходные данные в этом потоке.
(структура)
Настройки вывода.
DataTransferSubscriberFeePercent -> (целое число)
Description -> (строка)
Destination -> (строка)
Encryption -> (структура)
Тип ключа, используемого для шифрования. Если keyType не указан, служба использует значение по умолчанию (static-key).
Algorithm -> (строка)
ConstantInitializationVector -> (строка)
DeviceId -> (строка)
KeyType -> (строка)
Region -> (строка)
ResourceId -> (строка)
RoleArn -> (строка)
SecretArn -> (строка)
Url -> (строка)
EntitlementArn -> (строка)
ListenerAddress -> (строка)
MediaLiveInputArn -> (строка)
MediaStreamOutputConfigurations -> (список)
Настройка для каждого потока медиа, связанного с выводом.
(структура)
Поток медиа, связанный с выводом, и параметры этого связывания.
DestinationConfigurations -> (список)
Параметры передачи, связанные с каждым исходящим потоком медиа.
(структура)
Параметры передачи, которые нужно связать с исходящим потоком медиа.
DestinationIp -> (строка)
DestinationPort -> (целое число)
Interface -> (структура)
Интерфейс VPC, который нужно использовать для потока медиа, связанного с выводом.
Name -> (строка)
OutboundIp -> (строка)
EncodingName -> (строка)
EncodingParameters -> (структура)
Набор параметров, определяющих, как MediaConnect преобразует контент. Эти поля применимы только к выводам в потоках, имеющих источник CDI.
CompressionFactor -> (двойное число)
EncoderProfile -> (строка)
MediaStreamName -> (строка)
Name -> (строка)
OutputArn -> (строка)
Port -> (целое число)
Transport -> (структура)
Атрибуты, относящиеся к потоку передачи, используемому в выводе.
CidrAllowList -> (список)
Диапазон IP-адресов, которые должны быть разрешены для инициирования запросов вывода в этот поток. Эти IP-адреса должны быть в формате CIDR; например, 10.0.0.0/16
(строка)
MaxBitrate -> (целое число)
MaxLatency -> (целое число)
MaxSyncBuffer -> (целое число)
MinLatency -> (целое число)
Protocol -> (строка)
Протокол, используемый источником или выводом.
Примечание
Elemental MediaConnect больше не поддерживает протокол Fujitsu QoS. Эта ссылка сохраняется только для обратной совместимости.RemoteId -> (строка)
SenderControlPort -> (целое число)
SenderIpAddress -> (строка)
SmoothingLatency -> (целое число)
SourceListenerAddress -> (строка)
SourceListenerPort -> (целое число)
StreamId -> (строка)
NdiSpeedHqQuality -> (целое число)
NdiProgramName -> (строка)
VpcInterfaceAttachment -> (структура)
Имя прикрепления интерфейса VPC, которое нужно использовать для этого вывода.
VpcInterfaceName -> (строка)
BridgeArn -> (строка)
BridgePorts -> (список)
Порты моста, которые в настоящее время используются.
(целое число)
OutputStatus -> (строка)
Source -> (структура)
Источник потока.
DataTransferSubscriberFeePercent -> (целое число)
Decryption -> (структура)
Тип шифрования, используемый для содержимого, поступающего из этого источника.
Algorithm -> (строка)
ConstantInitializationVector -> (строка)
DeviceId -> (строка)
KeyType -> (строка)
Region -> (строка)
ResourceId -> (строка)
RoleArn -> (строка)
SecretArn -> (строка)
Url -> (строка)
Description -> (строка)
EntitlementArn -> (строка)
IngestIp -> (строка)
IngestPort -> (целое число)
MediaStreamSourceConfigurations -> (список)
Потоки медиа, связанные с источником, и параметры этих связей.
(структура)
Поток медиа, связанный с источником, и параметры этой связи.
EncodingName -> (строка)
InputConfigurations -> (список)
Потоки медиа, которые вы хотите связать с источником.
(структура)
Параметры транспорта, связанные с входящим потоком медиа.
InputIp -> (строка)
InputPort -> (целое число)
Interface -> (структура)
Интерфейс VPC, через который поступает поток медиа.
Name -> (строка)
MediaStreamName -> (строка)
Name -> (строка)
SenderControlPort -> (целое число)
SenderIpAddress -> (строка)
SourceArn -> (строка)
Transport -> (структура)
Атрибуты, связанные с потоком транспорта, используемые в источнике.
CidrAllowList -> (список)
Диапазон IP-адресов, которым разрешено инициировать запросы вывода в этот поток. Эти IP-адреса должны быть в формате блока CIDR; например, 10.0.0.0/16
(строка)
MaxBitrate -> (целое число)
MaxLatency -> (целое число)
MaxSyncBuffer -> (целое число)
MinLatency -> (целое число)
Protocol -> (строка)
Протокол, используемый источником или выводом.
Примечание
Elemental MediaConnect больше не поддерживает протокол Fujitsu QoS. Эта справка поддерживается только для целей совместимости со старыми версиями.RemoteId -> (строка)
SenderControlPort -> (целое число)
SenderIpAddress -> (строка)
SmoothingLatency -> (целое число)
SourceListenerAddress -> (строка)
SourceListenerPort -> (целое число)
StreamId -> (строка)
NdiSpeedHqQuality -> (целое число)
NdiProgramName -> (строка)
VpcInterfaceName -> (строка)
WhitelistCidr -> (строка)
GatewayBridgeSource -> (структура)
Настройка источника для облачных потоков, получающих поток от моста.
BridgeArn -> (строка)
VpcInterfaceAttachment -> (структура)
Имя присоединения интерфейса VPC, используемого для этого источника моста.
VpcInterfaceName -> (строка)
SourceFailoverConfig -> (структура)
Настройки для резервного копирования источника.
FailoverMode -> (строка)
RecoveryWindow -> (целое число)
SourcePriority -> (структура)
Приоритет, который вы хотите назначить источнику. Вы можете иметь первичный поток и резервный поток или два потока с одинаковым приоритетом.
PrimarySource -> (строка)
State -> (строка)
Sources -> (список)
Настройки источников, назначенных потоку.
(структура)
Настройки источника потока.
DataTransferSubscriberFeePercent -> (целое число)
Decryption -> (структура)
Тип шифрования, используемый для контента, полученного из этого источника.
Algorithm -> (строка)
ConstantInitializationVector -> (строка)
DeviceId -> (строка)
KeyType -> (строка)
Region -> (строка)
ResourceId -> (строка)
RoleArn -> (строка)
SecretArn -> (строка)
Url -> (строка)
Description -> (строка)
EntitlementArn -> (строка)
IngestIp -> (строка)
IngestPort -> (целое число)
MediaStreamSourceConfigurations -> (список)
Мультимедийные потоки, связанные с источником, и параметры этих связей.
(структура)
Мультимедийный поток, связанный с источником, и параметры этой связи.
EncodingName -> (строка)
InputConfigurations -> (список)
Мультимедийные потоки, которые вы хотите связать с источником.
(структура)
Параметры передачи, связанные с входящим мультимедийным потоком.
InputIp -> (строка)
InputPort -> (целое число)
Interface -> (структура)
Интерфейс VPC, откуда поступает мультимедийный поток.
Name -> (строка)
MediaStreamName -> (строка)
Name -> (строка)
SenderControlPort -> (целое число)
SenderIpAddress -> (строка)
SourceArn -> (строка)
Transport -> (структура)
Атрибуты, относящиеся к потоку передачи, используемому в источнике.
CidrAllowList -> (список)
Диапазон IP-адресов, которые должны быть разрешены для инициирования запросов вывода в этот поток. Эти IP-адреса должны быть в формате блока CIDR (Classless Inter-Domain Routing); например, 10.0.0.0/16
(строка)
MaxBitrate -> (целое число)
MaxLatency -> (целое число)
MaxSyncBuffer -> (целое число)
MinLatency -> (целое число)
Protocol -> (строка)
Протокол, используемый источником или выводом.
Примечание
Elemental MediaConnect больше не поддерживает протокол Fujitsu QoS. Эта ссылка сохраняется только для целей обратной совместимости.RemoteId -> (строка)
SenderControlPort -> (целое число)
SenderIpAddress -> (строка)
SmoothingLatency -> (целое число)
SourceListenerAddress -> (строка)
SourceListenerPort -> (целое число)
StreamId -> (строка)
NdiSpeedHqQuality -> (целое число)
NdiProgramName -> (строка)
VpcInterfaceName -> (строка)
WhitelistCidr -> (строка)
GatewayBridgeSource -> (структура)
Настройки источника для облачных потоков, получающих поток с моста.
BridgeArn -> (строка)
VpcInterfaceAttachment -> (структура)
Имя подключения интерфейса VPC для использования с этим источником моста.
VpcInterfaceName -> (строка)
Status -> (строка)
VpcInterfaces -> (список)
Интерфейсы VPC для этого потока.
(структура)
Настройки источника VPC.
Name -> (строка)
NetworkInterfaceIds -> (список)
Идентификаторы сетевых интерфейсов, созданных в учетной записи клиента MediaConnect.
(строка)
NetworkInterfaceType -> (строка)
RoleArn -> (строка)
SecurityGroupIds -> (список)
Идентификаторы групп безопасности, которые будут использоваться на сетевом интерфейсе.
(строка)
SubnetId -> (строка)
Maintenance -> (структура)
Настройки обслуживания потока.
MaintenanceDay -> (строка)
MaintenanceDeadline -> (строка)
MaintenanceScheduledDate -> (строка)
MaintenanceStartHour -> (строка)
SourceMonitoringConfig -> (структура)
Настройки мониторинга источника.
ThumbnailState -> (строка)
AudioMonitoringSettings -> (список)
Содержит настройки мониторинга метрик аудиопотока.
(структура)
Указывает конфигурацию для мониторинга метрик аудиопотока.
SilentAudio -> (структура)
Обнаруживает периоды тишины.
State -> (строка)
SilentAudio.ThresholdSeconds -> (целое число)
ContentQualityAnalysisState -> (строка)
VideoMonitoringSettings -> (список)
Содержит настройки мониторинга метрик видеопотока.
(структура)
Указывает конфигурацию для мониторинга метрик видеопотока.
BlackFrames -> (структура)
Обнаруживает видеокадры, которые являются черными.
State -> (строка)
BlackFrames.ThresholdSeconds -> (целое число)
FrozenFrames -> (структура)
Обнаруживает видеокадры, которые не изменились.
State -> (строка)
FrozenFrames.ThresholdSeconds -> (целое число)
FlowSize -> (строка)
NdiConfig -> (структура)
Указывает параметры конфигурации выходов NDI. Требуется, когда поток включает выходы NDI.
NdiState -> (строка)
MachineName -> (строка)
NdiDiscoveryServers -> (список)
Список до трёх конфигураций серверов обнаружения NDI. Хотя API этого не требует, такая настройка необходима для корректной работы функциональности NDI.
(структура)
Указывает параметры конфигурации отдельных серверов обнаружения NDI. Разрешено не более 3 серверов.
DiscoveryServerAddress -> (строка)
DiscoveryServerPort -> (целое число)
VpcInterfaceAdapter -> (строка)
Messages -> (структура)
Любые ошибки, которые в настоящее время применимы к потоку. Если ошибок нет, MediaConnect не включит это поле в ответ.
Errors -> (список)
Список ошибок, которые могли быть сгенерированы процессами в этом потоке.
(строка)
© Copyright 2025, Amazon Web Services. Created using Sphinx.