As informações nas seções a seguir explicam como criar um perfil vinculado a serviços que conceda aos pipelines de mídia acesso às suas reuniões do SDK do Amazon Chime.
Tópicos
Como configurar permissões de perfil
Os pipelines de mídia usam um perfil vinculado ao serviço chamado AWSServiceRoleForAmazonChimeSDKMediaPipelines. O perfil permite que os pipelines de captura acessem as reuniões do SDK do Amazon Chime e publiquem métricas no Amazon CloudWatch em seu nome. O perfil confia no serviço mediapipelines.chime.amazonaws.com
.
A política de permissões do perfil permite que o SDK do Amazon Chime conclua as seguintes ações em todos os recursos da AWS:
-
Ação:
cloudwatch:PutMetricData
emall AWS resources
-
Ação:
chime:CreateAttendee
emall AWS resources
-
Ação:
chime:DeleteAttendee
emall AWS resources
-
Ação:
chime:GetMeeting
emall AWS resources
-
Ação:
kinesisvideo:CreateStream
emarn:aws:kinesisvideo:*:
111122223333
:stream/ChimeMediaPipelines-* -
Ação:
kinesisvideo:PutMedia
emarn:aws:kinesisvideo:*:
111122223333
:stream/ChimeMediaPipelines-* -
Ação:
kinesisvideo:UpdateDataRetention
emarn:aws:kinesisvideo:*:
111122223333
:stream/ChimeMediaPipelines-* -
Ação:
kinesisvideo:DescribeStream
emarn:aws:kinesisvideo:*:
111122223333
:stream/ChimeMediaPipelines-* -
Ação:
kinesisvideo:GetDataEndpoint
emarn:aws:kinesisvideo:*:
111122223333
:stream/ChimeMediaPipelines-* -
Ação:
kinesisvideo:ListStreams
emarn:aws:kinesisvideo:*:
111122223333
:stream/*
É necessário configurar permissões para permitir que uma entidade do IAM, como um usuário, grupo ou perfil, crie, edite ou exclua um perfil vinculado ao serviço. Para mais informações sobre permissões, consulte Permissões de perfil vinculado a serviço no Guia do usuário do IAM.
Como criar uma função vinculada ao serviço
Você usa o console do IAM para criar um perfil vinculado ao serviço para usar com pipelines de mídia do SDK do Amazon Chime. Você deve ter permissões administrativas do IAM para concluir essas etapas. Caso contrário, entre em contato com um administrador do sistema.
Para criar a função
-
Faça login no Console de Gerenciamento da AWS e, em seguida, abra o console do IAM em https://console.aws.amazon.com/iam/
. -
No painel de navegação do console do IAM, escolha Perfis e, em seguida, Criar perfil.
-
Escolha o tipo de perfil do Serviço da AWS e, em seguida, escolha Pipelines de mídia do SDK do Chime.
A política do IAM é exibida.
-
Marque a caixa de seleção ao lado da política e escolha Próximo: Tags.
-
Selecione Next: Review (Próximo: revisar).
-
Edite a descrição conforme necessário e escolha Criar perfil.
Você também pode usar a CLI da AWS ou a API da AWS para criar um perfil vinculado ao serviço chamada mediapipelines.chime.amazonaws.com. Na CLI da AWS, execute este comando:
aws iam create-service-linked-role --aws-service-name mediapipelines.chime.amazonaws.com
Para mais informações sobre a criação do perfil, consulte Criando um perfil vinculado ao serviço no Guia do usuário do IAM. Se você excluir esse perfil, será possível usar esse mesmo processo para criá-lo novamente.
Editando a função vinculada ao serviço
Não é possível editar o perfil vinculado ao serviço AWSServiceRoleForAmazonChimeSDKMediaPipelines. Depois de criar o perfil, você não pode alterar o seu nome, pois outras entidades podem fazer referência a ele. No entanto, é possível usar o IAM para editar a descrição do perfil. Para mais informações, consulte Como editar uma função vinculada ao serviço no Guia do usuário do IAM.
Excluindo uma função vinculada ao serviço
Se você não precisa de um perfil vinculado ao serviço, recomendamos que o exclua. Para fazer isso, primeiro exclua os pipelines de mídia que usam o perfil. É possível usar a CLI da AWS ou a API DeleteMediaCapturePipeline para excluir os pipelines.
Como usar a CLI para excluir pipelines
Use esse comando na CLI da AWS para excluir pipelines de mídia em sua conta.
aws chime-sdk-media-pipelines delete-media-capture-pipeline --media-pipeline-id
Pipeline_Id
Como usar uma API para excluir pipelines
Use a API DeleteMediaCapturePipeline para excluir pipelines de mídia em sua conta.
Como excluir o perfil
Depois de excluir os pipelines, é possível usar o console do IAM, a CLI da AWS ou a API da AWS para excluir o perfil. Para mais informações sobre a exclusão de perfis, consulte Como excluir um perfil vinculado ao serviço no Guia do usuário do IAM.
Regiões compatíveis com perfis vinculados ao serviço
O SDK do Amazon Chime oferece suporte a perfis vinculados a serviço em todas as regiões da AWS em que o serviço está disponível. Para mais informações, consulte Endpoints e quotas do SDK do Amazon Chime no Referência geral da Amazon Web Services.