Actions, ressources et clés de condition pour Amazon Athena - Référence de l'autorisation de service

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Actions, ressources et clés de condition pour Amazon Athena

Amazon Athena (préfixe de service : athena) fournit les ressources, actions et clés de contexte de condition spécifiques au service suivantes en vue de leur utilisation dans les politiques d'autorisation IAM.

Références :

Actions définies par Amazon Athena

Vous pouvez indiquer les actions suivantes dans l'élément Action d'une déclaration de politique IAM. Utilisez des politiques pour accorder des autorisations permettant d'effectuer une opération dans AWS. Lorsque vous utilisez une action dans une politique, vous autorisez ou refusez généralement l'accès à l'opération d'API ou à la commande CLI portant le même nom. Toutefois, dans certains cas, une seule action contrôle l'accès à plusieurs opérations. D'autres opérations, quant à elles, requièrent plusieurs actions différentes.

La colonne Types de ressources indique si chaque action prend en charge les autorisations au niveau des ressources. S'il n'y a pas de valeur pour cette colonne, vous devez indiquer toutes les ressources (« * ») dans l'élément Resource de votre déclaration de politique. Si la colonne inclut un type de ressource, vous pouvez indiquer un ARN de ce type dans une déclaration avec cette action. Si l'action comporte une ou plusieurs ressources requises, l'appelant doit être autorisé à utiliser l'action avec ces ressources. Les ressources requises sont indiquées dans le tableau par un astérisque (*). Si vous limitez l'accès aux ressources avec l'Resourceélément dans une politique IAM, vous devez inclure un ARN ou un modèle pour chaque type de ressource requis. Certaines actions prennent en charge plusieurs types de ressources. Si le type de ressource est facultatif (non indiqué comme obligatoire), vous pouvez choisir d'utiliser l'un, mais pas l'autre.

La colonne Clés de condition inclut des clés que vous pouvez spécifier dans l'élément Condition d'une déclaration de politique. Pour plus d'informations sur les clés de condition associées aux ressources du service, consultez la colonne Clés de condition du tableau des types de ressources.

Note

Les clés de condition des ressources sont répertoriées dans le tableau Types de ressources. Vous pouvez trouver un lien vers le type de ressource qui s'applique à une action dans la colonne Types de ressources (* obligatoire) du tableau Actions. Le type de ressource indiqué dans le tableau Types de ressources inclut la colonne Clés de condition, qui contient les clés de condition de ressource qui s'appliquent à une action dans le tableau Actions.

Pour plus de détails sur les colonnes du tableau suivant, veuillez consulter le tableau Actions.

Actions Description Niveau d'accès Types de ressources (*obligatoire) Clés de condition Actions dépendantes
BatchGetNamedQuery Accorde l'autorisation nécessaire pour obtenir des informations relatives à une ou plusieurs requêtes nommées Lecture

workgroup*

BatchGetPreparedStatement Accorde l'autorisation d'obtenir des informations sur une ou plusieurs instructions préparées Lecture

workgroup*

BatchGetQueryExecution Accorde l'autorisation nécessaire pour obtenir des informations relatives à une ou plusieurs exécutions de requête Lecture

workgroup*

CancelCapacityReservation Accorde l'autorisation d'annuler une réservation de capacité Écrire

capacity-reservation*

CancelQueryExecution Accorde l'autorisation d'annuler l’exécution d’une requête. Obsolète. S'applique uniquement aux AWS services et aux principaux qui utilisent le pilote Athena JDBC antérieur à la version 1.1.0. Utiliser StopQueryExecution autrement Écrire

workgroup*

CreateCapacityReservation Accorde l'autorisation de créer une réservation de capacité Écrire

capacity-reservation*

aws:RequestTag/${TagKey}

aws:TagKeys

CreateDataCatalog Accorde l'autorisation nécessaire pour créer un catalogue de données Écrire

datacatalog*

aws:RequestTag/${TagKey}

aws:TagKeys

CreateNamedQuery Accorde l'autorisation nécessaire pour créer une requête nommée Écrire

workgroup*

CreateNotebook Accorde l'autorisation de créer un bloc-notes Écrire

workgroup*

CreatePreparedStatement Accorde l'autorisation nécessaire pour créer une déclaration préparée Écrire

workgroup*

CreatePresignedNotebookUrl Accorde l'autorisation de créer une URL de bloc-notes présignée Écrire

workgroup*

CreateWorkGroup Accorde l'autorisation nécessaire pour créer un groupe de travail Écrire

workgroup*

aws:RequestTag/${TagKey}

aws:TagKeys

DeleteCapacityReservation Accorde l'autorisation de supprimer une réserve de capacité Écrire

capacity-reservation*

DeleteDataCatalog Accorde l'autorisation nécessaire pour supprimer un catalogue de données Écrire

datacatalog*

DeleteNamedQuery Accorde l'autorisation nécessaire pour supprimer une requête nommée spécifiée Écrire

workgroup*

DeleteNotebook Accorde l'autorisation de supprimer un bloc-notes Écrire

workgroup*

DeletePreparedStatement Accorde l'autorisation nécessaire pour supprimer une déclaration préparée spécifiée Écrire

workgroup*

DeleteWorkGroup Accorde l'autorisation nécessaire pour supprimer un groupe de travail Écrire

workgroup*

ExportNotebook Accorde l'autorisation d'exporter un bloc-notes Écrire

workgroup*

GetCalculationExecution Accorde l'autorisation d'obtenir l'exécution d'un calcul Lecture

workgroup*

GetCalculationExecutionCode Accorde l'autorisation d'obtenir un code d'exécution de calcul Lecture

workgroup*

GetCalculationExecutionStatus Accorde l'autorisation d'obtenir le statut d'exécution d'un calcul Lecture

workgroup*

GetCapacityAssignmentConfiguration Accorde l'autorisation d'obtenir des informations d'attribution de capacité pour une réservation de capacité Lecture

capacity-reservation*

GetCapacityReservation Accorde l'autorisation d'obtenir une réservation de capacité Lecture

capacity-reservation*

GetCatalogs Accorde l’autorisation pour permettre l'accès aux bases de données et aux tables. S'applique uniquement aux AWS services gérés, à la politique et aux principes qui utilisent un pilote Athena JDBC version 1.1.0 Lecture
GetDataCatalog Accorde l'autorisation nécessaire pour obtenir un catalogue de données Lecture

datacatalog*

GetDatabase Accorde l'autorisation nécessaire pour obtenir une base de données pour un catalogue de données en particulier Lecture

datacatalog*

GetExecutionEngine Accorde l’autorisation pour permettre l'accès aux bases de données et aux tables spécifiées. S'applique uniquement aux AWS services gérés, à la politique et aux principes qui utilisent un pilote Athena JDBC version 1.1.0 Lecture
GetExecutionEngines Accorde l’autorisation pour permettre l'accès aux bases de données et aux tables. S'applique uniquement aux AWS services gérés, à la politique et aux principes qui utilisent un pilote Athena JDBC version 1.1.0 Lecture
GetNamedQuery Accorde l'autorisation nécessaire pour obtenir des informations relatives à la requête nommée spécifiée Lecture

workgroup*

GetNamespace Accorde l’autorisation pour permettre l'accès aux bases de données et aux tables spécifiées. S'applique uniquement aux AWS services gérés, à la politique et aux principes qui utilisent un pilote Athena JDBC version 1.1.0 Lecture
GetNamespaces Accorde l’autorisation pour permettre l'accès aux bases de données et aux tables. S'applique uniquement aux AWS services gérés, à la politique et aux principes qui utilisent un pilote Athena JDBC version 1.1.0 Lecture
GetNotebookMetadata Accorde l'autorisation d'obtenir les métadonnées du bloc-notes Lecture

workgroup*

GetPreparedStatement Accorde l'autorisation nécessaire pour obtenir des informations relatives à la déclaration préparée spécifiée Lecture

workgroup*

GetQueryExecution Accorde l'autorisation nécessaire pour obtenir des informations relatives à l'exécution de la requête spécifiée Lecture

workgroup*

GetQueryExecutions Accorde l'autorisation d’obtenir des exécutions de requêtes. Obsolète. S'applique uniquement aux AWS services et aux principaux qui utilisent le pilote Athena JDBC antérieur à la version 1.1.0. Utiliser ListQueryExecutions autrement Lecture
GetQueryResults Accorde l'autorisation nécessaire pour obtenir les résultats de la requête Lecture

workgroup*

GetQueryResultsStream Accorde l'autorisation nécessaire pour obtenir le flux de résultats de la requête Lecture

workgroup*

GetQueryRuntimeStatistics Accorde l'autorisation d'obtenir des statistiques d'exécution pour l'exécution de la requête spécifiée Lecture

workgroup*

GetSession Accorde l'autorisation d'obtenir une session Lecture

workgroup*

GetSessionStatus Accorde l'autorisation d'obtenir un statut de session Lecture

workgroup*

GetTable Accorde l’autorisation pour permettre l'accès à la table spécifiée. S'applique uniquement aux AWS services gérés, à la politique et aux principes qui utilisent un pilote Athena JDBC version 1.1.0 Lecture
GetTableMetadata Accorde l'autorisation nécessaire pour obtenir une métadonnée sur une table pour un catalogue de données en particulier Lecture

datacatalog*

GetTables Accorde l’autorisation pour activer l'accès aux tables. S'applique uniquement aux AWS services gérés, à la politique et aux principes qui utilisent un pilote Athena JDBC version 1.1.0 Lecture
GetWorkGroup Accorde l'autorisation nécessaire pour obtenir un groupe de travail Lecture

workgroup*

ImportNotebook Accorde l'autorisation d'importer un bloc-notes Écrire

workgroup*

ListApplicationDPUSizes Autorise le renvoi d'une liste de ApplicationRuntimeIds Liste
ListCalculationExecutions Accorde l'autorisation de renvoyer une liste d'exécutions de calculs Liste

workgroup*

ListCapacityReservations Autorise le renvoi d'une liste des réservations de capacité pour la capacité spécifiée Compte AWS Liste
ListDataCatalogs Accorde l'autorisation de renvoyer une liste de catalogues de données pour le fichier spécifié Compte AWS Liste
ListDatabases Accorde l'autorisation nécessaire pour renvoyer une liste de bases de données pour un catalogue de données en particulier Liste

datacatalog*

ListEngineVersions Accorde l'autorisation de renvoyer une liste des versions du moteur Athena pour le moteur spécifié Compte AWS Lecture
ListExecutors Accorde l'autorisation de renvoyer une liste d'exécuteurs Liste
ListNamedQueries Accorde l'autorisation de renvoyer une liste de requêtes nommées dans Amazon Athena pour les requêtes spécifiées Compte AWS Liste

workgroup*

ListNotebookMetadata Accorde l'autorisation de renvoyer une liste de blocs-notes pour un groupe de travail donné Liste

workgroup*

ListNotebookSessions Accorde l'autorisation de renvoyer une liste de sessions pour un bloc-notes donné Liste

workgroup*

ListPreparedStatements Accorde l'autorisation nécessaire pour renvoyer une liste de déclarations préparées pour le groupe de travail spécifié Liste

workgroup*

ListQueryExecutions Accorde l'autorisation de renvoyer une liste des exécutions de requêtes pour le paramètre spécifié Compte AWS Lecture

workgroup*

ListSessions Accorde l'autorisation de renvoyer une liste de sessions pour un groupe de travail donné Liste

workgroup*

ListTableMetadata Accorde les autorisations pour renvoyer une liste de métadonnées de table dans une base de données pour un catalogue de données en particulier Lecture

datacatalog*

ListTagsForResource Accorde l'autorisation de renvoyer une liste d'étiquettes pour une ressource Lecture

capacity-reservation*

datacatalog*

workgroup*

ListWorkGroups Accorde l'autorisation de renvoyer une liste de groupes de travail pour le groupe spécifié Compte AWS Liste
PutCapacityAssignmentConfiguration Accorde l'autorisation d'attribuer une capacité à des requêtes à partir d'une réservation de capacité Écrire

capacity-reservation*

workgroup*

RunQuery Accorde l'autorisation d'exécuter une requête. Obsolète. S'applique uniquement aux AWS services et aux principaux qui utilisent le pilote Athena JDBC antérieur à la version 1.1.0. Utiliser StartQueryExecution autrement Écrire
StartCalculationExecution Accorde l'autorisation de démarrer une exécution de calcul Écrire

workgroup*

StartQueryExecution Accorde l'autorisation nécessaire pour commencer l'exécution d'une requête à l'aide d'une requête SQL fournie en tant que chaîne Écrire

workgroup*

StartSession Accorde l'autorisation de démarrer une session Écrire

workgroup*

StopCalculationExecution Accorde l'autorisation d'arrêter une exécution de calcul Écrire

workgroup*

StopQueryExecution Accorde l'autorisation nécessaire pour arrêter l'exécution de la requête spécifiée Écrire

workgroup*

TagResource Accorde l'autorisation d'ajouter une balise à une ressource Identification

capacity-reservation*

datacatalog*

workgroup*

aws:RequestTag/${TagKey}

aws:TagKeys

TerminateSession Accorde l'autorisation de mettre fin à une session Écrire

workgroup*

UntagResource Accorde l'autorisation de supprimer une balise d'une ressource Identification

capacity-reservation*

datacatalog*

workgroup*

aws:TagKeys

UpdateCapacityReservation Accorde l'autorisation de mettre à jour une réservation de capacité Écrire

capacity-reservation*

UpdateDataCatalog Accorde l'autorisation nécessaire pour mettre à jour un catalogue de données Écrire

datacatalog*

UpdateNamedQuery Accorde l'autorisation nécessaire pour mettre à jour une requête nommée spécifiée Écrire

workgroup*

UpdateNotebook Accorde l'autorisation de mettre à jour un bloc-notes Écrire

workgroup*

UpdateNotebookMetadata Accorde l'autorisation de mettre à jour les métadonnées du bloc-notes Écrire

workgroup*

UpdatePreparedStatement Accorde l'autorisation nécessaire pour mettre à jour une déclaration préparée Écrire

workgroup*

UpdateWorkGroup Accorde l'autorisation nécessaire pour mettre à jour un groupe de travail Écrire

workgroup*

Types de ressources définis par Amazon Athena

Ce service définit les types de ressources suivants, qui peuvent être utilisés dans l' Resource élément des déclarations de politique d'autorisation IAM. Chaque action du tableau Actions identifie les types de ressources pouvant être spécifiés avec cette action. Un type de ressource peut également définir les clés de condition que vous pouvez inclure dans une politique. Ces clés sont affichées dans la dernière colonne du tableau. Pour plus de détails sur les colonnes du tableau suivant, veuillez consulter le tableau Types de ressources.

Types de ressources ARN Clés de condition
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}

Clés de condition pour Amazon Athena

Amazon Athena définit les clés de condition suivantes que vous pouvez utiliser dans l'élément Condition d'une stratégie IAM. Vous pouvez utiliser ces clés pour affiner les conditions d'application de la déclaration de politique. Pour plus de détails sur les colonnes du tableau suivant, veuillez consulter le tableau Clés de condition.

Pour afficher les clés de condition globales disponibles pour tous les services, consultez Clés de condition globales disponibles.

Clés de condition Description Type
aws:RequestTag/${TagKey} Filtre l'accès en fonction de la présence de paires clé-valeur d'identification dans la demande Chaîne
aws:ResourceTag/${TagKey} Filtre l'accès en fonction des paires clé-valeur d'identification attachées à la ressource Chaîne
aws:TagKeys Filtre l'accès en fonction de la présence de clés d'identification dans la requête ArrayOfString