使用 Amazon Chime SDK 語音連接器服務連結角色政策

下列各節中的資訊說明如何執行下列作業：

• 使用 Amazon Chime SDK 語音連接器服務連結的角色政策，將 Amazon Chime SDK 語音連接器媒體串流至 Kinesis。

• 與 Amazon Polly 和說話和行動合成語音。SpeakAndGetDigits

Amazon Chime SDK 語音連接器的服務連結角色許可

Amazon Chime SDK 語音連接器使用名為的服務連結角色 AWSServiceRoleForAmazonChimeVoiceConnector— 允許 Amazon Chime SDK 語音連接器代表您呼叫 AWS 服務。如需如何為 Amazon Chime SDK 語音連接器啟動媒體串流的詳細資訊，請參閱將 Amazon Chime 聲 SDK 語音連接器媒體串流至 Kinesis。

服 AWSServiceRoleForAmazonChimeVoiceConnector 務連結角色會信任下列服務擔任該角色：

• voiceconnector.chime.amazonaws.com

AmazonChimeVoiceConnectorServiceLinkedRolePolicy可讓 Amazon Chime 開發套件在指定的資源上完成下列動作：

• 動作：all AWS resources 上的 chime:GetVoiceConnector*

• 動作：arn:aws:kinesisvideo:us-east-1:111122223333:stream/ChimeVoiceConnector-* 上的 kinesisvideo:*

• 動作：all AWS resources 上的 polly:SynthesizeSpeech

• 動作：all AWS resources 上的 chime:CreateMediaInsightsPipeline

• 動作：all AWS resources 上的 chime:GetMediaInsightsPipelineConfiguration

• 動作：arn:aws:kinesisvideo:us-east-1:111122223333:stream/ChimeMediaPipelines-* 上的 kinesisvideo:CreateStream

• 動作：arn:aws:kinesisvideo:us-east-1:111122223333:stream/ChimeMediaPipelines-* 上的 kinesisvideo:PutMedia

• 動作：arn:aws:kinesisvideo:us-east-1:111122223333:stream/ChimeMediaPipelines-* 上的 kinesisvideo:UpdateDataRetention

• 動作：arn:aws:kinesisvideo:us-east-1:111122223333:stream/ChimeMediaPipelines-* 上的 kinesisvideo:DescribeStream

• 動作：arn:aws:kinesisvideo:us-east-1:111122223333:stream/ChimeMediaPipelines-* 上的 kinesisvideo:GetDataEndpoint

• 動作：arn:aws:kinesisvideo:us-east-1:111122223333:stream/* 上的 kinesisvideo:ListStreams

您必須設定許可，IAM 實體 (如使用者、群組或角色) 才可建立、編輯或刪除服務連結角色。如需詳細資訊，請參閱《IAM 使用者指南》中的服務連結角色許可。

為 Amazon Chime SDK 語音連接器建立服務連結角色

您不需要手動建立一個服務連結角色。當您為 Amazon Chime SDK 語音連接器啟動 Kinesis 媒體串流，或在、或 AWS API 中建立或更新 Amazon Chime SDK SIP 媒體應用程式時 AWS CLI，Amazon Chime 會為您建立服務連結角色。 AWS Management Console

您也可以使用 IAM 主控台，透過 Chime 語音連接器使用案例建立服務連結角色。在 AWS CLI 或 AWS API 中，使用voiceconnector.chime.amazonaws.com服務名稱建立服務連結角色。如需詳細資訊，請參閱《IAM 使用者指南》中的「建立服務連結角色」。如果您刪除此服務連結角色，您可以使用此相同的程序以再次建立該角色。

編輯 Amazon Chime SDK 語音連接器的服務連結角色

Amazon Chime 開發套件不允許您編輯 AWSServiceRoleForAmazonChimeVoiceConnector 服務連結角色。因為有各種實體可能會參考服務連結角色，所以您無法在建立角色之後變更角色名稱。然而，您可使用 IAM 來編輯角色描述。如需詳細資訊，請參閱 IAM 使用者指南中的編輯服務連結角色。

刪除 Amazon Chime SDK 語音連接器的服務連結角色

若您不再使用需要服務連結角色的功能或服務，我們建議您刪除該角色。如此一來，您就沒有未主動監控或維護的未使用實體。然而，務必清除您的服務連結角色，之後才能以手動方式將其刪除。

清除服務連結角色

在您使用 IAM 刪除服務連結角色之前，您必須先刪除該角色所使用的任何資源。

注意

如果您嘗試刪除資源時，Amazon Chime SDK 服務正在使用該角色，則刪除可能會失敗。若此情況發生，請等待數分鐘後並再次嘗試操作。

若要刪除 AWSServiceRoleForAmazonChimeVoiceConnector (主控台) 所使用的 Amazon Chime SDK 資源

• 停止 Amazon Chime 開發套件帳戶中所有 Amazon Chime SDK 語音連接器的媒體串流。

  1. 開啟 Amazon Chime 聲開發套件主控台，網址為 https://console.aws.amazon.com/chime-sdk/home。

  2. 在功能窗格的 [SIP 中繼] 下，選擇 [語音連接器]。

  3. 選擇 Amazon Chime 聲 SDK 語音連接器的名稱。

  4. 選擇「串流」標籤。

  5. 在「傳送至 Kinesis Video Streams」下，選擇「停止」。

  6. 選擇儲存。

若要刪除 AWSServiceRoleForAmazonChimeVoiceConnector (AWS CLI) 所使用的 Amazon Chime 指令開發套件資源

• 使用 AWS CLI 中的delete-voice-connector-streaming-configuration命令停止帳戶中所有 Amazon Chime SDK 語音連接器的媒體串流。

  aws chime delete-voice-connector-streaming-configuration --voice-connector-id abcdef1ghij2klmno3pqr4

若要刪除 AWSServiceRoleForAmazonChimeVoiceConnector (API) 使用的 Amazon Chime 聲 SDK 資源

• 使用 DeleteVoiceConnectorStreamingConfigurationAPI 停止帳戶中所有 Amazon Chime SDK 語音連接器的媒體串流。

手動刪除服務連結角色

使用 IAM 主控台或 AWS API 作業刪除 AWSServiceRoleForAmazonChimeVoiceConnector 服務連結角色。 AWS CLI如需詳細資訊，請參閱《IAM 使用者指南》中的刪除服務連結角色。

支援 Amazon Chime SDK 服務連結角色的區域

Amazon Chime 開發套件支援在所有提供服務的地方使用服務連結角色。 AWS 區域如需詳細資訊，請參閱 Amazon Chime 端點和配額。