Acciones, recursos y claves de condición para Amazon Athena

Amazon Athena (prefijo de servicio: athena) proporciona las siguientes claves de contexto de condición, acciones y recursos específicos del servicio para su uso en las políticas de permisos de IAM.

Referencias:

• Obtenga información para configurar este servicio.

• Vea una lista de las operaciones de API disponibles para este servicio.

• Obtenga información sobre cómo proteger este servicio y sus recursos mediante las políticas de permisos de IAM.

Acciones definidas por Amazon Athena

Puede especificar las siguientes acciones en el elemento Action de una declaración de política de IAM. Utilice políticas para conceder permisos para realizar una operación en AWS. Cuando utiliza una acción en una política, normalmente permite o deniega el acceso a la operación de la API o comandos de la CLI con el mismo nombre. No obstante, en algunos casos, una sola acción controla el acceso a más de una operación. Asimismo, algunas operaciones requieren varias acciones diferentes.

La columna Tipos de recurso de la tabla de Acción indica si cada acción admite permisos de nivel de recursos. Si no hay ningún valor para esta columna, debe especificar todos los recursos ("*") a los que aplica la política en el elemento Resource de la instrucción de su política. Si la columna incluye un tipo de recurso, puede especificar un ARN de ese tipo en una instrucción con dicha acción. Si la acción tiene uno o más recursos necesarios, la persona que llama debe tener permiso para usar la acción con esos recursos. Los recursos necesarios se indican en la tabla con un asterisco (*). Si limita el acceso a los recursos con el elemento Resource de una política de IAM, debe incluir un ARN o patrón para cada tipo de recurso requerido. Algunas acciones admiten varios tipos de recursos. Si el tipo de recurso es opcional (no se indica como obligatorio), puede elegir utilizar uno de los tipos de recursos opcionales.

La columna Claves de condición de la tabla Acciones incluye claves que puede especificar en el elemento Condition de la instrucción de una política. Para obtener más información sobre las claves de condición asociadas a los recursos del servicio, consulte la columna Claves de condición de la tabla Tipos de recursos.

nota

Las claves de condición de recursos se enumeran en la tabla Tipos de recursos. Encontrará un enlace al tipo de recurso que se aplica a una acción en la columna Tipos de recursos (*obligatorio) de la tabla Acciones. El tipo de recurso de la tabla Tipos de recursos incluye la columna Claves de condición, que son las claves de condición del recurso que se aplican a una acción de la tabla Acciones.

Para obtener información detallada sobre las columnas de la siguiente tabla, consulte Tabla Acciones.

Acciones	Descripción	Nivel de acceso	Tipos de recursos (*necesarios)	Claves de condición	Acciones dependientes
BatchGetNamedQuery	Concede permiso para obtener información acerca de una o varias consultas con nombre	Lectura	workgroup*
BatchGetPreparedStatement	Otorga permiso para obtener información sobre una o varias instrucciones preparadas	Lectura	workgroup*
BatchGetQueryExecution	Concede permiso para obtener información acerca de una o varias ejecuciones de consultas	Lectura	workgroup*
CancelCapacityReservation	Concede permiso para cancelar una reserva de capacidad	Escritura	capacity-reservation*
CancelQueryExecution	Concede permiso para cancelar la ejecución de la consulta. Obsoleto. Solo se aplica a las entidades principales y servicios de AWS que utilizan el controlador JDBC de Athena con una versión anterior a 1.1.0. De no ser así, utiliza StopQueryExecution	Escritura	workgroup*
CreateCapacityReservation	Concede permiso para crear una reserva de capacidad	Escritura	capacity-reservation*
				aws:RequestTag/${TagKey} aws:TagKeys
CreateDataCatalog	Concede permiso para crear un catálogo de datos	Escritura	datacatalog*
				aws:RequestTag/${TagKey} aws:TagKeys
CreateNamedQuery	Concede permiso para crear una consulta con nombre	Escritura	workgroup*
CreateNotebook	Otorga permiso para crear un cuaderno	Escritura	workgroup*
CreatePreparedStatement	Concede permiso para crear una instrucción preparada.	Escritura	workgroup*
CreatePresignedNotebookUrl	Otorga permiso para crear una URL prefirmada de un cuaderno	Escritura	workgroup*
CreateWorkGroup	Concede permiso para crear un grupo de trabajo	Escritura	workgroup*
				aws:RequestTag/${TagKey} aws:TagKeys
DeleteCapacityReservation	Concede permiso para eliminar una reserva de capacidad	Escritura	capacity-reservation*
DeleteDataCatalog	Concede permiso para eliminar un catálogo de datos	Escritura	datacatalog*
DeleteNamedQuery	Concede permiso para eliminar una consulta con nombre especificada	Escritura	workgroup*
DeleteNotebook	Otorga permiso para eliminar un cuaderno	Escritura	workgroup*
DeletePreparedStatement	Concede permiso para eliminar una instrucción preparada especificada.	Escritura	workgroup*
DeleteWorkGroup	Concede permiso para eliminar un grupo de trabajo	Escritura	workgroup*
ExportNotebook	Otorga permiso para exportar un cuaderno	Escritura	workgroup*
GetCalculationExecution	Otorga permiso para obtener una ejecución de un cálculo	Lectura	workgroup*
GetCalculationExecutionCode	Otorga permiso para obtener un código de ejecución de un cálculo	Lectura	workgroup*
GetCalculationExecutionStatus	Otorga permiso para obtener un estado de ejecución de un cálculo	Lectura	workgroup*
GetCapacityAssignmentConfiguration	Concede permiso para obtener información sobre la asignación de capacidad para una reserva de capacidad	Lectura	capacity-reservation*
GetCapacityReservation	Concede permiso para obtener una reserva de capacidad	Lectura	capacity-reservation*
GetCatalogs	Concede permiso para permitir el acceso a bases de datos y tablas. Solo se aplica a las entidades principales y políticas administradas de los servicios de AWS que utilizan el controlador JDBC de Athena con una versión anterior a 1.1.0	Lectura
GetDataCatalog	Concede permiso para obtener un catálogo de datos	Lectura	datacatalog*
GetDatabase	Concede permiso para obtener una base de datos para un determinado catálogo de datos	Lectura	datacatalog*
GetExecutionEngine	Concede permiso para permitir el acceso a la base de datos y tabla especificadas. Solo se aplica a las entidades principales y políticas administradas de los servicios de AWS que utilizan el controlador JDBC de Athena con una versión anterior a 1.1.0	Lectura
GetExecutionEngines	Concede permiso para permitir el acceso a bases de datos y tablas. Solo se aplica a las entidades principales y políticas administradas de los servicios de AWS que utilizan el controlador JDBC de Athena con una versión anterior a 1.1.0	Lectura
GetNamedQuery	Concede permiso para obtener información acerca de una consulta con nombre especificada	Lectura	workgroup*
GetNamespace	Concede permiso para permitir el acceso a la base de datos y tabla especificadas. Solo se aplica a las entidades principales y políticas administradas de los servicios de AWS que utilizan el controlador JDBC de Athena con una versión anterior a 1.1.0	Lectura
GetNamespaces	Concede permiso para permitir el acceso a bases de datos y tablas. Solo se aplica a las entidades principales y políticas administradas de los servicios de AWS que utilizan el controlador JDBC de Athena con una versión anterior a 1.1.0	Lectura
GetNotebookMetadata	Otorga permiso para obtener metadatos de un cuaderno	Lectura	workgroup*
GetPreparedStatement	Concede permiso para obtener información sobre la instrucción preparada especificada	Lectura	workgroup*
GetQueryExecution	Concede permiso para obtener información sobre la ejecución de consulta especificada	Lectura	workgroup*
GetQueryExecutions	Concede permiso para ejecuciones de consultas. Obsoleto. Solo se aplica a las entidades principales y servicios de AWS que utilizan el controlador JDBC de Athena con una versión anterior a 1.1.0. De no ser así, utiliza ListQueryExecutions	Lectura
GetQueryResults	Concede permiso para obtener los resultados de la consulta	Lectura	workgroup*
GetQueryResultsStream	Concede permiso para obtener el flujo de resultados de la consulta	Lectura	workgroup*
GetQueryRuntimeStatistics	Otorga permiso para obtener estadísticas de tiempo de ejecución para la ejecución de una consulta especificada	Lectura	workgroup*
GetSession	Otorga permiso para obtener una sesión	Lectura	workgroup*
GetSessionStatus	Otorga permiso para obtener el estado de una sesión	Lectura	workgroup*
GetTable	Concede permiso para permitir el acceso a la tabla especificada. Solo se aplica a las entidades principales y políticas administradas de los servicios de AWS que utilizan el controlador JDBC de Athena con una versión anterior a 1.1.0	Lectura
GetTableMetadata	Concede permiso para obtener metadatos sobre una tabla de un catálogo de datos determinado	Lectura	datacatalog*
GetTables	Concede permiso para permitir el acceso a las tablas. Solo se aplica a las entidades principales y políticas administradas de los servicios de AWS que utilizan el controlador JDBC de Athena con una versión anterior a 1.1.0	Lectura
GetWorkGroup	Concede permiso para obtener un grupo de trabajo	Lectura	workgroup*
ImportNotebook	Otorga permiso para importar un cuaderno	Escritura	workgroup*
ListApplicationDPUSizes	Otorga permiso para devolver una lista de ApplicationRuntimeIds	Enumeración
ListCalculationExecutions	Otorga permiso para devolver una lista de ejecuciones de cálculos	Enumeración	workgroup*
ListCapacityReservations	Concede permiso para devolver una lista de reservas de capacidad para la Cuenta de AWS especificada	Enumeración
ListDataCatalogs	Concede permiso para devolver una lista de catálogos de datos de la Cuenta de AWS especificada.	Enumeración
ListDatabases	Concede permiso para devolver una lista de bases de datos de un catálogo de datos determinado	Enumeración	datacatalog*
ListEngineVersions	Concede permiso para devolver una lista de versiones del motor de athena para la Cuenta de AWS especificada.	Lectura
ListExecutors	Otorga permiso para devolver una lista de ejecutores	Enumeración
ListNamedQueries	Concede permiso para devolver una lista de consultas con nombre en Amazon Athena para la Cuenta de AWS especificada.	Enumeración	workgroup*
ListNotebookMetadata	Otorga permiso para devolver una lista de cuadernos de un grupo de trabajo determinado	Enumeración	workgroup*
ListNotebookSessions	Otorga permiso para devolver una lista de sesiones de un cuaderno determinado	Enumeración	workgroup*
ListPreparedStatements	Concede permiso para devolver una lista de instrucciones preparadas para el grupo de trabajo especificado.	Enumeración	workgroup*
ListQueryExecutions	Concede permiso para devolver una lista de ejecuciones de consultas para la Cuenta de AWS especificada	Lectura	workgroup*
ListSessions	Otorga permiso para devolver una lista de sesiones de un grupo de trabajo determinado	Enumeración	workgroup*
ListTableMetadata	Concede permiso para devolver la lista de metadatos de una tabla que se encuentra en una base de datos de un catálogo de datos determinado	Lectura	datacatalog*
ListTagsForResource	Concede permiso para devolver una lista de etiquetas de un recurso	Lectura	capacity-reservation*
			datacatalog*
			workgroup*
ListWorkGroups	Concede permiso para devolver una lista de grupos de trabajo para la Cuenta de AWS especificada.	Enumeración
PutCapacityAssignmentConfiguration	Concede permiso para asignar capacidad de una reserva de capacidad a consultas	Escritura	capacity-reservation*
			workgroup*
RunQuery	Concede permiso para ejecutar una consulta. Obsoleto. Solo se aplica a las entidades principales y servicios de AWS que utilizan el controlador JDBC de Athena con una versión anterior a 1.1.0. De no ser así, utiliza StartQueryExecution	Escritura
StartCalculationExecution	Otorga permiso para iniciar la ejecución de un cálculo	Escritura	workgroup*
StartQueryExecution	Concede permiso para iniciar una ejecución de consulta mediante una consulta SQL proporcionada como una cadena	Escritura	workgroup*
StartSession	Otorga permiso para iniciar una sesión	Escritura	workgroup*
StopCalculationExecution	Otorga permiso para detener la ejecución de un cálculo	Escritura	workgroup*
StopQueryExecution	Concede permiso para detener la ejecución de una consulta especificada	Escritura	workgroup*
TagResource	Otorga permiso para agregar una etiqueta a un recurso.	Etiquetado	capacity-reservation*
			datacatalog*
			workgroup*
				aws:RequestTag/${TagKey} aws:TagKeys
TerminateSession	Otorga permiso para terminar una sesión	Escritura	workgroup*
UntagResource	Otorga permiso para eliminar una etiqueta de un recurso.	Etiquetado	capacity-reservation*
			datacatalog*
			workgroup*
				aws:TagKeys
UpdateCapacityReservation	Concede permiso para actualizar una reserva de capacidad	Escritura	capacity-reservation*
UpdateDataCatalog	Concede permiso para actualizar un catálogo de datos	Escritura	datacatalog*
UpdateNamedQuery	Concede permiso para actualizar una consulta con nombre especificada	Escritura	workgroup*
UpdateNotebook	Otorga permiso para actualizar un cuaderno	Escritura	workgroup*
UpdateNotebookMetadata	Otorga permiso para actualizar metadatos de un cuaderno	Escritura	workgroup*
UpdatePreparedStatement	Concede permiso para actualizar una instrucción preparada	Escritura	workgroup*
UpdateWorkGroup	Concede permiso para actualizar un grupo de trabajo	Escritura	workgroup*

Tipos de recurso definidos por Amazon Athena

Los siguientes tipos de recurso están definidos por este servicio y se pueden utilizar en el elemento Resource de las instrucciones de política de permisos de IAM. Cada acción de la tabla Acciones identifica los tipos de recursos que se pueden especificar con dicha acción. Un tipo de recurso también puede definir qué claves de condición se pueden incluir en una política. Estas claves se muestran en la última columna de la tabla Tipos de recursos. Para obtener información detallada sobre las columnas de la siguiente tabla, consulte Tabla Tipos de recurso.

Tipos de recurso	ARN	Claves de condición
datacatalog	arn:${Partition}:athena:${Region}:${Account}:datacatalog/${DataCatalogName}	aws:ResourceTag/${TagKey}
workgroup	arn:${Partition}:athena:${Region}:${Account}:workgroup/${WorkGroupName}	aws:ResourceTag/${TagKey}
capacity-reservation	arn:${Partition}:athena:${Region}:${Account}:capacity-reservation/${CapacityReservationName}	aws:ResourceTag/${TagKey}

Claves de condición de Amazon Athena

Amazon Athena define las siguientes claves de condiciones que se pueden utilizar en el elemento Condition de una política de IAM. Puede utilizar estas claves para ajustar más las condiciones en las que se aplica la instrucción de política. Para obtener información detallada sobre las columnas de la siguiente tabla, consulte Tabla Claves de condición.

Para ver las claves de condición globales que están disponibles para todos los servicios, consulte Claves de condición globales disponibles.

Claves de condición	Descripción	Tipo
aws:RequestTag/${TagKey}	Filtra el acceso según si hay pares de clave-valor de etiqueta en la solicitud.	Cadena
aws:ResourceTag/${TagKey}	Filtra el acceso por los pares clave-valor de etiqueta adjuntados al recurso	Cadena
aws:TagKeys	Filtra el acceso en función de la presencia de claves de etiqueta en la solicitud	ArrayOfString