software.amazon.awscdk.services.apigateway

Interface IRestApi

All Superinterfaces:

software.constructs.IConstruct, software.constructs.IDependable, IResource, software.amazon.jsii.JsiiSerializable

All Known Subinterfaces:

IRestApi.Jsii$Default

All Known Implementing Classes:

IRestApi.Jsii$Proxy, LambdaRestApi, RestApi, RestApiBase, SpecRestApi

@Generated(value="jsii-pacmak/1.29.0 (build 41df200)",
           date="2021-06-02T09:54:56.852Z")
 @Stability(value=Experimental)
public interface IRestApi
extends software.amazon.jsii.JsiiSerializable, IResource

Nested Class Summary

Nested Classes

Modifier and Type	Interface and Description
static interface	IRestApi.Jsii$Default Internal default implementation for IRestApi.
static class	IRestApi.Jsii$Proxy A proxy class which represents a concrete javascript instance of this type.

Method Summary

Modifier and Type	Method and Description
String	arnForExecuteApi() (experimental) Gets the "execute-api" ARN.
String	arnForExecuteApi(String method) (experimental) Gets the "execute-api" ARN.
String	arnForExecuteApi(String method, String path) (experimental) Gets the "execute-api" ARN.
String	arnForExecuteApi(String method, String path, String stage) (experimental) Gets the "execute-api" ARN.
Stage	getDeploymentStage() (experimental) API Gateway stage that points to the latest deployment (if defined).
default Deployment	getLatestDeployment() (experimental) API Gateway deployment that represents the latest changes of the API.
String	getRestApiId() (experimental) The ID of this API Gateway RestApi.
String	getRestApiRootResourceId() (experimental) The resource ID of the root resource.
IResource	getRoot() (experimental) Represents the root resource ("/") of this API.
void	setDeploymentStage(Stage value) (experimental) API Gateway stage that points to the latest deployment (if defined).

Methods inherited from interface software.amazon.awscdk.IResource

getEnv, getStack

Methods inherited from interface software.constructs.IConstruct

getNode

Methods inherited from interface software.amazon.jsii.JsiiSerializable

$jsii$toJson

Method Detail

getRestApiId

@Stability(value=Experimental)
 @NotNull
String getRestApiId()

(experimental) The ID of this API Gateway RestApi.

getRestApiRootResourceId

@Stability(value=Experimental)
 @NotNull
String getRestApiRootResourceId()

(experimental) The resource ID of the root resource.

getRoot

@Stability(value=Experimental)
 @NotNull
IResource getRoot()

(experimental) Represents the root resource ("/") of this API. Use it to define the API model:.

api.root.addMethod('ANY', redirectToHomePage); // "ANY /" api.root.addResource('friends').addMethod('GET', getFriendsHandler); // "GET /friends"

getLatestDeployment

@Stability(value=Experimental)
 @Nullable
default Deployment getLatestDeployment()

(experimental) API Gateway deployment that represents the latest changes of the API.

This resource will be automatically updated every time the REST API model changes. undefined when no deployment is configured.

getDeploymentStage

@Stability(value=Experimental)
 @NotNull
Stage getDeploymentStage()

(experimental) API Gateway stage that points to the latest deployment (if defined).

setDeploymentStage

void setDeploymentStage(@NotNull
                        Stage value)

(experimental) API Gateway stage that points to the latest deployment (if defined).

arnForExecuteApi

@Stability(value=Experimental)
 @NotNull
String arnForExecuteApi(@Nullable
                                                                 String method,
                                                                 @Nullable
                                                                 String path,
                                                                 @Nullable
                                                                 String stage)

(experimental) Gets the "execute-api" ARN.

Default: "*" returns the execute API ARN for all methods/resources in this API.

Parameters:

method - The method (default `*`).

path - The resource path.

stage - The stage (default `*`).

Returns:

The "execute-api" ARN.

arnForExecuteApi

@Stability(value=Experimental)
 @NotNull
String arnForExecuteApi(@Nullable
                                                                 String method,
                                                                 @Nullable
                                                                 String path)

(experimental) Gets the "execute-api" ARN.

Default: "*" returns the execute API ARN for all methods/resources in this API.

Parameters:

method - The method (default `*`).

path - The resource path.

Returns:

The "execute-api" ARN.

arnForExecuteApi

@Stability(value=Experimental)
 @NotNull
String arnForExecuteApi(@Nullable
                                                                 String method)

(experimental) Gets the "execute-api" ARN.

Default: "*" returns the execute API ARN for all methods/resources in this API.

Parameters:

method - The method (default `*`).

Returns:

The "execute-api" ARN.

arnForExecuteApi

@Stability(value=Experimental)
 @NotNull
String arnForExecuteApi()

(experimental) Gets the "execute-api" ARN.

Default: "*" returns the execute API ARN for all methods/resources in this API.

Returns:

The "execute-api" ARN.