software.amazon.awscdk.services.apigatewayv2.alpha

Interface IHttpStage.Jsii$Default

All Superinterfaces:

software.constructs.IConstruct, software.constructs.IConstruct.Jsii$Default, software.constructs.IDependable, software.constructs.IDependable.Jsii$Default, IHttpStage, IResource, IResource.Jsii$Default, IStage, IStage.Jsii$Default, software.amazon.jsii.JsiiSerializable

All Known Implementing Classes:

IHttpStage.Jsii$Proxy

Enclosing interface:

IHttpStage

@Internal
public static interface IHttpStage.Jsii$Default
extends IHttpStage, IStage.Jsii$Default

Internal default implementation for IHttpStage.

Nested Class Summary

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

IHttpStage.Jsii$Default, IHttpStage.Jsii$Proxy

Method Summary

Modifier and Type	Method and Description
default void	applyRemovalPolicy(RemovalPolicy policy) Apply the given removal policy to this resource.
default IHttpApi	getApi() (experimental) The API this stage is associated to.
default String	getDomainUrl() (experimental) The custom domain URL to this stage.
default ResourceEnvironment	getEnv() The environment this resource belongs to.
default software.constructs.Node	getNode() The tree node.
default Stack	getStack() The stack in which this resource is defined.
default String	getStageName() (experimental) The name of the stage;
default String	getUrl() (experimental) The URL to this stage.
default Metric	metric(String metricName, MetricOptions props) (experimental) Return the given named metric for this HTTP Api Gateway Stage.
default Metric	metricClientError(MetricOptions props) (experimental) Metric for the number of client-side errors captured in a given period.
default Metric	metricCount(MetricOptions props) (experimental) Metric for the total number API requests in a given period.
default Metric	metricDataProcessed(MetricOptions props) (experimental) Metric for the amount of data processed in bytes.
default Metric	metricIntegrationLatency(MetricOptions props) (experimental) Metric for the time between when API Gateway relays a request to the backend and when it receives a response from the backend.
default Metric	metricLatency(MetricOptions props) (experimental) The time between when API Gateway receives a request from a client and when it returns a response to the client.
default Metric	metricServerError(MetricOptions props) (experimental) Metric for the number of server-side errors captured in a given period.

Methods inherited from interface software.amazon.awscdk.services.apigatewayv2.alpha.IHttpStage

metricClientError, metricCount, metricDataProcessed, metricIntegrationLatency, metricLatency, metricServerError

Methods inherited from interface software.amazon.awscdk.services.apigatewayv2.alpha.IStage

metric

Methods inherited from interface software.amazon.jsii.JsiiSerializable

$jsii$toJson

Method Detail

getNode

@Stability(value=Stable)
 @NotNull
default software.constructs.Node getNode()

The tree node.

Specified by:

getNode in interface software.constructs.IConstruct

Specified by:

getNode in interface software.constructs.IConstruct.Jsii$Default

Specified by:

getNode in interface IResource.Jsii$Default

Specified by:

getNode in interface IStage.Jsii$Default

getEnv

@Stability(value=Stable)
 @NotNull
default ResourceEnvironment getEnv()

The environment this resource belongs to.

For resources that are created and managed by the CDK (generally, those created by creating new class instances like Role, Bucket, etc.), this is always the same as the environment of the stack they belong to; however, for imported resources (those obtained from static methods like fromRoleArn, fromBucketName, etc.), that might be different than the stack they were imported into.

Specified by:

getEnv in interface IResource

Specified by:

getEnv in interface IResource.Jsii$Default

Specified by:

getEnv in interface IStage.Jsii$Default

getStack

@Stability(value=Stable)
 @NotNull
default Stack getStack()

The stack in which this resource is defined.

Specified by:

getStack in interface IResource

Specified by:

getStack in interface IResource.Jsii$Default

Specified by:

getStack in interface IStage.Jsii$Default

getStageName

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

(experimental) The name of the stage;

its primary identifier.

Specified by:

getStageName in interface IStage

Specified by:

getStageName in interface IStage.Jsii$Default

getUrl

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

(experimental) The URL to this stage.

Specified by:

getUrl in interface IStage

Specified by:

getUrl in interface IStage.Jsii$Default

getApi

@Stability(value=Experimental)
 @NotNull
default IHttpApi getApi()

(experimental) The API this stage is associated to.

Specified by:

getApi in interface IHttpStage

getDomainUrl

@Stability(value=Experimental)
 @NotNull
default String getDomainUrl()

(experimental) The custom domain URL to this stage.

Specified by:

getDomainUrl in interface IHttpStage

applyRemovalPolicy

@Stability(value=Stable)
default void applyRemovalPolicy(@NotNull
                                                         RemovalPolicy policy)

Apply the given removal policy to this resource.

The Removal Policy controls what happens to this resource when it stops being managed by CloudFormation, either because you've removed it from the CDK application or because you've made a change that requires the resource to be replaced.

The resource can be deleted (RemovalPolicy.DESTROY), or left in your AWS account for data recovery and cleanup later (RemovalPolicy.RETAIN).

Specified by:

applyRemovalPolicy in interface IResource

Specified by:

applyRemovalPolicy in interface IResource.Jsii$Default

Specified by:

applyRemovalPolicy in interface IStage.Jsii$Default

Parameters:

policy - This parameter is required.

metric

@Stability(value=Experimental)
 @NotNull
default Metric metric(@NotNull
                                                               String metricName,
                                                               @Nullable
                                                               MetricOptions props)

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

Default: - average over 5 minutes

Specified by:

metric in interface IStage

Specified by:

metric in interface IStage.Jsii$Default

Parameters:

metricName - This parameter is required.

props -

metricClientError

@Stability(value=Experimental)
 @NotNull
default Metric metricClientError(@Nullable
                                                                          MetricOptions props)

(experimental) Metric for the number of client-side errors captured in a given period.

Default: - sum over 5 minutes

Specified by:

metricClientError in interface IHttpStage

Parameters:

props -

metricCount

@Stability(value=Experimental)
 @NotNull
default Metric metricCount(@Nullable
                                                                    MetricOptions props)

(experimental) Metric for the total number API requests in a given period.

Default: - SampleCount over 5 minutes

Specified by:

metricCount in interface IHttpStage

Parameters:

props -

metricDataProcessed

@Stability(value=Experimental)
 @NotNull
default Metric metricDataProcessed(@Nullable
                                                                            MetricOptions props)

(experimental) Metric for the amount of data processed in bytes.

Default: - sum over 5 minutes

Specified by:

metricDataProcessed in interface IHttpStage

Parameters:

props -

metricIntegrationLatency

@Stability(value=Experimental)
 @NotNull
default Metric metricIntegrationLatency(@Nullable
                                                                                 MetricOptions props)

(experimental) Metric for the time between when API Gateway relays a request to the backend and when it receives a response from the backend.

Default: - no statistic

Specified by:

metricIntegrationLatency in interface IHttpStage

Parameters:

props -

metricLatency

@Stability(value=Experimental)
 @NotNull
default Metric metricLatency(@Nullable
                                                                      MetricOptions props)

(experimental) The time between when API Gateway receives a request from a client and when it returns a response to the client.

The latency includes the integration latency and other API Gateway overhead.

Default: - no statistic

Specified by:

metricLatency in interface IHttpStage

Parameters:

props -

metricServerError

@Stability(value=Experimental)
 @NotNull
default Metric metricServerError(@Nullable
                                                                          MetricOptions props)

(experimental) Metric for the number of server-side errors captured in a given period.

Default: - sum over 5 minutes

Specified by:

metricServerError in interface IHttpStage

Parameters:

props -