software.amazon.awscdk.services.apigatewayv2

Interface HttpApiProps

All Superinterfaces:

software.amazon.jsii.JsiiSerializable

All Known Implementing Classes:

HttpApiProps.Jsii$Proxy

@Generated(value="jsii-pacmak/1.67.0 (build 2c027f5)",
           date="2022-09-07T23:46:59.807Z")
 @Stability(value=Experimental)
public interface HttpApiProps
extends software.amazon.jsii.JsiiSerializable

(experimental) Properties to initialize an instance of `HttpApi`.

Example:

 import software.amazon.awscdk.services.apigatewayv2.integrations.HttpAlbIntegration;
 ApplicationLoadBalancer lb;
 ApplicationListener listener = lb.addListener("listener", BaseApplicationListenerProps.builder().port(80).build());
 listener.addTargets("target", AddApplicationTargetsProps.builder()
         .port(80)
         .build());
 HttpApi httpEndpoint = HttpApi.Builder.create(this, "HttpProxyPrivateApi")
         .defaultIntegration(HttpAlbIntegration.Builder.create("DefaultIntegration", listener)
                 .parameterMapping(new ParameterMapping().custom("myKey", "myValue"))
                 .build())
         .build();
 

Nested Class Summary

Nested Classes

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

Method Summary

Modifier and Type	Method and Description
static HttpApiProps.Builder	builder()
default String	getApiName() (experimental) Name for the HTTP API resource.
default CorsPreflightOptions	getCorsPreflight() (experimental) Specifies a CORS configuration for an API.
default Boolean	getCreateDefaultStage() (experimental) Whether a default stage and deployment should be automatically created.
default List<String>	getDefaultAuthorizationScopes() (experimental) Default OIDC scopes attached to all routes in the gateway, unless explicitly configured on the route.
default IHttpRouteAuthorizer	getDefaultAuthorizer() (experimental) Default Authorizer to applied to all routes in the gateway.
default DomainMappingOptions	getDefaultDomainMapping() (experimental) Configure a custom domain with the API mapping resource to the HTTP API.
default HttpRouteIntegration	getDefaultIntegration() (experimental) An integration that will be configured on the catch-all route ($default).
default String	getDescription() (experimental) The description of the API.
default Boolean	getDisableExecuteApiEndpoint() (experimental) Specifies whether clients can invoke your API using the default endpoint.

Methods inherited from interface software.amazon.jsii.JsiiSerializable

$jsii$toJson

Method Detail

getApiName

@Stability(value=Experimental)
 @Nullable
default String getApiName()

(experimental) Name for the HTTP API resource.

Default: - id of the HttpApi construct.

getCorsPreflight

@Stability(value=Experimental)
 @Nullable
default CorsPreflightOptions getCorsPreflight()

(experimental) Specifies a CORS configuration for an API.

Default: - CORS disabled.

See Also:

https://docs.aws.amazon.com/apigateway/latest/developerguide/http-api-cors.html

getCreateDefaultStage

@Stability(value=Experimental)
 @Nullable
default Boolean getCreateDefaultStage()

(experimental) Whether a default stage and deployment should be automatically created.

Default: true

getDefaultAuthorizationScopes

@Stability(value=Experimental)
 @Nullable
default List<String> getDefaultAuthorizationScopes()

(experimental) Default OIDC scopes attached to all routes in the gateway, unless explicitly configured on the route.

Default: - no default authorization scopes

getDefaultAuthorizer

@Stability(value=Experimental)
 @Nullable
default IHttpRouteAuthorizer getDefaultAuthorizer()

(experimental) Default Authorizer to applied to all routes in the gateway.

Default: - No authorizer

getDefaultDomainMapping

@Stability(value=Experimental)
 @Nullable
default DomainMappingOptions getDefaultDomainMapping()

(experimental) Configure a custom domain with the API mapping resource to the HTTP API.

Default: - no default domain mapping configured. meaningless if `createDefaultStage` is `false`.

getDefaultIntegration

@Stability(value=Experimental)
 @Nullable
default HttpRouteIntegration getDefaultIntegration()

(experimental) An integration that will be configured on the catch-all route ($default).

Default: - none

getDescription

@Stability(value=Experimental)
 @Nullable
default String getDescription()

(experimental) The description of the API.

Default: - none

getDisableExecuteApiEndpoint

@Stability(value=Experimental)
 @Nullable
default Boolean getDisableExecuteApiEndpoint()

(experimental) Specifies whether clients can invoke your API using the default endpoint.

By default, clients can invoke your API with the default https://{api_id}.execute-api.{region}.amazonaws.com endpoint. Enable this if you would like clients to use your custom domain name.

Default: false execute-api endpoint enabled.

builder

@Stability(value=Experimental)
static HttpApiProps.Builder builder()

Returns:

a HttpApiProps.Builder of HttpApiProps