DomainConfiguration - AWS Serverless Application Model

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:

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 BasePathde um recurso AWS::ApiGateway::BasePathMapping. AWS SAM cria vários recursos AWS::ApiGateway::BasePathMapping, um por BasePath especificado nessa propriedade.

NormalizeBasePath

Indica se caracteres não alfanuméricos são permitidos nos caminhos base definidos pela propriedade BasePath. Quando definido como True, caracteres não alfanuméricos são removidos dos caminhos base.

Use a propriedade NormalizeBasePath para BasePath.

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 recurso AWS::ApiGateway::DomainName. Se EndpointConfiguration estiver definido como REGIONAL (o valor padrão), CertificateArn mapeia para RegionalCertificateARN em AWS::ApiGateway::DomainName. Se EndpointConfiguration estiver definido como EDGE, CertificateArn mapeia para CertificateArn in em AWS::ApiGateway::DomainName.

Observações adicionais: Para um EDGE endpoint, você deve criar o certificado na região us-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 recurso AWS::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 ou EDGE

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 recurso AWS::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 recurso AWS::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 recurso AWS::ApiGateway::DomainName.

Exemplos

DomainName

exemplo de DomainName

YAML

Domain: DomainName: www.example.com CertificateArn: arn-example EndpointConfiguration: EDGE Route53: HostedZoneId: Z1PA6795UKMFR9 BasePath: - foo - bar