aws-cdk-lib 2.209.1__py3-none-any.whl → 2.211.0__py3-none-any.whl

aws_cdk/aws_opsworkscm/__init__.py

@@ -77,7 +77,7 @@ class CfnServer(
 ):
     '''The ``AWS::OpsWorksCM::Server`` resource creates an AWS OpsWorks for Chef Automate or OpsWorks for Puppet Enterprise configuration management server.
 
-    For more information, see `Create a Chef Automate Server in AWS CloudFormation <https://docs.aws.amazon.com/opsworks/latest/userguide/opscm-create-server-cfn.html>`_ or `Create a Puppet Enterprise Master in AWS CloudFormation <https://docs.aws.amazon.com/opsworks/latest/userguide/opspup-create-server-cfn.html>`_ in the *AWS OpsWorks User Guide* , and `CreateServer <https://docs.aws.amazon.com/opsworks-cm/latest/APIReference/API_CreateServer.html>`_ in the *AWS OpsWorks CM API Reference* .
+    For more information, see `Create a Chef Automate Server in AWS CloudFormation <https://docs.aws.amazon.com/opsworks/latest/userguide/opscm-create-server-cfn.html>`_ or `Create a Puppet Enterprise Master in AWS CloudFormation <https://docs.aws.amazon.com/opsworks/latest/userguide/opspup-create-server-cfn.html>`_ in the *OpsWorks User Guide* , and `CreateServer <https://docs.aws.amazon.com/opsworks-cm/latest/APIReference/API_CreateServer.html>`_ in the *AWS OpsWorks CM API Reference* .
 
     :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-opsworkscm-server.html
     :cloudformationResource: AWS::OpsWorksCM::Server
@@ -113,7 +113,6 @@ class CfnServer(
             preferred_backup_window="preferredBackupWindow",
             preferred_maintenance_window="preferredMaintenanceWindow",
             security_group_ids=["securityGroupIds"],
-            server_name="serverName",
             subnet_ids=["subnetIds"],
             tags=[CfnTag(
                 key="key",
@@ -145,7 +144,6 @@ class CfnServer(
         preferred_backup_window: typing.Optional[builtins.str] = None,
         preferred_maintenance_window: typing.Optional[builtins.str] = None,
         security_group_ids: typing.Optional[typing.Sequence[builtins.str]] = None,
-        server_name: typing.Optional[builtins.str] = None,
         subnet_ids: typing.Optional[typing.Sequence[builtins.str]] = None,
         tags: typing.Optional[typing.Sequence[typing.Union[_CfnTag_f6864754, typing.Dict[builtins.str, typing.Any]]]] = None,
     ) -> None:
@@ -170,7 +168,6 @@ class CfnServer(
         :param preferred_backup_window: The start time for a one-hour period during which AWS OpsWorks CM backs up application-level data on your server if automated backups are enabled. Valid values must be specified in one of the following formats: - ``HH:MM`` for daily backups - ``DDD:HH:MM`` for weekly backups ``MM`` must be specified as ``00`` . The specified time is in coordinated universal time (UTC). The default value is a random, daily start time. *Example:* ``08:00`` , which represents a daily start time of 08:00 UTC. *Example:* ``Mon:08:00`` , which represents a start time of every Monday at 08:00 UTC. (8:00 a.m.)
         :param preferred_maintenance_window: The start time for a one-hour period each week during which AWS OpsWorks CM performs maintenance on the instance. Valid values must be specified in the following format: ``DDD:HH:MM`` . ``MM`` must be specified as ``00`` . The specified time is in coordinated universal time (UTC). The default value is a random one-hour period on Tuesday, Wednesday, or Friday. See ``TimeWindowDefinition`` for more information. *Example:* ``Mon:08:00`` , which represents a start time of every Monday at 08:00 UTC. (8:00 a.m.)
         :param security_group_ids: A list of security group IDs to attach to the Amazon EC2 instance. If you add this parameter, the specified security groups must be within the VPC that is specified by ``SubnetIds`` . If you do not specify this parameter, AWS OpsWorks CM creates one new security group that uses TCP ports 22 and 443, open to 0.0.0.0/0 (everyone).
-        :param server_name: The name of the server. The server name must be unique within your AWS account, within each region. Server names must start with a letter; then letters, numbers, or hyphens (-) are allowed, up to a maximum of 40 characters.
         :param subnet_ids: The IDs of subnets in which to launch the server EC2 instance. Amazon EC2-Classic customers: This field is required. All servers must run within a VPC. The VPC must have "Auto Assign Public IP" enabled. EC2-VPC customers: This field is optional. If you do not specify subnet IDs, your EC2 instances are created in a default subnet that is selected by Amazon EC2. If you specify subnet IDs, the VPC must have "Auto Assign Public IP" enabled. For more information about supported Amazon EC2 platforms, see `Supported Platforms <https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-supported-platforms.html>`_ .
         :param tags: A map that contains tag keys and tag values to attach to an AWS OpsWorks for Chef Automate or OpsWorks for Puppet Enterprise server. - The key cannot be empty. - The key can be a maximum of 127 characters, and can contain only Unicode letters, numbers, or separators, or the following special characters: `+ - = . _ : /
         '''
@@ -197,7 +194,6 @@ class CfnServer(
             preferred_backup_window=preferred_backup_window,
             preferred_maintenance_window=preferred_maintenance_window,
             security_group_ids=security_group_ids,
-            server_name=server_name,
             subnet_ids=subnet_ids,
             tags=tags,
         )
@@ -254,15 +250,6 @@ class CfnServer(
         '''
         return typing.cast(builtins.str, jsii.get(self, "attrEndpoint"))
 
-    @builtins.property
-    @jsii.member(jsii_name="attrId")
-    def attr_id(self) -> builtins.str:
-        '''The ID of the server.
-
-        :cloudformationAttribute: Id
-        '''
-        return typing.cast(builtins.str, jsii.get(self, "attrId"))
-
     @builtins.property
     @jsii.member(jsii_name="attrServerName")
     def attr_server_name(self) -> builtins.str:
@@ -537,19 +524,6 @@ class CfnServer(
             check_type(argname="argument value", value=value, expected_type=type_hints["value"])
         jsii.set(self, "securityGroupIds", value) # pyright: ignore[reportArgumentType]
 
-    @builtins.property
-    @jsii.member(jsii_name="serverName")
-    def server_name(self) -> typing.Optional[builtins.str]:
-        '''The name of the server.'''
-        return typing.cast(typing.Optional[builtins.str], jsii.get(self, "serverName"))
-
-    @server_name.setter
-    def server_name(self, value: typing.Optional[builtins.str]) -> None:
-        if __debug__:
-            type_hints = typing.get_type_hints(_typecheckingstub__0fdc9b0c6ccfb79b318a5321a2bdb7586f084e301b627e9b708804bad96c9238)
-            check_type(argname="argument value", value=value, expected_type=type_hints["value"])
-        jsii.set(self, "serverName", value) # pyright: ignore[reportArgumentType]
-
     @builtins.property
     @jsii.member(jsii_name="subnetIds")
     def subnet_ids(self) -> typing.Optional[typing.List[builtins.str]]:
@@ -695,7 +669,6 @@ class CfnServer(
         "preferred_backup_window": "preferredBackupWindow",
         "preferred_maintenance_window": "preferredMaintenanceWindow",
         "security_group_ids": "securityGroupIds",
-        "server_name": "serverName",
         "subnet_ids": "subnetIds",
         "tags": "tags",
     },
@@ -722,7 +695,6 @@ class CfnServerProps:
         preferred_backup_window: typing.Optional[builtins.str] = None,
         preferred_maintenance_window: typing.Optional[builtins.str] = None,
         security_group_ids: typing.Optional[typing.Sequence[builtins.str]] = None,
-        server_name: typing.Optional[builtins.str] = None,
         subnet_ids: typing.Optional[typing.Sequence[builtins.str]] = None,
         tags: typing.Optional[typing.Sequence[typing.Union[_CfnTag_f6864754, typing.Dict[builtins.str, typing.Any]]]] = None,
     ) -> None:
@@ -746,7 +718,6 @@ class CfnServerProps:
         :param preferred_backup_window: The start time for a one-hour period during which AWS OpsWorks CM backs up application-level data on your server if automated backups are enabled. Valid values must be specified in one of the following formats: - ``HH:MM`` for daily backups - ``DDD:HH:MM`` for weekly backups ``MM`` must be specified as ``00`` . The specified time is in coordinated universal time (UTC). The default value is a random, daily start time. *Example:* ``08:00`` , which represents a daily start time of 08:00 UTC. *Example:* ``Mon:08:00`` , which represents a start time of every Monday at 08:00 UTC. (8:00 a.m.)
         :param preferred_maintenance_window: The start time for a one-hour period each week during which AWS OpsWorks CM performs maintenance on the instance. Valid values must be specified in the following format: ``DDD:HH:MM`` . ``MM`` must be specified as ``00`` . The specified time is in coordinated universal time (UTC). The default value is a random one-hour period on Tuesday, Wednesday, or Friday. See ``TimeWindowDefinition`` for more information. *Example:* ``Mon:08:00`` , which represents a start time of every Monday at 08:00 UTC. (8:00 a.m.)
         :param security_group_ids: A list of security group IDs to attach to the Amazon EC2 instance. If you add this parameter, the specified security groups must be within the VPC that is specified by ``SubnetIds`` . If you do not specify this parameter, AWS OpsWorks CM creates one new security group that uses TCP ports 22 and 443, open to 0.0.0.0/0 (everyone).
-        :param server_name: The name of the server. The server name must be unique within your AWS account, within each region. Server names must start with a letter; then letters, numbers, or hyphens (-) are allowed, up to a maximum of 40 characters.
         :param subnet_ids: The IDs of subnets in which to launch the server EC2 instance. Amazon EC2-Classic customers: This field is required. All servers must run within a VPC. The VPC must have "Auto Assign Public IP" enabled. EC2-VPC customers: This field is optional. If you do not specify subnet IDs, your EC2 instances are created in a default subnet that is selected by Amazon EC2. If you specify subnet IDs, the VPC must have "Auto Assign Public IP" enabled. For more information about supported Amazon EC2 platforms, see `Supported Platforms <https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-supported-platforms.html>`_ .
         :param tags: A map that contains tag keys and tag values to attach to an AWS OpsWorks for Chef Automate or OpsWorks for Puppet Enterprise server. - The key cannot be empty. - The key can be a maximum of 127 characters, and can contain only Unicode letters, numbers, or separators, or the following special characters: `+ - = . _ : /
 
@@ -783,7 +754,6 @@ class CfnServerProps:
                 preferred_backup_window="preferredBackupWindow",
                 preferred_maintenance_window="preferredMaintenanceWindow",
                 security_group_ids=["securityGroupIds"],
-                server_name="serverName",
                 subnet_ids=["subnetIds"],
                 tags=[CfnTag(
                     key="key",
@@ -811,7 +781,6 @@ class CfnServerProps:
             check_type(argname="argument preferred_backup_window", value=preferred_backup_window, expected_type=type_hints["preferred_backup_window"])
             check_type(argname="argument preferred_maintenance_window", value=preferred_maintenance_window, expected_type=type_hints["preferred_maintenance_window"])
             check_type(argname="argument security_group_ids", value=security_group_ids, expected_type=type_hints["security_group_ids"])
-            check_type(argname="argument server_name", value=server_name, expected_type=type_hints["server_name"])
             check_type(argname="argument subnet_ids", value=subnet_ids, expected_type=type_hints["subnet_ids"])
             check_type(argname="argument tags", value=tags, expected_type=type_hints["tags"])
         self._values: typing.Dict[builtins.str, typing.Any] = {
@@ -849,8 +818,6 @@ class CfnServerProps:
             self._values["preferred_maintenance_window"] = preferred_maintenance_window
         if security_group_ids is not None:
             self._values["security_group_ids"] = security_group_ids
-        if server_name is not None:
-            self._values["server_name"] = server_name
         if subnet_ids is not None:
             self._values["subnet_ids"] = subnet_ids
         if tags is not None:
@@ -1077,17 +1044,6 @@ class CfnServerProps:
         result = self._values.get("security_group_ids")
         return typing.cast(typing.Optional[typing.List[builtins.str]], result)
 
-    @builtins.property
-    def server_name(self) -> typing.Optional[builtins.str]:
-        '''The name of the server.
-
-        The server name must be unique within your AWS account, within each region. Server names must start with a letter; then letters, numbers, or hyphens (-) are allowed, up to a maximum of 40 characters.
-
-        :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-opsworkscm-server.html#cfn-opsworkscm-server-servername
-        '''
-        result = self._values.get("server_name")
-        return typing.cast(typing.Optional[builtins.str], result)
-
     @builtins.property
     def subnet_ids(self) -> typing.Optional[typing.List[builtins.str]]:
         '''The IDs of subnets in which to launch the server EC2 instance.
@@ -1163,7 +1119,6 @@ def _typecheckingstub__4fcf3005231c62e7682797d2e25d33ceb0c0b9602a2f2ffe6a7c3dabf
     preferred_backup_window: typing.Optional[builtins.str] = None,
     preferred_maintenance_window: typing.Optional[builtins.str] = None,
     security_group_ids: typing.Optional[typing.Sequence[builtins.str]] = None,
-    server_name: typing.Optional[builtins.str] = None,
     subnet_ids: typing.Optional[typing.Sequence[builtins.str]] = None,
     tags: typing.Optional[typing.Sequence[typing.Union[_CfnTag_f6864754, typing.Dict[builtins.str, typing.Any]]]] = None,
 ) -> None:
@@ -1290,12 +1245,6 @@ def _typecheckingstub__d7663e937d0fabd66d40de7584fca886669aae87261a418b199493778
     """Type checking stubs"""
     pass
 
-def _typecheckingstub__0fdc9b0c6ccfb79b318a5321a2bdb7586f084e301b627e9b708804bad96c9238(
-    value: typing.Optional[builtins.str],
-) -> None:
-    """Type checking stubs"""
-    pass
-
 def _typecheckingstub__e6d133d8dd209b40a7f4c3900293e312fe8b95abc9cfff43e88a6fd1608b595b(
     value: typing.Optional[typing.List[builtins.str]],
 ) -> None:
@@ -1336,7 +1285,6 @@ def _typecheckingstub__6f3d9a63c768f1a40206835320dfa128b267da1fa702fbb4ecd8ac94b
     preferred_backup_window: typing.Optional[builtins.str] = None,
     preferred_maintenance_window: typing.Optional[builtins.str] = None,
     security_group_ids: typing.Optional[typing.Sequence[builtins.str]] = None,
-    server_name: typing.Optional[builtins.str] = None,
     subnet_ids: typing.Optional[typing.Sequence[builtins.str]] = None,
     tags: typing.Optional[typing.Sequence[typing.Union[_CfnTag_f6864754, typing.Dict[builtins.str, typing.Any]]]] = None,
 ) -> None:

aws_cdk/aws_pcs/__init__.py

@@ -98,6 +98,7 @@ class CfnCluster(
         
         cfn_cluster = pcs.CfnCluster(self, "MyCfnCluster",
             networking=pcs.CfnCluster.NetworkingProperty(
+                network_type="networkType",
                 security_group_ids=["securityGroupIds"],
                 subnet_ids=["subnetIds"]
             ),
@@ -520,6 +521,7 @@ class CfnCluster(
             "port": "port",
             "private_ip_address": "privateIpAddress",
             "type": "type",
+            "ipv6_address": "ipv6Address",
             "public_ip_address": "publicIpAddress",
         },
     )
@@ -530,6 +532,7 @@ class CfnCluster(
             port: builtins.str,
             private_ip_address: builtins.str,
             type: builtins.str,
+            ipv6_address: typing.Optional[builtins.str] = None,
             public_ip_address: typing.Optional[builtins.str] = None,
         ) -> None:
             '''An endpoint available for interaction with the scheduler.
@@ -537,6 +540,7 @@ class CfnCluster(
             :param port: The endpoint's connection port number.
             :param private_ip_address: The endpoint's private IP address.
             :param type: Indicates the type of endpoint running at the specific IP address.
+            :param ipv6_address: The endpoint's IPv6 address.
             :param public_ip_address: The endpoint's public IP address.
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-pcs-cluster-endpoint.html
@@ -554,6 +558,7 @@ class CfnCluster(
                     type="type",
                 
                     # the properties below are optional
+                    ipv6_address="ipv6Address",
                     public_ip_address="publicIpAddress"
                 )
             '''
@@ -562,12 +567,15 @@ class CfnCluster(
                 check_type(argname="argument port", value=port, expected_type=type_hints["port"])
                 check_type(argname="argument private_ip_address", value=private_ip_address, expected_type=type_hints["private_ip_address"])
                 check_type(argname="argument type", value=type, expected_type=type_hints["type"])
+                check_type(argname="argument ipv6_address", value=ipv6_address, expected_type=type_hints["ipv6_address"])
                 check_type(argname="argument public_ip_address", value=public_ip_address, expected_type=type_hints["public_ip_address"])
             self._values: typing.Dict[builtins.str, typing.Any] = {
                 "port": port,
                 "private_ip_address": private_ip_address,
                 "type": type,
             }
+            if ipv6_address is not None:
+                self._values["ipv6_address"] = ipv6_address
             if public_ip_address is not None:
                 self._values["public_ip_address"] = public_ip_address
 
@@ -601,6 +609,15 @@ class CfnCluster(
             assert result is not None, "Required property 'type' is missing"
             return typing.cast(builtins.str, result)
 
+        @builtins.property
+        def ipv6_address(self) -> typing.Optional[builtins.str]:
+            '''The endpoint's IPv6 address.
+
+            :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-pcs-cluster-endpoint.html#cfn-pcs-cluster-endpoint-ipv6address
+            '''
+            result = self._values.get("ipv6_address")
+            return typing.cast(typing.Optional[builtins.str], result)
+
         @builtins.property
         def public_ip_address(self) -> typing.Optional[builtins.str]:
             '''The endpoint's public IP address.
@@ -695,6 +712,7 @@ class CfnCluster(
         jsii_type="aws-cdk-lib.aws_pcs.CfnCluster.NetworkingProperty",
         jsii_struct_bases=[],
         name_mapping={
+            "network_type": "networkType",
             "security_group_ids": "securityGroupIds",
             "subnet_ids": "subnetIds",
         },
@@ -703,11 +721,13 @@ class CfnCluster(
         def __init__(
             self,
             *,
+            network_type: typing.Optional[builtins.str] = None,
             security_group_ids: typing.Optional[typing.Sequence[builtins.str]] = None,
             subnet_ids: typing.Optional[typing.Sequence[builtins.str]] = None,
         ) -> None:
             '''TThe networking configuration for the cluster's control plane.
 
+            :param network_type: The IP of the cluster (IPV4 or IPV6).
             :param security_group_ids: The list of security group IDs associated with the Elastic Network Interface (ENI) created in subnets.
             :param subnet_ids: The list of subnet IDs where AWS PCS creates an Elastic Network Interface (ENI) to enable communication between managed controllers and AWS PCS resources. The subnet must have an available IP address, cannot reside in AWS Outposts, AWS Wavelength, or an AWS Local Zone. AWS PCS currently supports only 1 subnet in this list.
 
@@ -721,20 +741,33 @@ class CfnCluster(
                 from aws_cdk import aws_pcs as pcs
                 
                 networking_property = pcs.CfnCluster.NetworkingProperty(
+                    network_type="networkType",
                     security_group_ids=["securityGroupIds"],
                     subnet_ids=["subnetIds"]
                 )
             '''
             if __debug__:
                 type_hints = typing.get_type_hints(_typecheckingstub__82c7f3d28e2ed0d063467ea787c6cfc31c28d4c5f26ef1ddf71940887dea9d1f)
+                check_type(argname="argument network_type", value=network_type, expected_type=type_hints["network_type"])
                 check_type(argname="argument security_group_ids", value=security_group_ids, expected_type=type_hints["security_group_ids"])
                 check_type(argname="argument subnet_ids", value=subnet_ids, expected_type=type_hints["subnet_ids"])
             self._values: typing.Dict[builtins.str, typing.Any] = {}
+            if network_type is not None:
+                self._values["network_type"] = network_type
             if security_group_ids is not None:
                 self._values["security_group_ids"] = security_group_ids
             if subnet_ids is not None:
                 self._values["subnet_ids"] = subnet_ids
 
+        @builtins.property
+        def network_type(self) -> typing.Optional[builtins.str]:
+            '''The IP of the cluster (IPV4 or IPV6).
+
+            :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-pcs-cluster-networking.html#cfn-pcs-cluster-networking-networktype
+            '''
+            result = self._values.get("network_type")
+            return typing.cast(typing.Optional[builtins.str], result)
+
         @builtins.property
         def security_group_ids(self) -> typing.Optional[typing.List[builtins.str]]:
             '''The list of security group IDs associated with the Elastic Network Interface (ENI) created in subnets.
@@ -1080,6 +1113,7 @@ class CfnClusterProps:
             
             cfn_cluster_props = pcs.CfnClusterProps(
                 networking=pcs.CfnCluster.NetworkingProperty(
+                    network_type="networkType",
                     security_group_ids=["securityGroupIds"],
                     subnet_ids=["subnetIds"]
                 ),
@@ -2874,6 +2908,7 @@ def _typecheckingstub__fb46faa4736fd5bede060ea1460c35898193ef49ace1726974a1db895
     port: builtins.str,
     private_ip_address: builtins.str,
     type: builtins.str,
+    ipv6_address: typing.Optional[builtins.str] = None,
     public_ip_address: typing.Optional[builtins.str] = None,
 ) -> None:
     """Type checking stubs"""
@@ -2889,6 +2924,7 @@ def _typecheckingstub__b9e127e61b0ea75f45a99bba1dcc51875a9ecf36ea91f697889ebe4cb
 
 def _typecheckingstub__82c7f3d28e2ed0d063467ea787c6cfc31c28d4c5f26ef1ddf71940887dea9d1f(
     *,
+    network_type: typing.Optional[builtins.str] = None,
     security_group_ids: typing.Optional[typing.Sequence[builtins.str]] = None,
     subnet_ids: typing.Optional[typing.Sequence[builtins.str]] = None,
 ) -> None:

aws_cdk/aws_qbusiness/__init__.py

@@ -7386,7 +7386,7 @@ class CfnWebExperience(
         :param customization_configuration: Contains the configuration information to customize the logo, font, and color of an Amazon Q Business web experience with individual files for each property or a CSS file for them all.
         :param identity_provider_configuration: Provides information about the identity provider (IdP) used to authenticate end users of an Amazon Q Business web experience.
         :param origins: Sets the website domain origins that are allowed to embed the Amazon Q Business web experience. The *domain origin* refers to the base URL for accessing a website including the protocol ( ``http/https`` ), the domain name, and the port number (if specified). .. epigraph:: You must only submit a *base URL* and not a full path. For example, ``https://docs.aws.amazon.com`` .
-        :param role_arn: The Amazon Resource Name (ARN) of the service role attached to your web experience. .. epigraph:: You must provide this value if you're using IAM Identity Center to manage end user access to your application. If you're using legacy identity management to manage user access, you don't need to provide this value.
+        :param role_arn: The Amazon Resource Name (ARN) of the service role attached to your web experience. .. epigraph:: The ``roleArn`` parameter is required when your Amazon Q Business application is created with IAM Identity Center. It is not required for SAML-based applications.
         :param sample_prompts_control_mode: Determines whether sample prompts are enabled in the web experience for an end user.
         :param subtitle: A subtitle to personalize your Amazon Q Business web experience.
         :param tags: A list of key-value pairs that identify or categorize your Amazon Q Business web experience. You can also use tags to help control access to the web experience. Tag keys and values can consist of Unicode letters, digits, white space, and any of the following symbols: _ . : / = + -
@@ -8079,7 +8079,7 @@ class CfnWebExperienceProps:
         :param customization_configuration: Contains the configuration information to customize the logo, font, and color of an Amazon Q Business web experience with individual files for each property or a CSS file for them all.
         :param identity_provider_configuration: Provides information about the identity provider (IdP) used to authenticate end users of an Amazon Q Business web experience.
         :param origins: Sets the website domain origins that are allowed to embed the Amazon Q Business web experience. The *domain origin* refers to the base URL for accessing a website including the protocol ( ``http/https`` ), the domain name, and the port number (if specified). .. epigraph:: You must only submit a *base URL* and not a full path. For example, ``https://docs.aws.amazon.com`` .
-        :param role_arn: The Amazon Resource Name (ARN) of the service role attached to your web experience. .. epigraph:: You must provide this value if you're using IAM Identity Center to manage end user access to your application. If you're using legacy identity management to manage user access, you don't need to provide this value.
+        :param role_arn: The Amazon Resource Name (ARN) of the service role attached to your web experience. .. epigraph:: The ``roleArn`` parameter is required when your Amazon Q Business application is created with IAM Identity Center. It is not required for SAML-based applications.
         :param sample_prompts_control_mode: Determines whether sample prompts are enabled in the web experience for an end user.
         :param subtitle: A subtitle to personalize your Amazon Q Business web experience.
         :param tags: A list of key-value pairs that identify or categorize your Amazon Q Business web experience. You can also use tags to help control access to the web experience. Tag keys and values can consist of Unicode letters, digits, white space, and any of the following symbols: _ . : / = + -
@@ -8229,7 +8229,7 @@ class CfnWebExperienceProps:
 
         .. epigraph::
 
-           You must provide this value if you're using IAM Identity Center to manage end user access to your application. If you're using legacy identity management to manage user access, you don't need to provide this value.
+           The ``roleArn`` parameter is required when your Amazon Q Business application is created with IAM Identity Center. It is not required for SAML-based applications.
 
         :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-qbusiness-webexperience.html#cfn-qbusiness-webexperience-rolearn
         '''

aws_cdk/aws_quicksight/__init__.py

@@ -222555,6 +222555,9 @@ class CfnTopic(
             config_options=quicksight.CfnTopic.TopicConfigOptionsProperty(
                 q_business_insights_enabled=False
             ),
+            custom_instructions=quicksight.CfnTopic.CustomInstructionsProperty(
+                custom_instructions_string="customInstructionsString"
+            ),
             data_sets=[quicksight.CfnTopic.DatasetMetadataProperty(
                 dataset_arn="datasetArn",
         
@@ -222783,6 +222786,7 @@ class CfnTopic(
         *,
         aws_account_id: typing.Optional[builtins.str] = None,
         config_options: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union["CfnTopic.TopicConfigOptionsProperty", typing.Dict[builtins.str, typing.Any]]]] = None,
+        custom_instructions: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union["CfnTopic.CustomInstructionsProperty", typing.Dict[builtins.str, typing.Any]]]] = None,
         data_sets: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Sequence[typing.Union[_IResolvable_da3f097b, typing.Union["CfnTopic.DatasetMetadataProperty", typing.Dict[builtins.str, typing.Any]]]]]] = None,
         description: typing.Optional[builtins.str] = None,
         folder_arns: typing.Optional[typing.Sequence[builtins.str]] = None,
@@ -222796,6 +222800,7 @@ class CfnTopic(
         :param id: Construct identifier for this resource (unique in its scope).
         :param aws_account_id: The ID of the AWS account that you want to create a topic in.
         :param config_options: Configuration options for a ``Topic`` .
+        :param custom_instructions: 
         :param data_sets: The data sets that the topic is associated with.
         :param description: The description of the topic.
         :param folder_arns: 
@@ -222811,6 +222816,7 @@ class CfnTopic(
         props = CfnTopicProps(
             aws_account_id=aws_account_id,
             config_options=config_options,
+            custom_instructions=custom_instructions,
             data_sets=data_sets,
             description=description,
             folder_arns=folder_arns,
@@ -222903,6 +222909,23 @@ class CfnTopic(
             check_type(argname="argument value", value=value, expected_type=type_hints["value"])
         jsii.set(self, "configOptions", value) # pyright: ignore[reportArgumentType]
 
+    @builtins.property
+    @jsii.member(jsii_name="customInstructions")
+    def custom_instructions(
+        self,
+    ) -> typing.Optional[typing.Union[_IResolvable_da3f097b, "CfnTopic.CustomInstructionsProperty"]]:
+        return typing.cast(typing.Optional[typing.Union[_IResolvable_da3f097b, "CfnTopic.CustomInstructionsProperty"]], jsii.get(self, "customInstructions"))
+
+    @custom_instructions.setter
+    def custom_instructions(
+        self,
+        value: typing.Optional[typing.Union[_IResolvable_da3f097b, "CfnTopic.CustomInstructionsProperty"]],
+    ) -> None:
+        if __debug__:
+            type_hints = typing.get_type_hints(_typecheckingstub__a4228e99258c3d4e4cf69c46721540d1bbf33b720b9bb0f99a31d4771ac81291)
+            check_type(argname="argument value", value=value, expected_type=type_hints["value"])
+        jsii.set(self, "customInstructions", value) # pyright: ignore[reportArgumentType]
+
     @builtins.property
     @jsii.member(jsii_name="dataSets")
     def data_sets(
@@ -223215,6 +223238,56 @@ class CfnTopic(
                 k + "=" + repr(v) for k, v in self._values.items()
             )
 
+    @jsii.data_type(
+        jsii_type="aws-cdk-lib.aws_quicksight.CfnTopic.CustomInstructionsProperty",
+        jsii_struct_bases=[],
+        name_mapping={"custom_instructions_string": "customInstructionsString"},
+    )
+    class CustomInstructionsProperty:
+        def __init__(self, *, custom_instructions_string: builtins.str) -> None:
+            '''
+            :param custom_instructions_string: 
+
+            :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-quicksight-topic-custominstructions.html
+            :exampleMetadata: fixture=_generated
+
+            Example::
+
+                # The code below shows an example of how to instantiate this type.
+                # The values are placeholders you should change.
+                from aws_cdk import aws_quicksight as quicksight
+                
+                custom_instructions_property = quicksight.CfnTopic.CustomInstructionsProperty(
+                    custom_instructions_string="customInstructionsString"
+                )
+            '''
+            if __debug__:
+                type_hints = typing.get_type_hints(_typecheckingstub__4623e8fed89e9724b107d62f351e7f4af85a6e603e6354489f7380506ba9040d)
+                check_type(argname="argument custom_instructions_string", value=custom_instructions_string, expected_type=type_hints["custom_instructions_string"])
+            self._values: typing.Dict[builtins.str, typing.Any] = {
+                "custom_instructions_string": custom_instructions_string,
+            }
+
+        @builtins.property
+        def custom_instructions_string(self) -> builtins.str:
+            '''
+            :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-quicksight-topic-custominstructions.html#cfn-quicksight-topic-custominstructions-custominstructionsstring
+            '''
+            result = self._values.get("custom_instructions_string")
+            assert result is not None, "Required property 'custom_instructions_string' is missing"
+            return typing.cast(builtins.str, result)
+
+        def __eq__(self, rhs: typing.Any) -> builtins.bool:
+            return isinstance(rhs, self.__class__) and rhs._values == self._values
+
+        def __ne__(self, rhs: typing.Any) -> builtins.bool:
+            return not (rhs == self)
+
+        def __repr__(self) -> str:
+            return "CustomInstructionsProperty(%s)" % ", ".join(
+                k + "=" + repr(v) for k, v in self._values.items()
+            )
+
     @jsii.data_type(
         jsii_type="aws-cdk-lib.aws_quicksight.CfnTopic.DataAggregationProperty",
         jsii_struct_bases=[],
@@ -226608,6 +226681,7 @@ class CfnTopic(
     name_mapping={
         "aws_account_id": "awsAccountId",
         "config_options": "configOptions",
+        "custom_instructions": "customInstructions",
         "data_sets": "dataSets",
         "description": "description",
         "folder_arns": "folderArns",
@@ -226623,6 +226697,7 @@ class CfnTopicProps:
         *,
         aws_account_id: typing.Optional[builtins.str] = None,
         config_options: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union[CfnTopic.TopicConfigOptionsProperty, typing.Dict[builtins.str, typing.Any]]]] = None,
+        custom_instructions: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union[CfnTopic.CustomInstructionsProperty, typing.Dict[builtins.str, typing.Any]]]] = None,
         data_sets: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Sequence[typing.Union[_IResolvable_da3f097b, typing.Union[CfnTopic.DatasetMetadataProperty, typing.Dict[builtins.str, typing.Any]]]]]] = None,
         description: typing.Optional[builtins.str] = None,
         folder_arns: typing.Optional[typing.Sequence[builtins.str]] = None,
@@ -226635,6 +226710,7 @@ class CfnTopicProps:
 
         :param aws_account_id: The ID of the AWS account that you want to create a topic in.
         :param config_options: Configuration options for a ``Topic`` .
+        :param custom_instructions: 
         :param data_sets: The data sets that the topic is associated with.
         :param description: The description of the topic.
         :param folder_arns: 
@@ -226657,6 +226733,9 @@ class CfnTopicProps:
                 config_options=quicksight.CfnTopic.TopicConfigOptionsProperty(
                     q_business_insights_enabled=False
                 ),
+                custom_instructions=quicksight.CfnTopic.CustomInstructionsProperty(
+                    custom_instructions_string="customInstructionsString"
+                ),
                 data_sets=[quicksight.CfnTopic.DatasetMetadataProperty(
                     dataset_arn="datasetArn",
             
@@ -226881,6 +226960,7 @@ class CfnTopicProps:
             type_hints = typing.get_type_hints(_typecheckingstub__594e8a4ec85e161016ae0aa60a6538d619759944135cfd2b531b0f063b24a029)
             check_type(argname="argument aws_account_id", value=aws_account_id, expected_type=type_hints["aws_account_id"])
             check_type(argname="argument config_options", value=config_options, expected_type=type_hints["config_options"])
+            check_type(argname="argument custom_instructions", value=custom_instructions, expected_type=type_hints["custom_instructions"])
             check_type(argname="argument data_sets", value=data_sets, expected_type=type_hints["data_sets"])
             check_type(argname="argument description", value=description, expected_type=type_hints["description"])
             check_type(argname="argument folder_arns", value=folder_arns, expected_type=type_hints["folder_arns"])
@@ -226893,6 +226973,8 @@ class CfnTopicProps:
             self._values["aws_account_id"] = aws_account_id
         if config_options is not None:
             self._values["config_options"] = config_options
+        if custom_instructions is not None:
+            self._values["custom_instructions"] = custom_instructions
         if data_sets is not None:
             self._values["data_sets"] = data_sets
         if description is not None:
@@ -226928,6 +227010,16 @@ class CfnTopicProps:
         result = self._values.get("config_options")
         return typing.cast(typing.Optional[typing.Union[_IResolvable_da3f097b, CfnTopic.TopicConfigOptionsProperty]], result)
 
+    @builtins.property
+    def custom_instructions(
+        self,
+    ) -> typing.Optional[typing.Union[_IResolvable_da3f097b, CfnTopic.CustomInstructionsProperty]]:
+        '''
+        :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-quicksight-topic.html#cfn-quicksight-topic-custominstructions
+        '''
+        result = self._values.get("custom_instructions")
+        return typing.cast(typing.Optional[typing.Union[_IResolvable_da3f097b, CfnTopic.CustomInstructionsProperty]], result)
+
     @builtins.property
     def data_sets(
         self,
@@ -244861,6 +244953,7 @@ def _typecheckingstub__e98a54c810cd62780e1f968a0f83f854bc8baac07e43fc099f3f81b06
     *,
     aws_account_id: typing.Optional[builtins.str] = None,
     config_options: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union[CfnTopic.TopicConfigOptionsProperty, typing.Dict[builtins.str, typing.Any]]]] = None,
+    custom_instructions: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union[CfnTopic.CustomInstructionsProperty, typing.Dict[builtins.str, typing.Any]]]] = None,
     data_sets: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Sequence[typing.Union[_IResolvable_da3f097b, typing.Union[CfnTopic.DatasetMetadataProperty, typing.Dict[builtins.str, typing.Any]]]]]] = None,
     description: typing.Optional[builtins.str] = None,
     folder_arns: typing.Optional[typing.Sequence[builtins.str]] = None,
@@ -244896,6 +244989,12 @@ def _typecheckingstub__6972dc597cc6d8f7def40f8560b5bfca6605c8ee567f410a1ef660f44
     """Type checking stubs"""
     pass
 
+def _typecheckingstub__a4228e99258c3d4e4cf69c46721540d1bbf33b720b9bb0f99a31d4771ac81291(
+    value: typing.Optional[typing.Union[_IResolvable_da3f097b, CfnTopic.CustomInstructionsProperty]],
+) -> None:
+    """Type checking stubs"""
+    pass
+
 def _typecheckingstub__865dd17cdf0180752414a809eb15588349da7941dd91964b989f41ca7cd29ab4(
     value: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.List[typing.Union[_IResolvable_da3f097b, CfnTopic.DatasetMetadataProperty]]]],
 ) -> None:
@@ -244962,6 +245061,13 @@ def _typecheckingstub__471648aa1c53b0767a1f96087fccfd258d8d0cb568d1b3ae8ddbb3d37
     """Type checking stubs"""
     pass
 
+def _typecheckingstub__4623e8fed89e9724b107d62f351e7f4af85a6e603e6354489f7380506ba9040d(
+    *,
+    custom_instructions_string: builtins.str,
+) -> None:
+    """Type checking stubs"""
+    pass
+
 def _typecheckingstub__6cf5ac3c01c8be3f1bd3d8b91d6b6fa59b49f363c86b67e4f688e399ae84c9d1(
     *,
     dataset_row_date_granularity: typing.Optional[builtins.str] = None,
@@ -245221,6 +245327,7 @@ def _typecheckingstub__594e8a4ec85e161016ae0aa60a6538d619759944135cfd2b531b0f063
     *,
     aws_account_id: typing.Optional[builtins.str] = None,
     config_options: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union[CfnTopic.TopicConfigOptionsProperty, typing.Dict[builtins.str, typing.Any]]]] = None,
+    custom_instructions: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union[CfnTopic.CustomInstructionsProperty, typing.Dict[builtins.str, typing.Any]]]] = None,
     data_sets: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Sequence[typing.Union[_IResolvable_da3f097b, typing.Union[CfnTopic.DatasetMetadataProperty, typing.Dict[builtins.str, typing.Any]]]]]] = None,
     description: typing.Optional[builtins.str] = None,
     folder_arns: typing.Optional[typing.Sequence[builtins.str]] = None,