

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

# Fehlerbehebung bei benutzerdefinierten Domains
<a name="troubleshooting-custom-domains"></a>

Wenn beim Verbinden einer benutzerdefinierten Domain mit Ihrer Amplify-Anwendung Probleme auftreten, finden Sie in den Themen in diesem Abschnitt Hilfe.

Wenn Sie hier keine Lösung für Ihr Problem finden, wenden Support Sie sich an. Weitere Informationen finden Sie unter [Erstellen eines Support-Falls](https://docs.aws.amazon.com/awssupport/latest/user/case-management.html#creating-a-support-case) im *Benutzerhandbuch von AWS Support *.

**Topics**
+ [Ich muss überprüfen, ob mein CNAME behoben wird](#how-do-i-verify-that-my-cname-resolves)
+ [Meine bei einem Drittanbieter gehostete Domain befindet sich im Status „Ausstehende Überprüfung“](#my-domain-hosted-with-a-third-party-is-stuck-in-the-pending-verification-state)
+ [Meine mit Amazon Route 53 gehostete Domain befindet sich im Status „Ausstehende Überprüfung“](#my-domain-hosted-with-amazon-route-53-is-stuck-in-the-pending-verification-state)
+ [Meine App mit mehrstufigen Subdomains befindet sich im Status „Ausstehende Überprüfung“](#multilevel-domain-is-stuck-in-the-pending-verification-state)
+ [Mein DNS-Anbieter unterstützt keine A-Einträge mit vollständig qualifizierten Domainnamen](#FQDN-A-recored-unsupported)
+ [Ich erhalte eine Fehlermeldung CNAMEAlready ExistsException](#i-get-a-cnamealreadyexistsexception-error)
+ [Ich erhalte die Fehlermeldung „Zusätzliche Überprüfung erforderlich“](#i-get-an-additionalverificationrequired-error)
+ [Ich erhalte eine 404-Fehlermeldung für die URL CloudFront](#i-get-a-404-cloudfront-url)
+ [Ich erhalte beim Besuch meiner Domain SSL-Zertifikat- oder HTTPS-Fehler](#ssl-HTTPS-errors-on-domain)
+ [Pfadkomponenten werden in Domainumleitungen nicht unterstützt](#domain-redirects-path-components)
+ [Ich erhalte die Fehlermeldung 400 für die kontoübergreifende Domänenzuweisung](#cross-account-domain-association-400-error)

## Ich muss überprüfen, ob mein CNAME behoben wird
<a name="how-do-i-verify-that-my-cname-resolves"></a>

1. Nachdem Sie Ihre DNS-Einträge bei Ihrem Drittanbieter für Domains aktualisiert haben, können Sie ein Tool wie [dig](https://en.wikipedia.org/wiki/Dig_(command)) oder eine kostenlose Website wie [https://www.whatsmydns.net/](https://www.whatsmydns.net/) verwenden, um zu überprüfen, ob Ihr CNAME-Eintrag korrekt aufgelöst wird. **Der folgende Screenshot zeigt, wie Sie whatsmydns.net verwenden, um Ihren CNAME-Eintrag für die Domain www.example.com zu überprüfen.**  
![\[Die whatsmydns.net-Anwendung, in der Sie den Namen einer zu überprüfenden Website eingeben.\]](http://docs.aws.amazon.com/de_de/amplify/latest/userguide/images/amplify-troubleshooting-whatsmydns-1Update.png)

1. Wählen Sie **Suchen** und **whatsmydns.net** zeigt die Ergebnisse für Ihren CNAME an. Der folgende Screenshot ist ein Beispiel für eine Ergebnisliste, die bestätigt, dass der CNAME korrekt in eine cloudfront.net-URL aufgelöst wird.  
![\[Die whatsmydns.net-Anwendung zeigt die Ergebnisse einer CNAME-Auflösung.\]](http://docs.aws.amazon.com/de_de/amplify/latest/userguide/images/amplify-troubleshooting-whatsmydns-2Update.png)

## Meine bei einem Drittanbieter gehostete Domain befindet sich im Status „Ausstehende Überprüfung“
<a name="my-domain-hosted-with-a-third-party-is-stuck-in-the-pending-verification-state"></a>

1. Wenn bei Ihrer benutzerdefinierten Domain der Status „**Überprüfung ausstehend**“ nicht mehr angezeigt wird, überprüfen Sie, ob CNAME Ihre Daten behoben werden. Anweisungen zur Durchführung dieser Aufgabe finden Sie im vorherigen Thema zur [CNAMEProblembehebung, Wie überprüfe ich, ob meine Probleme behoben](#how-do-i-verify-that-my-cname-resolves) sind?

1. Wenn Ihre CNAME Datensätze nicht aufgelöst werden, überprüfen Sie bei Ihrem Domain-Anbieter, ob der CNAME Eintrag in Ihren DNS-Einstellungen vorhanden ist.
**Wichtig**  
 Es ist wichtig, dass Sie Ihre CNAME Einträge aktualisieren, sobald Sie Ihre benutzerdefinierte Domain erstellt haben. Nachdem Ihre App in der Amplify-Konsole erstellt wurde, wird Ihr CNAME Datensatz alle paar Minuten überprüft, um festzustellen, ob er aufgelöst wird. Wenn es nach einer Stunde nicht behoben wird, wird die Überprüfung alle paar Stunden durchgeführt, was zu einer Verzögerung bei der Einsatzbereitschaft Ihrer Domain führen kann. Wenn Sie Ihre CNAME Datensätze einige Stunden nach der Erstellung Ihrer App hinzugefügt oder aktualisiert haben, ist dies der wahrscheinlichste Grund dafür, dass Ihre App im Status „**Ausstehende Überprüfung**“ hängen bleibt.

1. Wenn Sie überprüft haben, dass der CNAME Eintrag existiert, liegt möglicherweise ein Problem mit Ihrem DNS-Anbieter vor. Sie können sich entweder an den DNS-Anbieter wenden, um zu diagnostizieren, warum die DNS-Überprüfung CNAME nicht funktioniert, oder Sie können Ihr DNS auf Route 53 migrieren. Weitere Informationen finden Sie unter [Amazon Route 53 zum DNS-Service für eine bestehende Domain machen](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/MigratingDNS.html).

## Meine mit Amazon Route 53 gehostete Domain befindet sich im Status „Ausstehende Überprüfung“
<a name="my-domain-hosted-with-amazon-route-53-is-stuck-in-the-pending-verification-state"></a>

Wenn Sie Ihre Domain zu Amazon Route 53 übertragen haben, ist es möglich, dass Ihre Domain andere Nameserver hat als die, die von Amplify bei der Erstellung Ihrer App ausgestellt wurden. Führen Sie die folgenden Schritte aus, um die Ursache des Fehlers zu diagnostizieren.

1. Melden Sie sich bei der [Amazon Route 53 53-Konsole](https://console.aws.amazon.com/route53/home) an

1. Wählen Sie im Navigationsbereich **Hosted Zones** und dann den Namen der Domain aus, mit der Sie eine Verbindung herstellen.

1. Notieren Sie sich die Nameserver-Werte aus dem Abschnitt **Hosted Zone Details**. Sie benötigen diese Werte, um den nächsten Schritt abzuschließen. Der folgende Screenshot der Route 53-Konsole zeigt die Position der Nameserver-Werte in der unteren rechten Ecke.  
![\[Der Abschnitt Hosted Zone Details in der Route 53 53-Konsole, in dem die Nameserver-Werte angezeigt werden.\]](http://docs.aws.amazon.com/de_de/amplify/latest/userguide/images/1555952748759-111.png)

1. Klicken Sie im Navigationsbereich auf **Registered domains (Registrierte Domains)**. Stellen Sie sicher, dass die im Abschnitt **Registrierte Domänen** angezeigten Nameserver mit den Nameserver-Werten übereinstimmen, die Sie im vorherigen Schritt im Abschnitt **Details zur gehosteten Zone** aufgezeichnet haben. Wenn sie nicht übereinstimmen, bearbeiten Sie die Nameserver-Werte so, dass sie mit den Werten in Ihrer **Hostzone** übereinstimmen. Der folgende Screenshot der Route 53-Konsole zeigt die Position der Nameserver-Werte auf der rechten Seite.  
![\[Der Abschnitt Registrierte Domänen der Route 53 53-Konsole, in dem die Nameserver-Werte angezeigt werden.\]](http://docs.aws.amazon.com/de_de/amplify/latest/userguide/images/1555952748759-607.png)

1. Wenn das Problem dadurch nicht behoben wird, wenden Sie sich an Support. Weitere Informationen finden Sie unter [Erstellen eines Support-Falls](https://docs.aws.amazon.com/awssupport/latest/user/case-management.html#creating-a-support-case) im *Benutzerhandbuch von AWS Support *.

## Meine App mit mehrstufigen Subdomains befindet sich im Status „Ausstehende Überprüfung“
<a name="multilevel-domain-is-stuck-in-the-pending-verification-state"></a>

Wenn eine App mit mehrstufigen Subdomains beim Herstellen einer Verbindung zu einem DNS-Drittanbieter im Status „**Ausstehende Überprüfung**“ hängen bleibt, liegt möglicherweise ein Problem mit dem Format Ihrer DNS-Einträge vor. Einige DNS-Anbieter fügen Ihren Einträgen automatisch die Domainsuffixe Second-Level-Domain (SLD) und Top-Level-Domain (TLD) hinzu. Wenn Sie die Domain auch in dem Format angeben, das SLD und TLD enthält, kann dies zu Problemen bei der Domainverifizierung führen.

Wenn Sie eine Domain verbinden, versuchen Sie zunächst, den Domainnamen im vollständigen Format anzugeben, das beispielsweise `_hash.docs.backend.example.com` von Amplify bereitgestellt wird. Wenn die SSL-Konfiguration im Status „**Ausstehende Überprüfung**“ hängen bleibt, versuchen Sie, die TLD und SLD aus den Datensätzen zu entfernen. Wenn das vollständige Format beispielsweise lautet`_hash.docs.backend.example.com`, geben Sie an. `_hash.docs.backend` Warten Sie 15 bis 30 Minuten, bis sich die Datensätze verbreiten können. Verwenden Sie dann ein Tool wie MX Toolbox, um zu überprüfen, ob der Überprüfungsprozess funktioniert.

## Mein DNS-Anbieter unterstützt keine A-Einträge mit vollständig qualifizierten Domainnamen
<a name="FQDN-A-recored-unsupported"></a>

Einige DNS-Anbieter unterstützen keine A-Einträge mit einem vollqualifizierten Domainnamen (FQDN), wie `example.cloudfront.net` z. Cloudflare A records kann beispielsweise nur IPv4 Adressen schreiben und unterstützt dies nicht. FQDNs Um diese Einschränkung zu umgehen, empfehlen wir, CNAME Datensätze anstelle von Datensätzen A records in Ihrer DNS Konfiguration zu verwenden.

Als Beispiel verwendet die folgende DNS Konfiguration eineA record.

```
A     | @ | ***.cloudfront.net
CNAME | www | ***.cloudfront.net
```

Ändern Sie sie auf die folgende DNS Konfiguration, um nur CNAME Datensätze zu verwenden.

```
CNAME | @ | ***.cloudfront.net  
CNAME | www | ***.cloudfront.net
```

Diese Problemumgehung ermöglicht es Ihnen, Ihre Apex-Domain (@-Eintrag) korrekt auf Dienste wie CloudFront zu verweisen und gleichzeitig die Beschränkung „ IPv4Nur“ A records im Cloudflare-System zu umgehen. 

## Ich erhalte eine Fehlermeldung CNAMEAlready ExistsException
<a name="i-get-a-cnamealreadyexistsexception-error"></a>

Wenn Sie eine **CNAMEAlreadyExistsException**Fehlermeldung erhalten, bedeutet dies, dass einer der Hostnamen, mit denen Sie versucht haben, eine Verbindung herzustellen (eine Subdomain oder die Apex-Domain), bereits für eine andere CloudFront Amazon-Distribution bereitgestellt ist. Die Ursache Ihres Fehlers hängt von Ihren aktuellen Hosting- und DNS-Anbietern ab.

Ein CNAME Alias wie `example.com` oder `sub.example.com` kann jeweils nur einer CloudFront Distribution zugeordnet werden. Das **CNAMEAlreadyExistsException**bedeutet, dass Ihre Domain bereits mit einer anderen CloudFront Distribution verknüpft ist, entweder innerhalb desselben AWS-Konto oder möglicherweise in einem anderen Konto. Die Domain muss von der vorherigen CloudFront Distribution getrennt werden, bevor die von Amplify Hosting erstellte neue Distribution funktioniert. Möglicherweise müssen Sie mehr als ein Konto überprüfen, wenn Sie oder Ihre Organisation mehrere AWS-Konto s besitzen.

Führen Sie die folgenden Schritte aus, um die Ursache des **CNAMEAlreadyExistsException**Fehlers zu diagnostizieren.

1. Melden Sie sich bei der [ CloudFront Amazon-Konsole](https://console.aws.amazon.com/cloudfront/home?#) an und vergewissern Sie sich, dass Sie diese Domain nicht für eine andere Distribution bereitgestellt haben. Ein einzelner CNAME Datensatz kann jeweils an eine CloudFront Distribution angehängt werden.

1. Wenn Sie die Domain zuvor für eine CloudFront Distribution bereitgestellt haben, müssen Sie sie entfernen.

   1. Wählen Sie **im linken Navigationsmenü Distributionen** aus.

   1. Wählen Sie den Namen der Distribution aus, die bearbeitet werden soll.

   1. Wählen Sie die Registerkarte **Allgemein**. Wählen Sie im Abschnitt **Settings** (Einstellungen) die Option **Edit** (Bearbeiten) aus.

   1. Entfernen Sie den Domainnamen aus dem **alternativen Domainnamen (CNAME)**. Wählen Sie dann „**Änderungen speichern**“.

1. Vergewissern Sie sich, dass keine andere CloudFront Distribution existiert, die diese Domain in der aktuellen AWS-Konto oder anderen verwendet AWS-Konten. Wenn dadurch keine aktuell laufenden Dienste gestört werden, versuchen Sie, die gehostete Zone zu löschen und neu zu erstellen.

1. Überprüfe, ob diese Domain mit einer anderen Amplify-App verbunden ist, die du besitzt. Stellen Sie in diesem Fall sicher, dass Sie nicht versuchen, einen der Hostnamen wiederzuwenden. Wenn Sie eine andere App verwenden`www.example.com`, können Sie sie nicht `www.example.com` mit der App verwenden, mit der Sie gerade eine Verbindung herstellen. Sie können andere Subdomains verwenden, wie `blog.example.com` z.

1. Wenn diese Domain erfolgreich mit einer anderen App verbunden und dann innerhalb der letzten Stunde gelöscht wurde, versuchen Sie es nach mindestens einer Stunde erneut. Wenn Sie diese Ausnahme nach 6 Stunden immer noch sehen, wenden Sie sich an Support. Weitere Informationen finden Sie unter [Erstellen eines Support-Falls](https://docs.aws.amazon.com/awssupport/latest/user/case-management.html#creating-a-support-case) im *Benutzerhandbuch von AWS Support *.

1. Wenn Sie Ihre Domain über Route 53 verwalten, stellen Sie sicher, dass Sie alle gehosteten Zonen CNAME oder ALIAS Datensätze bereinigen, die auf die alte CloudFront Distribution verweisen. 

1. Nachdem Sie die vorherigen Schritte abgeschlossen haben, entfernen Sie die benutzerdefinierte Domain aus Amplify Hosting und beginnen Sie erneut mit dem Workflow, um eine benutzerdefinierte Domain in der Amplify-Konsole zu verbinden.

## Ich erhalte die Fehlermeldung „Zusätzliche Überprüfung erforderlich“
<a name="i-get-an-additionalverificationrequired-error"></a>

Wenn Sie die Fehlermeldung „**Zusätzliche Überprüfung erforderlich**“ erhalten, bedeutet dies, dass AWS Certificate Manager (ACM) zusätzliche Informationen benötigt, um diese Zertifikatsanforderung zu bearbeiten. Dies kann als Betrugsschutzmaßnahme geschehen, z. B. wenn die Domäne unter den [Top 1000 Websites von Alexa](https://aws.amazon.com/marketplace/pp/Amazon-Web-Services-Alexa-Top-Sites/B07QK2XWNV) rangiert. Um diese Informationen bereitzustellen, kontaktieren Sie [ über das ](https://console.aws.amazon.com/support/home)Support-Center Support. Wenn Sie über keinen Supportplan verfügen, veröffentlichen Sie einen neuen Thread im [ACM-Diskussionsforum](https://forums.aws.amazon.com/forum.jspa?forumID=206).

**Anmerkung**  
Sie können kein Zertifikat für Amazon-eigene Domainnamen, wie solche, die mit amazonaws.com, cloudfront.net oder elasticbeanstalk.com enden, anfordern.

## Ich erhalte eine 404-Fehlermeldung für die URL CloudFront
<a name="i-get-a-404-cloudfront-url"></a>

Um Traffic bereitzustellen, verweist Amplify Hosting über einen CNAME-Record auf eine CloudFront URL. Beim Verbinden einer App mit einer benutzerdefinierten Domain zeigt die Amplify-Konsole die CloudFront URL für die App an. Über diese CloudFront URL können Sie jedoch nicht direkt auf Ihre Anwendung zugreifen. Es wird ein 404-Fehler zurückgegeben. Ihre Anwendung wird nur mithilfe der Amplify-App-URL (z. B.`https://main.d5udybEXAMPLE.amplifyapp.com`) oder Ihrer benutzerdefinierten Domain (zum Beispiel`www.example.com`) aufgelöst.

Amplify muss Anfragen an den richtigen bereitgestellten Branch weiterleiten und verwendet dazu den Hostnamen. Sie können beispielsweise die Domain `www.example.com` konfigurieren, die auf den Mainline-Zweig einer App verweist, aber auch konfigurieren, `dev.example.com` dass sie auf den Entwicklungszweig derselben App verweist. Daher müssen Sie Ihre Anwendung auf der Grundlage der konfigurierten Subdomains aufrufen, damit Amplify die Anfragen entsprechend weiterleiten kann.

## Ich erhalte beim Besuch meiner Domain SSL-Zertifikat- oder HTTPS-Fehler
<a name="ssl-HTTPS-errors-on-domain"></a>

Wenn Sie DNS-Einträge für Certificate Authority Authorization (CAA) bei Ihrem DNS-Drittanbieter konfiguriert haben, kann AWS Certificate Manager (ACM) möglicherweise keine Zwischenzertifikate für Ihr benutzerdefiniertes Domain-SSL-Zertifikat aktualisieren oder neu ausstellen. Um dieses Problem zu lösen, müssen Sie einen CAA-Eintrag hinzufügen, um mindestens einer der Zertifizierungsstellen-Domains von Amazon zu vertrauen. Das folgende Verfahren beschreibt die Schritte, die Sie ausführen müssen.

**So fügen Sie einen CAA-Eintrag hinzu, um einer Amazon-Zertifizierungsstelle zu vertrauen**

1. Konfigurieren Sie einen CAA-Eintrag bei Ihrem Domain-Anbieter, um mindestens einer der Amazon-Zertifizierungsstellen-Domains zu vertrauen. *Weitere Informationen zur Konfiguration des CAA-Eintrags finden Sie unter [Probleme mit der Zertifizierungsstellen-Autorisierung (CAA)](https://docs.aws.amazon.com/acm/latest/userguide/troubleshooting-caa.html) im AWS Certificate Manager Benutzerhandbuch.*

1. Verwenden Sie eine der folgenden Methoden, um Ihr SSL-Zertifikat zu aktualisieren:
   + Manuelles Update mit der Amplify-Konsole.
**Anmerkung**  
Diese Methode führt zu Ausfallzeiten für Ihre benutzerdefinierte Domain.

     1. Melden Sie sich bei der an AWS-Managementkonsole und öffnen Sie die [Amplify-Konsole](https://console.aws.amazon.com/amplify/).

     1. Wählen Sie Ihre App aus, zu der Sie einen CAA-Eintrag hinzufügen möchten.

     1. Wählen Sie im Navigationsbereich **App-Einstellungen**, **Domainverwaltung** aus.

     1. Löschen Sie auf der Seite **Domainverwaltung** die benutzerdefinierte Domain.

     1. Connect deine App erneut mit der benutzerdefinierten Domain. Durch diesen Vorgang wird ein neues SSL-Zertifikat ausgestellt, und die Zwischenzertifikate können jetzt von ACM verwaltet werden. 

        Verwenden Sie eines der folgenden Verfahren, das dem von Ihnen verwendeten Domain-Anbieter entspricht, um Ihre App wieder mit Ihrer benutzerdefinierten Domain zu verbinden.
        + [Hinzufügen einer von Amazon Route 53 verwalteten benutzerdefinierten Domain](to-add-a-custom-domain-managed-by-amazon-route-53.md).
        + [Hinzufügen einer benutzerdefinierten Domain, die von einem DNS-Drittanbieter verwaltet wird](to-add-a-custom-domain-managed-by-a-third-party-dns-provider.md).
        + [Aktualisierung von DNS-Einträgen für eine Domain, die verwaltet wird von GoDaddy](to-add-a-custom-domain-managed-by-godaddy.md).
   + Wenden Sie sich Support an uns, um Ihr SSL-Zertifikat erneut ausstellen zu lassen.

## Pfadkomponenten werden in Domainumleitungen nicht unterstützt
<a name="domain-redirects-path-components"></a>

Domainweiterleitungen stimmen nur mit dem Teil des Hostnamens überein. Pfadkomponenten in domänenbasierten Quellregeln (z. B.`"https://domain.com/path"`) werden nicht unterstützt und führen dazu, dass die Regel fehlerfrei ignoriert wird. Weitere Informationen finden Sie unter [Leitet die Beispielreferenz weiter und schreibt sie neu](redirect-rewrite-examples.md).

## Ich erhalte die Fehlermeldung 400 für die kontoübergreifende Domänenzuweisung
<a name="cross-account-domain-association-400-error"></a>

Wenn DomainAssociation Sie eine Anfrage für eine Amplify-App mit einer Domain initiieren, die bereits oder zuvor mit verschiedenen Amplify-Apps in anderen AWS-Konten in derselben Region verknüpft ist oder war, wird dies als kontoübergreifende Domain-Zuordnung betrachtet. Wenn Sie diesen Fehler erhalten, bedeutet dies, dass Sie versuchen, eine kontoübergreifende Domainverknüpfung zu verknüpfen, was eine manuelle Überprüfung erfordert. Wenn Sie mit einer kontoübergreifenden Domain-Zuordnung fortfahren möchten, wenden Sie sich bitte an den AWS-Support, um Unterstützung zu erhalten.