software.amazon.awscdk.services.apigateway

Interface DeploymentProps

All Superinterfaces:

software.amazon.jsii.JsiiSerializable

All Known Implementing Classes:

DeploymentProps.Jsii$Proxy

@Generated(value="jsii-pacmak/1.67.0 (build 2c027f5)",
           date="2022-09-19T20:26:36.158Z")
 @Stability(value=Stable)
public interface DeploymentProps
extends software.amazon.jsii.JsiiSerializable

Example:

 // production stage
 LogGroup prdLogGroup = new LogGroup(this, "PrdLogs");
 RestApi api = RestApi.Builder.create(this, "books")
         .deployOptions(StageOptions.builder()
                 .accessLogDestination(new LogGroupLogDestination(prdLogGroup))
                 .accessLogFormat(AccessLogFormat.jsonWithStandardFields())
                 .build())
         .build();
 Deployment deployment = Deployment.Builder.create(this, "Deployment").api(api).build();
 // development stage
 LogGroup devLogGroup = new LogGroup(this, "DevLogs");
 Stage.Builder.create(this, "dev")
         .deployment(deployment)
         .accessLogDestination(new LogGroupLogDestination(devLogGroup))
         .accessLogFormat(AccessLogFormat.jsonWithStandardFields(JsonWithStandardFieldProps.builder()
                 .caller(false)
                 .httpMethod(true)
                 .ip(true)
                 .protocol(true)
                 .requestTime(true)
                 .resourcePath(true)
                 .responseLength(true)
                 .status(true)
                 .user(true)
                 .build()))
         .build();
 

Nested Class Summary

Nested Classes

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

Method Summary

Modifier and Type	Method and Description
static DeploymentProps.Builder	builder()
IRestApi	getApi() The Rest API to deploy.
default String	getDescription() A description of the purpose of the API Gateway deployment.
default Boolean	getRetainDeployments() When an API Gateway model is updated, a new deployment will automatically be created.

Methods inherited from interface software.amazon.jsii.JsiiSerializable

$jsii$toJson

Method Detail

getApi

@Stability(value=Stable)
 @NotNull
IRestApi getApi()

The Rest API to deploy.

getDescription

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

A description of the purpose of the API Gateway deployment.

Default: - No description.

getRetainDeployments

@Stability(value=Stable)
 @Nullable
default Boolean getRetainDeployments()

When an API Gateway model is updated, a new deployment will automatically be created.

If this is true, the old API Gateway Deployment resource will not be deleted. This will allow manually reverting back to a previous deployment in case for example

Default: false

builder

@Stability(value=Stable)
static DeploymentProps.Builder builder()

Returns:

a DeploymentProps.Builder of DeploymentProps