Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés. # Nombres de recursos de Amazon (ARN) en Amazon QuickSight Los nombres de recursos de Amazon (ARN) identifican de forma exclusiva los recursos de AWS. Un ARN identifica un recurso de forma inequívoca en todos losAWS, por ejemplo, en IAMPolicies, etiquetas de Amazon Relational Database Service (Amazon RDS) y llamadas a la API. Para obtener el ARN de un Amazon QuickSight, puede utilizar`Describe`operación en el recurso correspondiente. Puedes usar esta sección para aprender cómo funcionan los ARN. El material aquí proporciona ejemplos que están diseñados específicamente para Amazon QuickSight. **Topics** + [Formatos de ARN](qs-arn-format.md) + [Amazon QuickSight ARN de recursos de](qs-resource-arns.md) # Formatos de ARN Los ARN están delimitados por dos puntos y están compuestos por*Segmentos de*, que son las partes deben estar separadas por comas (`:`). Los componentes y valores específicos utilizados en los segmentos de un ARN dependen de quéAWSservicio para el que es el ARN. El siguiente ejemplo muestra cómo se construyen los ARN. ``` 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 ``` Estos ARN contienen los siguientes segmentos: ***`partition`***: la partición en la que se encuentra el recurso. ParaRegiones de AWS, la partición es*aws*. Si tiene recursos en otras particiones, la partición es*aws-partitionname*. Por ejemplo, la partición de los recursos de la región China (Pekín) es `aws-cn`. ***`service`***: el espacio de nombres del servicio que identifica elAWSProduct. Por ejemplo,`quicksight`identifica a Amazon QuickSight,`s3`identifica Amazon S3,`iam`identifica la IAM, y así sucesivamente. ***`region`***— ElRegión de AWSen el que reside el recurso. Tenga en cuenta que los ARN de algunos recursos no requieren unaRegión de AWS, por lo que este componente podría omitirse en algunos casos, como en el caso de S3. Amazon QuickSight Los ARN requieren unRegión de AWS. ***`account-id`***: el ID deCuenta de AWSque posee el recurso. Cuando se usa el número de cuenta en una operación de ARN o API, se omiten los guiones (por ejemplo, 123456789012). Tenga en cuenta que los ARN de algunos recursos no requieren un número de cuenta, por lo que este componente podría omitirse. Amazon QuickSight Los ARN requieren unCuenta de AWSnúmero. Sin embargo, el número de cuenta y elRegión de AWSse omiten de los ARN del depósito de S3, como se muestra a continuación. ``` arn:aws:s3:::bucket_name arn:aws:s3:::bucket_name/key_name ``` ***`resource`*o*`resource-type`***: el contenido de esta parte del ARN varía en función del servicio. Un identificador de recurso puede ser el nombre o ID del recurso (por ejemplo,`user/Bob`o`instance/i-1234567890abcdef0`) o una ruta de recurso. Por ejemplo, algunos identificadores de recursos incluyen un recurso principal (`sub-resource-type/parent-resource/sub-resource`) o un calificador como una versión (*resource-*:*nombre-recurso*:*Calificador*). Algunos ARN de recursos pueden incluir una ruta, una variable o una ruta. Puede utilizar los caracteres comodín (`*`y`?`) dentro de cualquier segmento de ARN. Un asterisco (`*`) representa cualquier combinación de cero o más caracteres y un signo de interrogación (`?`) representa un único carácter. Puede utilizar varios caracteres \$1 o ? o en cada segmento, pero un carácter comodín no puede abarcar varios segmentos. Si usa el ARN para los permisos, evite usar`*`caracteres comodín si es posible, para limitar el acceso solo a los elementos necesarios. A continuación, se muestran algunos ejemplos de uso de rutas, caracteres comodín y variables. Para el siguiente ejemplo, utilizamos un ARN de S3. Puede usar esto cuando conceda permisos a S3 en una IAMPolicy. Este ARN de S3 muestra que se especifican una ruta y un archivo. **nota** El*Nombre de la clave*se usa para describir lo que parece una ruta y un archivo después`bucketname/`. Se denominan nombres de clave porque un depósito en realidad no contiene estructuras de carpetas como las que se usan en el sistema de archivos de su computadora. En cambio, la barra (`/`) es un delimitador que ayuda a que la organización del depósito sea más intuitiva. En este caso, el nombre del depósito es`examplebucket`y el nombre de la clave es`developers/design_info.doc`. ``` arn:aws:s3:::examplebucket/my-data/sales-export-2019-q4.json ``` Si desea identificar todos los objetos del depósito, puede usar un comodín para indicar que todos los nombres de clave (o rutas y archivos) están incluidos en el ARN, de la siguiente manera. ``` arn:aws:s3:::examplebucket/* ``` Puede usar parte de un nombre de clave más el comodín para identificar todos los objetos que comiencen con un patrón específico. En este caso, se parece a un nombre de carpeta más un comodín, como se muestra a continuación. Sin embargo, este ARN también incluye cualquier «subcarpeta» dentro de`my-data`. ``` arn:aws:s3:::examplebucket/my-data/* ``` Puede especificar un nombre parcial agregando un comodín. Este identifica todos los objetos que comiencen con`my-data/sales-export*`. ``` arn:aws:s3:::examplebucket/my-data/sales-export* ``` En este caso, al especificar el uso de este comodín, se incluyen los objetos con nombres como los siguientes: + `my-data/sales-export-1.xlsx` + `my-data/sales-export-new.txt` + `my-data/sales-export-2019/file1.txt` Puede usar comodines de ambos tipos (asteriscos y signos de interrogación) en combinación o por separado, como se muestra a continuación. ``` arn:aws:s3:::examplebucket/my-data/sales-export-2019-q?.* arn:aws:s3:::examplebucket/my-data/sales-export-20??-q?.* ``` O bien, si desea preparar el ARN para el futuro, puede reemplazar todo el año con un comodín, en lugar de usar simplemente comodines para los dos últimos dígitos. ``` arn:aws:s3:::examplebucket/my-data/sales-export-????-q?.* arn:aws:s3:::examplebucket/my-data/sales-export-*-q?.* ``` Para obtener más información sobre los ARN de S3, consulte[Especificación de recursos en una política](https://docs.aws.amazon.com//AmazonS3/latest/dev/s3-arn-format.html)y[Clave y metadatos de objetos](https://docs.aws.amazon.com//AmazonS3/latest/dev/UsingMetadata.html)en la*Amazon Simple Storage Service Resource Guide.* # Amazon QuickSight ARN de recursos de Amazon define los siguientes tipos de recursos QuickSight: usuario, grupo y panel. Se utilizan en Amazon QuickSight Llamadas a la API y como elementos de las declaraciones de IAMPermission. Paraup-to-date información para Amazon QuickSight (prefijo de servicio: vista rápida) claves de contexto de condición, acciones y recursos para su uso en las políticas de IAMPermission, consulte[Claves de condición, recursos y acciones de Amazon QuickSight](https://docs.aws.amazon.com/IAM/latest/UserGuide/list_amazonquicksight.html)en la*Guía del usuario de* | Tipo de recurso | Formato de ARN | Claves de condición | | --- | --- | --- | | user | arn: \$1 \$1Account\$1 :user/\$1 Account\$1 :user/\$1 Account\$1 :user/\$1 Account\$1 :user/\$1 Account\$1ResourceId\$1 | N/A | | grupo | arn: \$1 \$1Account\$1 :Resource: \$1 \$1Account\$1 :Resource\$1 :guarder/\$1 Resource\$1 :detector/\$1ResourceId\$1 | N/A | | panel | arn: \$1 \$1Account\$1 :guarder/\$1 Account\$1 :detectaber/\$1 Account\$1 :dasher/\$1 Account\$1 :detector/\$1 Account\$1ResourceId\$1 | N/A | Los ARN de recursos se crean a partir de los segmentos que describen el recurso. Por ejemplo, un ARN de recursos para un análisis consta de los siguientes segmentos. ``` arn::quicksight:::/ ``` Los segmentos se definen de la siguiente manera: + *`partition`*— Por ejemplo:`aws`o`aws-cn`. + *`aws-region`*— ElRegión de AWSque contiene el recurso. + *`aws-account-id`*— ElCuenta de AWSque contiene el recurso. Esto excluye los guiones. + *`resource-type`*: el tipo de recurso de. Para este ejemplo, este`analyses`. Para un tablero, es`dashboard`. + *`resource-id`*: el identificador único para un recurso específico. LaRegión de AWS, el tipo de recurso y el identificador del recurso se identifican en la URL del recurso cuando utiliza Amazon QuickSight consola de . Por ejemplo, imaginemos que esta es la URL del análisis para el que desea un ARN. ``` https://us-east-2.quicksight.aws.amazon.com/sn/analysis/4036e682-7de6-4c05-8a76-be51b9ec9b29 ``` El valor de Región de AWS es `us-east-2`. El tipo de recurso es`analysis`. El ID de recurso de esta URL es`4036e682-7de6-4c05-8a76-be51b9ec9b29`. Si el número de su cuenta de`111122223333`, el ARN para este análisis es el siguiente. ``` arn:aws:quicksight:us-east-2:111122223333:analysis/4036e682-7de6-4c05-8a76-be51b9ec9b29 ``` Para obtenerCuenta de AWSnúmero, póngase en contacto con el administrador del sistema.