1. Packages
  2. AWS Cloud Control
  3. API Docs
  4. lambda
  5. CapacityProvider

We recommend new projects start with resources from the AWS provider.

AWS Cloud Control v1.40.0 published on Thursday, Dec 11, 2025 by Pulumi
Schema (JSON)
pulumi/pulumi-aws-native

aws-native.lambda.CapacityProvider

aws-native logo

We recommend new projects start with resources from the AWS provider.

AWS Cloud Control v1.40.0 published on Thursday, Dec 11, 2025 by Pulumi
Schema (JSON)
pulumi/pulumi-aws-native

    Resource Type definition for AWS::Lambda::CapacityProvider

    Create CapacityProvider Resource

    Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.

    Constructor syntax

    new CapacityProvider(name: string, args: CapacityProviderArgs, opts?: CustomResourceOptions);
    @overload
def CapacityProvider(resource_name: str,
                     args: CapacityProviderArgs,
                     opts: Optional[ResourceOptions] = None)

@overload
def CapacityProvider(resource_name: str,
                     opts: Optional[ResourceOptions] = None,
                     permissions_config: Optional[CapacityProviderPermissionsConfigArgs] = None,
                     vpc_config: Optional[CapacityProviderVpcConfigArgs] = None,
                     capacity_provider_name: Optional[str] = None,
                     capacity_provider_scaling_config: Optional[CapacityProviderScalingConfigArgs] = None,
                     instance_requirements: Optional[CapacityProviderInstanceRequirementsArgs] = None,
                     kms_key_arn: Optional[str] = None,
                     tags: Optional[Sequence[_root_inputs.TagArgs]] = None)
    func NewCapacityProvider(ctx *Context, name string, args CapacityProviderArgs, opts ...ResourceOption) (*CapacityProvider, error)
    public CapacityProvider(string name, CapacityProviderArgs args, CustomResourceOptions? opts = null)
    public CapacityProvider(String name, CapacityProviderArgs args)
public CapacityProvider(String name, CapacityProviderArgs args, CustomResourceOptions options)

    type: aws-native:lambda:CapacityProvider
properties: # The arguments to resource properties.
options: # Bag of options to control resource's behavior.

    Parameters

    name string
    The unique name of the resource.
    args CapacityProviderArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    resource_name str
    The unique name of the resource.
    args CapacityProviderArgs
    The arguments to resource properties.
    opts ResourceOptions
    Bag of options to control resource's behavior.
    ctx Context
    Context object for the current deployment.
    name string
    The unique name of the resource.
    args CapacityProviderArgs
    The arguments to resource properties.
    opts ResourceOption
    Bag of options to control resource's behavior.
    name string
    The unique name of the resource.
    args CapacityProviderArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    name String
    The unique name of the resource.
    args CapacityProviderArgs
    The arguments to resource properties.
    options CustomResourceOptions
    Bag of options to control resource's behavior.

    CapacityProvider Resource Properties

    To learn more about resource properties and how to use them, see Inputs and Outputs in the Architecture and Concepts docs.

    Inputs

    In Python, inputs that are objects can be passed either as argument classes or as dictionary literals.

    The CapacityProvider resource accepts the following input properties:

    PermissionsConfig Pulumi.AwsNative.Lambda.Inputs.CapacityProviderPermissionsConfig
    IAM permissions configuration for the capacity provider.
    VpcConfig Pulumi.AwsNative.Lambda.Inputs.CapacityProviderVpcConfig
    VPC configuration for the capacity provider.
    CapacityProviderName string
    The name of the capacity provider. The name must be unique within your AWS account and region. If you don't specify a name, CloudFormation generates one.
    CapacityProviderScalingConfig Pulumi.AwsNative.Lambda.Inputs.CapacityProviderScalingConfig
    The scaling configuration for the capacity provider.
    InstanceRequirements Pulumi.AwsNative.Lambda.Inputs.CapacityProviderInstanceRequirements
    Specifications for the types of EC2 instances that the capacity provider can use.
    KmsKeyArn string
    The ARN of the AWS Key Management Service (KMS) key used by the capacity provider.
    Tags List<Pulumi.AwsNative.Inputs.Tag>
    A list of tags to apply to the capacity provider.
    PermissionsConfig CapacityProviderPermissionsConfigArgs
    IAM permissions configuration for the capacity provider.
    VpcConfig CapacityProviderVpcConfigArgs
    VPC configuration for the capacity provider.
    CapacityProviderName string
    The name of the capacity provider. The name must be unique within your AWS account and region. If you don't specify a name, CloudFormation generates one.
    CapacityProviderScalingConfig CapacityProviderScalingConfigArgs
    The scaling configuration for the capacity provider.
    InstanceRequirements CapacityProviderInstanceRequirementsArgs
    Specifications for the types of EC2 instances that the capacity provider can use.
    KmsKeyArn string
    The ARN of the AWS Key Management Service (KMS) key used by the capacity provider.
    Tags TagArgs
    A list of tags to apply to the capacity provider.
    permissionsConfig CapacityProviderPermissionsConfig
    IAM permissions configuration for the capacity provider.
    vpcConfig CapacityProviderVpcConfig
    VPC configuration for the capacity provider.
    capacityProviderName String
    The name of the capacity provider. The name must be unique within your AWS account and region. If you don't specify a name, CloudFormation generates one.
    capacityProviderScalingConfig CapacityProviderScalingConfig
    The scaling configuration for the capacity provider.
    instanceRequirements CapacityProviderInstanceRequirements
    Specifications for the types of EC2 instances that the capacity provider can use.
    kmsKeyArn String
    The ARN of the AWS Key Management Service (KMS) key used by the capacity provider.
    tags List<Tag>
    A list of tags to apply to the capacity provider.
    permissionsConfig CapacityProviderPermissionsConfig
    IAM permissions configuration for the capacity provider.
    vpcConfig CapacityProviderVpcConfig
    VPC configuration for the capacity provider.
    capacityProviderName string
    The name of the capacity provider. The name must be unique within your AWS account and region. If you don't specify a name, CloudFormation generates one.
    capacityProviderScalingConfig CapacityProviderScalingConfig
    The scaling configuration for the capacity provider.
    instanceRequirements CapacityProviderInstanceRequirements
    Specifications for the types of EC2 instances that the capacity provider can use.
    kmsKeyArn string
    The ARN of the AWS Key Management Service (KMS) key used by the capacity provider.
    tags Tag[]
    A list of tags to apply to the capacity provider.
    permissions_config CapacityProviderPermissionsConfigArgs
    IAM permissions configuration for the capacity provider.
    vpc_config CapacityProviderVpcConfigArgs
    VPC configuration for the capacity provider.
    capacity_provider_name str
    The name of the capacity provider. The name must be unique within your AWS account and region. If you don't specify a name, CloudFormation generates one.
    capacity_provider_scaling_config CapacityProviderScalingConfigArgs
    The scaling configuration for the capacity provider.
    instance_requirements CapacityProviderInstanceRequirementsArgs
    Specifications for the types of EC2 instances that the capacity provider can use.
    kms_key_arn str
    The ARN of the AWS Key Management Service (KMS) key used by the capacity provider.
    tags Sequence[TagArgs]
    A list of tags to apply to the capacity provider.
    permissionsConfig Property Map
    IAM permissions configuration for the capacity provider.
    vpcConfig Property Map
    VPC configuration for the capacity provider.
    capacityProviderName String
    The name of the capacity provider. The name must be unique within your AWS account and region. If you don't specify a name, CloudFormation generates one.
    capacityProviderScalingConfig Property Map
    The scaling configuration for the capacity provider.
    instanceRequirements Property Map
    Specifications for the types of EC2 instances that the capacity provider can use.
    kmsKeyArn String
    The ARN of the AWS Key Management Service (KMS) key used by the capacity provider.
    tags List<Property Map>
    A list of tags to apply to the capacity provider.

    Outputs

    All input properties are implicitly available as output properties. Additionally, the CapacityProvider resource produces the following output properties:

    Arn string
    The Amazon Resource Name (ARN) of the capacity provider. This is a read-only property that is automatically generated when the capacity provider is created.
    Id string
    The provider-assigned unique ID for this managed resource.
    State Pulumi.AwsNative.Lambda.CapacityProviderState
    The current state of the capacity provider.
    Arn string
    The Amazon Resource Name (ARN) of the capacity provider. This is a read-only property that is automatically generated when the capacity provider is created.
    Id string
    The provider-assigned unique ID for this managed resource.
    State CapacityProviderStateEnum
    The current state of the capacity provider.
    arn String
    The Amazon Resource Name (ARN) of the capacity provider. This is a read-only property that is automatically generated when the capacity provider is created.
    id String
    The provider-assigned unique ID for this managed resource.
    state CapacityProviderState
    The current state of the capacity provider.
    arn string
    The Amazon Resource Name (ARN) of the capacity provider. This is a read-only property that is automatically generated when the capacity provider is created.
    id string
    The provider-assigned unique ID for this managed resource.
    state CapacityProviderState
    The current state of the capacity provider.
    arn str
    The Amazon Resource Name (ARN) of the capacity provider. This is a read-only property that is automatically generated when the capacity provider is created.
    id str
    The provider-assigned unique ID for this managed resource.
    state CapacityProviderState
    The current state of the capacity provider.
    arn String
    The Amazon Resource Name (ARN) of the capacity provider. This is a read-only property that is automatically generated when the capacity provider is created.
    id String
    The provider-assigned unique ID for this managed resource.
    state "Pending" | "Active" | "Failed" | "Deleting"
    The current state of the capacity provider.

    Supporting Types

    CapacityProviderArchitecture, CapacityProviderArchitectureArgs

    X8664
    x86_64
    Arm64
    arm64
    CapacityProviderArchitectureX8664
    x86_64
    CapacityProviderArchitectureArm64
    arm64
    X8664
    x86_64
    Arm64
    arm64
    X8664
    x86_64
    Arm64
    arm64
    X8664
    x86_64
    ARM64
    arm64
    "x86_64"
    x86_64
    "arm64"
    arm64

    CapacityProviderInstanceRequirements, CapacityProviderInstanceRequirementsArgs

    Specifications for the types of EC2 instances that the capacity provider can use.
    AllowedInstanceTypes List<string>
    A list of instance types that the capacity provider can use. Supports wildcards (for example, m5.*).
    Architectures List<Pulumi.AwsNative.Lambda.CapacityProviderArchitecture>
    The instruction set architecture for EC2 instances. Specify either x86_64 or arm64.
    ExcludedInstanceTypes List<string>
    A list of instance types that the capacity provider should not use. Takes precedence over AllowedInstanceTypes.
    AllowedInstanceTypes []string
    A list of instance types that the capacity provider can use. Supports wildcards (for example, m5.*).
    Architectures []CapacityProviderArchitecture
    The instruction set architecture for EC2 instances. Specify either x86_64 or arm64.
    ExcludedInstanceTypes []string
    A list of instance types that the capacity provider should not use. Takes precedence over AllowedInstanceTypes.
    allowedInstanceTypes List<String>
    A list of instance types that the capacity provider can use. Supports wildcards (for example, m5.*).
    architectures List<CapacityProviderArchitecture>
    The instruction set architecture for EC2 instances. Specify either x86_64 or arm64.
    excludedInstanceTypes List<String>
    A list of instance types that the capacity provider should not use. Takes precedence over AllowedInstanceTypes.
    allowedInstanceTypes string[]
    A list of instance types that the capacity provider can use. Supports wildcards (for example, m5.*).
    architectures CapacityProviderArchitecture[]
    The instruction set architecture for EC2 instances. Specify either x86_64 or arm64.
    excludedInstanceTypes string[]
    A list of instance types that the capacity provider should not use. Takes precedence over AllowedInstanceTypes.
    allowed_instance_types Sequence[str]
    A list of instance types that the capacity provider can use. Supports wildcards (for example, m5.*).
    architectures Sequence[CapacityProviderArchitecture]
    The instruction set architecture for EC2 instances. Specify either x86_64 or arm64.
    excluded_instance_types Sequence[str]
    A list of instance types that the capacity provider should not use. Takes precedence over AllowedInstanceTypes.
    allowedInstanceTypes List<String>
    A list of instance types that the capacity provider can use. Supports wildcards (for example, m5.*).
    architectures List<"x86_64" | "arm64">
    The instruction set architecture for EC2 instances. Specify either x86_64 or arm64.
    excludedInstanceTypes List<String>
    A list of instance types that the capacity provider should not use. Takes precedence over AllowedInstanceTypes.

    CapacityProviderPermissionsConfig, CapacityProviderPermissionsConfigArgs

    IAM permissions configuration for the capacity provider.
    CapacityProviderOperatorRoleArn string
    The ARN of the IAM role that Lambda assumes to manage the capacity provider.
    CapacityProviderOperatorRoleArn string
    The ARN of the IAM role that Lambda assumes to manage the capacity provider.
    capacityProviderOperatorRoleArn String
    The ARN of the IAM role that Lambda assumes to manage the capacity provider.
    capacityProviderOperatorRoleArn string
    The ARN of the IAM role that Lambda assumes to manage the capacity provider.
    capacity_provider_operator_role_arn str
    The ARN of the IAM role that Lambda assumes to manage the capacity provider.
    capacityProviderOperatorRoleArn String
    The ARN of the IAM role that Lambda assumes to manage the capacity provider.

    CapacityProviderPredefinedMetricType, CapacityProviderPredefinedMetricTypeArgs

    LambdaCapacityProviderAverageCpuUtilization
    LambdaCapacityProviderAverageCPUUtilization
    CapacityProviderPredefinedMetricTypeLambdaCapacityProviderAverageCpuUtilization
    LambdaCapacityProviderAverageCPUUtilization
    LambdaCapacityProviderAverageCpuUtilization
    LambdaCapacityProviderAverageCPUUtilization
    LambdaCapacityProviderAverageCpuUtilization
    LambdaCapacityProviderAverageCPUUtilization
    LAMBDA_CAPACITY_PROVIDER_AVERAGE_CPU_UTILIZATION
    LambdaCapacityProviderAverageCPUUtilization
    "LambdaCapacityProviderAverageCPUUtilization"
    LambdaCapacityProviderAverageCPUUtilization

    CapacityProviderScalingConfig, CapacityProviderScalingConfigArgs

    The scaling configuration for the capacity provider.
    MaxVCpuCount int
    The maximum number of EC2 instances that the capacity provider can scale up to.
    ScalingMode Pulumi.AwsNative.Lambda.CapacityProviderScalingMode
    ScalingPolicies List<Pulumi.AwsNative.Lambda.Inputs.CapacityProviderTargetTrackingScalingPolicy>
    A list of target tracking scaling policies for the capacity provider.
    MaxVCpuCount int
    The maximum number of EC2 instances that the capacity provider can scale up to.
    ScalingMode CapacityProviderScalingMode
    ScalingPolicies []CapacityProviderTargetTrackingScalingPolicy
    A list of target tracking scaling policies for the capacity provider.
    maxVCpuCount Integer
    The maximum number of EC2 instances that the capacity provider can scale up to.
    scalingMode CapacityProviderScalingMode
    scalingPolicies List<CapacityProviderTargetTrackingScalingPolicy>
    A list of target tracking scaling policies for the capacity provider.
    maxVCpuCount number
    The maximum number of EC2 instances that the capacity provider can scale up to.
    scalingMode CapacityProviderScalingMode
    scalingPolicies CapacityProviderTargetTrackingScalingPolicy[]
    A list of target tracking scaling policies for the capacity provider.
    max_v_cpu_count int
    The maximum number of EC2 instances that the capacity provider can scale up to.
    scaling_mode CapacityProviderScalingMode
    scaling_policies Sequence[CapacityProviderTargetTrackingScalingPolicy]
    A list of target tracking scaling policies for the capacity provider.
    maxVCpuCount Number
    The maximum number of EC2 instances that the capacity provider can scale up to.
    scalingMode "Auto" | "Manual"
    scalingPolicies List<Property Map>
    A list of target tracking scaling policies for the capacity provider.

    CapacityProviderScalingMode, CapacityProviderScalingModeArgs

    Auto
    Auto
    Manual
    Manual
    CapacityProviderScalingModeAuto
    Auto
    CapacityProviderScalingModeManual
    Manual
    Auto
    Auto
    Manual
    Manual
    Auto
    Auto
    Manual
    Manual
    AUTO
    Auto
    MANUAL
    Manual
    "Auto"
    Auto
    "Manual"
    Manual

    CapacityProviderState, CapacityProviderStateArgs

    Pending
    Pending
    Active
    Active
    Failed
    Failed
    Deleting
    Deleting
    CapacityProviderStatePending
    Pending
    CapacityProviderStateActive
    Active
    CapacityProviderStateFailed
    Failed
    CapacityProviderStateDeleting
    Deleting
    Pending
    Pending
    Active
    Active
    Failed
    Failed
    Deleting
    Deleting
    Pending
    Pending
    Active
    Active
    Failed
    Failed
    Deleting
    Deleting
    PENDING
    Pending
    ACTIVE
    Active
    FAILED
    Failed
    DELETING
    Deleting
    "Pending"
    Pending
    "Active"
    Active
    "Failed"
    Failed
    "Deleting"
    Deleting

    CapacityProviderTargetTrackingScalingPolicy, CapacityProviderTargetTrackingScalingPolicyArgs

    A target tracking scaling policy for the capacity provider.
    PredefinedMetricType Pulumi.AwsNative.Lambda.CapacityProviderPredefinedMetricType
    TargetValue double
    The target value for the metric as a percentage (for example, 70.0 for 70%).
    PredefinedMetricType CapacityProviderPredefinedMetricType
    TargetValue float64
    The target value for the metric as a percentage (for example, 70.0 for 70%).
    predefinedMetricType CapacityProviderPredefinedMetricType
    targetValue Double
    The target value for the metric as a percentage (for example, 70.0 for 70%).
    predefinedMetricType CapacityProviderPredefinedMetricType
    targetValue number
    The target value for the metric as a percentage (for example, 70.0 for 70%).
    predefined_metric_type CapacityProviderPredefinedMetricType
    target_value float
    The target value for the metric as a percentage (for example, 70.0 for 70%).
    predefinedMetricType "LambdaCapacityProviderAverageCPUUtilization"
    targetValue Number
    The target value for the metric as a percentage (for example, 70.0 for 70%).

    CapacityProviderVpcConfig, CapacityProviderVpcConfigArgs

    VPC configuration for the capacity provider.
    SecurityGroupIds List<string>
    A list of security group IDs to associate with EC2 instances.
    SubnetIds List<string>
    A list of subnet IDs where the capacity provider can launch EC2 instances.
    SecurityGroupIds []string
    A list of security group IDs to associate with EC2 instances.
    SubnetIds []string
    A list of subnet IDs where the capacity provider can launch EC2 instances.
    securityGroupIds List<String>
    A list of security group IDs to associate with EC2 instances.
    subnetIds List<String>
    A list of subnet IDs where the capacity provider can launch EC2 instances.
    securityGroupIds string[]
    A list of security group IDs to associate with EC2 instances.
    subnetIds string[]
    A list of subnet IDs where the capacity provider can launch EC2 instances.
    security_group_ids Sequence[str]
    A list of security group IDs to associate with EC2 instances.
    subnet_ids Sequence[str]
    A list of subnet IDs where the capacity provider can launch EC2 instances.
    securityGroupIds List<String>
    A list of security group IDs to associate with EC2 instances.
    subnetIds List<String>
    A list of subnet IDs where the capacity provider can launch EC2 instances.

    Tag, TagArgs

    A set of tags to apply to the resource.
    Key string
    The key name of the tag
    Value string
    The value of the tag
    Key string
    The key name of the tag
    Value string
    The value of the tag
    key String
    The key name of the tag
    value String
    The value of the tag
    key string
    The key name of the tag
    value string
    The value of the tag
    key str
    The key name of the tag
    value str
    The value of the tag
    key String
    The key name of the tag
    value String
    The value of the tag

    Package Details

    Repository
    AWS Native pulumi/pulumi-aws-native
    License
    Apache-2.0
    aws-native logo

    We recommend new projects start with resources from the AWS provider.

    AWS Cloud Control v1.40.0 published on Thursday, Dec 11, 2025 by Pulumi
    Schema (JSON)
    pulumi/pulumi-aws-native
      Meet Neo: Your AI Platform Teammate