Função vinculada ao serviço Amazon ECR para modelos de criação de repositórios

O Amazon ECR usa uma função vinculada ao serviço chamada AWSServiceRoleForECRTemplateque dá permissão para o Amazon ECR realizar ações em seu nome para concluir ações de modelo de criação de repositórios.

Permissões de função vinculada ao serviço para o Amazon ECR

A função AWSServiceRoleForECRTemplatevinculada ao serviço confia no serviço a seguir para assumir a função.

• ecr.amazonaws.com

Detalhes da permissão

A política de permissões da ECRTemplateServiceRolePolicy está vinculada à função vinculada ao serviço. Essa política gerenciada concede ao Amazon ECR permissão para realizar ações de criação de repositórios em seu nome.

A política da ECRTemplateServiceRolePolicy contém os elementos a seguir:

{
    "Version": "2012-10-17",
    "Statement": [
        {
	    "Sid": "CreateRepositoryWithTemplate",
            "Effect": "Allow",
            "Action": [
                "ecr:CreateRepository"
            ],
            "Resource": "*"
        }
    ]
}

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 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.

Criar uma função vinculada ao serviço para o Amazon ECR

Você não precisa criar manualmente a função vinculada ao serviço Amazon ECR para o modelo de criação de repositórios. Quando você cria uma regra de modelo de criação de repositório para seu registro privado na AWS Management Console, na ou na AWS API AWS CLI, o Amazon ECR cria a função vinculada ao serviço para você.

Se você excluir essa função vinculada ao serviço e precisar criá-la novamente, poderá usar esse mesmo processo para recriar a função em sua conta. Quando você cria uma regra de criação de repositório para seu registro privado, o Amazon ECR cria a função vinculada ao serviço para você novamente, caso ela ainda não exista.

Editar uma função vinculada ao serviço do Amazon ECR

O Amazon ECR não permite a edição manual da função vinculada ao AWSServiceRoleForECRTemplateserviço. Após a criação da função vinculada ao serviço, você não poderá alterar o nome da função, pois várias entidades podem fazer referência à função. No entanto, será possível editar a descrição da função usando o IAM. Para ter mais informações, consulte Editar uma função vinculada a serviço no Guia do usuário do IAM.

Exclusão de função vinculada ao serviço para o Amazon ECR

Se você não precisar mais usar um atributo ou serviço que exija uma função vinculada a um serviço, recomendamos que você exclua essa função. Dessa forma, você não tem uma entidade não utilizada que não seja monitorada ou mantida ativamente. No entanto, você deve excluir as regras de criação de repositórios do seu registro em cada região antes de poder excluir manualmente a função vinculada ao serviço.

nota

Se você tentar excluir recursos enquanto o serviço Amazon ECR ainda estiver usando as funções, sua ação de exclusão poderá falhar. Se isso acontecer, aguarde alguns minutos e tente novamente.

Para excluir os recursos do Amazon ECR usados pela função vinculada ao serviço AWSServiceRoleForECRTemplate

1. Abra o console do Amazon ECR em https://console.aws.amazon.com/ecr/

2. Na barra de navegação, escolha a região em que suas regras de criação de repositório são criadas.

3. No painel de navegação, escolha Private registry (Registro privado).

4. Na página Registro privado, na seção Modelos de criação de repositório, escolha Editar.

5. Para cada regra de criação de repositório que você criou, selecione a regra e escolha Excluir regra.

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 AWSServiceRoleForECRTemplatevinculada ao serviço. Para mais informações, consulte Excluir um perfil vinculado ao serviço no Guia do usuário do IAM.