software.amazon.awscdk.services.apigatewayv2.alpha

Class WebSocketStage

java.lang.Object

software.amazon.jsii.JsiiObject

software.constructs.Construct

software.amazon.awscdk.Resource

software.amazon.awscdk.services.apigatewayv2.alpha.WebSocketStage

All Implemented Interfaces:

IResource, IStage, IWebSocketStage, software.amazon.jsii.JsiiSerializable, software.constructs.IConstruct, software.constructs.IDependable

@Generated(value="jsii-pacmak/1.74.0 (build 6d08790)",
           date="2023-02-15T19:53:17.431Z")
 @Stability(value=Experimental)
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.alpha.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 class software.amazon.jsii.JsiiObject

software.amazon.jsii.JsiiObject.InitializationMode

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

IWebSocketStage.Jsii$Default, IWebSocketStage.Jsii$Proxy

Constructor Summary

Constructors

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

Method Summary

Modifier and Type	Method and Description
static IWebSocketStage	fromWebSocketStageAttributes(software.constructs.Construct scope, 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()
String	getCallbackUrl() (experimental) The callback URL to this stage.
String	getStageName() (experimental) The name of the stage;
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(String metricName) (experimental) Return the given named metric for this HTTP Api Gateway Stage.
Metric	metric(String metricName, MetricOptions props) (experimental) Return the given named metric for this HTTP Api Gateway Stage.

Methods inherited from class software.amazon.awscdk.Resource

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

Methods inherited from class software.constructs.Construct

getNode, isConstruct, toString

Methods inherited from class software.amazon.jsii.JsiiObject

jsiiAsyncCall, jsiiAsyncCall, jsiiCall, jsiiCall, jsiiGet, jsiiGet, jsiiSet, jsiiStaticCall, jsiiStaticCall, jsiiStaticGet, jsiiStaticGet, jsiiStaticSet, jsiiStaticSet

Methods inherited from class java.lang.Object

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

Methods inherited from interface software.amazon.awscdk.IResource

applyRemovalPolicy, getEnv, getStack

Methods inherited from interface software.constructs.IConstruct

getNode

Methods inherited from interface software.amazon.jsii.JsiiSerializable

$jsii$toJson

Constructor Detail

WebSocketStage

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

WebSocketStage

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

WebSocketStage

@Stability(value=Experimental)
public WebSocketStage(@NotNull
                                                     software.constructs.Construct scope,
                                                     @NotNull
                                                     String id,
                                                     @NotNull
                                                     WebSocketStageProps props)

Parameters:

scope - This parameter is required.

id - This parameter is required.

props - This parameter is required.

Method Detail

fromWebSocketStageAttributes

@Stability(value=Experimental)
 @NotNull
public static IWebSocketStage fromWebSocketStageAttributes(@NotNull
                                                                                                    software.constructs.Construct scope,
                                                                                                    @NotNull
                                                                                                    String id,
                                                                                                    @NotNull
                                                                                                    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

@Stability(value=Experimental)
 @NotNull
public Grant grantManagementApiAccess(@NotNull
                                                                               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

@Stability(value=Experimental)
 @NotNull
public Metric metric(@NotNull
                                                              String metricName,
                                                              @Nullable
                                                              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

@Stability(value=Experimental)
 @NotNull
public Metric metric(@NotNull
                                                              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

@Stability(value=Experimental)
 @NotNull
public IWebSocketApi getApi()

(experimental) The API this stage is associated to.

Specified by:

getApi in interface IWebSocketStage

getBaseApi

@Stability(value=Experimental)
 @NotNull
protected IApi getBaseApi()

getCallbackUrl

@Stability(value=Experimental)
 @NotNull
public String getCallbackUrl()

(experimental) The callback URL to this stage.

Specified by:

getCallbackUrl in interface IWebSocketStage

getStageName

@Stability(value=Experimental)
 @NotNull
public String getStageName()

(experimental) The name of the stage;

its primary identifier.

Specified by:

getStageName in interface IStage

getUrl

@Stability(value=Experimental)
 @NotNull
public String getUrl()

(experimental) The websocket URL to this stage.

Specified by:

getUrl in interface IStage