AWS CodeBuild Codebuild Fleet API
The Codebuild Fleet API from AWS CodeBuild — 5 operation(s) for codebuild fleet.
The Codebuild Fleet API from AWS CodeBuild — 5 operation(s) for codebuild fleet.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/aws-codebuild:aws-codebuild-fleet-api"
curl "https://apis.io/api/v1/apis?limit=25"
Discovery needs no key. Ratings and market analysis are Pro.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: AWS CodeBuild Fleet API
version: '2016-10-06'
description: Generated from AWS's published Smithy model for AWS CodeBuild. 5 operation(s).
contact:
name: Amazon Web Services
url: https://aws.amazon.com/contact-us/
license:
name: Apache 2.0
identifier: Apache-2.0
url: https://github.com/aws/api-models-aws/blob/main/LICENSE
servers:
- url: https://codebuild.{region}.amazonaws.com
variables:
region:
default: us-east-1
security:
- sigv4: []
tags:
- name: Fleet
paths:
/#BatchGetFleets:
post:
operationId: BatchGetFleets
summary: Batch Get Fleets
description: Gets information about one or more compute fleets.
responses:
'200':
description: Success
content:
application/x-amz-json-1.1:
schema:
$ref: '#/components/schemas/BatchGetFleetsOutput'
'400':
description: InvalidInputException
content:
application/x-amz-json-1.1:
schema:
$ref: '#/components/schemas/InvalidInputException'
parameters:
- name: X-Amz-Target
in: header
required: true
schema:
type: string
enum:
- CodeBuild_20161006.BatchGetFleets
requestBody:
required: true
content:
application/x-amz-json-1.1:
schema:
$ref: '#/components/schemas/BatchGetFleetsInput'
tags:
- Fleet
/#CreateFleet:
post:
operationId: CreateFleet
summary: Create Fleet
description: Creates a compute fleet.
responses:
'200':
description: Success
content:
application/x-amz-json-1.1:
schema:
$ref: '#/components/schemas/CreateFleetOutput'
'400':
description: AccountLimitExceededException; InvalidInputException; ResourceAlreadyExistsException
content:
application/x-amz-json-1.1:
schema:
$ref: '#/components/schemas/AccountLimitExceededException'
parameters:
- name: X-Amz-Target
in: header
required: true
schema:
type: string
enum:
- CodeBuild_20161006.CreateFleet
requestBody:
required: true
content:
application/x-amz-json-1.1:
schema:
$ref: '#/components/schemas/CreateFleetInput'
tags:
- Fleet
/#DeleteFleet:
post:
operationId: DeleteFleet
summary: Delete Fleet
description: Deletes a compute fleet. When you delete a compute fleet, its builds are not deleted.
responses:
'200':
description: Success
content:
application/x-amz-json-1.1:
schema:
$ref: '#/components/schemas/DeleteFleetOutput'
'400':
description: InvalidInputException
content:
application/x-amz-json-1.1:
schema:
$ref: '#/components/schemas/InvalidInputException'
parameters:
- name: X-Amz-Target
in: header
required: true
schema:
type: string
enum:
- CodeBuild_20161006.DeleteFleet
requestBody:
required: true
content:
application/x-amz-json-1.1:
schema:
$ref: '#/components/schemas/DeleteFleetInput'
tags:
- Fleet
/#ListFleets:
post:
operationId: ListFleets
summary: List Fleets
description: Gets a list of compute fleet names with each compute fleet name representing a single compute fleet.
responses:
'200':
description: Success
content:
application/x-amz-json-1.1:
schema:
$ref: '#/components/schemas/ListFleetsOutput'
'400':
description: InvalidInputException
content:
application/x-amz-json-1.1:
schema:
$ref: '#/components/schemas/InvalidInputException'
parameters:
- name: X-Amz-Target
in: header
required: true
schema:
type: string
enum:
- CodeBuild_20161006.ListFleets
requestBody:
required: true
content:
application/x-amz-json-1.1:
schema:
$ref: '#/components/schemas/ListFleetsInput'
tags:
- Fleet
/#UpdateFleet:
post:
operationId: UpdateFleet
summary: Update Fleet
description: Updates a compute fleet.
responses:
'200':
description: Success
content:
application/x-amz-json-1.1:
schema:
$ref: '#/components/schemas/UpdateFleetOutput'
'400':
description: AccountLimitExceededException; InvalidInputException; ResourceNotFoundException
content:
application/x-amz-json-1.1:
schema:
$ref: '#/components/schemas/AccountLimitExceededException'
parameters:
- name: X-Amz-Target
in: header
required: true
schema:
type: string
enum:
- CodeBuild_20161006.UpdateFleet
requestBody:
required: true
content:
application/x-amz-json-1.1:
schema:
$ref: '#/components/schemas/UpdateFleetInput'
tags:
- Fleet
components:
schemas:
ScalingConfigurationOutput:
type: object
properties:
scalingType:
type: string
enum:
- TARGET_TRACKING_SCALING
description: The scaling type for a compute fleet.
targetTrackingScalingConfigs:
type: array
items:
$ref: '#/components/schemas/TargetTrackingScalingConfiguration'
description: A list of TargetTrackingScalingConfiguration objects.
maxCapacity:
type: integer
description: The maximum number of instances in the fleet when auto-scaling.
desiredCapacity:
type: integer
description: The desired number of instances in the fleet when auto-scaling.
TargetTrackingScalingConfiguration:
type: object
properties:
metricType:
type: string
enum:
- FLEET_UTILIZATION_RATE
description: The metric type to determine auto-scaling.
targetValue:
type: number
description: The value of metricType when to start scaling.
ScalingConfigurationInput:
type: object
properties:
scalingType:
type: string
enum:
- TARGET_TRACKING_SCALING
description: The scaling type for a compute fleet.
targetTrackingScalingConfigs:
type: array
items:
$ref: '#/components/schemas/TargetTrackingScalingConfiguration'
description: A list of TargetTrackingScalingConfiguration objects.
maxCapacity:
type: integer
description: The maximum number of instances in the fleet when auto-scaling.
ListFleetsInput:
type: object
properties:
nextToken:
type: string
description: During a previous call, if there are more than 100 items in the list, only the first 100 items are returned, along with a unique string called a nextToken. To get the next batch of items in the list, call this operation again, adding the next token to the call. To get all of the items in the list, keep calling this operation with each subsequent next token that is returned, until no more next tokens are returned.
maxResults:
type: integer
description: The maximum number of paginated compute fleets returned per response. Use nextToken to iterate pages in the list of returned compute fleets.
sortOrder:
type: string
enum:
- ASCENDING
- DESCENDING
description: 'The order in which to list compute fleets. Valid values include: ASCENDING: List in ascending order. DESCENDING: List in descending order. Use sortBy to specify the criterion to be used to list compute fleet names.'
sortBy:
type: string
enum:
- NAME
- CREATED_TIME
- LAST_MODIFIED_TIME
description: 'The criterion to be used to list compute fleet names. Valid values include: CREATED_TIME: List based on when each compute fleet was created. LAST_MODIFIED_TIME: List based on when information about each compute fleet was last changed. NAME: List based on each compute fleet''s name. Use sortOrder to specify in what order to list the compute fleet names based on the preceding criteria.'
VpcConfig:
type: object
properties:
vpcId:
type: string
description: The ID of the Amazon VPC.
subnets:
type: array
items:
type: string
description: A list of one or more subnet IDs in your Amazon VPC.
securityGroupIds:
type: array
items:
type: string
description: A list of one or more security groups IDs in your Amazon VPC.
Tag:
type: object
properties:
key:
type: string
description: The tag's key.
value:
type: string
description: The tag's value.
DeleteFleetInput:
type: object
properties:
arn:
type: string
description: The ARN of the compute fleet.
required:
- arn
DeleteFleetOutput:
type: object
properties: {}
ComputeConfiguration:
type: object
properties:
vCpu:
type: integer
description: The number of vCPUs of the instance type included in your fleet.
memory:
type: integer
description: The amount of memory of the instance type included in your fleet.
disk:
type: integer
description: The amount of disk space of the instance type included in your fleet.
machineType:
type: string
enum:
- GENERAL
- NVME
description: The machine type of the instance type included in your fleet.
instanceType:
type: string
description: The EC2 instance type to be launched in your fleet.
FleetStatus:
type: object
properties:
statusCode:
type: string
enum:
- CREATING
- UPDATING
- ROTATING
- PENDING_DELETION
- DELETING
- CREATE_FAILED
- UPDATE_ROLLBACK_FAILED
- ACTIVE
description: 'The status code of the compute fleet. Valid values include: CREATING: The compute fleet is being created. UPDATING: The compute fleet is being updated. ROTATING: The compute fleet is being rotated. PENDING_DELETION: The compute fleet is pending deletion. DELETING: The compute fleet is being deleted. CREATE_FAILED: The compute fleet has failed to create. UPDATE_ROLLBACK_FAILED: The compute fleet has failed to update and could not rollback to previous state. ACTIVE: The compute fleet has succeeded and is active.'
context:
type: string
enum:
- CREATE_FAILED
- UPDATE_FAILED
- ACTION_REQUIRED
- PENDING_DELETION
- INSUFFICIENT_CAPACITY
description: 'Additional information about a compute fleet. Valid values include: CREATE_FAILED: The compute fleet has failed to create. UPDATE_FAILED: The compute fleet has failed to update.'
message:
type: string
description: A message associated with the status of a compute fleet.
AccountLimitExceededException:
type: object
properties:
message:
type: string
FleetProxyRule:
type: object
properties:
type:
type: string
enum:
- DOMAIN
- IP
description: The type of proxy rule.
effect:
type: string
enum:
- ALLOW
- DENY
description: The behavior of the proxy rule.
entities:
type: array
items:
type: string
description: The destination of the proxy rule.
required:
- type
- effect
- entities
UpdateFleetOutput:
type: object
properties:
fleet:
$ref: '#/components/schemas/Fleet'
ListFleetsOutput:
type: object
properties:
nextToken:
type: string
description: If there are more than 100 items in the list, only the first 100 items are returned, along with a unique string called a nextToken. To get the next batch of items in the list, call this operation again, adding the next token to the call.
fleets:
type: array
items:
type: string
description: The list of compute fleet names.
UpdateFleetInput:
type: object
properties:
arn:
type: string
description: The ARN of the compute fleet.
baseCapacity:
type: integer
description: The initial number of machines allocated to the compute fleet, which defines the number of builds that can run in parallel.
environmentType:
type: string
enum:
- WINDOWS_CONTAINER
- LINUX_CONTAINER
- LINUX_GPU_CONTAINER
- ARM_CONTAINER
- WINDOWS_SERVER_2019_CONTAINER
- WINDOWS_SERVER_2022_CONTAINER
- LINUX_LAMBDA_CONTAINER
- ARM_LAMBDA_CONTAINER
- LINUX_EC2
- ARM_EC2
- WINDOWS_EC2
- MAC_ARM
description: The environment type of the compute fleet. The environment type ARM_CONTAINER is available only in regions US East (N. Virginia), US East (Ohio), US West (Oregon), EU (Ireland), Asia Pacific (Mumbai), Asia Pacific (Tokyo), Asia Pacific (Singapore), Asia Pacific (Sydney), EU (Frankfurt), and South America (São Paulo). The environment type ARM_EC2 is available only in regions US East (N. Virginia), US East (Ohio), US West (Oregon), EU (Ireland), EU (Frankfurt), Asia Pacific (Tokyo), Asia Pacific (Singapore), Asia Pacific (Sydney), South America (São Paulo), and Asia Pacific (Mumbai). The environ
computeType:
type: string
enum:
- BUILD_GENERAL1_SMALL
- BUILD_GENERAL1_MEDIUM
- BUILD_GENERAL1_LARGE
- BUILD_GENERAL1_XLARGE
- BUILD_GENERAL1_2XLARGE
- BUILD_LAMBDA_1GB
- BUILD_LAMBDA_2GB
- BUILD_LAMBDA_4GB
- BUILD_LAMBDA_8GB
- BUILD_LAMBDA_10GB
- ATTRIBUTE_BASED_COMPUTE
- CUSTOM_INSTANCE_TYPE
description: 'Information about the compute resources the compute fleet uses. Available values include: ATTRIBUTE_BASED_COMPUTE: Specify the amount of vCPUs, memory, disk space, and the type of machine. If you use ATTRIBUTE_BASED_COMPUTE, you must define your attributes by using computeConfiguration. CodeBuild will select the cheapest instance that satisfies your specified attributes. For more information, see Reserved capacity environment types in the CodeBuild User Guide. CUSTOM_INSTANCE_TYPE: Specify the instance type for your compute fleet. For a list of supported instance types, see Supported instance '
computeConfiguration:
$ref: '#/components/schemas/ComputeConfiguration'
scalingConfiguration:
$ref: '#/components/schemas/ScalingConfigurationInput'
overflowBehavior:
type: string
enum:
- QUEUE
- ON_DEMAND
description: The compute fleet overflow behavior. For overflow behavior QUEUE, your overflow builds need to wait on the existing fleet instance to become available. For overflow behavior ON_DEMAND, your overflow builds run on CodeBuild on-demand. If you choose to set your overflow behavior to on-demand while creating a VPC-connected fleet, make sure that you add the required VPC permissions to your project service role. For more information, see Example policy statement to allow CodeBuild access to Amazon Web Services services required to create a VPC network interface.
vpcConfig:
$ref: '#/components/schemas/VpcConfig'
proxyConfiguration:
$ref: '#/components/schemas/ProxyConfiguration'
imageId:
type: string
description: The Amazon Machine Image (AMI) of the compute fleet.
fleetServiceRole:
type: string
description: The service role associated with the compute fleet. For more information, see Allow a user to add a permission policy for a fleet service role in the CodeBuild User Guide.
tags:
type: array
items:
$ref: '#/components/schemas/Tag'
description: A list of tag key and value pairs associated with this compute fleet. These tags are available for use by Amazon Web Services services that support CodeBuild build project tags.
required:
- arn
ProxyConfiguration:
type: object
properties:
defaultBehavior:
type: string
enum:
- ALLOW_ALL
- DENY_ALL
description: The default behavior of outgoing traffic.
orderedProxyRules:
type: array
items:
$ref: '#/components/schemas/FleetProxyRule'
description: An array of FleetProxyRule objects that represent the specified destination domains or IPs to allow or deny network access control to.
Fleet:
type: object
properties:
arn:
type: string
description: The ARN of the compute fleet.
name:
type: string
description: The name of the compute fleet.
id:
type: string
description: The ID of the compute fleet.
created:
type: string
format: date-time
description: The time at which the compute fleet was created.
lastModified:
type: string
format: date-time
description: The time at which the compute fleet was last modified.
status:
$ref: '#/components/schemas/FleetStatus'
baseCapacity:
type: integer
description: The initial number of machines allocated to the compute fleet, which defines the number of builds that can run in parallel.
environmentType:
type: string
enum:
- WINDOWS_CONTAINER
- LINUX_CONTAINER
- LINUX_GPU_CONTAINER
- ARM_CONTAINER
- WINDOWS_SERVER_2019_CONTAINER
- WINDOWS_SERVER_2022_CONTAINER
- LINUX_LAMBDA_CONTAINER
- ARM_LAMBDA_CONTAINER
- LINUX_EC2
- ARM_EC2
- WINDOWS_EC2
- MAC_ARM
description: The environment type of the compute fleet. The environment type ARM_CONTAINER is available only in regions US East (N. Virginia), US East (Ohio), US West (Oregon), EU (Ireland), Asia Pacific (Mumbai), Asia Pacific (Tokyo), Asia Pacific (Singapore), Asia Pacific (Sydney), EU (Frankfurt), and South America (São Paulo). The environment type ARM_EC2 is available only in regions US East (N. Virginia), US East (Ohio), US West (Oregon), EU (Ireland), EU (Frankfurt), Asia Pacific (Tokyo), Asia Pacific (Singapore), Asia Pacific (Sydney), South America (São Paulo), and Asia Pacific (Mumbai). The environ
computeType:
type: string
enum:
- BUILD_GENERAL1_SMALL
- BUILD_GENERAL1_MEDIUM
- BUILD_GENERAL1_LARGE
- BUILD_GENERAL1_XLARGE
- BUILD_GENERAL1_2XLARGE
- BUILD_LAMBDA_1GB
- BUILD_LAMBDA_2GB
- BUILD_LAMBDA_4GB
- BUILD_LAMBDA_8GB
- BUILD_LAMBDA_10GB
- ATTRIBUTE_BASED_COMPUTE
- CUSTOM_INSTANCE_TYPE
description: 'Information about the compute resources the compute fleet uses. Available values include: ATTRIBUTE_BASED_COMPUTE: Specify the amount of vCPUs, memory, disk space, and the type of machine. If you use ATTRIBUTE_BASED_COMPUTE, you must define your attributes by using computeConfiguration. CodeBuild will select the cheapest instance that satisfies your specified attributes. For more information, see Reserved capacity environment types in the CodeBuild User Guide. CUSTOM_INSTANCE_TYPE: Specify the instance type for your compute fleet. For a list of supported instance types, see Supported instance '
computeConfiguration:
$ref: '#/components/schemas/ComputeConfiguration'
scalingConfiguration:
$ref: '#/components/schemas/ScalingConfigurationOutput'
overflowBehavior:
type: string
enum:
- QUEUE
- ON_DEMAND
description: The compute fleet overflow behavior. For overflow behavior QUEUE, your overflow builds need to wait on the existing fleet instance to become available. For overflow behavior ON_DEMAND, your overflow builds run on CodeBuild on-demand. If you choose to set your overflow behavior to on-demand while creating a VPC-connected fleet, make sure that you add the required VPC permissions to your project service role. For more information, see Example policy statement to allow CodeBuild access to Amazon Web Services services required to create a VPC network interface.
vpcConfig:
$ref: '#/components/schemas/VpcConfig'
proxyConfiguration:
$ref: '#/components/schemas/ProxyConfiguration'
imageId:
type: string
description: The Amazon Machine Image (AMI) of the compute fleet.
fleetServiceRole:
type: string
description: The service role associated with the compute fleet. For more information, see Allow a user to add a permission policy for a fleet service role in the CodeBuild User Guide.
tags:
type: array
items:
$ref: '#/components/schemas/Tag'
description: A list of tag key and value pairs associated with this compute fleet. These tags are available for use by Amazon Web Services services that support CodeBuild build project tags.
InvalidInputException:
type: object
properties:
message:
type: string
CreateFleetOutput:
type: object
properties:
fleet:
$ref: '#/components/schemas/Fleet'
BatchGetFleetsOutput:
type: object
properties:
fleets:
type: array
items:
$ref: '#/components/schemas/Fleet'
description: Information about the requested compute fleets.
fleetsNotFound:
type: array
items:
type: string
description: The names of compute fleets for which information could not be found.
CreateFleetInput:
type: object
properties:
name:
type: string
description: The name of the compute fleet.
baseCapacity:
type: integer
description: The initial number of machines allocated to the fleet, which defines the number of builds that can run in parallel.
environmentType:
type: string
enum:
- WINDOWS_CONTAINER
- LINUX_CONTAINER
- LINUX_GPU_CONTAINER
- ARM_CONTAINER
- WINDOWS_SERVER_2019_CONTAINER
- WINDOWS_SERVER_2022_CONTAINER
- LINUX_LAMBDA_CONTAINER
- ARM_LAMBDA_CONTAINER
- LINUX_EC2
- ARM_EC2
- WINDOWS_EC2
- MAC_ARM
description: The environment type of the compute fleet. The environment type ARM_CONTAINER is available only in regions US East (N. Virginia), US East (Ohio), US West (Oregon), EU (Ireland), Asia Pacific (Mumbai), Asia Pacific (Tokyo), Asia Pacific (Singapore), Asia Pacific (Sydney), EU (Frankfurt), and South America (São Paulo). The environment type ARM_EC2 is available only in regions US East (N. Virginia), US East (Ohio), US West (Oregon), EU (Ireland), EU (Frankfurt), Asia Pacific (Tokyo), Asia Pacific (Singapore), Asia Pacific (Sydney), South America (São Paulo), and Asia Pacific (Mumbai). The environ
computeType:
type: string
enum:
- BUILD_GENERAL1_SMALL
- BUILD_GENERAL1_MEDIUM
- BUILD_GENERAL1_LARGE
- BUILD_GENERAL1_XLARGE
- BUILD_GENERAL1_2XLARGE
- BUILD_LAMBDA_1GB
- BUILD_LAMBDA_2GB
- BUILD_LAMBDA_4GB
- BUILD_LAMBDA_8GB
- BUILD_LAMBDA_10GB
- ATTRIBUTE_BASED_COMPUTE
- CUSTOM_INSTANCE_TYPE
description: 'Information about the compute resources the compute fleet uses. Available values include: ATTRIBUTE_BASED_COMPUTE: Specify the amount of vCPUs, memory, disk space, and the type of machine. If you use ATTRIBUTE_BASED_COMPUTE, you must define your attributes by using computeConfiguration. CodeBuild will select the cheapest instance that satisfies your specified attributes. For more information, see Reserved capacity environment types in the CodeBuild User Guide. CUSTOM_INSTANCE_TYPE: Specify the instance type for your compute fleet. For a list of supported instance types, see Supported instance '
computeConfiguration:
$ref: '#/components/schemas/ComputeConfiguration'
scalingConfiguration:
$ref: '#/components/schemas/ScalingConfigurationInput'
overflowBehavior:
type: string
enum:
- QUEUE
- ON_DEMAND
description: The compute fleet overflow behavior. For overflow behavior QUEUE, your overflow builds need to wait on the existing fleet instance to become available. For overflow behavior ON_DEMAND, your overflow builds run on CodeBuild on-demand. If you choose to set your overflow behavior to on-demand while creating a VPC-connected fleet, make sure that you add the required VPC permissions to your project service role. For more information, see Example policy statement to allow CodeBuild access to Amazon Web Services services required to create a VPC network interface.
vpcConfig:
$ref: '#/components/schemas/VpcConfig'
proxyConfiguration:
$ref: '#/components/schemas/ProxyConfiguration'
imageId:
type: string
description: The Amazon Machine Image (AMI) of the compute fleet.
fleetServiceRole:
type: string
description: The service role associated with the compute fleet. For more information, see Allow a user to add a permission policy for a fleet service role in the CodeBuild User Guide.
tags:
type: array
items:
$ref: '#/components/schemas/Tag'
description: A list of tag key and value pairs associated with this compute fleet. These tags are available for use by Amazon Web Services services that support CodeBuild build project tags.
required:
- name
- baseCapacity
- environmentType
- computeType
BatchGetFleetsInput:
type: object
properties:
names:
type: array
items:
type: string
description: The names or ARNs of the compute fleets.
required:
- names
securitySchemes:
sigv4:
type: apiKey
in: header
name: Authorization
description: AWS Signature Version 4. The Authorization header carries an AWS4-HMAC-SHA256 signature over the canonical request, with X-Amz-Date (and X-Amz-Security-Token for temporary credentials). Not a bearer token.
x-aws-sigv4:
signingName: codebuild
x-provenance:
method: harvested
publisher: Amazon Web Services
source: https://raw.githubusercontent.com/aws/api-models-aws/582e55931c45b944739742a2c1620b6026dd2d13/models/codebuild/service/2016-10-06/codebuild-2016-10-06.json
note: converted by smithy-to-openapi.py from AWS's Smithy model (roadmap#1001)