aws-cdk-lib 2.115.0__py3-none-any.whl → 2.116.1__py3-none-any.whl

aws_cdk/aws_fis/__init__.py

@@ -56,7 +56,15 @@ class CfnExperimentTemplate(
     metaclass=jsii.JSIIMeta,
     jsii_type="aws-cdk-lib.aws_fis.CfnExperimentTemplate",
 ):
-    '''Describes an experiment template.
+    '''Specifies an experiment template.
+
+    An experiment template includes the following components:
+
+    - *Targets* : A target can be a specific resource in your AWS environment, or one or more resources that match criteria that you specify, for example, resources that have specific tags.
+    - *Actions* : The actions to carry out on the target. You can specify multiple actions, the duration of each action, and when to start each action during an experiment.
+    - *Stop conditions* : If a stop condition is triggered while an experiment is running, the experiment is automatically stopped. You can define a stop condition as a CloudWatch alarm.
+
+    For more information, see `Experiment templates <https://docs.aws.amazon.com/fis/latest/userguide/experiment-templates.html>`_ in the *AWS Fault Injection Service User Guide* .
 
     :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-fis-experimenttemplate.html
     :cloudformationResource: AWS::FIS::ExperimentTemplate
@@ -430,7 +438,9 @@ class CfnExperimentTemplate(
             start_after: typing.Optional[typing.Sequence[builtins.str]] = None,
             targets: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Mapping[builtins.str, builtins.str]]] = None,
         ) -> None:
-            '''Describes an action for an experiment template.
+            '''Specifies an action for an experiment template.
+
+            For more information, see `Actions <https://docs.aws.amazon.com/fis/latest/userguide/actions.html>`_ in the *AWS Fault Injection Service User Guide* .
 
             :param action_id: The ID of the action.
             :param description: A description for the action.
@@ -631,11 +641,13 @@ class CfnExperimentTemplate(
             cloud_watch_logs_configuration: typing.Any = None,
             s3_configuration: typing.Any = None,
         ) -> None:
-            '''Describes the configuration for experiment logging.
+            '''Specifies the configuration for experiment logging.
+
+            For more information, see `Experiment logging <https://docs.aws.amazon.com/fis/latest/userguide/monitoring-logging.html>`_ in the *AWS Fault Injection Service User Guide* .
 
             :param log_schema_version: The schema version.
-            :param cloud_watch_logs_configuration: The configuration for experiment logging to Amazon CloudWatch Logs.
-            :param s3_configuration: The configuration for experiment logging to Amazon S3.
+            :param cloud_watch_logs_configuration: The configuration for experiment logging to CloudWatch Logs .
+            :param s3_configuration: The configuration for experiment logging to Amazon S3 .
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-fis-experimenttemplate-experimenttemplatelogconfiguration.html
             :exampleMetadata: fixture=_generated
@@ -682,7 +694,7 @@ class CfnExperimentTemplate(
 
         @builtins.property
         def cloud_watch_logs_configuration(self) -> typing.Any:
-            '''The configuration for experiment logging to Amazon CloudWatch Logs.
+            '''The configuration for experiment logging to CloudWatch Logs .
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-fis-experimenttemplate-experimenttemplatelogconfiguration.html#cfn-fis-experimenttemplate-experimenttemplatelogconfiguration-cloudwatchlogsconfiguration
             '''
@@ -691,7 +703,7 @@ class CfnExperimentTemplate(
 
         @builtins.property
         def s3_configuration(self) -> typing.Any:
-            '''The configuration for experiment logging to Amazon S3.
+            '''The configuration for experiment logging to Amazon S3 .
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-fis-experimenttemplate-experimenttemplatelogconfiguration.html#cfn-fis-experimenttemplate-experimenttemplatelogconfiguration-s3configuration
             '''
@@ -721,7 +733,9 @@ class CfnExperimentTemplate(
             source: builtins.str,
             value: typing.Optional[builtins.str] = None,
         ) -> None:
-            '''Describes a stop condition for an experiment template.
+            '''Specifies a stop condition for an experiment template.
+
+            For more information, see `Stop conditions <https://docs.aws.amazon.com/fis/latest/userguide/stop-conditions.html>`_ in the *AWS Fault Injection Service User Guide* .
 
             :param source: The source for the stop condition.
             :param value: The Amazon Resource Name (ARN) of the CloudWatch alarm, if applicable.
@@ -794,7 +808,9 @@ class CfnExperimentTemplate(
             path: builtins.str,
             values: typing.Sequence[builtins.str],
         ) -> None:
-            '''Describes a filter used for the target resources in an experiment template.
+            '''Specifies a filter used for the target resource input in an experiment template.
+
+            For more information, see `Resource filters <https://docs.aws.amazon.com/fis/latest/userguide/targets.html#target-filters>`_ in the *AWS Fault Injection Service User Guide* .
 
             :param path: The attribute path for the filter.
             :param values: The attribute values for the filter.
@@ -876,12 +892,16 @@ class CfnExperimentTemplate(
             resource_arns: typing.Optional[typing.Sequence[builtins.str]] = None,
             resource_tags: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Mapping[builtins.str, builtins.str]]] = None,
         ) -> None:
-            '''Describes a target for an experiment template.
+            '''Specifies a target for an experiment.
+
+            You must specify at least one Amazon Resource Name (ARN) or at least one resource tag. You cannot specify both ARNs and tags.
+
+            For more information, see `Targets <https://docs.aws.amazon.com/fis/latest/userguide/targets.html>`_ in the *AWS Fault Injection Service User Guide* .
 
             :param resource_type: The resource type.
             :param selection_mode: Scopes the identified resources to a specific count or percentage.
             :param filters: The filters to apply to identify target resources using specific attributes.
-            :param parameters: The resource type parameters.
+            :param parameters: The parameters for the resource type.
             :param resource_arns: The Amazon Resource Names (ARNs) of the targets.
             :param resource_tags: The tags for the target resources.
 
@@ -968,7 +988,7 @@ class CfnExperimentTemplate(
         def parameters(
             self,
         ) -> typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Mapping[builtins.str, builtins.str]]]:
-            '''The resource type parameters.
+            '''The parameters for the resource type.
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-fis-experimenttemplate-experimenttemplatetarget.html#cfn-fis-experimenttemplate-experimenttemplatetarget-parameters
             '''
@@ -1322,7 +1342,7 @@ class CfnTargetAccountConfiguration(
 ):
     '''Creates a target account configuration for the experiment template.
 
-    A target account configuration is required when ``accountTargeting`` of ``experimentOptions`` is set to ``multi-account`` . For more information, see `experiment options <https://docs.aws.amazon.com/fis/latest/userguide/experiment-options.html>`_ in the *AWS Fault Injection Simulator User Guide* .
+    A target account configuration is required when ``accountTargeting`` of ``experimentOptions`` is set to ``multi-account`` . For more information, see `experiment options <https://docs.aws.amazon.com/fis/latest/userguide/experiment-options.html>`_ in the *AWS Fault Injection Service User Guide* .
 
     :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-fis-targetaccountconfiguration.html
     :cloudformationResource: AWS::FIS::TargetAccountConfiguration

aws_cdk/aws_gamelift/__init__.py

@@ -880,6 +880,7 @@ class CfnFleet(
             anywhere_configuration=gamelift.CfnFleet.AnywhereConfigurationProperty(
                 cost="cost"
             ),
+            apply_capacity="applyCapacity",
             build_id="buildId",
             certificate_configuration=gamelift.CfnFleet.CertificateConfigurationProperty(
                 certificate_type="certificateType"
@@ -960,6 +961,7 @@ class CfnFleet(
         *,
         name: builtins.str,
         anywhere_configuration: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union["CfnFleet.AnywhereConfigurationProperty", typing.Dict[builtins.str, typing.Any]]]] = None,
+        apply_capacity: typing.Optional[builtins.str] = None,
         build_id: typing.Optional[builtins.str] = None,
         certificate_configuration: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union["CfnFleet.CertificateConfigurationProperty", typing.Dict[builtins.str, typing.Any]]]] = None,
         compute_type: typing.Optional[builtins.str] = None,
@@ -990,6 +992,7 @@ class CfnFleet(
         :param id: Construct identifier for this resource (unique in its scope).
         :param name: A descriptive label that is associated with a fleet. Fleet names do not need to be unique.
         :param anywhere_configuration: Amazon GameLift Anywhere configuration options.
+        :param apply_capacity: Current resource capacity settings in a specified fleet or location. The location value might refer to a fleet's remote location or its home Region. *Related actions* `DescribeFleetCapacity <https://docs.aws.amazon.com/gamelift/latest/apireference/API_DescribeFleetCapacity.html>`_ | `DescribeFleetLocationCapacity <https://docs.aws.amazon.com/gamelift/latest/apireference/API_DescribeFleetLocationCapacity.html>`_ | `UpdateFleetCapacity <https://docs.aws.amazon.com/gamelift/latest/apireference/API_UpdateFleetCapacity.html>`_
         :param build_id: A unique identifier for a build to be deployed on the new fleet. If you are deploying the fleet with a custom game build, you must specify this property. The build must have been successfully uploaded to Amazon GameLift and be in a ``READY`` status. This fleet setting cannot be changed once the fleet is created.
         :param certificate_configuration: Prompts Amazon GameLift to generate a TLS/SSL certificate for the fleet. Amazon GameLift uses the certificates to encrypt traffic between game clients and the game servers running on Amazon GameLift. 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* .
         :param compute_type: The type of compute resource used to host your game servers. You can use your own compute resources with Amazon GameLift Anywhere or use Amazon EC2 instances with managed Amazon GameLift. By default, this property is set to ``EC2`` .
@@ -1022,6 +1025,7 @@ class CfnFleet(
         props = CfnFleetProps(
             name=name,
             anywhere_configuration=anywhere_configuration,
+            apply_capacity=apply_capacity,
             build_id=build_id,
             certificate_configuration=certificate_configuration,
             compute_type=compute_type,
@@ -1125,6 +1129,19 @@ class CfnFleet(
             check_type(argname="argument value", value=value, expected_type=type_hints["value"])
         jsii.set(self, "anywhereConfiguration", value)
 
+    @builtins.property
+    @jsii.member(jsii_name="applyCapacity")
+    def apply_capacity(self) -> typing.Optional[builtins.str]:
+        '''Current resource capacity settings in a specified fleet or location.'''
+        return typing.cast(typing.Optional[builtins.str], jsii.get(self, "applyCapacity"))
+
+    @apply_capacity.setter
+    def apply_capacity(self, value: typing.Optional[builtins.str]) -> None:
+        if __debug__:
+            type_hints = typing.get_type_hints(_typecheckingstub__6e4da24e64fdcbb7830d9e09a27219d611e9c486d09dd2a970381192b5e97213)
+            check_type(argname="argument value", value=value, expected_type=type_hints["value"])
+        jsii.set(self, "applyCapacity", value)
+
     @builtins.property
     @jsii.member(jsii_name="buildId")
     def build_id(self) -> typing.Optional[builtins.str]:
@@ -2544,6 +2561,7 @@ class CfnFleet(
     name_mapping={
         "name": "name",
         "anywhere_configuration": "anywhereConfiguration",
+        "apply_capacity": "applyCapacity",
         "build_id": "buildId",
         "certificate_configuration": "certificateConfiguration",
         "compute_type": "computeType",
@@ -2576,6 +2594,7 @@ class CfnFleetProps:
         *,
         name: builtins.str,
         anywhere_configuration: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union[CfnFleet.AnywhereConfigurationProperty, typing.Dict[builtins.str, typing.Any]]]] = None,
+        apply_capacity: typing.Optional[builtins.str] = None,
         build_id: typing.Optional[builtins.str] = None,
         certificate_configuration: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union[CfnFleet.CertificateConfigurationProperty, typing.Dict[builtins.str, typing.Any]]]] = None,
         compute_type: typing.Optional[builtins.str] = None,
@@ -2605,6 +2624,7 @@ class CfnFleetProps:
 
         :param name: A descriptive label that is associated with a fleet. Fleet names do not need to be unique.
         :param anywhere_configuration: Amazon GameLift Anywhere configuration options.
+        :param apply_capacity: Current resource capacity settings in a specified fleet or location. The location value might refer to a fleet's remote location or its home Region. *Related actions* `DescribeFleetCapacity <https://docs.aws.amazon.com/gamelift/latest/apireference/API_DescribeFleetCapacity.html>`_ | `DescribeFleetLocationCapacity <https://docs.aws.amazon.com/gamelift/latest/apireference/API_DescribeFleetLocationCapacity.html>`_ | `UpdateFleetCapacity <https://docs.aws.amazon.com/gamelift/latest/apireference/API_UpdateFleetCapacity.html>`_
         :param build_id: A unique identifier for a build to be deployed on the new fleet. If you are deploying the fleet with a custom game build, you must specify this property. The build must have been successfully uploaded to Amazon GameLift and be in a ``READY`` status. This fleet setting cannot be changed once the fleet is created.
         :param certificate_configuration: Prompts Amazon GameLift to generate a TLS/SSL certificate for the fleet. Amazon GameLift uses the certificates to encrypt traffic between game clients and the game servers running on Amazon GameLift. 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* .
         :param compute_type: The type of compute resource used to host your game servers. You can use your own compute resources with Amazon GameLift Anywhere or use Amazon EC2 instances with managed Amazon GameLift. By default, this property is set to ``EC2`` .
@@ -2646,6 +2666,7 @@ class CfnFleetProps:
                 anywhere_configuration=gamelift.CfnFleet.AnywhereConfigurationProperty(
                     cost="cost"
                 ),
+                apply_capacity="applyCapacity",
                 build_id="buildId",
                 certificate_configuration=gamelift.CfnFleet.CertificateConfigurationProperty(
                     certificate_type="certificateType"
@@ -2722,6 +2743,7 @@ class CfnFleetProps:
             type_hints = typing.get_type_hints(_typecheckingstub__8a51a418ba5b606bdfc45dc50c3172e280a12e078a7392f3258d5d329e037a55)
             check_type(argname="argument name", value=name, expected_type=type_hints["name"])
             check_type(argname="argument anywhere_configuration", value=anywhere_configuration, expected_type=type_hints["anywhere_configuration"])
+            check_type(argname="argument apply_capacity", value=apply_capacity, expected_type=type_hints["apply_capacity"])
             check_type(argname="argument build_id", value=build_id, expected_type=type_hints["build_id"])
             check_type(argname="argument certificate_configuration", value=certificate_configuration, expected_type=type_hints["certificate_configuration"])
             check_type(argname="argument compute_type", value=compute_type, expected_type=type_hints["compute_type"])
@@ -2751,6 +2773,8 @@ class CfnFleetProps:
         }
         if anywhere_configuration is not None:
             self._values["anywhere_configuration"] = anywhere_configuration
+        if apply_capacity is not None:
+            self._values["apply_capacity"] = apply_capacity
         if build_id is not None:
             self._values["build_id"] = build_id
         if certificate_configuration is not None:
@@ -2823,6 +2847,21 @@ class CfnFleetProps:
         result = self._values.get("anywhere_configuration")
         return typing.cast(typing.Optional[typing.Union[_IResolvable_da3f097b, CfnFleet.AnywhereConfigurationProperty]], result)
 
+    @builtins.property
+    def apply_capacity(self) -> typing.Optional[builtins.str]:
+        '''Current resource capacity settings in a specified fleet or location.
+
+        The location value might refer to a fleet's remote location or its home Region.
+
+        *Related actions*
+
+        `DescribeFleetCapacity <https://docs.aws.amazon.com/gamelift/latest/apireference/API_DescribeFleetCapacity.html>`_ | `DescribeFleetLocationCapacity <https://docs.aws.amazon.com/gamelift/latest/apireference/API_DescribeFleetLocationCapacity.html>`_ | `UpdateFleetCapacity <https://docs.aws.amazon.com/gamelift/latest/apireference/API_UpdateFleetCapacity.html>`_
+
+        :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-gamelift-fleet.html#cfn-gamelift-fleet-applycapacity
+        '''
+        result = self._values.get("apply_capacity")
+        return typing.cast(typing.Optional[builtins.str], result)
+
     @builtins.property
     def build_id(self) -> typing.Optional[builtins.str]:
         '''A unique identifier for a build to be deployed on the new fleet.
@@ -6883,6 +6922,7 @@ def _typecheckingstub__21fe09a90444788b3c862f454214d4e160757c9b02d0598d282f68b7f
     *,
     name: builtins.str,
     anywhere_configuration: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union[CfnFleet.AnywhereConfigurationProperty, typing.Dict[builtins.str, typing.Any]]]] = None,
+    apply_capacity: typing.Optional[builtins.str] = None,
     build_id: typing.Optional[builtins.str] = None,
     certificate_configuration: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union[CfnFleet.CertificateConfigurationProperty, typing.Dict[builtins.str, typing.Any]]]] = None,
     compute_type: typing.Optional[builtins.str] = None,
@@ -6935,6 +6975,12 @@ def _typecheckingstub__bc575abdd043760dd1cbe4178328d65df4b96ee18072484d24bd88d2e
     """Type checking stubs"""
     pass
 
+def _typecheckingstub__6e4da24e64fdcbb7830d9e09a27219d611e9c486d09dd2a970381192b5e97213(
+    value: typing.Optional[builtins.str],
+) -> None:
+    """Type checking stubs"""
+    pass
+
 def _typecheckingstub__fecb16629d96a3f0b5b4acdf8ba4a4b1a44a9314ada24ee4bf29122c11df18e7(
     value: typing.Optional[builtins.str],
 ) -> None:
@@ -7175,6 +7221,7 @@ def _typecheckingstub__8a51a418ba5b606bdfc45dc50c3172e280a12e078a7392f3258d5d329
     *,
     name: builtins.str,
     anywhere_configuration: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union[CfnFleet.AnywhereConfigurationProperty, typing.Dict[builtins.str, typing.Any]]]] = None,
+    apply_capacity: typing.Optional[builtins.str] = None,
     build_id: typing.Optional[builtins.str] = None,
     certificate_configuration: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union[CfnFleet.CertificateConfigurationProperty, typing.Dict[builtins.str, typing.Any]]]] = None,
     compute_type: typing.Optional[builtins.str] = None,