Encontre nomes de recursos da Amazon (ARNs) no AMS - Guia do usuário avançado do AMS

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

Encontre nomes de recursos da Amazon (ARNs) no AMS

Um Amazon Resource Name (ARN) é uma string que identifica exclusivamente um AWS recurso, como EC2 instâncias, buckets S3, contas, funções Lambda e assim por diante. AWS requer um ARN quando você deseja especificar um recurso de forma inequívoca em todos eles AWS, como nas políticas do IAM, nas tags do Amazon Relational Database Service (Amazon RDS) e nas chamadas de API. ARNs são construídos a partir de identificadores que especificam o serviço, a região, a conta e outras informações. Há três formatos de ARN:

arn:aws:service:region:account-id:resource-id
arn:aws:service:region:account-id:resource-type/resource-id
arn:aws:service:region:account-id:resource-type:resource-id
nota

O formato exato de um ARN depende do serviço e do tipo de recurso. Para saber mais ARNs, consulte Amazon Resource Names (ARNs) e Namespaces AWS de serviços e formatos ARN.

Para exemplos do formato ARN por recurso, consulte a tabela de tipos de recursos de Referência AWS de Autorização de Serviço.

Encontrar o ARN de um objeto da AWS pode ser difícil. Aqui estão três maneiras de experimentar:

  • Console de serviços da AWS: acesse o console de serviços relevante da AWS, localize o recurso e encontre o ARN nos detalhes do recurso.

  • AWS API/CLI (você deve primeiro instalar a AWS CLI): procure o serviço relevante na Referência de Comandos da CLI da AWS e, dependendo do serviço da AWS, procure a operação relevante, como, ou describeget, e assim por diante. Por exemplo, para todas as funções, políticas e usuários do IAM, você pode obter o ARN na saída da CLI com:

    aws iam get-role --role-name EMR_DefaultRole

  • Crie o ARN com base no formato relevante: encontre o formato ARN para o recurso, consultando a página Ações, recursos e chaves de condição para serviços da AWS, localizando o serviço relevante e, em seguida, a ação relevante e detalhando o formato ARN do recurso. Depois de ter o formato, substitua as variáveis pelas configurações relevantes.

Você mesmo pode criar o ARN seguindo o formato apropriado (os formatos mudam por serviço e tipo de recurso) e preenchendo as informações. Aqui estão alguns exemplos de ARN:

  • Um Conta da AWS ARN tem a seguinte sintaxe:

    arn:aws:iam::ACCOUNT-ID:root

  • Um ARN do S3 tem uma hierarquia plana de buckets e objetos associados:

    arn:aws:s3:::ams-bucket

  • Um EC2 ARN tem subtipos de recursos, como imagem, grupos de segurança, instância e assim por diante. Esse exemplo inclui o ID da instância no final:

    arn:aws:ec2:us-east-1:123456789012:instance/i-012abcd34efghi56

  • Um ARN do Lambda tem o nome da função para a parte resource-id, e talvez seja necessário incluir o número da versão no final, conforme mostrado neste exemplo:

    arn:aws:lambda:us-east-1:123456789012:function:api-function:1

O AWS Key Management Service serviço fornece as seguintes informações: Encontrar o ID da chave e o ARN da chave.

Para encontrar o ARN de uma tabela do DynamoDB, use a CLI da tabela descritiva do DynamoDB.

Para quem não conhece a descoberta AWS ARNs, consulte AWS ARN Explained: Amazon Resource Name Guide.