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á. # Nomes de recurso da Amazon (ARN) na Amazon QuickSight Nomes de recurso da Amazon (ARNs) identificam apenas recursos da AWS. Um ARN identifica um recurso de forma inequívoca em todos osAWS, por exemplo, em IAMPolicies, tags do Amazon Relational Database Service (Amazon RDS) e chamadas de API. Para recuperar o ARN de uma Amazon QuickSight, você pode usar o`Describe`operação no recurso relevante. Você pode usar esta seção para aprender como os ARNs funcionam. O material aqui fornece exemplos voltados especificamente para a Amazon. QuickSight. **Topics** + [Formatos ARN](qs-arn-format.md) + [Amazônia QuickSight ARNs de recursos do](qs-resource-arns.md) # Formatos ARN Os ARNs são delimitados por dois pontos e compostos de*segmentos*, que são partes separadas por dois pontos (`:`). Os componentes e valores específicos usados nos segmentos de um ARN dependem de quaisAWSserviço para o qual o ARN se destina. O exemplo a seguir mostra como os ARNs são construídos. ``` arn:partition:service:region:account-id:resource-id arn:partition:service:region:account-id:resource-type/resource-id arn:partition:service:region:account-id:resource-type:resource-id ``` Esses ARNs contêm os seguintes segmentos: ***`partition`***— A partição onde o recurso se encontra. Para o padrãoRegiões da AWS, a partição é*aws*. Se você tem recursos em outras partições, a partição é*aws-partitionname*. Por exemplo, a partição de recursos na região China (Pequim) é `aws-cn`. ***`service`***— O namespace de serviço que identifica aAWSproduto. Por exemplo,`quicksight`identifica a Amazon QuickSight,`s3`identifica o Amazon S3,`iam`identifica o IAM e assim por diante. ***`region`***— ORegião da AWSem que o recurso reside. Os ARNs de alguns recursos não exigem umaRegião da AWS, portanto, este componente pode ser omitido em alguns casos, como no caso do S3. Amazônia QuickSight Os ARNs exigem umRegião da AWS. ***`account-id`***— O ID doConta da AWSque possui o recurso. Ao usar o número da conta em um ARN ou uma operação de API, você omite os hifens (por exemplo, 123456789012). Os ARNs de alguns recursos não exigem um número de conta, portanto, este componente pode ser omitido. Amazônia QuickSight Os ARNs exigem umConta da AWSnúmero. No entanto, o número da conta e oRegião da AWSsão omitidos dos ARNs do bucket do S3, conforme mostrado a seguir. ``` arn:aws:s3:::bucket_name arn:aws:s3:::bucket_name/key_name ``` ***`resource`*ou*`resource-type`***— O conteúdo dessa parte do ARN varia de acordo com o serviço. Um identificador de recurso pode ser o nome ou o ID do recurso (por exemplo,`user/Bob`ou`instance/i-1234567890abcdef0`) ou um caminho de recurso. Por exemplo, alguns identificadores de recursos incluem um recurso pai (`sub-resource-type/parent-resource/sub-resource`) ou um qualificador, como uma versão (*Tipo de recurso do*:*resource-name*:*qualificadora*). Alguns ARNs de recursos podem incluir um caminho, uma variável ou um curinga. Você pode usar caracteres curingas (`*`e`?`) dentro de qualquer segmento de ARN. Um asterisco (`*`) representa qualquer combinação de zero ou mais caracteres, e um ponto de interrogação (`?`) representa qualquer caractere único. É possível usar vários caracteres \$1 ou ? em cada segmento, mas um curinga não pode abranger segmentos. Se você estiver usando o ARN para permissões, evite usar`*`curingas, se possível, para limitar o acesso somente aos elementos necessários. Veja a seguir alguns exemplos de para o uso de caminhos, caracteres curinga e variáveis. No exemplo a seguir, usamos um ARN S3. Você pode usar isso ao conceder permissões ao S3 em uma IAMPolicy. Este ARN do S3 mostra um caminho e um arquivo especificados. **nota** O termo*nome da chave*é usado para descrever o que parece ser um caminho e um arquivo após`bucketname/`. Eles são chamados de nomes de chave porque um intervalo não contém estruturas de pastas como as usadas no sistema de arquivos do seu computador. Em vez disso, a barra (`/`) é um delimitador que ajuda a tornar a organização do bucket mais intuitiva. Nesse caso, o nome do bucket é`examplebucket`e o nome da chave é`developers/design_info.doc`. ``` arn:aws:s3:::examplebucket/my-data/sales-export-2019-q4.json ``` Se você quiser identificar todos os objetos no bucket, poderá usar um caractere curinga para indicar que todos os nomes de chave (ou caminhos e arquivos) estão incluídos no ARN, como a seguir. ``` arn:aws:s3:::examplebucket/* ``` Você pode usar parte de um nome de chave mais o curinga para identificar todos os objetos que começam com um padrão específico. Nesse caso, ele se assemelha a um nome de pasta mais um curinga, conforme mostrado a seguir. No entanto, esse ARN também inclui quaisquer “subpastas” dentro do`my-data`. ``` arn:aws:s3:::examplebucket/my-data/* ``` Você pode especificar um nome parcial adicionando um curinga. Este identifica todos os objetos que começam com`my-data/sales-export*`. ``` arn:aws:s3:::examplebucket/my-data/sales-export* ``` Nesse caso, especificar o uso desse curinga inclui os objetos com nomes como os seguintes: + `my-data/sales-export-1.xlsx` + `my-data/sales-export-new.txt` + `my-data/sales-export-2019/file1.txt` Você pode usar curingas de ambos os tipos (asteriscos e pontos de interrogação) em combinação ou separadamente, conforme mostrado a seguir. ``` arn:aws:s3:::examplebucket/my-data/sales-export-2019-q?.* arn:aws:s3:::examplebucket/my-data/sales-export-20??-q?.* ``` Ou, se você quiser preparar o ARN para o futuro, poderá substituir o ano inteiro por um curinga, em vez de usar apenas curingas para os dois últimos dígitos. ``` arn:aws:s3:::examplebucket/my-data/sales-export-????-q?.* arn:aws:s3:::examplebucket/my-data/sales-export-*-q?.* ``` Para ler mais sobre os ARNs do S3, consulte[Especificação de recursos em uma política](https://docs.aws.amazon.com//AmazonS3/latest/dev/s3-arn-format.html)e[Chave de objeto e metadados](https://docs.aws.amazon.com//AmazonS3/latest/dev/UsingMetadata.html)no*Guia do usuário do Amazon Simple Storage Service.* # Amazônia QuickSight ARNs de recursos do Os seguintes tipos de recursos são definidos pela Amazon QuickSight: usuário, grupo e painel. Eles são usados na Amazon QuickSight Chamadas de API e como elementos das declarações IAMPermission. Para encontrar oup-to-date informações para a Amazon QuickSight (prefixo do serviço: visão rápida) recursos, ações e chaves de contexto de condição para uso em políticas do IAMPermission, consulte[Ações, recursos e chaves de condição da Amazon QuickSight](https://docs.aws.amazon.com/IAM/latest/UserGuide/list_amazonquicksight.html)no*Guia do usuário do Iam.* | Tipo de recurso | Formato de Nome de região da Amazon (ARN) | Chaves de condição | | --- | --- | --- | | user | arn::::::::::::::::::::::::::::::::::::::ResourceId\$1 | N/D | | grupo | arn::::::::::::::::::::::::::::::::::::::ResourceId\$1 | N/D | | painel | arn::::::::::::::::::::::::::::::::::::::::ResourceId\$1 | N/D | Os ARNs de recursos são construídos a partir dos segmentos que descrevem seu recurso. Por exemplo, um ARN de recurso para uma análise consiste nos seguintes segmentos. ``` arn::quicksight:::/ ``` Os segmentos são definidos da seguinte forma: + *`partition`*— Por exemplo,`aws`ou`aws-cn`. + *`aws-region`*— ORegião da AWSque contém o recurso. + *`aws-account-id`*— OConta da AWSque contém o recurso. Isso exclui os hífens. + *`resource-type`*— O tipo de recurso. Para este exemplo, isso é`analyses`. Para um painel, é`dashboard`. + *`resource-id`*— O identificador exclusivo de um recurso específico. ORegião da AWS, o tipo de recurso e o ID do recurso são identificados na URL do recurso quando você estiver usando a Amazon QuickSight console do . Por exemplo, suponhamos que esta seja a URL da análise para a qual é necessário um ARN. ``` https://us-east-2.quicksight.aws.amazon.com/sn/analysis/4036e682-7de6-4c05-8a76-be51b9ec9b29 ``` O Região da AWS é `us-east-2`. O tipo de recurso do é`analysis`. O ID do recurso nesse URL é`4036e682-7de6-4c05-8a76-be51b9ec9b29`. Se o seu número de conta da`111122223333`, então o ARN para essa análise é o seguinte. ``` arn:aws:quicksight:us-east-2:111122223333:analysis/4036e682-7de6-4c05-8a76-be51b9ec9b29 ``` Para obter oConta da AWS, entre em contato com o administrador do sistema.