翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
HttpApiDomainConfiguration
API のカスタムドメインを設定します。
構文
AWS Serverless Application Model (AWS SAM) テンプレートでこのエンティティを宣言するには、次の構文を使用します。
YAML
BasePath:ListCertificateArn:StringDomainName:StringEndpointConfiguration:StringMutualTlsAuthentication:MutualTlsAuthenticationOwnershipVerificationCertificateArn:StringRoute53:Route53ConfigurationSecurityPolicy:String
プロパティ
-
BasePath -
Amazon API Gateway ドメイン名で設定する basepaths のリストです。
タイプ: リスト
必須: いいえ
デフォルト: /
AWS CloudFormation 互換性: このプロパティは、
AWS::ApiGatewayV2::ApiMappingresource.creates のApiMappingKeyプロパティに似ています。このプロパティで指定された値ごとに 1 つずつ、複数のAWS::ApiGatewayV2::ApiMappingリソース AWS SAM を作成します。 -
CertificateArn -
このドメイン名のエンドポイントの AWS マネージド証明書の Amazon リソースネーム (ARN)。 は、サポートされている唯一のソース AWS Certificate Manager です。
型: 文字列
必須: はい
AWS CloudFormation 互換性: このプロパティは、
AWS::ApiGateway2::DomainName DomainNameConfigurationリソースのCertificateArnプロパティに直接渡されます。 -
DomainName -
API Gateway API のカスタムドメイン名です。大文字はサポートされていません。
AWS SAM このプロパティが設定されると、 は
AWS::ApiGatewayV2::DomainNameリソースを生成します。このシナリオの詳細については、「DomainName プロパティが指定されている」を参照してください。生成された AWS CloudFormation リソースの詳細については、「」を参照してください用に生成された AWS CloudFormation リソース AWS SAM。型: 文字列
必須: はい
AWS CloudFormation 互換性: このプロパティは、
AWS::ApiGateway2::DomainNameリソースのDomainNameプロパティに直接渡されます。 -
EndpointConfiguration -
カスタムドメインにマップする API Gateway エンドポイントのタイプを定義します。このプロパティの値は、
CertificateArnプロパティのマッピング方法を決定します AWS CloudFormation。HTTP API に有効な値は
REGIONALのみです。型: 文字列
必須: いいえ
デフォルト:
REGIONALAWS CloudFormation 互換性: このプロパティは に固有 AWS SAM であり、 AWS CloudFormation 同等のものはありません。
-
MutualTlsAuthentication -
カスタムドメイン名の相互 Transport Layer Security (TLS) 認証設定です。
必須: いいえ
AWS CloudFormation 互換性: このプロパティは、
AWS::ApiGatewayV2::DomainNameリソースのMutualTlsAuthenticationプロパティに直接渡されます。 -
OwnershipVerificationCertificateArn -
カスタムドメインの所有権を検証するために ACM によって発行されたパブリック証明書の ARN。相互 TLS を設定し、ACM にインポートされた、またはプライベート CA 証明書の ARN を
CertificateArnに指定する場合のみ必須です。型: 文字列
必須: いいえ
AWS CloudFormation 互換性: このプロパティは、
AWS::ApiGatewayV2::DomainNameDomainNameConfigurationデータ型のOwnershipVerificationCertificateArnプロパティに直接渡されます。 -
Route53 -
Amazon Route 53 設定を定義します。
タイプ: Route53Configuration
必須: いいえ
AWS CloudFormation 互換性: このプロパティは に固有 AWS SAM であり、 AWS CloudFormation 同等のものはありません。
-
SecurityPolicy -
このドメイン名に対するセキュリティポリシーの TLS バージョンです。
HTTP API に有効な値は
TLS_1_2のみです。型: 文字列
必須: いいえ
AWS CloudFormation 互換性: このプロパティは、
AWS::ApiGatewayV2::DomainNameDomainNameConfigurationデータ型のSecurityPolicyプロパティに直接渡されます。
例
DomainName
DomainName の例
YAML
Domain: DomainName: www.example.com CertificateArn: arn-example EndpointConfiguration: REGIONAL Route53: HostedZoneId: Z1PA6795UKMFR9 BasePath: - foo - bar