As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
DomainConfiguration
Configura um domínio personalizado para uma API.
Sintaxe
Para declarar esta entidade no modelo do AWS Serverless Application Model (AWS SAM), use a seguinte sintaxe:
YAML
BasePath:
List
NormalizeBasePath:Boolean
CertificateArn:String
DomainName:String
EndpointConfiguration:String
MutualTlsAuthentication:MutualTlsAuthentication
OwnershipVerificationCertificateArn:String
Route53:Route53Configuration
SecurityPolicy:String
Propriedades
-
BasePath
-
Uma lista dos caminhos básicos a serem configurados com o nome de domínio do Amazon API Gateway.
Tipo: lista
Obrigatório: não
Padrão: /
Compatibilidade AWS CloudFormation: essa propriedade é semelhante à propriedade
BasePath
de um recursoAWS::ApiGateway::BasePathMapping
. AWS SAM cria vários recursosAWS::ApiGateway::BasePathMapping
, um porBasePath
especificado nessa propriedade. -
NormalizeBasePath
-
Indica se caracteres não alfanuméricos são permitidos nos caminhos base definidos pela propriedade
BasePath
. Quando definido comoTrue
, caracteres não alfanuméricos são removidos dos caminhos base.Use a propriedade
NormalizeBasePath
paraBasePath
.Tipo: booliano
Obrigatório: não
Padrão: verdadeiro
Compatibilidade AWS CloudFormation: Essa propriedade é exclusiva do AWS SAM e não tem AWS CloudFormation equivalente.
-
CertificateArn
-
O nome de recurso da Amazon (ARN) de um certificado gerenciado do AWS endpoint deste nome de domínio. AWS Certificate Manager é a única origem compatível.
Tipo: string
Obrigatório: Sim
Compatibilidade AWS CloudFormation: essa propriedade é semelhante à propriedade
CertificateArn
de um recursoAWS::ApiGateway::DomainName
. SeEndpointConfiguration
estiver definido comoREGIONAL
(o valor padrão),CertificateArn
mapeia para RegionalCertificateARN emAWS::ApiGateway::DomainName
. SeEndpointConfiguration
estiver definido comoEDGE
,CertificateArn
mapeia para CertificateArn in emAWS::ApiGateway::DomainName
.Observações adicionais: Para um
EDGE
endpoint, você deve criar o certificado na regiãous-east-1
AWS. -
DomainName
-
O nome de domínio personalizado para a sua API Gateway API. Letras maiúsculas não são compatíveis.
AWS SAM gera um recurso AWS::ApiGateway::DomainName quando essa propriedade é definida. Para obter informações sobre esse cenário, consulte A propriedade domainName é especificada. Para obter informações sobre recursos gerados do AWS CloudFormation, consulte Recursos gerados do AWS CloudFormation para o AWS SAM.
Tipo: string
Obrigatório: Sim
Compatibilidade AWS CloudFormation: essa propriedade é passada diretamente para a propriedade
DomainName
de um recursoAWS::ApiGateway::DomainName
. -
EndpointConfiguration
-
Define o tipo de endpoint do API Gateway a ser mapeado para o domínio personalizado. O valor dessa propriedade determina como a propriedade
CertificateArn
é mapeada AWS CloudFormation.Valores válidos:
REGIONAL
ouEDGE
Tipo: string
Obrigatório: não
Padrão:
REGIONAL
Compatibilidade AWS CloudFormation: Essa propriedade é exclusiva do AWS SAM e não tem AWS CloudFormation equivalente.
-
MutualTlsAuthentication
-
A Transport Layer Security (TLS) mútua para um nome de domínio personalizado.
Type: MutualTlsAuthentication
Obrigatório: não
Compatibilidade AWS CloudFormation: essa propriedade é passada diretamente para a propriedade
MutualTlsAuthentication
de um recursoAWS::ApiGateway::DomainName
. -
OwnershipVerificationCertificateArn
-
O ARN do certificado público emitido pelo ACM para validar a propriedade do domínio personalizado. Necessário somente para configurar o TLS mútuo e para especificar um ARN de CA privado ou importado do ACM para o
CertificateArn
.Tipo: string
Obrigatório: não
Compatibilidade AWS CloudFormation: essa propriedade é passada diretamente para a propriedade
OwnershipVerificationCertificateArn
de um recursoAWS::ApiGateway::DomainName
. -
Route53
-
Define uma configuração do Amazon Route 53.
Tipo:: Route53Configuration
Obrigatório: não
Compatibilidade AWS CloudFormation: Essa propriedade é exclusiva do AWS SAM e não tem AWS CloudFormation equivalente.
-
SecurityPolicy
-
O pacote de criptografia TLS mais o pacote de criptografia para este nome de domínio.
Tipo: string
Obrigatório: não
Compatibilidade AWS CloudFormation: essa propriedade é passada diretamente para a propriedade
SecurityPolicy
de um recursoAWS::ApiGateway::DomainName
.
Exemplos
DomainName
exemplo de DomainName
YAML
Domain: DomainName: www.example.com CertificateArn: arn-example EndpointConfiguration: EDGE Route53: HostedZoneId: Z1PA6795UKMFR9 BasePath: - foo - bar