2026/06/02 - AWS Lambda - 5 updated api methods
Changes Adds configuration for tag propagation to Lambda-managed resources.
{'PropagateTags': {'ExplicitTags': {'string': 'string'},
'Mode': 'None | Explicit'}}
Response {'CapacityProvider': {'PropagateTags': {'ExplicitTags': {'string': 'string'},
'Mode': 'None | Explicit'}}}
Creates a capacity provider that manages compute resources for Lambda functions
See also: AWS API Documentation
Request Syntax
client.create_capacity_provider(
CapacityProviderName='string',
VpcConfig={
'SubnetIds': [
'string',
],
'SecurityGroupIds': [
'string',
]
},
PermissionsConfig={
'CapacityProviderOperatorRoleArn': 'string'
},
InstanceRequirements={
'Architectures': [
'x86_64'|'arm64',
],
'AllowedInstanceTypes': [
'string',
],
'ExcludedInstanceTypes': [
'string',
]
},
CapacityProviderScalingConfig={
'MaxVCpuCount': 123,
'ScalingMode': 'Auto'|'Manual',
'ScalingPolicies': [
{
'PredefinedMetricType': 'LambdaCapacityProviderAverageCPUUtilization',
'TargetValue': 123.0
},
]
},
KmsKeyArn='string',
Tags={
'string': 'string'
},
PropagateTags={
'Mode': 'None'|'Explicit',
'ExplicitTags': {
'string': 'string'
}
}
)
string
[REQUIRED]
The name of the capacity provider.
dict
[REQUIRED]
The VPC configuration for the capacity provider, including subnet IDs and security group IDs where compute instances will be launched.
SubnetIds (list) -- [REQUIRED]
A list of subnet IDs where the capacity provider launches compute instances.
(string) --
SecurityGroupIds (list) -- [REQUIRED]
A list of security group IDs that control network access for compute instances managed by the capacity provider.
(string) --
dict
[REQUIRED]
The permissions configuration that specifies the IAM role ARN used by the capacity provider to manage compute resources.
CapacityProviderOperatorRoleArn (string) -- [REQUIRED]
The ARN of the IAM role that the capacity provider uses to manage compute instances and other Amazon Web Services resources.
dict
The instance requirements that specify the compute instance characteristics, including architectures and allowed or excluded instance types.
Architectures (list) --
A list of supported CPU architectures for compute instances. Valid values include x86_64 and arm64.
(string) --
AllowedInstanceTypes (list) --
A list of EC2 instance types that the capacity provider is allowed to use. If not specified, all compatible instance types are allowed.
(string) --
ExcludedInstanceTypes (list) --
A list of EC2 instance types that the capacity provider should not use, even if they meet other requirements.
(string) --
dict
The scaling configuration that defines how the capacity provider scales compute instances, including maximum vCPU count and scaling policies.
MaxVCpuCount (integer) --
The maximum number of vCPUs that the capacity provider can provision across all compute instances.
ScalingMode (string) --
The scaling mode that determines how the capacity provider responds to changes in demand.
ScalingPolicies (list) --
A list of scaling policies that define how the capacity provider scales compute instances based on metrics and thresholds.
(dict) --
A scaling policy for the capacity provider that automatically adjusts capacity to maintain a target value for a specific metric.
PredefinedMetricType (string) -- [REQUIRED]
The predefined metric type to track for scaling decisions.
TargetValue (float) -- [REQUIRED]
The target value for the metric that the scaling policy attempts to maintain through scaling actions.
string
The ARN of the KMS key used to encrypt data associated with the capacity provider.
dict
A list of tags to associate with the capacity provider.
(string) --
(string) --
dict
The tag propagation configuration for the capacity provider. Specifies tags to apply to managed resources at launch.
Mode (string) --
The tag propagation mode. Set to Explicit to propagate the tags specified in ExplicitTags to managed resources. Set to None to disable tag propagation.
ExplicitTags (dict) --
A list of tags to apply to managed resources when Mode is set to Explicit. You can specify up to 40 tags.
(string) --
(string) --
dict
Response Syntax
{
'CapacityProvider': {
'CapacityProviderArn': 'string',
'State': 'Pending'|'Active'|'Failed'|'Deleting',
'VpcConfig': {
'SubnetIds': [
'string',
],
'SecurityGroupIds': [
'string',
]
},
'PermissionsConfig': {
'CapacityProviderOperatorRoleArn': 'string'
},
'InstanceRequirements': {
'Architectures': [
'x86_64'|'arm64',
],
'AllowedInstanceTypes': [
'string',
],
'ExcludedInstanceTypes': [
'string',
]
},
'CapacityProviderScalingConfig': {
'MaxVCpuCount': 123,
'ScalingMode': 'Auto'|'Manual',
'ScalingPolicies': [
{
'PredefinedMetricType': 'LambdaCapacityProviderAverageCPUUtilization',
'TargetValue': 123.0
},
]
},
'KmsKeyArn': 'string',
'LastModified': 'string',
'PropagateTags': {
'Mode': 'None'|'Explicit',
'ExplicitTags': {
'string': 'string'
}
}
}
}
Response Structure
(dict) --
CapacityProvider (dict) --
Information about the capacity provider that was created.
CapacityProviderArn (string) --
The Amazon Resource Name (ARN) of the capacity provider.
State (string) --
The current state of the capacity provider.
VpcConfig (dict) --
The VPC configuration for the capacity provider.
SubnetIds (list) --
A list of subnet IDs where the capacity provider launches compute instances.
(string) --
SecurityGroupIds (list) --
A list of security group IDs that control network access for compute instances managed by the capacity provider.
(string) --
PermissionsConfig (dict) --
The permissions configuration for the capacity provider.
CapacityProviderOperatorRoleArn (string) --
The ARN of the IAM role that the capacity provider uses to manage compute instances and other Amazon Web Services resources.
InstanceRequirements (dict) --
The instance requirements for compute resources managed by the capacity provider.
Architectures (list) --
A list of supported CPU architectures for compute instances. Valid values include x86_64 and arm64.
(string) --
AllowedInstanceTypes (list) --
A list of EC2 instance types that the capacity provider is allowed to use. If not specified, all compatible instance types are allowed.
(string) --
ExcludedInstanceTypes (list) --
A list of EC2 instance types that the capacity provider should not use, even if they meet other requirements.
(string) --
CapacityProviderScalingConfig (dict) --
The scaling configuration for the capacity provider.
MaxVCpuCount (integer) --
The maximum number of vCPUs that the capacity provider can provision across all compute instances.
ScalingMode (string) --
The scaling mode that determines how the capacity provider responds to changes in demand.
ScalingPolicies (list) --
A list of scaling policies that define how the capacity provider scales compute instances based on metrics and thresholds.
(dict) --
A scaling policy for the capacity provider that automatically adjusts capacity to maintain a target value for a specific metric.
PredefinedMetricType (string) --
The predefined metric type to track for scaling decisions.
TargetValue (float) --
The target value for the metric that the scaling policy attempts to maintain through scaling actions.
KmsKeyArn (string) --
The ARN of the KMS key used to encrypt the capacity provider's resources.
LastModified (string) --
The date and time when the capacity provider was last modified.
PropagateTags (dict) --
Configuration for tag propagation to managed resources launched by the capacity provider.
Mode (string) --
The tag propagation mode. Set to Explicit to propagate the tags specified in ExplicitTags to managed resources. Set to None to disable tag propagation.
ExplicitTags (dict) --
A list of tags to apply to managed resources when Mode is set to Explicit. You can specify up to 40 tags.
(string) --
(string) --
{'CapacityProvider': {'PropagateTags': {'ExplicitTags': {'string': 'string'},
'Mode': 'None | Explicit'}}}
Deletes a capacity provider. You cannot delete a capacity provider that is currently being used by Lambda functions.
See also: AWS API Documentation
Request Syntax
client.delete_capacity_provider(
CapacityProviderName='string'
)
string
[REQUIRED]
The name of the capacity provider to delete.
dict
Response Syntax
{
'CapacityProvider': {
'CapacityProviderArn': 'string',
'State': 'Pending'|'Active'|'Failed'|'Deleting',
'VpcConfig': {
'SubnetIds': [
'string',
],
'SecurityGroupIds': [
'string',
]
},
'PermissionsConfig': {
'CapacityProviderOperatorRoleArn': 'string'
},
'InstanceRequirements': {
'Architectures': [
'x86_64'|'arm64',
],
'AllowedInstanceTypes': [
'string',
],
'ExcludedInstanceTypes': [
'string',
]
},
'CapacityProviderScalingConfig': {
'MaxVCpuCount': 123,
'ScalingMode': 'Auto'|'Manual',
'ScalingPolicies': [
{
'PredefinedMetricType': 'LambdaCapacityProviderAverageCPUUtilization',
'TargetValue': 123.0
},
]
},
'KmsKeyArn': 'string',
'LastModified': 'string',
'PropagateTags': {
'Mode': 'None'|'Explicit',
'ExplicitTags': {
'string': 'string'
}
}
}
}
Response Structure
(dict) --
CapacityProvider (dict) --
Information about the deleted capacity provider.
CapacityProviderArn (string) --
The Amazon Resource Name (ARN) of the capacity provider.
State (string) --
The current state of the capacity provider.
VpcConfig (dict) --
The VPC configuration for the capacity provider.
SubnetIds (list) --
A list of subnet IDs where the capacity provider launches compute instances.
(string) --
SecurityGroupIds (list) --
A list of security group IDs that control network access for compute instances managed by the capacity provider.
(string) --
PermissionsConfig (dict) --
The permissions configuration for the capacity provider.
CapacityProviderOperatorRoleArn (string) --
The ARN of the IAM role that the capacity provider uses to manage compute instances and other Amazon Web Services resources.
InstanceRequirements (dict) --
The instance requirements for compute resources managed by the capacity provider.
Architectures (list) --
A list of supported CPU architectures for compute instances. Valid values include x86_64 and arm64.
(string) --
AllowedInstanceTypes (list) --
A list of EC2 instance types that the capacity provider is allowed to use. If not specified, all compatible instance types are allowed.
(string) --
ExcludedInstanceTypes (list) --
A list of EC2 instance types that the capacity provider should not use, even if they meet other requirements.
(string) --
CapacityProviderScalingConfig (dict) --
The scaling configuration for the capacity provider.
MaxVCpuCount (integer) --
The maximum number of vCPUs that the capacity provider can provision across all compute instances.
ScalingMode (string) --
The scaling mode that determines how the capacity provider responds to changes in demand.
ScalingPolicies (list) --
A list of scaling policies that define how the capacity provider scales compute instances based on metrics and thresholds.
(dict) --
A scaling policy for the capacity provider that automatically adjusts capacity to maintain a target value for a specific metric.
PredefinedMetricType (string) --
The predefined metric type to track for scaling decisions.
TargetValue (float) --
The target value for the metric that the scaling policy attempts to maintain through scaling actions.
KmsKeyArn (string) --
The ARN of the KMS key used to encrypt the capacity provider's resources.
LastModified (string) --
The date and time when the capacity provider was last modified.
PropagateTags (dict) --
Configuration for tag propagation to managed resources launched by the capacity provider.
Mode (string) --
The tag propagation mode. Set to Explicit to propagate the tags specified in ExplicitTags to managed resources. Set to None to disable tag propagation.
ExplicitTags (dict) --
A list of tags to apply to managed resources when Mode is set to Explicit. You can specify up to 40 tags.
(string) --
(string) --
{'CapacityProvider': {'PropagateTags': {'ExplicitTags': {'string': 'string'},
'Mode': 'None | Explicit'}}}
Retrieves information about a specific capacity provider, including its configuration, state, and associated resources.
See also: AWS API Documentation
Request Syntax
client.get_capacity_provider(
CapacityProviderName='string'
)
string
[REQUIRED]
The name of the capacity provider to retrieve.
dict
Response Syntax
{
'CapacityProvider': {
'CapacityProviderArn': 'string',
'State': 'Pending'|'Active'|'Failed'|'Deleting',
'VpcConfig': {
'SubnetIds': [
'string',
],
'SecurityGroupIds': [
'string',
]
},
'PermissionsConfig': {
'CapacityProviderOperatorRoleArn': 'string'
},
'InstanceRequirements': {
'Architectures': [
'x86_64'|'arm64',
],
'AllowedInstanceTypes': [
'string',
],
'ExcludedInstanceTypes': [
'string',
]
},
'CapacityProviderScalingConfig': {
'MaxVCpuCount': 123,
'ScalingMode': 'Auto'|'Manual',
'ScalingPolicies': [
{
'PredefinedMetricType': 'LambdaCapacityProviderAverageCPUUtilization',
'TargetValue': 123.0
},
]
},
'KmsKeyArn': 'string',
'LastModified': 'string',
'PropagateTags': {
'Mode': 'None'|'Explicit',
'ExplicitTags': {
'string': 'string'
}
}
}
}
Response Structure
(dict) --
CapacityProvider (dict) --
Information about the capacity provider, including its configuration and current state.
CapacityProviderArn (string) --
The Amazon Resource Name (ARN) of the capacity provider.
State (string) --
The current state of the capacity provider.
VpcConfig (dict) --
The VPC configuration for the capacity provider.
SubnetIds (list) --
A list of subnet IDs where the capacity provider launches compute instances.
(string) --
SecurityGroupIds (list) --
A list of security group IDs that control network access for compute instances managed by the capacity provider.
(string) --
PermissionsConfig (dict) --
The permissions configuration for the capacity provider.
CapacityProviderOperatorRoleArn (string) --
The ARN of the IAM role that the capacity provider uses to manage compute instances and other Amazon Web Services resources.
InstanceRequirements (dict) --
The instance requirements for compute resources managed by the capacity provider.
Architectures (list) --
A list of supported CPU architectures for compute instances. Valid values include x86_64 and arm64.
(string) --
AllowedInstanceTypes (list) --
A list of EC2 instance types that the capacity provider is allowed to use. If not specified, all compatible instance types are allowed.
(string) --
ExcludedInstanceTypes (list) --
A list of EC2 instance types that the capacity provider should not use, even if they meet other requirements.
(string) --
CapacityProviderScalingConfig (dict) --
The scaling configuration for the capacity provider.
MaxVCpuCount (integer) --
The maximum number of vCPUs that the capacity provider can provision across all compute instances.
ScalingMode (string) --
The scaling mode that determines how the capacity provider responds to changes in demand.
ScalingPolicies (list) --
A list of scaling policies that define how the capacity provider scales compute instances based on metrics and thresholds.
(dict) --
A scaling policy for the capacity provider that automatically adjusts capacity to maintain a target value for a specific metric.
PredefinedMetricType (string) --
The predefined metric type to track for scaling decisions.
TargetValue (float) --
The target value for the metric that the scaling policy attempts to maintain through scaling actions.
KmsKeyArn (string) --
The ARN of the KMS key used to encrypt the capacity provider's resources.
LastModified (string) --
The date and time when the capacity provider was last modified.
PropagateTags (dict) --
Configuration for tag propagation to managed resources launched by the capacity provider.
Mode (string) --
The tag propagation mode. Set to Explicit to propagate the tags specified in ExplicitTags to managed resources. Set to None to disable tag propagation.
ExplicitTags (dict) --
A list of tags to apply to managed resources when Mode is set to Explicit. You can specify up to 40 tags.
(string) --
(string) --
{'CapacityProviders': {'PropagateTags': {'ExplicitTags': {'string': 'string'},
'Mode': 'None | Explicit'}}}
Returns a list of capacity providers in your account.
See also: AWS API Documentation
Request Syntax
client.list_capacity_providers(
State='Pending'|'Active'|'Failed'|'Deleting',
Marker='string',
MaxItems=123
)
string
Filter capacity providers by their current state.
string
Specify the pagination token that's returned by a previous request to retrieve the next page of results.
integer
The maximum number of capacity providers to return.
dict
Response Syntax
{
'CapacityProviders': [
{
'CapacityProviderArn': 'string',
'State': 'Pending'|'Active'|'Failed'|'Deleting',
'VpcConfig': {
'SubnetIds': [
'string',
],
'SecurityGroupIds': [
'string',
]
},
'PermissionsConfig': {
'CapacityProviderOperatorRoleArn': 'string'
},
'InstanceRequirements': {
'Architectures': [
'x86_64'|'arm64',
],
'AllowedInstanceTypes': [
'string',
],
'ExcludedInstanceTypes': [
'string',
]
},
'CapacityProviderScalingConfig': {
'MaxVCpuCount': 123,
'ScalingMode': 'Auto'|'Manual',
'ScalingPolicies': [
{
'PredefinedMetricType': 'LambdaCapacityProviderAverageCPUUtilization',
'TargetValue': 123.0
},
]
},
'KmsKeyArn': 'string',
'LastModified': 'string',
'PropagateTags': {
'Mode': 'None'|'Explicit',
'ExplicitTags': {
'string': 'string'
}
}
},
],
'NextMarker': 'string'
}
Response Structure
(dict) --
CapacityProviders (list) --
A list of capacity providers in your account.
(dict) --
A capacity provider manages compute resources for Lambda functions.
CapacityProviderArn (string) --
The Amazon Resource Name (ARN) of the capacity provider.
State (string) --
The current state of the capacity provider.
VpcConfig (dict) --
The VPC configuration for the capacity provider.
SubnetIds (list) --
A list of subnet IDs where the capacity provider launches compute instances.
(string) --
SecurityGroupIds (list) --
A list of security group IDs that control network access for compute instances managed by the capacity provider.
(string) --
PermissionsConfig (dict) --
The permissions configuration for the capacity provider.
CapacityProviderOperatorRoleArn (string) --
The ARN of the IAM role that the capacity provider uses to manage compute instances and other Amazon Web Services resources.
InstanceRequirements (dict) --
The instance requirements for compute resources managed by the capacity provider.
Architectures (list) --
A list of supported CPU architectures for compute instances. Valid values include x86_64 and arm64.
(string) --
AllowedInstanceTypes (list) --
A list of EC2 instance types that the capacity provider is allowed to use. If not specified, all compatible instance types are allowed.
(string) --
ExcludedInstanceTypes (list) --
A list of EC2 instance types that the capacity provider should not use, even if they meet other requirements.
(string) --
CapacityProviderScalingConfig (dict) --
The scaling configuration for the capacity provider.
MaxVCpuCount (integer) --
The maximum number of vCPUs that the capacity provider can provision across all compute instances.
ScalingMode (string) --
The scaling mode that determines how the capacity provider responds to changes in demand.
ScalingPolicies (list) --
A list of scaling policies that define how the capacity provider scales compute instances based on metrics and thresholds.
(dict) --
A scaling policy for the capacity provider that automatically adjusts capacity to maintain a target value for a specific metric.
PredefinedMetricType (string) --
The predefined metric type to track for scaling decisions.
TargetValue (float) --
The target value for the metric that the scaling policy attempts to maintain through scaling actions.
KmsKeyArn (string) --
The ARN of the KMS key used to encrypt the capacity provider's resources.
LastModified (string) --
The date and time when the capacity provider was last modified.
PropagateTags (dict) --
Configuration for tag propagation to managed resources launched by the capacity provider.
Mode (string) --
The tag propagation mode. Set to Explicit to propagate the tags specified in ExplicitTags to managed resources. Set to None to disable tag propagation.
ExplicitTags (dict) --
A list of tags to apply to managed resources when Mode is set to Explicit. You can specify up to 40 tags.
(string) --
(string) --
NextMarker (string) --
The pagination token that's included if more results are available.
{'PropagateTags': {'ExplicitTags': {'string': 'string'},
'Mode': 'None | Explicit'}}
Response {'CapacityProvider': {'PropagateTags': {'ExplicitTags': {'string': 'string'},
'Mode': 'None | Explicit'}}}
Updates the configuration of an existing capacity provider.
See also: AWS API Documentation
Request Syntax
client.update_capacity_provider(
CapacityProviderName='string',
CapacityProviderScalingConfig={
'MaxVCpuCount': 123,
'ScalingMode': 'Auto'|'Manual',
'ScalingPolicies': [
{
'PredefinedMetricType': 'LambdaCapacityProviderAverageCPUUtilization',
'TargetValue': 123.0
},
]
},
PropagateTags={
'Mode': 'None'|'Explicit',
'ExplicitTags': {
'string': 'string'
}
}
)
string
[REQUIRED]
The name of the capacity provider to update.
dict
The updated scaling configuration for the capacity provider.
MaxVCpuCount (integer) --
The maximum number of vCPUs that the capacity provider can provision across all compute instances.
ScalingMode (string) --
The scaling mode that determines how the capacity provider responds to changes in demand.
ScalingPolicies (list) --
A list of scaling policies that define how the capacity provider scales compute instances based on metrics and thresholds.
(dict) --
A scaling policy for the capacity provider that automatically adjusts capacity to maintain a target value for a specific metric.
PredefinedMetricType (string) -- [REQUIRED]
The predefined metric type to track for scaling decisions.
TargetValue (float) -- [REQUIRED]
The target value for the metric that the scaling policy attempts to maintain through scaling actions.
dict
Configuration for tag propagation to managed resources launched by the capacity provider.
Mode (string) --
The tag propagation mode. Set to Explicit to propagate the tags specified in ExplicitTags to managed resources. Set to None to disable tag propagation.
ExplicitTags (dict) --
A list of tags to apply to managed resources when Mode is set to Explicit. You can specify up to 40 tags.
(string) --
(string) --
dict
Response Syntax
{
'CapacityProvider': {
'CapacityProviderArn': 'string',
'State': 'Pending'|'Active'|'Failed'|'Deleting',
'VpcConfig': {
'SubnetIds': [
'string',
],
'SecurityGroupIds': [
'string',
]
},
'PermissionsConfig': {
'CapacityProviderOperatorRoleArn': 'string'
},
'InstanceRequirements': {
'Architectures': [
'x86_64'|'arm64',
],
'AllowedInstanceTypes': [
'string',
],
'ExcludedInstanceTypes': [
'string',
]
},
'CapacityProviderScalingConfig': {
'MaxVCpuCount': 123,
'ScalingMode': 'Auto'|'Manual',
'ScalingPolicies': [
{
'PredefinedMetricType': 'LambdaCapacityProviderAverageCPUUtilization',
'TargetValue': 123.0
},
]
},
'KmsKeyArn': 'string',
'LastModified': 'string',
'PropagateTags': {
'Mode': 'None'|'Explicit',
'ExplicitTags': {
'string': 'string'
}
}
}
}
Response Structure
(dict) --
CapacityProvider (dict) --
Information about the updated capacity provider.
CapacityProviderArn (string) --
The Amazon Resource Name (ARN) of the capacity provider.
State (string) --
The current state of the capacity provider.
VpcConfig (dict) --
The VPC configuration for the capacity provider.
SubnetIds (list) --
A list of subnet IDs where the capacity provider launches compute instances.
(string) --
SecurityGroupIds (list) --
A list of security group IDs that control network access for compute instances managed by the capacity provider.
(string) --
PermissionsConfig (dict) --
The permissions configuration for the capacity provider.
CapacityProviderOperatorRoleArn (string) --
The ARN of the IAM role that the capacity provider uses to manage compute instances and other Amazon Web Services resources.
InstanceRequirements (dict) --
The instance requirements for compute resources managed by the capacity provider.
Architectures (list) --
A list of supported CPU architectures for compute instances. Valid values include x86_64 and arm64.
(string) --
AllowedInstanceTypes (list) --
A list of EC2 instance types that the capacity provider is allowed to use. If not specified, all compatible instance types are allowed.
(string) --
ExcludedInstanceTypes (list) --
A list of EC2 instance types that the capacity provider should not use, even if they meet other requirements.
(string) --
CapacityProviderScalingConfig (dict) --
The scaling configuration for the capacity provider.
MaxVCpuCount (integer) --
The maximum number of vCPUs that the capacity provider can provision across all compute instances.
ScalingMode (string) --
The scaling mode that determines how the capacity provider responds to changes in demand.
ScalingPolicies (list) --
A list of scaling policies that define how the capacity provider scales compute instances based on metrics and thresholds.
(dict) --
A scaling policy for the capacity provider that automatically adjusts capacity to maintain a target value for a specific metric.
PredefinedMetricType (string) --
The predefined metric type to track for scaling decisions.
TargetValue (float) --
The target value for the metric that the scaling policy attempts to maintain through scaling actions.
KmsKeyArn (string) --
The ARN of the KMS key used to encrypt the capacity provider's resources.
LastModified (string) --
The date and time when the capacity provider was last modified.
PropagateTags (dict) --
Configuration for tag propagation to managed resources launched by the capacity provider.
Mode (string) --
The tag propagation mode. Set to Explicit to propagate the tags specified in ExplicitTags to managed resources. Set to None to disable tag propagation.
ExplicitTags (dict) --
A list of tags to apply to managed resources when Mode is set to Explicit. You can specify up to 40 tags.
(string) --
(string) --