Class HttpApi

(experimental) Create a new API Gateway HTTP API endpoint.

Inheritance

System.Object

Construct

Resource

HttpApi

Implements

IHttpApi

IResource

IConstruct

Constructs.IConstruct

IDependable

Inherited Members

Resource.GeneratePhysicalName()

Resource.GetResourceArnAttribute(String, IArnComponents)

Resource.GetResourceNameAttribute(String)

Resource.Env

Resource.PhysicalName

Resource.Stack

Construct.IsConstruct(Object)

Construct.OnPrepare()

Construct.OnSynthesize(ISynthesisSession)

Construct.OnValidate()

Construct.Prepare()

Construct.Synthesize(ISynthesisSession)

Construct.Validate()

Construct.Node

Namespace: Amazon.CDK.AWS.APIGatewayv2

Assembly: Amazon.CDK.AWS.APIGatewayv2.dll

Syntax (csharp)

public class HttpApi : Resource, IHttpApi, IResource, IConstruct, IConstruct, IDependable

Syntax (vb)

Public Class HttpApi
    Inherits Resource
    Implements IHttpApi, IResource, IConstruct, IConstruct, IDependable

Remarks

Stability: Experimental

Resource: AWS::ApiGatewayV2::Api

Synopsis

Constructors

HttpApi(ByRefValue)	Used by jsii to construct an instance of this class from a Javascript-owned object reference
HttpApi(DeputyBase.DeputyProps)	Used by jsii to construct an instance of this class from DeputyProps
HttpApi(Construct, String, IHttpApiProps)

Properties

ApiEndpoint	(experimental) The default endpoint for an API.
DefaultStage	(experimental) default stage of the api resource.
HttpApiId	(experimental) The identifier of this API Gateway HTTP API.
HttpApiName	(experimental) A human friendly name for this HTTP API.
Url	(experimental) Get the URL to the default stage of this API.

Methods

AddRoutes(IAddRoutesOptions)	(experimental) Add multiple routes that uses the same configuration.
AddStage(String, IHttpStageOptions)	(experimental) Add a new stage.
AddVpcLink(IVpcLinkProps)	(experimental) Add a new VpcLink.
FromApiId(Construct, String, String)	(experimental) Import an existing HTTP API into this CDK app.
Metric(String, IMetricOptions)	(experimental) Return the given named metric for this HTTP Api Gateway.
MetricClientError(IMetricOptions)	(experimental) Metric for the number of client-side errors captured in a given period.
MetricCount(IMetricOptions)	(experimental) Metric for the total number API requests in a given period.
MetricDataProcessed(IMetricOptions)	(experimental) Metric for the amount of data processed in bytes.
MetricIntegrationLatency(IMetricOptions)	(experimental) Metric for the time between when API Gateway relays a request to the backend and when it receives a response from the backend.
MetricLatency(IMetricOptions)	(experimental) The time between when API Gateway receives a request from a client and when it returns a response to the client.
MetricServerError(IMetricOptions)	(experimental) Metric for the number of server-side errors captured in a given period.

Constructors

HttpApi(ByRefValue)

Used by jsii to construct an instance of this class from a Javascript-owned object reference

protected HttpApi(ByRefValue reference)

Parameters

reference Amazon.JSII.Runtime.Deputy.ByRefValue: The Javascript-owned object reference

HttpApi(DeputyBase.DeputyProps)

Used by jsii to construct an instance of this class from DeputyProps

protected HttpApi(DeputyBase.DeputyProps props)

Parameters

props Amazon.JSII.Runtime.Deputy.DeputyBase.DeputyProps: The deputy props

HttpApi(Construct, String, IHttpApiProps)

public HttpApi(Construct scope, string id, IHttpApiProps props = null)

Parameters

scope Constructs.Construct
id System.String
props IHttpApiProps

Remarks

Stability: Experimental

Properties

ApiEndpoint

(experimental) The default endpoint for an API.

public virtual string ApiEndpoint { get; }

Property Value

System.String

Remarks

Stability: Experimental

Attribute: true

DefaultStage

(experimental) default stage of the api resource.

public virtual HttpStage DefaultStage { get; }

Property Value

HttpStage

Remarks

Stability: Experimental

HttpApiId

(experimental) The identifier of this API Gateway HTTP API.

public virtual string HttpApiId { get; }

Property Value

System.String

Remarks

Stability: Experimental

HttpApiName

(experimental) A human friendly name for this HTTP API.

public virtual string HttpApiName { get; }

Property Value

System.String

Remarks

Note that this is different from httpApiId.

Stability: Experimental

Url

(experimental) Get the URL to the default stage of this API.

public virtual string Url { get; }

Property Value

System.String

Remarks

Returns undefined if createDefaultStage is unset.

Stability: Experimental

Methods

AddRoutes(IAddRoutesOptions)

(experimental) Add multiple routes that uses the same configuration.

public virtual HttpRoute[] AddRoutes(IAddRoutesOptions options)

Parameters

options IAddRoutesOptions

Returns

HttpRoute[]

Remarks

The routes all go to the same path, but for different methods.

Stability: Experimental

AddStage(String, IHttpStageOptions)

(experimental) Add a new stage.

public virtual HttpStage AddStage(string id, IHttpStageOptions options)

Parameters

id System.String
options IHttpStageOptions

Returns

HttpStage

Remarks

Stability: Experimental

AddVpcLink(IVpcLinkProps)

(experimental) Add a new VpcLink.

public virtual VpcLink AddVpcLink(IVpcLinkProps options)

Parameters

options IVpcLinkProps

Returns

VpcLink

Remarks

Stability: Experimental

FromApiId(Construct, String, String)

(experimental) Import an existing HTTP API into this CDK app.

public static IHttpApi FromApiId(Construct scope, string id, string httpApiId)

Parameters

scope Constructs.Construct
id System.String
httpApiId System.String

Returns

IHttpApi

Remarks

Stability: Experimental

Metric(String, IMetricOptions)

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

public virtual Metric Metric(string metricName, IMetricOptions props = null)

Parameters

metricName System.String
props IMetricOptions

Returns

Metric

Remarks

Stability: Experimental

MetricClientError(IMetricOptions)

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

public virtual Metric MetricClientError(IMetricOptions props = null)

Parameters

props IMetricOptions

Returns

Metric

Remarks

Stability: Experimental

MetricCount(IMetricOptions)

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

public virtual Metric MetricCount(IMetricOptions props = null)

Parameters

props IMetricOptions

Returns

Metric

Remarks

Stability: Experimental

MetricDataProcessed(IMetricOptions)

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

public virtual Metric MetricDataProcessed(IMetricOptions props = null)

Parameters

props IMetricOptions

Returns

Metric

Remarks

Stability: Experimental

MetricIntegrationLatency(IMetricOptions)

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

public virtual Metric MetricIntegrationLatency(IMetricOptions props = null)

Parameters

props IMetricOptions

Returns

Metric

Remarks

Stability: Experimental

MetricLatency(IMetricOptions)

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

public virtual Metric MetricLatency(IMetricOptions props = null)

Parameters

props IMetricOptions

Returns

Metric

Remarks

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

Stability: Experimental

MetricServerError(IMetricOptions)

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

public virtual Metric MetricServerError(IMetricOptions props = null)

Parameters

props IMetricOptions

Returns

Metric

Remarks

Stability: Experimental

Implements

IHttpApi

IResource

IConstruct

Constructs.IConstruct

IDependable