

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.

# Beantragen von Telefonnummern für Datenverkehr-Verteilergruppen mithilfe von Amazon Connect
<a name="claim-phone-numbers-traffic-distribution-groups"></a>

**Anmerkung**  
**Neuer Benutzer?** Schauen Sie sich den [Workshop zu Amazon Connect Global Resiliency](https://catalog.workshops.aws/amazon-connect-global-resiliency/en-US) an. Dieser Online-Kurs führt Sie durch den Prozess des Onboardings und Testens von Rufnummern und Agenten-Failover mithilfe von New APIs über die AWS-CLI.  
Global Resiliency ist nur für Amazon Connect Connect-Instances verfügbar, die in den folgenden AWS Regionen erstellt wurden: USA Ost (Nord-Virginia), USA West (Oregon), Asien-Pazifik (Osaka), Asien-Pazifik (Tokio), Europa (Frankfurt) und Europa (London).  
Sie können ein Replikat in der Region USA Ost (Nord-Virginia) nur dann erstellen, wenn sich die Quelle in der Region USA West (Oregon) befindet oder umgekehrt. 
Sie können ein Replikat in der Region Europa (Frankfurt) nur dann erstellen, wenn die Quelle sich in der Region Europa (London) befindet oder umgekehrt.
Sie können ein Replikat in der Region Asien-Pazifik (Osaka) nur dann erstellen, wenn die Quelle sich in der Region Asien-Pazifik (Tokio) befindet.
Um Zugriff auf dieses Feature zu erhalten, wenden Sie sich an Ihren Amazon Connect Solutions Architect oder Technical Account Manager.

 Nachdem Ihre Traffic-Verteilergruppe erfolgreich erstellt wurde (`Status`ist`ACTIVE`), können Sie sie verwenden, [SearchAvailablePhoneNumbers](https://docs.aws.amazon.com/connect/latest/APIReference/API_SearchAvailablePhoneNumbers.html)um nach verfügbaren Telefonnummern zu suchen und diese [ClaimPhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_ClaimPhoneNumber.html)zu beanspruchen. 

Bevor Sie eine Telefonnummer für Ihre Verkehrsverteilergruppe beanspruchen, empfehlen wir, mithilfe der [DescribeTrafficDistributionGroup](https://docs.aws.amazon.com/connect/latest/APIReference/API_DescribeTrafficDistributionGroup.html)API zu überprüfen, ob der Status der Verkehrsverteilergruppe lautet`ACTIVE`. Das Zuweisen einer Telefonnummer zu einer Datenverkehr-Verteilergruppe, die nicht `ACTIVE` ist, führt zum Fehler `ResourceNotFoundException`. 

Sie können eine Telefonnummer für eine Verkehrsverteilergruppe beanspruchen, indem Sie beim Aufrufen der [ClaimPhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_ClaimPhoneNumber.html)API den ARN der Verkehrsverteilergruppe im **TargetArn**Parameter angeben. Sie können die [UpdatePhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_UpdatePhoneNumber.html)API auch verwenden, um eine Telefonnummer, die zuvor für eine Instanz beansprucht wurde, einer Verkehrsverteilergruppe zuzuweisen. 

**Anmerkung**  
Um das Feld **Beschreibung** zu aktualisieren, müssen Sie die Amazon-Connect-Konsole verwenden.

## Beispiel-ArbeitsFlows
<a name="example-workflow-claim"></a>

Im Folgenden finden Sie ein Beispiel für einen ArbeitsFlow, um Telefonnummern zu beanspruchen und sie für mehrere AWS-Regionen zu verwenden:

1. Erstellen Sie ein Replikat Ihrer Instance: 

   1. Rufen Sie die [ReplicateInstance](https://docs.aws.amazon.com/connect/latest/APIReference/API_ReplicateInstance.html)-API auf.

1. Erstellen Sie eine Datenverkehr-Verteilergruppe, die diese Instances miteinander verbindet:

   1. Rufen Sie die [CreateTrafficDistributionGroup](https://docs.aws.amazon.com/connect/latest/APIReference/API_CreateTrafficDistributionGroup.html)-API auf.

1. Suchen Sie nach verfügbaren Telefonnummern, die für die Datenverkehr-Verteilergruppe beansprucht werden können:

   1. Rufen Sie die [SearchAvailablePhoneNumbers](https://docs.aws.amazon.com/connect/latest/APIReference/API_SearchAvailablePhoneNumbers.html)API in der Region auf, in der die Verkehrsverteilergruppe erstellt wurde. Geben Sie den ARN der Datenverkehr-Verteilergruppe für den Parameter `TargetArn` an.

1. Rufen Sie in der Region, in der die Verkehrsverteilergruppe erstellt wurde, die [ClaimPhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_ClaimPhoneNumber.html)API auf: 

   1. Geben Sie den ARN der Datenverkehr-Verteilergruppe für den Parameter `TargetArn` an.

   1. Geben Sie den Wert für die E164-Telefonnummer an, der durch den [SearchAvailablePhoneNumbers](https://docs.aws.amazon.com/connect/latest/APIReference/API_SearchAvailablePhoneNumbers.html)API-Aufruf in Schritt 3 zurückgegeben wurde.

   Eine `PhoneNumberId` und ein `PhoneNumberArn` werden zurückgegeben. Sie können diese Werte für Folgeoperationen verwenden. 

1. Stellen Sie sicher, dass der Status der Telefonnummer `CLAIMED` lautet:

   1. Rufen Sie die [DescribePhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_DescribePhoneNumber.html)-API auf.

     (DescribePhoneNumber kann auch in der anderen Region angerufen werden, die der Verkehrsverteilergruppe zugeordnet ist. Es werden dieselben Telefonnummerndetails zurückgegeben.)

   Die Telefonnummer kann erst dann für Folgeoperationen verwendet werden, wenn ihr Status `CLAIMED` lautet. 

   Eine Beschreibung der möglichen Statuswerte finden Sie unter [Definitionen der Rufnummernstatuswerte](#claim-phone-number-status). 

1. Wiederholen Sie die Schritte 3 bis 5 für alle Telefonnummern, die Sie für die Datenverkehr-Verteilergruppe beanspruchen möchten.

1. Gehen Sie wie folgt vor, um Telefonnummern Flows zuzuordnen. Führen Sie sie in beiden Regionen aus, in denen die Datenverkehr-Verteilergruppe aktiv ist. 

   Diese Schritte stellen sicher, dass Ihr Telefonieverkehr korrekt an Ihre DatenFlows weitergeleitet wird, um Ihre Konfiguration der Datenverkehrsverteilung zu unterstützen.

   1. Gehen Sie in Ihrer bestehenden Amazon-Connect-Instance in der Region, in der die Datenverkehr-Verteilergruppe erstellt wurde, wie folgt vor:

      1. Rufen Sie die [ListContactFlows](https://docs.aws.amazon.com/connect/latest/APIReference/API_ListContactFlows.html)API auf. Geben Sie die `InstanceId` an, die der replizierten Instance entspricht. 

      1. Eine Liste von Flows ARNs wird zurückgegeben. Verwenden Sie diese ARNs Flows, um einen Flow mit einer Telefonnummer zu verknüpfen. Rufen Sie dazu die [AssociatePhoneNumberContactFlow](https://docs.aws.amazon.com/connect/latest/APIReference/API_AssociatePhoneNumberContactFlow.html)API auf. 

   1. Führen Sie in der replizierten Amazon Connect Connect-Instance in der anderen AWS Region die folgenden Schritte aus:

      1. Rufen Sie die [ListContactFlows](https://docs.aws.amazon.com/connect/latest/APIReference/API_ListContactFlows.html)API auf. Geben Sie die `InstanceId` an, die der replizierten Instance entspricht. 

      1. Eine Liste von Flows ARNs wird zurückgegeben. Verwenden Sie diese ARNs Flows, um einen Flow mit einer Telefonnummer zu verknüpfen. Rufen Sie dazu die [AssociatePhoneNumberContactFlow](https://docs.aws.amazon.com/connect/latest/APIReference/API_AssociatePhoneNumberContactFlow.html)API auf. 

## Warum schlägt ein ClaimPhoneNumber Anruf fehl
<a name="why-claimphonenumber-fails"></a>

Ihr [ClaimPhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_ClaimPhoneNumber.html)API-Aufruf schlägt `ResourceNotFoundException` in den folgenden Fällen mit einer fehl:
+ Die angegebene Datenverkehr-Verteilergruppe ist nicht vorhanden, der Status der Datenverkehr-Verteilergruppe ist nicht `ACTIVE` oder Sie sind nicht Eigentümer der Datenverkehr-Verteilergruppe.
+ Die Telefonnummer ist nicht verfügbar, um Ansprüche geltend zu machen. In einigen Fällen wurde eine Telefonnummer, von der Sie gefunden haben, [SearchAvailablePhoneNumbers](https://docs.aws.amazon.com/connect/latest/APIReference/API_SearchAvailablePhoneNumbers.html)möglicherweise von einem anderen Kunden angefordert.

[ClaimPhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_ClaimPhoneNumber.html)schlägt im folgenden Fall mit einem `InvalidParameterException` Fehler fehl:
+ Der Endpunkt, den Sie aufrufen, befindet sich nicht in derselben Region, in der die Datenverkehr-Verteilergruppe erstellt wurde.

## Definitionen der Rufnummernstatuswerte
<a name="claim-phone-number-status"></a>

Im Folgenden finden Sie eine Beschreibung der Rufnummernstatuswerte:
+ `CLAIMED`bedeutet, dass die [ClaimPhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_ClaimPhoneNumber.html)vorherige [UpdatePhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_UpdatePhoneNumber.html)Oder-Operation erfolgreich war.
+ `IN_PROGRESS`bedeutet a [ClaimPhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_ClaimPhoneNumber.html), der [UpdatePhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_UpdatePhoneNumber.html)Vorgang ist noch im Gange und wurde noch nicht abgeschlossen. Sie können zu einem späteren [DescribePhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_DescribePhoneNumber.html)Zeitpunkt anrufen, um zu überprüfen, ob der vorherige Vorgang abgeschlossen wurde.
+ `FAILED`zeigt an, dass der [ClaimPhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_ClaimPhoneNumber.html)vorherige [UpdatePhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_UpdatePhoneNumber.html)Oder-Vorgang fehlgeschlagen ist. Enthält eine Meldung, in der die Ursache des Fehlers angegeben ist. 

   Ein häufiger Grund für einen Fehlschlag ist, dass der Wert `TargetArn`, mit dem Sie eine Telefonnummer beanspruchen oder auf den Sie eine Telefonnummer aktualisieren, das Limit für die Gesamtzahl der beanspruchten Nummern erreicht hat. 

  Wenn Sie aufgrund eines API-Aufrufs von `ClaimPhoneNumber` den Status `FAILED` erhalten haben, haben Sie einen Tag Zeit, um erneut zu versuchen, die Telefonnummer zu beanspruchen, bevor die Nummer wieder in den Bestand aufgenommen wird, sodass andere Kunden sie anfordern können.