在 CDK v2 中找不到 HttpApi 构造

Question

我正在尝试将 HttpApi 添加到我已经使用 CDK v2 的项目中。 我能够从 @aws-cdk/aws-apigatewayv2:

检索 HttpApi class

https://docs.aws.amazon.com/cdk/api/v1/docs/@aws-cdk_aws-apigatewayv2.HttpApi.html

但我无法在新的 v2 aws-cdk-lib 模块中检索构造：

https://docs.aws.amazon.com/cdk/api/v2/docs/aws-cdk-lib.aws_apigatewayv2-readme.html

包在 v2 中移动了吗？

另外，HttpApi和这个有什么区别https://docs.aws.amazon.com/cdk/api/v2/docs/aws-cdk-lib.aws_sam.CfnHttpApi.html？

谢谢:)

Answer 1

HttpApi 构造的新位置

来自migrating to AWS CDK V2：

Experimental constructs are provided in separate, independently-versioned packages with names that end in alpha and an alpha version number that corresponds to the first release of aws-cdk-lib with which they are compatible.

由于 HttpApi 构造被认为是实验性的，因此已将其移至单独的包中：

Link to construct page

Link to overview of new experimental package labelled alpha

CfnHttpApi、CfnApi 和 HttpApi 的区别

CfnHttpApi documentation（非实验性）

CfnApi documentation（非实验性）

HttpApi documentation（实验）

CfnHttpApi 和 CfnApi 是 L1 构造，这意味着它们直接转换为单个 CloudFormation 资源块。 HttpApi 是一种 L2 构造，通常更复杂并且可以转换为一个或多个 CloudFormation 资源块。 This CDK Developer guide page 关于构造提供了有关 L1 和 L2 构造如何工作的更多详细信息。

CfnHttpApi 和 CfnApi 都是创建 HTTP API 的 CloudFormation 资源类型，但 CfnHttpApi 是 AWS SAM version of CfnApi. Quoting this page，AWS SAM 模板是 AWS CloudFormation 模板的扩展，有一些额外的组件使它们更容易使用.

Answer 2

L2 HttpApi 构造在 @aws-cdk/aws-apigatewayv2-alpha 中。在 CDK V2 中，发布了实验模块 in separate "alpha" packages.

CfnHttpApi 是 L1 construct that represents the CloudFormation AWS::ApiGatewayV2::Api 资源。在幕后，HttpApi 有一个 CfnHttpApi 作为子节点。 Cfn-前缀结构在 aws-cdk-lib 中发布，因为它们很稳定。