Package software.amazon.awscdk.services.apigatewayv2

Interface AddRoutesOptions

All Superinterfaces:

BatchHttpRouteOptions, software.amazon.jsii.JsiiSerializable

All Known Implementing Classes:

AddRoutesOptions.Jsii$Proxy

@Generated(value="jsii-pacmak/1.119.0 (build 1634eac)",
           date="2025-11-13T16:09:57.969Z")
@Stability(Stable)
public interface AddRoutesOptions
extends software.amazon.jsii.JsiiSerializable, BatchHttpRouteOptions

Options for the Route with Integration resource.

Example:

 import software.amazon.awscdk.aws_apigatewayv2_integrations.HttpUrlIntegration;
 import software.amazon.awscdk.aws_apigatewayv2_integrations.HttpLambdaIntegration;
 Function bookStoreDefaultFn;
 HttpUrlIntegration getBooksIntegration = new HttpUrlIntegration("GetBooksIntegration", "https://get-books-proxy.example.com");
 HttpLambdaIntegration bookStoreDefaultIntegration = new HttpLambdaIntegration("BooksIntegration", bookStoreDefaultFn);
 HttpApi httpApi = new HttpApi(this, "HttpApi");
 httpApi.addRoutes(AddRoutesOptions.builder()
         .path("/books")
         .methods(List.of(HttpMethod.GET))
         .integration(getBooksIntegration)
         .build());
 httpApi.addRoutes(AddRoutesOptions.builder()
         .path("/books")
         .methods(List.of(HttpMethod.ANY))
         .integration(bookStoreDefaultIntegration)
         .build());
 

Nested Class Summary

Nested Classes

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

Method Summary

Modifier and Type	Method	Description
static AddRoutesOptions.Builder	builder()
default List<String>	getAuthorizationScopes()	The list of OIDC scopes to include in the authorization.
default IHttpRouteAuthorizer	getAuthorizer()	Authorizer to be associated to these routes.
default List<HttpMethod>	getMethods()	The HTTP methods to be configured.
String	getPath()	The path at which all of these routes are configured.

Methods inherited from interface software.amazon.awscdk.services.apigatewayv2.BatchHttpRouteOptions

getIntegration

Methods inherited from interface software.amazon.jsii.JsiiSerializable

$jsii$toJson

Method Details

getPath

@Stability(Stable)
@NotNull
String getPath()

The path at which all of these routes are configured.

getAuthorizationScopes

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

The list of OIDC scopes to include in the authorization.

These scopes will override the default authorization scopes on the gateway. Set to [] to remove default scopes

Default: - uses defaultAuthorizationScopes if configured on the API, otherwise none.

getAuthorizer

@Stability(Stable)
@Nullable
default IHttpRouteAuthorizer getAuthorizer()

Authorizer to be associated to these routes.

Use NoneAuthorizer to remove the default authorizer for the api

Default: - uses the default authorizer if one is specified on the HttpApi

getMethods

@Stability(Stable)
@Nullable
default List<HttpMethod> getMethods()

The HTTP methods to be configured.

Default: HttpMethod.ANY

builder

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

Returns:

a AddRoutesOptions.Builder of AddRoutesOptions