WebSocketApiDomainConfiguration

为 WebSocket API 配置自定义网域。

语法

要在 AWS Serverless Application Model (AWS SAM) 模板中声明此实体，请使用以下语法。

YAML

  BasePath: List
  CertificateArn: String
  DomainName: String
  EndpointConfiguration: String
  Route53: Route53Configuration
  SecurityPolicy: String

Properties

BasePath

要使用 Amazon API Gateway 域名配置的基本路径列表。

类型：列表

必需：否

默认值：/

CloudFormation 兼容性：此属性类似于AWS::ApiGatewayV2::ApiMapping资源的ApiMappingKey属性。 AWS SAM 创建多个AWS::ApiGatewayV2::ApiMapping资源，每个资源在此属性中指定的值一个。

CertificateArn

该域名终端节点的 AWS 托管证书的 Amazon 资源名称 (ARN)。 AWS Certificate Manager 是唯一支持的来源。

类型：字符串

是否必需：是

CloudFormation 兼容性：此属性直接传递给AWS::ApiGatewayV2::DomainName DomainNameConfiguration资源的CertificateArn属性。

DomainName

您的 API Gateway WebSocket API 的自定义域名。不支持大写字母。

AWS SAM 设置此属性时会生成AWS::ApiGatewayV2::DomainName资源。有关生成的 CloudFormation 资源的信息，请参阅生成的 CloudFormation 资源用于 AWS SAM。

类型：字符串

是否必需：是

CloudFormation 兼容性：此属性直接传递给AWS::ApiGatewayV2::DomainName资源的DomainName属性。

EndpointConfiguration

定义要映射到自定义域的 API Gateway 端点的类型。此属性的值决定了该CertificateArn属性的映射方式 CloudFormation。

的唯一有效值 WebSocket APIs 是REGIONAL。

类型：字符串

必需：否

默认值：REGIONAL

CloudFormation 兼容性：此属性是独有的 AWS SAM ，没有 CloudFormation 等效属性。

Route53

定义 53 号公路配置。

类型：Route53Configuration

必需：否

CloudFormation 兼容性：此属性是独有的 AWS SAM ，没有 CloudFormation 等效属性。

SecurityPolicy

此域名的安全策略的 TLS 版本。

的唯一有效值 WebSocket APIs 是TLS_1_2。

类型：字符串

必需：否

CloudFormation 兼容性：此属性直接传递给AWS::ApiGatewayV2::DomainNameDomainNameConfiguration数据类型的SecurityPolicy属性。

示例

DomainName

DomainName 示例

YAML

Domain:
  DomainName: ws.example.com
  CertificateArn: arn:aws:acm:us-east-1:123456789012:certificate/example
  EndpointConfiguration: REGIONAL
  Route53:
    HostedZoneId: Z1PA6795UKMFR9
  BasePath:
    - v1
    - v2