software.amazon.awscdk.services.apigateway

Class Stage

java.lang.Object

software.constructs.Construct

software.amazon.awscdk.core.Construct

software.amazon.awscdk.core.Resource

software.amazon.awscdk.services.apigateway.Stage

All Implemented Interfaces:

IConstruct, IDependable, IResource, IStage

@Generated(value="jsii-pacmak/1.73.0 (build 6faeda3)",
           date="2023-01-31T18:36:58.331Z")
public class Stage
extends Resource
implements IStage

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	Class and Description
static class	Stage.Builder A fluent builder for Stage.

Nested classes/interfaces inherited from interface software.amazon.awscdk.services.apigateway.IStage

IStage.Jsii$Default, IStage.Jsii$Proxy

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	Stage(software.amazon.jsii.JsiiObject.InitializationMode initializationMode)
protected	Stage(software.amazon.jsii.JsiiObjectRef objRef)
	Stage(software.constructs.Construct scope, java.lang.String id, StageProps props)

Method Summary

Modifier and Type	Method and Description
IRestApi	getRestApi() RestApi to which this stage is associated.
java.lang.String	getStageArn() Returns the resource ARN for this stage:.
java.lang.String	getStageName() Name of this stage.
java.lang.String	urlForPath() Returns the invoke URL for a certain path.
java.lang.String	urlForPath(java.lang.String path) Returns the invoke URL for a certain path.

Methods inherited from class software.amazon.awscdk.core.Resource

applyRemovalPolicy, generatePhysicalName, getEnv, getPhysicalName, getResourceArnAttribute, getResourceNameAttribute, getStack, isResource

Methods inherited from class software.amazon.awscdk.core.Construct

getNode, isConstruct, onPrepare, onSynthesize, onValidate, prepare, synthesize, validate

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface software.amazon.awscdk.core.IResource

applyRemovalPolicy, getEnv, getStack

Methods inherited from interface software.amazon.awscdk.core.IConstruct

getNode

Constructor Detail

Stage

protected Stage(software.amazon.jsii.JsiiObjectRef objRef)

Stage

protected Stage(software.amazon.jsii.JsiiObject.InitializationMode initializationMode)

Stage

public Stage(software.constructs.Construct scope,
             java.lang.String id,
             StageProps props)

Parameters:

scope - This parameter is required.

id - This parameter is required.

props - This parameter is required.

Method Detail

urlForPath

public java.lang.String urlForPath(java.lang.String path)

Returns the invoke URL for a certain path.

Parameters:

path - The resource path.

urlForPath

public java.lang.String urlForPath()

Returns the invoke URL for a certain path.

getRestApi

public IRestApi getRestApi()

RestApi to which this stage is associated.

Specified by:

getRestApi in interface IStage

getStageArn

public java.lang.String getStageArn()

Returns the resource ARN for this stage:.

arn:aws:apigateway:{region}::/restapis/{restApiId}/stages/{stageName}

Note that this is separate from the execute-api ARN for methods and resources within this stage.

getStageName

public java.lang.String getStageName()

Name of this stage.

Specified by:

getStageName in interface IStage