AWS cli documentation change
Summary
Updated AWS CLI version reference from 2.33.8 to 2.33.12. Added new --encoding-config parameter for NDI® source transcoding. Enhanced NDI® documentation including source settings, maintenance options, and output configurations. Updated Secrets Manager references by removing 'AWS' prefix. Added new LARGE_4X maintenance option and clarified NDI® enablement requirements.
Security assessment
The changes primarily involve feature enhancements for NDI® sources/outputs and documentation updates. While transit encryption using Secrets Manager is mentioned, these are minor wording changes ('AWS Secrets Manager' to 'Secrets Manager') without new security guidance. No vulnerabilities, exploits, or security weaknesses are addressed.
Diff
diff --git a/cli/latest/reference/mediaconnect/create-flow.md b/cli/latest/reference/mediaconnect/create-flow.md index f6671d0b7..cc2da9c77 100644 --- a//cli/latest/reference/mediaconnect/create-flow.md +++ b//cli/latest/reference/mediaconnect/create-flow.md @@ -15 +15 @@ - * [AWS CLI 2.33.8 Command Reference](../../index.html) » + * [AWS CLI 2.33.12 Command Reference](../../index.html) » @@ -80,0 +81 @@ See also: [AWS API Documentation](https://docs.aws.amazon.com/goto/WebAPI/mediac + [--encoding-config <value>] @@ -643 +644 @@ JSON Syntax: ->>> A suffix for the names of the NDI sources that the flow creates. If a custom name isn’t specified, MediaConnect uses the output name. +>>> A suffix for the name of the NDI® sender that the flow creates. If a custom name isn’t specified, MediaConnect uses the output name. @@ -689 +690 @@ JSON Syntax: ->>>>> The configuration settings for transit encryption using AWS Secrets Manager, including the secret ARN and role ARN. +>>>>> The configuration settings for transit encryption using Secrets Manager, including the secret ARN and role ARN. @@ -693 +694 @@ JSON Syntax: ->>>>>> The ARN of the AWS Secrets Manager secret used for transit encryption. +>>>>>> The ARN of the Secrets Manager secret used for transit encryption. @@ -703 +704 @@ JSON Syntax: ->>>>>> The ARN of the IAM role assumed by MediaConnect to access the AWS Secrets Manager secret. +>>>>>> The ARN of the IAM role assumed by MediaConnect to access the Secrets Manager secret. @@ -1007,0 +1009,8 @@ JSON Syntax: +> NdiSourceSettings -> (structure) +> +>> The settings for the NDI® source. This includes the exact name of the upstream NDI sender that you want to connect to your source. +>> +>> SourceName -> (string) +>> +>>> The exact name of an existing NDI sender that’s registered with your discovery server. If included, the format of this name must be `MACHINENAME (ProgramName)` . +> @@ -1052 +1061 @@ JSON Syntax: ->>>> The configuration settings for transit encryption using AWS Secrets Manager, including the secret ARN and role ARN. +>>>> The configuration settings for transit encryption using Secrets Manager, including the secret ARN and role ARN. @@ -1056 +1065 @@ JSON Syntax: ->>>>> The ARN of the AWS Secrets Manager secret used for transit encryption. +>>>>> The ARN of the Secrets Manager secret used for transit encryption. @@ -1066 +1075 @@ JSON Syntax: ->>>>> The ARN of the IAM role assumed by MediaConnect to access the AWS Secrets Manager secret. +>>>>> The ARN of the IAM role assumed by MediaConnect to access the Secrets Manager secret. @@ -1130,0 +1140,3 @@ JSON Syntax: + "NdiSourceSettings": { + "SourceName": "string" + }, @@ -1427,0 +1440,8 @@ JSON Syntax: +>> NdiSourceSettings -> (structure) +>> +>>> The settings for the NDI® source. This includes the exact name of the upstream NDI sender that you want to connect to your source. +>>> +>>> SourceName -> (string) +>>> +>>>> The exact name of an existing NDI sender that’s registered with your discovery server. If included, the format of this name must be `MACHINENAME (ProgramName)` . +>> @@ -1472 +1492 @@ JSON Syntax: ->>>>> The configuration settings for transit encryption using AWS Secrets Manager, including the secret ARN and role ARN. +>>>>> The configuration settings for transit encryption using Secrets Manager, including the secret ARN and role ARN. @@ -1476 +1496 @@ JSON Syntax: ->>>>>> The ARN of the AWS Secrets Manager secret used for transit encryption. +>>>>>> The ARN of the Secrets Manager secret used for transit encryption. @@ -1486 +1506 @@ JSON Syntax: ->>>>>> The ARN of the IAM role assumed by MediaConnect to access the AWS Secrets Manager secret. +>>>>>> The ARN of the IAM role assumed by MediaConnect to access the Secrets Manager secret. @@ -1551,0 +1572,3 @@ JSON Syntax: + "NdiSourceSettings": { + "SourceName": "string" + }, @@ -1819 +1842 @@ JSON Syntax: -> Determines the processing capacity and feature set of the flow. Set this optional parameter to `LARGE` if you want to enable NDI outputs on the flow. +> Determines the processing capacity and feature set of the flow. Set this optional parameter to `LARGE` if you want to enable NDI sources or outputs on the flow. @@ -1824,0 +1848 @@ JSON Syntax: +> * `LARGE_4X` @@ -1830 +1854 @@ JSON Syntax: -> Specifies the configuration settings for NDI outputs. Required when the flow includes NDI outputs. +> Specifies the configuration settings for a flow’s NDI source or output. Required when the flow includes an NDI source or output. @@ -1834 +1858,3 @@ JSON Syntax: ->> A setting that controls whether NDI outputs can be used in the flow. Must be ENABLED to add NDI outputs. Default is DISABLED. +>> A setting that controls whether NDI® sources or outputs can be used in the flow. +>> +>> The default value is `DISABLED` . This value must be set as `ENABLED` for your flow to support NDI sources or outputs. @@ -1853 +1879 @@ JSON Syntax: ->>> Specifies the configuration settings for individual NDI discovery servers. A maximum of 3 servers is allowed. +>>> Specifies the configuration settings for individual NDI® discovery servers. A maximum of 3 servers is allowed. @@ -1889,0 +1916,36 @@ JSON Syntax: +`--encoding-config` (structure) + +> The encoding configuration to apply to the NDI® source when transcoding it to a transport stream for downstream distribution. You can choose between several predefined encoding profiles based on common use cases. +> +> EncodingProfile -> (string) +> +>> The encoding profile to use when transcoding the NDI source content to a transport stream. You can change this value while the flow is running. +>> +>> Possible values: +>> +>> * `DISTRIBUTION_H264_DEFAULT` +>> * `CONTRIBUTION_H264_DEFAULT` +>> + +> +> VideoMaxBitrate -> (integer) +> +>> The maximum video bitrate to use when transcoding the NDI source to a transport stream. This parameter enables you to override the default video bitrate within the encoding profile’s supported range. +>> +>> The supported range is 10,000,000 - 50,000,000 bits per second (bps). If you don’t specify a value, MediaConnect uses the default value of 20,000,000 bps. + +Shorthand Syntax: + + + EncodingProfile=string,VideoMaxBitrate=integer + + +JSON Syntax: + + + { + "EncodingProfile": "DISTRIBUTION_H264_DEFAULT"|"CONTRIBUTION_H264_DEFAULT", + "VideoMaxBitrate": integer + } + + @@ -2564 +2626,9 @@ Flow -> (structure) ->>>>> A suffix for the names of the NDI sources that the flow creates. If a custom name isn’t specified, MediaConnect uses the output name. +>>>>> A suffix for the name of the NDI® sender that the flow creates. If a custom name isn’t specified, MediaConnect uses the output name. +>>>> +>>>> NdiSourceSettings -> (structure) +>>>> +>>>>> The settings for the NDI source. This includes the exact name of the upstream NDI sender that you want to connect to your source. +>>>>> +>>>>> SourceName -> (string) +>>>>> +>>>>>> The exact name of an existing NDI sender that’s registered with your discovery server. If included, the format of this name must be `MACHINENAME (ProgramName)` . @@ -2603 +2673 @@ Flow -> (structure) ->>>> * Peer IP addresses aren’t available for entitlements, managed MediaLive outputs, NDI outputs, and CDI/ST2110 outputs. +>>>> * Peer IP addresses aren’t available for entitlements, managed MediaLive outputs, NDI® sources and outputs, and CDI/ST2110 outputs. @@ -2644 +2714 @@ Flow -> (structure) ->>>>>> The configuration settings for transit encryption using AWS Secrets Manager, including the secret ARN and role ARN. +>>>>>> The configuration settings for transit encryption using Secrets Manager, including the secret ARN and role ARN. @@ -2648 +2718 @@ Flow -> (structure) ->>>>>>> The ARN of the AWS Secrets Manager secret used for transit encryption. +>>>>>>> The ARN of the Secrets Manager secret used for transit encryption. @@ -2658 +2728 @@ Flow -> (structure) ->>>>>>> The ARN of the IAM role assumed by MediaConnect to access the AWS Secrets Manager secret. +>>>>>>> The ARN of the IAM role assumed by MediaConnect to access the Secrets Manager secret. @@ -2904 +2974,9 @@ Flow -> (structure) ->>>> A suffix for the names of the NDI sources that the flow creates. If a custom name isn’t specified, MediaConnect uses the output name. +>>>> A suffix for the name of the NDI® sender that the flow creates. If a custom name isn’t specified, MediaConnect uses the output name. +>>> +>>> NdiSourceSettings -> (structure) +>>> +>>>> The settings for the NDI source. This includes the exact name of the upstream NDI sender that you want to connect to your source. +>>>> +>>>> SourceName -> (string) +>>>> +>>>>> The exact name of an existing NDI sender that’s registered with your discovery server. If included, the format of this name must be `MACHINENAME (ProgramName)` . @@ -2979 +3057 @@ Flow -> (structure) ->>>>> The configuration settings for transit encryption using AWS Secrets Manager, including the secret ARN and role ARN. +>>>>> The configuration settings for transit encryption using Secrets Manager, including the secret ARN and role ARN. @@ -2983 +3061 @@ Flow -> (structure) ->>>>>> The ARN of the AWS Secrets Manager secret used for transit encryption. +>>>>>> The ARN of the Secrets Manager secret used for transit encryption. @@ -2993 +3071 @@ Flow -> (structure) ->>>>>> The ARN of the IAM role assumed by MediaConnect to access the AWS Secrets Manager secret. +>>>>>> The ARN of the IAM role assumed by MediaConnect to access the Secrets Manager secret. @@ -3281 +3359,9 @@ Flow -> (structure) ->>>>> A suffix for the names of the NDI sources that the flow creates. If a custom name isn’t specified, MediaConnect uses the output name. +>>>>> A suffix for the name of the NDI® sender that the flow creates. If a custom name isn’t specified, MediaConnect uses the output name. +>>>> +>>>> NdiSourceSettings -> (structure) +>>>> +>>>>> The settings for the NDI source. This includes the exact name of the upstream NDI sender that you want to connect to your source. +>>>>> +>>>>> SourceName -> (string) +>>>>> +>>>>>> The exact name of an existing NDI sender that’s registered with your discovery server. If included, the format of this name must be `MACHINENAME (ProgramName)` . @@ -3356 +3442 @@ Flow -> (structure) ->>>>>> The configuration settings for transit encryption using AWS Secrets Manager, including the secret ARN and role ARN. +>>>>>> The configuration settings for transit encryption using Secrets Manager, including the secret ARN and role ARN. @@ -3360 +3446 @@ Flow -> (structure) ->>>>>>> The ARN of the AWS Secrets Manager secret used for transit encryption. +>>>>>>> The ARN of the Secrets Manager secret used for transit encryption. @@ -3370 +3456 @@ Flow -> (structure) ->>>>>>> The ARN of the IAM role assumed by MediaConnect to access the AWS Secrets Manager secret. +>>>>>>> The ARN of the IAM role assumed by MediaConnect to access the Secrets Manager secret. @@ -3578 +3664 @@ Flow -> (structure) ->> Determines the processing capacity and feature set of the flow. Set this optional parameter to LARGE if you want to enable NDI outputs on the flow. +>> Determines the processing capacity and feature set of the flow. @@ -3583,0 +3670 @@ Flow -> (structure) +>> * `LARGE_4X` @@ -3589 +3676 @@ Flow -> (structure) ->> Specifies the configuration settings for NDI outputs. Required when the flow includes NDI outputs. +>> Specifies the configuration settings for a flow’s NDI source or output. Required when the flow includes an NDI source or output. @@ -3593 +3680,3 @@ Flow -> (structure) ->>> A setting that controls whether NDI outputs can be used in the flow. Must be ENABLED to add NDI outputs. Default is DISABLED. +>>> A setting that controls whether NDI® sources or outputs can be used in the flow. +>>> +>>> The default value is `DISABLED` . This value must be set as `ENABLED` for your flow to support NDI sources or outputs. @@ -3612 +3701 @@ Flow -> (structure) ->>>> Specifies the configuration settings for individual NDI discovery servers. A maximum of 3 servers is allowed. +>>>> Specifies the configuration settings for individual NDI® discovery servers. A maximum of 3 servers is allowed. @@ -3624,0 +3714,21 @@ Flow -> (structure) +> +> EncodingConfig -> (structure)