翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# SIP メディアアプリケーションの管理
<a name="manage-sip-applications"></a>

Amazon Chime SDK コンソールを使用して、セッション開始プロトコル (SIP) メディアアプリケーションを作成できます。SIP メディアアプリケーションを使用すると、通常は構内交換機 (PBX) に基づいて構築されるカスタム信号やメディア命令を簡単かつ迅速に作成できます。

また、 コンソールを使用して SIP ルールを作成します。SIP ルールは、SIP メディアアプリケーションが Amazon Chime SDK 会議に接続する方法を指定します。通話は、Amazon Chime SDK インベントリからプロビジョニングされたパブリック DID または通話料無料の電話番号との間で送受信できます。または、Amazon Chime SDK Voice Connector に割り当てられた名前であるリクエスト URI ホスト名との間で送受信できます。Amazon Chime SDK は、ユーザーが通話を発信または着信したときに SIP ルールを実行します。SIP ルールの使用については、「」を参照してください[SIP ルールの管理](use-sip-rules.md)。

SIP メディアアプリケーションを作成する前に、 AWS Lambda ユーザーである必要があります。SIP メディアアプリケーションは、以下の理由で Lambda 関数を使用します。
+ 意思決定を伴う複雑なロジックを書くことができます。例えば、発信者はタッチトーン電話を使用して会議にダイヤルインできます。今度は、その電話番号がトリガーする Lambda 関数が会議 PIN を要求し、発信者を正しい会議に誘導します。
+ サーバーインフラストラクチャなしで Lambda 関数をデプロイできます。

詳細については AWS Lambda、[AWS Lambda の開始方法](https://docs.aws.amazon.com/lambda/latest/dg/getting-started.html)」を参照してください。

**注記**  
Amazon Chime SDK SIP メディアアプリケーションには、アウトバウンドの国際通話の制限があります。詳細については、「[発信通話の制限](outbound-call-restrictions.md)」を参照してください。

**Topics**
+ [SIP アプリケーションとルールについて](understand-sip-data-models.md)
+ [SIP メディアアプリケーションの使用](use-sip-apps.md)

# SIP アプリケーションとルールについて
<a name="understand-sip-data-models"></a>

Amazon Chime SDK でセッション開始プロトコル (SIP) を使用するには、SIP メディアアプリケーションと SIP ルールを作成します。Amazon Chime SDK コンソールで両方を作成します。

次の図は、アプリケーションとルールの仕組みを示しています。これは SIP ルールによって電話番号とリクエスト URI のホスト名から異なる SIP アプリケーションに通話がルーティングされるしくみを示しています。

画像の数字は、画像の下のテキスト内の数字に対応しています。

![\[SIP メディアアプリケーションを優先度順にトリガーする SIP ルール。Amazon Chime SDK PSTN Audio サービスで Lambda 関数を呼び出す SIP アプリケーション。\]](http://docs.aws.amazon.com/ja_jp/chime-sdk/latest/ag/images/pstn-diagram2.png)


Chime インベントリと Voice Connector (1) から SIP ルール (2) にのみ電話番号を割り当てることができます。また、PSTN Audio サービスで電話番号または Amazon Chime SDK Voice Connector をプロビジョニングする必要があります。その方法については、「」の手順[SIP メディアアプリケーションの作成](create-sip-app.md)で説明しています。電話番号への通話を受信すると、SIP ルールは SIP メディアアプリケーションとそれに関連付けられた Lambda 関数 (4) を呼び出します。Lambda 関数は、保留中の音楽の再生、会議への参加、通話のミュートなどのアクションを呼び出すコードを実行します。マルチリージョンの回復性を提供するために、SIP ルール (2) では、フェイルオーバーの優先順位に従って、異なる AWS リージョン (3) の代替ターゲット SIP メディアアプリケーションを指定できます。1 つのターゲットが失敗した場合、PSTN Audio サービスは次のターゲットを試行します。各代替ターゲットは異なる AWS リージョンに存在する必要があることに注意してください。

# SIP メディアアプリケーションの使用
<a name="use-sip-apps"></a>

SIP メディアアプリケーションは、SIP ルールからターゲット AWS Lambda 関数に値を渡すマネージドオブジェクトです。SIP メディアアプリケーションを作成、表示、更新、および削除できます。任意のアプリケーションの詳細を表示できますが、それらのアプリケーションを自分以外の管理者も表示できる点に注意してください。

**注記**  
SIP メディアアプリケーションを作成する前に、 AWS Lambda 関数が必要です。詳細については「[AWS Lambda の使用開始](https://docs.aws.amazon.com/lambda/latest/dg/getting-started.html)」を参照してください。

**Topics**
+ [SIP メディアアプリケーションの作成](create-sip-app.md)
+ [SIP メディアアプリケーションでのタグの使用](use-tags-sip-apps.md)
+ [SIP メディアアプリケーションの表示](view-sip-app.md)
+ [SIP メディアアプリケーションの更新](update-sip-app.md)
+ [SIP メディアアプリケーションの削除](delete-sip-app.md)

# SIP メディアアプリケーションの作成
<a name="create-sip-app"></a>

SIP メディアアプリケーションは、リクエスト URI ホスト名、Amazon Chime SDK Voice Connector グループ、またはプライベート電話番号との間の呼び出しを有効にする必要がある場合に作成します。

**SIP メディアアプリケーションを作成するには**

1. [https://console.aws.amazon.com/chime-sdk/home](https://console.aws.amazon.com/chime-sdk/home) で Amazon Chime SDK コンソールを開きます。

1. ナビゲーションペインの **PSTN Audio** で **SIP メディアアプリケーション**を選択し、表示されるページで **SIP メディアアプリケーションの作成**を選択します。

1. **名前** に、アプリケーションの名前を入力します。

1. 次のいずれかの値をコピーし、**ARN** ボックスに貼り付けます。
   + Lambda 関数の ARN
   + Lambda 関数の*エイリアスの* ARN
   + Lambda 関数*のバージョン* ARN
**注記**  
Lambda 関数を構築するときにエイリアスとバージョン ARNs を作成できます。Lambda 同時実行を有効にする場合は、エイリアスまたはバージョン ARN が必要です。Lambda 関数のエイリアス、バージョンエイリアス、および同時実行の詳細については、「 *AWS Lambda デベロッパーガイド*」の[「Lambda 関数のエイリア](https://docs.aws.amazon.com/lambda/latest/dg/configuration-aliases.html)ス、[Lambda 関数のバージョン](https://docs.aws.amazon.com/lambda/latest/dg/configuration-versions.html)、および [Lambda プロビジョニング済み同時実行の管理](https://docs.aws.amazon.com/lambda/latest/dg/provisioned-concurrency.html)」を参照してください。

1. （オプション) **タグ** で新しい**タグを追加** を選択し、次の操作を行います。

   1. **キー**ボックスに値を入力します。

   1. （オプション) 値ボックスに**値**を入力します。

   1. 必要に応じて、**新しいタグを追加** を選択してタグを追加します。

1. **SIP メディアアプリケーションの作成を選択します。**

   **[Create a SIP media application]** (SIP メディアアプリケーションの作成) ページの最上部に成功メッセージが表示され、アプリケーションのリストに作成されたメディアアプリケーションが表示されます。エラーメッセージが表示された場合、その指示に従ってください。

# SIP メディアアプリケーションでのタグの使用
<a name="use-tags-sip-apps"></a>

このセクションのトピックでは、既存の Amazon Chime SDK SIP メディアアプリケーションでタグを使用する方法について説明します。タグを使用すると、SIP メディアアプリケーションなどの AWS リソースにメタデータを割り当てることができます。タグは、リソースに関する情報、またはそのリソースに保持されているデータを保存するキーとオプションの値で構成されます。すべてのキーと値を定義します。例えば、 の値`CostCenter`を持つ という名前のタグキーを作成し`98765`、そのペアをコスト配分に使用できます。SIP メディアアプリケーションには最大 50 個のタグを追加できます。

**Topics**
+ [SIP メディアアプリケーションへのタグの追加](#add-tags-sip-app)
+ [タグの編集](#edit-tags-sip-app)
+ [タグの削除](#remove-tags-sip-app)

## SIP メディアアプリケーションへのタグの追加
<a name="add-tags-sip-app"></a>

既存の Amazon Chime SDK SIP メディアアプリケーションには、最大 50 個のタグを追加できます。

**タグを追加するには**

1. [https://console.aws.amazon.com/chime-sdk/home](https://console.aws.amazon.com/chime-sdk/home) で Amazon Chime SDK コンソールを開きます。

1. ナビゲーションペインの **PSTN Audio** で、**SIP メディアアプリケーション**を選択します。

1. 使用する SIP メディアアプリケーションの名前を選択します。

1. **[タグ]** タブ、**[タグを管理]** の順に選択します。

1. **新しいタグを追加**を選択し、キーとオプションの値を入力します。

1. 必要に応じて、**新しいタグを追加** を選択して別のタグを作成します。

1. 完了したら、**[変更を保存]** を選択します。

## タグの編集
<a name="edit-tags-sip-app"></a>

必要なアクセス許可がある場合は、誰がタグを作成したかに関係なく、 AWS アカウントの任意のタグを編集できます。ただし、IAM ポリシーでは、これを行うことができない場合があります。

**タグを編集するには**

1. [https://console.aws.amazon.com/chime-sdk/home](https://console.aws.amazon.com/chime-sdk/home) で Amazon Chime SDK コンソールを開きます。

1. ナビゲーションペインの **PSTN Audio** で、**SIP メディアアプリケーション**を選択します。

1. 変更する SIP メディアアプリケーションの名前を選択します。

1. **[タグ]** タブ、**[タグを管理]** の順に選択します。

1. **キー**または**値**ボックスに、新しい値を入力します。

1. 完了したら、**[変更を保存]** を選択します。

## タグの削除
<a name="remove-tags-sip-app"></a>

必要なアクセス許可がある場合は、誰がタグを作成したかに関係なく、 AWS アカウントのタグを削除できます。ただし、IAM ポリシーでは、これを行うことができない場合があります。

**タグを削除するには**

1. [https://console.aws.amazon.com/chime-sdk/home](https://console.aws.amazon.com/chime-sdk/home) で Amazon Chime SDK コンソールを開きます。

1. ナビゲーションペインの **PSTN Audio** で、**SIP メディアアプリケーション**を選択します。

1. 変更する SIP メディアアプリケーションの名前を選択します。

1. **[タグ]** タブ、**[タグを管理]** の順に選択します。

1. 削除するタグの横にある **[削除]** を選択します。

1. [**Save changes**] (変更の保存) をクリックします。

# SIP メディアアプリケーションの表示
<a name="view-sip-app"></a>

自分の SIP メディアアプリケーションを他の管理者が詳細まで表示でき、自分は他の管理者のアプリケーションを詳細まで表示できます。

**SIP メディアアプリケーションを表示するには**

1. [https://console.aws.amazon.com/chime-sdk/home](https://console.aws.amazon.com/chime-sdk/home) で Amazon Chime SDK コンソールを開きます。

1. ナビゲーションペインで、**[SIP media applications]** (SIP メディアアプリケーション) を選択します。

   **[SIP media application]** (SIP メディアアプリケーション) ページに組織内のすべてのアプリケーションが表示されます。

1. アプリケーションの詳細を表示するには、アプリケーションの名前を選択します。

# SIP メディアアプリケーションの更新
<a name="update-sip-app"></a>

SIP メディアアプリケーションの Lambda 関数の名前と Amazon リソースネーム (ARNs) を更新できます。 AWS リージョンを更新することはできません。

**SIP メディアアプリケーションを更新するには**

1. [https://console.aws.amazon.com/chime-sdk/home](https://console.aws.amazon.com/chime-sdk/home) で Amazon Chime SDK コンソールを開きます。

1. ナビゲーションペインで、**[SIP media applications]** (SIP メディアアプリケーション) を選択します。

   **[SIP media application]** (SIP メディアアプリケーション) ページが表示されます。

1. 更新したいアプリケーションの名前を選択します。

   アプリケーションは固有のページに表示されます。

1. [**編集**] を選択します。

1. 必要に応じて、以下を変更します。
   + アプリケーションの名前
   + Lambda ARN、エイリアス ARN、またはバージョン ARN
   + タグ。タグの変更の詳細については、「」を参照してください。
**注記**  
Lambda 関数を構築するときにエイリアスとバージョン ARNs を作成できます。Lambda 同時実行を有効にする場合は、エイリアスまたはバージョン ARN が必要です。Lambda 関数のエイリアス、バージョンエイリアス、および同時実行の詳細については、「 *AWS Lambda デベロッパーガイド*」の[「Lambda 関数のエイリア](https://docs.aws.amazon.com/lambda/latest/dg/configuration-aliases.html)ス、[Lambda 関数のバージョン](https://docs.aws.amazon.com/lambda/latest/dg/configuration-versions.html)、および [Lambda プロビジョニング済み同時実行の管理](https://docs.aws.amazon.com/lambda/latest/dg/provisioned-concurrency.html)」を参照してください。

1. [**Save**] を選択します。

   成功メッセージが表示されます。エラーメッセージが表示された場合、その指示に従ってください。

# SIP メディアアプリケーションの削除
<a name="delete-sip-app"></a>

SIP メディアアプリケーションを削除したい理由としてはいくつかがあり、次のような例が挙げられます。
+ 電話番号またはリクエスト URI のホスト名の使用を停止します。
+ SIP メディアアプリケーションの作成が間違っています。

**注記**  
ベストプラクティスとして、アプリケーションを削除しても通話の流れが中断されないことを確認します。また、アプリケーションを削除しても、関連する電話番号や SIP ルールは削除されません。

**SIP メディアアプリケーションを削除するには**

1. [https://console.aws.amazon.com/chime-sdk/home](https://console.aws.amazon.com/chime-sdk/home) で Amazon Chime SDK コンソールを開きます。

1. ナビゲーションペインで、**[SIP media applications]** (SIP メディアアプリケーション) を選択します。

   **[SIP media application]** (SIP メディアアプリケーション) ページが表示されます。

1. アプリケーション名の隣にあるオプションボタンを選択します。

1. [**削除**] を選択します。

   **[Delete** *application name]* (アプリケーション名の削除) ダイアログボックスが表示されます。

1. **[I understand that this action cannot be reversed]** (この処理は元に戻せないことを理解しています) を選択してから **[Delete]** (削除) を選択します。