aws-cdk-lib 2.177.0__py3-none-any.whl → 2.178.1__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.
- aws_cdk/__init__.py +95 -61
- aws_cdk/_jsii/__init__.py +1 -1
- aws_cdk/_jsii/{aws-cdk-lib@2.177.0.jsii.tgz → aws-cdk-lib@2.178.1.jsii.tgz} +0 -0
- aws_cdk/aws_amplifyuibuilder/__init__.py +8 -8
- aws_cdk/aws_apigateway/__init__.py +97 -97
- aws_cdk/aws_apigatewayv2/__init__.py +35 -10
- aws_cdk/aws_appconfig/__init__.py +10 -10
- aws_cdk/aws_appflow/__init__.py +20 -20
- aws_cdk/aws_applicationsignals/__init__.py +8 -8
- aws_cdk/aws_appmesh/__init__.py +8 -8
- aws_cdk/aws_appsync/__init__.py +10383 -7035
- aws_cdk/aws_apptest/__init__.py +4 -4
- aws_cdk/aws_aps/__init__.py +135 -0
- aws_cdk/aws_athena/__init__.py +10 -10
- aws_cdk/aws_backup/__init__.py +14 -14
- aws_cdk/aws_batch/__init__.py +185 -22
- aws_cdk/aws_bcmdataexports/__init__.py +4 -4
- aws_cdk/aws_bedrock/__init__.py +266 -177
- aws_cdk/aws_certificatemanager/__init__.py +15 -14
- aws_cdk/aws_chatbot/__init__.py +4 -4
- aws_cdk/aws_cloudformation/__init__.py +22 -18
- aws_cdk/aws_cloudfront/__init__.py +674 -7
- aws_cdk/aws_cloudfront_origins/__init__.py +40 -0
- aws_cdk/aws_cloudtrail/__init__.py +4 -4
- aws_cdk/aws_cloudwatch/__init__.py +53 -53
- aws_cdk/aws_codedeploy/__init__.py +2 -2
- aws_cdk/aws_codepipeline/__init__.py +24 -6
- aws_cdk/aws_codepipeline_actions/__init__.py +2 -2
- aws_cdk/aws_cognito/__init__.py +42 -20
- aws_cdk/aws_connect/__init__.py +4 -4
- aws_cdk/aws_customerprofiles/__init__.py +3 -1
- aws_cdk/aws_databrew/__init__.py +16 -16
- aws_cdk/aws_datasync/__init__.py +14 -11
- aws_cdk/aws_datazone/__init__.py +5 -5
- aws_cdk/aws_dms/__init__.py +4 -4
- aws_cdk/aws_dynamodb/__init__.py +267 -25
- aws_cdk/aws_ec2/__init__.py +1137 -181
- aws_cdk/aws_ecs/__init__.py +740 -116
- aws_cdk/aws_ecs_patterns/__init__.py +49 -0
- aws_cdk/aws_efs/__init__.py +3 -3
- aws_cdk/aws_eks/__init__.py +31 -32
- aws_cdk/aws_elasticache/__init__.py +10 -10
- aws_cdk/aws_elasticloadbalancingv2/__init__.py +47 -18
- aws_cdk/aws_elasticsearch/__init__.py +10 -10
- aws_cdk/aws_emr/__init__.py +16 -16
- aws_cdk/aws_emrserverless/__init__.py +12 -9
- aws_cdk/aws_entityresolution/__init__.py +31 -17
- aws_cdk/aws_events/__init__.py +12 -12
- aws_cdk/aws_fis/__init__.py +16 -16
- aws_cdk/aws_fms/__init__.py +7 -3
- aws_cdk/aws_glue/__init__.py +1326 -7
- aws_cdk/aws_greengrassv2/__init__.py +8 -8
- aws_cdk/aws_guardduty/__init__.py +521 -0
- aws_cdk/aws_healthlake/__init__.py +10 -2
- aws_cdk/aws_imagebuilder/__init__.py +26 -26
- aws_cdk/aws_iot/__init__.py +40 -40
- aws_cdk/aws_iotanalytics/__init__.py +4 -4
- aws_cdk/aws_iotfleetwise/__init__.py +424 -10
- aws_cdk/aws_iotsitewise/__init__.py +84 -13
- aws_cdk/aws_iottwinmaker/__init__.py +18 -18
- aws_cdk/aws_iotwireless/__init__.py +4 -4
- aws_cdk/aws_kafkaconnect/__init__.py +10 -10
- aws_cdk/aws_kendra/__init__.py +0 -10
- aws_cdk/aws_kinesisanalytics/__init__.py +4 -4
- aws_cdk/aws_kinesisanalyticsv2/__init__.py +4 -4
- aws_cdk/aws_kinesisfirehose/__init__.py +4544 -183
- aws_cdk/aws_kms/__init__.py +11 -10
- aws_cdk/aws_lambda/__init__.py +34 -4
- aws_cdk/aws_lambda_nodejs/__init__.py +24 -5
- aws_cdk/aws_launchwizard/__init__.py +10 -10
- aws_cdk/aws_logs/__init__.py +19 -15
- aws_cdk/aws_mediaconnect/__init__.py +509 -12
- aws_cdk/aws_medialive/__init__.py +16 -16
- aws_cdk/aws_mediatailor/__init__.py +10 -10
- aws_cdk/aws_networkfirewall/__init__.py +12 -12
- aws_cdk/aws_notifications/__init__.py +602 -65
- aws_cdk/aws_omics/__init__.py +4 -4
- aws_cdk/aws_opensearchservice/__init__.py +10 -10
- aws_cdk/aws_opsworks/__init__.py +58 -58
- aws_cdk/aws_personalize/__init__.py +8 -8
- aws_cdk/aws_pipes/__init__.py +20 -20
- aws_cdk/aws_qbusiness/__init__.py +119 -0
- aws_cdk/aws_quicksight/__init__.py +247 -92
- aws_cdk/aws_rds/__init__.py +21 -15
- aws_cdk/aws_redshift/__init__.py +10 -10
- aws_cdk/aws_resiliencehub/__init__.py +0 -41
- aws_cdk/aws_route53/__init__.py +6 -0
- aws_cdk/aws_rum/__init__.py +4 -4
- aws_cdk/aws_s3/__init__.py +12 -2
- aws_cdk/aws_sagemaker/__init__.py +84 -60
- aws_cdk/aws_sam/__init__.py +48 -48
- aws_cdk/aws_secretsmanager/__init__.py +30 -14
- aws_cdk/aws_securityhub/__init__.py +12 -12
- aws_cdk/aws_sns/__init__.py +101 -15
- aws_cdk/aws_ssmquicksetup/__init__.py +10 -10
- aws_cdk/aws_stepfunctions/__init__.py +13207 -4740
- aws_cdk/aws_stepfunctions_tasks/__init__.py +77615 -22817
- aws_cdk/aws_synthetics/__init__.py +4 -4
- aws_cdk/aws_timestream/__init__.py +41 -0
- aws_cdk/aws_transfer/__init__.py +9 -10
- aws_cdk/aws_wafv2/__init__.py +24 -22
- aws_cdk/aws_wisdom/__init__.py +8 -8
- aws_cdk/aws_workspacesweb/__init__.py +60 -60
- aws_cdk/aws_xray/__init__.py +8 -8
- aws_cdk/cx_api/__init__.py +18 -0
- {aws_cdk_lib-2.177.0.dist-info → aws_cdk_lib-2.178.1.dist-info}/METADATA +1 -1
- {aws_cdk_lib-2.177.0.dist-info → aws_cdk_lib-2.178.1.dist-info}/RECORD +111 -111
- {aws_cdk_lib-2.177.0.dist-info → aws_cdk_lib-2.178.1.dist-info}/LICENSE +0 -0
- {aws_cdk_lib-2.177.0.dist-info → aws_cdk_lib-2.178.1.dist-info}/NOTICE +0 -0
- {aws_cdk_lib-2.177.0.dist-info → aws_cdk_lib-2.178.1.dist-info}/WHEEL +0 -0
- {aws_cdk_lib-2.177.0.dist-info → aws_cdk_lib-2.178.1.dist-info}/top_level.txt +0 -0
|
@@ -49,6 +49,8 @@ load_balanced_fargate_service = ecs_patterns.ApplicationLoadBalancedFargateServi
|
|
|
49
49
|
command=["command"],
|
|
50
50
|
entry_point=["entry", "point"]
|
|
51
51
|
),
|
|
52
|
+
container_cpu=256,
|
|
53
|
+
container_memory_limit_mi_b=512,
|
|
52
54
|
min_healthy_percent=100
|
|
53
55
|
)
|
|
54
56
|
|
|
@@ -74,6 +76,10 @@ By setting `redirectHTTP` to true, CDK will automatically create a listener on p
|
|
|
74
76
|
|
|
75
77
|
If you specify the option `recordType` you can decide if you want the construct to use CNAME or Route53-Aliases as record sets.
|
|
76
78
|
|
|
79
|
+
To set the minimum number of CPU units to reserve for the container, you can use the `containerCpu` property.
|
|
80
|
+
|
|
81
|
+
To set the amount of memory (in MiB) to provide to the container, you can use the `containerMemoryLimitMiB` property.
|
|
82
|
+
|
|
77
83
|
If you need to encrypt the traffic between the load balancer and the ECS tasks, you can set the `targetProtocol` to `HTTPS`.
|
|
78
84
|
|
|
79
85
|
Additionally, if more than one application target group are needed, instantiate one of the following:
|
|
@@ -8411,6 +8417,8 @@ class ApplicationLoadBalancedFargateService(
|
|
|
8411
8417
|
id: builtins.str,
|
|
8412
8418
|
*,
|
|
8413
8419
|
assign_public_ip: typing.Optional[builtins.bool] = None,
|
|
8420
|
+
container_cpu: typing.Optional[jsii.Number] = None,
|
|
8421
|
+
container_memory_limit_mib: typing.Optional[jsii.Number] = None,
|
|
8414
8422
|
health_check: typing.Optional[typing.Union[_HealthCheck_6459d04f, typing.Dict[builtins.str, typing.Any]]] = None,
|
|
8415
8423
|
security_groups: typing.Optional[typing.Sequence[_ISecurityGroup_acf8a799]] = None,
|
|
8416
8424
|
task_subnets: typing.Optional[typing.Union[_SubnetSelection_e57d76df, typing.Dict[builtins.str, typing.Any]]] = None,
|
|
@@ -8457,6 +8465,8 @@ class ApplicationLoadBalancedFargateService(
|
|
|
8457
8465
|
:param scope: -
|
|
8458
8466
|
:param id: -
|
|
8459
8467
|
:param assign_public_ip: Determines whether the service will be assigned a public IP address. Default: false
|
|
8468
|
+
:param container_cpu: The minimum number of CPU units to reserve for the container. Default: - No minimum CPU units reserved.
|
|
8469
|
+
:param container_memory_limit_mib: The amount (in MiB) of memory to present to the container. If your container attempts to exceed the allocated memory, the container is terminated. Default: - No memory limit.
|
|
8460
8470
|
:param health_check: The health check command and associated configuration parameters for the container. Default: - Health check configuration from container.
|
|
8461
8471
|
:param security_groups: The security groups to associate with the service. If you do not specify a security group, a new security group is created. Default: - A new security group is created.
|
|
8462
8472
|
:param task_subnets: The subnets to associate with the service. Default: - Public subnets if ``assignPublicIp`` is set, otherwise the first available one of Private, Isolated, Public, in that order.
|
|
@@ -8504,6 +8514,8 @@ class ApplicationLoadBalancedFargateService(
|
|
|
8504
8514
|
check_type(argname="argument id", value=id, expected_type=type_hints["id"])
|
|
8505
8515
|
props = ApplicationLoadBalancedFargateServiceProps(
|
|
8506
8516
|
assign_public_ip=assign_public_ip,
|
|
8517
|
+
container_cpu=container_cpu,
|
|
8518
|
+
container_memory_limit_mib=container_memory_limit_mib,
|
|
8507
8519
|
health_check=health_check,
|
|
8508
8520
|
security_groups=security_groups,
|
|
8509
8521
|
task_subnets=task_subnets,
|
|
@@ -8611,6 +8623,8 @@ class ApplicationLoadBalancedFargateService(
|
|
|
8611
8623
|
"runtime_platform": "runtimePlatform",
|
|
8612
8624
|
"task_definition": "taskDefinition",
|
|
8613
8625
|
"assign_public_ip": "assignPublicIp",
|
|
8626
|
+
"container_cpu": "containerCpu",
|
|
8627
|
+
"container_memory_limit_mib": "containerMemoryLimitMiB",
|
|
8614
8628
|
"health_check": "healthCheck",
|
|
8615
8629
|
"security_groups": "securityGroups",
|
|
8616
8630
|
"task_subnets": "taskSubnets",
|
|
@@ -8661,6 +8675,8 @@ class ApplicationLoadBalancedFargateServiceProps(
|
|
|
8661
8675
|
runtime_platform: typing.Optional[typing.Union[_RuntimePlatform_5ed98a9c, typing.Dict[builtins.str, typing.Any]]] = None,
|
|
8662
8676
|
task_definition: typing.Optional[_FargateTaskDefinition_83754b60] = None,
|
|
8663
8677
|
assign_public_ip: typing.Optional[builtins.bool] = None,
|
|
8678
|
+
container_cpu: typing.Optional[jsii.Number] = None,
|
|
8679
|
+
container_memory_limit_mib: typing.Optional[jsii.Number] = None,
|
|
8664
8680
|
health_check: typing.Optional[typing.Union[_HealthCheck_6459d04f, typing.Dict[builtins.str, typing.Any]]] = None,
|
|
8665
8681
|
security_groups: typing.Optional[typing.Sequence[_ISecurityGroup_acf8a799]] = None,
|
|
8666
8682
|
task_subnets: typing.Optional[typing.Union[_SubnetSelection_e57d76df, typing.Dict[builtins.str, typing.Any]]] = None,
|
|
@@ -8705,6 +8721,8 @@ class ApplicationLoadBalancedFargateServiceProps(
|
|
|
8705
8721
|
:param runtime_platform: The runtime platform of the task definition. Default: - If the property is undefined, ``operatingSystemFamily`` is LINUX and ``cpuArchitecture`` is X86_64
|
|
8706
8722
|
:param task_definition: The task definition to use for tasks in the service. TaskDefinition or TaskImageOptions must be specified, but not both. [disable-awslint:ref-via-interface] Default: - none
|
|
8707
8723
|
:param assign_public_ip: Determines whether the service will be assigned a public IP address. Default: false
|
|
8724
|
+
:param container_cpu: The minimum number of CPU units to reserve for the container. Default: - No minimum CPU units reserved.
|
|
8725
|
+
:param container_memory_limit_mib: The amount (in MiB) of memory to present to the container. If your container attempts to exceed the allocated memory, the container is terminated. Default: - No memory limit.
|
|
8708
8726
|
:param health_check: The health check command and associated configuration parameters for the container. Default: - Health check configuration from container.
|
|
8709
8727
|
:param security_groups: The security groups to associate with the service. If you do not specify a security group, a new security group is created. Default: - A new security group is created.
|
|
8710
8728
|
:param task_subnets: The subnets to associate with the service. Default: - Public subnets if ``assignPublicIp`` is set, otherwise the first available one of Private, Isolated, Public, in that order.
|
|
@@ -8793,6 +8811,8 @@ class ApplicationLoadBalancedFargateServiceProps(
|
|
|
8793
8811
|
check_type(argname="argument runtime_platform", value=runtime_platform, expected_type=type_hints["runtime_platform"])
|
|
8794
8812
|
check_type(argname="argument task_definition", value=task_definition, expected_type=type_hints["task_definition"])
|
|
8795
8813
|
check_type(argname="argument assign_public_ip", value=assign_public_ip, expected_type=type_hints["assign_public_ip"])
|
|
8814
|
+
check_type(argname="argument container_cpu", value=container_cpu, expected_type=type_hints["container_cpu"])
|
|
8815
|
+
check_type(argname="argument container_memory_limit_mib", value=container_memory_limit_mib, expected_type=type_hints["container_memory_limit_mib"])
|
|
8796
8816
|
check_type(argname="argument health_check", value=health_check, expected_type=type_hints["health_check"])
|
|
8797
8817
|
check_type(argname="argument security_groups", value=security_groups, expected_type=type_hints["security_groups"])
|
|
8798
8818
|
check_type(argname="argument task_subnets", value=task_subnets, expected_type=type_hints["task_subnets"])
|
|
@@ -8873,6 +8893,10 @@ class ApplicationLoadBalancedFargateServiceProps(
|
|
|
8873
8893
|
self._values["task_definition"] = task_definition
|
|
8874
8894
|
if assign_public_ip is not None:
|
|
8875
8895
|
self._values["assign_public_ip"] = assign_public_ip
|
|
8896
|
+
if container_cpu is not None:
|
|
8897
|
+
self._values["container_cpu"] = container_cpu
|
|
8898
|
+
if container_memory_limit_mib is not None:
|
|
8899
|
+
self._values["container_memory_limit_mib"] = container_memory_limit_mib
|
|
8876
8900
|
if health_check is not None:
|
|
8877
8901
|
self._values["health_check"] = health_check
|
|
8878
8902
|
if security_groups is not None:
|
|
@@ -9324,6 +9348,27 @@ class ApplicationLoadBalancedFargateServiceProps(
|
|
|
9324
9348
|
result = self._values.get("assign_public_ip")
|
|
9325
9349
|
return typing.cast(typing.Optional[builtins.bool], result)
|
|
9326
9350
|
|
|
9351
|
+
@builtins.property
|
|
9352
|
+
def container_cpu(self) -> typing.Optional[jsii.Number]:
|
|
9353
|
+
'''The minimum number of CPU units to reserve for the container.
|
|
9354
|
+
|
|
9355
|
+
:default: - No minimum CPU units reserved.
|
|
9356
|
+
'''
|
|
9357
|
+
result = self._values.get("container_cpu")
|
|
9358
|
+
return typing.cast(typing.Optional[jsii.Number], result)
|
|
9359
|
+
|
|
9360
|
+
@builtins.property
|
|
9361
|
+
def container_memory_limit_mib(self) -> typing.Optional[jsii.Number]:
|
|
9362
|
+
'''The amount (in MiB) of memory to present to the container.
|
|
9363
|
+
|
|
9364
|
+
If your container attempts to exceed the allocated memory, the container
|
|
9365
|
+
is terminated.
|
|
9366
|
+
|
|
9367
|
+
:default: - No memory limit.
|
|
9368
|
+
'''
|
|
9369
|
+
result = self._values.get("container_memory_limit_mib")
|
|
9370
|
+
return typing.cast(typing.Optional[jsii.Number], result)
|
|
9371
|
+
|
|
9327
9372
|
@builtins.property
|
|
9328
9373
|
def health_check(self) -> typing.Optional[_HealthCheck_6459d04f]:
|
|
9329
9374
|
'''The health check command and associated configuration parameters for the container.
|
|
@@ -17086,6 +17131,8 @@ def _typecheckingstub__52e4707f036e6b5ab8a12a1dd88ad78656d9ef102eb7d04caef957d69
|
|
|
17086
17131
|
id: builtins.str,
|
|
17087
17132
|
*,
|
|
17088
17133
|
assign_public_ip: typing.Optional[builtins.bool] = None,
|
|
17134
|
+
container_cpu: typing.Optional[jsii.Number] = None,
|
|
17135
|
+
container_memory_limit_mib: typing.Optional[jsii.Number] = None,
|
|
17089
17136
|
health_check: typing.Optional[typing.Union[_HealthCheck_6459d04f, typing.Dict[builtins.str, typing.Any]]] = None,
|
|
17090
17137
|
security_groups: typing.Optional[typing.Sequence[_ISecurityGroup_acf8a799]] = None,
|
|
17091
17138
|
task_subnets: typing.Optional[typing.Union[_SubnetSelection_e57d76df, typing.Dict[builtins.str, typing.Any]]] = None,
|
|
@@ -17170,6 +17217,8 @@ def _typecheckingstub__cdcb8bd483faaddad588ad37d4527fa1a0028fc2307a21fc3690044a0
|
|
|
17170
17217
|
runtime_platform: typing.Optional[typing.Union[_RuntimePlatform_5ed98a9c, typing.Dict[builtins.str, typing.Any]]] = None,
|
|
17171
17218
|
task_definition: typing.Optional[_FargateTaskDefinition_83754b60] = None,
|
|
17172
17219
|
assign_public_ip: typing.Optional[builtins.bool] = None,
|
|
17220
|
+
container_cpu: typing.Optional[jsii.Number] = None,
|
|
17221
|
+
container_memory_limit_mib: typing.Optional[jsii.Number] = None,
|
|
17173
17222
|
health_check: typing.Optional[typing.Union[_HealthCheck_6459d04f, typing.Dict[builtins.str, typing.Any]]] = None,
|
|
17174
17223
|
security_groups: typing.Optional[typing.Sequence[_ISecurityGroup_acf8a799]] = None,
|
|
17175
17224
|
task_subnets: typing.Optional[typing.Union[_SubnetSelection_e57d76df, typing.Dict[builtins.str, typing.Any]]] = None,
|
aws_cdk/aws_efs/__init__.py
CHANGED
|
@@ -1634,7 +1634,7 @@ class CfnFileSystem(
|
|
|
1634
1634
|
:param kms_key_id: The ID of the AWS KMS key to be used to protect the encrypted file system. This parameter is only required if you want to use a nondefault KMS key . If this parameter is not specified, the default KMS key for Amazon EFS is used. This ID can be in one of the following formats: - Key ID - A unique identifier of the key, for example ``1234abcd-12ab-34cd-56ef-1234567890ab`` . - ARN - An Amazon Resource Name (ARN) for the key, for example ``arn:aws:kms:us-west-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab`` . - Key alias - A previously created display name for a key, for example ``alias/projectKey1`` . - Key alias ARN - An ARN for a key alias, for example ``arn:aws:kms:us-west-2:444455556666:alias/projectKey1`` . If ``KmsKeyId`` is specified, the ``Encrypted`` parameter must be set to true.
|
|
1635
1635
|
:param lifecycle_policies: An array of ``LifecyclePolicy`` objects that define the file system's ``LifecycleConfiguration`` object. A ``LifecycleConfiguration`` object informs Lifecycle management of the following: - When to move files in the file system from primary storage to IA storage. - When to move files in the file system from primary storage or IA storage to Archive storage. - When to move files that are in IA or Archive storage to primary storage. .. epigraph:: Amazon EFS requires that each ``LifecyclePolicy`` object have only a single transition. This means that in a request body, ``LifecyclePolicies`` needs to be structured as an array of ``LifecyclePolicy`` objects, one object for each transition, ``TransitionToIA`` , ``TransitionToArchive`` ``TransitionToPrimaryStorageClass`` . See the example requests in the following section for more information.
|
|
1636
1636
|
:param performance_mode: The performance mode of the file system. We recommend ``generalPurpose`` performance mode for all file systems. File systems using the ``maxIO`` performance mode can scale to higher levels of aggregate throughput and operations per second with a tradeoff of slightly higher latencies for most file operations. The performance mode can't be changed after the file system has been created. The ``maxIO`` mode is not supported on One Zone file systems. .. epigraph:: Due to the higher per-operation latencies with Max I/O, we recommend using General Purpose performance mode for all file systems. Default is ``generalPurpose`` .
|
|
1637
|
-
:param provisioned_throughput_in_mibps: The throughput, measured in mebibytes per second (MiBps), that you want to provision for a file system that you're creating. Required if ``ThroughputMode`` is set to ``provisioned`` . Valid values are 1-3414 MiBps, with the upper limit depending on Region. To increase this limit, contact
|
|
1637
|
+
:param provisioned_throughput_in_mibps: The throughput, measured in mebibytes per second (MiBps), that you want to provision for a file system that you're creating. Required if ``ThroughputMode`` is set to ``provisioned`` . Valid values are 1-3414 MiBps, with the upper limit depending on Region. To increase this limit, contact Support . For more information, see `Amazon EFS quotas that you can increase <https://docs.aws.amazon.com/efs/latest/ug/limits.html#soft-limits>`_ in the *Amazon EFS User Guide* .
|
|
1638
1638
|
:param replication_configuration: Describes the replication configuration for a specific file system.
|
|
1639
1639
|
:param throughput_mode: Specifies the throughput mode for the file system. The mode can be ``bursting`` , ``provisioned`` , or ``elastic`` . If you set ``ThroughputMode`` to ``provisioned`` , you must also set a value for ``ProvisionedThroughputInMibps`` . After you create the file system, you can decrease your file system's Provisioned throughput or change between the throughput modes, with certain time restrictions. For more information, see `Specifying throughput with provisioned mode <https://docs.aws.amazon.com/efs/latest/ug/performance.html#provisioned-throughput>`_ in the *Amazon EFS User Guide* . Default is ``bursting`` .
|
|
1640
1640
|
'''
|
|
@@ -2502,7 +2502,7 @@ class CfnFileSystemProps:
|
|
|
2502
2502
|
:param kms_key_id: The ID of the AWS KMS key to be used to protect the encrypted file system. This parameter is only required if you want to use a nondefault KMS key . If this parameter is not specified, the default KMS key for Amazon EFS is used. This ID can be in one of the following formats: - Key ID - A unique identifier of the key, for example ``1234abcd-12ab-34cd-56ef-1234567890ab`` . - ARN - An Amazon Resource Name (ARN) for the key, for example ``arn:aws:kms:us-west-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab`` . - Key alias - A previously created display name for a key, for example ``alias/projectKey1`` . - Key alias ARN - An ARN for a key alias, for example ``arn:aws:kms:us-west-2:444455556666:alias/projectKey1`` . If ``KmsKeyId`` is specified, the ``Encrypted`` parameter must be set to true.
|
|
2503
2503
|
:param lifecycle_policies: An array of ``LifecyclePolicy`` objects that define the file system's ``LifecycleConfiguration`` object. A ``LifecycleConfiguration`` object informs Lifecycle management of the following: - When to move files in the file system from primary storage to IA storage. - When to move files in the file system from primary storage or IA storage to Archive storage. - When to move files that are in IA or Archive storage to primary storage. .. epigraph:: Amazon EFS requires that each ``LifecyclePolicy`` object have only a single transition. This means that in a request body, ``LifecyclePolicies`` needs to be structured as an array of ``LifecyclePolicy`` objects, one object for each transition, ``TransitionToIA`` , ``TransitionToArchive`` ``TransitionToPrimaryStorageClass`` . See the example requests in the following section for more information.
|
|
2504
2504
|
:param performance_mode: The performance mode of the file system. We recommend ``generalPurpose`` performance mode for all file systems. File systems using the ``maxIO`` performance mode can scale to higher levels of aggregate throughput and operations per second with a tradeoff of slightly higher latencies for most file operations. The performance mode can't be changed after the file system has been created. The ``maxIO`` mode is not supported on One Zone file systems. .. epigraph:: Due to the higher per-operation latencies with Max I/O, we recommend using General Purpose performance mode for all file systems. Default is ``generalPurpose`` .
|
|
2505
|
-
:param provisioned_throughput_in_mibps: The throughput, measured in mebibytes per second (MiBps), that you want to provision for a file system that you're creating. Required if ``ThroughputMode`` is set to ``provisioned`` . Valid values are 1-3414 MiBps, with the upper limit depending on Region. To increase this limit, contact
|
|
2505
|
+
:param provisioned_throughput_in_mibps: The throughput, measured in mebibytes per second (MiBps), that you want to provision for a file system that you're creating. Required if ``ThroughputMode`` is set to ``provisioned`` . Valid values are 1-3414 MiBps, with the upper limit depending on Region. To increase this limit, contact Support . For more information, see `Amazon EFS quotas that you can increase <https://docs.aws.amazon.com/efs/latest/ug/limits.html#soft-limits>`_ in the *Amazon EFS User Guide* .
|
|
2506
2506
|
:param replication_configuration: Describes the replication configuration for a specific file system.
|
|
2507
2507
|
:param throughput_mode: Specifies the throughput mode for the file system. The mode can be ``bursting`` , ``provisioned`` , or ``elastic`` . If you set ``ThroughputMode`` to ``provisioned`` , you must also set a value for ``ProvisionedThroughputInMibps`` . After you create the file system, you can decrease your file system's Provisioned throughput or change between the throughput modes, with certain time restrictions. For more information, see `Specifying throughput with provisioned mode <https://docs.aws.amazon.com/efs/latest/ug/performance.html#provisioned-throughput>`_ in the *Amazon EFS User Guide* . Default is ``bursting`` .
|
|
2508
2508
|
|
|
@@ -2742,7 +2742,7 @@ class CfnFileSystemProps:
|
|
|
2742
2742
|
def provisioned_throughput_in_mibps(self) -> typing.Optional[jsii.Number]:
|
|
2743
2743
|
'''The throughput, measured in mebibytes per second (MiBps), that you want to provision for a file system that you're creating.
|
|
2744
2744
|
|
|
2745
|
-
Required if ``ThroughputMode`` is set to ``provisioned`` . Valid values are 1-3414 MiBps, with the upper limit depending on Region. To increase this limit, contact
|
|
2745
|
+
Required if ``ThroughputMode`` is set to ``provisioned`` . Valid values are 1-3414 MiBps, with the upper limit depending on Region. To increase this limit, contact Support . For more information, see `Amazon EFS quotas that you can increase <https://docs.aws.amazon.com/efs/latest/ug/limits.html#soft-limits>`_ in the *Amazon EFS User Guide* .
|
|
2746
2746
|
|
|
2747
2747
|
:see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-efs-filesystem.html#cfn-efs-filesystem-provisionedthroughputinmibps
|
|
2748
2748
|
'''
|
aws_cdk/aws_eks/__init__.py
CHANGED
|
@@ -822,7 +822,7 @@ By default, CDK will create a new python lambda function to apply your k8s manif
|
|
|
822
822
|
|
|
823
823
|
```python
|
|
824
824
|
handler_role = iam.Role.from_role_arn(self, "HandlerRole", "arn:aws:iam::123456789012:role/lambda-role")
|
|
825
|
-
# get the
|
|
825
|
+
# get the serviceToken from the custom resource provider
|
|
826
826
|
function_arn = lambda_.Function.from_function_name(self, "ProviderOnEventFunc", "ProviderframeworkonEvent-XXX").function_arn
|
|
827
827
|
kubectl_provider = eks.KubectlProvider.from_kubectl_provider_attributes(self, "KubectlProvider",
|
|
828
828
|
function_arn=function_arn,
|
|
@@ -2690,7 +2690,7 @@ class AddonProps:
|
|
|
2690
2690
|
|
|
2691
2691
|
:param addon_name: Name of the Add-On.
|
|
2692
2692
|
:param cluster: The EKS cluster the Add-On is associated with.
|
|
2693
|
-
:param addon_version: Version of the Add-On. You can check all available versions with describe-addon-
|
|
2693
|
+
:param addon_version: Version of the Add-On. You can check all available versions with describe-addon-versions. For example, this lists all available versions for the ``eks-pod-identity-agent`` addon: $ aws eks describe-addon-versions --addon-name eks-pod-identity-agent --query 'addons[*].addonVersions[*].addonVersion' Default: the latest version.
|
|
2694
2694
|
:param preserve_on_delete: Specifying this option preserves the add-on software on your cluster but Amazon EKS stops managing any settings for the add-on. If an IAM account is associated with the add-on, it isn't removed. Default: true
|
|
2695
2695
|
|
|
2696
2696
|
:exampleMetadata: infused
|
|
@@ -2741,7 +2741,7 @@ class AddonProps:
|
|
|
2741
2741
|
def addon_version(self) -> typing.Optional[builtins.str]:
|
|
2742
2742
|
'''Version of the Add-On.
|
|
2743
2743
|
|
|
2744
|
-
You can check all available versions with describe-addon-
|
|
2744
|
+
You can check all available versions with describe-addon-versions.
|
|
2745
2745
|
For example, this lists all available versions for the ``eks-pod-identity-agent`` addon:
|
|
2746
2746
|
$ aws eks describe-addon-versions --addon-name eks-pod-identity-agent
|
|
2747
2747
|
--query 'addons[*].addonVersions[*].addonVersion'
|
|
@@ -4675,11 +4675,11 @@ class CfnAccessEntry(
|
|
|
4675
4675
|
:param scope: Scope in which this resource is defined.
|
|
4676
4676
|
:param id: Construct identifier for this resource (unique in its scope).
|
|
4677
4677
|
:param cluster_name: The name of your cluster.
|
|
4678
|
-
:param principal_arn: The ARN of the IAM principal for the ``AccessEntry`` . You can specify one ARN for each access entry. You can't specify the same ARN in more than one access entry. This value can't be changed after access entry creation. The valid principals differ depending on the type of the access entry in the ``type`` field.
|
|
4678
|
+
:param principal_arn: The ARN of the IAM principal for the ``AccessEntry`` . You can specify one ARN for each access entry. You can't specify the same ARN in more than one access entry. This value can't be changed after access entry creation. The valid principals differ depending on the type of the access entry in the ``type`` field. For ``STANDARD`` access entries, you can use every IAM principal type. For nodes ( ``EC2`` (for EKS Auto Mode), ``EC2_LINUX`` , ``EC2_WINDOWS`` , ``FARGATE_LINUX`` , and ``HYBRID_LINUX`` ), the only valid ARN is IAM roles. You can't use the STS session principal type with access entries because this is a temporary principal for each session and not a permanent identity that can be assigned permissions. `IAM best practices <https://docs.aws.amazon.com/IAM/latest/UserGuide/best-practices.html#bp-users-federation-idp>`_ recommend using IAM roles with temporary credentials, rather than IAM users with long-term credentials.
|
|
4679
4679
|
:param access_policies: The access policies to associate to the access entry.
|
|
4680
4680
|
:param kubernetes_groups: The value for ``name`` that you've specified for ``kind: Group`` as a ``subject`` in a Kubernetes ``RoleBinding`` or ``ClusterRoleBinding`` object. Amazon EKS doesn't confirm that the value for ``name`` exists in any bindings on your cluster. You can specify one or more names. Kubernetes authorizes the ``principalArn`` of the access entry to access any cluster objects that you've specified in a Kubernetes ``Role`` or ``ClusterRole`` object that is also specified in a binding's ``roleRef`` . For more information about creating Kubernetes ``RoleBinding`` , ``ClusterRoleBinding`` , ``Role`` , or ``ClusterRole`` objects, see `Using RBAC Authorization in the Kubernetes documentation <https://docs.aws.amazon.com/https://kubernetes.io/docs/reference/access-authn-authz/rbac/>`_ . If you want Amazon EKS to authorize the ``principalArn`` (instead of, or in addition to Kubernetes authorizing the ``principalArn`` ), you can associate one or more access policies to the access entry using ``AssociateAccessPolicy`` . If you associate any access policies, the ``principalARN`` has all permissions assigned in the associated access policies and all permissions in any Kubernetes ``Role`` or ``ClusterRole`` objects that the group names are bound to.
|
|
4681
4681
|
:param tags: Metadata that assists with categorization and organization. Each tag consists of a key and an optional value. You define both. Tags don't propagate to any other cluster or AWS resources.
|
|
4682
|
-
:param type: The type of the new access entry. Valid values are ``
|
|
4682
|
+
:param type: The type of the new access entry. Valid values are ``STANDARD`` , ``FARGATE_LINUX`` , ``EC2_LINUX`` , ``EC2_WINDOWS`` , ``EC2`` (for EKS Auto Mode), ``HYBRID_LINUX`` , and ``HYPERPOD_LINUX`` . If the ``principalArn`` is for an IAM role that's used for self-managed Amazon EC2 nodes, specify ``EC2_LINUX`` or ``EC2_WINDOWS`` . Amazon EKS grants the necessary permissions to the node for you. If the ``principalArn`` is for any other purpose, specify ``STANDARD`` . If you don't specify a value, Amazon EKS sets the value to ``STANDARD`` . If you have the access mode of the cluster set to ``API_AND_CONFIG_MAP`` , it's unnecessary to create access entries for IAM roles used with Fargate profiles or managed Amazon EC2 nodes, because Amazon EKS creates entries in the ``aws-auth`` ``ConfigMap`` for the roles. You can't change this value once you've created the access entry. If you set the value to ``EC2_LINUX`` or ``EC2_WINDOWS`` , you can't specify values for ``kubernetesGroups`` , or associate an ``AccessPolicy`` to the access entry.
|
|
4683
4683
|
:param username: The username to authenticate to Kubernetes with. We recommend not specifying a username and letting Amazon EKS specify it for you. For more information about the value Amazon EKS specifies for you, or constraints before specifying your own username, see `Creating access entries <https://docs.aws.amazon.com/eks/latest/userguide/access-entries.html#creating-access-entries>`_ in the *Amazon EKS User Guide* .
|
|
4684
4684
|
'''
|
|
4685
4685
|
if __debug__:
|
|
@@ -4824,10 +4824,7 @@ class CfnAccessEntry(
|
|
|
4824
4824
|
@builtins.property
|
|
4825
4825
|
@jsii.member(jsii_name="type")
|
|
4826
4826
|
def type(self) -> typing.Optional[builtins.str]:
|
|
4827
|
-
'''The type of the new access entry.
|
|
4828
|
-
|
|
4829
|
-
Valid values are ``Standard`` , ``FARGATE_LINUX`` , ``EC2_LINUX`` , and ``EC2_WINDOWS`` .
|
|
4830
|
-
'''
|
|
4827
|
+
'''The type of the new access entry.'''
|
|
4831
4828
|
return typing.cast(typing.Optional[builtins.str], jsii.get(self, "type"))
|
|
4832
4829
|
|
|
4833
4830
|
@type.setter
|
|
@@ -5034,11 +5031,11 @@ class CfnAccessEntryProps:
|
|
|
5034
5031
|
'''Properties for defining a ``CfnAccessEntry``.
|
|
5035
5032
|
|
|
5036
5033
|
:param cluster_name: The name of your cluster.
|
|
5037
|
-
:param principal_arn: The ARN of the IAM principal for the ``AccessEntry`` . You can specify one ARN for each access entry. You can't specify the same ARN in more than one access entry. This value can't be changed after access entry creation. The valid principals differ depending on the type of the access entry in the ``type`` field.
|
|
5034
|
+
:param principal_arn: The ARN of the IAM principal for the ``AccessEntry`` . You can specify one ARN for each access entry. You can't specify the same ARN in more than one access entry. This value can't be changed after access entry creation. The valid principals differ depending on the type of the access entry in the ``type`` field. For ``STANDARD`` access entries, you can use every IAM principal type. For nodes ( ``EC2`` (for EKS Auto Mode), ``EC2_LINUX`` , ``EC2_WINDOWS`` , ``FARGATE_LINUX`` , and ``HYBRID_LINUX`` ), the only valid ARN is IAM roles. You can't use the STS session principal type with access entries because this is a temporary principal for each session and not a permanent identity that can be assigned permissions. `IAM best practices <https://docs.aws.amazon.com/IAM/latest/UserGuide/best-practices.html#bp-users-federation-idp>`_ recommend using IAM roles with temporary credentials, rather than IAM users with long-term credentials.
|
|
5038
5035
|
:param access_policies: The access policies to associate to the access entry.
|
|
5039
5036
|
:param kubernetes_groups: The value for ``name`` that you've specified for ``kind: Group`` as a ``subject`` in a Kubernetes ``RoleBinding`` or ``ClusterRoleBinding`` object. Amazon EKS doesn't confirm that the value for ``name`` exists in any bindings on your cluster. You can specify one or more names. Kubernetes authorizes the ``principalArn`` of the access entry to access any cluster objects that you've specified in a Kubernetes ``Role`` or ``ClusterRole`` object that is also specified in a binding's ``roleRef`` . For more information about creating Kubernetes ``RoleBinding`` , ``ClusterRoleBinding`` , ``Role`` , or ``ClusterRole`` objects, see `Using RBAC Authorization in the Kubernetes documentation <https://docs.aws.amazon.com/https://kubernetes.io/docs/reference/access-authn-authz/rbac/>`_ . If you want Amazon EKS to authorize the ``principalArn`` (instead of, or in addition to Kubernetes authorizing the ``principalArn`` ), you can associate one or more access policies to the access entry using ``AssociateAccessPolicy`` . If you associate any access policies, the ``principalARN`` has all permissions assigned in the associated access policies and all permissions in any Kubernetes ``Role`` or ``ClusterRole`` objects that the group names are bound to.
|
|
5040
5037
|
:param tags: Metadata that assists with categorization and organization. Each tag consists of a key and an optional value. You define both. Tags don't propagate to any other cluster or AWS resources.
|
|
5041
|
-
:param type: The type of the new access entry. Valid values are ``
|
|
5038
|
+
:param type: The type of the new access entry. Valid values are ``STANDARD`` , ``FARGATE_LINUX`` , ``EC2_LINUX`` , ``EC2_WINDOWS`` , ``EC2`` (for EKS Auto Mode), ``HYBRID_LINUX`` , and ``HYPERPOD_LINUX`` . If the ``principalArn`` is for an IAM role that's used for self-managed Amazon EC2 nodes, specify ``EC2_LINUX`` or ``EC2_WINDOWS`` . Amazon EKS grants the necessary permissions to the node for you. If the ``principalArn`` is for any other purpose, specify ``STANDARD`` . If you don't specify a value, Amazon EKS sets the value to ``STANDARD`` . If you have the access mode of the cluster set to ``API_AND_CONFIG_MAP`` , it's unnecessary to create access entries for IAM roles used with Fargate profiles or managed Amazon EC2 nodes, because Amazon EKS creates entries in the ``aws-auth`` ``ConfigMap`` for the roles. You can't change this value once you've created the access entry. If you set the value to ``EC2_LINUX`` or ``EC2_WINDOWS`` , you can't specify values for ``kubernetesGroups`` , or associate an ``AccessPolicy`` to the access entry.
|
|
5042
5039
|
:param username: The username to authenticate to Kubernetes with. We recommend not specifying a username and letting Amazon EKS specify it for you. For more information about the value Amazon EKS specifies for you, or constraints before specifying your own username, see `Creating access entries <https://docs.aws.amazon.com/eks/latest/userguide/access-entries.html#creating-access-entries>`_ in the *Amazon EKS User Guide* .
|
|
5043
5040
|
|
|
5044
5041
|
:see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-eks-accessentry.html
|
|
@@ -5113,7 +5110,7 @@ class CfnAccessEntryProps:
|
|
|
5113
5110
|
|
|
5114
5111
|
You can specify one ARN for each access entry. You can't specify the same ARN in more than one access entry. This value can't be changed after access entry creation.
|
|
5115
5112
|
|
|
5116
|
-
The valid principals differ depending on the type of the access entry in the ``type`` field.
|
|
5113
|
+
The valid principals differ depending on the type of the access entry in the ``type`` field. For ``STANDARD`` access entries, you can use every IAM principal type. For nodes ( ``EC2`` (for EKS Auto Mode), ``EC2_LINUX`` , ``EC2_WINDOWS`` , ``FARGATE_LINUX`` , and ``HYBRID_LINUX`` ), the only valid ARN is IAM roles. You can't use the STS session principal type with access entries because this is a temporary principal for each session and not a permanent identity that can be assigned permissions.
|
|
5117
5114
|
|
|
5118
5115
|
`IAM best practices <https://docs.aws.amazon.com/IAM/latest/UserGuide/best-practices.html#bp-users-federation-idp>`_ recommend using IAM roles with temporary credentials, rather than IAM users with long-term credentials.
|
|
5119
5116
|
|
|
@@ -5162,9 +5159,11 @@ class CfnAccessEntryProps:
|
|
|
5162
5159
|
|
|
5163
5160
|
@builtins.property
|
|
5164
5161
|
def type(self) -> typing.Optional[builtins.str]:
|
|
5165
|
-
'''The type of the new access entry.
|
|
5162
|
+
'''The type of the new access entry.
|
|
5166
5163
|
|
|
5167
|
-
|
|
5164
|
+
Valid values are ``STANDARD`` , ``FARGATE_LINUX`` , ``EC2_LINUX`` , ``EC2_WINDOWS`` , ``EC2`` (for EKS Auto Mode), ``HYBRID_LINUX`` , and ``HYPERPOD_LINUX`` .
|
|
5165
|
+
|
|
5166
|
+
If the ``principalArn`` is for an IAM role that's used for self-managed Amazon EC2 nodes, specify ``EC2_LINUX`` or ``EC2_WINDOWS`` . Amazon EKS grants the necessary permissions to the node for you. If the ``principalArn`` is for any other purpose, specify ``STANDARD`` . If you don't specify a value, Amazon EKS sets the value to ``STANDARD`` . If you have the access mode of the cluster set to ``API_AND_CONFIG_MAP`` , it's unnecessary to create access entries for IAM roles used with Fargate profiles or managed Amazon EC2 nodes, because Amazon EKS creates entries in the ``aws-auth`` ``ConfigMap`` for the roles. You can't change this value once you've created the access entry.
|
|
5168
5167
|
|
|
5169
5168
|
If you set the value to ``EC2_LINUX`` or ``EC2_WINDOWS`` , you can't specify values for ``kubernetesGroups`` , or associate an ``AccessPolicy`` to the access entry.
|
|
5170
5169
|
|
|
@@ -5261,7 +5260,7 @@ class CfnAddon(
|
|
|
5261
5260
|
:param configuration_values: The configuration values that you provided.
|
|
5262
5261
|
:param pod_identity_associations: An array of Pod Identity Assocations owned by the Addon. Each EKS Pod Identity association maps a role to a service account in a namespace in the cluster. For more information, see `Attach an IAM Role to an Amazon EKS add-on using Pod Identity <https://docs.aws.amazon.com/eks/latest/userguide/add-ons-iam.html>`_ in the *Amazon EKS User Guide* .
|
|
5263
5262
|
:param preserve_on_delete: Specifying this option preserves the add-on software on your cluster but Amazon EKS stops managing any settings for the add-on. If an IAM account is associated with the add-on, it isn't removed.
|
|
5264
|
-
:param resolve_conflicts: How to resolve field value conflicts for an Amazon EKS add-on. Conflicts are handled based on the value you choose: - *None* – If the self-managed version of the add-on is installed on your cluster, Amazon EKS doesn't change the value. Creation of the add-on might fail. - *Overwrite* – If the self-managed version of the add-on is installed on your cluster and the Amazon EKS default value is different than the existing value, Amazon EKS changes the value to the Amazon EKS default value. - *Preserve* – This is similar to the NONE option. If the self-managed version of the add-on is installed on your cluster Amazon EKS doesn't change the add-on resource properties. Creation of the add-on might fail if conflicts are detected. This option works differently during the update operation. For more information, see
|
|
5263
|
+
:param resolve_conflicts: How to resolve field value conflicts for an Amazon EKS add-on. Conflicts are handled based on the value you choose: - *None* – If the self-managed version of the add-on is installed on your cluster, Amazon EKS doesn't change the value. Creation of the add-on might fail. - *Overwrite* – If the self-managed version of the add-on is installed on your cluster and the Amazon EKS default value is different than the existing value, Amazon EKS changes the value to the Amazon EKS default value. - *Preserve* – This is similar to the NONE option. If the self-managed version of the add-on is installed on your cluster Amazon EKS doesn't change the add-on resource properties. Creation of the add-on might fail if conflicts are detected. This option works differently during the update operation. For more information, see ```UpdateAddon`` <https://docs.aws.amazon.com/eks/latest/APIReference/API_UpdateAddon.html>`_ . If you don't currently have the self-managed version of the add-on installed on your cluster, the Amazon EKS add-on is installed. Amazon EKS sets all values to default values, regardless of the option that you specify.
|
|
5265
5264
|
:param service_account_role_arn: The Amazon Resource Name (ARN) of an existing IAM role to bind to the add-on's service account. The role must be assigned the IAM permissions required by the add-on. If you don't specify an existing IAM role, then the add-on uses the permissions assigned to the node IAM role. For more information, see `Amazon EKS node IAM role <https://docs.aws.amazon.com/eks/latest/userguide/create-node-role.html>`_ in the *Amazon EKS User Guide* . .. epigraph:: To specify an existing IAM role, you must have an IAM OpenID Connect (OIDC) provider created for your cluster. For more information, see `Enabling IAM roles for service accounts on your cluster <https://docs.aws.amazon.com/eks/latest/userguide/enable-iam-roles-for-service-accounts.html>`_ in the *Amazon EKS User Guide* .
|
|
5266
5265
|
:param tags: The metadata that you apply to the add-on to assist with categorization and organization. Each tag consists of a key and an optional value, both of which you define. Add-on tags do not propagate to any other resources associated with the cluster.
|
|
5267
5266
|
'''
|
|
@@ -5571,7 +5570,7 @@ class CfnAddonProps:
|
|
|
5571
5570
|
:param configuration_values: The configuration values that you provided.
|
|
5572
5571
|
:param pod_identity_associations: An array of Pod Identity Assocations owned by the Addon. Each EKS Pod Identity association maps a role to a service account in a namespace in the cluster. For more information, see `Attach an IAM Role to an Amazon EKS add-on using Pod Identity <https://docs.aws.amazon.com/eks/latest/userguide/add-ons-iam.html>`_ in the *Amazon EKS User Guide* .
|
|
5573
5572
|
:param preserve_on_delete: Specifying this option preserves the add-on software on your cluster but Amazon EKS stops managing any settings for the add-on. If an IAM account is associated with the add-on, it isn't removed.
|
|
5574
|
-
:param resolve_conflicts: How to resolve field value conflicts for an Amazon EKS add-on. Conflicts are handled based on the value you choose: - *None* – If the self-managed version of the add-on is installed on your cluster, Amazon EKS doesn't change the value. Creation of the add-on might fail. - *Overwrite* – If the self-managed version of the add-on is installed on your cluster and the Amazon EKS default value is different than the existing value, Amazon EKS changes the value to the Amazon EKS default value. - *Preserve* – This is similar to the NONE option. If the self-managed version of the add-on is installed on your cluster Amazon EKS doesn't change the add-on resource properties. Creation of the add-on might fail if conflicts are detected. This option works differently during the update operation. For more information, see
|
|
5573
|
+
:param resolve_conflicts: How to resolve field value conflicts for an Amazon EKS add-on. Conflicts are handled based on the value you choose: - *None* – If the self-managed version of the add-on is installed on your cluster, Amazon EKS doesn't change the value. Creation of the add-on might fail. - *Overwrite* – If the self-managed version of the add-on is installed on your cluster and the Amazon EKS default value is different than the existing value, Amazon EKS changes the value to the Amazon EKS default value. - *Preserve* – This is similar to the NONE option. If the self-managed version of the add-on is installed on your cluster Amazon EKS doesn't change the add-on resource properties. Creation of the add-on might fail if conflicts are detected. This option works differently during the update operation. For more information, see ```UpdateAddon`` <https://docs.aws.amazon.com/eks/latest/APIReference/API_UpdateAddon.html>`_ . If you don't currently have the self-managed version of the add-on installed on your cluster, the Amazon EKS add-on is installed. Amazon EKS sets all values to default values, regardless of the option that you specify.
|
|
5575
5574
|
:param service_account_role_arn: The Amazon Resource Name (ARN) of an existing IAM role to bind to the add-on's service account. The role must be assigned the IAM permissions required by the add-on. If you don't specify an existing IAM role, then the add-on uses the permissions assigned to the node IAM role. For more information, see `Amazon EKS node IAM role <https://docs.aws.amazon.com/eks/latest/userguide/create-node-role.html>`_ in the *Amazon EKS User Guide* . .. epigraph:: To specify an existing IAM role, you must have an IAM OpenID Connect (OIDC) provider created for your cluster. For more information, see `Enabling IAM roles for service accounts on your cluster <https://docs.aws.amazon.com/eks/latest/userguide/enable-iam-roles-for-service-accounts.html>`_ in the *Amazon EKS User Guide* .
|
|
5576
5575
|
:param tags: The metadata that you apply to the add-on to assist with categorization and organization. Each tag consists of a key and an optional value, both of which you define. Add-on tags do not propagate to any other resources associated with the cluster.
|
|
5577
5576
|
|
|
@@ -5708,7 +5707,7 @@ class CfnAddonProps:
|
|
|
5708
5707
|
|
|
5709
5708
|
- *None* – If the self-managed version of the add-on is installed on your cluster, Amazon EKS doesn't change the value. Creation of the add-on might fail.
|
|
5710
5709
|
- *Overwrite* – If the self-managed version of the add-on is installed on your cluster and the Amazon EKS default value is different than the existing value, Amazon EKS changes the value to the Amazon EKS default value.
|
|
5711
|
-
- *Preserve* – This is similar to the NONE option. If the self-managed version of the add-on is installed on your cluster Amazon EKS doesn't change the add-on resource properties. Creation of the add-on might fail if conflicts are detected. This option works differently during the update operation. For more information, see
|
|
5710
|
+
- *Preserve* – This is similar to the NONE option. If the self-managed version of the add-on is installed on your cluster Amazon EKS doesn't change the add-on resource properties. Creation of the add-on might fail if conflicts are detected. This option works differently during the update operation. For more information, see ```UpdateAddon`` <https://docs.aws.amazon.com/eks/latest/APIReference/API_UpdateAddon.html>`_ .
|
|
5712
5711
|
|
|
5713
5712
|
If you don't currently have the self-managed version of the add-on installed on your cluster, the Amazon EKS add-on is installed. Amazon EKS sets all values to default values, regardless of the option that you specify.
|
|
5714
5713
|
|
|
@@ -9438,7 +9437,7 @@ class CfnNodegroup(
|
|
|
9438
9437
|
disk_size: typing.Optional[jsii.Number] = None,
|
|
9439
9438
|
force_update_enabled: typing.Optional[typing.Union[builtins.bool, _IResolvable_da3f097b]] = None,
|
|
9440
9439
|
instance_types: typing.Optional[typing.Sequence[builtins.str]] = None,
|
|
9441
|
-
labels: typing.Optional[typing.Union[
|
|
9440
|
+
labels: typing.Optional[typing.Union[typing.Mapping[builtins.str, builtins.str], _IResolvable_da3f097b]] = None,
|
|
9442
9441
|
launch_template: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union["CfnNodegroup.LaunchTemplateSpecificationProperty", typing.Dict[builtins.str, typing.Any]]]] = None,
|
|
9443
9442
|
nodegroup_name: typing.Optional[builtins.str] = None,
|
|
9444
9443
|
node_repair_config: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union["CfnNodegroup.NodeRepairConfigProperty", typing.Dict[builtins.str, typing.Any]]]] = None,
|
|
@@ -9690,14 +9689,14 @@ class CfnNodegroup(
|
|
|
9690
9689
|
@jsii.member(jsii_name="labels")
|
|
9691
9690
|
def labels(
|
|
9692
9691
|
self,
|
|
9693
|
-
) -> typing.Optional[typing.Union[
|
|
9692
|
+
) -> typing.Optional[typing.Union[typing.Mapping[builtins.str, builtins.str], _IResolvable_da3f097b]]:
|
|
9694
9693
|
'''The Kubernetes ``labels`` applied to the nodes in the node group.'''
|
|
9695
|
-
return typing.cast(typing.Optional[typing.Union[
|
|
9694
|
+
return typing.cast(typing.Optional[typing.Union[typing.Mapping[builtins.str, builtins.str], _IResolvable_da3f097b]], jsii.get(self, "labels"))
|
|
9696
9695
|
|
|
9697
9696
|
@labels.setter
|
|
9698
9697
|
def labels(
|
|
9699
9698
|
self,
|
|
9700
|
-
value: typing.Optional[typing.Union[
|
|
9699
|
+
value: typing.Optional[typing.Union[typing.Mapping[builtins.str, builtins.str], _IResolvable_da3f097b]],
|
|
9701
9700
|
) -> None:
|
|
9702
9701
|
if __debug__:
|
|
9703
9702
|
type_hints = typing.get_type_hints(_typecheckingstub__bfdcdc90e2da680bcf24a101a162039fcfa5c8ddbf5eae9a97a45451dc10a0e1)
|
|
@@ -10422,7 +10421,7 @@ class CfnNodegroupProps:
|
|
|
10422
10421
|
disk_size: typing.Optional[jsii.Number] = None,
|
|
10423
10422
|
force_update_enabled: typing.Optional[typing.Union[builtins.bool, _IResolvable_da3f097b]] = None,
|
|
10424
10423
|
instance_types: typing.Optional[typing.Sequence[builtins.str]] = None,
|
|
10425
|
-
labels: typing.Optional[typing.Union[
|
|
10424
|
+
labels: typing.Optional[typing.Union[typing.Mapping[builtins.str, builtins.str], _IResolvable_da3f097b]] = None,
|
|
10426
10425
|
launch_template: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union[CfnNodegroup.LaunchTemplateSpecificationProperty, typing.Dict[builtins.str, typing.Any]]]] = None,
|
|
10427
10426
|
nodegroup_name: typing.Optional[builtins.str] = None,
|
|
10428
10427
|
node_repair_config: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union[CfnNodegroup.NodeRepairConfigProperty, typing.Dict[builtins.str, typing.Any]]]] = None,
|
|
@@ -10669,7 +10668,7 @@ class CfnNodegroupProps:
|
|
|
10669
10668
|
@builtins.property
|
|
10670
10669
|
def labels(
|
|
10671
10670
|
self,
|
|
10672
|
-
) -> typing.Optional[typing.Union[
|
|
10671
|
+
) -> typing.Optional[typing.Union[typing.Mapping[builtins.str, builtins.str], _IResolvable_da3f097b]]:
|
|
10673
10672
|
'''The Kubernetes ``labels`` applied to the nodes in the node group.
|
|
10674
10673
|
|
|
10675
10674
|
.. epigraph::
|
|
@@ -10679,7 +10678,7 @@ class CfnNodegroupProps:
|
|
|
10679
10678
|
:see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-eks-nodegroup.html#cfn-eks-nodegroup-labels
|
|
10680
10679
|
'''
|
|
10681
10680
|
result = self._values.get("labels")
|
|
10682
|
-
return typing.cast(typing.Optional[typing.Union[
|
|
10681
|
+
return typing.cast(typing.Optional[typing.Union[typing.Mapping[builtins.str, builtins.str], _IResolvable_da3f097b]], result)
|
|
10683
10682
|
|
|
10684
10683
|
@builtins.property
|
|
10685
10684
|
def launch_template(
|
|
@@ -14223,7 +14222,7 @@ class KubectlProvider(
|
|
|
14223
14222
|
Example::
|
|
14224
14223
|
|
|
14225
14224
|
handler_role = iam.Role.from_role_arn(self, "HandlerRole", "arn:aws:iam::123456789012:role/lambda-role")
|
|
14226
|
-
# get the
|
|
14225
|
+
# get the serviceToken from the custom resource provider
|
|
14227
14226
|
function_arn = lambda_.Function.from_function_name(self, "ProviderOnEventFunc", "ProviderframeworkonEvent-XXX").function_arn
|
|
14228
14227
|
kubectl_provider = eks.KubectlProvider.from_kubectl_provider_attributes(self, "KubectlProvider",
|
|
14229
14228
|
function_arn=function_arn,
|
|
@@ -14353,7 +14352,7 @@ class KubectlProviderAttributes:
|
|
|
14353
14352
|
Example::
|
|
14354
14353
|
|
|
14355
14354
|
handler_role = iam.Role.from_role_arn(self, "HandlerRole", "arn:aws:iam::123456789012:role/lambda-role")
|
|
14356
|
-
# get the
|
|
14355
|
+
# get the serviceToken from the custom resource provider
|
|
14357
14356
|
function_arn = lambda_.Function.from_function_name(self, "ProviderOnEventFunc", "ProviderframeworkonEvent-XXX").function_arn
|
|
14358
14357
|
kubectl_provider = eks.KubectlProvider.from_kubectl_provider_attributes(self, "KubectlProvider",
|
|
14359
14358
|
function_arn=function_arn,
|
|
@@ -14542,7 +14541,7 @@ class KubernetesManifest(
|
|
|
14542
14541
|
@jsii.python.classproperty
|
|
14543
14542
|
@jsii.member(jsii_name="RESOURCE_TYPE")
|
|
14544
14543
|
def RESOURCE_TYPE(cls) -> builtins.str:
|
|
14545
|
-
'''The CloudFormation
|
|
14544
|
+
'''The CloudFormation resource type.'''
|
|
14546
14545
|
return typing.cast(builtins.str, jsii.sget(cls, "RESOURCE_TYPE"))
|
|
14547
14546
|
|
|
14548
14547
|
|
|
@@ -14971,7 +14970,7 @@ class KubernetesObjectValue(
|
|
|
14971
14970
|
@jsii.python.classproperty
|
|
14972
14971
|
@jsii.member(jsii_name="RESOURCE_TYPE")
|
|
14973
14972
|
def RESOURCE_TYPE(cls) -> builtins.str:
|
|
14974
|
-
'''The CloudFormation
|
|
14973
|
+
'''The CloudFormation resource type.'''
|
|
14975
14974
|
return typing.cast(builtins.str, jsii.sget(cls, "RESOURCE_TYPE"))
|
|
14976
14975
|
|
|
14977
14976
|
@builtins.property
|
|
@@ -17893,7 +17892,7 @@ class Addon(
|
|
|
17893
17892
|
:param id: The construct ID.
|
|
17894
17893
|
:param addon_name: Name of the Add-On.
|
|
17895
17894
|
:param cluster: The EKS cluster the Add-On is associated with.
|
|
17896
|
-
:param addon_version: Version of the Add-On. You can check all available versions with describe-addon-
|
|
17895
|
+
:param addon_version: Version of the Add-On. You can check all available versions with describe-addon-versions. For example, this lists all available versions for the ``eks-pod-identity-agent`` addon: $ aws eks describe-addon-versions --addon-name eks-pod-identity-agent --query 'addons[*].addonVersions[*].addonVersion' Default: the latest version.
|
|
17897
17896
|
:param preserve_on_delete: Specifying this option preserves the add-on software on your cluster but Amazon EKS stops managing any settings for the add-on. If an IAM account is associated with the add-on, it isn't removed. Default: true
|
|
17898
17897
|
'''
|
|
17899
17898
|
if __debug__:
|
|
@@ -21984,7 +21983,7 @@ def _typecheckingstub__27ebd660a66f96284eec036f7614b1586f77d9990c9dd345fe73522c7
|
|
|
21984
21983
|
disk_size: typing.Optional[jsii.Number] = None,
|
|
21985
21984
|
force_update_enabled: typing.Optional[typing.Union[builtins.bool, _IResolvable_da3f097b]] = None,
|
|
21986
21985
|
instance_types: typing.Optional[typing.Sequence[builtins.str]] = None,
|
|
21987
|
-
labels: typing.Optional[typing.Union[
|
|
21986
|
+
labels: typing.Optional[typing.Union[typing.Mapping[builtins.str, builtins.str], _IResolvable_da3f097b]] = None,
|
|
21988
21987
|
launch_template: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union[CfnNodegroup.LaunchTemplateSpecificationProperty, typing.Dict[builtins.str, typing.Any]]]] = None,
|
|
21989
21988
|
nodegroup_name: typing.Optional[builtins.str] = None,
|
|
21990
21989
|
node_repair_config: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union[CfnNodegroup.NodeRepairConfigProperty, typing.Dict[builtins.str, typing.Any]]]] = None,
|
|
@@ -22060,7 +22059,7 @@ def _typecheckingstub__d7945a05c2376d70b30fc28a96959abf6f7e23d90fd6e700764137f4b
|
|
|
22060
22059
|
pass
|
|
22061
22060
|
|
|
22062
22061
|
def _typecheckingstub__bfdcdc90e2da680bcf24a101a162039fcfa5c8ddbf5eae9a97a45451dc10a0e1(
|
|
22063
|
-
value: typing.Optional[typing.Union[
|
|
22062
|
+
value: typing.Optional[typing.Union[typing.Mapping[builtins.str, builtins.str], _IResolvable_da3f097b]],
|
|
22064
22063
|
) -> None:
|
|
22065
22064
|
"""Type checking stubs"""
|
|
22066
22065
|
pass
|
|
@@ -22186,7 +22185,7 @@ def _typecheckingstub__61a7b4277678abead400083fb1974a4f71ee28a78b5e79235fc3a4581
|
|
|
22186
22185
|
disk_size: typing.Optional[jsii.Number] = None,
|
|
22187
22186
|
force_update_enabled: typing.Optional[typing.Union[builtins.bool, _IResolvable_da3f097b]] = None,
|
|
22188
22187
|
instance_types: typing.Optional[typing.Sequence[builtins.str]] = None,
|
|
22189
|
-
labels: typing.Optional[typing.Union[
|
|
22188
|
+
labels: typing.Optional[typing.Union[typing.Mapping[builtins.str, builtins.str], _IResolvable_da3f097b]] = None,
|
|
22190
22189
|
launch_template: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union[CfnNodegroup.LaunchTemplateSpecificationProperty, typing.Dict[builtins.str, typing.Any]]]] = None,
|
|
22191
22190
|
nodegroup_name: typing.Optional[builtins.str] = None,
|
|
22192
22191
|
node_repair_config: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union[CfnNodegroup.NodeRepairConfigProperty, typing.Dict[builtins.str, typing.Any]]]] = None,
|
|
@@ -2445,7 +2445,7 @@ class CfnParameterGroup(
|
|
|
2445
2445
|
*,
|
|
2446
2446
|
cache_parameter_group_family: builtins.str,
|
|
2447
2447
|
description: builtins.str,
|
|
2448
|
-
properties: typing.Optional[typing.Union[
|
|
2448
|
+
properties: typing.Optional[typing.Union[typing.Mapping[builtins.str, builtins.str], _IResolvable_da3f097b]] = None,
|
|
2449
2449
|
tags: typing.Optional[typing.Sequence[typing.Union[_CfnTag_f6864754, typing.Dict[builtins.str, typing.Any]]]] = None,
|
|
2450
2450
|
) -> None:
|
|
2451
2451
|
'''
|
|
@@ -2549,14 +2549,14 @@ class CfnParameterGroup(
|
|
|
2549
2549
|
@jsii.member(jsii_name="properties")
|
|
2550
2550
|
def properties(
|
|
2551
2551
|
self,
|
|
2552
|
-
) -> typing.Optional[typing.Union[
|
|
2552
|
+
) -> typing.Optional[typing.Union[typing.Mapping[builtins.str, builtins.str], _IResolvable_da3f097b]]:
|
|
2553
2553
|
'''A comma-delimited list of parameter name/value pairs.'''
|
|
2554
|
-
return typing.cast(typing.Optional[typing.Union[
|
|
2554
|
+
return typing.cast(typing.Optional[typing.Union[typing.Mapping[builtins.str, builtins.str], _IResolvable_da3f097b]], jsii.get(self, "properties"))
|
|
2555
2555
|
|
|
2556
2556
|
@properties.setter
|
|
2557
2557
|
def properties(
|
|
2558
2558
|
self,
|
|
2559
|
-
value: typing.Optional[typing.Union[
|
|
2559
|
+
value: typing.Optional[typing.Union[typing.Mapping[builtins.str, builtins.str], _IResolvable_da3f097b]],
|
|
2560
2560
|
) -> None:
|
|
2561
2561
|
if __debug__:
|
|
2562
2562
|
type_hints = typing.get_type_hints(_typecheckingstub__ad995d05e00fe4d7296f16776a975d33eb5d75180391440607e5d71ae30d1f08)
|
|
@@ -2593,7 +2593,7 @@ class CfnParameterGroupProps:
|
|
|
2593
2593
|
*,
|
|
2594
2594
|
cache_parameter_group_family: builtins.str,
|
|
2595
2595
|
description: builtins.str,
|
|
2596
|
-
properties: typing.Optional[typing.Union[
|
|
2596
|
+
properties: typing.Optional[typing.Union[typing.Mapping[builtins.str, builtins.str], _IResolvable_da3f097b]] = None,
|
|
2597
2597
|
tags: typing.Optional[typing.Sequence[typing.Union[_CfnTag_f6864754, typing.Dict[builtins.str, typing.Any]]]] = None,
|
|
2598
2598
|
) -> None:
|
|
2599
2599
|
'''Properties for defining a ``CfnParameterGroup``.
|
|
@@ -2666,7 +2666,7 @@ class CfnParameterGroupProps:
|
|
|
2666
2666
|
@builtins.property
|
|
2667
2667
|
def properties(
|
|
2668
2668
|
self,
|
|
2669
|
-
) -> typing.Optional[typing.Union[
|
|
2669
|
+
) -> typing.Optional[typing.Union[typing.Mapping[builtins.str, builtins.str], _IResolvable_da3f097b]]:
|
|
2670
2670
|
'''A comma-delimited list of parameter name/value pairs.
|
|
2671
2671
|
|
|
2672
2672
|
For example::
|
|
@@ -2677,7 +2677,7 @@ class CfnParameterGroupProps:
|
|
|
2677
2677
|
:see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-elasticache-parametergroup.html#cfn-elasticache-parametergroup-properties
|
|
2678
2678
|
'''
|
|
2679
2679
|
result = self._values.get("properties")
|
|
2680
|
-
return typing.cast(typing.Optional[typing.Union[
|
|
2680
|
+
return typing.cast(typing.Optional[typing.Union[typing.Mapping[builtins.str, builtins.str], _IResolvable_da3f097b]], result)
|
|
2681
2681
|
|
|
2682
2682
|
@builtins.property
|
|
2683
2683
|
def tags(self) -> typing.Optional[typing.List[_CfnTag_f6864754]]:
|
|
@@ -8071,7 +8071,7 @@ def _typecheckingstub__86f3b322f4ea3d0cc63e18e1b285cc656e6d789289e29668aa7acce95
|
|
|
8071
8071
|
*,
|
|
8072
8072
|
cache_parameter_group_family: builtins.str,
|
|
8073
8073
|
description: builtins.str,
|
|
8074
|
-
properties: typing.Optional[typing.Union[
|
|
8074
|
+
properties: typing.Optional[typing.Union[typing.Mapping[builtins.str, builtins.str], _IResolvable_da3f097b]] = None,
|
|
8075
8075
|
tags: typing.Optional[typing.Sequence[typing.Union[_CfnTag_f6864754, typing.Dict[builtins.str, typing.Any]]]] = None,
|
|
8076
8076
|
) -> None:
|
|
8077
8077
|
"""Type checking stubs"""
|
|
@@ -8102,7 +8102,7 @@ def _typecheckingstub__131595ea286a946147c38535eb5fcf0537b68b2132e909e191998a1e3
|
|
|
8102
8102
|
pass
|
|
8103
8103
|
|
|
8104
8104
|
def _typecheckingstub__ad995d05e00fe4d7296f16776a975d33eb5d75180391440607e5d71ae30d1f08(
|
|
8105
|
-
value: typing.Optional[typing.Union[
|
|
8105
|
+
value: typing.Optional[typing.Union[typing.Mapping[builtins.str, builtins.str], _IResolvable_da3f097b]],
|
|
8106
8106
|
) -> None:
|
|
8107
8107
|
"""Type checking stubs"""
|
|
8108
8108
|
pass
|
|
@@ -8117,7 +8117,7 @@ def _typecheckingstub__56da2ad187e00defe2d3a6812e7eea3611b1990da4526952f58e2f80c
|
|
|
8117
8117
|
*,
|
|
8118
8118
|
cache_parameter_group_family: builtins.str,
|
|
8119
8119
|
description: builtins.str,
|
|
8120
|
-
properties: typing.Optional[typing.Union[
|
|
8120
|
+
properties: typing.Optional[typing.Union[typing.Mapping[builtins.str, builtins.str], _IResolvable_da3f097b]] = None,
|
|
8121
8121
|
tags: typing.Optional[typing.Sequence[typing.Union[_CfnTag_f6864754, typing.Dict[builtins.str, typing.Any]]]] = None,
|
|
8122
8122
|
) -> None:
|
|
8123
8123
|
"""Type checking stubs"""
|