software.amazon.awscdk.services.apigatewayv2

Interface IHttpStage.Jsii$Default

All Superinterfaces:

software.constructs.IConstruct, software.constructs.IConstruct.Jsii$Default, IDependable, 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.IHttpStage

IHttpStage.Jsii$Default, IHttpStage.Jsii$Proxy

Method Summary

Modifier and Type	Method and Description
default IHttpApi	getApi() (experimental) The API this stage is associated to.
default ResourceEnvironment	getEnv() (experimental) The environment this resource belongs to.
default ConstructNode	getNode() (experimental) The construct tree node for this construct.
default Stack	getStack() (experimental) 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.IStage

metric, metricClientError, metricCount, metricDataProcessed, metricIntegrationLatency, metricLatency, metricServerError

Methods inherited from interface software.amazon.jsii.JsiiSerializable

$jsii$toJson

Method Detail

getNode

@Stability(value=Experimental)
 @NotNull
default ConstructNode getNode()

(experimental) The construct tree node for this construct.

Specified by:

getNode in interface IResource.Jsii$Default

Specified by:

getNode in interface IStage.Jsii$Default

getEnv

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

(experimental) 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=Experimental)
 @NotNull
default Stack getStack()

(experimental) 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

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 IStage

Specified by:

metricClientError in interface IStage.Jsii$Default

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 IStage

Specified by:

metricCount in interface IStage.Jsii$Default

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 IStage

Specified by:

metricDataProcessed in interface IStage.Jsii$Default

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 IStage

Specified by:

metricIntegrationLatency in interface IStage.Jsii$Default

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 IStage

Specified by:

metricLatency in interface IStage.Jsii$Default

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 IStage

Specified by:

metricServerError in interface IStage.Jsii$Default

Parameters:

props -