翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
HttpApiDomainConfiguration
API のカスタムドメインを設定します。
構文
AWS Serverless Application Model (AWS SAM) テンプレートでこのエンティティを宣言するには、以下の構文を使用します。
YAML
BasePath:
List
CertificateArn:String
DomainName:String
EndpointConfiguration:String
MutualTlsAuthentication:MutualTlsAuthentication
OwnershipVerificationCertificateArn:String
Route53:Route53Configuration
SecurityPolicy:String
プロパティ
-
BasePath
-
Amazon API Gateway ドメイン名で設定する basepaths のリストです。
タイプ: リスト
必須: いいえ
デフォルト: /
AWS CloudFormation との互換性: このプロパティは
AWS::ApiGatewayV2::ApiMapping
リソースのApiMappingKey
プロパティと似ています。AWS SAM は複数のAWS::ApiGatewayV2::ApiMapping
リソースを作成します (このプロパティに指定された値につき 1 つ)。 -
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 SAM 向けに生成された AWS CloudFormation リソース」を参照してください。型: 文字列
必須: はい
AWS CloudFormation との互換性: このプロパティは、
AWS::ApiGateway2::DomainName
リソースのDomainName
プロパティに直接渡されます。 -
EndpointConfiguration
-
カスタムドメインにマップする API Gateway エンドポイントのタイプを定義します。このプロパティの値は、
CertificateArn
プロパティが AWS CloudFormation でマップされる方法を決定します。HTTP API に有効な値は
REGIONAL
のみです。型: 文字列
必須: いいえ
デフォルト:
REGIONAL
AWS 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::DomainName
DomainNameConfiguration
データ型のOwnershipVerificationCertificateArn
プロパティに直接渡されます。 -
Route53
-
Amazon Route 53 設定を定義します。
タイプ: Route53Configuration
必須: いいえ
AWS CloudFormation との互換性: このプロパティは AWS SAM に固有であり、AWS CloudFormation に同等のものはありません。
-
SecurityPolicy
-
このドメイン名に対するセキュリティポリシーの TLS バージョンです。
HTTP API に有効な値は
TLS_1_2
のみです。型: 文字列
必須: いいえ
AWS CloudFormation との互換性: このプロパティは、
AWS::ApiGatewayV2::DomainName
DomainNameConfiguration
データ型のSecurityPolicy
プロパティに直接渡されます。
例
DomainName
DomainName の例
YAML
Domain: DomainName: www.example.com CertificateArn: arn-example EndpointConfiguration: REGIONAL Route53: HostedZoneId: Z1PA6795UKMFR9 BasePath: - foo - bar