本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。 # 管理 SIP 媒体应用程序 您可以使用 Amazon Chime 软件开发工具包控制台创建会话初始协议 (SIP) 媒体应用程序。SIP 媒体应用程序使您可以更轻松、更快地创建自定义信令和媒体指令，而这些指令通常是在专用分支电话交换机 (PBX) 上构建的。 您还可以使用控制台创建 SIP 规则。SIP 规则指定 SIP 媒体应用程序如何连接到 Amazon Chime SDK 会议。呼叫可以拨打公共 DID 或从您的 Amazon Chime SDK 库存中配置的免费电话号码，也可以拨出请求 URI 主机名（分配给 Amazon Chime SDK 语音连接器的名称）。当用户拨打或接听电话时，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 应用程序和规则 要将会话初始化协议 (SIP) 与 Amazon Chime SDK 配合使用，您需要创建 SIP 媒体应用程序和 SIP 规则。您可以在 Amazon Chime 软件开发工具包控制台中创建两者。 下图显示了应用程序和规则的工作原理。它显示了 SIP 规则如何将来自电话号码和请求 URI 主机名的呼叫路由到不同的 SIP 应用程序。 图片中的数字对应于其下面文本的编号： ![\[按优先顺序触发 SIP 媒体应用程序的 SIP 规则；在 Amazon Chime SDK PSTN 音频服务中调用 Lambda 函数的 SIP 应用程序。\]](http://docs.aws.amazon.com/zh_cn/chime-sdk/latest/ag/images/pstn-diagram2.png) 您只能将 Chime 库存和语音连接器 (1) 中的电话号码分配给 SIP 规则 (2)。此外，您还必须在 PSTN 音频服务中配置电话号码或 Amazon Chime SDK 语音连接器，中的步骤[创建 SIP 媒体应用程序](create-sip-app.md)说明了如何执行此操作。接到电话号码的呼叫后，SIP 规则会调用 SIP 媒体应用程序及其关联的 Lambda 函数 (4)。Lambda 函数运行调用操作的代码，例如播放暂停的音乐、加入会议或将通话静音。为了提供多区域弹性，SIP 规则 (2) 可以按故障转移的优先顺序指定不同 AWS 区域 (3) 中的备用目标 SIP 媒体应用程序。如果一个目标失败，PSTN 音频服务将尝试下一个目标。请注意，每个备用目标必须位于不同的 AWS 区域。 # 使用 SIP 媒体应用程序 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 媒体应用程序 当您需要启用对请求 URI 主机名、Amazon Chime SDK 语音连接器组或私人电话号码的呼入和呼出时，您可以创建 SIP 媒体应用程序。 **创建 SIP 媒体应用程序** 1. [在家中打开 Amazon Chime SDK 控制台。https://console.aws.amazon.com/chime-sdk/](https://console.aws.amazon.com/chime-sdk/home) 1. 在导航窗格的 “**PSTN 音频**” 下，选择 **SIP 媒体应用程序**，然后在出现的页面上选择 “**创建 SIP 媒体**应用程序”。 1. 在 “**名称**” 下，输入应用程序的名称。 1. 复制以下值之一并将其粘贴到 **ARN 框**中： + Lambda 函数的 ARN + Lambda 函数*别*名的 ARN + Lambda 函数*版本的* ARN **注意** 您可以在构建 Lambda 函数 ARNs 时创建别名和版本，如果要启用 Lambda 并发，则必须具有别名或版本 ARN。[https://docs.aws.amazon.com/lambda/latest/dg/provisioned-concurrency.html](https://docs.aws.amazon.com/lambda/latest/dg/provisioned-concurrency.html) 1. （可选）在 “**标签**” 下，选择 “**添加新标签**”，然后执行以下操作： 1. 在**密钥**框中输入一个值。 1. （可选）在 “值” 框中输入一个**值**。 1. 根据需要，选择**添加新标签**以添加更多标签。 1. 选择**创建 SIP 媒体应用程序。** 。 成功消息显示在 “**创建 SIP 媒体应用程序**” 页面的顶部，并且您的媒体应用程序将出现在应用程序列表中。如果您看到错误消息，请按照其说明进行操作。 # 在 SIP 媒体应用程序中使用标签 本节中的主题说明了如何在现有的 Amazon Chime SDK SIP 媒体应用程序中使用标签。标签允许您为 AWS 资源（例如 SIP 媒体应用程序）分配元数据。标签由密钥和可选值组成，用于存储有关资源或该资源上保留的数据的信息。您可以定义所有键和值。例如，您可以创建一个名为`CostCenter`、值为的标签密钥，`98765`然后使用该对进行成本分配。您最多可以向 SIP 媒体应用程序添加 50 个标签。 **Topics** + [向 SIP 媒体应用程序添加标签](#add-tags-sip-app) + [编辑标签](#edit-tags-sip-app) + [删除标签](#remove-tags-sip-app) ## 向 SIP 媒体应用程序添加标签 您可以向现有的 Amazon Chime SDK SIP 媒体应用程序添加多达 50 个标签。 **添加 标签** 1. [在家中打开 Amazon Chime SDK 控制台。https://console.aws.amazon.com/chime-sdk/](https://console.aws.amazon.com/chime-sdk/home) 1. 在导航窗格的 **PSTN 音频**下，选择 **SIP 媒体应用程序**。 1. 选择要使用的 SIP 媒体应用程序的名称。 1. 选择**标签**选项卡，然后选择**管理标签**。 1. 选择 “**添加新标签**”，然后输入密钥和可选值。 1. 根据需要，选择**添加新标签**以创建另一个标签。 1. 完成后，选择**保存更改**。 ## 编辑标签 如果您拥有必要的权限，则可以编辑 AWS 账户中的任何标签，而不管这些标签是谁创建的。但是，IAM 策略可能会阻止您这样做。 **编辑标签** 1. [在家中打开 Amazon Chime SDK 控制台。https://console.aws.amazon.com/chime-sdk/](https://console.aws.amazon.com/chime-sdk/home) 1. 在导航窗格的 **PSTN 音频**下，选择 **SIP 媒体应用程序**。 1. 选择要更改的 SIP 媒体应用程序的名称。 1. 选择**标签**选项卡，然后选择**管理标签**。 1. 在 “**密钥**” 或 “**值**” 框中，输入新值。 1. 完成后，选择**保存更改**。 ## 删除标签 如果您拥有必要的权限，则可以移除 AWS 账户中的任何标签，无论这些标签是谁创建的。但是，IAM 策略可能会阻止您这样做。 **删除标签** 1. [在家中打开 Amazon Chime SDK 控制台。https://console.aws.amazon.com/chime-sdk/](https://console.aws.amazon.com/chime-sdk/home) 1. 在导航窗格的 **PSTN 音频**下，选择 **SIP 媒体应用程序**。 1. 选择要更改的 SIP 媒体应用程序的名称。 1. 选择**标签**选项卡，然后选择**管理标签**。 1. 选择要移除的标签旁边的**移除**。 1. 选择 **Save changes（保存更改）**。 # 查看 SIP 媒体应用程序 其他管理员可以查看您的 SIP 媒体应用程序，包括其详细信息，您也可以查看他们的 SIP 媒体应用程序。 **查看 SIP 媒体应用程序** 1. [在家中打开 Amazon Chime SDK 控制台。https://console.aws.amazon.com/chime-sdk/](https://console.aws.amazon.com/chime-sdk/home) 1. 在导航窗格中，选择 **SIP 媒体应用程序**。 将出现 **SIP 媒体应用程序**页面，并显示您组织中的所有应用程序。 1. 要查看应用程序的详细信息，请选择该应用程序的名称。 # 更新 SIP 媒体应用程序 您可以更新 SIP 媒体应用程序的 Lambda 函数的名称和亚马逊资源名称 (ARNs)。您无法更新该 AWS 区域。 **更新 SIP 媒体应用程序** 1. [在家中打开 Amazon Chime SDK 控制台。https://console.aws.amazon.com/chime-sdk/](https://console.aws.amazon.com/chime-sdk/home) 1. 在导航窗格中，选择 **SIP 媒体应用程序**。 出现 **SIP 媒体应用程序**页面。 1. 选择要更新的应用程序的名称。 该应用程序显示在自己的页面上。 1. 选择**编辑**。 1. 根据需要更改以下内容： + 应用程序的名称 + Lambda ARN、别名 ARN 或版本 ARN + 标签。有关更改标签的更多信息，请参阅 **注意** 您可以在构建 Lambda 函数 ARNs 时创建别名和版本，如果要启用 Lambda 并发，则必须具有别名或版本 ARN。[https://docs.aws.amazon.com/lambda/latest/dg/provisioned-concurrency.html](https://docs.aws.amazon.com/lambda/latest/dg/provisioned-concurrency.html) 1. 选择**保存**。 将显示一条成功消息。如果您看到错误消息，请按照其说明进行操作。 # 删除 SIP 媒体应用程序 您删除 SIP 媒体应用程序的原因有很多，例如： + 您停止使用电话号码或请求 URI 主机名。 + 创建 SIP 媒体应用程序时犯了一个错误。 **注意** 作为最佳实践，请检查以确保删除应用程序不会中断呼叫流程。此外，删除应用程序不会删除任何关联的电话号码或 SIP 规则。 **删除 SIP 媒体应用程序** 1. [在家中打开 Amazon Chime SDK 控制台。https://console.aws.amazon.com/chime-sdk/](https://console.aws.amazon.com/chime-sdk/home) 1. 在导航窗格中，选择 **SIP 媒体应用程序**。 出现 **SIP 媒体应用程序**页面。 1. 选择应用程序名称旁边的选项按钮。 1. 选择**删除**。 将出现 “**删除***应用程序名称*” 对话框。 1. 选择 “**我知道此操作无法撤消**”，然后选择 “**删除**”。