DomainConfiguration

La configurazione richiesta per generare AWS::ApiGateway::DomainNameAccessAssociation una risorsa.

AWS SAM genera una AWS::ApiGateway::DomainNameAccessAssociationrisorsa quando questa proprietà è impostata. Per informazioni sulle CloudFormation risorse generate, vedereCloudFormation Risorse generate per AWS SAM.

Tipo: DomainAccessAssociation

Obbligatorio: no

CloudFormation compatibilità: questa proprietà è unica AWS SAM e non ha un CloudFormation equivalente.

Un elenco dei percorsi di base da configurare con il nome di dominio Amazon API Gateway.

Tipo: elenco

Obbligatorio: no

Predefinito:/

CloudFormation compatibilità: questa proprietà è simile alla BasePath proprietà di una AWS::ApiGateway::BasePathMapping risorsa. AWS SAM crea più AWS::ApiGateway::BasePathMapping risorse, una per quelle BasePath specificate in questa proprietà.

L'Amazon Resource Name (ARN) di un certificato AWS gestito, endpoint di questo nome di dominio. AWS Certificate Manager è l'unica fonte supportata.

▬Tipo: stringa

Obbligatorio: sì

CloudFormation compatibilità: questa proprietà è simile alla CertificateArn proprietà di una AWS::ApiGateway::DomainName risorsa. Se EndpointConfiguration è impostato su REGIONAL (il valore predefinito), viene CertificateArn mappato a RegionalCertificateArninAWS::ApiGateway::DomainName. Se EndpointConfiguration è impostato suEDGE, viene CertificateArn mappato a CertificateArndentroAWS::ApiGateway::DomainName. Se EndpointConfiguration è impostato suPRIVATE, questa proprietà viene passata alla risorsa AWS::ApiGateway::DomainNameV2.

Note aggiuntive: per un EDGE endpoint, è necessario creare il certificato nella us-east-1 AWS regione.

Il nome di dominio personalizzato per l'API API Gateway. Le lettere maiuscole non sono supportate.

AWS SAM genera una AWS::ApiGateway::DomainNamerisorsa quando questa proprietà è impostata. Per informazioni su questo scenario, vedereDomainNamela proprietà è specificata. Per informazioni sulle CloudFormation risorse generate, vedereCloudFormation Risorse generate per AWS SAM.

▬Tipo: stringa

Obbligatorio: sì

CloudFormation compatibilità: questa proprietà viene passata direttamente alla DomainName proprietà di una AWS::ApiGateway::DomainName risorsa o a AWS::ApiGateway::DomainNameV2quando EndpointConfiguration è impostata suPRIVATE.

Definisce il tipo di endpoint API Gateway da mappare al dominio personalizzato. Il valore di questa proprietà determina il modo in cui la CertificateArn proprietà viene mappata. CloudFormation

Valori validi: EDGE, REGIONAL o PRIVATE

▬Tipo: stringa

Obbligatorio: no

Default: REGIONAL

CloudFormation compatibilità: questa proprietà è unica AWS SAM e non ha un CloudFormation equivalente.

La configurazione di autenticazione TLS (Mutual Transport Layer Security) per un nome di dominio personalizzato.

Tipo: MutualTlsAuthentication

Obbligatorio: no

CloudFormation compatibilità: questa proprietà viene passata direttamente alla MutualTlsAuthentication proprietà di una AWS::ApiGateway::DomainName risorsa.

Indica se i caratteri non alfanumerici sono consentiti nei percorsi di base definiti dalla proprietà. BasePath Se impostato suTrue, i caratteri non alfanumerici vengono rimossi dai percorsi di base.

Utilizzare con la proprietà. NormalizeBasePath BasePath

Tipo: Booleano

Obbligatorio: no

Impostazione predefinita: True

CloudFormation compatibilità: questa proprietà è unica AWS SAM e non ha un CloudFormation equivalente.

L'ARN del certificato pubblico emesso da ACM per convalidare la proprietà del dominio personalizzato. Richiesto solo quando si configura il TLS reciproco e si specifica un ARN di certificato CA privato o importato da ACM per. CertificateArn

▬Tipo: stringa

Obbligatorio: no

CloudFormation compatibilità: questa proprietà viene passata direttamente alla OwnershipVerificationCertificateArn proprietà di una risorsa. AWS::ApiGateway::DomainName

La policy IAM da collegare al nome di dominio API Gateway. Applicabile solo quando EndpointConfiguration è impostato suPRIVATE.

Type: Json

Obbligatorio: no

CloudFormation compatibilità: questa proprietà viene passata direttamente alla Policy proprietà di una AWS::ApiGateway::DomainNameV2 risorsa quando EndpointConfiguration è impostata suPRIVATE. Per esempi di documenti politici validi, vedere AWS::ApiGateway::DomainNameV2.

Definisce una configurazione Amazon Route 53.

Tipo: configurazione Route53

Obbligatorio: no

CloudFormation compatibilità: Questa proprietà è unica AWS SAM e non ha un equivalente. CloudFormation

La versione TLS più la suite di crittografia per questo nome di dominio.

▬Tipo: stringa

Obbligatorio: no

CloudFormation compatibilità: questa proprietà viene passata direttamente alla SecurityPolicy proprietà di una AWS::ApiGateway::DomainName risorsa o a AWS::ApiGateway::DomainNameV2when EndpointConfiguration è impostata su. PRIVATE Per gli PRIVATE endpoint, è supportato solo TLS_1_2.