Package software.amazon.awscdk.services.apigatewayv2

Class HttpStage

java.lang.Object
software.amazon.jsii.JsiiObject
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, software.amazon.jsii.JsiiSerializable, software.constructs.IConstruct
@Generated(value="jsii-pacmak/1.74.0 (build 6d08790)", date="2023-05-31T18:44:14.865Z") @Stability(Experimental) 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();

  • Constructor Details

    • HttpStage

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

    • HttpStage

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

    • HttpStage

      @Stability(Experimental) public HttpStage(@NotNull software.constructs.Construct scope, @NotNull String id, @NotNull HttpStageProps props)
      Parameters:
      scope - This parameter is required.
      id - This parameter is required.
      props - This parameter is required.

  • Method Details

    • fromHttpStageAttributes

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

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

    • metricClientError

      @Stability(Experimental) @NotNull public Metric metricClientError(@Nullable 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

      @Stability(Experimental) @NotNull public Metric metricClientError()
      (experimental) Metric for the number of client-side errors captured in a given period.
      Specified by:
      metricClientError in interface IHttpStage

    • metricCount

      @Stability(Experimental) @NotNull public Metric metricCount(@Nullable MetricOptions props)
      (experimental) Metric for the total number API requests in a given period.

      Specified by:
      metricCount in interface IHttpStage
      Parameters:
      props -

    • metricCount

      @Stability(Experimental) @NotNull public Metric metricCount()
      (experimental) Metric for the total number API requests in a given period.
      Specified by:
      metricCount in interface IHttpStage

    • metricDataProcessed

      @Stability(Experimental) @NotNull public Metric metricDataProcessed(@Nullable MetricOptions props)
      (experimental) Metric for the amount of data processed in bytes.

      Specified by:
      metricDataProcessed in interface IHttpStage
      Parameters:
      props -

    • metricDataProcessed

      @Stability(Experimental) @NotNull public Metric metricDataProcessed()
      (experimental) Metric for the amount of data processed in bytes.
      Specified by:
      metricDataProcessed in interface IHttpStage

    • metricIntegrationLatency

      @Stability(Experimental) @NotNull public 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.

      Specified by:
      metricIntegrationLatency in interface IHttpStage
      Parameters:
      props -

    • metricIntegrationLatency

      @Stability(Experimental) @NotNull 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

      @Stability(Experimental) @NotNull public 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.

      Specified by:
      metricLatency in interface IHttpStage
      Parameters:
      props -

    • metricLatency

      @Stability(Experimental) @NotNull 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

      @Stability(Experimental) @NotNull public Metric metricServerError(@Nullable 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

      @Stability(Experimental) @NotNull public Metric metricServerError()
      (experimental) Metric for the number of server-side errors captured in a given period.
      Specified by:
      metricServerError in interface IHttpStage

    • getApi

      @Stability(Experimental) @NotNull public IHttpApi getApi()
      (experimental) The API this stage is associated to.
      Specified by:
      getApi in interface IHttpStage

    • getBaseApi

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

    • getDomainUrl

      @Stability(Experimental) @NotNull public String getDomainUrl()
      (experimental) The custom domain URL to this stage.
      Specified by:
      getDomainUrl in interface IHttpStage

    • getStageName

      @Stability(Experimental) @NotNull public String getStageName()
      (experimental) The name of the stage;

      its primary identifier.

      Specified by:
      getStageName in interface IStage

    • getUrl

      @Stability(Experimental) @NotNull public String getUrl()
      (experimental) The URL to this stage.
      Specified by:
      getUrl in interface IStage