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.
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 del IAM.
Temas
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 | Leer | |||
BatchGetPreparedStatement | Otorga permiso para obtener información sobre una o varias instrucciones preparadas | Leer | |||
BatchGetQueryExecution | Concede permiso para obtener información acerca de una o varias ejecuciones de consultas | Leer | |||
CancelCapacityReservation | Concede permiso para cancelar una reserva de capacidad | Escritura | |||
CancelQueryExecution | Concede permiso para cancelar la ejecución de la consulta. Obsoleto. Se aplica solo a AWS los servicios y principales que utilizan el controlador Athena JDBC anterior a la versión 1.1.0. StopQueryExecution Úselo de otra manera | Escritura | |||
CreateCapacityReservation | Concede permiso para crear una reserva de capacidad | Escritura | |||
CreateDataCatalog | Concede permiso para crear un catálogo de datos | Escritura | |||
CreateNamedQuery | Concede permiso para crear una consulta con nombre | Escritura | |||
CreateNotebook | Otorga permiso para crear un cuaderno | Escritura | |||
CreatePreparedStatement | Concede permiso para crear una instrucción preparada. | Escritura | |||
CreatePresignedNotebookUrl | Otorga permiso para crear una URL prefirmada de un cuaderno | Escritura | |||
CreateWorkGroup | Concede permiso para crear un grupo de trabajo | Escritura | |||
DeleteCapacityReservation | Concede permiso para eliminar una reserva de capacidad | Escritura | |||
DeleteDataCatalog | Concede permiso para eliminar un catálogo de datos | Escritura | |||
DeleteNamedQuery | Concede permiso para eliminar una consulta con nombre especificada | Escritura | |||
DeleteNotebook | Otorga permiso para eliminar un cuaderno | Escritura | |||
DeletePreparedStatement | Concede permiso para eliminar una instrucción preparada especificada. | Escritura | |||
DeleteWorkGroup | Concede permiso para eliminar un grupo de trabajo | Escritura | |||
ExportNotebook | Otorga permiso para exportar un cuaderno | Escritura | |||
GetCalculationExecution | Otorga permiso para obtener una ejecución de un cálculo | Leer | |||
GetCalculationExecutionCode | Otorga permiso para obtener un código de ejecución de un cálculo | Leer | |||
GetCalculationExecutionStatus | Otorga permiso para obtener un estado de ejecución de un cálculo | Leer | |||
GetCapacityAssignmentConfiguration | Concede permiso para obtener información sobre la asignación de capacidad para una reserva de capacidad | Leer | |||
GetCapacityReservation | Concede permiso para obtener una reserva de capacidad | Leer | |||
GetCatalogs | Concede permiso para permitir el acceso a bases de datos y tablas. Se aplica únicamente a AWS los servicios gestionados, políticas y principios que utilizan un controlador JDBC de Athena versión 1.1.0 | Leer | |||
GetDataCatalog | Concede permiso para obtener un catálogo de datos | Leer | |||
GetDatabase | Concede permiso para obtener una base de datos para un determinado catálogo de datos | Leer | |||
GetExecutionEngine | Concede permiso para permitir el acceso a la base de datos y tabla especificadas. Se aplica únicamente a AWS los servicios gestionados, políticas y principios que utilizan un controlador JDBC de Athena versión 1.1.0 | Leer | |||
GetExecutionEngines | Concede permiso para permitir el acceso a bases de datos y tablas. Se aplica únicamente a AWS los servicios gestionados, políticas y principios que utilizan un controlador JDBC de Athena versión 1.1.0 | Leer | |||
GetNamedQuery | Concede permiso para obtener información acerca de una consulta con nombre especificada | Leer | |||
GetNamespace | Concede permiso para permitir el acceso a la base de datos y tabla especificadas. Se aplica únicamente a AWS los servicios gestionados, políticas y principios que utilizan un controlador JDBC de Athena versión 1.1.0 | Leer | |||
GetNamespaces | Concede permiso para permitir el acceso a bases de datos y tablas. Se aplica únicamente a AWS los servicios gestionados, políticas y principios que utilizan un controlador JDBC de Athena versión 1.1.0 | Leer | |||
GetNotebookMetadata | Otorga permiso para obtener metadatos de un cuaderno | Leer | |||
GetPreparedStatement | Concede permiso para obtener información sobre la instrucción preparada especificada | Leer | |||
GetQueryExecution | Concede permiso para obtener información sobre la ejecución de consulta especificada | Leer | |||
GetQueryExecutions | Concede permiso para ejecuciones de consultas. Obsoleto. Se aplica solo a AWS los servicios y principales que utilizan el controlador Athena JDBC anterior a la versión 1.1.0. ListQueryExecutions Úselo de otra manera | Leer | |||
GetQueryResults | Concede permiso para obtener los resultados de la consulta | Leer | |||
GetQueryResultsStream | Concede permiso para obtener el flujo de resultados de la consulta | Leer | |||
GetQueryRuntimeStatistics | Otorga permiso para obtener estadísticas de tiempo de ejecución para la ejecución de una consulta especificada | Leer | |||
GetSession | Otorga permiso para obtener una sesión | Leer | |||
GetSessionStatus | Otorga permiso para obtener el estado de una sesión | Leer | |||
GetTable | Concede permiso para permitir el acceso a la tabla especificada. Se aplica únicamente a AWS los servicios gestionados, políticas y principios que utilizan un controlador JDBC de Athena versión 1.1.0 | Leer | |||
GetTableMetadata | Concede permiso para obtener metadatos sobre una tabla de un catálogo de datos determinado | Leer | |||
GetTables | Concede permiso para permitir el acceso a las tablas. Se aplica únicamente a AWS los servicios gestionados, políticas y principios que utilizan un controlador JDBC de Athena versión 1.1.0 | Leer | |||
GetWorkGroup | Concede permiso para obtener un grupo de trabajo | Leer | |||
ImportNotebook | Otorga permiso para importar un cuaderno | Escritura | |||
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 | |||
ListCapacityReservations | Otorga permiso para devolver una lista de reservas de capacidad para la capacidad especificada Cuenta de AWS | Enumeración | |||
ListDataCatalogs | Otorga permiso para devolver una lista de catálogos de datos de la información especificada Cuenta de AWS | Enumeración | |||
ListDatabases | Concede permiso para devolver una lista de bases de datos de un catálogo de datos determinado | Enumeración | |||
ListEngineVersions | Otorga permiso para devolver una lista de las versiones del motor Athena para la versión especificada Cuenta de AWS | Leer | |||
ListExecutors | Otorga permiso para devolver una lista de ejecutores | Enumeración | |||
ListNamedQueries | Otorga permiso para devolver una lista de consultas con nombre en Amazon Athena para lo especificado Cuenta de AWS | Enumeración | |||
ListNotebookMetadata | Otorga permiso para devolver una lista de cuadernos de un grupo de trabajo determinado | Enumeración | |||
ListNotebookSessions | Otorga permiso para devolver una lista de sesiones de un cuaderno determinado | Enumeración | |||
ListPreparedStatements | Concede permiso para devolver una lista de instrucciones preparadas para el grupo de trabajo especificado. | Enumeración | |||
ListQueryExecutions | Otorga permiso para devolver una lista de las consultas ejecutadas para la consulta especificada Cuenta de AWS | Leer | |||
ListSessions | Otorga permiso para devolver una lista de sesiones de un grupo de trabajo determinado | Enumeración | |||
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 | Leer | |||
ListTagsForResource | Concede permiso para devolver una lista de etiquetas de un recurso | Leer | |||
ListWorkGroups | Otorga permiso para devolver una lista de grupos de trabajo para el especificado Cuenta de AWS | Enumeración | |||
PutCapacityAssignmentConfiguration | Concede permiso para asignar capacidad de una reserva de capacidad a consultas | Escritura | |||
RunQuery | Concede permiso para ejecutar una consulta. Obsoleto. Se aplica solo a AWS los servicios y principales que utilizan el controlador Athena JDBC anterior a la versión 1.1.0. StartQueryExecution Úselo de otra manera | Escritura | |||
StartCalculationExecution | Otorga permiso para iniciar la ejecución de un cálculo | Escritura | |||
StartQueryExecution | Concede permiso para iniciar una ejecución de consulta mediante una consulta SQL proporcionada como una cadena | Escritura | |||
StartSession | Otorga permiso para iniciar una sesión | Escritura | |||
StopCalculationExecution | Otorga permiso para detener la ejecución de un cálculo | Escritura | |||
StopQueryExecution | Concede permiso para detener la ejecución de una consulta especificada | Escritura | |||
TagResource | Otorga permiso para agregar una etiqueta a un recurso. | Etiquetado | |||
TerminateSession | Otorga permiso para terminar una sesión | Escritura | |||
UntagResource | Otorga permiso para eliminar una etiqueta de un recurso. | Etiquetado | |||
UpdateCapacityReservation | Concede permiso para actualizar una reserva de capacidad | Escritura | |||
UpdateDataCatalog | Concede permiso para actualizar un catálogo de datos | Escritura | |||
UpdateNamedQuery | Concede permiso para actualizar una consulta con nombre especificada | Escritura | |||
UpdateNotebook | Otorga permiso para actualizar un cuaderno | Escritura | |||
UpdateNotebookMetadata | Otorga permiso para actualizar metadatos de un cuaderno | Escritura | |||
UpdatePreparedStatement | Concede permiso para actualizar una instrucción preparada | Escritura | |||
UpdateWorkGroup | Concede permiso para actualizar un grupo de trabajo | Escritura |
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}
|
|
workgroup |
arn:${Partition}:athena:${Region}:${Account}:workgroup/${WorkGroupName}
|
|
capacity-reservation |
arn:${Partition}:athena:${Region}:${Account}:capacity-reservation/${CapacityReservationName}
|
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 de 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 |