

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.

# AWS Glue Spécifications des API REST pour Apache Iceberg
<a name="iceberg-rest-apis"></a>

Cette section contient les spécifications relatives au catalogue REST d' AWS Glue Iceberg et aux API d' AWS Glue extension, ainsi que les considérations relatives à l'utilisation de ces API. 

Les demandes d'API adressées aux AWS Glue Data Catalog points de terminaison sont authentifiées à l'aide de AWS Signature Version 4 (SigV4). Consultez [AWS la section Signature version 4 pour les demandes d'API](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_sigv.html) pour en savoir plus sur AWS SigV4.

Lors de l'accès au point de terminaison du AWS Glue service et aux AWS Glue métadonnées, l'application assume un rôle IAM qui nécessite une action `glue:getCatalog` IAM. 

L’accès au catalogue de données et à ses objets peut être géré à l’aide des autorisations IAM, Lake Formation ou du mode hybride Lake Formation.

Les catalogues fédérés dans le catalogue de données contiennent des emplacements de données enregistrés pour Lake Formation. Lake Formation utilise le catalogue de données pour fournir des autorisations de type base de données afin de gérer l’accès des utilisateurs aux objets du catalogue de données. 

Vous pouvez utiliser les autorisations du mode hybride IAM ou Lake Formation pour gérer l'accès au catalogue de données par défaut et à ses objets. AWS Lake Formation

Pour créer, insérer ou supprimer des données dans les objets gérés Lake Formation, vous devez configurer des autorisations spécifiques pour l’utilisateur ou le rôle IAM. 
+ CREATE\_CATALOG : nécessaire pour créer des catalogues 
+ CREATE\_DATABASE : nécessaire pour créer des bases de données
+ CREATE\_TABLE : nécessaire pour créer des tables
+ DELETE : nécessaire pour supprimer des données d’une table
+ DESCRIBE : nécessaire pour lire les métadonnées 
+ DROP — Obligatoire pour drop/delete une table ou une base de données
+ INSERT : nécessaire lorsque le principal doit insérer des données dans une table
+ SELECT : nécessaire lorsque le principal doit sélectionner des données d’une table

Pour plus d'informations, consultez la [référence sur les autorisations de Lake Formation](https://docs.aws.amazon.com/lake-formation/latest/dg/lf-permissions-reference.html) dans le Guide du AWS Lake Formation développeur.

## LoadNamespaceMetadata
<a name="load-ns-metadata"></a>


**Informations générales**  

|  |  | 
| --- |--- |
| Nom de l'opération | LoadNamespaceMetadata | 
| Type | API de catalogue REST Iceberg | 
| Chemin REST | GET/iceberg/v1/catalogs/{catalog} /namespaces/ {ns} | 
| Action IAM | colle : GetDatabase | 
| Autorisations Lake Formation | ALL, DESCRIBE, SELECT | 
| CloudTrail event | colle : GetDatabase | 
| Définition Open API | https://github.com/apache/iceberg/blob/apache-iceberg-1.6.1/open-api/rest-catalog-open-api.yaml\#L302 | 

****Considérations et restrictions****
+ Le paramètre du chemin d’accès au catalogue doit suivre le style décrit dans la section [Paramètres du chemin d’accès au préfixe et au catalogue](connect-glu-iceberg-rest.md#prefix-catalog-path-parameters).
+ Vous ne pouvez spécifier qu’un espace de noms à un seul niveau dans le paramètre de chemin d’accès REST. Pour plus d’informations, consultez la section [Paramètre de chemin d’accès à l’espace de noms](connect-glu-iceberg-rest.md#ns-path-param).

## UpdateNamespaceProperties
<a name="w2aac20c31c16c21c13"></a>


**Informations générales**  

|  |  | 
| --- |--- |
| Nom de l'opération | UpdateNamespaceProperties | 
| Type | API de catalogue REST Iceberg | 
| Chemin REST | POST/iceberg/v1/catalogs/ {catalog} /namespaces/ {ns} /properties | 
| Action IAM | colle : UpdateDatabase | 
| Autorisations Lake Formation | ALL, ALTER | 
| CloudTrail event | colle : UpdateDatabase | 
| Définition Open API | https://github.com/apache/iceberg/blob/apache-iceberg-1.6.1/open-api/rest-catalog-open-api.yaml\#L400 | 

****Considérations et restrictions****
+ Le paramètre du chemin d’accès au catalogue doit suivre le style décrit dans la section [Paramètres du chemin d’accès au préfixe et au catalogue](connect-glu-iceberg-rest.md#prefix-catalog-path-parameters).
+ Vous ne pouvez spécifier qu’un espace de noms à un seul niveau dans le paramètre de chemin d’accès REST. Pour plus d’informations, consultez la section [Paramètre de chemin d’accès à l’espace de noms](connect-glu-iceberg-rest.md#ns-path-param).