Package software.amazon.awscdk.services.apigateway

Class SpecRestApi

java.lang.Object

software.amazon.jsii.JsiiObject

software.constructs.Construct

software.amazon.awscdk.Resource

software.amazon.awscdk.services.apigateway.RestApiBase

software.amazon.awscdk.services.apigateway.SpecRestApi

All Implemented Interfaces:

IRestApiRef, IEnvironmentAware, IResource, IRestApi, IResourceWithPolicy, IResourceWithPolicyV2, software.amazon.jsii.JsiiSerializable, software.constructs.IConstruct, software.constructs.IDependable

@Generated(value="jsii-pacmak/1.120.0 (build 192dc88)",
           date="2025-12-05T10:47:11.610Z")
@Stability(Stable)
public class SpecRestApi
extends RestApiBase

Represents a REST API in Amazon API Gateway, created with an OpenAPI specification.

Some properties normally accessible on

Example:

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

See Also:

• `RestApi` - such as the description - must be declared in the specification. All Resources and Methods need to be defined as part of the OpenAPI specification file, and cannot be added via the CDK. By default, the API will automatically be deployed and accessible from a public endpoint.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static final class	SpecRestApi.Builder	A fluent builder for SpecRestApi.

Nested classes/interfaces inherited from class software.amazon.jsii.JsiiObject

software.amazon.jsii.JsiiObject.InitializationMode

Nested classes/interfaces inherited from interface software.constructs.IConstruct

software.constructs.IConstruct.Jsii$Default

Nested classes/interfaces inherited from interface software.amazon.awscdk.IResource

IResource.Jsii$Default

Nested classes/interfaces inherited from interface software.amazon.awscdk.services.iam.IResourceWithPolicy

IResourceWithPolicy.Jsii$Default

Nested classes/interfaces inherited from interface software.amazon.awscdk.services.apigateway.IRestApi

IRestApi.Jsii$Default

Field Summary

Fields

Modifier and Type	Field	Description
static final String	PROPERTY_INJECTION_ID	Uniquely identifies this class.

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	SpecRestApi(software.amazon.jsii.JsiiObject.InitializationMode initializationMode)
protected	SpecRestApi(software.amazon.jsii.JsiiObjectRef objRef)
	SpecRestApi(software.constructs.Construct scope, String id, SpecRestApiProps props)

Method Summary

Modifier and Type	Method	Description
AddToResourcePolicyResult	addToResourcePolicy(PolicyStatement statement)	Adds a statement to the resource policy associated with this rest api.
String	getRestApiId()	The ID of this API Gateway RestApi.
String	getRestApiRootResourceId()	The resource ID of the root resource.
IResource	getRoot()	Represents the root resource of this API endpoint ('/').

Methods inherited from class software.amazon.awscdk.services.apigateway.RestApiBase

addApiKey, addApiKey, addDomainName, addGatewayResponse, addUsagePlan, addUsagePlan, arnForExecuteApi, arnForExecuteApi, arnForExecuteApi, arnForExecuteApi, getCloudWatchAccount, getDeploymentStage, getDomainName, getLatestDeployment, getResourcePolicy, getRestApiName, getRestApiRef, getUrl, grantInvokeFromVpcEndpointsOnly, metric, metric, metricCacheHitCount, metricCacheHitCount, metricCacheMissCount, metricCacheMissCount, metricClientError, metricClientError, metricCount, metricCount, metricIntegrationLatency, metricIntegrationLatency, metricLatency, metricLatency, metricServerError, metricServerError, setCloudWatchAccount, setDeploymentStage, setResourcePolicy, urlForPath, urlForPath

Methods inherited from class software.amazon.awscdk.Resource

applyRemovalPolicy, generatePhysicalName, getEnv, getPhysicalName, getResourceArnAttribute, getResourceNameAttribute, getStack, isOwnedResource, isResource

Methods inherited from class software.constructs.Construct

getNode, isConstruct, toString

Methods inherited from class software.amazon.jsii.JsiiObject

jsiiAsyncCall, jsiiAsyncCall, jsiiCall, jsiiCall, jsiiGet, jsiiGet, jsiiSet, jsiiStaticCall, jsiiStaticCall, jsiiStaticGet, jsiiStaticGet, jsiiStaticSet, jsiiStaticSet

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Methods inherited from interface software.amazon.awscdk.IResource

applyRemovalPolicy, getStack

Methods inherited from interface software.amazon.awscdk.services.iam.IResourceWithPolicy

getEnv

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

getEnv, getNode

Methods inherited from interface software.amazon.jsii.JsiiSerializable

$jsii$toJson

Field Details

PROPERTY_INJECTION_ID

@Stability(Stable)
public static final String PROPERTY_INJECTION_ID

Uniquely identifies this class.

Constructor Details

SpecRestApi

protected SpecRestApi(software.amazon.jsii.JsiiObjectRef objRef)

SpecRestApi

protected SpecRestApi(software.amazon.jsii.JsiiObject.InitializationMode initializationMode)

SpecRestApi

@Stability(Stable)
public SpecRestApi(@NotNull
 software.constructs.Construct scope,
 @NotNull
 String id,
 @NotNull
 SpecRestApiProps props)

Parameters:

scope - This parameter is required.

id - This parameter is required.

props - This parameter is required.

Method Details

addToResourcePolicy

@Stability(Stable)
@NotNull
public AddToResourcePolicyResult addToResourcePolicy(@NotNull
 PolicyStatement statement)

Adds a statement to the resource policy associated with this rest api.

A resource policy will be automatically created upon the first call to addToResourcePolicy.

Note that this does not work with imported rest api.

Specified by:

addToResourcePolicy in interface IResourceWithPolicyV2

Specified by:

addToResourcePolicy in class RestApiBase

Parameters:

statement - The policy statement to add. This parameter is required.

getRestApiId

@Stability(Stable)
@NotNull
public String getRestApiId()

The ID of this API Gateway RestApi.

Specified by:

getRestApiId in interface IRestApi

Specified by:

getRestApiId in class RestApiBase

getRestApiRootResourceId

@Stability(Stable)
@NotNull
public String getRestApiRootResourceId()

The resource ID of the root resource.

Specified by:

getRestApiRootResourceId in interface IRestApi

Specified by:

getRestApiRootResourceId in class RestApiBase

getRoot

@Stability(Stable)
@NotNull
public IResource getRoot()

Represents the root resource of this API endpoint ('/').

Resources and Methods are added to this resource.

Specified by:

getRoot in interface IRestApi

Specified by:

getRoot in class RestApiBase