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.67.0 (build 2c027f5)",
           date="2022-09-19T20:26:36.162Z")
 @Stability(value=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(
                 "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 and Description
static class	GatewayResponseOptions.Builder A builder for GatewayResponseOptions
static class	GatewayResponseOptions.Jsii$Proxy An implementation for GatewayResponseOptions

Method Summary

Modifier and Type	Method and 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 Detail

getType

@Stability(value=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(value=Stable)
 @Nullable
default Map<String,String> getResponseHeaders()

Custom headers parameters for response.

Default: - no headers

getStatusCode

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

Http status code for response.

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

getTemplates

@Stability(value=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(value=Stable)
static GatewayResponseOptions.Builder builder()

Returns:

a GatewayResponseOptions.Builder of GatewayResponseOptions