software.amazon.awscdk.services.apigatewayv2

Class WebSocketStage

java.lang.Object

software.constructs.Construct

software.amazon.awscdk.core.Construct

software.amazon.awscdk.core.Resource

software.amazon.awscdk.services.apigatewayv2.WebSocketStage

All Implemented Interfaces:

IConstruct, IDependable, IResource, IStage, IWebSocketStage

@Generated(value="jsii-pacmak/1.58.0 (build f8ba112)",
           date="2022-05-20T22:20:02.328Z")
public class WebSocketStage
extends Resource
implements IWebSocketStage, IStage

(experimental) Represents a stage where an instance of the API is deployed.

Example:

 import software.amazon.awscdk.services.apigatewayv2.integrations.WebSocketLambdaIntegration;
 Function messageHandler;
 WebSocketApi webSocketApi = new WebSocketApi(this, "mywsapi");
 WebSocketStage.Builder.create(this, "mystage")
         .webSocketApi(webSocketApi)
         .stageName("dev")
         .autoDeploy(true)
         .build();
 webSocketApi.addRoute("sendmessage", WebSocketRouteOptions.builder()
         .integration(new WebSocketLambdaIntegration("SendMessageIntegration", messageHandler))
         .build());
 

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	WebSocketStage.Builder (experimental) A fluent builder for WebSocketStage.

Nested classes/interfaces inherited from interface software.amazon.awscdk.services.apigatewayv2.IWebSocketStage

IWebSocketStage.Jsii$Default, IWebSocketStage.Jsii$Proxy

Constructor Summary

Constructors

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

Method Summary

Modifier and Type	Method and Description
static IWebSocketStage	fromWebSocketStageAttributes(software.constructs.Construct scope, java.lang.String id, WebSocketStageAttributes attrs) (experimental) Import an existing stage into this CDK app.
IWebSocketApi	getApi() (experimental) The API this stage is associated to.
protected IApi	getBaseApi()
java.lang.String	getCallbackUrl() (experimental) The callback URL to this stage.
java.lang.String	getStageName() (experimental) The name of the stage;
java.lang.String	getUrl() (experimental) The websocket URL to this stage.
Grant	grantManagementApiAccess(IGrantable identity) (experimental) Grant access to the API Gateway management API for this WebSocket API Stage to an IAM principal (Role/Group/User).
Metric	metric(java.lang.String metricName) (experimental) Return the given named metric for this HTTP Api Gateway Stage.
Metric	metric(java.lang.String metricName, MetricOptions props) (experimental) Return the given named metric for this HTTP Api Gateway Stage.

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

WebSocketStage

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

WebSocketStage

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

WebSocketStage

public WebSocketStage(software.constructs.Construct scope,
                      java.lang.String id,
                      WebSocketStageProps props)

Parameters:

scope - This parameter is required.

id - This parameter is required.

props - This parameter is required.

Method Detail

fromWebSocketStageAttributes

public static IWebSocketStage fromWebSocketStageAttributes(software.constructs.Construct scope,
                                                           java.lang.String id,
                                                           WebSocketStageAttributes attrs)

(experimental) Import an existing stage into this CDK app.

Parameters:

scope - This parameter is required.

id - This parameter is required.

attrs - This parameter is required.

grantManagementApiAccess

public Grant grantManagementApiAccess(IGrantable identity)

(experimental) Grant access to the API Gateway management API for this WebSocket API Stage to an IAM principal (Role/Group/User).

Parameters:

identity - The principal. This parameter is required.

metric

public Metric metric(java.lang.String metricName,
                     MetricOptions props)

(experimental) Return the given named metric for this HTTP Api Gateway Stage.

Specified by:

metric in interface IStage

Parameters:

metricName - This parameter is required.

props -

metric

public Metric metric(java.lang.String metricName)

(experimental) Return the given named metric for this HTTP Api Gateway Stage.

Specified by:

metric in interface IStage

Parameters:

metricName - This parameter is required.

getApi

public IWebSocketApi getApi()

(experimental) The API this stage is associated to.

Specified by:

getApi in interface IWebSocketStage

getBaseApi

protected IApi getBaseApi()

getCallbackUrl

public java.lang.String getCallbackUrl()

(experimental) The callback URL to this stage.

Specified by:

getCallbackUrl in interface IWebSocketStage

getStageName

public java.lang.String getStageName()

(experimental) The name of the stage;

its primary identifier.

Specified by:

getStageName in interface IStage

getUrl

public java.lang.String getUrl()

(experimental) The websocket URL to this stage.

Specified by:

getUrl in interface IStage