software.amazon.awscdk.services.apigateway

Interface DeploymentProps

All Known Implementing Classes:

DeploymentProps.Jsii$Proxy

@Generated(value="jsii-pacmak/1.71.0 (build f1f58ae)",
           date="2022-11-29T04:32:25.313Z")
public interface DeploymentProps

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 java.lang.String	getDescription() A description of the purpose of the API Gateway deployment.
default java.lang.Boolean	getRetainDeployments() When an API Gateway model is updated, a new deployment will automatically be created.

Method Detail

getApi

IRestApi getApi()

The Rest API to deploy.

getDescription

default java.lang.String getDescription()

A description of the purpose of the API Gateway deployment.

Default: - No description.

getRetainDeployments

default java.lang.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

static DeploymentProps.Builder builder()

Returns:

a DeploymentProps.Builder of DeploymentProps