aws-cdk-lib 2.197.0__py3-none-any.whl → 2.199.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 (38) hide show
  1. aws_cdk/_jsii/__init__.py +1 -1
  2. aws_cdk/_jsii/{aws-cdk-lib@2.197.0.jsii.tgz → aws-cdk-lib@2.199.0.jsii.tgz} +0 -0
  3. aws_cdk/aws_appconfig/__init__.py +296 -48
  4. aws_cdk/aws_applicationautoscaling/__init__.py +36 -0
  5. aws_cdk/aws_appsync/__init__.py +31 -21
  6. aws_cdk/aws_aps/__init__.py +343 -0
  7. aws_cdk/aws_autoscaling/__init__.py +2 -1
  8. aws_cdk/aws_bedrock/__init__.py +387 -4
  9. aws_cdk/aws_codepipeline/__init__.py +4 -2
  10. aws_cdk/aws_datasync/__init__.py +885 -839
  11. aws_cdk/aws_deadline/__init__.py +23 -4
  12. aws_cdk/aws_ec2/__init__.py +229 -12
  13. aws_cdk/aws_ecs/__init__.py +14 -2
  14. aws_cdk/aws_ecs_patterns/__init__.py +64 -12
  15. aws_cdk/aws_eks/__init__.py +40 -9
  16. aws_cdk/aws_elasticloadbalancingv2/__init__.py +14 -8
  17. aws_cdk/aws_events_targets/__init__.py +78 -1
  18. aws_cdk/aws_gamelift/__init__.py +15 -17
  19. aws_cdk/aws_lex/__init__.py +1245 -172
  20. aws_cdk/aws_mediapackagev2/__init__.py +11 -10
  21. aws_cdk/aws_omics/__init__.py +41 -19
  22. aws_cdk/aws_pcs/__init__.py +126 -0
  23. aws_cdk/aws_rds/__init__.py +48 -21
  24. aws_cdk/aws_rolesanywhere/__init__.py +14 -13
  25. aws_cdk/aws_sagemaker/__init__.py +38 -12
  26. aws_cdk/aws_ses/__init__.py +437 -0
  27. aws_cdk/aws_ssmquicksetup/__init__.py +10 -2
  28. aws_cdk/aws_stepfunctions_tasks/__init__.py +1502 -2
  29. aws_cdk/aws_synthetics/__init__.py +137 -3
  30. aws_cdk/aws_vpclattice/__init__.py +219 -209
  31. aws_cdk/aws_wafv2/__init__.py +4 -4
  32. aws_cdk/aws_workspaces/__init__.py +5 -3
  33. {aws_cdk_lib-2.197.0.dist-info → aws_cdk_lib-2.199.0.dist-info}/METADATA +2 -2
  34. {aws_cdk_lib-2.197.0.dist-info → aws_cdk_lib-2.199.0.dist-info}/RECORD +38 -38
  35. {aws_cdk_lib-2.197.0.dist-info → aws_cdk_lib-2.199.0.dist-info}/LICENSE +0 -0
  36. {aws_cdk_lib-2.197.0.dist-info → aws_cdk_lib-2.199.0.dist-info}/NOTICE +0 -0
  37. {aws_cdk_lib-2.197.0.dist-info → aws_cdk_lib-2.199.0.dist-info}/WHEEL +0 -0
  38. {aws_cdk_lib-2.197.0.dist-info → aws_cdk_lib-2.199.0.dist-info}/top_level.txt +0 -0
@@ -27,6 +27,7 @@ Currently supported are:
27
27
  * [Assign public IP addresses to tasks](#assign-public-ip-addresses-to-tasks)
28
28
  * [Enable Amazon ECS Exec for ECS Task](#enable-amazon-ecs-exec-for-ecs-task)
29
29
  * [Run a Redshift query](#schedule-a-redshift-query-serverless-or-cluster)
30
+ * [Publish to an SNS topic](#publish-to-an-sns-topic)
30
31
 
31
32
  See the README of the `aws-cdk-lib/aws-events` library for more information on
32
33
  EventBridge.
@@ -624,6 +625,40 @@ rule.add_target(targets.RedshiftQuery(workgroup.attr_workgroup_workgroup_arn,
624
625
  sql=["SELECT * FROM foo", "SELECT * FROM baz"]
625
626
  ))
626
627
  ```
628
+
629
+ ## Publish to an SNS Topic
630
+
631
+ Use the `SnsTopic` target to publish to an SNS Topic.
632
+
633
+ The code snippet below creates the scheduled event rule that publishes to an SNS Topic using a resource policy.
634
+
635
+ ```python
636
+ import aws_cdk.aws_sns as sns
637
+
638
+ # topic: sns.ITopic
639
+
640
+
641
+ rule = events.Rule(self, "Rule",
642
+ schedule=events.Schedule.rate(cdk.Duration.hours(1))
643
+ )
644
+
645
+ rule.add_target(targets.SnsTopic(topic))
646
+ ```
647
+
648
+ Alternatively, a role can be attached to the target when the rule is triggered.
649
+
650
+ ```python
651
+ import aws_cdk.aws_sns as sns
652
+
653
+ # topic: sns.ITopic
654
+
655
+
656
+ rule = events.Rule(self, "Rule",
657
+ schedule=events.Schedule.rate(cdk.Duration.hours(1))
658
+ )
659
+
660
+ rule.add_target(targets.SnsTopic(topic, authorize_using_role=True))
661
+ ```
627
662
  '''
628
663
  from pkgutil import extend_path
629
664
  __path__ = extend_path(__path__, __name__)
@@ -3302,14 +3337,18 @@ class SnsTopic(
3302
3337
  self,
3303
3338
  topic: _ITopic_9eca4852,
3304
3339
  *,
3340
+ authorize_using_role: typing.Optional[builtins.bool] = None,
3305
3341
  message: typing.Optional[_RuleTargetInput_6beca786] = None,
3342
+ role: typing.Optional[_IRole_235f5d8e] = None,
3306
3343
  dead_letter_queue: typing.Optional[_IQueue_7ed6f679] = None,
3307
3344
  max_event_age: typing.Optional[_Duration_4839e8c3] = None,
3308
3345
  retry_attempts: typing.Optional[jsii.Number] = None,
3309
3346
  ) -> None:
3310
3347
  '''
3311
3348
  :param topic: -
3349
+ :param authorize_using_role: Specifies whether an IAM role should be used to publish to the topic. Default: - true if ``role`` is provided, false otherwise
3312
3350
  :param message: The message to send to the topic. Default: the entire EventBridge event
3351
+ :param role: The IAM role to be used to publish to the topic. Default: - a new role will be created if ``authorizeUsingRole`` is true
3313
3352
  :param dead_letter_queue: The SQS queue to be used as deadLetterQueue. Check out the `considerations for using a dead-letter queue <https://docs.aws.amazon.com/eventbridge/latest/userguide/rule-dlq.html#dlq-considerations>`_. The events not successfully delivered are automatically retried for a specified period of time, depending on the retry policy of the target. If an event is not delivered before all retry attempts are exhausted, it will be sent to the dead letter queue. Default: - no dead-letter queue
3314
3353
  :param max_event_age: The maximum age of a request that Lambda sends to a function for processing. Minimum value of 60. Maximum value of 86400. Default: Duration.hours(24)
3315
3354
  :param retry_attempts: The maximum number of times to retry when the function returns an error. Minimum value of 0. Maximum value of 185. Default: 185
@@ -3318,7 +3357,9 @@ class SnsTopic(
3318
3357
  type_hints = typing.get_type_hints(_typecheckingstub__b58aa74b2a717b90ef291556746b786df8882b8158b4b3255bf88691dbd8fd07)
3319
3358
  check_type(argname="argument topic", value=topic, expected_type=type_hints["topic"])
3320
3359
  props = SnsTopicProps(
3360
+ authorize_using_role=authorize_using_role,
3321
3361
  message=message,
3362
+ role=role,
3322
3363
  dead_letter_queue=dead_letter_queue,
3323
3364
  max_event_age=max_event_age,
3324
3365
  retry_attempts=retry_attempts,
@@ -5722,7 +5763,9 @@ class SfnStateMachineProps(TargetBaseProps):
5722
5763
  "dead_letter_queue": "deadLetterQueue",
5723
5764
  "max_event_age": "maxEventAge",
5724
5765
  "retry_attempts": "retryAttempts",
5766
+ "authorize_using_role": "authorizeUsingRole",
5725
5767
  "message": "message",
5768
+ "role": "role",
5726
5769
  },
5727
5770
  )
5728
5771
  class SnsTopicProps(TargetBaseProps):
@@ -5732,14 +5775,18 @@ class SnsTopicProps(TargetBaseProps):
5732
5775
  dead_letter_queue: typing.Optional[_IQueue_7ed6f679] = None,
5733
5776
  max_event_age: typing.Optional[_Duration_4839e8c3] = None,
5734
5777
  retry_attempts: typing.Optional[jsii.Number] = None,
5778
+ authorize_using_role: typing.Optional[builtins.bool] = None,
5735
5779
  message: typing.Optional[_RuleTargetInput_6beca786] = None,
5780
+ role: typing.Optional[_IRole_235f5d8e] = None,
5736
5781
  ) -> None:
5737
5782
  '''Customize the SNS Topic Event Target.
5738
5783
 
5739
5784
  :param dead_letter_queue: The SQS queue to be used as deadLetterQueue. Check out the `considerations for using a dead-letter queue <https://docs.aws.amazon.com/eventbridge/latest/userguide/rule-dlq.html#dlq-considerations>`_. The events not successfully delivered are automatically retried for a specified period of time, depending on the retry policy of the target. If an event is not delivered before all retry attempts are exhausted, it will be sent to the dead letter queue. Default: - no dead-letter queue
5740
5785
  :param max_event_age: The maximum age of a request that Lambda sends to a function for processing. Minimum value of 60. Maximum value of 86400. Default: Duration.hours(24)
5741
5786
  :param retry_attempts: The maximum number of times to retry when the function returns an error. Minimum value of 0. Maximum value of 185. Default: 185
5787
+ :param authorize_using_role: Specifies whether an IAM role should be used to publish to the topic. Default: - true if ``role`` is provided, false otherwise
5742
5788
  :param message: The message to send to the topic. Default: the entire EventBridge event
5789
+ :param role: The IAM role to be used to publish to the topic. Default: - a new role will be created if ``authorizeUsingRole`` is true
5743
5790
 
5744
5791
  :exampleMetadata: infused
5745
5792
 
@@ -5750,7 +5797,9 @@ class SnsTopicProps(TargetBaseProps):
5750
5797
 
5751
5798
 
5752
5799
  on_commit_rule.add_target(targets.SnsTopic(topic,
5753
- message=events.RuleTargetInput.from_text(f"A commit was pushed to the repository {codecommit.ReferenceEvent.repositoryName} on branch {codecommit.ReferenceEvent.referenceName}")
5800
+ message=events.RuleTargetInput.from_object({
5801
+ "DataType": f"custom_{events.EventField.fromPath('$.detail-type')}"
5802
+ })
5754
5803
  ))
5755
5804
  '''
5756
5805
  if __debug__:
@@ -5758,7 +5807,9 @@ class SnsTopicProps(TargetBaseProps):
5758
5807
  check_type(argname="argument dead_letter_queue", value=dead_letter_queue, expected_type=type_hints["dead_letter_queue"])
5759
5808
  check_type(argname="argument max_event_age", value=max_event_age, expected_type=type_hints["max_event_age"])
5760
5809
  check_type(argname="argument retry_attempts", value=retry_attempts, expected_type=type_hints["retry_attempts"])
5810
+ check_type(argname="argument authorize_using_role", value=authorize_using_role, expected_type=type_hints["authorize_using_role"])
5761
5811
  check_type(argname="argument message", value=message, expected_type=type_hints["message"])
5812
+ check_type(argname="argument role", value=role, expected_type=type_hints["role"])
5762
5813
  self._values: typing.Dict[builtins.str, typing.Any] = {}
5763
5814
  if dead_letter_queue is not None:
5764
5815
  self._values["dead_letter_queue"] = dead_letter_queue
@@ -5766,8 +5817,12 @@ class SnsTopicProps(TargetBaseProps):
5766
5817
  self._values["max_event_age"] = max_event_age
5767
5818
  if retry_attempts is not None:
5768
5819
  self._values["retry_attempts"] = retry_attempts
5820
+ if authorize_using_role is not None:
5821
+ self._values["authorize_using_role"] = authorize_using_role
5769
5822
  if message is not None:
5770
5823
  self._values["message"] = message
5824
+ if role is not None:
5825
+ self._values["role"] = role
5771
5826
 
5772
5827
  @builtins.property
5773
5828
  def dead_letter_queue(self) -> typing.Optional[_IQueue_7ed6f679]:
@@ -5806,6 +5861,15 @@ class SnsTopicProps(TargetBaseProps):
5806
5861
  result = self._values.get("retry_attempts")
5807
5862
  return typing.cast(typing.Optional[jsii.Number], result)
5808
5863
 
5864
+ @builtins.property
5865
+ def authorize_using_role(self) -> typing.Optional[builtins.bool]:
5866
+ '''Specifies whether an IAM role should be used to publish to the topic.
5867
+
5868
+ :default: - true if ``role`` is provided, false otherwise
5869
+ '''
5870
+ result = self._values.get("authorize_using_role")
5871
+ return typing.cast(typing.Optional[builtins.bool], result)
5872
+
5809
5873
  @builtins.property
5810
5874
  def message(self) -> typing.Optional[_RuleTargetInput_6beca786]:
5811
5875
  '''The message to send to the topic.
@@ -5815,6 +5879,15 @@ class SnsTopicProps(TargetBaseProps):
5815
5879
  result = self._values.get("message")
5816
5880
  return typing.cast(typing.Optional[_RuleTargetInput_6beca786], result)
5817
5881
 
5882
+ @builtins.property
5883
+ def role(self) -> typing.Optional[_IRole_235f5d8e]:
5884
+ '''The IAM role to be used to publish to the topic.
5885
+
5886
+ :default: - a new role will be created if ``authorizeUsingRole`` is true
5887
+ '''
5888
+ result = self._values.get("role")
5889
+ return typing.cast(typing.Optional[_IRole_235f5d8e], result)
5890
+
5818
5891
  def __eq__(self, rhs: typing.Any) -> builtins.bool:
5819
5892
  return isinstance(rhs, self.__class__) and rhs._values == self._values
5820
5893
 
@@ -6428,7 +6501,9 @@ def _typecheckingstub__0e0733fbe09a8310edfc7237ca759e925b3db6d25ad43627fcf4f165c
6428
6501
  def _typecheckingstub__b58aa74b2a717b90ef291556746b786df8882b8158b4b3255bf88691dbd8fd07(
6429
6502
  topic: _ITopic_9eca4852,
6430
6503
  *,
6504
+ authorize_using_role: typing.Optional[builtins.bool] = None,
6431
6505
  message: typing.Optional[_RuleTargetInput_6beca786] = None,
6506
+ role: typing.Optional[_IRole_235f5d8e] = None,
6432
6507
  dead_letter_queue: typing.Optional[_IQueue_7ed6f679] = None,
6433
6508
  max_event_age: typing.Optional[_Duration_4839e8c3] = None,
6434
6509
  retry_attempts: typing.Optional[jsii.Number] = None,
@@ -6641,7 +6716,9 @@ def _typecheckingstub__29b5b095e8884167f8f78e4ccfc6cd844ecb24d73c2e229d24c0a7a18
6641
6716
  dead_letter_queue: typing.Optional[_IQueue_7ed6f679] = None,
6642
6717
  max_event_age: typing.Optional[_Duration_4839e8c3] = None,
6643
6718
  retry_attempts: typing.Optional[jsii.Number] = None,
6719
+ authorize_using_role: typing.Optional[builtins.bool] = None,
6644
6720
  message: typing.Optional[_RuleTargetInput_6beca786] = None,
6721
+ role: typing.Optional[_IRole_235f5d8e] = None,
6645
6722
  ) -> None:
6646
6723
  """Type checking stubs"""
6647
6724
  pass
@@ -4804,7 +4804,7 @@ class CfnFleet(
4804
4804
  :param certificate_configuration: Prompts Amazon GameLift Servers to generate a TLS/SSL certificate for the fleet. Amazon GameLift Servers uses the certificates to encrypt traffic between game clients and the game servers running on Amazon GameLift Servers. By default, the ``CertificateConfiguration`` is ``DISABLED`` . You can't change this property after you create the fleet. AWS Certificate Manager (ACM) certificates expire after 13 months. Certificate expiration can cause fleets to fail, preventing players from connecting to instances in the fleet. We recommend you replace fleets before 13 months, consider using fleet aliases for a smooth transition. .. epigraph:: ACM isn't available in all AWS regions. A fleet creation request with certificate generation enabled in an unsupported Region, fails with a 4xx error. For more information about the supported Regions, see `Supported Regions <https://docs.aws.amazon.com/acm/latest/userguide/acm-regions.html>`_ in the *AWS Certificate Manager User Guide* .
4805
4805
  :param compute_type: The type of compute resource used to host your game servers. - ``EC2`` – The game server build is deployed to Amazon EC2 instances for cloud hosting. This is the default setting. - ``ANYWHERE`` – Game servers and supporting software are deployed to compute resources that you provide and manage. With this compute type, you can also set the ``AnywhereConfiguration`` parameter.
4806
4806
  :param description: A description for the fleet.
4807
- :param desired_ec2_instances: (deprecated) The number of EC2 instances that you want this fleet to host. When creating a new fleet, GameLift automatically sets this value to "1" and initiates a single instance. Once the fleet is active, update this value to trigger GameLift to add or remove instances from the fleet.
4807
+ :param desired_ec2_instances: (deprecated) [DEPRECATED] The number of EC2 instances that you want this fleet to host. When creating a new fleet, GameLift automatically sets this value to "1" and initiates a single instance. Once the fleet is active, update this value to trigger GameLift to add or remove instances from the fleet.
4808
4808
  :param ec2_inbound_permissions: The IP address ranges and port settings that allow inbound traffic to access game server processes and other processes on this fleet. Set this parameter for managed EC2 fleets. You can leave this parameter empty when creating the fleet, but you must call ` <https://docs.aws.amazon.com/gamelift/latest/apireference/API_UpdateFleetPortSettings>`_ to set it before players can connect to game sessions. As a best practice, we recommend opening ports for remote access only when you need them and closing them when you're finished. For Amazon GameLift Servers Realtime fleets, Amazon GameLift Servers automatically sets TCP and UDP ranges.
4809
4809
  :param ec2_instance_type: The Amazon GameLift Servers-supported Amazon EC2 instance type to use with managed EC2 fleets. Instance type determines the computing resources that will be used to host your game servers, including CPU, memory, storage, and networking capacity. See `Amazon Elastic Compute Cloud Instance Types <https://docs.aws.amazon.com/ec2/instance-types/>`_ for detailed descriptions of Amazon EC2 instance types.
4810
4810
  :param fleet_type: Indicates whether to use On-Demand or Spot instances for this fleet. By default, this property is set to ``ON_DEMAND`` . Learn more about when to use `On-Demand versus Spot Instances <https://docs.aws.amazon.com/gamelift/latest/developerguide/gamelift-ec2-instances.html#gamelift-ec2-instances-spot>`_ . This fleet property can't be changed after the fleet is created.
@@ -4812,9 +4812,9 @@ class CfnFleet(
4812
4812
  :param instance_role_credentials_provider: Indicates that fleet instances maintain a shared credentials file for the IAM role defined in ``InstanceRoleArn`` . Shared credentials allow applications that are deployed with the game server executable to communicate with other AWS resources. This property is used only when the game server is integrated with the server SDK version 5.x. For more information about using shared credentials, see `Communicate with other AWS resources from your fleets <https://docs.aws.amazon.com/gamelift/latest/developerguide/gamelift-sdk-server-resources.html>`_ . This attribute is used with fleets where ``ComputeType`` is ``EC2`` .
4813
4813
  :param locations: A set of remote locations to deploy additional instances to and manage as a multi-location fleet. Use this parameter when creating a fleet in AWS Regions that support multiple locations. You can add any AWS Region or Local Zone that's supported by Amazon GameLift Servers. Provide a list of one or more AWS Region codes, such as ``us-west-2`` , or Local Zone names. When using this parameter, Amazon GameLift Servers requires you to include your home location in the request. For a list of supported Regions and Local Zones, see `Amazon GameLift Servers service locations <https://docs.aws.amazon.com/gamelift/latest/developerguide/gamelift-regions.html>`_ for managed hosting.
4814
4814
  :param log_paths: (deprecated) This parameter is no longer used. When hosting a custom game build, specify where Amazon GameLift should store log files using the Amazon GameLift server API call ProcessReady()
4815
- :param max_size: (deprecated) The maximum number of instances that are allowed in the specified fleet location. If this parameter is not set, the default is 1.
4815
+ :param max_size: (deprecated) [DEPRECATED] The maximum value that is allowed for the fleet's instance count. When creating a new fleet, GameLift automatically sets this value to "1". Once the fleet is active, you can change this value.
4816
4816
  :param metric_groups: The name of an AWS CloudWatch metric group to add this fleet to. A metric group is used to aggregate the metrics for multiple fleets. You can specify an existing metric group name or set a new name to create a new metric group. A fleet can be included in only one metric group at a time.
4817
- :param min_size: (deprecated) The minimum number of instances that are allowed in the specified fleet location. If this parameter is not set, the default is 0.
4817
+ :param min_size: (deprecated) [DEPRECATED] The minimum value allowed for the fleet's instance count. When creating a new fleet, GameLift automatically sets this value to "0". After the fleet is active, you can change this value.
4818
4818
  :param new_game_session_protection_policy: The status of termination protection for active game sessions on the fleet. By default, this property is set to ``NoProtection`` . - *NoProtection* - Game sessions can be terminated during active gameplay as a result of a scale-down event. - *FullProtection* - Game sessions in ``ACTIVE`` status cannot be terminated during a scale-down event.
4819
4819
  :param peer_vpc_aws_account_id: Used when peering your Amazon GameLift Servers fleet with a VPC, the unique identifier for the AWS account that owns the VPC. You can find your account ID in the AWS Management Console under account settings.
4820
4820
  :param peer_vpc_id: A unique identifier for a VPC with resources to be accessed by your Amazon GameLift Servers fleet. The VPC must be in the same Region as your fleet. To look up a VPC ID, use the `VPC Dashboard <https://docs.aws.amazon.com/vpc/>`_ in the AWS Management Console . Learn more about VPC peering in `VPC Peering with Amazon GameLift Servers Fleets <https://docs.aws.amazon.com/gamelift/latest/developerguide/vpc-peering.html>`_ .
@@ -4896,9 +4896,7 @@ class CfnFleet(
4896
4896
  @builtins.property
4897
4897
  @jsii.member(jsii_name="attrFleetArn")
4898
4898
  def attr_fleet_arn(self) -> builtins.str:
4899
- '''The Amazon Resource Name (ARN) that is assigned to a Amazon GameLift Servers Fleet resource and uniquely identifies it.
4900
-
4901
- ARNs are unique across all Regions. In a GameLift Fleet ARN, the resource ID matches the FleetId value.
4899
+ '''The Amazon Resource Name ( `ARN <https://docs.aws.amazon.com/AmazonS3/latest/dev/s3-arn-format.html>`_ ) that is assigned to a Amazon GameLift Servers fleet resource and uniquely identifies it. ARNs are unique across all Regions. Format is ``arn:aws:gamelift:<region>::fleet/fleet-a1234567-b8c9-0d1e-2fa3-b45c6d7e8912`` . In a GameLift fleet ARN, the resource ID matches the ``FleetId`` value.
4902
4900
 
4903
4901
  :cloudformationAttribute: FleetArn
4904
4902
  '''
@@ -5028,7 +5026,7 @@ class CfnFleet(
5028
5026
  @builtins.property
5029
5027
  @jsii.member(jsii_name="desiredEc2Instances")
5030
5028
  def desired_ec2_instances(self) -> typing.Optional[jsii.Number]:
5031
- '''(deprecated) The number of EC2 instances that you want this fleet to host.
5029
+ '''(deprecated) [DEPRECATED] The number of EC2 instances that you want this fleet to host.
5032
5030
 
5033
5031
  :deprecated: this property has been deprecated
5034
5032
 
@@ -5155,7 +5153,7 @@ class CfnFleet(
5155
5153
  @builtins.property
5156
5154
  @jsii.member(jsii_name="maxSize")
5157
5155
  def max_size(self) -> typing.Optional[jsii.Number]:
5158
- '''(deprecated) The maximum number of instances that are allowed in the specified fleet location.
5156
+ '''(deprecated) [DEPRECATED] The maximum value that is allowed for the fleet's instance count.
5159
5157
 
5160
5158
  :deprecated: this property has been deprecated
5161
5159
 
@@ -5186,7 +5184,7 @@ class CfnFleet(
5186
5184
  @builtins.property
5187
5185
  @jsii.member(jsii_name="minSize")
5188
5186
  def min_size(self) -> typing.Optional[jsii.Number]:
5189
- '''(deprecated) The minimum number of instances that are allowed in the specified fleet location.
5187
+ '''(deprecated) [DEPRECATED] The minimum value allowed for the fleet's instance count.
5190
5188
 
5191
5189
  :deprecated: this property has been deprecated
5192
5190
 
@@ -6483,7 +6481,7 @@ class CfnFleetProps:
6483
6481
  :param certificate_configuration: Prompts Amazon GameLift Servers to generate a TLS/SSL certificate for the fleet. Amazon GameLift Servers uses the certificates to encrypt traffic between game clients and the game servers running on Amazon GameLift Servers. By default, the ``CertificateConfiguration`` is ``DISABLED`` . You can't change this property after you create the fleet. AWS Certificate Manager (ACM) certificates expire after 13 months. Certificate expiration can cause fleets to fail, preventing players from connecting to instances in the fleet. We recommend you replace fleets before 13 months, consider using fleet aliases for a smooth transition. .. epigraph:: ACM isn't available in all AWS regions. A fleet creation request with certificate generation enabled in an unsupported Region, fails with a 4xx error. For more information about the supported Regions, see `Supported Regions <https://docs.aws.amazon.com/acm/latest/userguide/acm-regions.html>`_ in the *AWS Certificate Manager User Guide* .
6484
6482
  :param compute_type: The type of compute resource used to host your game servers. - ``EC2`` – The game server build is deployed to Amazon EC2 instances for cloud hosting. This is the default setting. - ``ANYWHERE`` – Game servers and supporting software are deployed to compute resources that you provide and manage. With this compute type, you can also set the ``AnywhereConfiguration`` parameter.
6485
6483
  :param description: A description for the fleet.
6486
- :param desired_ec2_instances: (deprecated) The number of EC2 instances that you want this fleet to host. When creating a new fleet, GameLift automatically sets this value to "1" and initiates a single instance. Once the fleet is active, update this value to trigger GameLift to add or remove instances from the fleet.
6484
+ :param desired_ec2_instances: (deprecated) [DEPRECATED] The number of EC2 instances that you want this fleet to host. When creating a new fleet, GameLift automatically sets this value to "1" and initiates a single instance. Once the fleet is active, update this value to trigger GameLift to add or remove instances from the fleet.
6487
6485
  :param ec2_inbound_permissions: The IP address ranges and port settings that allow inbound traffic to access game server processes and other processes on this fleet. Set this parameter for managed EC2 fleets. You can leave this parameter empty when creating the fleet, but you must call ` <https://docs.aws.amazon.com/gamelift/latest/apireference/API_UpdateFleetPortSettings>`_ to set it before players can connect to game sessions. As a best practice, we recommend opening ports for remote access only when you need them and closing them when you're finished. For Amazon GameLift Servers Realtime fleets, Amazon GameLift Servers automatically sets TCP and UDP ranges.
6488
6486
  :param ec2_instance_type: The Amazon GameLift Servers-supported Amazon EC2 instance type to use with managed EC2 fleets. Instance type determines the computing resources that will be used to host your game servers, including CPU, memory, storage, and networking capacity. See `Amazon Elastic Compute Cloud Instance Types <https://docs.aws.amazon.com/ec2/instance-types/>`_ for detailed descriptions of Amazon EC2 instance types.
6489
6487
  :param fleet_type: Indicates whether to use On-Demand or Spot instances for this fleet. By default, this property is set to ``ON_DEMAND`` . Learn more about when to use `On-Demand versus Spot Instances <https://docs.aws.amazon.com/gamelift/latest/developerguide/gamelift-ec2-instances.html#gamelift-ec2-instances-spot>`_ . This fleet property can't be changed after the fleet is created.
@@ -6491,9 +6489,9 @@ class CfnFleetProps:
6491
6489
  :param instance_role_credentials_provider: Indicates that fleet instances maintain a shared credentials file for the IAM role defined in ``InstanceRoleArn`` . Shared credentials allow applications that are deployed with the game server executable to communicate with other AWS resources. This property is used only when the game server is integrated with the server SDK version 5.x. For more information about using shared credentials, see `Communicate with other AWS resources from your fleets <https://docs.aws.amazon.com/gamelift/latest/developerguide/gamelift-sdk-server-resources.html>`_ . This attribute is used with fleets where ``ComputeType`` is ``EC2`` .
6492
6490
  :param locations: A set of remote locations to deploy additional instances to and manage as a multi-location fleet. Use this parameter when creating a fleet in AWS Regions that support multiple locations. You can add any AWS Region or Local Zone that's supported by Amazon GameLift Servers. Provide a list of one or more AWS Region codes, such as ``us-west-2`` , or Local Zone names. When using this parameter, Amazon GameLift Servers requires you to include your home location in the request. For a list of supported Regions and Local Zones, see `Amazon GameLift Servers service locations <https://docs.aws.amazon.com/gamelift/latest/developerguide/gamelift-regions.html>`_ for managed hosting.
6493
6491
  :param log_paths: (deprecated) This parameter is no longer used. When hosting a custom game build, specify where Amazon GameLift should store log files using the Amazon GameLift server API call ProcessReady()
6494
- :param max_size: (deprecated) The maximum number of instances that are allowed in the specified fleet location. If this parameter is not set, the default is 1.
6492
+ :param max_size: (deprecated) [DEPRECATED] The maximum value that is allowed for the fleet's instance count. When creating a new fleet, GameLift automatically sets this value to "1". Once the fleet is active, you can change this value.
6495
6493
  :param metric_groups: The name of an AWS CloudWatch metric group to add this fleet to. A metric group is used to aggregate the metrics for multiple fleets. You can specify an existing metric group name or set a new name to create a new metric group. A fleet can be included in only one metric group at a time.
6496
- :param min_size: (deprecated) The minimum number of instances that are allowed in the specified fleet location. If this parameter is not set, the default is 0.
6494
+ :param min_size: (deprecated) [DEPRECATED] The minimum value allowed for the fleet's instance count. When creating a new fleet, GameLift automatically sets this value to "0". After the fleet is active, you can change this value.
6497
6495
  :param new_game_session_protection_policy: The status of termination protection for active game sessions on the fleet. By default, this property is set to ``NoProtection`` . - *NoProtection* - Game sessions can be terminated during active gameplay as a result of a scale-down event. - *FullProtection* - Game sessions in ``ACTIVE`` status cannot be terminated during a scale-down event.
6498
6496
  :param peer_vpc_aws_account_id: Used when peering your Amazon GameLift Servers fleet with a VPC, the unique identifier for the AWS account that owns the VPC. You can find your account ID in the AWS Management Console under account settings.
6499
6497
  :param peer_vpc_id: A unique identifier for a VPC with resources to be accessed by your Amazon GameLift Servers fleet. The VPC must be in the same Region as your fleet. To look up a VPC ID, use the `VPC Dashboard <https://docs.aws.amazon.com/vpc/>`_ in the AWS Management Console . Learn more about VPC peering in `VPC Peering with Amazon GameLift Servers Fleets <https://docs.aws.amazon.com/gamelift/latest/developerguide/vpc-peering.html>`_ .
@@ -6774,7 +6772,7 @@ class CfnFleetProps:
6774
6772
 
6775
6773
  @builtins.property
6776
6774
  def desired_ec2_instances(self) -> typing.Optional[jsii.Number]:
6777
- '''(deprecated) The number of EC2 instances that you want this fleet to host.
6775
+ '''(deprecated) [DEPRECATED] The number of EC2 instances that you want this fleet to host.
6778
6776
 
6779
6777
  When creating a new fleet, GameLift automatically sets this value to "1" and initiates a single instance. Once the fleet is active, update this value to trigger GameLift to add or remove instances from the fleet.
6780
6778
 
@@ -6872,9 +6870,9 @@ class CfnFleetProps:
6872
6870
 
6873
6871
  @builtins.property
6874
6872
  def max_size(self) -> typing.Optional[jsii.Number]:
6875
- '''(deprecated) The maximum number of instances that are allowed in the specified fleet location.
6873
+ '''(deprecated) [DEPRECATED] The maximum value that is allowed for the fleet's instance count.
6876
6874
 
6877
- If this parameter is not set, the default is 1.
6875
+ When creating a new fleet, GameLift automatically sets this value to "1". Once the fleet is active, you can change this value.
6878
6876
 
6879
6877
  :deprecated: this property has been deprecated
6880
6878
 
@@ -6897,9 +6895,9 @@ class CfnFleetProps:
6897
6895
 
6898
6896
  @builtins.property
6899
6897
  def min_size(self) -> typing.Optional[jsii.Number]:
6900
- '''(deprecated) The minimum number of instances that are allowed in the specified fleet location.
6898
+ '''(deprecated) [DEPRECATED] The minimum value allowed for the fleet's instance count.
6901
6899
 
6902
- If this parameter is not set, the default is 0.
6900
+ When creating a new fleet, GameLift automatically sets this value to "0". After the fleet is active, you can change this value.
6903
6901
 
6904
6902
  :deprecated: this property has been deprecated
6905
6903