aws-cdk-lib 2.181.1__py3-none-any.whl → 2.182.0__py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Potentially problematic release.


This version of aws-cdk-lib might be problematic. Click here for more details.

Files changed (49) hide show
  1. aws_cdk/__init__.py +292 -8
  2. aws_cdk/_jsii/__init__.py +1 -1
  3. aws_cdk/_jsii/{aws-cdk-lib@2.181.1.jsii.tgz → aws-cdk-lib@2.182.0.jsii.tgz} +0 -0
  4. aws_cdk/assertions/__init__.py +59 -0
  5. aws_cdk/aws_apigateway/__init__.py +122 -66
  6. aws_cdk/aws_applicationautoscaling/__init__.py +4 -0
  7. aws_cdk/aws_appsync/__init__.py +30 -4
  8. aws_cdk/aws_autoscaling/__init__.py +409 -36
  9. aws_cdk/aws_batch/__init__.py +629 -11
  10. aws_cdk/aws_bedrock/__init__.py +204 -0
  11. aws_cdk/aws_certificatemanager/__init__.py +24 -0
  12. aws_cdk/aws_cloudformation/__init__.py +284 -2
  13. aws_cdk/aws_cloudfront/__init__.py +1 -0
  14. aws_cdk/aws_cloudtrail/__init__.py +4 -4
  15. aws_cdk/aws_datazone/__init__.py +82 -0
  16. aws_cdk/aws_ec2/__init__.py +32 -12
  17. aws_cdk/aws_ecr/__init__.py +10 -4
  18. aws_cdk/aws_ecs/__init__.py +58 -9
  19. aws_cdk/aws_eks/__init__.py +32 -3
  20. aws_cdk/aws_fsx/__init__.py +2 -0
  21. aws_cdk/aws_guardduty/__init__.py +38 -26
  22. aws_cdk/aws_iam/__init__.py +5 -2
  23. aws_cdk/aws_inspector/__init__.py +176 -0
  24. aws_cdk/aws_iotsitewise/__init__.py +2 -3
  25. aws_cdk/aws_kinesisfirehose/__init__.py +6 -0
  26. aws_cdk/aws_lambda/__init__.py +8 -0
  27. aws_cdk/aws_logs/__init__.py +2 -0
  28. aws_cdk/aws_mediapackagev2/__init__.py +22 -14
  29. aws_cdk/aws_opensearchservice/__init__.py +261 -1
  30. aws_cdk/aws_pcaconnectorad/__init__.py +30 -4
  31. aws_cdk/aws_pipes/__init__.py +6 -2
  32. aws_cdk/aws_quicksight/__init__.py +225 -451
  33. aws_cdk/aws_rds/__init__.py +50 -13
  34. aws_cdk/aws_s3/__init__.py +8 -0
  35. aws_cdk/aws_sagemaker/__init__.py +68 -13
  36. aws_cdk/aws_sns/__init__.py +76 -1
  37. aws_cdk/aws_vpclattice/__init__.py +144 -9
  38. aws_cdk/aws_wafv2/__init__.py +702 -0
  39. aws_cdk/aws_wisdom/__init__.py +3 -110
  40. aws_cdk/aws_workspacesthinclient/__init__.py +4 -4
  41. aws_cdk/aws_workspacesweb/__init__.py +179 -2
  42. aws_cdk/cloud_assembly_schema/__init__.py +224 -4
  43. aws_cdk/cx_api/__init__.py +2 -1
  44. {aws_cdk_lib-2.181.1.dist-info → aws_cdk_lib-2.182.0.dist-info}/METADATA +2 -2
  45. {aws_cdk_lib-2.181.1.dist-info → aws_cdk_lib-2.182.0.dist-info}/RECORD +49 -49
  46. {aws_cdk_lib-2.181.1.dist-info → aws_cdk_lib-2.182.0.dist-info}/LICENSE +0 -0
  47. {aws_cdk_lib-2.181.1.dist-info → aws_cdk_lib-2.182.0.dist-info}/NOTICE +0 -0
  48. {aws_cdk_lib-2.181.1.dist-info → aws_cdk_lib-2.182.0.dist-info}/WHEEL +0 -0
  49. {aws_cdk_lib-2.181.1.dist-info → aws_cdk_lib-2.182.0.dist-info}/top_level.txt +0 -0
@@ -464,6 +464,27 @@ cluster = rds.DatabaseCluster(self, "Database",
464
464
  )
465
465
  ```
466
466
 
467
+ ### Creating a read replica cluster
468
+
469
+ Use `replicationSourceIdentifier` to create a read replica cluster:
470
+
471
+ ```python
472
+ # vpc: ec2.Vpc
473
+ # primary_cluster: rds.DatabaseCluster
474
+
475
+
476
+ rds.DatabaseCluster(self, "DatabaseCluster",
477
+ engine=rds.DatabaseClusterEngine.aurora_mysql(
478
+ version=rds.AuroraMysqlEngineVersion.VER_3_03_0
479
+ ),
480
+ writer=rds.ClusterInstance.serverless_v2("Writer"),
481
+ vpc=vpc,
482
+ replication_source_identifier=primary_cluster.cluster_arn
483
+ )
484
+ ```
485
+
486
+ **Note**: Cannot create a read replica cluster with `credentials` as the value is inherited from the source DB cluster.
487
+
467
488
  ## Starting an instance database
468
489
 
469
490
  To set up an instance database, define a `DatabaseInstance`. You must
@@ -2238,17 +2259,11 @@ class AuroraMysqlClusterEngineProps:
2238
2259
 
2239
2260
  cluster = rds.DatabaseCluster(self, "Database",
2240
2261
  engine=rds.DatabaseClusterEngine.aurora_mysql(version=rds.AuroraMysqlEngineVersion.VER_3_01_0),
2241
- credentials=rds.Credentials.from_generated_secret("clusteradmin"), # Optional - will default to 'admin' username and generated password
2242
- writer=rds.ClusterInstance.provisioned("writer",
2243
- publicly_accessible=False
2244
- ),
2245
- readers=[
2246
- rds.ClusterInstance.provisioned("reader1", promotion_tier=1),
2247
- rds.ClusterInstance.serverless_v2("reader2")
2248
- ],
2249
- vpc_subnets=ec2.SubnetSelection(
2250
- subnet_type=ec2.SubnetType.PRIVATE_WITH_EGRESS
2262
+ writer=rds.ClusterInstance.provisioned("Instance",
2263
+ instance_type=ec2.InstanceType.of(ec2.InstanceClass.BURSTABLE3, ec2.InstanceSize.SMALL)
2251
2264
  ),
2265
+ readers=[rds.ClusterInstance.provisioned("reader")],
2266
+ instance_update_behaviour=rds.InstanceUpdateBehaviour.ROLLING, # Optional - defaults to rds.InstanceUpdateBehaviour.BULK
2252
2267
  vpc=vpc
2253
2268
  )
2254
2269
  '''
@@ -5131,7 +5146,7 @@ class CfnDBCluster(
5131
5146
  :param backup_retention_period: The number of days for which automated backups are retained. Default: 1 Constraints: - Must be a value from 1 to 35 Valid for: Aurora DB clusters and Multi-AZ DB clusters Default: - 1
5132
5147
  :param cluster_scalability_type: Specifies the scalability mode of the Aurora DB cluster. When set to ``limitless`` , the cluster operates as an Aurora Limitless Database, allowing you to create a DB shard group for horizontal scaling (sharding) capabilities. When set to ``standard`` (the default), the cluster uses normal DB instance creation.
5133
5148
  :param copy_tags_to_snapshot: A value that indicates whether to copy all tags from the DB cluster to snapshots of the DB cluster. The default is not to copy them. Valid for: Aurora DB clusters and Multi-AZ DB clusters
5134
- :param database_insights_mode: The mode of Database Insights to enable for the DB cluster. If you set this value to ``advanced`` , you must also set the ``PerformanceInsightsEnabled`` parameter to ``true`` and the ``PerformanceInsightsRetentionPeriod`` parameter to 465. Valid for Cluster Type: Aurora DB clusters only
5149
+ :param database_insights_mode: The mode of Database Insights to enable for the DB cluster. If you set this value to ``advanced`` , you must also set the ``PerformanceInsightsEnabled`` parameter to ``true`` and the ``PerformanceInsightsRetentionPeriod`` parameter to 465. Valid for Cluster Type: Aurora DB clusters and Multi-AZ DB clusters
5135
5150
  :param database_name: The name of your database. If you don't provide a name, then Amazon RDS won't create a database in this DB cluster. For naming constraints, see `Naming Constraints <https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/CHAP_Limits.html#RDS_Limits.Constraints>`_ in the *Amazon Aurora User Guide* . Valid for: Aurora DB clusters and Multi-AZ DB clusters
5136
5151
  :param db_cluster_identifier: The DB cluster identifier. This parameter is stored as a lowercase string. Constraints: - Must contain from 1 to 63 letters, numbers, or hyphens. - First character must be a letter. - Can't end with a hyphen or contain two consecutive hyphens. Example: ``my-cluster1`` Valid for: Aurora DB clusters and Multi-AZ DB clusters
5137
5152
  :param db_cluster_instance_class: The compute and memory capacity of each DB instance in the Multi-AZ DB cluster, for example ``db.m6gd.xlarge`` . Not all DB instance classes are available in all AWS Regions , or for all database engines. For the full list of DB instance classes and availability for your engine, see `DB instance class <https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/Concepts.DBInstanceClass.html>`_ in the *Amazon RDS User Guide* . This setting is required to create a Multi-AZ DB cluster. Valid for Cluster Type: Multi-AZ DB clusters only
@@ -7325,7 +7340,7 @@ class CfnDBClusterProps:
7325
7340
  :param backup_retention_period: The number of days for which automated backups are retained. Default: 1 Constraints: - Must be a value from 1 to 35 Valid for: Aurora DB clusters and Multi-AZ DB clusters Default: - 1
7326
7341
  :param cluster_scalability_type: Specifies the scalability mode of the Aurora DB cluster. When set to ``limitless`` , the cluster operates as an Aurora Limitless Database, allowing you to create a DB shard group for horizontal scaling (sharding) capabilities. When set to ``standard`` (the default), the cluster uses normal DB instance creation.
7327
7342
  :param copy_tags_to_snapshot: A value that indicates whether to copy all tags from the DB cluster to snapshots of the DB cluster. The default is not to copy them. Valid for: Aurora DB clusters and Multi-AZ DB clusters
7328
- :param database_insights_mode: The mode of Database Insights to enable for the DB cluster. If you set this value to ``advanced`` , you must also set the ``PerformanceInsightsEnabled`` parameter to ``true`` and the ``PerformanceInsightsRetentionPeriod`` parameter to 465. Valid for Cluster Type: Aurora DB clusters only
7343
+ :param database_insights_mode: The mode of Database Insights to enable for the DB cluster. If you set this value to ``advanced`` , you must also set the ``PerformanceInsightsEnabled`` parameter to ``true`` and the ``PerformanceInsightsRetentionPeriod`` parameter to 465. Valid for Cluster Type: Aurora DB clusters and Multi-AZ DB clusters
7329
7344
  :param database_name: The name of your database. If you don't provide a name, then Amazon RDS won't create a database in this DB cluster. For naming constraints, see `Naming Constraints <https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/CHAP_Limits.html#RDS_Limits.Constraints>`_ in the *Amazon Aurora User Guide* . Valid for: Aurora DB clusters and Multi-AZ DB clusters
7330
7345
  :param db_cluster_identifier: The DB cluster identifier. This parameter is stored as a lowercase string. Constraints: - Must contain from 1 to 63 letters, numbers, or hyphens. - First character must be a letter. - Can't end with a hyphen or contain two consecutive hyphens. Example: ``my-cluster1`` Valid for: Aurora DB clusters and Multi-AZ DB clusters
7331
7346
  :param db_cluster_instance_class: The compute and memory capacity of each DB instance in the Multi-AZ DB cluster, for example ``db.m6gd.xlarge`` . Not all DB instance classes are available in all AWS Regions , or for all database engines. For the full list of DB instance classes and availability for your engine, see `DB instance class <https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/Concepts.DBInstanceClass.html>`_ in the *Amazon RDS User Guide* . This setting is required to create a Multi-AZ DB cluster. Valid for Cluster Type: Multi-AZ DB clusters only
@@ -7770,7 +7785,7 @@ class CfnDBClusterProps:
7770
7785
 
7771
7786
  If you set this value to ``advanced`` , you must also set the ``PerformanceInsightsEnabled`` parameter to ``true`` and the ``PerformanceInsightsRetentionPeriod`` parameter to 465.
7772
7787
 
7773
- Valid for Cluster Type: Aurora DB clusters only
7788
+ Valid for Cluster Type: Aurora DB clusters and Multi-AZ DB clusters
7774
7789
 
7775
7790
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-rds-dbcluster.html#cfn-rds-dbcluster-databaseinsightsmode
7776
7791
  '''
@@ -21950,6 +21965,7 @@ class DatabaseClusterFromSnapshotProps:
21950
21965
  "preferred_maintenance_window": "preferredMaintenanceWindow",
21951
21966
  "readers": "readers",
21952
21967
  "removal_policy": "removalPolicy",
21968
+ "replication_source_identifier": "replicationSourceIdentifier",
21953
21969
  "s3_export_buckets": "s3ExportBuckets",
21954
21970
  "s3_export_role": "s3ExportRole",
21955
21971
  "s3_import_buckets": "s3ImportBuckets",
@@ -22007,6 +22023,7 @@ class DatabaseClusterProps:
22007
22023
  preferred_maintenance_window: typing.Optional[builtins.str] = None,
22008
22024
  readers: typing.Optional[typing.Sequence["IClusterInstance"]] = None,
22009
22025
  removal_policy: typing.Optional[_RemovalPolicy_9f93c814] = None,
22026
+ replication_source_identifier: typing.Optional[builtins.str] = None,
22010
22027
  s3_export_buckets: typing.Optional[typing.Sequence[_IBucket_42e086fd]] = None,
22011
22028
  s3_export_role: typing.Optional[_IRole_235f5d8e] = None,
22012
22029
  s3_import_buckets: typing.Optional[typing.Sequence[_IBucket_42e086fd]] = None,
@@ -22061,6 +22078,7 @@ class DatabaseClusterProps:
22061
22078
  :param preferred_maintenance_window: A preferred maintenance window day/time range. Should be specified as a range ddd:hh24:mi-ddd:hh24:mi (24H Clock UTC). Example: 'Sun:23:45-Mon:00:15' Default: - 30-minute window selected at random from an 8-hour block of time for each AWS Region, occurring on a random day of the week.
22062
22079
  :param readers: A list of instances to create as cluster reader instances. Default: - no readers are created. The cluster will have a single writer/reader
22063
22080
  :param removal_policy: The removal policy to apply when the cluster and its instances are removed from the stack or replaced during an update. Default: - RemovalPolicy.SNAPSHOT (remove the cluster and instances, but retain a snapshot of the data)
22081
+ :param replication_source_identifier: The Amazon Resource Name (ARN) of the source DB instance or DB cluster if this DB cluster is created as a read replica. Cannot be used with credentials. Default: - This DB Cluster is not a read replica
22064
22082
  :param s3_export_buckets: S3 buckets that you want to load data into. This feature is only supported by the Aurora database engine. This property must not be used if ``s3ExportRole`` is used. For MySQL: Default: - None
22065
22083
  :param s3_export_role: Role that will be associated with this DB cluster to enable S3 export. This feature is only supported by the Aurora database engine. This property must not be used if ``s3ExportBuckets`` is used. To use this property with Aurora PostgreSQL, it must be configured with the S3 export feature enabled when creating the DatabaseClusterEngine For MySQL: Default: - New role is created if ``s3ExportBuckets`` is set, no role is defined otherwise
22066
22084
  :param s3_import_buckets: S3 buckets that you want to load data from. This feature is only supported by the Aurora database engine. This property must not be used if ``s3ImportRole`` is used. For MySQL: Default: - None
@@ -22143,6 +22161,7 @@ class DatabaseClusterProps:
22143
22161
  check_type(argname="argument preferred_maintenance_window", value=preferred_maintenance_window, expected_type=type_hints["preferred_maintenance_window"])
22144
22162
  check_type(argname="argument readers", value=readers, expected_type=type_hints["readers"])
22145
22163
  check_type(argname="argument removal_policy", value=removal_policy, expected_type=type_hints["removal_policy"])
22164
+ check_type(argname="argument replication_source_identifier", value=replication_source_identifier, expected_type=type_hints["replication_source_identifier"])
22146
22165
  check_type(argname="argument s3_export_buckets", value=s3_export_buckets, expected_type=type_hints["s3_export_buckets"])
22147
22166
  check_type(argname="argument s3_export_role", value=s3_export_role, expected_type=type_hints["s3_export_role"])
22148
22167
  check_type(argname="argument s3_import_buckets", value=s3_import_buckets, expected_type=type_hints["s3_import_buckets"])
@@ -22232,6 +22251,8 @@ class DatabaseClusterProps:
22232
22251
  self._values["readers"] = readers
22233
22252
  if removal_policy is not None:
22234
22253
  self._values["removal_policy"] = removal_policy
22254
+ if replication_source_identifier is not None:
22255
+ self._values["replication_source_identifier"] = replication_source_identifier
22235
22256
  if s3_export_buckets is not None:
22236
22257
  self._values["s3_export_buckets"] = s3_export_buckets
22237
22258
  if s3_export_role is not None:
@@ -22670,6 +22691,17 @@ class DatabaseClusterProps:
22670
22691
  result = self._values.get("removal_policy")
22671
22692
  return typing.cast(typing.Optional[_RemovalPolicy_9f93c814], result)
22672
22693
 
22694
+ @builtins.property
22695
+ def replication_source_identifier(self) -> typing.Optional[builtins.str]:
22696
+ '''The Amazon Resource Name (ARN) of the source DB instance or DB cluster if this DB cluster is created as a read replica.
22697
+
22698
+ Cannot be used with credentials.
22699
+
22700
+ :default: - This DB Cluster is not a read replica
22701
+ '''
22702
+ result = self._values.get("replication_source_identifier")
22703
+ return typing.cast(typing.Optional[builtins.str], result)
22704
+
22673
22705
  @builtins.property
22674
22706
  def s3_export_buckets(self) -> typing.Optional[typing.List[_IBucket_42e086fd]]:
22675
22707
  '''S3 buckets that you want to load data into. This feature is only supported by the Aurora database engine.
@@ -46044,6 +46076,7 @@ class DatabaseCluster(
46044
46076
  preferred_maintenance_window: typing.Optional[builtins.str] = None,
46045
46077
  readers: typing.Optional[typing.Sequence[IClusterInstance]] = None,
46046
46078
  removal_policy: typing.Optional[_RemovalPolicy_9f93c814] = None,
46079
+ replication_source_identifier: typing.Optional[builtins.str] = None,
46047
46080
  s3_export_buckets: typing.Optional[typing.Sequence[_IBucket_42e086fd]] = None,
46048
46081
  s3_export_role: typing.Optional[_IRole_235f5d8e] = None,
46049
46082
  s3_import_buckets: typing.Optional[typing.Sequence[_IBucket_42e086fd]] = None,
@@ -46099,6 +46132,7 @@ class DatabaseCluster(
46099
46132
  :param preferred_maintenance_window: A preferred maintenance window day/time range. Should be specified as a range ddd:hh24:mi-ddd:hh24:mi (24H Clock UTC). Example: 'Sun:23:45-Mon:00:15' Default: - 30-minute window selected at random from an 8-hour block of time for each AWS Region, occurring on a random day of the week.
46100
46133
  :param readers: A list of instances to create as cluster reader instances. Default: - no readers are created. The cluster will have a single writer/reader
46101
46134
  :param removal_policy: The removal policy to apply when the cluster and its instances are removed from the stack or replaced during an update. Default: - RemovalPolicy.SNAPSHOT (remove the cluster and instances, but retain a snapshot of the data)
46135
+ :param replication_source_identifier: The Amazon Resource Name (ARN) of the source DB instance or DB cluster if this DB cluster is created as a read replica. Cannot be used with credentials. Default: - This DB Cluster is not a read replica
46102
46136
  :param s3_export_buckets: S3 buckets that you want to load data into. This feature is only supported by the Aurora database engine. This property must not be used if ``s3ExportRole`` is used. For MySQL: Default: - None
46103
46137
  :param s3_export_role: Role that will be associated with this DB cluster to enable S3 export. This feature is only supported by the Aurora database engine. This property must not be used if ``s3ExportBuckets`` is used. To use this property with Aurora PostgreSQL, it must be configured with the S3 export feature enabled when creating the DatabaseClusterEngine For MySQL: Default: - New role is created if ``s3ExportBuckets`` is set, no role is defined otherwise
46104
46138
  :param s3_import_buckets: S3 buckets that you want to load data from. This feature is only supported by the Aurora database engine. This property must not be used if ``s3ImportRole`` is used. For MySQL: Default: - None
@@ -46156,6 +46190,7 @@ class DatabaseCluster(
46156
46190
  preferred_maintenance_window=preferred_maintenance_window,
46157
46191
  readers=readers,
46158
46192
  removal_policy=removal_policy,
46193
+ replication_source_identifier=replication_source_identifier,
46159
46194
  s3_export_buckets=s3_export_buckets,
46160
46195
  s3_export_role=s3_export_role,
46161
46196
  s3_import_buckets=s3_import_buckets,
@@ -49904,6 +49939,7 @@ def _typecheckingstub__a32e21c90ab65d3cfdb3b7ef2a0d741ba1528ec8824cd1817d1e485b4
49904
49939
  preferred_maintenance_window: typing.Optional[builtins.str] = None,
49905
49940
  readers: typing.Optional[typing.Sequence[IClusterInstance]] = None,
49906
49941
  removal_policy: typing.Optional[_RemovalPolicy_9f93c814] = None,
49942
+ replication_source_identifier: typing.Optional[builtins.str] = None,
49907
49943
  s3_export_buckets: typing.Optional[typing.Sequence[_IBucket_42e086fd]] = None,
49908
49944
  s3_export_role: typing.Optional[_IRole_235f5d8e] = None,
49909
49945
  s3_import_buckets: typing.Optional[typing.Sequence[_IBucket_42e086fd]] = None,
@@ -51624,6 +51660,7 @@ def _typecheckingstub__c6184cbbefaa372690b9776dafecbf5857cf9bfbab91d1666aad22c56
51624
51660
  preferred_maintenance_window: typing.Optional[builtins.str] = None,
51625
51661
  readers: typing.Optional[typing.Sequence[IClusterInstance]] = None,
51626
51662
  removal_policy: typing.Optional[_RemovalPolicy_9f93c814] = None,
51663
+ replication_source_identifier: typing.Optional[builtins.str] = None,
51627
51664
  s3_export_buckets: typing.Optional[typing.Sequence[_IBucket_42e086fd]] = None,
51628
51665
  s3_export_role: typing.Optional[_IRole_235f5d8e] = None,
51629
51666
  s3_import_buckets: typing.Optional[typing.Sequence[_IBucket_42e086fd]] = None,
@@ -15740,6 +15740,14 @@ class EventType(enum.Enum):
15740
15740
  An event is not generated when a request results in no change to an
15741
15741
  object’s ACL.
15742
15742
  '''
15743
+ OBJECT_RESTORE = "OBJECT_RESTORE"
15744
+ '''Using restore object event types you can receive notifications for initiation and completion when restoring objects from the S3 Glacier storage class.
15745
+
15746
+ You use s3:ObjectRestore:* to request notification of
15747
+ any restoration event.
15748
+ '''
15749
+ REPLICATION = "REPLICATION"
15750
+ '''You receive this notification event for any object replication event.'''
15743
15751
 
15744
15752
 
15745
15753
  @jsii.data_type(
@@ -1590,7 +1590,7 @@ class CfnCluster(
1590
1590
  '''
1591
1591
  :param scope: Scope in which this resource is defined.
1592
1592
  :param id: Construct identifier for this resource (unique in its scope).
1593
- :param instance_groups: The instance groups of the SageMaker HyperPod cluster.
1593
+ :param instance_groups: The instance groups of the SageMaker HyperPod cluster. To delete an instance group, remove it from the array.
1594
1594
  :param cluster_name: The name of the SageMaker HyperPod cluster.
1595
1595
  :param node_recovery: Specifies whether to enable or disable the automatic node recovery feature of SageMaker HyperPod. Available values are ``Automatic`` for enabling and ``None`` for disabling.
1596
1596
  :param orchestrator: The orchestrator type for the SageMaker HyperPod cluster. Currently, ``'eks'`` is the only available option.
@@ -1882,7 +1882,7 @@ class CfnCluster(
1882
1882
  :param current_count: The number of instances that are currently in the instance group of a SageMaker HyperPod cluster.
1883
1883
  :param instance_storage_configs: The configurations of additional storage specified to the instance group where the instance (node) is launched.
1884
1884
  :param on_start_deep_health_checks: A flag indicating whether deep health checks should be performed when the HyperPod cluster instance group is created or updated. Deep health checks are comprehensive, invasive tests that validate the health of the underlying hardware and infrastructure components.
1885
- :param override_vpc_config: When specified, overrides the subnet and security group configuration for a specific instance group.
1885
+ :param override_vpc_config: Specifies an Amazon Virtual Private Cloud (VPC) that your SageMaker jobs, hosted models, and compute resources have access to. You can control access to and from your resources by configuring a VPC.
1886
1886
  :param threads_per_core: The number of threads per CPU core you specified under ``CreateCluster`` .
1887
1887
 
1888
1888
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-sagemaker-cluster-clusterinstancegroup.html
@@ -2038,7 +2038,9 @@ class CfnCluster(
2038
2038
  def override_vpc_config(
2039
2039
  self,
2040
2040
  ) -> typing.Optional[typing.Union[_IResolvable_da3f097b, "CfnCluster.VpcConfigProperty"]]:
2041
- '''When specified, overrides the subnet and security group configuration for a specific instance group.
2041
+ '''Specifies an Amazon Virtual Private Cloud (VPC) that your SageMaker jobs, hosted models, and compute resources have access to.
2042
+
2043
+ You can control access to and from your resources by configuring a VPC.
2042
2044
 
2043
2045
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-sagemaker-cluster-clusterinstancegroup.html#cfn-sagemaker-cluster-clusterinstancegroup-overridevpcconfig
2044
2046
  '''
@@ -2422,7 +2424,7 @@ class CfnClusterProps:
2422
2424
  ) -> None:
2423
2425
  '''Properties for defining a ``CfnCluster``.
2424
2426
 
2425
- :param instance_groups: The instance groups of the SageMaker HyperPod cluster.
2427
+ :param instance_groups: The instance groups of the SageMaker HyperPod cluster. To delete an instance group, remove it from the array.
2426
2428
  :param cluster_name: The name of the SageMaker HyperPod cluster.
2427
2429
  :param node_recovery: Specifies whether to enable or disable the automatic node recovery feature of SageMaker HyperPod. Available values are ``Automatic`` for enabling and ``None`` for disabling.
2428
2430
  :param orchestrator: The orchestrator type for the SageMaker HyperPod cluster. Currently, ``'eks'`` is the only available option.
@@ -2510,6 +2512,8 @@ class CfnClusterProps:
2510
2512
  ) -> typing.Union[_IResolvable_da3f097b, typing.List[typing.Union[_IResolvable_da3f097b, CfnCluster.ClusterInstanceGroupProperty]]]:
2511
2513
  '''The instance groups of the SageMaker HyperPod cluster.
2512
2514
 
2515
+ To delete an instance group, remove it from the array.
2516
+
2513
2517
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-sagemaker-cluster.html#cfn-sagemaker-cluster-instancegroups
2514
2518
  '''
2515
2519
  result = self._values.get("instance_groups")
@@ -8286,7 +8290,7 @@ class CfnDomain(
8286
8290
  ) -> None:
8287
8291
  '''The KernelGateway app settings.
8288
8292
 
8289
- :param custom_images: A list of custom SageMaker AI images that are configured to run as a KernelGateway app.
8293
+ :param custom_images: A list of custom SageMaker AI images that are configured to run as a KernelGateway app. The maximum number of custom images are as follows. - On a domain level: 200 - On a space level: 5 - On a user profile level: 5
8290
8294
  :param default_resource_spec: The default instance type and the Amazon Resource Name (ARN) of the default SageMaker AI image used by the KernelGateway app. .. epigraph:: The Amazon SageMaker AI Studio UI does not use the default instance type value set here. The default instance type set here is used when Apps are created using the AWS CLI or AWS CloudFormation and the instance type parameter value is not passed.
8291
8295
  :param lifecycle_config_arns: The Amazon Resource Name (ARN) of the Lifecycle Configurations attached to the the user profile or domain. .. epigraph:: To remove a Lifecycle Config, you must set ``LifecycleConfigArns`` to an empty list.
8292
8296
 
@@ -8335,6 +8339,12 @@ class CfnDomain(
8335
8339
  ) -> typing.Optional[typing.Union[_IResolvable_da3f097b, typing.List[typing.Union[_IResolvable_da3f097b, "CfnDomain.CustomImageProperty"]]]]:
8336
8340
  '''A list of custom SageMaker AI images that are configured to run as a KernelGateway app.
8337
8341
 
8342
+ The maximum number of custom images are as follows.
8343
+
8344
+ - On a domain level: 200
8345
+ - On a space level: 5
8346
+ - On a user profile level: 5
8347
+
8338
8348
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-sagemaker-domain-kernelgatewayappsettings.html#cfn-sagemaker-domain-kernelgatewayappsettings-customimages
8339
8349
  '''
8340
8350
  result = self._values.get("custom_images")
@@ -10984,6 +10994,7 @@ class CfnEndpointConfig(
10984
10994
  accelerator_type="acceleratorType",
10985
10995
  container_startup_health_check_timeout_in_seconds=123,
10986
10996
  enable_ssm_access=False,
10997
+ inference_ami_version="inferenceAmiVersion",
10987
10998
  initial_instance_count=123,
10988
10999
  initial_variant_weight=123,
10989
11000
  instance_type="instanceType",
@@ -11087,6 +11098,7 @@ class CfnEndpointConfig(
11087
11098
  accelerator_type="acceleratorType",
11088
11099
  container_startup_health_check_timeout_in_seconds=123,
11089
11100
  enable_ssm_access=False,
11101
+ inference_ami_version="inferenceAmiVersion",
11090
11102
  initial_instance_count=123,
11091
11103
  initial_variant_weight=123,
11092
11104
  instance_type="instanceType",
@@ -12924,6 +12936,7 @@ class CfnEndpointConfig(
12924
12936
  "accelerator_type": "acceleratorType",
12925
12937
  "container_startup_health_check_timeout_in_seconds": "containerStartupHealthCheckTimeoutInSeconds",
12926
12938
  "enable_ssm_access": "enableSsmAccess",
12939
+ "inference_ami_version": "inferenceAmiVersion",
12927
12940
  "initial_instance_count": "initialInstanceCount",
12928
12941
  "initial_variant_weight": "initialVariantWeight",
12929
12942
  "instance_type": "instanceType",
@@ -12943,6 +12956,7 @@ class CfnEndpointConfig(
12943
12956
  accelerator_type: typing.Optional[builtins.str] = None,
12944
12957
  container_startup_health_check_timeout_in_seconds: typing.Optional[jsii.Number] = None,
12945
12958
  enable_ssm_access: typing.Optional[typing.Union[builtins.bool, _IResolvable_da3f097b]] = None,
12959
+ inference_ami_version: typing.Optional[builtins.str] = None,
12946
12960
  initial_instance_count: typing.Optional[jsii.Number] = None,
12947
12961
  initial_variant_weight: typing.Optional[jsii.Number] = None,
12948
12962
  instance_type: typing.Optional[builtins.str] = None,
@@ -12961,6 +12975,7 @@ class CfnEndpointConfig(
12961
12975
  :param accelerator_type: The size of the Elastic Inference (EI) instance to use for the production variant. EI instances provide on-demand GPU computing for inference. For more information, see `Using Elastic Inference in Amazon SageMaker <https://docs.aws.amazon.com/sagemaker/latest/dg/ei.html>`_ . For more information, see `Using Elastic Inference in Amazon SageMaker <https://docs.aws.amazon.com/sagemaker/latest/dg/ei.html>`_ .
12962
12976
  :param container_startup_health_check_timeout_in_seconds: The timeout value, in seconds, for your inference container to pass health check by SageMaker Hosting. For more information about health check, see `How Your Container Should Respond to Health Check (Ping) Requests <https://docs.aws.amazon.com/sagemaker/latest/dg/your-algorithms-inference-code.html#your-algorithms-inference-algo-ping-requests>`_ .
12963
12977
  :param enable_ssm_access: You can use this parameter to turn on native AWS Systems Manager (SSM) access for a production variant behind an endpoint. By default, SSM access is disabled for all production variants behind an endpoint. You can turn on or turn off SSM access for a production variant behind an existing endpoint by creating a new endpoint configuration and calling ``UpdateEndpoint`` .
12978
+ :param inference_ami_version:
12964
12979
  :param initial_instance_count: Number of instances to launch initially.
12965
12980
  :param initial_variant_weight: Determines initial traffic distribution among all of the models that you specify in the endpoint configuration. The traffic to a production variant is determined by the ratio of the ``VariantWeight`` to the sum of all ``VariantWeight`` values across all ProductionVariants. If unspecified, it defaults to 1.0.
12966
12981
  :param instance_type: The ML compute instance type.
@@ -12987,6 +13002,7 @@ class CfnEndpointConfig(
12987
13002
  accelerator_type="acceleratorType",
12988
13003
  container_startup_health_check_timeout_in_seconds=123,
12989
13004
  enable_ssm_access=False,
13005
+ inference_ami_version="inferenceAmiVersion",
12990
13006
  initial_instance_count=123,
12991
13007
  initial_variant_weight=123,
12992
13008
  instance_type="instanceType",
@@ -13016,6 +13032,7 @@ class CfnEndpointConfig(
13016
13032
  check_type(argname="argument accelerator_type", value=accelerator_type, expected_type=type_hints["accelerator_type"])
13017
13033
  check_type(argname="argument container_startup_health_check_timeout_in_seconds", value=container_startup_health_check_timeout_in_seconds, expected_type=type_hints["container_startup_health_check_timeout_in_seconds"])
13018
13034
  check_type(argname="argument enable_ssm_access", value=enable_ssm_access, expected_type=type_hints["enable_ssm_access"])
13035
+ check_type(argname="argument inference_ami_version", value=inference_ami_version, expected_type=type_hints["inference_ami_version"])
13019
13036
  check_type(argname="argument initial_instance_count", value=initial_instance_count, expected_type=type_hints["initial_instance_count"])
13020
13037
  check_type(argname="argument initial_variant_weight", value=initial_variant_weight, expected_type=type_hints["initial_variant_weight"])
13021
13038
  check_type(argname="argument instance_type", value=instance_type, expected_type=type_hints["instance_type"])
@@ -13034,6 +13051,8 @@ class CfnEndpointConfig(
13034
13051
  self._values["container_startup_health_check_timeout_in_seconds"] = container_startup_health_check_timeout_in_seconds
13035
13052
  if enable_ssm_access is not None:
13036
13053
  self._values["enable_ssm_access"] = enable_ssm_access
13054
+ if inference_ami_version is not None:
13055
+ self._values["inference_ami_version"] = inference_ami_version
13037
13056
  if initial_instance_count is not None:
13038
13057
  self._values["initial_instance_count"] = initial_instance_count
13039
13058
  if initial_variant_weight is not None:
@@ -13100,6 +13119,14 @@ class CfnEndpointConfig(
13100
13119
  result = self._values.get("enable_ssm_access")
13101
13120
  return typing.cast(typing.Optional[typing.Union[builtins.bool, _IResolvable_da3f097b]], result)
13102
13121
 
13122
+ @builtins.property
13123
+ def inference_ami_version(self) -> typing.Optional[builtins.str]:
13124
+ '''
13125
+ :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-sagemaker-endpointconfig-productionvariant.html#cfn-sagemaker-endpointconfig-productionvariant-inferenceamiversion
13126
+ '''
13127
+ result = self._values.get("inference_ami_version")
13128
+ return typing.cast(typing.Optional[builtins.str], result)
13129
+
13103
13130
  @builtins.property
13104
13131
  def initial_instance_count(self) -> typing.Optional[jsii.Number]:
13105
13132
  '''Number of instances to launch initially.
@@ -13491,6 +13518,7 @@ class CfnEndpointConfigProps:
13491
13518
  accelerator_type="acceleratorType",
13492
13519
  container_startup_health_check_timeout_in_seconds=123,
13493
13520
  enable_ssm_access=False,
13521
+ inference_ami_version="inferenceAmiVersion",
13494
13522
  initial_instance_count=123,
13495
13523
  initial_variant_weight=123,
13496
13524
  instance_type="instanceType",
@@ -13594,6 +13622,7 @@ class CfnEndpointConfigProps:
13594
13622
  accelerator_type="acceleratorType",
13595
13623
  container_startup_health_check_timeout_in_seconds=123,
13596
13624
  enable_ssm_access=False,
13625
+ inference_ami_version="inferenceAmiVersion",
13597
13626
  initial_instance_count=123,
13598
13627
  initial_variant_weight=123,
13599
13628
  instance_type="instanceType",
@@ -28793,7 +28822,14 @@ class CfnModelPackage(
28793
28822
  metaclass=jsii.JSIIMeta,
28794
28823
  jsii_type="aws-cdk-lib.aws_sagemaker.CfnModelPackage",
28795
28824
  ):
28796
- '''A versioned model that can be deployed for SageMaker inference.
28825
+ '''A container for your trained model that can be deployed for SageMaker inference.
28826
+
28827
+ This can include inference code, artifacts, and metadata. The model package type can be one of the following.
28828
+
28829
+ - Versioned model: A part of a model package group in Model Registry.
28830
+ - Unversioned model: Not part of a model package group and used in AWS Marketplace.
28831
+
28832
+ For more information, see ```CreateModelPackage`` <https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_CreateModelPackage.html>`_ .
28797
28833
 
28798
28834
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-sagemaker-modelpackage.html
28799
28835
  :cloudformationResource: AWS::SageMaker::ModelPackage
@@ -29206,7 +29242,7 @@ class CfnModelPackage(
29206
29242
  :param model_metrics: Metrics for the model.
29207
29243
  :param model_package_description: The description of the model package.
29208
29244
  :param model_package_group_name: The model group to which the model belongs.
29209
- :param model_package_name: The name of the model.
29245
+ :param model_package_name: The name of the model package. The name can be as follows:. - For a versioned model, the name is automatically generated by SageMaker Model Registry and follows the format ' ``ModelPackageGroupName/ModelPackageVersion`` '. - For an unversioned model, you must provide the name.
29210
29246
  :param model_package_status_details: Specifies the validation and image scan statuses of the model package.
29211
29247
  :param model_package_version: The version number of a versioned model.
29212
29248
  :param sample_payload_url: The Amazon Simple Storage Service path where the sample payload are stored. This path must point to a single gzip compressed tar archive (.tar.gz suffix).
@@ -29587,7 +29623,10 @@ class CfnModelPackage(
29587
29623
  @builtins.property
29588
29624
  @jsii.member(jsii_name="modelPackageName")
29589
29625
  def model_package_name(self) -> typing.Optional[builtins.str]:
29590
- '''The name of the model.'''
29626
+ '''The name of the model package.
29627
+
29628
+ The name can be as follows:.
29629
+ '''
29591
29630
  return typing.cast(typing.Optional[builtins.str], jsii.get(self, "modelPackageName"))
29592
29631
 
29593
29632
  @model_package_name.setter
@@ -33432,7 +33471,7 @@ class CfnModelPackageGroup(
33432
33471
  metaclass=jsii.JSIIMeta,
33433
33472
  jsii_type="aws-cdk-lib.aws_sagemaker.CfnModelPackageGroup",
33434
33473
  ):
33435
- '''A group of versioned models in the model registry.
33474
+ '''A group of versioned models in the Model Registry.
33436
33475
 
33437
33476
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-sagemaker-modelpackagegroup.html
33438
33477
  :cloudformationResource: AWS::SageMaker::ModelPackageGroup
@@ -33815,7 +33854,7 @@ class CfnModelPackageProps:
33815
33854
  :param model_metrics: Metrics for the model.
33816
33855
  :param model_package_description: The description of the model package.
33817
33856
  :param model_package_group_name: The model group to which the model belongs.
33818
- :param model_package_name: The name of the model.
33857
+ :param model_package_name: The name of the model package. The name can be as follows:. - For a versioned model, the name is automatically generated by SageMaker Model Registry and follows the format ' ``ModelPackageGroupName/ModelPackageVersion`` '. - For an unversioned model, you must provide the name.
33819
33858
  :param model_package_status_details: Specifies the validation and image scan statuses of the model package.
33820
33859
  :param model_package_version: The version number of a versioned model.
33821
33860
  :param sample_payload_url: The Amazon Simple Storage Service path where the sample payload are stored. This path must point to a single gzip compressed tar archive (.tar.gz suffix).
@@ -34443,7 +34482,10 @@ class CfnModelPackageProps:
34443
34482
 
34444
34483
  @builtins.property
34445
34484
  def model_package_name(self) -> typing.Optional[builtins.str]:
34446
- '''The name of the model.
34485
+ '''The name of the model package. The name can be as follows:.
34486
+
34487
+ - For a versioned model, the name is automatically generated by SageMaker Model Registry and follows the format ' ``ModelPackageGroupName/ModelPackageVersion`` '.
34488
+ - For an unversioned model, you must provide the name.
34447
34489
 
34448
34490
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-sagemaker-modelpackage.html#cfn-sagemaker-modelpackage-modelpackagename
34449
34491
  '''
@@ -44224,7 +44266,7 @@ class CfnSpace(
44224
44266
  ) -> None:
44225
44267
  '''The KernelGateway app settings.
44226
44268
 
44227
- :param custom_images: A list of custom SageMaker AI images that are configured to run as a KernelGateway app.
44269
+ :param custom_images: A list of custom SageMaker AI images that are configured to run as a KernelGateway app. The maximum number of custom images are as follows. - On a domain level: 200 - On a space level: 5 - On a user profile level: 5
44228
44270
  :param default_resource_spec: The default instance type and the Amazon Resource Name (ARN) of the default SageMaker AI image used by the KernelGateway app. .. epigraph:: The Amazon SageMaker AI Studio UI does not use the default instance type value set here. The default instance type set here is used when Apps are created using the AWS CLI or AWS CloudFormation and the instance type parameter value is not passed.
44229
44271
  :param lifecycle_config_arns: The Amazon Resource Name (ARN) of the Lifecycle Configurations attached to the the user profile or domain. .. epigraph:: To remove a Lifecycle Config, you must set ``LifecycleConfigArns`` to an empty list.
44230
44272
 
@@ -44273,6 +44315,12 @@ class CfnSpace(
44273
44315
  ) -> typing.Optional[typing.Union[_IResolvable_da3f097b, typing.List[typing.Union[_IResolvable_da3f097b, "CfnSpace.CustomImageProperty"]]]]:
44274
44316
  '''A list of custom SageMaker AI images that are configured to run as a KernelGateway app.
44275
44317
 
44318
+ The maximum number of custom images are as follows.
44319
+
44320
+ - On a domain level: 200
44321
+ - On a space level: 5
44322
+ - On a user profile level: 5
44323
+
44276
44324
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-sagemaker-space-kernelgatewayappsettings.html#cfn-sagemaker-space-kernelgatewayappsettings-customimages
44277
44325
  '''
44278
44326
  result = self._values.get("custom_images")
@@ -47131,7 +47179,7 @@ class CfnUserProfile(
47131
47179
  ) -> None:
47132
47180
  '''The KernelGateway app settings.
47133
47181
 
47134
- :param custom_images: A list of custom SageMaker AI images that are configured to run as a KernelGateway app.
47182
+ :param custom_images: A list of custom SageMaker AI images that are configured to run as a KernelGateway app. The maximum number of custom images are as follows. - On a domain level: 200 - On a space level: 5 - On a user profile level: 5
47135
47183
  :param default_resource_spec: The default instance type and the Amazon Resource Name (ARN) of the default SageMaker AI image used by the KernelGateway app. .. epigraph:: The Amazon SageMaker AI Studio UI does not use the default instance type value set here. The default instance type set here is used when Apps are created using the AWS CLI or AWS CloudFormation and the instance type parameter value is not passed.
47136
47184
  :param lifecycle_config_arns: The Amazon Resource Name (ARN) of the Lifecycle Configurations attached to the the user profile or domain. .. epigraph:: To remove a Lifecycle Config, you must set ``LifecycleConfigArns`` to an empty list.
47137
47185
 
@@ -47180,6 +47228,12 @@ class CfnUserProfile(
47180
47228
  ) -> typing.Optional[typing.Union[_IResolvable_da3f097b, typing.List[typing.Union[_IResolvable_da3f097b, "CfnUserProfile.CustomImageProperty"]]]]:
47181
47229
  '''A list of custom SageMaker AI images that are configured to run as a KernelGateway app.
47182
47230
 
47231
+ The maximum number of custom images are as follows.
47232
+
47233
+ - On a domain level: 200
47234
+ - On a space level: 5
47235
+ - On a user profile level: 5
47236
+
47183
47237
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-sagemaker-userprofile-kernelgatewayappsettings.html#cfn-sagemaker-userprofile-kernelgatewayappsettings-customimages
47184
47238
  '''
47185
47239
  result = self._values.get("custom_images")
@@ -50686,6 +50740,7 @@ def _typecheckingstub__685c22aefe4bd12e237f4e6f239c6de7809e228c81d2604127d6824fa
50686
50740
  accelerator_type: typing.Optional[builtins.str] = None,
50687
50741
  container_startup_health_check_timeout_in_seconds: typing.Optional[jsii.Number] = None,
50688
50742
  enable_ssm_access: typing.Optional[typing.Union[builtins.bool, _IResolvable_da3f097b]] = None,
50743
+ inference_ami_version: typing.Optional[builtins.str] = None,
50689
50744
  initial_instance_count: typing.Optional[jsii.Number] = None,
50690
50745
  initial_variant_weight: typing.Optional[jsii.Number] = None,
50691
50746
  instance_type: typing.Optional[builtins.str] = None,