software.amazon.awscdk.services.apigatewayv2

Class HttpStage

java.lang.Object

software.constructs.Construct

software.amazon.awscdk.core.Construct

software.amazon.awscdk.core.Resource

software.amazon.awscdk.services.apigatewayv2.HttpStage

All Implemented Interfaces:

IConstruct, IDependable, IResource, IHttpStage, IStage

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

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

Example:

 HttpApi api;
 HttpStage.Builder.create(this, "Stage")
         .httpApi(api)
         .stageName("beta")
         .build();
 

Nested Class Summary

Nested Classes

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

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

IHttpStage.Jsii$Default, IHttpStage.Jsii$Proxy

Constructor Summary

Constructors

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

Method Summary

Modifier and Type	Method and Description
static IHttpStage	fromHttpStageAttributes(software.constructs.Construct scope, java.lang.String id, HttpStageAttributes attrs) (experimental) Import an existing stage into this CDK app.
IHttpApi	getApi() (experimental) The API this stage is associated to.
protected IApi	getBaseApi()
java.lang.String	getDomainUrl() (experimental) The custom domain URL to this stage.
java.lang.String	getStageName() (experimental) The name of the stage;
java.lang.String	getUrl() (experimental) The URL to this stage.
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.
Metric	metricClientError() (experimental) Metric for the number of client-side errors captured in a given period.
Metric	metricClientError(MetricOptions props) (experimental) Metric for the number of client-side errors captured in a given period.
Metric	metricCount() (experimental) Metric for the total number API requests in a given period.
Metric	metricCount(MetricOptions props) (experimental) Metric for the total number API requests in a given period.
Metric	metricDataProcessed() (experimental) Metric for the amount of data processed in bytes.
Metric	metricDataProcessed(MetricOptions props) (experimental) Metric for the amount of data processed in bytes.
Metric	metricIntegrationLatency() (experimental) Metric for the time between when API Gateway relays a request to the backend and when it receives a response from the backend.
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.
Metric	metricLatency() (experimental) The time between when API Gateway receives a request from a client and when it returns a response to the client.
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.
Metric	metricServerError() (experimental) Metric for the number of server-side errors captured in a given period.
Metric	metricServerError(MetricOptions props) (experimental) Metric for the number of server-side errors captured in a given period.

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

HttpStage

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

HttpStage

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

HttpStage

public HttpStage(software.constructs.Construct scope,
                 java.lang.String id,
                 HttpStageProps props)

Parameters:

scope - This parameter is required.

id - This parameter is required.

props - This parameter is required.

Method Detail

fromHttpStageAttributes

public static IHttpStage fromHttpStageAttributes(software.constructs.Construct scope,
                                                 java.lang.String id,
                                                 HttpStageAttributes 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.

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.

metricClientError

public Metric metricClientError(MetricOptions props)

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

Specified by:

metricClientError in interface IHttpStage

Parameters:

props -

metricClientError

public Metric metricClientError()

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

Specified by:

metricClientError in interface IHttpStage

metricCount

public Metric metricCount(MetricOptions props)

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

Specified by:

metricCount in interface IHttpStage

Parameters:

props -

metricCount

public Metric metricCount()

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

Specified by:

metricCount in interface IHttpStage

metricDataProcessed

public Metric metricDataProcessed(MetricOptions props)

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

Specified by:

metricDataProcessed in interface IHttpStage

Parameters:

props -

metricDataProcessed

public Metric metricDataProcessed()

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

Specified by:

metricDataProcessed in interface IHttpStage

metricIntegrationLatency

public 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.

Specified by:

metricIntegrationLatency in interface IHttpStage

Parameters:

props -

metricIntegrationLatency

public Metric metricIntegrationLatency()

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

Specified by:

metricIntegrationLatency in interface IHttpStage

metricLatency

public 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.

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

Specified by:

metricLatency in interface IHttpStage

Parameters:

props -

metricLatency

public Metric metricLatency()

(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.

Specified by:

metricLatency in interface IHttpStage

metricServerError

public Metric metricServerError(MetricOptions props)

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

Specified by:

metricServerError in interface IHttpStage

Parameters:

props -

metricServerError

public Metric metricServerError()

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

Specified by:

metricServerError in interface IHttpStage

getApi

public IHttpApi getApi()

(experimental) The API this stage is associated to.

Specified by:

getApi in interface IHttpStage

getBaseApi

protected IApi getBaseApi()

getDomainUrl

public java.lang.String getDomainUrl()

(experimental) The custom domain URL to this stage.

Specified by:

getDomainUrl in interface IHttpStage

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 URL to this stage.

Specified by:

getUrl in interface IStage