Package software.amazon.awscdk.services.apigatewayv2

Class HttpRoute

java.lang.Object

software.amazon.jsii.JsiiObject

software.constructs.Construct

software.amazon.awscdk.Resource

software.amazon.awscdk.services.apigatewayv2.HttpRoute

All Implemented Interfaces:

IEnvironmentAware, IResource, IHttpRoute, IRoute, software.amazon.jsii.JsiiSerializable, software.constructs.IConstruct, software.constructs.IDependable

@Generated(value="jsii-pacmak/1.119.0 (build 1634eac)",
           date="2025-11-13T16:09:58.076Z")
@Stability(Stable)
public class HttpRoute
extends Resource
implements IHttpRoute

Route class that creates the Route for API Gateway HTTP API.

Example:

 // The code below shows an example of how to instantiate this type.
 // The values are placeholders you should change.
 import software.amazon.awscdk.services.apigatewayv2.*;
 HttpApi httpApi;
 IHttpRouteAuthorizer httpRouteAuthorizer;
 HttpRouteIntegration httpRouteIntegration;
 HttpRouteKey httpRouteKey;
 HttpRoute httpRoute = HttpRoute.Builder.create(this, "MyHttpRoute")
         .httpApi(httpApi)
         .integration(httpRouteIntegration)
         .routeKey(httpRouteKey)
         // the properties below are optional
         .authorizationScopes(List.of("authorizationScopes"))
         .authorizer(httpRouteAuthorizer)
         .build();
 

Nested Class Summary

Nested Classes

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

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.services.apigatewayv2.IHttpRoute

IHttpRoute.Jsii$Default, IHttpRoute.Jsii$Proxy

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

IResource.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	HttpRoute(software.amazon.jsii.JsiiObject.InitializationMode initializationMode)
protected	HttpRoute(software.amazon.jsii.JsiiObjectRef objRef)
	HttpRoute(software.constructs.Construct scope, String id, HttpRouteProps props)

Method Summary

Modifier and Type	Method	Description
IHttpApi	getHttpApi()	The HTTP API associated with this route.
String	getPath()	Returns the path component of this HTTP route, undefined if the path is the catch-all route.
String	getRouteArn()	Returns the arn of the route.
String	getRouteId()	Id of the Route.
Grant	grantInvoke(IGrantable grantee)	Grant access to invoke the route.
Grant	grantInvoke(IGrantable grantee, GrantInvokeOptions options)	Grant access to invoke the route.

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.constructs.IConstruct

getNode

Methods inherited from interface software.amazon.awscdk.interfaces.IEnvironmentAware

getEnv

Methods inherited from interface software.amazon.awscdk.IResource

applyRemovalPolicy, getStack

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

HttpRoute

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

HttpRoute

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

HttpRoute

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

Parameters:

scope - This parameter is required.

id - This parameter is required.

props - This parameter is required.

Method Details

grantInvoke

@Stability(Stable)
@NotNull
public Grant grantInvoke(@NotNull
 IGrantable grantee,
 @Nullable
 GrantInvokeOptions options)

Grant access to invoke the route.

This method requires that the authorizer of the route is undefined or is an HttpIamAuthorizer.

Specified by:

grantInvoke in interface IHttpRoute

Parameters:

grantee - This parameter is required.

options -

grantInvoke

@Stability(Stable)
@NotNull
public Grant grantInvoke(@NotNull
 IGrantable grantee)

Grant access to invoke the route.

This method requires that the authorizer of the route is undefined or is an HttpIamAuthorizer.

Specified by:

grantInvoke in interface IHttpRoute

Parameters:

grantee - This parameter is required.

getHttpApi

@Stability(Stable)
@NotNull
public IHttpApi getHttpApi()

The HTTP API associated with this route.

Specified by:

getHttpApi in interface IHttpRoute

getRouteArn

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

Returns the arn of the route.

Specified by:

getRouteArn in interface IHttpRoute

getRouteId

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

Id of the Route.

Specified by:

getRouteId in interface IRoute

getPath

@Stability(Stable)
@Nullable
public String getPath()

Returns the path component of this HTTP route, undefined if the path is the catch-all route.

Specified by:

getPath in interface IHttpRoute