Usando funções vinculadas a serviços para criar VPC domínios e fontes de dados de consulta direta

O Amazon OpenSearch Service 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 ao OpenSearch Serviço. As funções vinculadas ao serviço são predefinidas pelo OpenSearch Serviço e incluem todas as permissões que o serviço exige para chamar outros AWS serviços em seu nome.

OpenSearch O serviço usa a função vinculada ao serviço chamada AWSServiceRoleForAmazonOpenSearchService, que fornece as permissões mínimas da Amazon EC2 e do Elastic Load Balancing necessárias para que a função VPCpermita o acesso a um domínio ou a uma fonte de dados de consulta direta.

Função legada do Elasticsearch

O Amazon OpenSearch Service usa uma função vinculada ao serviço chamada. AWSServiceRoleForAmazonOpenSearchService Suas contas também podem conter uma função legada vinculada ao serviço chamadaAWSServiceRoleForAmazonElasticsearchService, que funciona com os endpoints obsoletos do Elasticsearch. API

Se a função legada do Elasticsearch não existir em sua conta, o OpenSearch Service cria automaticamente uma nova função OpenSearch vinculada ao serviço na primeira vez que você cria um domínio. OpenSearch Caso contrário, sua conta continuará usando a função Elasticsearch. Para que essa criação automática seja bem-sucedida, você precisa ter permissões para a ação iam:CreateServiceLinkedRole.

Permissões

A função vinculada ao serviço AWSServiceRoleForAmazonOpenSearchService confia nos seguintes serviços para aceitar a função:

• opensearchservice.amazonaws.com

A política de permissões de função nomeada AmazonOpenSearchServiceRolePolicypermite que o OpenSearch Serviço conclua as seguintes ações nos recursos especificados:

• Ação: acm:DescribeCertificate em *

• Ação: cloudwatch:PutMetricData em *

• Ação: ec2:CreateNetworkInterface em *

• Ação: ec2:DeleteNetworkInterface em *

• Ação: ec2:DescribeNetworkInterfaces em *

• Ação: ec2:ModifyNetworkInterfaceAttribute em *

• Ação: ec2:DescribeSecurityGroups em *

• Ação: ec2:DescribeSubnets em *

• Ação: ec2:DescribeVpcs em *

• Ação: ec2:CreateTags em todas as interfaces de rede e VPC endpoints

• Ação: ec2:DescribeTags em *

• Ação: ec2:CreateVpcEndpoint em todos os grupos de segurançaVPCs, sub-redes e tabelas de rotas, bem como em todos os VPC endpoints quando a solicitação contém a tag OpenSearchManaged=true

• Ação: ec2:ModifyVpcEndpoint em todos os grupos de segurançaVPCs, sub-redes e tabelas de rotas, bem como em todos os VPC endpoints quando a solicitação contém a tag OpenSearchManaged=true

• Ação: ec2:DeleteVpcEndpoints em todos os endpoints quando a solicitação contiver a tag OpenSearchManaged=true

• Ação: ec2:AssignIpv6Addresses em *

• Ação: ec2:UnAssignIpv6Addresses em *

• Ação: elasticloadbalancing:AddListenerCertificates em *

• Ação: elasticloadbalancing:RemoveListenerCertificates em *

Você deve configurar permissões para que uma entidade do IAM (por exemplo, um 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.

Criando uma função vinculada ao serviço

Não é necessário criar manualmente uma função vinculada ao serviço. Quando você cria um domínio VPC habilitado ou uma fonte de dados de consulta direta usando o AWS Management Console, o OpenSearch Service cria a função vinculada ao serviço para você. Para que essa criação automática seja bem-sucedida, você precisa ter permissões para a ação iam:CreateServiceLinkedRole.

Você também pode usar o IAM console IAMCLI, o ou o IAM API para criar uma função vinculada ao serviço manualmente. Para obter mais informações, consulte Criar uma função vinculada ao serviço no Guia do usuário do IAM.

Editando a função vinculada ao serviço

OpenSearch O serviço não permite que você edite a função AWSServiceRoleForAmazonOpenSearchService vinculada ao serviço. Depois que você criar um perfil vinculado ao serviço, não poderá alterar o nome do perfil, pois várias entidades podem fazer referência ao perfil. No entanto, você poderá editar a descrição da função usando o IAM. Para obter mais informações, consulte Edição de uma função vinculada ao serviço no Guia do IAMusuário.

Excluindo uma função vinculada ao serviço

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 suo perfil vinculado ao serviço para excluí-la manualmente.

Limpar a função vinculada ao serviço

Antes de você poder usar o IAM para excluir uma função vinculada ao serviço, você deve primeiro confirmar que a função não tem sessões ativas e remover quaisquer recursos usados pela função.

Para verificar se a função vinculada ao serviço tem uma sessão ativa no console do IAM

1. Faça login no AWS Management Console e abra o IAM console em https://console.aws.amazon.com/iam/.

2. No painel de navegação do console do IAM, selecione Roles (Funções). A seguir, selecione o nome (não a caixa de seleção) da função AWSServiceRoleForAmazonOpenSearchService.

3. Na página Resumo para a função selecionada, escolha a guia Consultor de Acesso.

4. Na guia Consultor de Acesso, revise a atividade recente para a função vinculada ao serviço.

   nota

   Se você não tiver certeza se o OpenSearch Serviço está usando a AWSServiceRoleForAmazonOpenSearchService função, tente excluir a função. Se o serviço estiver usando a função, a exclusão falhará e você poderá visualizar os recursos usando a função. Se a função estiver sendo usada, você deverá aguardar o término da sessão antes de poder excluir a função e/ou excluir os recursos usando a função. Não é possível revogar a sessão de uma função vinculada a um serviço.

Exclusão manual de uma função vinculada ao serviço

Exclua funções vinculadas ao serviço do IAM consoleAPI, ou. AWS CLI Para obter instruções, consulte Excluir uma função vinculada ao serviço no Guia do IAM usuário.