Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
DomainConfiguration
Mengonfigurasi domain kustom untuk API.
Sintaksis
Untuk mendeklarasikan entitas ini dalam template AWS Serverless Application Model (AWS SAM) Anda, gunakan sintaks berikut.
YAML
AccessAssociation:DomainAccessAssociationBasePath:ListCertificateArn:StringDomainName:StringEndpointConfiguration:StringMutualTlsAuthentication:MutualTlsAuthenticationNormalizeBasePath:BooleanOwnershipVerificationCertificateArn:StringPolicy:JsonRoute53:Route53ConfigurationSecurityPolicy:String
Properti
-
AccessAssociation -
Konfigurasi yang diperlukan untuk menghasilkan
AWS::ApiGateway::DomainNameAccessAssociationsumber daya.AWS SAM menghasilkan sebuah AWS::ApiGateway::DomainNameAccessAssociationsumber daya saat properti ini disetel. Untuk informasi tentang CloudFormation sumber daya yang dihasilkan, lihatCloudFormation Sumber daya yang dihasilkan untuk AWS SAM.
Jenis: DomainAccessAssociation
Wajib: Tidak
CloudFormation kompatibilitas: Properti ini unik AWS SAM dan tidak memiliki CloudFormation padanan.
-
BasePath -
Daftar basepaths untuk mengonfigurasi dengan nama domain Amazon API Gateway.
Tipe: Daftar
Wajib: Tidak
Default:/
CloudFormation kompatibilitas: Properti ini mirip dengan
BasePathpropertiAWS::ApiGateway::BasePathMappingsumber daya. AWS SAM menciptakan beberapaAWS::ApiGateway::BasePathMappingsumber daya, satu perBasePathditentukan dalam properti ini. -
CertificateArn -
Nama Sumber Daya Amazon (ARN) dari sertifikat AWS terkelola titik akhir nama domain ini. AWS Certificate Manager adalah satu-satunya sumber yang didukung.
Tipe: String
Wajib: Ya
CloudFormation kompatibilitas: Properti ini mirip dengan
CertificateArnpropertiAWS::ApiGateway::DomainNamesumber daya. JikaEndpointConfigurationdiatur keREGIONAL(nilai default),CertificateArnpeta ke RegionalCertificateArninAWS::ApiGateway::DomainName. JikaEndpointConfigurationdiatur keEDGE,CertificateArnpetakan ke CertificateArninAWS::ApiGateway::DomainName. JikaEndpointConfigurationdisetel kePRIVATE, properti ini diteruskan ke sumber daya AWS::ApiGateway::DomainNameV2.Catatan tambahan: Untuk
EDGEtitik akhir, Anda harus membuat sertifikat dius-east-1AWS Wilayah. -
DomainName -
Nama domain khusus untuk API dari API Gateway Anda. Tidak didukung huruf besar.
AWS SAM menghasilkan sebuah AWS::ApiGateway::DomainNamesumber daya saat properti ini disetel. Untuk informasi selengkapnya tentang skenario ini, lihat DomainNameproperti ditentukan. Untuk informasi tentang CloudFormation sumber daya yang dihasilkan, lihatCloudFormation Sumber daya yang dihasilkan untuk AWS SAM.
Tipe: String
Wajib: Ya
CloudFormation kompatibilitas: Properti ini diteruskan langsung ke
DomainNamepropertiAWS::ApiGateway::DomainNamesumber daya, atauAWS::ApiGateway::DomainNameV2kapan EndpointConfiguration disetel kePRIVATE. -
EndpointConfiguration -
Menentukan tipe titik akhir API Gateway untuk memetakan ke domain kustom. Nilai properti ini menentukan bagaimana
CertificateArnproperti dipetakan. CloudFormationNilai yang valid:
EDGE,REGIONAL, atauPRIVATETipe: String
Wajib: Tidak
Default:
REGIONALCloudFormation kompatibilitas: Properti ini unik AWS SAM dan tidak memiliki CloudFormation padanan.
-
MutualTlsAuthentication -
Konfigurasi autentikasi Keamanan Lapisan Pengangkutan (TLS) yang saling terkait untuk nama domain kustom.
Jenis: MutualTlsAuthentication
Wajib: Tidak
CloudFormation kompatibilitas: Properti ini diteruskan langsung ke
MutualTlsAuthenticationpropertiAWS::ApiGateway::DomainNamesumber daya. -
NormalizeBasePath -
Menunjukkan apakah karakter non-alfanumerik diizinkan dalam basepaths yang ditentukan oleh properti.
BasePathKetika diatur keTrue, karakter non-alfanumerik dihapus dari basepaths.Gunakan
NormalizeBasePathdenganBasePathproperti.Tipe: Boolean
Wajib: Tidak
Default: BETUL
CloudFormation kompatibilitas: Properti ini unik AWS SAM dan tidak memiliki CloudFormation padanan.
-
OwnershipVerificationCertificateArn -
ARN sertifikat publik yang dikeluarkan oleh ACM untuk memvalidasi kepemilikan domain kustom Anda. Diperlukan hanya ketika Anda mengonfigurasi TLS timbal balik dan Anda menentukan ARN sertifikat CA yang diimpor atau pribadi ACM untuk ARN.
CertificateArnTipe: String
Wajib: Tidak
CloudFormation kompatibilitas: Properti ini diteruskan langsung ke
OwnershipVerificationCertificateArnpropertiAWS::ApiGateway::DomainNamesumber daya. -
Policy -
Kebijakan IAM untuk melampirkan ke nama domain API Gateway. Hanya berlaku bila
EndpointConfigurationdisetel kePRIVATE.Jenis: Json
Wajib: Tidak
CloudFormation kompatibilitas: Properti ini diteruskan langsung ke
PolicypropertiAWS::ApiGateway::DomainNameV2sumber daya saatEndpointConfigurationdisetel kePRIVATE. Untuk contoh dokumen kebijakan yang valid, lihat AWS::ApiGateway::DomainNameV2. -
Route53 -
Menentukan konfigurasi Amazon Route 53.
Tipe:Route53Configuration
Wajib: Tidak
CloudFormation kompatibilitas: Properti ini unik AWS SAM dan tidak memiliki CloudFormation padanan.
-
SecurityPolicy -
Versi TLS ditambah paket sandi untuk nama domain ini.
Tipe: String
Wajib: Tidak
CloudFormation kompatibilitas: Properti ini diteruskan langsung ke
SecurityPolicypropertiAWS::ApiGateway::DomainNamesumber daya, atauAWS::ApiGateway::DomainNameV2kapanEndpointConfigurationdisetel kePRIVATE. UntukPRIVATEtitik akhir, hanya TLS_1_2 yang didukung.
Contoh
DomainName
DomainName contoh
YAML
Domain: DomainName: www.example.com CertificateArn: arn-example EndpointConfiguration: EDGE Route53: HostedZoneId: Z1PA6795UKMFR9 BasePath: - foo - bar