aws-cdk.aws-ivs-alpha 2.158.0a0__py3-none-any.whl → 2.159.0a0__py3-none-any.whl

aws_cdk/aws_ivs_alpha/__init__.py

@@ -55,6 +55,18 @@ my_channel = ivs.Channel(self, "myChannel",
 )
 ```
 
+If you want to use RTMP ingest, set `insecureIngest` property to `true`.
+By default, `insecureIngest` is `false` which means using RTMPS ingest.
+
+**⚠ Note:** RTMP ingest might result in reduced security for your streams. AWS recommends that you use RTMPS for ingest, unless you have specific and verified use cases. For more information, see [Encoder Settings](https://docs.aws.amazon.com/ivs/latest/LowLatencyUserGuide/streaming-config.html#streaming-config-settings).
+
+```python
+my_rtmp_channel = ivs.Channel(self, "myRtmpChannel",
+    type=ivs.ChannelType.STANDARD,
+    insecure_ingest=True
+)
+```
+
 ### Importing an existing channel
 
 You can reference an existing channel, for example, if you need to create a
@@ -146,6 +158,7 @@ import constructs as _constructs_77d1e7e8
     name_mapping={
         "authorized": "authorized",
         "channel_name": "channelName",
+        "insecure_ingest": "insecureIngest",
         "latency_mode": "latencyMode",
         "preset": "preset",
         "type": "type",
@@ -157,6 +170,7 @@ class ChannelProps:
         *,
         authorized: typing.Optional[builtins.bool] = None,
         channel_name: typing.Optional[builtins.str] = None,
+        insecure_ingest: typing.Optional[builtins.bool] = None,
         latency_mode: typing.Optional["LatencyMode"] = None,
         preset: typing.Optional["Preset"] = None,
         type: typing.Optional["ChannelType"] = None,
@@ -165,6 +179,7 @@ class ChannelProps:
 
         :param authorized: (experimental) Whether the channel is authorized. If you wish to make an authorized channel, you will need to ensure that a PlaybackKeyPair has been uploaded to your account as this is used to validate the signed JWT that is required for authorization Default: false
         :param channel_name: (experimental) A name for the channel. Default: Automatically generated name
+        :param insecure_ingest: (experimental) Whether the channel allows insecure RTMP ingest. Default: false
         :param latency_mode: (experimental) Channel latency mode. Default: LatencyMode.LOW
         :param preset: (experimental) An optional transcode preset for the channel. Can be used for ADVANCED_HD and ADVANCED_SD channel types. When LOW or STANDARD is used, the preset will be overridden and set to none regardless of the value provided. Default: - Preset.HIGHER_BANDWIDTH_DELIVERY if channelType is ADVANCED_SD or ADVANCED_HD, none otherwise
         :param type: (experimental) The channel type, which determines the allowable resolution and bitrate. If you exceed the allowable resolution or bitrate, the stream will disconnect immediately Default: ChannelType.STANDARD
@@ -174,15 +189,16 @@ class ChannelProps:
 
         Example::
 
-            my_channel = ivs.Channel(self, "myChannel",
-                type=ivs.ChannelType.ADVANCED_HD,
-                preset=ivs.Preset.CONSTRAINED_BANDWIDTH_DELIVERY
+            my_rtmp_channel = ivs.Channel(self, "myRtmpChannel",
+                type=ivs.ChannelType.STANDARD,
+                insecure_ingest=True
             )
         '''
         if __debug__:
             type_hints = typing.get_type_hints(_typecheckingstub__0ebf6a0e98bbd5b88d9676fbe616666a44f837cba80675eade5df1fea22c9d22)
             check_type(argname="argument authorized", value=authorized, expected_type=type_hints["authorized"])
             check_type(argname="argument channel_name", value=channel_name, expected_type=type_hints["channel_name"])
+            check_type(argname="argument insecure_ingest", value=insecure_ingest, expected_type=type_hints["insecure_ingest"])
             check_type(argname="argument latency_mode", value=latency_mode, expected_type=type_hints["latency_mode"])
             check_type(argname="argument preset", value=preset, expected_type=type_hints["preset"])
             check_type(argname="argument type", value=type, expected_type=type_hints["type"])
@@ -191,6 +207,8 @@ class ChannelProps:
             self._values["authorized"] = authorized
         if channel_name is not None:
             self._values["channel_name"] = channel_name
+        if insecure_ingest is not None:
+            self._values["insecure_ingest"] = insecure_ingest
         if latency_mode is not None:
             self._values["latency_mode"] = latency_mode
         if preset is not None:
@@ -224,6 +242,17 @@ class ChannelProps:
         result = self._values.get("channel_name")
         return typing.cast(typing.Optional[builtins.str], result)
 
+    @builtins.property
+    def insecure_ingest(self) -> typing.Optional[builtins.bool]:
+        '''(experimental) Whether the channel allows insecure RTMP ingest.
+
+        :default: false
+
+        :stability: experimental
+        '''
+        result = self._values.get("insecure_ingest")
+        return typing.cast(typing.Optional[builtins.bool], result)
+
     @builtins.property
     def latency_mode(self) -> typing.Optional["LatencyMode"]:
         '''(experimental) Channel latency mode.
@@ -812,7 +841,10 @@ class Channel(
 
     Example::
 
-        my_channel = ivs.Channel.from_channel_arn(self, "Channel", my_channel_arn)
+        my_rtmp_channel = ivs.Channel(self, "myRtmpChannel",
+            type=ivs.ChannelType.STANDARD,
+            insecure_ingest=True
+        )
     '''
 
     def __init__(
@@ -822,6 +854,7 @@ class Channel(
         *,
         authorized: typing.Optional[builtins.bool] = None,
         channel_name: typing.Optional[builtins.str] = None,
+        insecure_ingest: typing.Optional[builtins.bool] = None,
         latency_mode: typing.Optional[LatencyMode] = None,
         preset: typing.Optional[Preset] = None,
         type: typing.Optional[ChannelType] = None,
@@ -831,6 +864,7 @@ class Channel(
         :param id: -
         :param authorized: (experimental) Whether the channel is authorized. If you wish to make an authorized channel, you will need to ensure that a PlaybackKeyPair has been uploaded to your account as this is used to validate the signed JWT that is required for authorization Default: false
         :param channel_name: (experimental) A name for the channel. Default: Automatically generated name
+        :param insecure_ingest: (experimental) Whether the channel allows insecure RTMP ingest. Default: false
         :param latency_mode: (experimental) Channel latency mode. Default: LatencyMode.LOW
         :param preset: (experimental) An optional transcode preset for the channel. Can be used for ADVANCED_HD and ADVANCED_SD channel types. When LOW or STANDARD is used, the preset will be overridden and set to none regardless of the value provided. Default: - Preset.HIGHER_BANDWIDTH_DELIVERY if channelType is ADVANCED_SD or ADVANCED_HD, none otherwise
         :param type: (experimental) The channel type, which determines the allowable resolution and bitrate. If you exceed the allowable resolution or bitrate, the stream will disconnect immediately Default: ChannelType.STANDARD
@@ -844,6 +878,7 @@ class Channel(
         props = ChannelProps(
             authorized=authorized,
             channel_name=channel_name,
+            insecure_ingest=insecure_ingest,
             latency_mode=latency_mode,
             preset=preset,
             type=type,
@@ -945,6 +980,7 @@ def _typecheckingstub__0ebf6a0e98bbd5b88d9676fbe616666a44f837cba80675eade5df1fea
     *,
     authorized: typing.Optional[builtins.bool] = None,
     channel_name: typing.Optional[builtins.str] = None,
+    insecure_ingest: typing.Optional[builtins.bool] = None,
     latency_mode: typing.Optional[LatencyMode] = None,
     preset: typing.Optional[Preset] = None,
     type: typing.Optional[ChannelType] = None,
@@ -998,6 +1034,7 @@ def _typecheckingstub__07139327925dc97a551bbf17c849a0f698e0c9c60d3da3f65f2b3d2be
     *,
     authorized: typing.Optional[builtins.bool] = None,
     channel_name: typing.Optional[builtins.str] = None,
+    insecure_ingest: typing.Optional[builtins.bool] = None,
     latency_mode: typing.Optional[LatencyMode] = None,
     preset: typing.Optional[Preset] = None,
     type: typing.Optional[ChannelType] = None,

aws_cdk/aws_ivs_alpha/_jsii/__init__.py

@@ -33,9 +33,9 @@ import constructs._jsii
 
 __jsii_assembly__ = jsii.JSIIAssembly.load(
     "@aws-cdk/aws-ivs-alpha",
-    "2.158.0-alpha.0",
+    "2.159.0-alpha.0",
     __name__[0:-6],
-    "aws-ivs-alpha@2.158.0-alpha.0.jsii.tgz",
+    "aws-ivs-alpha@2.159.0-alpha.0.jsii.tgz",
 )
 
 __all__ = [

{aws_cdk.aws_ivs_alpha-2.158.0a0.dist-info → aws_cdk.aws_ivs_alpha-2.159.0a0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: aws-cdk.aws-ivs-alpha
-Version: 2.158.0a0
+Version: 2.159.0a0
 Summary: The CDK Construct Library for AWS::IVS
 Home-page: https://github.com/aws/aws-cdk
 Author: Amazon Web Services
@@ -23,7 +23,7 @@ Requires-Python: ~=3.8
 Description-Content-Type: text/markdown
 License-File: LICENSE
 License-File: NOTICE
-Requires-Dist: aws-cdk-lib<3.0.0,>=2.158.0
+Requires-Dist: aws-cdk-lib<3.0.0,>=2.159.0
 Requires-Dist: constructs<11.0.0,>=10.0.0
 Requires-Dist: jsii<2.0.0,>=1.103.1
 Requires-Dist: publication>=0.0.3
@@ -85,6 +85,18 @@ my_channel = ivs.Channel(self, "myChannel",
 )
 ```
 
+If you want to use RTMP ingest, set `insecureIngest` property to `true`.
+By default, `insecureIngest` is `false` which means using RTMPS ingest.
+
+**⚠ Note:** RTMP ingest might result in reduced security for your streams. AWS recommends that you use RTMPS for ingest, unless you have specific and verified use cases. For more information, see [Encoder Settings](https://docs.aws.amazon.com/ivs/latest/LowLatencyUserGuide/streaming-config.html#streaming-config-settings).
+
+```python
+my_rtmp_channel = ivs.Channel(self, "myRtmpChannel",
+    type=ivs.ChannelType.STANDARD,
+    insecure_ingest=True
+)
+```
+
 ### Importing an existing channel
 
 You can reference an existing channel, for example, if you need to create a

aws_cdk.aws_ivs_alpha-2.159.0a0.dist-info/RECORD

@@ -0,0 +1,10 @@
+aws_cdk/aws_ivs_alpha/__init__.py,sha256=1yMxCucI4anyJ3gZluv1I6UCVHhonkrz5fgJ4KQp5cE,39178
+aws_cdk/aws_ivs_alpha/py.typed,sha256=AbpHGcgLb-kRsJGnwFEktk7uzpZOCcBY74-YBdrKVGs,1
+aws_cdk/aws_ivs_alpha/_jsii/__init__.py,sha256=b8Z2LNg1RnC1w7ifUGLJnyry9i6aoJeBB4xxOaUSJsI,1479
+aws_cdk/aws_ivs_alpha/_jsii/aws-ivs-alpha@2.159.0-alpha.0.jsii.tgz,sha256=BYcQhwar2iA56xHef2gtSY7S941UxTmvBC9Tmide0Ww,38366
+aws_cdk.aws_ivs_alpha-2.159.0a0.dist-info/LICENSE,sha256=kEDF86xJUQh1E9M7UPKKbHepBEdFxIUyoGfTwQB7zKg,11391
+aws_cdk.aws_ivs_alpha-2.159.0a0.dist-info/METADATA,sha256=Un7Rsa490ZmbUcym_boAm4UQ4zXsxz0GstM0rUx9LIo,5566
+aws_cdk.aws_ivs_alpha-2.159.0a0.dist-info/NOTICE,sha256=dXf56qvx2VDNCaqiRscOD2IH5GbmqbnKRzroZCeLtaQ,113
+aws_cdk.aws_ivs_alpha-2.159.0a0.dist-info/WHEEL,sha256=eOLhNAGa2EW3wWl_TU484h7q1UNgy0JXjjoqKoxAAQc,92
+aws_cdk.aws_ivs_alpha-2.159.0a0.dist-info/top_level.txt,sha256=1TALAKbuUGsMSrfKWEf268lySCmcqSEO6cDYe_XlLHM,8
+aws_cdk.aws_ivs_alpha-2.159.0a0.dist-info/RECORD,,

aws_cdk.aws_ivs_alpha-2.158.0a0.dist-info/RECORD

@@ -1,10 +0,0 @@
-aws_cdk/aws_ivs_alpha/__init__.py,sha256=0PpW2BqW3nCkWP0znO-fm_eP39O-fyQaPensf9fsYd0,37389
-aws_cdk/aws_ivs_alpha/py.typed,sha256=AbpHGcgLb-kRsJGnwFEktk7uzpZOCcBY74-YBdrKVGs,1
-aws_cdk/aws_ivs_alpha/_jsii/__init__.py,sha256=84-GBHv_RK4MTd-XZIHPsV6qIreDo-i98NyuYkmybFQ,1479
-aws_cdk/aws_ivs_alpha/_jsii/aws-ivs-alpha@2.158.0-alpha.0.jsii.tgz,sha256=XmNn7KL3NYwT3OShM-5etD1XnRC3Vgq3g0aH-vqVYII,37471
-aws_cdk.aws_ivs_alpha-2.158.0a0.dist-info/LICENSE,sha256=kEDF86xJUQh1E9M7UPKKbHepBEdFxIUyoGfTwQB7zKg,11391
-aws_cdk.aws_ivs_alpha-2.158.0a0.dist-info/METADATA,sha256=wJ9jREp-UeEQMEpHyTHu4yNRKAXmoB2uqG28A1GclXY,4963
-aws_cdk.aws_ivs_alpha-2.158.0a0.dist-info/NOTICE,sha256=dXf56qvx2VDNCaqiRscOD2IH5GbmqbnKRzroZCeLtaQ,113
-aws_cdk.aws_ivs_alpha-2.158.0a0.dist-info/WHEEL,sha256=eOLhNAGa2EW3wWl_TU484h7q1UNgy0JXjjoqKoxAAQc,92
-aws_cdk.aws_ivs_alpha-2.158.0a0.dist-info/top_level.txt,sha256=1TALAKbuUGsMSrfKWEf268lySCmcqSEO6cDYe_XlLHM,8
-aws_cdk.aws_ivs_alpha-2.158.0a0.dist-info/RECORD,,