Package software.amazon.awscdk.services.apigateway

Interface SpecRestApiProps

All Superinterfaces:

software.amazon.jsii.JsiiSerializable, RestApiBaseProps

All Known Implementing Classes:

SpecRestApiProps.Jsii$Proxy

@Generated(value="jsii-pacmak/1.119.0 (build 1634eac)",
           date="2025-11-17T14:40:44.418Z")
@Stability(Stable)
public interface SpecRestApiProps
extends software.amazon.jsii.JsiiSerializable, RestApiBaseProps

Props to instantiate a new SpecRestApi.

Example:

 SpecRestApi api = SpecRestApi.Builder.create(this, "books-api")
         .apiDefinition(ApiDefinition.fromAsset("path-to-file.json"))
         .mode(RestApiMode.MERGE)
         .build();
 

Nested Class Summary

Nested Classes

Modifier and Type	Interface	Description
static final class	SpecRestApiProps.Builder	A builder for SpecRestApiProps
static final class	SpecRestApiProps.Jsii$Proxy	An implementation for SpecRestApiProps

Method Summary

Modifier and Type	Method	Description
static SpecRestApiProps.Builder	builder()
ApiDefinition	getApiDefinition()	An OpenAPI definition compatible with API Gateway.
default List<String>	getBinaryMediaTypes()	The list of binary media mime-types that are supported by the SpecRestApi resource, such as "image/png" or "application/octet-stream".
default Size	getMinCompressionSize()	A Size(in bytes, kibibytes, mebibytes etc) that is used to enable compression (with non-negative between 0 and 10485760 (10M) bytes, inclusive) or disable compression (when undefined) on an API.
default RestApiMode	getMode()	The Mode that determines how API Gateway handles resource updates.

Methods inherited from interface software.amazon.jsii.JsiiSerializable

$jsii$toJson

Methods inherited from interface software.amazon.awscdk.services.apigateway.RestApiBaseProps

getCloudWatchRole, getCloudWatchRoleRemovalPolicy, getDeploy, getDeployOptions, getDescription, getDisableExecuteApiEndpoint, getDomainName, getEndpointConfiguration, getEndpointExportName, getEndpointTypes, getFailOnWarnings, getParameters, getPolicy, getRestApiName, getRetainDeployments

Method Details

getApiDefinition

@Stability(Stable)
@NotNull
ApiDefinition getApiDefinition()

An OpenAPI definition compatible with API Gateway.

See Also:

• https://docs.aws.amazon.com/apigateway/latest/developerguide/api-gateway-import-api.html

getBinaryMediaTypes

@Stability(Stable)
@Nullable
default List<String> getBinaryMediaTypes()

The list of binary media mime-types that are supported by the SpecRestApi resource, such as "image/png" or "application/octet-stream".

Default: - SpecRestApi supports only UTF-8-encoded text payloads.

getMinCompressionSize

@Stability(Stable)
@Nullable
default Size getMinCompressionSize()

A Size(in bytes, kibibytes, mebibytes etc) that is used to enable compression (with non-negative between 0 and 10485760 (10M) bytes, inclusive) or disable compression (when undefined) on an API.

When compression is enabled, compression or decompression is not applied on the payload if the payload size is smaller than this value. Setting it to zero allows compression for any payload size.

Default: - Compression is disabled.

getMode

@Stability(Stable)
@Nullable
default RestApiMode getMode()

The Mode that determines how API Gateway handles resource updates.

Valid values are overwrite or merge.

For overwrite, the new API definition replaces the existing one. The existing API identifier remains unchanged.

For merge, the new API definition is merged with the existing API.

If you don't specify this property, a default value is chosen:

• For REST APIs created before March 29, 2021, the default is overwrite
• For REST APIs created after March 29, 2021, the new API definition takes precedence, but any container types such as endpoint configurations and binary media types are merged with the existing API.

Use the default mode to define top-level RestApi properties in addition to using OpenAPI. Generally, it's preferred to use API Gateway's OpenAPI extensions to model these properties.

Default: - `merge` for REST APIs created after March 29, 2021, otherwise `overwrite`

builder

@Stability(Stable)
static SpecRestApiProps.Builder builder()

Returns:

a SpecRestApiProps.Builder of SpecRestApiProps