Package software.amazon.awscdk.services.apigateway

Interface GatewayResponseOptions

All Superinterfaces:

software.amazon.jsii.JsiiSerializable

All Known Subinterfaces:

GatewayResponseProps

All Known Implementing Classes:

GatewayResponseOptions.Jsii$Proxy, GatewayResponseProps.Jsii$Proxy

@Generated(value="jsii-pacmak/1.116.0 (build 0eddcff)",
           date="2025-10-24T13:34:30.297Z")
@Stability(Stable)
public interface GatewayResponseOptions
extends software.amazon.jsii.JsiiSerializable

Options to add gateway response.

Example:

 RestApi api = new RestApi(this, "books-api");
 api.addGatewayResponse("test-response", GatewayResponseOptions.builder()
         .type(ResponseType.ACCESS_DENIED)
         .statusCode("500")
         .responseHeaders(Map.of(
                 // Note that values must be enclosed within a pair of single quotes
                 "Access-Control-Allow-Origin", "'test.com'",
                 "test-key", "'test-value'"))
         .templates(Map.of(
                 "application/json", "{ \"message\": $context.error.messageString, \"statusCode\": \"488\", \"type\": \"$context.error.responseType\" }"))
         .build());
 

Nested Class Summary

Nested Classes

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

Method Summary

Modifier and Type	Method	Description
static GatewayResponseOptions.Builder	builder()
default Map<String,String>	getResponseHeaders()	Custom headers parameters for response.
default String	getStatusCode()	Http status code for response.
default Map<String,String>	getTemplates()	Custom templates to get mapped as response.
ResponseType	getType()	Response type to associate with gateway response.

Methods inherited from interface software.amazon.jsii.JsiiSerializable

$jsii$toJson

Method Details

getType

@Stability(Stable)
@NotNull
ResponseType getType()

Response type to associate with gateway response.

See Also:

• https://docs.aws.amazon.com/apigateway/latest/developerguide/supported-gateway-response-types.html

getResponseHeaders

@Stability(Stable)
@Nullable
default Map<String,String> getResponseHeaders()

Custom headers parameters for response.

Default: - no headers

getStatusCode

@Stability(Stable)
@Nullable
default String getStatusCode()

Http status code for response.

Default: - standard http status code for the response type.

getTemplates

@Stability(Stable)
@Nullable
default Map<String,String> getTemplates()

Custom templates to get mapped as response.

Default: - Response from api will be returned without applying any transformation.

builder

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

Returns:

a GatewayResponseOptions.Builder of GatewayResponseOptions