Usando funções vinculadas a serviços para Amazon Q Developer - Amazon Q Developer

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Usando funções vinculadas a serviços para Amazon Q Developer

O Amazon Q Developer usa AWS Identity and Access Management funções vinculadas a serviços (IAM). Uma função vinculada a serviços é um tipo exclusivo de função do IAM vinculada diretamente ao Amazon Q Developer. As funções vinculadas ao serviço são predefinidas pelo Amazon Q Developer 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 do Amazon Q Developer porque você não precisa adicionar manualmente as permissões necessárias. O Amazon Q Developer define as permissões de suas funções vinculadas ao serviço e, a menos que seja definido de outra forma, somente o Amazon Q Developer pode assumir suas funções. As permissões definidas incluem a política de confiança e a política de permissões, que não pode ser anexada a nenhuma outra entidade do IAM.

Um perfil vinculado ao serviço poderá ser excluído somente após excluir seus atributos relacionados. Isso protege seus recursos do Amazon Q Developer 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 do perfil vinculado a esse serviço.

Saiba mais sobre o AWS políticas gerenciadas para o Amazon Q Developer.

Permissões de função vinculadas ao serviço para Amazon Q Developer

O Amazon Q Developer usa a função vinculada ao serviço chamada AWSServiceRoleForAmazonQDeveloper— Essa função concede permissões ao Amazon Q para acessar dados em sua conta para calcular o faturamento, fornece acesso para criar e acessar relatórios de segurança na Amazon CodeGuru e emitir dados para. CloudWatch

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

  • q.amazonaws.com

A política de permissões de função nomeada AWSServiceRoleForAmazonQDeveloperPolicy permite que o Amazon Q Developer conclua as seguintes ações nos recursos especificados:

  • Ação: cloudwatch:PutMetricData em AWS/Q CloudWatch namespace

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 obter mais informações, consulte Permissões de perfil vinculado a serviços no Guia do usuário do IAM.

Criação de uma função vinculada ao serviço para o Amazon Q Developer

Não é necessário criar manualmente uma função vinculada a serviço. Quando você cria um perfil para o Amazon Q no AWS Management Console, o Amazon Q Developer cria a função vinculada ao serviço para você.

Se excluir esse perfil vinculado ao serviço e precisar criá-lo novamente, você poderá usar esse mesmo processo para recriar o perfil em sua conta. Quando você atualiza as configurações, o Amazon Q cria a função vinculada ao serviço para você novamente.

Você também pode usar o console do IAM ou o AWS CLI para criar uma função vinculada ao serviço com o nome do serviço. q.amazonaws.com Para obter mais informações, consulte Criar um perfil vinculado a serviço no Guia 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 o Amazon Q Developer

O Amazon Q Developer não permite que você edite a função AWSServiceRoleForAmazonQDeveloper 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 um perfil vinculado ao serviço no Guia do usuário do IAM.

Excluindo uma função vinculada ao serviço para o Amazon Q Developer

Se você não precisar mais usar um recurso ou serviço que requer um perfil vinculado ao serviço, é recomendável excluí-lo. 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 serviço Amazon Q Developer 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 AWSServiceRoleForAmazonQDeveloper vinculada ao serviço. Para obter mais informações, consulte Excluir um perfil vinculado ao serviço no Guia do usuário do IAM.

Regiões suportadas para funções vinculadas ao serviço Amazon Q Developer

O Amazon Q Developer não oferece suporte ao uso de funções vinculadas a serviços em todas as regiões em que o serviço está disponível. Você pode usar a AWSServiceRoleForAmazonQDeveloper função nas seguintes regiões. Para obter mais informações, consulte Regiões e endpoints da AWS.

Nome da região Identidade da região Support no Amazon Q Developer
Leste dos EUA (Norte da Virgínia) us-east-1 Sim
Leste dos EUA (Ohio) us-east-2 Não
Oeste dos EUA (Norte da Califórnia) us-west-1 Não
Oeste dos EUA (Oregon) us-west-2 Não
África (Cidade do Cabo) af-south-1 Não
Ásia-Pacífico (Hong Kong) ap-east-1 Não
Ásia-Pacífico (Jacarta) ap-southeast-3 Não
Ásia-Pacífico (Mumbai) ap-south-1 Não
Asia Pacific (Osaka) ap-northeast-3 Não
Ásia-Pacífico (Seul) ap-northeast-2 Não
Ásia-Pacífico (Singapura) ap-southeast-1 Não
Ásia-Pacífico (Sydney) ap-southeast-2 Não
Ásia-Pacífico (Tóquio) ap-northeast-1 Não
Canadá (Central) ca-central-1 Não
Europa (Frankfurt) eu-central-1 Não
Europa (Irlanda) eu-west-1 Não
Europa (Londres) eu-west-2 Não
Europa (Milão) eu-south-1 Não
Europa (Paris) eu-west-3 Não
Europa (Estocolmo) eu-north-1 Não
Oriente Médio (Barém) me-south-1 Não
Oriente Médio (Emirados Árabes Unidos) me-central-1 Não
América do Sul (São Paulo) sa-east-1 Não
AWS GovCloud (Leste dos EUA) us-gov-east-1 Não
AWS GovCloud (Oeste dos EUA) us-gov-west-1 Não