software.amazon.awscdk.services.apigatewayv2

Class HttpRoute

java.lang.Object

software.constructs.Construct

software.amazon.awscdk.core.Construct

software.amazon.awscdk.core.Resource

software.amazon.awscdk.services.apigatewayv2.HttpRoute

All Implemented Interfaces:

IConstruct, IDependable, IResource, IHttpRoute, IRoute

@Generated(value="jsii-pacmak/1.67.0 (build 2c027f5)",
           date="2022-09-21T22:31:06.379Z")
public class HttpRoute
extends Resource
implements IHttpRoute

(experimental) 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 and Description
static class	HttpRoute.Builder (experimental) A fluent builder for HttpRoute.

Nested classes/interfaces inherited from interface software.amazon.awscdk.services.apigatewayv2.IHttpRoute

IHttpRoute.Jsii$Default, IHttpRoute.Jsii$Proxy

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	HttpRoute(software.amazon.jsii.JsiiObject.InitializationMode initializationMode)
protected	HttpRoute(software.amazon.jsii.JsiiObjectRef objRef)
	HttpRoute(software.constructs.Construct scope, java.lang.String id, HttpRouteProps props)

Method Summary

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

Methods inherited from class software.amazon.awscdk.core.Resource

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

Methods inherited from class software.amazon.awscdk.core.Construct

getNode, isConstruct, onPrepare, onSynthesize, onValidate, prepare, synthesize, validate

Methods inherited from class java.lang.Object

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

Methods inherited from interface software.amazon.awscdk.core.IResource

applyRemovalPolicy, getEnv, getStack

Methods inherited from interface software.amazon.awscdk.core.IConstruct

getNode

Constructor Detail

HttpRoute

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

HttpRoute

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

HttpRoute

public HttpRoute(software.constructs.Construct scope,
                 java.lang.String id,
                 HttpRouteProps props)

Parameters:

scope - This parameter is required.

id - This parameter is required.

props - This parameter is required.

Method Detail

grantInvoke

public Grant grantInvoke(IGrantable grantee,
                         GrantInvokeOptions options)

(experimental) 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

public Grant grantInvoke(IGrantable grantee)

(experimental) 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

public IHttpApi getHttpApi()

(experimental) The HTTP API associated with this route.

Specified by:

getHttpApi in interface IHttpRoute

getRouteArn

public java.lang.String getRouteArn()

(experimental) Returns the arn of the route.

Specified by:

getRouteArn in interface IHttpRoute

getRouteId

public java.lang.String getRouteId()

(experimental) Id of the Route.

Specified by:

getRouteId in interface IRoute

getPath

public java.lang.String getPath()

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

Specified by:

getPath in interface IHttpRoute