はじめに

Amazon Connectのインスタンス間で電話番号を移行する場合、アカウントやリージョンによって移行方法が異なるのでまとめました。

背景

Amazon Connectのログイン方式をId、パスワード形式からSSO形式に変更したいという要望がありました。
Amazon Connectのログイン方式は作成時にしか選択できないため、インスタンスを別途作成するしかありません。
別のインスタンスを作成するにあたり、既存のAmazon Connectで使用していた電話番号を、新規に作成したAmazon Connectインスタンスへ移行する必要がありました。その際のナレッジを記事としてまとめました。

結論

Amazon Connectの移行元と移行先のAWSアカウントやリージョンによって、電話番号移行の方法が異なります。

同一AWSアカウントで、同一リージョンの場合は、CLIによる電話番号移行が可能です
別のAWSアカウントや同一AWSアカウントでもリージョンが異なる場合は、AWSへのケース起票をする必要があります

電話番号移行をやってみた

CLIによる移行が可能なのは、既存のAmazon Connectインスタンスと移行先のインスタンスが同一アカウント・同一リージョンの場合のみです。
なお、ダウンタイムはほぼありませんでした。

まず、PhoneNumberIdを取得します。

InstanceIdはAmazon ConnectのARNの末尾に記載されています。
PhoneNumberはPhoneNumberIdを探したい電話番号を記載します（ハイフンやスペースは削除しましょう）。

aws connect list-phone-numbers --instance-id xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx --query 'PhoneNumberSummaryList[?PhoneNumber==`+815011112222`]'

実行結果

[
    {
        "Id": "zzzzzzzz-zzzz-zzzz-zzzz-zzzzzzzzzzzz",
        "Arn": "arn:aws:connect:ap-northeast-1:000000000000:instance/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/phone-number/zzzzzzzz-zzzz-zzzz-zzzz-zzzzzzzzzzzz",
        "PhoneNumber": "+815011112222",
        "PhoneNumberType": "DID",
        "PhoneNumberCountryCode": "JP"
    }
]

実際の移行は以下のコマンドを実行することで移行が可能です。
PhoneNumberIdは上記で取得したものを記載します。

aws connect update-phone-number --phone-number-id zzzzzzzz-zzzz-zzzz-zzzz-zzzzzzzzzzzz --target-arn arn:aws:connect:ap-northeast-1:000000000000:instance/yyyyyyyy-yyyy-yyyy-yyyy-yyyyyyyyyyyy

注意点

移行元のインスタンスで、移行対象の電話番号がキューの「アウトバウンド発信者 ID 番号」に設定されている場合は、移行時にエラーが発生します
- エラーが発生したらキューの「アウトバウンド発信者 ID 番号」に対象の電話番号が設定されていないか確認しましょう
移行先のインスタンスで、以下を設定する必要があります
- 電話番号に紐づく問い合わせフローの設定
- キューの「アウトバウンド発信者 ID 番号」
移行先インスタンスの電話番号数の上限
- 筆者が試したところ、上限を超えても移行はできたのですが、念のため上限は事前に緩和しておくといいと思います

既存のAmazon Connectインスタンスと移行先のインスタンスが別アカウントもしくは別リージョンの場合

CLIなどでの移行ができないため、AWSへサポート起票する必要があります。
サポート起票の際は以下の情報を含める必要があります。

・移行元のAmazonConnectのインスタンスARN

・移行先のAmazonConnectのインスタンス ARN

・移行する電話番号 (複数可)

・リクエストする移行日時

・移行先の問い合わせフロー ARN (AWS で Amazon 問い合わせフローを移行先のConnect インスタンスの移行された電話番号に関連付ける場合)

注意点

以下re:Postに記載のあった注意点を引用しています。

・リクエストした移行日時は保証されません。

・電話番号の移行ごとに 15～20 分のダウンタイムがあります。

・サポートケースを開く前に、移行する電話番号が発信者 ID として指定されていないことを確認してください。

・問い合わせフローを移行先の Connect インスタンスの移行された電話番号に関連付ける場合は、問い合わせフローが存在し、移行先の Amazon Connect インスタンスで公開されていることを確認します。

・電話番号によっては、移行できない場合があります。リクエストがこれに該当する場合は、サポートケースを通じて連絡があります

引用文献

参考資料：AWS re:Post