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à.

# `AWSSupport-TroubleshootAPIGatewayCustomDomainConfig`
<a name="automation-awssupport-troubleshootapigateway-customdomainconfig"></a>

 **Descrizione** 

Il `AWSSupport-TroubleshootAPIGatewayCustomDomainConfig` runbook ti aiuta a identificare i problemi relativi alla configurazione del nome di dominio personalizzato in Amazon API Gateway. Il runbook analizza i seguenti passaggi di configurazione:
+ Un nome di dominio personalizzato viene creato in API Gateway.
+ Esiste una mappatura tra il nome di dominio personalizzato e l'API in questione.
+ Esiste un record DNS per il nome di dominio personalizzato che punta alla destinazione corretta.

**Importante**  
Questo runbook non supporta la risoluzione dei problemi MTL con i nomi di dominio personalizzati di API Gateway.

**Importante**  
Questo runbook supporta solo la risoluzione dei problemi relativi ai nomi di dominio personalizzati risolvibili pubblicamente.

 [Esegui questa automazione (console)](https://console.aws.amazon.com/systems-manager/automation/execute/AWSSupport-TroubleshootAPIGatewayCustomDomainConfig) 

**Tipo di documento**

Automazione

**Proprietario**

Amazon

**Piattaforme**

/

**Autorizzazioni IAM richieste**

Il `AutomationAssumeRole` parametro richiede le seguenti azioni per utilizzare correttamente il runbook.
+ `apigateway:GET`
+ `route53:ListResourceRecordSets`

Policy IAM di esempio:

```
{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "apigateway:GET",
                "route53:ListResourceRecordSets"
            ],
            "Resource": "*"
        }
    ]
}
```

**Nota**  
L'utente o il ruolo IAM che avvia il runbook richiede le seguenti azioni:  
`iam:ListRoles`
`iam:PassRole`
`ssm:DescribeAutomationExecutions`
`ssm:DescribeAutomationStepExecutions`
`ssm:DescribeDocument`
`ssm:GetAutomationExecution`
`ssm:GetDocument`
`ssm:ListDocuments`
`ssm:StartAutomationExecution`

 **Istruzioni** 

Segui questi passaggi per configurare l'automazione:

1. Accedere [https://console.aws.amazon.com/systems-manager/documents/AWSSupport-TroubleshootAPIGatewayCustomDomainConfig/description](https://console.aws.amazon.com/systems-manager/documents/AWSSupport-TroubleshootAPIGatewayCustomDomainConfig/description)a Systems Manager nella sezione Documenti.

1. Seleziona Execute automation (Esegui automazione).

1. Per i parametri di input, immettete quanto segue:
   + **AutomationAssumeRole (Facoltativo):**

     L'Amazon Resource Name (ARN) del ruolo IAM che consente a Systems Manager Automation di eseguire le azioni per tuo conto. Se non viene specificato alcun ruolo, Systems Manager Automation utilizza le autorizzazioni dell'utente che avvia questo runbook.
   + **DomainName (Obbligatorio):**

     Il nome di dominio personalizzato creato per la tua API Amazon API Gateway.
   + **ApiId (Obbligatorio):**

     L'ID API del tuo API Gateway.
   + **DNSServerIp (Facoltativo):**

     Indirizzo IPv4 di un server DNS per risolvere il nome di dominio personalizzato e il nome di dominio API Gateway. Se non viene specificato un valore, verrà utilizzato il server AWS DNS (169.254.169.253).
   + **HostedZoneId (Facoltativo):**

     L'ID della zona ospitata pubblica in cui viene creato il record DNS per il nome di dominio personalizzato in Amazon Route 53. Se Route 53 non viene utilizzata per DNS, il valore non è richiesto.

1. Seleziona Esegui.

1. L'automazione viene avviata.

1. Il documento esegue le seguenti operazioni:
   + **`CheckAPIExists`**:

     Verifica l'esistenza dell'API Amazon API Gateway.
   + **`GetDomainName`**:

     Ottiene i dettagli per il nome di dominio personalizzato configurato in Amazon API Gateway.
   + **`GetMappings`**:

     Recupera tutte le mappature API di Amazon API Gateway configurate per il nome di dominio personalizzato e verifica se l'ID API specificato ha una mappatura valida con le configurazioni di fase e percorso corrette.
   + **`CheckDNSRecordExists`**:

     Controlla il DNS del nome di dominio personalizzato e restituisce i record associati.
   + **`ValidateDNSResults`**:

     Confronta i dettagli DNS (record A o CNAME) del nome di dominio personalizzato per garantire che il record punti al nome di dominio di distribuzione Amazon API Gateway corretto.
   + **`Results`**:

     Formatta l'output complessivo di Systems Manager Automation per restituire un riepilogo strutturato dei risultati dell'analisi della configurazione personalizzata del dominio alla console Systems Manager.

1. Al termine, consulta la sezione Output per i risultati dettagliati dell'esecuzione.

**Riferimenti**

Systems Manager Automation
+ [Esegui questa automazione (console)](https://console.aws.amazon.com/systems-manager/documents/AWSSupport-TroubleshootAPIGatewayCustomDomainConfig/description)
+ [Esegui un'automazione](https://docs.aws.amazon.com//systems-manager/latest/userguide/automation-working-executing.html)
+ [Configurazione di un'automazione](https://docs.aws.amazon.com//systems-manager/latest/userguide/automation-setup.html)
+ [Flussi di lavoro di Support Automation](https://aws.amazon.com/premiumsupport/technology/saw/)