aws-cdk-lib 2.186.0__py3-none-any.whl → 2.188.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 (85) hide show
  1. aws_cdk/__init__.py +303 -119
  2. aws_cdk/_jsii/__init__.py +1 -1
  3. aws_cdk/_jsii/{aws-cdk-lib@2.186.0.jsii.tgz → aws-cdk-lib@2.188.0.jsii.tgz} +0 -0
  4. aws_cdk/aws_amplify/__init__.py +136 -0
  5. aws_cdk/aws_apigateway/__init__.py +69 -17
  6. aws_cdk/aws_apigatewayv2/__init__.py +88 -0
  7. aws_cdk/aws_appconfig/__init__.py +30 -14
  8. aws_cdk/aws_appsync/__init__.py +14 -5
  9. aws_cdk/aws_arczonalshift/__init__.py +4 -4
  10. aws_cdk/aws_bedrock/__init__.py +637 -32
  11. aws_cdk/aws_budgets/__init__.py +8 -8
  12. aws_cdk/aws_cassandra/__init__.py +4 -2
  13. aws_cdk/aws_ce/__init__.py +2 -2
  14. aws_cdk/aws_cloudformation/__init__.py +3 -3
  15. aws_cdk/aws_cloudfront/__init__.py +11 -0
  16. aws_cdk/aws_cloudtrail/__init__.py +4 -18
  17. aws_cdk/aws_cloudwatch/__init__.py +50 -50
  18. aws_cdk/aws_codebuild/__init__.py +32 -1
  19. aws_cdk/aws_codepipeline/__init__.py +47 -32
  20. aws_cdk/aws_codepipeline_actions/__init__.py +2786 -1042
  21. aws_cdk/aws_codestarnotifications/__init__.py +16 -16
  22. aws_cdk/aws_cognito/__init__.py +8 -2
  23. aws_cdk/aws_config/__init__.py +2 -5
  24. aws_cdk/aws_datazone/__init__.py +287 -226
  25. aws_cdk/aws_detective/__init__.py +3 -3
  26. aws_cdk/aws_dynamodb/__init__.py +37 -0
  27. aws_cdk/aws_ec2/__init__.py +2448 -442
  28. aws_cdk/aws_ecr/__init__.py +143 -0
  29. aws_cdk/aws_ecr_assets/__init__.py +115 -4
  30. aws_cdk/aws_ecs/__init__.py +51 -0
  31. aws_cdk/aws_eks/__init__.py +222 -6
  32. aws_cdk/aws_events/__init__.py +8 -11
  33. aws_cdk/aws_events_targets/__init__.py +136 -0
  34. aws_cdk/aws_forecast/__init__.py +1 -1
  35. aws_cdk/aws_fsx/__init__.py +2 -2
  36. aws_cdk/aws_gamelift/__init__.py +11 -11
  37. aws_cdk/aws_iam/__init__.py +6 -4
  38. aws_cdk/aws_identitystore/__init__.py +6 -4
  39. aws_cdk/aws_iotsitewise/__init__.py +623 -0
  40. aws_cdk/aws_kinesisfirehose/__init__.py +38 -0
  41. aws_cdk/aws_kms/__init__.py +10 -11
  42. aws_cdk/aws_lakeformation/__init__.py +3 -3
  43. aws_cdk/aws_lambda/__init__.py +105 -4
  44. aws_cdk/aws_lambda_event_sources/__init__.py +87 -25
  45. aws_cdk/aws_lambda_nodejs/__init__.py +5 -24
  46. aws_cdk/aws_lex/__init__.py +985 -5
  47. aws_cdk/aws_logs/__init__.py +18 -0
  48. aws_cdk/aws_logs_destinations/__init__.py +146 -0
  49. aws_cdk/aws_mediaconnect/__init__.py +714 -290
  50. aws_cdk/aws_mwaa/__init__.py +9 -9
  51. aws_cdk/aws_networkfirewall/__init__.py +44 -0
  52. aws_cdk/aws_notifications/__init__.py +4 -4
  53. aws_cdk/aws_omics/__init__.py +225 -1
  54. aws_cdk/aws_opensearchserverless/__init__.py +31 -23
  55. aws_cdk/aws_organizations/__init__.py +1 -1
  56. aws_cdk/aws_pcaconnectorad/__init__.py +3 -2
  57. aws_cdk/aws_quicksight/__init__.py +268 -50
  58. aws_cdk/aws_rds/__init__.py +186 -10
  59. aws_cdk/aws_route53/__init__.py +5 -5
  60. aws_cdk/aws_route53recoverycontrol/__init__.py +41 -2
  61. aws_cdk/aws_rum/__init__.py +13 -10
  62. aws_cdk/aws_s3/__init__.py +3 -6
  63. aws_cdk/aws_s3_assets/__init__.py +70 -1
  64. aws_cdk/aws_s3_deployment/__init__.py +4 -0
  65. aws_cdk/aws_sagemaker/__init__.py +47 -4
  66. aws_cdk/aws_scheduler_targets/__init__.py +4 -16
  67. aws_cdk/aws_securitylake/__init__.py +2 -2
  68. aws_cdk/aws_servicecatalog/__init__.py +4 -0
  69. aws_cdk/aws_sns/__init__.py +1 -1
  70. aws_cdk/aws_ssmincidents/__init__.py +10 -10
  71. aws_cdk/aws_stepfunctions/__init__.py +23 -17
  72. aws_cdk/aws_stepfunctions_tasks/__init__.py +4 -0
  73. aws_cdk/aws_synthetics/__init__.py +9 -0
  74. aws_cdk/aws_systemsmanagersap/__init__.py +160 -0
  75. aws_cdk/aws_transfer/__init__.py +19 -10
  76. aws_cdk/aws_wafv2/__init__.py +512 -1141
  77. aws_cdk/cloud_assembly_schema/__init__.py +60 -10
  78. aws_cdk/cx_api/__init__.py +38 -2
  79. aws_cdk/pipelines/__init__.py +52 -2
  80. {aws_cdk_lib-2.186.0.dist-info → aws_cdk_lib-2.188.0.dist-info}/METADATA +4 -4
  81. {aws_cdk_lib-2.186.0.dist-info → aws_cdk_lib-2.188.0.dist-info}/RECORD +85 -85
  82. {aws_cdk_lib-2.186.0.dist-info → aws_cdk_lib-2.188.0.dist-info}/WHEEL +1 -1
  83. {aws_cdk_lib-2.186.0.dist-info → aws_cdk_lib-2.188.0.dist-info}/LICENSE +0 -0
  84. {aws_cdk_lib-2.186.0.dist-info → aws_cdk_lib-2.188.0.dist-info}/NOTICE +0 -0
  85. {aws_cdk_lib-2.186.0.dist-info → aws_cdk_lib-2.188.0.dist-info}/top_level.txt +0 -0
@@ -11938,18 +11938,15 @@ class EventBus(
11938
11938
 
11939
11939
  Example::
11940
11940
 
11941
- bus = events.EventBus(self, "bus",
11942
- event_bus_name="MyCustomEventBus",
11943
- description="MyCustomEventBus"
11944
- )
11941
+ import aws_cdk.aws_events as events
11945
11942
 
11946
- bus.archive("MyArchive",
11947
- archive_name="MyCustomEventBusArchive",
11948
- description="MyCustomerEventBus Archive",
11949
- event_pattern=events.EventPattern(
11950
- account=[Stack.of(self).account]
11951
- ),
11952
- retention=Duration.days(365)
11943
+ # my_configuration_set: ses.ConfigurationSet
11944
+
11945
+
11946
+ bus = events.EventBus.from_event_bus_name(self, "EventBus", "default")
11947
+
11948
+ my_configuration_set.add_event_destination("ToEventBus",
11949
+ destination=ses.EventDestination.event_bus(bus)
11953
11950
  )
11954
11951
  '''
11955
11952
 
@@ -324,6 +324,20 @@ rule.add_target(
324
324
  ))
325
325
  ```
326
326
 
327
+ ## Invoke an API Gateway V2 HTTP API
328
+
329
+ Use the `ApiGatewayV2` target to trigger a HTTP API.
330
+
331
+ ```python
332
+ import aws_cdk.aws_apigatewayv2 as apigwv2
333
+
334
+ # http_api: apigwv2.HttpApi
335
+ # rule: events.Rule
336
+
337
+
338
+ rule.add_target(targets.ApiGatewayV2(http_api))
339
+ ```
340
+
327
341
  ## Invoke an API Destination
328
342
 
329
343
  Use the `targets.ApiDestination` target to trigger an external API. You need to
@@ -648,6 +662,7 @@ from .. import Duration as _Duration_4839e8c3, IResource as _IResource_c80c4260
648
662
  from ..aws_apigateway import (
649
663
  IRestApi as _IRestApi_1f02523d, RestApi as _RestApi_777c8238
650
664
  )
665
+ from ..aws_apigatewayv2 import IHttpApi as _IHttpApi_dc82ff0d
651
666
  from ..aws_appsync import IGraphqlApi as _IGraphqlApi_ed8270f3
652
667
  from ..aws_codebuild import IProject as _IProject_aafae30a
653
668
  from ..aws_codepipeline import IPipeline as _IPipeline_0931f838
@@ -900,6 +915,101 @@ class ApiGateway(
900
915
  return typing.cast(_RestApi_777c8238, jsii.get(self, "restApi"))
901
916
 
902
917
 
918
+ @jsii.implements(_IRuleTarget_7a91f454)
919
+ class ApiGatewayV2(
920
+ metaclass=jsii.JSIIMeta,
921
+ jsii_type="aws-cdk-lib.aws_events_targets.ApiGatewayV2",
922
+ ):
923
+ '''Use an API Gateway V2 HTTP APIs as a target for Amazon EventBridge rules.
924
+
925
+ :exampleMetadata: infused
926
+
927
+ Example::
928
+
929
+ import aws_cdk.aws_apigatewayv2 as apigwv2
930
+
931
+ # http_api: apigwv2.HttpApi
932
+ # rule: events.Rule
933
+
934
+
935
+ rule.add_target(targets.ApiGatewayV2(http_api))
936
+ '''
937
+
938
+ def __init__(
939
+ self,
940
+ http_api: _IHttpApi_dc82ff0d,
941
+ *,
942
+ event_role: typing.Optional[_IRole_235f5d8e] = None,
943
+ header_parameters: typing.Optional[typing.Mapping[builtins.str, builtins.str]] = None,
944
+ method: typing.Optional[builtins.str] = None,
945
+ path: typing.Optional[builtins.str] = None,
946
+ path_parameter_values: typing.Optional[typing.Sequence[builtins.str]] = None,
947
+ post_body: typing.Optional[_RuleTargetInput_6beca786] = None,
948
+ query_string_parameters: typing.Optional[typing.Mapping[builtins.str, builtins.str]] = None,
949
+ stage: typing.Optional[builtins.str] = None,
950
+ dead_letter_queue: typing.Optional[_IQueue_7ed6f679] = None,
951
+ max_event_age: typing.Optional[_Duration_4839e8c3] = None,
952
+ retry_attempts: typing.Optional[jsii.Number] = None,
953
+ ) -> None:
954
+ '''
955
+ :param http_api: - IHttpApi implementation to use as event target.
956
+ :param event_role: The role to assume before invoking the target (i.e., the pipeline) when the given rule is triggered. Default: - a new role will be created
957
+ :param header_parameters: The headers to be set when requesting API. Default: no header parameters
958
+ :param method: The method for api resource invoked by the rule. Default: '*' that treated as ANY
959
+ :param path: The api resource invoked by the rule. We can use wildcards('*') to specify the path. In that case, an equal number of real values must be specified for pathParameterValues. Default: '/'
960
+ :param path_parameter_values: The path parameter values to be used to populate to wildcards("*") of requesting api path. Default: no path parameters
961
+ :param post_body: This will be the post request body send to the API. Default: the entire EventBridge event
962
+ :param query_string_parameters: The query parameters to be set when requesting API. Default: no querystring parameters
963
+ :param stage: The deploy stage of api gateway invoked by the rule. Default: the value of deploymentStage.stageName of target api gateway.
964
+ :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
965
+ :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)
966
+ :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
967
+ '''
968
+ if __debug__:
969
+ type_hints = typing.get_type_hints(_typecheckingstub__383729f98d86a6617d8a045270e12ac1a082325deb3e0e67276cb84f86261302)
970
+ check_type(argname="argument http_api", value=http_api, expected_type=type_hints["http_api"])
971
+ props = ApiGatewayProps(
972
+ event_role=event_role,
973
+ header_parameters=header_parameters,
974
+ method=method,
975
+ path=path,
976
+ path_parameter_values=path_parameter_values,
977
+ post_body=post_body,
978
+ query_string_parameters=query_string_parameters,
979
+ stage=stage,
980
+ dead_letter_queue=dead_letter_queue,
981
+ max_event_age=max_event_age,
982
+ retry_attempts=retry_attempts,
983
+ )
984
+
985
+ jsii.create(self.__class__, self, [http_api, props])
986
+
987
+ @jsii.member(jsii_name="bind")
988
+ def bind(
989
+ self,
990
+ rule: _IRule_af9e3d28,
991
+ _id: typing.Optional[builtins.str] = None,
992
+ ) -> _RuleTargetConfig_4e70fe03:
993
+ '''Returns a RuleTarget that can be used to trigger this API Gateway HTTP APIs as a result from an EventBridge event.
994
+
995
+ :param rule: -
996
+ :param _id: -
997
+
998
+ :see: https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-use-resource-based.html#eb-api-gateway-permissions
999
+ '''
1000
+ if __debug__:
1001
+ type_hints = typing.get_type_hints(_typecheckingstub__278e3545966677d368a504247d212e49fccdecf42a63bdd56101b78bbeed205d)
1002
+ check_type(argname="argument rule", value=rule, expected_type=type_hints["rule"])
1003
+ check_type(argname="argument _id", value=_id, expected_type=type_hints["_id"])
1004
+ return typing.cast(_RuleTargetConfig_4e70fe03, jsii.invoke(self, "bind", [rule, _id]))
1005
+
1006
+ @builtins.property
1007
+ @jsii.member(jsii_name="iHttpApi")
1008
+ def i_http_api(self) -> _IHttpApi_dc82ff0d:
1009
+ '''Returns the target IHttpApi.'''
1010
+ return typing.cast(_IHttpApi_dc82ff0d, jsii.get(self, "iHttpApi"))
1011
+
1012
+
903
1013
  @jsii.implements(_IRuleTarget_7a91f454)
904
1014
  class AppSync(
905
1015
  metaclass=jsii.JSIIMeta,
@@ -5863,6 +5973,7 @@ __all__ = [
5863
5973
  "ApiDestinationProps",
5864
5974
  "ApiGateway",
5865
5975
  "ApiGatewayProps",
5976
+ "ApiGatewayV2",
5866
5977
  "AppSync",
5867
5978
  "AppSyncGraphQLApiProps",
5868
5979
  "AwsApi",
@@ -5955,6 +6066,31 @@ def _typecheckingstub__f34d8ba93048cf243454dc97d2236199033c050fc0bbc6ff84e18fa60
5955
6066
  """Type checking stubs"""
5956
6067
  pass
5957
6068
 
6069
+ def _typecheckingstub__383729f98d86a6617d8a045270e12ac1a082325deb3e0e67276cb84f86261302(
6070
+ http_api: _IHttpApi_dc82ff0d,
6071
+ *,
6072
+ event_role: typing.Optional[_IRole_235f5d8e] = None,
6073
+ header_parameters: typing.Optional[typing.Mapping[builtins.str, builtins.str]] = None,
6074
+ method: typing.Optional[builtins.str] = None,
6075
+ path: typing.Optional[builtins.str] = None,
6076
+ path_parameter_values: typing.Optional[typing.Sequence[builtins.str]] = None,
6077
+ post_body: typing.Optional[_RuleTargetInput_6beca786] = None,
6078
+ query_string_parameters: typing.Optional[typing.Mapping[builtins.str, builtins.str]] = None,
6079
+ stage: typing.Optional[builtins.str] = None,
6080
+ dead_letter_queue: typing.Optional[_IQueue_7ed6f679] = None,
6081
+ max_event_age: typing.Optional[_Duration_4839e8c3] = None,
6082
+ retry_attempts: typing.Optional[jsii.Number] = None,
6083
+ ) -> None:
6084
+ """Type checking stubs"""
6085
+ pass
6086
+
6087
+ def _typecheckingstub__278e3545966677d368a504247d212e49fccdecf42a63bdd56101b78bbeed205d(
6088
+ rule: _IRule_af9e3d28,
6089
+ _id: typing.Optional[builtins.str] = None,
6090
+ ) -> None:
6091
+ """Type checking stubs"""
6092
+ pass
6093
+
5958
6094
  def _typecheckingstub__56a99cbd83a0d7a956b68eb6ee5cedd89a2b1c37754c2dc7f5a5ea2ccffb1c7f(
5959
6095
  appsync_api: _IGraphqlApi_ed8270f3,
5960
6096
  *,
@@ -392,7 +392,7 @@ class CfnDataset(
392
392
  ) -> None:
393
393
  '''An AWS Key Management Service (KMS) key and an AWS Identity and Access Management (IAM) role that Amazon Forecast can assume to access the key.
394
394
 
395
- You can specify this optional object in the ``CreateDataset`` and ``CreatePredictor`` requests.
395
+ You can specify this optional object in the `CreateDataset <https://docs.aws.amazon.com/forecast/latest/dg/API_CreateDataset.html>`_ and `CreatePredictor <https://docs.aws.amazon.com/forecast/latest/dg/API_CreatePredictor.html>`_ requests.
396
396
 
397
397
  :param kms_key_arn: The Amazon Resource Name (ARN) of the KMS key.
398
398
  :param role_arn: The ARN of the IAM role that Amazon Forecast can assume to access the AWS KMS key. Passing a role across AWS accounts is not allowed. If you pass a role that isn't in your account, you get an ``InvalidInputException`` error.
@@ -5956,7 +5956,7 @@ class CfnVolume(
5956
5956
  '''Specifies the configuration of the Amazon FSx for OpenZFS volume that you are creating.
5957
5957
 
5958
5958
  :param parent_volume_id: The ID of the volume to use as the parent volume of the volume that you are creating.
5959
- :param copy_tags_to_snapshots: A Boolean value indicating whether tags for the volume should be copied to snapshots. This value defaults to ``false`` . If it's set to ``true`` , all tags for the volume are copied to snapshots where the user doesn't specify tags. If this value is ``true`` , and you specify one or more tags, only the specified tags are copied to snapshots. If you specify one or more tags when creating the snapshot, no tags are copied from the volume, regardless of this value.
5959
+ :param copy_tags_to_snapshots: A Boolean value indicating whether tags for the volume should be copied to snapshots. This value defaults to ``false`` . If this value is set to ``true`` , and you do not specify any tags, all tags for the original volume are copied over to snapshots. If this value is set to ``true`` , and you do specify one or more tags, only the specified tags for the original volume are copied over to snapshots. If you specify one or more tags when creating a new snapshot, no tags are copied over from the original volume, regardless of this value.
5960
5960
  :param data_compression_type: Specifies the method used to compress the data on the volume. The compression type is ``NONE`` by default. - ``NONE`` - Doesn't compress the data on the volume. ``NONE`` is the default. - ``ZSTD`` - Compresses the data in the volume using the Zstandard (ZSTD) compression algorithm. Compared to LZ4, Z-Standard provides a better compression ratio to minimize on-disk storage utilization. - ``LZ4`` - Compresses the data in the volume using the LZ4 compression algorithm. Compared to Z-Standard, LZ4 is less compute-intensive and delivers higher write throughput speeds.
5961
5961
  :param nfs_exports: The configuration object for mounting a Network File System (NFS) file system.
5962
5962
  :param options: To delete the volume's child volumes, snapshots, and clones, use the string ``DELETE_CHILD_VOLUMES_AND_SNAPSHOTS`` .
@@ -6057,7 +6057,7 @@ class CfnVolume(
6057
6057
  ) -> typing.Optional[typing.Union[builtins.bool, _IResolvable_da3f097b]]:
6058
6058
  '''A Boolean value indicating whether tags for the volume should be copied to snapshots.
6059
6059
 
6060
- This value defaults to ``false`` . If it's set to ``true`` , all tags for the volume are copied to snapshots where the user doesn't specify tags. If this value is ``true`` , and you specify one or more tags, only the specified tags are copied to snapshots. If you specify one or more tags when creating the snapshot, no tags are copied from the volume, regardless of this value.
6060
+ This value defaults to ``false`` . If this value is set to ``true`` , and you do not specify any tags, all tags for the original volume are copied over to snapshots. If this value is set to ``true`` , and you do specify one or more tags, only the specified tags for the original volume are copied over to snapshots. If you specify one or more tags when creating a new snapshot, no tags are copied over from the original volume, regardless of this value.
6061
6061
 
6062
6062
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-fsx-volume-openzfsconfiguration.html#cfn-fsx-volume-openzfsconfiguration-copytagstosnapshots
6063
6063
  '''
@@ -478,7 +478,7 @@ class CfnBuild(
478
478
  :param scope: Scope in which this resource is defined.
479
479
  :param id: Construct identifier for this resource (unique in its scope).
480
480
  :param name: A descriptive label that is associated with a build. Build names do not need to be unique.
481
- :param operating_system: The operating system that your game server binaries run on. This value determines the type of fleet resources that you use for this build. If your game build contains multiple executables, they all must run on the same operating system. You must specify a valid operating system in this request. There is no default value. You can't change a build's operating system later. .. epigraph:: Amazon Linux 2 (AL2) will reach end of support on 6/30/2025. See more details in the `Amazon Linux 2 FAQs <https://docs.aws.amazon.com/https://aws.amazon.com/amazon-linux-2/faqs/>`_ . For game servers that are hosted on AL2 and use server SDK version 4.x for Amazon GameLift Servers, first update the game server build to server SDK 5.x, and then deploy to AL2023 instances. See `Migrate to server SDK version 5. <https://docs.aws.amazon.com/gamelift/latest/developerguide/reference-serversdk5-migration.html>`_
481
+ :param operating_system: The operating system that your game server binaries run on. This value determines the type of fleet resources that you use for this build. If your game build contains multiple executables, they all must run on the same operating system. You must specify a valid operating system in this request. There is no default value. You can't change a build's operating system later. .. epigraph:: Amazon Linux 2 (AL2) will reach end of support on 6/30/2025. See more details in the `Amazon Linux 2 FAQs <https://docs.aws.amazon.com/amazon-linux-2/faqs/>`_ . For game servers that are hosted on AL2 and use server SDK version 4.x for Amazon GameLift Servers, first update the game server build to server SDK 5.x, and then deploy to AL2023 instances. See `Migrate to server SDK version 5. <https://docs.aws.amazon.com/gamelift/latest/developerguide/reference-serversdk5-migration.html>`_
482
482
  :param server_sdk_version: A server SDK version you used when integrating your game server build with Amazon GameLift Servers. For more information see `Integrate games with custom game servers <https://docs.aws.amazon.com/gamelift/latest/developerguide/integration-custom-intro.html>`_ . By default Amazon GameLift Servers sets this value to ``4.0.2`` .
483
483
  :param storage_location: Information indicating where your game build files are stored. Use this parameter only when creating a build with files stored in an Amazon S3 bucket that you own. The storage location must specify an Amazon S3 bucket name and key. The location must also specify a role ARN that you set up to allow Amazon GameLift Servers to access your Amazon S3 bucket. The S3 bucket and your new build must be in the same Region. If a ``StorageLocation`` is specified, the size of your file can be found in your Amazon S3 bucket. Amazon GameLift Servers will report a ``SizeOnDisk`` of 0.
484
484
  :param version: Version information that is associated with this build. Version strings do not need to be unique.
@@ -635,7 +635,7 @@ class CfnBuild(
635
635
  :param bucket: An Amazon S3 bucket identifier. The name of the S3 bucket. .. epigraph:: Amazon GameLift doesn't support uploading from Amazon S3 buckets with names that contain a dot (.).
636
636
  :param key: The name of the zip file that contains the build files or script files.
637
637
  :param role_arn: The ARNfor an IAM role that allows Amazon GameLift to access the S3 bucket.
638
- :param object_version: A version of a stored file to retrieve, if the object versioning feature is turned on for the S3 bucket. Use this parameter to specify a specific version. If this parameter isn't set, Amazon GameLift retrieves the latest version of the file.
638
+ :param object_version: A version of a stored file to retrieve, if the object versioning feature is turned on for the S3 bucket. Use this parameter to specify a specific version. If this parameter isn't set, Amazon GameLift Servers retrieves the latest version of the file.
639
639
 
640
640
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-gamelift-build-storagelocation.html
641
641
  :exampleMetadata: fixture=_generated
@@ -707,7 +707,7 @@ class CfnBuild(
707
707
  def object_version(self) -> typing.Optional[builtins.str]:
708
708
  '''A version of a stored file to retrieve, if the object versioning feature is turned on for the S3 bucket.
709
709
 
710
- Use this parameter to specify a specific version. If this parameter isn't set, Amazon GameLift retrieves the latest version of the file.
710
+ Use this parameter to specify a specific version. If this parameter isn't set, Amazon GameLift Servers retrieves the latest version of the file.
711
711
 
712
712
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-gamelift-build-storagelocation.html#cfn-gamelift-build-storagelocation-objectversion
713
713
  '''
@@ -750,7 +750,7 @@ class CfnBuildProps:
750
750
  '''Properties for defining a ``CfnBuild``.
751
751
 
752
752
  :param name: A descriptive label that is associated with a build. Build names do not need to be unique.
753
- :param operating_system: The operating system that your game server binaries run on. This value determines the type of fleet resources that you use for this build. If your game build contains multiple executables, they all must run on the same operating system. You must specify a valid operating system in this request. There is no default value. You can't change a build's operating system later. .. epigraph:: Amazon Linux 2 (AL2) will reach end of support on 6/30/2025. See more details in the `Amazon Linux 2 FAQs <https://docs.aws.amazon.com/https://aws.amazon.com/amazon-linux-2/faqs/>`_ . For game servers that are hosted on AL2 and use server SDK version 4.x for Amazon GameLift Servers, first update the game server build to server SDK 5.x, and then deploy to AL2023 instances. See `Migrate to server SDK version 5. <https://docs.aws.amazon.com/gamelift/latest/developerguide/reference-serversdk5-migration.html>`_
753
+ :param operating_system: The operating system that your game server binaries run on. This value determines the type of fleet resources that you use for this build. If your game build contains multiple executables, they all must run on the same operating system. You must specify a valid operating system in this request. There is no default value. You can't change a build's operating system later. .. epigraph:: Amazon Linux 2 (AL2) will reach end of support on 6/30/2025. See more details in the `Amazon Linux 2 FAQs <https://docs.aws.amazon.com/amazon-linux-2/faqs/>`_ . For game servers that are hosted on AL2 and use server SDK version 4.x for Amazon GameLift Servers, first update the game server build to server SDK 5.x, and then deploy to AL2023 instances. See `Migrate to server SDK version 5. <https://docs.aws.amazon.com/gamelift/latest/developerguide/reference-serversdk5-migration.html>`_
754
754
  :param server_sdk_version: A server SDK version you used when integrating your game server build with Amazon GameLift Servers. For more information see `Integrate games with custom game servers <https://docs.aws.amazon.com/gamelift/latest/developerguide/integration-custom-intro.html>`_ . By default Amazon GameLift Servers sets this value to ``4.0.2`` .
755
755
  :param storage_location: Information indicating where your game build files are stored. Use this parameter only when creating a build with files stored in an Amazon S3 bucket that you own. The storage location must specify an Amazon S3 bucket name and key. The location must also specify a role ARN that you set up to allow Amazon GameLift Servers to access your Amazon S3 bucket. The S3 bucket and your new build must be in the same Region. If a ``StorageLocation`` is specified, the size of your file can be found in your Amazon S3 bucket. Amazon GameLift Servers will report a ``SizeOnDisk`` of 0.
756
756
  :param version: Version information that is associated with this build. Version strings do not need to be unique.
@@ -816,7 +816,7 @@ class CfnBuildProps:
816
816
  This value determines the type of fleet resources that you use for this build. If your game build contains multiple executables, they all must run on the same operating system. You must specify a valid operating system in this request. There is no default value. You can't change a build's operating system later.
817
817
  .. epigraph::
818
818
 
819
- Amazon Linux 2 (AL2) will reach end of support on 6/30/2025. See more details in the `Amazon Linux 2 FAQs <https://docs.aws.amazon.com/https://aws.amazon.com/amazon-linux-2/faqs/>`_ . For game servers that are hosted on AL2 and use server SDK version 4.x for Amazon GameLift Servers, first update the game server build to server SDK 5.x, and then deploy to AL2023 instances. See `Migrate to server SDK version 5. <https://docs.aws.amazon.com/gamelift/latest/developerguide/reference-serversdk5-migration.html>`_
819
+ Amazon Linux 2 (AL2) will reach end of support on 6/30/2025. See more details in the `Amazon Linux 2 FAQs <https://docs.aws.amazon.com/amazon-linux-2/faqs/>`_ . For game servers that are hosted on AL2 and use server SDK version 4.x for Amazon GameLift Servers, first update the game server build to server SDK 5.x, and then deploy to AL2023 instances. See `Migrate to server SDK version 5. <https://docs.aws.amazon.com/gamelift/latest/developerguide/reference-serversdk5-migration.html>`_
820
820
 
821
821
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-gamelift-build.html#cfn-gamelift-build-operatingsystem
822
822
  '''
@@ -2928,7 +2928,7 @@ class CfnContainerGroupDefinition(
2928
2928
  :param scope: Scope in which this resource is defined.
2929
2929
  :param id: Construct identifier for this resource (unique in its scope).
2930
2930
  :param name: A descriptive identifier for the container group definition. The name value is unique in an AWS Region.
2931
- :param operating_system: The platform that all containers in the container group definition run on. .. epigraph:: Amazon Linux 2 (AL2) will reach end of support on 6/30/2025. See more details in the `Amazon Linux 2 FAQs <https://docs.aws.amazon.com/https://aws.amazon.com/amazon-linux-2/faqs/>`_ . For game servers that are hosted on AL2 and use server SDK version 4.x for Amazon GameLift Servers, first update the game server build to server SDK 5.x, and then deploy to AL2023 instances. See `Migrate to server SDK version 5. <https://docs.aws.amazon.com/gamelift/latest/developerguide/reference-serversdk5-migration.html>`_
2931
+ :param operating_system: The platform that all containers in the container group definition run on. .. epigraph:: Amazon Linux 2 (AL2) will reach end of support on 6/30/2025. See more details in the `Amazon Linux 2 FAQs <https://docs.aws.amazon.com/aws.amazon.com/amazon-linux-2/faqs/>`_ . For game servers that are hosted on AL2 and use server SDK version 4.x for Amazon GameLift Servers, first update the game server build to server SDK 5.x, and then deploy to AL2023 instances. See `Migrate to server SDK version 5. <https://docs.aws.amazon.com/gamelift/latest/developerguide/reference-serversdk5-migration.html>`_
2932
2932
  :param total_memory_limit_mebibytes: The amount of memory (in MiB) on a fleet instance to allocate for the container group. All containers in the group share these resources. You can set a limit for each container definition in the group. If individual containers have limits, this total value must be greater than any individual container's memory limit.
2933
2933
  :param total_vcpu_limit: The amount of vCPU units on a fleet instance to allocate for the container group (1 vCPU is equal to 1024 CPU units). All containers in the group share these resources. You can set a limit for each container definition in the group. If individual containers have limits, this total value must be equal to or greater than the sum of the limits for each container in the group.
2934
2934
  :param container_group_type: The type of container group. Container group type determines how Amazon GameLift Servers deploys the container group on each fleet instance.
@@ -4278,7 +4278,7 @@ class CfnContainerGroupDefinitionProps:
4278
4278
  '''Properties for defining a ``CfnContainerGroupDefinition``.
4279
4279
 
4280
4280
  :param name: A descriptive identifier for the container group definition. The name value is unique in an AWS Region.
4281
- :param operating_system: The platform that all containers in the container group definition run on. .. epigraph:: Amazon Linux 2 (AL2) will reach end of support on 6/30/2025. See more details in the `Amazon Linux 2 FAQs <https://docs.aws.amazon.com/https://aws.amazon.com/amazon-linux-2/faqs/>`_ . For game servers that are hosted on AL2 and use server SDK version 4.x for Amazon GameLift Servers, first update the game server build to server SDK 5.x, and then deploy to AL2023 instances. See `Migrate to server SDK version 5. <https://docs.aws.amazon.com/gamelift/latest/developerguide/reference-serversdk5-migration.html>`_
4281
+ :param operating_system: The platform that all containers in the container group definition run on. .. epigraph:: Amazon Linux 2 (AL2) will reach end of support on 6/30/2025. See more details in the `Amazon Linux 2 FAQs <https://docs.aws.amazon.com/aws.amazon.com/amazon-linux-2/faqs/>`_ . For game servers that are hosted on AL2 and use server SDK version 4.x for Amazon GameLift Servers, first update the game server build to server SDK 5.x, and then deploy to AL2023 instances. See `Migrate to server SDK version 5. <https://docs.aws.amazon.com/gamelift/latest/developerguide/reference-serversdk5-migration.html>`_
4282
4282
  :param total_memory_limit_mebibytes: The amount of memory (in MiB) on a fleet instance to allocate for the container group. All containers in the group share these resources. You can set a limit for each container definition in the group. If individual containers have limits, this total value must be greater than any individual container's memory limit.
4283
4283
  :param total_vcpu_limit: The amount of vCPU units on a fleet instance to allocate for the container group (1 vCPU is equal to 1024 CPU units). All containers in the group share these resources. You can set a limit for each container definition in the group. If individual containers have limits, this total value must be equal to or greater than the sum of the limits for each container in the group.
4284
4284
  :param container_group_type: The type of container group. Container group type determines how Amazon GameLift Servers deploys the container group on each fleet instance.
@@ -4433,7 +4433,7 @@ class CfnContainerGroupDefinitionProps:
4433
4433
 
4434
4434
  .. epigraph::
4435
4435
 
4436
- Amazon Linux 2 (AL2) will reach end of support on 6/30/2025. See more details in the `Amazon Linux 2 FAQs <https://docs.aws.amazon.com/https://aws.amazon.com/amazon-linux-2/faqs/>`_ . For game servers that are hosted on AL2 and use server SDK version 4.x for Amazon GameLift Servers, first update the game server build to server SDK 5.x, and then deploy to AL2023 instances. See `Migrate to server SDK version 5. <https://docs.aws.amazon.com/gamelift/latest/developerguide/reference-serversdk5-migration.html>`_
4436
+ Amazon Linux 2 (AL2) will reach end of support on 6/30/2025. See more details in the `Amazon Linux 2 FAQs <https://docs.aws.amazon.com/aws.amazon.com/amazon-linux-2/faqs/>`_ . For game servers that are hosted on AL2 and use server SDK version 4.x for Amazon GameLift Servers, first update the game server build to server SDK 5.x, and then deploy to AL2023 instances. See `Migrate to server SDK version 5. <https://docs.aws.amazon.com/gamelift/latest/developerguide/reference-serversdk5-migration.html>`_
4437
4437
 
4438
4438
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-gamelift-containergroupdefinition.html#cfn-gamelift-containergroupdefinition-operatingsystem
4439
4439
  '''
@@ -4706,7 +4706,7 @@ class CfnFleet(
4706
4706
  :param resource_creation_limit_policy: A policy that limits the number of game sessions that an individual player can create on instances in this fleet within a specified span of time.
4707
4707
  :param runtime_configuration: Instructions for how to launch and maintain server processes on instances in the fleet. The runtime configuration defines one or more server process configurations, each identifying a build executable or Realtime script file and the number of processes of that type to run concurrently. .. epigraph:: The ``RuntimeConfiguration`` parameter is required unless the fleet is being configured using the older parameters ``ServerLaunchPath`` and ``ServerLaunchParameters`` , which are still supported for backward compatibility.
4708
4708
  :param scaling_policies: Rule that controls how a fleet is scaled. Scaling policies are uniquely identified by the combination of name and fleet ID.
4709
- :param script_id: The unique identifier for a Realtime configuration script to be deployed on fleet instances. You can use either the script ID or ARN. Scripts must be uploaded to Amazon GameLift prior to creating the fleet. This fleet property cannot be changed later. .. epigraph:: You can't use the ``!Ref`` command to reference a script created with a CloudFormation template for the fleet property ``ScriptId`` . Instead, use ``Fn::GetAtt Script.Arn`` or ``Fn::GetAtt Script.Id`` to retrieve either of these properties as input for ``ScriptId`` . Alternatively, enter a ``ScriptId`` string manually.
4709
+ :param script_id: The unique identifier for a Realtime configuration script to be deployed on fleet instances. You can use either the script ID or ARN. Scripts must be uploaded to Amazon GameLift Servers prior to creating the fleet. This fleet property cannot be changed later. .. epigraph:: You can't use the ``!Ref`` command to reference a script created with a CloudFormation template for the fleet property ``ScriptId`` . Instead, use ``Fn::GetAtt Script.Arn`` or ``Fn::GetAtt Script.Id`` to retrieve either of these properties as input for ``ScriptId`` . Alternatively, enter a ``ScriptId`` string manually.
4710
4710
  :param server_launch_parameters: (deprecated) This parameter is no longer used but is retained for backward compatibility. Instead, specify server launch parameters in the RuntimeConfiguration parameter. A request must specify either a runtime configuration or values for both ServerLaunchParameters and ServerLaunchPath.
4711
4711
  :param server_launch_path: (deprecated) This parameter is no longer used. Instead, specify a server launch path using the RuntimeConfiguration parameter. Requests that specify a server launch path and launch parameters instead of a runtime configuration will continue to work.
4712
4712
  '''
@@ -6336,7 +6336,7 @@ class CfnFleetProps:
6336
6336
  :param resource_creation_limit_policy: A policy that limits the number of game sessions that an individual player can create on instances in this fleet within a specified span of time.
6337
6337
  :param runtime_configuration: Instructions for how to launch and maintain server processes on instances in the fleet. The runtime configuration defines one or more server process configurations, each identifying a build executable or Realtime script file and the number of processes of that type to run concurrently. .. epigraph:: The ``RuntimeConfiguration`` parameter is required unless the fleet is being configured using the older parameters ``ServerLaunchPath`` and ``ServerLaunchParameters`` , which are still supported for backward compatibility.
6338
6338
  :param scaling_policies: Rule that controls how a fleet is scaled. Scaling policies are uniquely identified by the combination of name and fleet ID.
6339
- :param script_id: The unique identifier for a Realtime configuration script to be deployed on fleet instances. You can use either the script ID or ARN. Scripts must be uploaded to Amazon GameLift prior to creating the fleet. This fleet property cannot be changed later. .. epigraph:: You can't use the ``!Ref`` command to reference a script created with a CloudFormation template for the fleet property ``ScriptId`` . Instead, use ``Fn::GetAtt Script.Arn`` or ``Fn::GetAtt Script.Id`` to retrieve either of these properties as input for ``ScriptId`` . Alternatively, enter a ``ScriptId`` string manually.
6339
+ :param script_id: The unique identifier for a Realtime configuration script to be deployed on fleet instances. You can use either the script ID or ARN. Scripts must be uploaded to Amazon GameLift Servers prior to creating the fleet. This fleet property cannot be changed later. .. epigraph:: You can't use the ``!Ref`` command to reference a script created with a CloudFormation template for the fleet property ``ScriptId`` . Instead, use ``Fn::GetAtt Script.Arn`` or ``Fn::GetAtt Script.Id`` to retrieve either of these properties as input for ``ScriptId`` . Alternatively, enter a ``ScriptId`` string manually.
6340
6340
  :param server_launch_parameters: (deprecated) This parameter is no longer used but is retained for backward compatibility. Instead, specify server launch parameters in the RuntimeConfiguration parameter. A request must specify either a runtime configuration or values for both ServerLaunchParameters and ServerLaunchPath.
6341
6341
  :param server_launch_path: (deprecated) This parameter is no longer used. Instead, specify a server launch path using the RuntimeConfiguration parameter. Requests that specify a server launch path and launch parameters instead of a runtime configuration will continue to work.
6342
6342
 
@@ -6808,7 +6808,7 @@ class CfnFleetProps:
6808
6808
  def script_id(self) -> typing.Optional[builtins.str]:
6809
6809
  '''The unique identifier for a Realtime configuration script to be deployed on fleet instances.
6810
6810
 
6811
- You can use either the script ID or ARN. Scripts must be uploaded to Amazon GameLift prior to creating the fleet. This fleet property cannot be changed later.
6811
+ You can use either the script ID or ARN. Scripts must be uploaded to Amazon GameLift Servers prior to creating the fleet. This fleet property cannot be changed later.
6812
6812
  .. epigraph::
6813
6813
 
6814
6814
  You can't use the ``!Ref`` command to reference a script created with a CloudFormation template for the fleet property ``ScriptId`` . Instead, use ``Fn::GetAtt Script.Arn`` or ``Fn::GetAtt Script.Id`` to retrieve either of these properties as input for ``ScriptId`` . Alternatively, enter a ``ScriptId`` string manually.
@@ -8483,7 +8483,7 @@ class IPrincipal(IGrantable, typing_extensions.Protocol):
8483
8483
  Notifications Service).
8484
8484
 
8485
8485
  A single logical Principal may also map to a set of physical principals.
8486
- For example, ``new OrganizationPrincipal('o-1234')`` represents all
8486
+ For example, ``new OrganizationPrincipal('o-12345abcde')`` represents all
8487
8487
  identities that are part of the given AWS Organization.
8488
8488
  '''
8489
8489
 
@@ -8539,7 +8539,7 @@ class _IPrincipalProxy(
8539
8539
  Notifications Service).
8540
8540
 
8541
8541
  A single logical Principal may also map to a set of physical principals.
8542
- For example, ``new OrganizationPrincipal('o-1234')`` represents all
8542
+ For example, ``new OrganizationPrincipal('o-12345abcde')`` represents all
8543
8543
  identities that are part of the given AWS Organization.
8544
8544
  '''
8545
8545
 
@@ -14772,7 +14772,9 @@ class OrganizationPrincipal(
14772
14772
 
14773
14773
  def __init__(self, organization_id: builtins.str) -> None:
14774
14774
  '''
14775
- :param organization_id: The unique identifier (ID) of an organization (i.e. o-12345abcde).
14775
+ :param organization_id: The unique identifier (ID) of an organization (i.e. o-12345abcde) It must match regex pattern ^o-[a-z0-9]{10,32}$.
14776
+
14777
+ :see: https://docs.aws.amazon.com/organizations/latest/APIReference/API_Organization.html
14776
14778
  '''
14777
14779
  if __debug__:
14778
14780
  type_hints = typing.get_type_hints(_typecheckingstub__4dc4375c7e3b272eef905d1d27c4bd67aa9d9f51ccb424f15955369df5f52edd)
@@ -14792,7 +14794,7 @@ class OrganizationPrincipal(
14792
14794
  @builtins.property
14793
14795
  @jsii.member(jsii_name="organizationId")
14794
14796
  def organization_id(self) -> builtins.str:
14795
- '''The unique identifier (ID) of an organization (i.e. o-12345abcde).'''
14797
+ '''The unique identifier (ID) of an organization (i.e. o-12345abcde) It must match regex pattern ^o-[a-z0-9]{10,32}$.'''
14796
14798
  return typing.cast(builtins.str, jsii.get(self, "organizationId"))
14797
14799
 
14798
14800
  @builtins.property
@@ -211,7 +211,9 @@ class CfnGroupMembership(
211
211
  metaclass=jsii.JSIIMeta,
212
212
  jsii_type="aws-cdk-lib.aws_identitystore.CfnGroupMembership",
213
213
  ):
214
- '''Contains the identifiers for a group, a group member, and a ``GroupMembership`` object in the identity store.
214
+ '''Creates a relationship between a member and a group.
215
+
216
+ The following identifiers must be specified: ``GroupId`` , ``IdentityStoreId`` , and ``MemberId`` .
215
217
 
216
218
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-identitystore-groupmembership.html
217
219
  :cloudformationResource: AWS::IdentityStore::GroupMembership
@@ -246,7 +248,7 @@ class CfnGroupMembership(
246
248
  :param id: Construct identifier for this resource (unique in its scope).
247
249
  :param group_id: The identifier for a group in the identity store.
248
250
  :param identity_store_id: The globally unique identifier for the identity store.
249
- :param member_id: An object containing the identifier of a group member. Setting ``MemberId`` 's ``UserId`` field to a specific User's ID indicates we should consider that User as a group member.
251
+ :param member_id: An object containing the identifier of a group member. Setting the ``MemberId`` 's ``UserId`` field to a specific User's ID indicates that user is a member of the group.
250
252
  '''
251
253
  if __debug__:
252
254
  type_hints = typing.get_type_hints(_typecheckingstub__76d55a804ce565c6f3a413944bff86b3236786318808951cf53ad4eff71316db)
@@ -422,7 +424,7 @@ class CfnGroupMembershipProps:
422
424
 
423
425
  :param group_id: The identifier for a group in the identity store.
424
426
  :param identity_store_id: The globally unique identifier for the identity store.
425
- :param member_id: An object containing the identifier of a group member. Setting ``MemberId`` 's ``UserId`` field to a specific User's ID indicates we should consider that User as a group member.
427
+ :param member_id: An object containing the identifier of a group member. Setting the ``MemberId`` 's ``UserId`` field to a specific User's ID indicates that user is a member of the group.
426
428
 
427
429
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-identitystore-groupmembership.html
428
430
  :exampleMetadata: fixture=_generated
@@ -478,7 +480,7 @@ class CfnGroupMembershipProps:
478
480
  ) -> typing.Union[_IResolvable_da3f097b, CfnGroupMembership.MemberIdProperty]:
479
481
  '''An object containing the identifier of a group member.
480
482
 
481
- Setting ``MemberId`` 's ``UserId`` field to a specific User's ID indicates we should consider that User as a group member.
483
+ Setting the ``MemberId`` 's ``UserId`` field to a specific User's ID indicates that user is a member of the group.
482
484
 
483
485
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-identitystore-groupmembership.html#cfn-identitystore-groupmembership-memberid
484
486
  '''