Usar funções vinculadas ao serviço do MediaTailor

AWS Elemental MediaTailor usa AWS Identity and Access Management (IAM) funções vinculadas ao serviço. Uma função vinculada ao serviço é um tipo exclusivo de IAM função vinculada diretamente a. MediaTailor As funções vinculadas ao serviço são predefinidas MediaTailor e incluem todas as permissões que o serviço exige para chamar outros AWS serviços em seu nome.

Uma função vinculada ao serviço facilita a configuração MediaTailor porque você não precisa adicionar manualmente as permissões necessárias. MediaTailor define as permissões de suas funções vinculadas ao serviço e, a menos que seja definido de outra forma, só MediaTailor pode assumir suas funções. As permissões definidas incluem a política de confiança e a política de permissões, e essa política de permissões não pode ser anexada a nenhuma outra IAM entidade.

Uma função vinculada ao serviço poderá ser excluída somente após excluir seus recursos relacionados. Isso protege seus MediaTailor recursos porque você não pode remover inadvertidamente a permissão para acessar os recursos.

Para obter informações sobre outros serviços que oferecem suporte a funções vinculadas a serviços, consulte AWS Serviços que funcionam com IAM e procure os serviços que têm Sim na coluna Função vinculada ao serviço. Escolha um Sim com um link para visualizar a documentação da função vinculada a esse serviço.

Permissões de função vinculadas ao serviço para MediaTailor

MediaTailor usa a função vinculada ao serviço chamada AWSServiceRoleForMediaTailor— MediaTailor usa essa função vinculada ao serviço para invocar CloudWatch para criar e gerenciar grupos de log, fluxos de log e eventos de log. Essa função vinculada ao serviço é anexada à seguinte política gerenciada: AWSMediaTailorServiceRolePolicy.

A função AWSServiceRoleForMediaTailor vinculada ao serviço confia nos seguintes serviços para assumir a função:

• mediatailor.amazonaws.com

A política de permissões de função MediaTailor permite concluir as seguintes ações nos recursos especificados:

• Ação: logs:PutLogEvents em arn:aws:logs:*:*:log-group:/aws/MediaTailor/*:log-stream:*

• Ação: logs:CreateLogStream, logs:CreateLogGroup, logs:DescribeLogGroups, logs:DescribeLogStreams em arn:aws:logs:*:*:log-group:/aws/MediaTailor/*

Você deve configurar permissões para permitir que uma IAM entidade (como usuário, grupo ou função) crie, edite ou exclua uma função vinculada ao serviço. Para obter mais informações, consulte Permissões de funções vinculadas ao serviço no Guia do IAMusuário.

Criação de uma função vinculada ao serviço para MediaTailor

Não é necessário criar manualmente uma função vinculada ao serviço. Quando você ativa o login da sessão AWS Management Console, o AWS Command Line Interface (AWS CLI) ou o AWS API, MediaTailor cria a função vinculada ao serviço para você.

Importante

Essa função vinculada ao serviço pode aparecer em sua conta se você concluiu uma ação em outro serviço que usa os atributos compatíveis com essa função. Além disso, se você estava usando o MediaTailor serviço antes de 15 de setembro de 2021, quando ele começou a oferecer suporte a funções vinculadas ao serviço, MediaTailor criou a AWSServiceRoleForMediaTailor função em sua conta. Para saber mais, consulte Uma nova função apareceu em Minha IAM conta.

Se excluir essa função vinculada ao serviço e precisar criá-la novamente, você poderá usar esse mesmo processo para recriar a função em sua conta. Quando você ativa o registro de sessão, MediaTailor cria a função vinculada ao serviço para você novamente.

Você também pode usar o IAM console para criar uma função vinculada ao serviço com o caso de MediaTailoruso. No AWS CLI ou no AWS API, crie uma função vinculada ao serviço com o nome do mediatailor.amazonaws.com serviço. Para obter mais informações, consulte Criação de uma função vinculada ao serviço no Guia do IAMusuário. Se você excluir essa função vinculada ao serviço, será possível usar esse mesmo processo para criar a função novamente.

Editando uma função vinculada ao serviço para MediaTailor

MediaTailor não permite que você edite a função AWSServiceRoleForMediaTailor vinculada ao serviço. Depois que criar um perfil vinculado ao serviço, você não poderá alterar o nome do perfil, pois várias entidades podem fazer referência a ele. No entanto, você pode editar a descrição da função usandoIAM. Para obter mais informações, consulte Editando uma função vinculada ao serviço no Guia do IAMusuário.

Excluindo uma função vinculada ao serviço para MediaTailor

Se você não precisar mais usar um atributo ou serviço que requer uma função vinculada a serviço, é recomendável excluí-la. Dessa forma, você não tem uma entidade não utilizada que não seja monitorada ativamente ou mantida. No entanto, você deve limpar os recursos de sua função vinculada ao serviço antes de excluí-la manualmente.

nota

Se o MediaTailor serviço estiver usando a função quando você tentar limpar os recursos, a exclusão poderá falhar. Se isso acontecer, espere alguns minutos e tente a operação novamente.

Para limpar MediaTailor os recursos usados pelo AWSServiceRoleForMediaTailor

• Antes de excluir a função vinculada ao serviço criada por MediaTailor para a configuração de registro, você deve primeiro desativar todas as configurações de registro em sua conta. Para desativar uma configuração de log, defina o valor da porcentagem ativada como 0. Isso desativa todo o registro da sessão na configuração de reprodução correspondente. Para obter mais informações, consulte Desativando uma configuração de log.

Para excluir manualmente a função vinculada ao serviço usando IAM

Use o IAM console, o AWS Command Line Interface (AWS CLI) ou o AWS API para excluir a função AWSServiceRoleForMediaTailor vinculada ao serviço. Para obter mais informações, consulte Excluindo uma função vinculada ao serviço no Guia do IAM usuário.

Regiões suportadas para funções vinculadas a MediaTailor serviços

MediaTailor suporta o uso de funções vinculadas ao serviço em todas as regiões em que o serviço está disponível. Para mais informações, consulte Regiões e endpoints da AWS.