Amazon Chime SDK Voice Connector サービスにリンクされたロールポリシーの使用

以下のセクションでは、以下の方法について説明します。

• Amazon Chime SDK Voice Connector サービスにリンクされたロールポリシーを使用して、Amazon Chime SDK Voice Connector メディアを Kinesis にストリーミングします。

• Amazon Polly と Speak および SpeakAndGetDigitsアクションを使用して音声を合成します。

Amazon Chime SDK Voice Connector のサービスにリンクされたロールのアクセス許可

Amazon Chime SDK Voice Connectors は、 という名前のサービスにリンクされたロールを使用しますAWSServiceRoleForAmazonChimeVoiceConnector。これにより、Amazon Chime SDK Voice Connector はユーザーに代わって AWS のサービスを呼び出すことができます。Amazon Chime SDK Voice Connector のメディアストリーミングを開始する方法の詳細については、「」を参照してくださいAmazon Chime SDK Voice Connector メディアを Kinesis にストリーミングする。

AWSServiceRoleForAmazonChimeVoiceConnector サービスにリンクされたロールは、次のサービスを信頼してロールを引き受けます。

• voiceconnector.chime.amazonaws.com

AmazonChimeVoiceConnectorServiceLinkedRolePolicy により、Amazon Chime SDK は指定されたリソースに対して以下のアクションを実行できます。

• アクション: 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

• アクション: kinesisvideo:ListStreams 上で arn:aws:kinesisvideo:us-east-1:111122223333:stream/*

サービスにリンクされたロールの作成、編集、削除を IAM エンティティ (ユーザー、グループ、ロールなど) に許可するには、権限を設定する必要があります。詳細については、「IAM ユーザーガイド」の「サービスリンクロール権限」を参照してください。

Amazon Chime SDK Voice Connector のサービスにリンクされたロールの作成

サービスリンクロールを手動で作成する必要はありません。Amazon Chime SDK Voice Connector の Kinesis メディアストリーミングを開始するか、、、または AWS API で Amazon Chime SDK SIP AWS Management Consoleメディアアプリケーションを作成 AWS CLIまたは更新すると、Amazon Chime によってサービスにリンクされたロールが作成されます。

IAM コンソールで Chime Voice Connector ユースケースによるサービスリンクロールを作成することもできます。 AWS CLI または AWS API で、サービス名を使用してvoiceconnector.chime.amazonaws.comサービスにリンクされたロールを作成します。詳細については、『IAM ユーザーガイド』の「サービスにリンクされたロールの作成」を参照してください。このサービスリンクロールを削除しても、同じ方法でロールを再作成できます。

Amazon Chime SDK Voice Connector のサービスにリンクされたロールの編集

Amazon Chime SDK では、 AWSServiceRoleForAmazonChimeVoiceConnector サービスにリンクされたロールを編集することはできません。サービスリンクロールを作成した後は、多くのエンティティによってロールが参照される可能性があるため、ロール名を変更することはできません。ただし、IAM を使用したロールの説明の編集はできます。詳細については、「IAM ユーザーガイド」の「サービスにリンクされたロールの編集」を参照してください。

Amazon Chime SDK Voice Connector のサービスにリンクされたロールの削除

サービスリンクロールが必要な機能またはサービスが不要になった場合には、そのロールを削除することをお勧めします。そうすることで、モニタリングや保守が積極的に行われていない未使用のエンティティを排除できます。ただし、手動で削除する前に、サービスリンクロールをクリーンアップする必要があります。

サービスリンクロールのクリーンアップ

IAM を使用してサービスリンクロールを削除するには、最初に、そのロールで使用されているリソースをすべて削除する必要があります。

注記

リソースを削除しようとしたときに Amazon Chime SDK サービスがロールを使用している場合、削除が失敗する可能性があります。失敗した場合は、数分待ってから操作を再試行してください。

によって使用されている Amazon Chime SDK リソースを削除するには AWSServiceRoleForAmazonChimeVoiceConnector （コンソール）

• Amazon Chime SDK アカウント内のすべての Amazon Chime SDK Voice Connector のメディアストリーミングを停止します。

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

  2. ナビゲーションペインの SIP Trunking で、音声コネクタ を選択します。

  3. Amazon Chime SDK Voice Connector の名前を選択します。

  4. ストリーミングタブを選択します。

  5. Kinesis Video Streams に送信する で、停止 を選択します。

  6. [保存] を選択します。

AWSServiceRoleForAmazonChimeVoiceConnector （AWS CLI) で使用されている Amazon Chime SDK リソースを削除するには

• AWS CLI の delete-voice-connector-streaming-configuration コマンドを使用して、アカウント内のすべての Amazon Chime SDK Voice Connector のメディアストリーミングを停止します。

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

AWSServiceRoleForAmazonChimeVoiceConnector (API) が使用する Amazon Chime SDK リソースを削除するには

• DeleteVoiceConnectorStreamingConfiguration API を使用して、アカウント内のすべての Amazon Chime SDK Voice Connector のメディアストリーミングを停止します。

サービスリンクロールの手動による削除

IAM コンソール、、または AWS API オペレーションを使用して AWS CLI、 AWSServiceRoleForAmazonChimeVoiceConnector サービスにリンクされたロールを削除します。詳細については、「IAM ユーザーガイド」の「サービスにリンクされたロールの削除」を参照してください。

Amazon Chime SDK サービスにリンクされたロールでサポートされているリージョン

Amazon Chime SDK は、サービス AWS リージョンが利用可能なすべての でサービスにリンクされたロールの使用をサポートします。詳細については、「Amazon Chime エンドポイントとクォータ」を参照してください。