Usar funções vinculadas ao serviço do AWS IoT TwinMaker

AWS IoT TwinMaker usa funções vinculadas ao serviço AWS Identity and Access Management (IAM). Uma função vinculada ao serviço é um tipo exclusivo de função do IAM vinculada diretamente a. AWS IoT TwinMaker As funções vinculadas ao serviço são predefinidas AWS IoT TwinMaker 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 AWS IoT TwinMaker porque você não precisa adicionar manualmente as permissões necessárias. AWS IoT TwinMaker define as permissões de suas funções vinculadas ao serviço e, a menos que seja definido de outra forma, só AWS IoT TwinMaker 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 não pode ser anexada a nenhuma outra entidade do IAM.

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

Para obter informações sobre outros serviços compatíveis com perfis vinculados ao serviço, consulte serviços da AWS que funcionam com o IAM e procure os serviços que apresentam Sim na coluna Perfis vinculados aos serviços. 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 AWS IoT TwinMaker

AWS IoT TwinMaker usa a função vinculada ao serviço chamada AWSServiceRoleForIoTTwinMaker— Permite AWS IoT TwinMaker chamar outros AWS serviços e sincronizar seus recursos em seu nome.

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

• iottwinmaker.amazonaws.com

A política de permissões de função nomeada AWSIoTTwinMakerServiceRolePolicy AWS IoT TwinMaker permite concluir as seguintes ações nos recursos especificados:

• Ação: iotsitewise:DescribeAsset, iotsitewise:ListAssets, iotsitewise:DescribeAssetModel, and iotsitewise:ListAssetModels, iottwinmaker:GetEntity, iottwinmaker:CreateEntity, iottwinmaker:UpdateEntity, iottwinmaker:DeleteEntity, iottwinmaker:ListEntities, iottwinmaker:GetComponentType, iottwinmaker:CreateComponentType, iottwinmaker:UpdateComponentType, iottwinmaker:DeleteComponentType, iottwinmaker:ListComponentTypes em all your iotsitewise asset and asset-model resources

Você deve configurar permissões para permitir que seus usuários, grupos ou perfis criem, editem ou excluam um perfil vinculado ao serviço. Para ter mais informações, consulte Service-linked role permissions (Permissões de nível vinculado a serviços) no Guia do usuário do IAM.

Criação de uma função vinculada ao serviço para AWS IoT TwinMaker

Não é necessário criar manualmente uma função vinculada ao serviço. Quando você sincroniza seus AWS IoT SiteWise ativos e modelos de ativos (sincronização de ativos) na AWS Management Console, na ou na AWS API AWS CLI, AWS IoT TwinMaker cria a função vinculada ao serviço para você.

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ê sincroniza seus AWS IoT SiteWise ativos e modelos de ativos (sincronização de ativos), AWS IoT TwinMaker cria a função vinculada ao serviço para você novamente.

Você também pode usar o console do IAM para criar uma função vinculada ao serviço com o caso de uso “IoT TwinMaker - Função gerenciada”. Na AWS CLI ou na AWS API, crie uma função vinculada ao serviço com o nome do iottwinmaker.amazonaws.com serviço. Para obter mais informações, consulte Criar uma função vinculada ao serviço no Manual do usuário do IAM. 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 AWS IoT TwinMaker

AWS IoT TwinMaker não permite que você edite a função AWSServiceRoleForIoTTwinMaker 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, será possível editar a descrição do perfil usando o IAM. Para ter mais informações, consulte Editar uma função vinculada a serviço no Guia do usuário do IAM.

Excluindo uma função vinculada ao serviço para AWS IoT TwinMaker

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 todos os espaços de trabalho vinculados a serviços que ainda estão usando sua função vinculada ao serviço antes de excluir manualmente a função.

nota

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

Como excluir manualmente a função vinculada a serviço usando o IAM

Use o console do IAM AWS CLI, o ou a AWS API para excluir a função AWSServiceRoleForIoTTwinMaker vinculada ao serviço. Para obter mais informações, consulte Excluir uma função vinculada ao serviço no Guia do usuário do IAM.

Regiões suportadas para funções vinculadas a AWS IoT TwinMaker serviços

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