Amazon EMR Emr Instance Fleet API
The Emr Instance Fleet API from Amazon EMR — 3 operation(s) for emr instance fleet.
The Emr Instance Fleet API from Amazon EMR — 3 operation(s) for emr instance 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/amazon-emr:amazon-emr-instance-fleet-api"
curl "https://apis.io/api/v1/apis?limit=25"
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
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: Amazon EMR Instance Fleet API
version: '2009-03-31'
description: Generated from AWS's published Smithy model for Amazon EMR. 3 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://elasticmapreduce.{region}.amazonaws.com
variables:
region:
default: us-east-1
security:
- sigv4: []
tags:
- name: Instance Fleet
paths:
/#AddInstanceFleet:
post:
operationId: AddInstanceFleet
summary: Add Instance Fleet
description: Adds an instance fleet to a running cluster. The instance fleet configuration is available only in Amazon EMR releases 4.8.0 and later, excluding 5.0.x.
responses:
'200':
description: Success
content:
application/x-amz-json-1.1:
schema:
$ref: '#/components/schemas/AddInstanceFleetOutput'
'500':
description: InternalServerException
content:
application/x-amz-json-1.1:
schema:
$ref: '#/components/schemas/InternalServerException'
'400':
description: InvalidRequestException
content:
application/x-amz-json-1.1:
schema:
$ref: '#/components/schemas/InvalidRequestException'
parameters:
- name: X-Amz-Target
in: header
required: true
schema:
type: string
enum:
- ElasticMapReduce.AddInstanceFleet
requestBody:
required: true
content:
application/x-amz-json-1.1:
schema:
$ref: '#/components/schemas/AddInstanceFleetInput'
tags:
- Instance Fleet
/#ListInstanceFleets:
post:
operationId: ListInstanceFleets
summary: List Instance Fleets
description: Lists all available details about the instance fleets in a cluster. The instance fleet configuration is available only in Amazon EMR releases 4.8.0 and later, excluding 5.0.x versions.
responses:
'200':
description: Success
content:
application/x-amz-json-1.1:
schema:
$ref: '#/components/schemas/ListInstanceFleetsOutput'
'500':
description: InternalServerException
content:
application/x-amz-json-1.1:
schema:
$ref: '#/components/schemas/InternalServerException'
'400':
description: InvalidRequestException
content:
application/x-amz-json-1.1:
schema:
$ref: '#/components/schemas/InvalidRequestException'
parameters:
- name: X-Amz-Target
in: header
required: true
schema:
type: string
enum:
- ElasticMapReduce.ListInstanceFleets
requestBody:
required: true
content:
application/x-amz-json-1.1:
schema:
$ref: '#/components/schemas/ListInstanceFleetsInput'
tags:
- Instance Fleet
/#ModifyInstanceFleet:
post:
operationId: ModifyInstanceFleet
summary: Modify Instance Fleet
description: Modifies the target On-Demand and target Spot capacities for the instance fleet with the specified InstanceFleetID within the cluster specified using ClusterID. The call either succeeds or fails atomically. The instance fleet configuration is available only in Amazon EMR releases 4.8.0 and later, excluding 5.0.x versions.
responses:
'200':
description: Success
content:
application/x-amz-json-1.1:
schema:
type: string
'500':
description: InternalServerException
content:
application/x-amz-json-1.1:
schema:
$ref: '#/components/schemas/InternalServerException'
'400':
description: InvalidRequestException
content:
application/x-amz-json-1.1:
schema:
$ref: '#/components/schemas/InvalidRequestException'
parameters:
- name: X-Amz-Target
in: header
required: true
schema:
type: string
enum:
- ElasticMapReduce.ModifyInstanceFleet
requestBody:
required: true
content:
application/x-amz-json-1.1:
schema:
$ref: '#/components/schemas/ModifyInstanceFleetInput'
tags:
- Instance Fleet
components:
schemas:
InstanceFleetModifyConfig:
type: object
properties:
InstanceFleetId:
type: string
description: A unique identifier for the instance fleet.
TargetOnDemandCapacity:
type: integer
description: The target capacity of On-Demand units for the instance fleet. For more information see InstanceFleetConfig$TargetOnDemandCapacity.
TargetSpotCapacity:
type: integer
description: The target capacity of Spot units for the instance fleet. For more information, see InstanceFleetConfig$TargetSpotCapacity.
ResizeSpecifications:
$ref: '#/components/schemas/InstanceFleetResizingSpecifications'
InstanceTypeConfigs:
type: array
items:
$ref: '#/components/schemas/InstanceTypeConfig'
description: An array of InstanceTypeConfig objects that specify how Amazon EMR provisions Amazon EC2 instances when it fulfills On-Demand and Spot capacities. For more information, see InstanceTypeConfig.
Context:
type: string
description: Reserved.
required:
- InstanceFleetId
InstanceFleetProvisioningSpecifications:
type: object
properties:
SpotSpecification:
$ref: '#/components/schemas/SpotProvisioningSpecification'
OnDemandSpecification:
$ref: '#/components/schemas/OnDemandProvisioningSpecification'
ModifyInstanceFleetInput:
type: object
properties:
ClusterId:
type: string
description: The unique identifier of the cluster.
InstanceFleet:
$ref: '#/components/schemas/InstanceFleetModifyConfig'
required:
- ClusterId
- InstanceFleet
EbsBlockDeviceConfig:
type: object
properties:
VolumeSpecification:
$ref: '#/components/schemas/VolumeSpecification'
VolumesPerInstance:
type: integer
description: Number of EBS volumes with a specific volume configuration that are associated with every instance in the instance group
required:
- VolumeSpecification
InternalServerException:
type: object
properties:
Message:
type: string
description: The message associated with the exception.
InstanceFleetConfig:
type: object
properties:
Name:
type: string
description: The friendly name of the instance fleet.
InstanceFleetType:
type: string
enum:
- MASTER
- CORE
- TASK
description: The node type that the instance fleet hosts. Valid values are MASTER, CORE, and TASK.
TargetOnDemandCapacity:
type: integer
description: The target capacity of On-Demand units for the instance fleet, which determines how many On-Demand Instances to provision. When the instance fleet launches, Amazon EMR tries to provision On-Demand Instances as specified by InstanceTypeConfig. Each instance configuration has a specified WeightedCapacity. When an On-Demand Instance is provisioned, the WeightedCapacity units count toward the target capacity. Amazon EMR provisions instances until the target capacity is totally fulfilled, even if this results in an overage. For example, if there are 2 units remaining to fulfill capacity, and Amazon
TargetSpotCapacity:
type: integer
description: The target capacity of Spot units for the instance fleet, which determines how many Spot Instances to provision. When the instance fleet launches, Amazon EMR tries to provision Spot Instances as specified by InstanceTypeConfig. Each instance configuration has a specified WeightedCapacity. When a Spot Instance is provisioned, the WeightedCapacity units count toward the target capacity. Amazon EMR provisions instances until the target capacity is totally fulfilled, even if this results in an overage. For example, if there are 2 units remaining to fulfill capacity, and Amazon EMR can only provisi
InstanceTypeConfigs:
type: array
items:
$ref: '#/components/schemas/InstanceTypeConfig'
description: The instance type configurations that define the Amazon EC2 instances in the instance fleet.
LaunchSpecifications:
$ref: '#/components/schemas/InstanceFleetProvisioningSpecifications'
ResizeSpecifications:
$ref: '#/components/schemas/InstanceFleetResizingSpecifications'
Context:
type: string
description: Reserved.
required:
- InstanceFleetType
InstanceFleetTimeline:
type: object
properties:
CreationDateTime:
type: string
format: date-time
description: The time and date the instance fleet was created.
ReadyDateTime:
type: string
format: date-time
description: The time and date the instance fleet was ready to run jobs.
EndDateTime:
type: string
format: date-time
description: The time and date the instance fleet terminated.
OnDemandResizingSpecification:
type: object
properties:
TimeoutDurationMinutes:
type: integer
description: On-Demand resize timeout in minutes. If On-Demand Instances are not provisioned within this time, the resize workflow stops. The minimum value is 5 minutes, and the maximum value is 10,080 minutes (7 days). The timeout applies to all resize workflows on the Instance Fleet. The resize could be triggered by Amazon EMR Managed Scaling or by the customer (via Amazon EMR Console, Amazon EMR CLI modify-instance-fleet or Amazon EMR SDK ModifyInstanceFleet API) or by Amazon EMR due to Amazon EC2 Spot Reclamation.
AllocationStrategy:
type: string
enum:
- lowest-price
- prioritized
description: Specifies the allocation strategy to use to launch On-Demand instances during a resize. The default is lowest-price.
CapacityReservationOptions:
$ref: '#/components/schemas/OnDemandCapacityReservationOptions'
SpotProvisioningSpecification:
type: object
properties:
TimeoutDurationMinutes:
type: integer
description: The Spot provisioning timeout period in minutes. If Spot Instances are not provisioned within this time period, the TimeOutAction is taken. Minimum value is 5 and maximum value is 1440. The timeout applies only during initial provisioning, when the cluster is first created.
TimeoutAction:
type: string
enum:
- SWITCH_TO_ON_DEMAND
- TERMINATE_CLUSTER
description: The action to take when TargetSpotCapacity has not been fulfilled when the TimeoutDurationMinutes has expired; that is, when all Spot Instances could not be provisioned within the Spot provisioning timeout. Valid values are TERMINATE_CLUSTER and SWITCH_TO_ON_DEMAND. SWITCH_TO_ON_DEMAND specifies that if no Spot Instances are available, On-Demand Instances should be provisioned to fulfill any remaining Spot capacity.
BlockDurationMinutes:
type: integer
description: The defined duration for Spot Instances (also known as Spot blocks) in minutes. When specified, the Spot Instance does not terminate before the defined duration expires, and defined duration pricing for Spot Instances applies. Valid values are 60, 120, 180, 240, 300, or 360. The duration period starts as soon as a Spot Instance receives its instance ID. At the end of the duration, Amazon EC2 marks the Spot Instance for termination and provides a Spot Instance termination notice, which gives the instance a two-minute warning before it terminates. Spot Instances with a defined duration (also kno
AllocationStrategy:
type: string
enum:
- capacity-optimized
- price-capacity-optimized
- lowest-price
- diversified
- capacity-optimized-prioritized
description: 'Specifies one of the following strategies to launch Spot Instance fleets: capacity-optimized, price-capacity-optimized, lowest-price, or diversified, and capacity-optimized-prioritized. For more information on the provisioning strategies, see Allocation strategies for Spot Instances in the Amazon EC2 User Guide for Linux Instances. When you launch a Spot Instance fleet with the old console, it automatically launches with the capacity-optimized strategy. You can''t change the allocation strategy from the old console.'
required:
- TimeoutDurationMinutes
- TimeoutAction
InstanceFleetResizingSpecifications:
type: object
properties:
SpotResizeSpecification:
$ref: '#/components/schemas/SpotResizingSpecification'
OnDemandResizeSpecification:
$ref: '#/components/schemas/OnDemandResizingSpecification'
ListInstanceFleetsInput:
type: object
properties:
ClusterId:
type: string
description: The unique identifier of the cluster.
Marker:
type: string
description: The pagination token that indicates the next set of results to retrieve.
required:
- ClusterId
InstanceFleet:
type: object
properties:
Id:
type: string
description: The unique identifier of the instance fleet.
Name:
type: string
description: A friendly name for the instance fleet.
Status:
$ref: '#/components/schemas/InstanceFleetStatus'
InstanceFleetType:
type: string
enum:
- MASTER
- CORE
- TASK
description: The node type that the instance fleet hosts. Valid values are MASTER, CORE, or TASK.
TargetOnDemandCapacity:
type: integer
description: The target capacity of On-Demand units for the instance fleet, which determines how many On-Demand Instances to provision. When the instance fleet launches, Amazon EMR tries to provision On-Demand Instances as specified by InstanceTypeConfig. Each instance configuration has a specified WeightedCapacity. When an On-Demand Instance is provisioned, the WeightedCapacity units count toward the target capacity. Amazon EMR provisions instances until the target capacity is totally fulfilled, even if this results in an overage. For example, if there are 2 units remaining to fulfill capacity, and Amazon
TargetSpotCapacity:
type: integer
description: The target capacity of Spot units for the instance fleet, which determines how many Spot Instances to provision. When the instance fleet launches, Amazon EMR tries to provision Spot Instances as specified by InstanceTypeConfig. Each instance configuration has a specified WeightedCapacity. When a Spot instance is provisioned, the WeightedCapacity units count toward the target capacity. Amazon EMR provisions instances until the target capacity is totally fulfilled, even if this results in an overage. For example, if there are 2 units remaining to fulfill capacity, and Amazon EMR can only provisi
ProvisionedOnDemandCapacity:
type: integer
description: The number of On-Demand units that have been provisioned for the instance fleet to fulfill TargetOnDemandCapacity. This provisioned capacity might be less than or greater than TargetOnDemandCapacity.
ProvisionedSpotCapacity:
type: integer
description: The number of Spot units that have been provisioned for this instance fleet to fulfill TargetSpotCapacity. This provisioned capacity might be less than or greater than TargetSpotCapacity.
InstanceTypeSpecifications:
type: array
items:
$ref: '#/components/schemas/InstanceTypeSpecification'
description: An array of specifications for the instance types that comprise an instance fleet.
LaunchSpecifications:
$ref: '#/components/schemas/InstanceFleetProvisioningSpecifications'
ResizeSpecifications:
$ref: '#/components/schemas/InstanceFleetResizingSpecifications'
Context:
type: string
description: Reserved.
InstanceTypeConfig:
type: object
properties:
InstanceType:
type: string
description: An Amazon EC2 instance type, such as m3.xlarge.
WeightedCapacity:
type: integer
description: The number of units that a provisioned instance of this type provides toward fulfilling the target capacities defined in InstanceFleetConfig. This value is 1 for a master instance fleet, and must be 1 or greater for core and task instance fleets. Defaults to 1 if not specified.
BidPrice:
type: string
description: The bid price for each Amazon EC2 Spot Instance type as defined by InstanceType. Expressed in USD. If neither BidPrice nor BidPriceAsPercentageOfOnDemandPrice is provided, BidPriceAsPercentageOfOnDemandPrice defaults to 100%.
BidPriceAsPercentageOfOnDemandPrice:
type: number
description: The bid price, as a percentage of On-Demand price, for each Amazon EC2 Spot Instance as defined by InstanceType. Expressed as a number (for example, 20 specifies 20%). If neither BidPrice nor BidPriceAsPercentageOfOnDemandPrice is provided, BidPriceAsPercentageOfOnDemandPrice defaults to 100%.
EbsConfiguration:
$ref: '#/components/schemas/EbsConfiguration'
Configurations:
type: array
items:
$ref: '#/components/schemas/Configuration'
description: A configuration classification that applies when provisioning cluster instances, which can include configurations for applications and software that run on the cluster.
CustomAmiId:
type: string
description: The custom AMI ID to use for the instance type.
Priority:
type: number
description: The priority at which Amazon EMR launches the Amazon EC2 instances with this instance type. Priority starts at 0, which is the highest priority. Amazon EMR considers the highest priority first.
required:
- InstanceType
InstanceFleetStatus:
type: object
properties:
State:
type: string
enum:
- PROVISIONING
- BOOTSTRAPPING
- RUNNING
- RESIZING
- RECONFIGURING
- SUSPENDED
- TERMINATING
- TERMINATED
description: A code representing the instance fleet status. PROVISIONING—The instance fleet is provisioning Amazon EC2 resources and is not yet ready to run jobs. BOOTSTRAPPING—Amazon EC2 instances and other resources have been provisioned and the bootstrap actions specified for the instances are underway. RUNNING—Amazon EC2 instances and other resources are running. They are either executing jobs or waiting to execute jobs. RESIZING—A resize operation is underway. Amazon EC2 instances are either being added or removed. SUSPENDED—A resize operation could not complete. Existing Amazon EC2 instances are runn
StateChangeReason:
$ref: '#/components/schemas/InstanceFleetStateChangeReason'
Timeline:
$ref: '#/components/schemas/InstanceFleetTimeline'
OnDemandCapacityReservationOptions:
type: object
properties:
UsageStrategy:
type: string
enum:
- use-capacity-reservations-first
description: 'Indicates whether to use unused Capacity Reservations for fulfilling On-Demand capacity. If you specify use-capacity-reservations-first, the fleet uses unused Capacity Reservations to fulfill On-Demand capacity up to the target On-Demand capacity. If multiple instance pools have unused Capacity Reservations, the On-Demand allocation strategy (lowest-price) is applied. If the number of unused Capacity Reservations is less than the On-Demand target capacity, the remaining On-Demand target capacity is launched according to the On-Demand allocation strategy (lowest-price). If you do not specify a '
CapacityReservationPreference:
type: string
enum:
- open
- none
description: 'Indicates the instance''s Capacity Reservation preferences. Possible preferences include: open - The instance can run in any open Capacity Reservation that has matching attributes (instance type, platform, Availability Zone). none - The instance avoids running in a Capacity Reservation even if one is available. The instance runs as an On-Demand Instance.'
CapacityReservationResourceGroupArn:
type: string
description: The ARN of the Capacity Reservation resource group in which to run the instance.
EbsBlockDevice:
type: object
properties:
VolumeSpecification:
$ref: '#/components/schemas/VolumeSpecification'
Device:
type: string
description: The device name that is exposed to the instance, such as /dev/sdh.
AddInstanceFleetOutput:
type: object
properties:
ClusterId:
type: string
description: The unique identifier of the cluster.
InstanceFleetId:
type: string
description: The unique identifier of the instance fleet.
ClusterArn:
type: string
description: The Amazon Resource Name of the cluster.
InstanceFleetStateChangeReason:
type: object
properties:
Code:
type: string
enum:
- INTERNAL_ERROR
- VALIDATION_ERROR
- INSTANCE_FAILURE
- CLUSTER_TERMINATED
description: A code corresponding to the reason the state change occurred.
Message:
type: string
description: An explanatory message.
VolumeSpecification:
type: object
properties:
VolumeType:
type: string
description: The volume type. Volume types supported are gp3, gp2, io1, st1, sc1, and standard.
Iops:
type: integer
description: The number of I/O operations per second (IOPS) that the volume supports.
SizeInGB:
type: integer
description: The volume size, in gibibytes (GiB). This can be a number from 1 - 1024. If the volume type is EBS-optimized, the minimum value is 10.
Throughput:
type: integer
description: The throughput, in mebibyte per second (MiB/s). This optional parameter can be a number from 125 - 1000 and is valid only for gp3 volumes.
required:
- VolumeType
- SizeInGB
EbsConfiguration:
type: object
properties:
EbsBlockDeviceConfigs:
type: array
items:
$ref: '#/components/schemas/EbsBlockDeviceConfig'
description: An array of Amazon EBS volume specifications attached to a cluster instance.
EbsOptimized:
type: boolean
description: Indicates whether an Amazon EBS volume is EBS-optimized. The default is false. You should explicitly set this value to true to enable the Amazon EBS-optimized setting for an EC2 instance.
Configuration:
type: object
properties:
Classification:
type: string
description: The classification within a configuration.
Configurations:
type: array
items:
$ref: '#/components/schemas/Configuration'
description: A list of additional configurations to apply within a configuration object.
Properties:
type: object
additionalProperties:
type: string
description: A set of properties specified within a configuration classification.
ListInstanceFleetsOutput:
type: object
properties:
InstanceFleets:
type: array
items:
$ref: '#/components/schemas/InstanceFleet'
description: The list of instance fleets for the cluster and given filters.
Marker:
type: string
description: The pagination token that indicates the next set of results to retrieve.
SpotResizingSpecification:
type: object
properties:
TimeoutDurationMinutes:
type: integer
description: Spot resize timeout in minutes. If Spot Instances are not provisioned within this time, the resize workflow will stop provisioning of Spot instances. Minimum value is 5 minutes and maximum value is 10,080 minutes (7 days). The timeout applies to all resize workflows on the Instance Fleet. The resize could be triggered by Amazon EMR Managed Scaling or by the customer (via Amazon EMR Console, Amazon EMR CLI modify-instance-fleet or Amazon EMR SDK ModifyInstanceFleet API) or by Amazon EMR due to Amazon EC2 Spot Reclamation.
AllocationStrategy:
type: string
enum:
- capacity-optimized
- price-capacity-optimized
- lowest-price
- diversified
- capacity-optimized-prioritized
description: Specifies the allocation strategy to use to launch Spot instances during a resize. If you run Amazon EMR releases 6.9.0 or higher, the default is price-capacity-optimized. If you run Amazon EMR releases 6.8.0 or lower, the default is capacity-optimized.
OnDemandProvisioningSpecification:
type: object
properties:
AllocationStrategy:
type: string
enum:
- lowest-price
- prioritized
description: Specifies the strategy to use in launching On-Demand instance fleets. Available options are lowest-price and prioritized. lowest-price specifies to launch the instances with the lowest price first, and prioritized specifies that Amazon EMR should launch the instances with the highest priority first. The default is lowest-price.
CapacityReservationOptions:
$ref: '#/components/schemas/OnDemandCapacityReservationOptions'
required:
- AllocationStrategy
AddInstanceFleetInput:
type: object
properties:
ClusterId:
type: string
description: The unique identifier of the cluster.
InstanceFleet:
$ref: '#/components/schemas/InstanceFleetConfig'
required:
- ClusterId
- InstanceFleet
InstanceTypeSpecification:
type: object
properties:
InstanceType:
type: string
description: The Amazon EC2 instance type, for example m3.xlarge.
WeightedCapacity:
type: integer
description: The number of units that a provisioned instance of this type provides toward fulfilling the target capacities defined in InstanceFleetConfig. Capacity values represent performance characteristics such as vCPUs, memory, or I/O. If not specified, the default value is 1.
BidPrice:
type: string
description: The bid price for each Amazon EC2 Spot Instance type as defined by InstanceType. Expressed in USD. If neither BidPrice nor BidPriceAsPercentageOfOnDemandPrice is provided, BidPriceAsPercentageOfOnDemandPrice defaults to 100%.
BidPriceAsPercentageOfOnDemandPrice:
type: number
description: The bid price, as a percentage of On-Demand price, for each Amazon EC2 Spot Instance as defined by InstanceType. Expressed as a number (for example, 20 specifies 20%).
Configurations:
type: array
items:
$ref: '#/components/schemas/Configuration'
description: A configuration classification that applies when provisioning cluster instances, which can include configurations for applications and software bundled with Amazon EMR.
EbsBlockDevices:
type: array
items:
$ref: '#/components/schemas/EbsBlockDevice'
description: The configuration of Amazon Elastic Block Store (Amazon EBS) attached to each instance as defined by InstanceType.
EbsOptimized:
type: boolean
description: Evaluates to TRUE when the specified InstanceType is EBS-optimized.
CustomAmiId:
type: string
description: The custom AMI ID to use for the instance type.
Priority:
type: number
description: The priority at which Amazon EMR launches the Amazon EC2 instances with this instance type. Priority starts at 0, which is the highest priority. Amazon EMR considers the highest priority first.
InvalidRequestException:
type: object
properties:
ErrorCode:
type: string
description: The error code associated with the exception.
Message:
type: string
description: The message associated with the exception.
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: elasticmapreduce
x-provenance:
method: harvested
publisher: Amazon Web Services
source: https://raw.githubusercontent.com/aws/api-models-aws/582e55931c45b944739742a2c1620b6026dd2d13/models/emr/service/2009-03-31/emr-2009-03-31.json
note: converted by smithy-to-openapi.py from AWS's Smithy model (roadmap#1001)