Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# DomainConfiguration
<a name="sam-property-api-domainconfiguration"></a>

Configura un dominio personalizzato per un'API.

## Sintassi
<a name="sam-property-api-domainconfiguration-syntax"></a>

Per dichiarare questa entità nel tuo modello AWS Serverless Application Model (AWS SAM), usa la seguente sintassi.

### YAML
<a name="sam-property-api-domainconfiguration-syntax.yaml"></a>

```
  [AccessAssociation](#sam-api-domainconfiguration-domainaccessassociation): DomainAccessAssociation
  [BasePath](#sam-api-domainconfiguration-basepath): List
  [CertificateArn](#sam-api-domainconfiguration-certificatearn): String
  [DomainName](#sam-api-domainconfiguration-domainname): String
  [EndpointConfiguration](#sam-api-domainconfiguration-endpointconfiguration): String
  [MutualTlsAuthentication](#sam-api-domainconfiguration-mutualtlsauthentication): [MutualTlsAuthentication](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-apigateway-domainname.html#cfn-apigateway-domainname-mutualtlsauthentication)
  [NormalizeBasePath](#sam-api-domainconfiguration-normalizebasepath): Boolean
  [OwnershipVerificationCertificateArn](#sam-api-domainconfiguration-ownershipverificationcertificatearn): String
  [Policy: ](#sam-api-domainconfiguration-policy)Json
  [Route53](#sam-api-domainconfiguration-route53): Route53Configuration
  [SecurityPolicy](#sam-api-domainconfiguration-securitypolicy): String
```

## Properties
<a name="sam-property-api-domainconfiguration-properties"></a>

 `AccessAssociation`   <a name="sam-api-domainconfiguration-domainaccessassociation"></a>
La configurazione richiesta per generare ` AWS::ApiGateway::DomainNameAccessAssociation` una risorsa.  
AWS SAM genera una [https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-apigateway-domainnameaccessassociation.html](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-apigateway-domainnameaccessassociation.html)risorsa quando questa proprietà è impostata. Per informazioni sulle CloudFormation risorse generate, vedere[CloudFormation Risorse generate per AWS SAM](sam-specification-generated-resources.md).  
*Tipo:* [DomainAccessAssociation](sam-property-api-domainaccessassociation.md)  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà è unica AWS SAM e non ha un CloudFormation equivalente.

 `BasePath`   <a name="sam-api-domainconfiguration-basepath"></a>
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](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-apigateway-basepathmapping.html#cfn-apigateway-basepathmapping-basepath)` proprietà di una `AWS::ApiGateway::BasePathMapping` risorsa. AWS SAM crea più `AWS::ApiGateway::BasePathMapping` risorse, una per quelle `BasePath` specificate in questa proprietà.

 `CertificateArn`   <a name="sam-api-domainconfiguration-certificatearn"></a>
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](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-apigateway-domainname.html#cfn-apigateway-domainname-certificatearn)` proprietà di una `AWS::ApiGateway::DomainName` risorsa. Se `EndpointConfiguration` è impostato su `REGIONAL` (il valore predefinito), viene `CertificateArn` mappato a [RegionalCertificateArn](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-apigateway-domainname.html#cfn-apigateway-domainname-regionalcertificatearn)in`AWS::ApiGateway::DomainName`. Se `EndpointConfiguration` è impostato su`EDGE`, viene `CertificateArn` mappato a [CertificateArn](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-apigateway-domainname.html#cfn-apigateway-domainname-certificatearn)dentro`AWS::ApiGateway::DomainName`. Se `EndpointConfiguration` è impostato su`PRIVATE`, questa proprietà viene passata alla risorsa [AWS::ApiGateway::DomainNameV2](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-apigateway-domainnamev2).  
*Note aggiuntive*: per un `EDGE` endpoint, è necessario creare il certificato nella `us-east-1` AWS regione.

 `DomainName`   <a name="sam-api-domainconfiguration-domainname"></a>
Il nome di dominio personalizzato per l'API API Gateway. Le lettere maiuscole non sono supportate.  
AWS SAM genera una [https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-apigateway-domainname.html](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-apigateway-domainname.html)risorsa quando questa proprietà è impostata. Per informazioni su questo scenario, vedere[DomainName la proprietà è specificata](sam-specification-generated-resources-api.md#sam-specification-generated-resources-api-domain-name). Per informazioni sulle CloudFormation risorse generate, vedere[CloudFormation Risorse generate per AWS SAM](sam-specification-generated-resources.md).  
▬*Tipo:* stringa  
*Obbligatorio:* sì  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla `[DomainName](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-apigateway-domainname.html#cfn-apigateway-domainname-domainname)` proprietà di una `AWS::ApiGateway::DomainName` risorsa o a [https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-apigateway-domainnamev2](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-apigateway-domainnamev2)quando EndpointConfiguration è impostata su`PRIVATE`.

 `EndpointConfiguration`   <a name="sam-api-domainconfiguration-endpointconfiguration"></a>
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.

 `MutualTlsAuthentication`   <a name="sam-api-domainconfiguration-mutualtlsauthentication"></a>
La configurazione di autenticazione TLS (Mutual Transport Layer Security) per un nome di dominio personalizzato.  
*Tipo:* [MutualTlsAuthentication](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-apigateway-domainname.html#cfn-apigateway-domainname-mutualtlsauthentication)  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla `[MutualTlsAuthentication](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-apigateway-domainname.html#cfn-apigateway-domainname-mutualtlsauthentication)` proprietà di una `AWS::ApiGateway::DomainName` risorsa.

 `NormalizeBasePath`   <a name="sam-api-domainconfiguration-normalizebasepath"></a>
Indica se i caratteri non alfanumerici sono consentiti nei percorsi di base definiti dalla proprietà. `BasePath` Se impostato su`True`, 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.

 `OwnershipVerificationCertificateArn`   <a name="sam-api-domainconfiguration-ownershipverificationcertificatearn"></a>
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](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-apigateway-domainname.html#cfn-apigateway-domainname-ownershipverificationcertificatearn)` proprietà di una risorsa. `AWS::ApiGateway::DomainName`

 `Policy`   <a name="sam-api-domainconfiguration-policy"></a>
La policy IAM da collegare al nome di dominio API Gateway. Applicabile solo quando `EndpointConfiguration` è impostato su`PRIVATE`.  
*Type*: Json  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla `Policy` proprietà di una `AWS::ApiGateway::DomainNameV2` risorsa quando `EndpointConfiguration` è impostata su`PRIVATE`. Per esempi di documenti politici validi, vedere [AWS::ApiGateway::DomainNameV2](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-apigateway-domainnamev2).

 `Route53`   <a name="sam-api-domainconfiguration-route53"></a>
Definisce una configurazione Amazon Route 53.  
*Tipo: configurazione* [Route53](sam-property-api-route53configuration.md)  
*Obbligatorio:* no  
*CloudFormation compatibilità*: Questa proprietà è unica AWS SAM e non ha un equivalente. CloudFormation 

 `SecurityPolicy`   <a name="sam-api-domainconfiguration-securitypolicy"></a>
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](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-apigateway-domainname.html#cfn-apigateway-domainname-securitypolicy)` proprietà di una `AWS::ApiGateway::DomainName` risorsa o a [https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-apigateway-domainnamev2](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-apigateway-domainnamev2)when `EndpointConfiguration` è impostata su. `PRIVATE` Per gli `PRIVATE` endpoint, è supportato solo TLS\$11\$12.

## Esempi
<a name="sam-property-api-domainconfiguration--examples"></a>

### DomainName
<a name="sam-property-api-domainconfiguration--examples--domainname"></a>

DomainName esempio

#### YAML
<a name="sam-property-api-domainconfiguration--examples--domainname--yaml"></a>

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

# DomainAccessAssociation
<a name="sam-property-api-domainaccessassociation"></a>

Configura un'associazione di accesso al dominio tra un'origine di associazione di accesso e un nome di dominio personalizzato privato. L'unica fonte di associazione di accesso supportata è un ID endpoint VPC. Per ulteriori informazioni, consulta [Nomi di dominio personalizzati per uso privato APIs in API Gateway](https://docs.aws.amazon.com/apigateway/latest/developerguide/apigateway-private-custom-domains.html).

## Sintassi
<a name="sam-property-api-domainaccessassociation-syntax"></a>

Per dichiarare questa entità nel tuo modello AWS Serverless Application Model (AWS SAM), usa la seguente sintassi.

### YAML
<a name="sam-property-api-domainaccessassociation-syntax.yaml"></a>

```
 VpcEndpointId: String
```

## Properties
<a name="sam-property-api-domainaccessassociation-properties"></a>

 `VpcEndpointId`   <a name="sam-api-domainaccessassociation-vpcendpointid"></a>
L'ID endpoint dell'endpoint dell'interfaccia VPC associato al servizio VPC API Gateway.  
▬*Tipo:* stringa  
*Obbligatorio:* sì  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla `[ AccessAssociationSource](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-apigateway-domainnameaccessassociation.html#cfn-apigateway-domainnameaccessassociation-accessassociationsource)` proprietà di una risorsa. `AWS::ApiGateway::DomainNameAccessAssociation`

# Route53Configuration
<a name="sam-property-api-route53configuration"></a>

Configura i set di record Route53 per un'API.

## Sintassi
<a name="sam-property-api-route53configuration-syntax"></a>

Per dichiarare questa entità nel tuo modello AWS Serverless Application Model (AWS SAM), usa la seguente sintassi.

### YAML
<a name="sam-property-api-route53configuration-syntax.yaml"></a>

```
  [DistributionDomainName](#sam-api-route53configuration-distributiondomainname): String
  [EvaluateTargetHealth](#sam-api-route53configuration-evaluatetargethealth): Boolean
  [HostedZoneId](#sam-api-route53configuration-hostedzoneid): String
  [HostedZoneName](#sam-api-route53configuration-hostedzonename): String
  [IpV6](#sam-api-route53configuration-ipv6): Boolean
  Region: String
  SetIdentifier: String
  VpcEndpointDomainName: String
  VpcEndpointHostedZoneId: String
```

## Properties
<a name="sam-property-api-route53configuration-properties"></a>

 `DistributionDomainName`   <a name="sam-api-route53configuration-distributiondomainname"></a>
Configura una distribuzione personalizzata del nome di dominio personalizzato dell'API.  
▬*Tipo:* stringa  
*Obbligatorio:* no  
*Impostazione predefinita*: utilizza la distribuzione API Gateway.  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla `[DNSName](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-route53-aliastarget-1.html#cfn-route53-aliastarget-dnshostname)` proprietà di una `AWS::Route53::RecordSetGroup AliasTarget` risorsa.  
*Note aggiuntive*: il nome di dominio di una [CloudFrontdistribuzione](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-cloudfront-distribution.html).

 `EvaluateTargetHealth`   <a name="sam-api-route53configuration-evaluatetargethealth"></a>
Quando EvaluateTargetHealth è vero, un record alias eredita lo stato della AWS risorsa di riferimento, ad esempio un sistema di bilanciamento del carico Elastic Load Balancing o un altro record nella zona ospitata.  
*Tipo*: Booleano  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla proprietà di una risorsa. `[EvaluateTargetHealth](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-route53-aliastarget.html#cfn-route53-aliastarget-evaluatetargethealth)` `AWS::Route53::RecordSetGroup AliasTarget`  
*Note aggiuntive*: non è possibile impostare su EvaluateTargetHealth true quando l'alias target è una CloudFront distribuzione.

 `HostedZoneId`   <a name="sam-api-route53configuration-hostedzoneid"></a>
L'ID della zona ospitata in cui creare i record.  
Specifica `HostedZoneName` o `HostedZoneId`, ma non entrambi. Se disponi di più zone ospitate con lo stesso nome di dominio, devi specificare la zona ospitata utilizzando `HostedZoneId`.  
▬*Tipo:* stringa  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla `[HostedZoneId](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-route53-recordset-1.html#cfn-route53-recordset-hostedzoneid)` proprietà di una `AWS::Route53::RecordSetGroup RecordSet` risorsa.

 `HostedZoneName`   <a name="sam-api-route53configuration-hostedzonename"></a>
Il nome della zona ospitata in cui desideri creare record.  
Specifica `HostedZoneName` o `HostedZoneId`, ma non entrambi. Se disponi di più zone ospitate con lo stesso nome di dominio, devi specificare la zona ospitata utilizzando `HostedZoneId`.  
▬*Tipo:* stringa  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla `[HostedZoneName](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-route53-recordset-1.html#cfn-route53-recordset-hostedzonename)` proprietà di una `AWS::Route53::RecordSetGroup RecordSet` risorsa.

 `IpV6`   <a name="sam-api-route53configuration-ipv6"></a>
Quando questa proprietà è impostata, AWS SAM crea una `AWS::Route53::RecordSet` risorsa e imposta [Type](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-route53-recordset.html#cfn-route53-recordset-type) su `AAAA` quella fornita HostedZone.  
*Tipo*: Booleano  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà è unica AWS SAM e non ha un CloudFormation equivalente.

`Region`  <a name="sam-api-route53configuration-region"></a>
*Solo set di record di risorse basati sulla latenza: la* EC2 regione Amazon in cui hai creato la risorsa a cui si riferisce questo set di record di risorse. La risorsa è in genere una AWS risorsa, EC2 ad esempio un'istanza o un sistema di bilanciamento del carico ELB, a cui si fa riferimento tramite un indirizzo IP o un nome di dominio DNS, a seconda del tipo di record.  
Quando Amazon Route 53 riceve una query DNS per un nome e un tipo di dominio per i quali sono stati creati set di record di risorse di latenza, Route 53 seleziona il set di record di risorse di latenza con la latenza più bassa tra l'utente finale e la regione Amazon associata. EC2 Route 53 restituisce il valore associato al set di record della risorsa selezionato.  
Tenere presente quanto segue:  
+ È possibile specificare un `ResourceRecord` per set di record di risorse di latenza.
+ Puoi creare un solo set di record di risorse di latenza per ogni EC2 regione Amazon.
+ Non è necessario creare set di record di risorse di latenza per tutte le EC2 regioni Amazon. Route 53 sceglie la Regione con la migliore latenza tra quelle per cui hai creato i set di record della risorsa di latenza.
+ Non è possibile creare set di record di risorse non di latenza le cui proprietà `Name` e `Type` abbiano lo stesso valore dei set di record di risorse di latenza.
▬*Tipo:* stringa  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla `[ Region](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-route53-recordset-1.html#cfn-route53-recordset-region)` proprietà di un tipo di `AWS::Route53::RecordSetGroup` `RecordSet` dati.

`SetIdentifier`  <a name="sam-api-route53configuration-setidentifier"></a>
*Set di record di risorse con un criterio di routing non semplice:* un identificatore che differenzia tra più set di record di risorse che hanno la stessa combinazione di nome e tipo, ad esempio più set di record di risorse ponderati denominati acme.example.com di tipo A. In un gruppo di set di record di risorse con lo steso nome e lo stesso tipo, il valore di `SetIdentifier` deve essere univoco per ogni set di record di risorse.  
Per informazioni sulle politiche di routing, consulta la sezione [Choose a routing policy](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/routing-policy.html) nella *Amazon Route 53 Developer Guide*.  
▬*Tipo:* stringa  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla `[ SetIdentifier](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-route53-recordset-1.html#cfn-route53-recordset-setidentifier)` proprietà di un tipo di `AWS::Route53::RecordSetGroup` `RecordSet` dati.

`VpcEndpointDomainName`  <a name="sam-api-route53configuration-vpcendpointdomainname"></a>
Un nome DNS dell'endpoint dell'interfaccia VPC associato al servizio VPC API Gateway. Questa proprietà è richiesta solo per i domini privati.  
▬*Tipo:* stringa  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla `[DNSName](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-route53-recordset-aliastarget.html)` proprietà di un `AWS::Route53::RecordSet` `AliasTarget` campo.

`VpcEndpointHostedZoneId`  <a name="sam-api-route53configuration-vpcendpointhostedzoneid"></a>
L'ID della zona ospitata dell'endpoint dell'interfaccia VPC associato al servizio VPC API Gateway. Questa proprietà è richiesta solo per i domini privati.  
▬*Tipo:* stringa  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla `[HostedZoneId](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-route53-recordset-aliastarget.html)` proprietà di un `AWS::Route53::RecordSet` `AliasTarget` campo.

## Esempi
<a name="sam-property-api-route53configuration--examples"></a>

### Esempio di base
<a name="sam-property-api-route53configuration--examples--route-53-configuration-example"></a>

In questo esempio, configuriamo un dominio personalizzato e i set di record Route 53 per la nostra API.

#### YAML
<a name="sam-property-api-route53configuration--examples--route-53-configuration-example--yaml"></a>

```
Resources:
  MyApi:
    Type: AWS::Serverless::Api
    Properties:
      StageName: Prod
      Domain:
        DomainName: www.example.com
        CertificateArn: arn:aws:acm:us-east-1:123456789012:certificate/abcdef12-3456-7890-abcd-ef1234567890
        EndpointConfiguration: REGIONAL
        Route53:
          HostedZoneId: ABCDEFGHIJKLMNOP
```