

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 l'API de données Amazon Redshift

API de données Amazon Redshift (préfixe de service) : `redshift-data`) fournit les opérations, ressources, actions et clés de condition spécifiques au service suivantes à utiliser dans les politiques d'autorisation IAM.

Références :
+ Découvrez comment [configurer ce service](https://docs.aws.amazon.com/redshift/latest/mgmt/data-api.html).
+ Affichez la liste des [opérations d'API disponibles pour ce service](https://docs.aws.amazon.com/redshift-data/latest/APIReference/).
+ Découvrez comment protéger ce service et ses ressources avec les stratégies d'autorisation [IAM](https://docs.aws.amazon.com/redshift/latest/mgmt/redshift-iam-authentication-access-control.html).
+ Consultez le [référence d'autorisation de service programmatique](https://servicereference.us-east-1.amazonaws.com/v1/redshift-data/redshift-data.json) pour ce service.

**Topics**
+ [Opérations d'API définies par l'API Amazon Redshift Data](#list_redshift-data-operations)
+ [Actions définies par l'API de données Amazon Redshift](#list_redshift-data-actions-as-permissions)
+ [Types de ressources définis par l'API de données Amazon Redshift](#list_redshift-data-resources-for-iam-policies)
+ [Clés de condition pour l'API de données Amazon Redshift](#list_redshift-data-policy-keys)

## Opérations d'API définies par l'API Amazon Redshift Data
<a name="list_redshift-data-operations"></a>

Le tableau suivant associe les opérations d'API aux actions IAM qu'elles autorisent. Seules les clés de condition qui ont des valeurs statiques pour l'API et l'action données sont répertoriées ; pour l'ensemble complet des clés de condition prises en charge par chaque action, consultez le [Tableau des actions](#list_redshift-data-actions-as-permissions).




- **   BatchExecuteStatement  **
  - **Action IAM:**  [redshift-data:BatchExecuteStatement](#list_redshift-data-action-BatchExecuteStatement) 
  - **Clé de condition:** 
  - **Valeur (s) possible (s):** 
  - **Niveau d’accès:** Écrire

- **   CancelStatement  **
  - **Action IAM:**  [redshift-data:CancelStatement](#list_redshift-data-action-CancelStatement) 
  - **Clé de condition:** 
  - **Valeur (s) possible (s):** 
  - **Niveau d’accès:** Écrire

- **   DescribeStatement  **
  - **Action IAM:**  [redshift-data:DescribeStatement](#list_redshift-data-action-DescribeStatement) 
  - **Clé de condition:** 
  - **Valeur (s) possible (s):** 
  - **Niveau d’accès:** Lecture

- **   DescribeTable  **
  - **Action IAM:**  [redshift-data:DescribeTable](#list_redshift-data-action-DescribeTable) 
  - **Clé de condition:** 
  - **Valeur (s) possible (s):** 
  - **Niveau d’accès:** Lecture

- **   ExecuteStatement  **
  - **Action IAM:**  [redshift-data:ExecuteStatement](#list_redshift-data-action-ExecuteStatement) 
  - **Clé de condition:** 
  - **Valeur (s) possible (s):** 
  - **Niveau d’accès:** Écrire

- **   GetStatementResult  **
  - **Action IAM:**  [redshift-data:GetStatementResult](#list_redshift-data-action-GetStatementResult) 
  - **Clé de condition:** 
  - **Valeur (s) possible (s):** 
  - **Niveau d’accès:** Lecture

- **   GetStatementResultV2  **
  - **Action IAM:**  [redshift-data:GetStatementResult](#list_redshift-data-action-GetStatementResult) 
  - **Clé de condition:** 
  - **Valeur (s) possible (s):** 
  - **Niveau d’accès:** Lecture

- **   ListDatabases  **
  - **Action IAM:**  [redshift-data:ListDatabases](#list_redshift-data-action-ListDatabases) 
  - **Clé de condition:** 
  - **Valeur (s) possible (s):** 
  - **Niveau d’accès:** Lecture

- **   ListSchemas  **
  - **Action IAM:**  [redshift-data:ListSchemas](#list_redshift-data-action-ListSchemas) 
  - **Clé de condition:** 
  - **Valeur (s) possible (s):** 
  - **Niveau d’accès:** Lecture

- **   ListSessions  **
  - **Action IAM:**  [redshift-data:ListSessions](#list_redshift-data-action-ListSessions) 
  - **Clé de condition:** 
  - **Valeur (s) possible (s):** 
  - **Niveau d’accès:** List

- **   ListStatements  **
  - **Action IAM:**  [redshift-data:ListStatements](#list_redshift-data-action-ListStatements) 
  - **Clé de condition:** 
  - **Valeur (s) possible (s):** 
  - **Niveau d’accès:** List

- **   ListTables  **
  - **Action IAM:**  [redshift-data:ListTables](#list_redshift-data-action-ListTables) 
  - **Clé de condition:** 
  - **Valeur (s) possible (s):** 
  - **Niveau d’accès:** List



## Actions définies par l'API de données Amazon Redshift
<a name="list_redshift-data-actions-as-permissions"></a>

Vous pouvez indiquer les actions suivantes dans l'élément `Action` d'une déclaration de politique IAM. Pour chaque action, le tableau répertorie les types de ressources et les clés de condition pris en charge par cette action. 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.




- **   [BatchExecuteStatement](https://docs.aws.amazon.com/redshift-data/latest/APIReference/API_BatchExecuteStatement.html)  **
  - **Description:** Accorde l'autorisation d'exécuter plusieurs requêtes sous une seule connexion
  - **Types de ressources (\*obligatoire):** [cluster](#list_redshift-data-resource-cluster) / **Clés de condition:** [aws:ResourceTag/${TagKey}](#list_redshift-data-aws_ResourceTag___TagKey_)<br />[redshift-data:glue-catalog-arn](#list_redshift-data-redshift-data_glue-catalog-arn)<br />[redshift-data:session-owner-iam-userid](#list_redshift-data-redshift-data_session-owner-iam-userid)
  - **Types de ressources (\*obligatoire):** [workgroup](#list_redshift-data-resource-workgroup) / **Clés de condition:** [aws:ResourceTag/${TagKey}](#list_redshift-data-aws_ResourceTag___TagKey_)<br />[redshift-data:glue-catalog-arn](#list_redshift-data-redshift-data_glue-catalog-arn)<br />[redshift-data:session-owner-iam-userid](#list_redshift-data-redshift-data_session-owner-iam-userid)
  - **Niveau d’accès:** Écrire

- **   [CancelStatement](https://docs.aws.amazon.com/redshift-data/latest/APIReference/API_CancelStatement.html)  **
  - **Description:** Accorde l'autorisation d'annuler une requête en cours d'exécution
  - **Types de ressources (\*obligatoire):** 
  - **Clés de condition:** [redshift-data:statement-owner-iam-userid](#list_redshift-data-redshift-data_statement-owner-iam-userid)
  - **Niveau d’accès:** Écriture

- **   [DescribeStatement](https://docs.aws.amazon.com/redshift-data/latest/APIReference/API_DescribeStatement.html)  **
  - **Description:** Accorde l'autorisation de récupérer des informations détaillées sur l'exécution d'une instruction
  - **Types de ressources (\*obligatoire):** 
  - **Clés de condition:** [redshift-data:statement-owner-iam-userid](#list_redshift-data-redshift-data_statement-owner-iam-userid)
  - **Niveau d’accès:** Lecture

- **   [DescribeTable](https://docs.aws.amazon.com/redshift-data/latest/APIReference/API_DescribeTable.html)  **
  - **Description:** Accorde l'autorisation de récupérer les métadonnées d'une table particulière
  - **Types de ressources (\*obligatoire):** [cluster\*](#list_redshift-data-resource-cluster) / **Clés de condition:** [aws:ResourceTag/${TagKey}](#list_redshift-data-aws_ResourceTag___TagKey_)
  - **Types de ressources (\*obligatoire):** [workgroup\*](#list_redshift-data-resource-workgroup) / **Clés de condition:** [aws:ResourceTag/${TagKey}](#list_redshift-data-aws_ResourceTag___TagKey_)
  - **Niveau d’accès:** Lecture

- **   [ExecuteStatement](https://docs.aws.amazon.com/redshift-data/latest/APIReference/API_ExecuteStatement.html)  **
  - **Description:** Accorde l'autorisation d'exécuter une requête
  - **Types de ressources (\*obligatoire):** [cluster](#list_redshift-data-resource-cluster) / **Clés de condition:** [aws:ResourceTag/${TagKey}](#list_redshift-data-aws_ResourceTag___TagKey_)<br />[redshift-data:glue-catalog-arn](#list_redshift-data-redshift-data_glue-catalog-arn)<br />[redshift-data:session-owner-iam-userid](#list_redshift-data-redshift-data_session-owner-iam-userid)
  - **Types de ressources (\*obligatoire):** [workgroup](#list_redshift-data-resource-workgroup) / **Clés de condition:** [aws:ResourceTag/${TagKey}](#list_redshift-data-aws_ResourceTag___TagKey_)<br />[redshift-data:glue-catalog-arn](#list_redshift-data-redshift-data_glue-catalog-arn)<br />[redshift-data:session-owner-iam-userid](#list_redshift-data-redshift-data_session-owner-iam-userid)
  - **Niveau d’accès:** Écrire

- **   [GetStagingBucketLocation](https://docs.aws.amazon.com/redshift-data/latest/APIReference/API_GetStagingBucketLocation.html)  **
  - **Description:** Accorde l'autorisation d'obtenir l'emplacement du bucket de transit pour un groupe de travail géré donné
  - **Types de ressources (\*obligatoire):** [managed-workgroup\*](#list_redshift-data-resource-managed-workgroup)
  - **Clés de condition:**  
  - **Niveau d’accès:** Lecture

- **   [GetStatementResult](https://docs.aws.amazon.com/redshift-data/latest/APIReference/API_GetStatementResult.html)  **
  - **Description:** Accorde l'autorisation de récupérer le résultat d'une requête
  - **Types de ressources (\*obligatoire):** 
  - **Clés de condition:** [redshift-data:statement-owner-iam-userid](#list_redshift-data-redshift-data_statement-owner-iam-userid)
  - **Niveau d’accès:** Lecture

- **   [ListDatabases](https://docs.aws.amazon.com/redshift-data/latest/APIReference/API_ListDatabases.html)  **
  - **Description:** Accorde l'autorisation de répertorier les bases de données d'un cluster spécifique
  - **Types de ressources (\*obligatoire):** [cluster\*](#list_redshift-data-resource-cluster) / **Clés de condition:** [aws:ResourceTag/${TagKey}](#list_redshift-data-aws_ResourceTag___TagKey_)
  - **Types de ressources (\*obligatoire):** [workgroup\*](#list_redshift-data-resource-workgroup) / **Clés de condition:** [aws:ResourceTag/${TagKey}](#list_redshift-data-aws_ResourceTag___TagKey_)
  - **Niveau d’accès:** Lecture

- **   [ListSchemas](https://docs.aws.amazon.com/redshift-data/latest/APIReference/API_ListSchemas.html)  **
  - **Description:** Accorde l'autorisation de répertorier les schémas d'un cluster spécifique
  - **Types de ressources (\*obligatoire):** [cluster\*](#list_redshift-data-resource-cluster) / **Clés de condition:** [aws:ResourceTag/${TagKey}](#list_redshift-data-aws_ResourceTag___TagKey_)
  - **Types de ressources (\*obligatoire):** [workgroup\*](#list_redshift-data-resource-workgroup) / **Clés de condition:** [aws:ResourceTag/${TagKey}](#list_redshift-data-aws_ResourceTag___TagKey_)
  - **Niveau d’accès:** Lecture

- **   [ListSessions](https://docs.aws.amazon.com/redshift-data/latest/APIReference/API_ListSessions.html)  **
  - **Description:** Permet de répertorier les sessions pour un directeur donné
  - **Types de ressources (\*obligatoire):** 
  - **Clés de condition:** [redshift-data:session-owner-iam-userid](#list_redshift-data-redshift-data_session-owner-iam-userid)
  - **Niveau d’accès:** List

- **   [ListStatements](https://docs.aws.amazon.com/redshift-data/latest/APIReference/API_ListStatements.html)  **
  - **Description:** Accorde l'autorisation de répertorier les requêtes d'un principal spécifique
  - **Types de ressources (\*obligatoire):** 
  - **Clés de condition:** [redshift-data:statement-owner-iam-userid](#list_redshift-data-redshift-data_statement-owner-iam-userid)
  - **Niveau d’accès:** Liste

- **   [ListTables](https://docs.aws.amazon.com/redshift-data/latest/APIReference/API_ListTables.html)  **
  - **Description:** Accorde l'autorisation de répertorier les tables d'un cluster spécifique
  - **Types de ressources (\*obligatoire):** [cluster\*](#list_redshift-data-resource-cluster) / **Clés de condition:** [aws:ResourceTag/${TagKey}](#list_redshift-data-aws_ResourceTag___TagKey_)
  - **Types de ressources (\*obligatoire):** [workgroup\*](#list_redshift-data-resource-workgroup) / **Clés de condition:** [aws:ResourceTag/${TagKey}](#list_redshift-data-aws_ResourceTag___TagKey_)
  - **Niveau d’accès:** Liste



## Types de ressources définis par l'API de données Amazon Redshift
<a name="list_redshift-data-resources-for-iam-policies"></a>

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.



| Types de ressources | ARN | Clés de condition | 
| --- | --- | --- | 
|  [cluster](https://docs.aws.amazon.com/redshift/latest/mgmt/working-with-clusters.html)  | arn:${Partition}:redshift:${Region}:${Account}:cluster:${ClusterName} | [aws:ResourceTag/${TagKey}](#list_redshift-data-aws_ResourceTag___TagKey_) | 
|  [managed-workgroup](https://docs.aws.amazon.com/redshift/latest/mgmt/working-with-serverless.html)  | arn:${Partition}:redshift-serverless:${Region}:${Account}:managed-workgroup/${ManagedWorkgroupId} |   | 
|  [workgroup](https://docs.aws.amazon.com/redshift/latest/mgmt/working-with-serverless.html)  | arn:${Partition}:redshift-serverless:${Region}:${Account}:workgroup/${WorkgroupId} | [aws:ResourceTag/${TagKey}](#list_redshift-data-aws_ResourceTag___TagKey_) | 

## Clés de condition pour l'API de données Amazon Redshift
<a name="list_redshift-data-policy-keys"></a>

L'API de données Amazon Redshift définit les clés de condition suivantes que vous pouvez utiliser dans l'élément `Condition` d'une politique IAM.



| Clés de condition | Description | Type | 
| --- | --- | --- | 
|   [aws:ResourceTag/${TagKey}](https://docs.aws.amazon.com/redshift/latest/mgmt/redshift-iam-access-control-overview.html#redshift-policy-resources.conditions)  | Filtre l'accès en fonction de la valeur d'identification associée à la ressource | String | 
|   [redshift-data:glue-catalog-arn](https://docs.aws.amazon.com/redshift/latest/mgmt/redshift-iam-access-control-overview.html#redshift-policy-resources.conditions)  | Accès aux filtres par chaîne de colle au catalogue | ARN | 
|   [redshift-data:session-owner-iam-userid](https://docs.aws.amazon.com/redshift/latest/mgmt/redshift-iam-access-control-overview.html#redshift-policy-resources.conditions)  | Filtre l'accès par nom d'utilisateur iam du propriétaire de la session | String | 
|   [redshift-data:statement-owner-iam-userid](https://docs.aws.amazon.com/redshift/latest/mgmt/redshift-iam-access-control-overview.html#redshift-policy-resources.conditions)  | Filtre l'accès en fonction du propriétaire de l'instruction iam userid | String | 