Request Syntax URI Request Parameters Request Body Response Syntax Response Elements Errors See Also

ListCapacityProviders

Returns a list of capacity providers in your account.

Request Syntax


GET /2025-11-30/capacity-providers?Marker=Marker&MaxItems=MaxItems&State=State HTTP/1.1

URI Request Parameters

The request uses the following URI parameters.

Marker

Specify the pagination token that's returned by a previous request to retrieve the next page of results.

MaxItems

The maximum number of capacity providers to return.

Valid Range: Minimum value of 1. Maximum value of 50.

State

Filter capacity providers by their current state.

Valid Values: Pending | Active | Failed | Deleting

Request Body

The request does not have a request body.

Response Syntax


HTTP/1.1 200
Content-type: application/json

{
   "CapacityProviders": [ 
      { 
         "CapacityProviderArn": "string",
         "CapacityProviderScalingConfig": { 
            "MaxVCpuCount": number,
            "ScalingMode": "string",
            "ScalingPolicies": [ 
               { 
                  "PredefinedMetricType": "string",
                  "TargetValue": number
               }
            ]
         },
         "InstanceRequirements": { 
            "AllowedInstanceTypes": [ "string" ],
            "Architectures": [ "string" ],
            "ExcludedInstanceTypes": [ "string" ]
         },
         "KmsKeyArn": "string",
         "LastModified": "string",
         "PermissionsConfig": { 
            "CapacityProviderOperatorRoleArn": "string"
         },
         "State": "string",
         "VpcConfig": { 
            "SecurityGroupIds": [ "string" ],
            "SubnetIds": [ "string" ]
         }
      }
   ],
   "NextMarker": "string"
}

Response Elements

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

CapacityProviders

A list of capacity providers in your account.

Type: Array of CapacityProvider objects

Array Members: Minimum number of 0 items. Maximum number of 50 items.

NextMarker

The pagination token that's included if more results are available.

Type: String

Errors

For information about the errors that are common to all actions, see Common Errors.

InvalidParameterValueException

One of the parameters in the request is not valid.

message: The exception message.
Type: The exception type.

HTTP Status Code: 400

ServiceException

The AWS Lambda service encountered an internal error.

HTTP Status Code: 500

TooManyRequestsException

The request throughput limit was exceeded. For more information, see Lambda quotas.

retryAfterSeconds: The number of seconds the caller should wait before retrying.

HTTP Status Code: 429