# AWS GlueEspecificaciones de las API de REST de para Apache Iceberg
<a name="iceberg-rest-apis"></a>

Esta sección contiene especificaciones sobre el catálogo REST Iceberg de AWS Glue y las API de extensión de AWS Glue, así como consideraciones sobre el uso de estas API. 

Las solicitudes de API a los puntos de conexión de AWS Glue Data Catalog se autentican mediante AWS Signature Version 4 (SigV4). Consulte la sección de [solicitudes de API de la versión de firma 4 de AWS](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_sigv.html) para obtener más información sobre SigV4 de AWS.

Al acceder al punto de conexión del servicio AWS Glue y a los metadatos de AWS Glue, la aplicación asume un rol de IAM que requiere una acción de IAM `glue:getCatalog`. 

El acceso al Catálogo de Datos y sus objetos puede gestionarse mediante IAM, Lake Formation o permisos en modo híbrido de Lake Formation.

Los catálogos federados en el catáogo de datos tienen ubicaciones de datos registradas en Lake Formation. Lake Formation trabaja con el catálogo de datos y proporciona permisos similares a los de una base de datos para administrar el acceso de los usuarios a los objetos del catálogo de datos. 

Puede usar IAM, AWS Lake Formation o los permisos de modo híbrido de Lake Formation para administrar el acceso al catálogo de datos predeterminado y sus objetos. 

Para crear, insertar o eliminar datos en objetos administrados por Lake Formation, debes configurar permisos específicos para el usuario o rol de IAM. 
+ CREATE\_CATALOG: es necesario para crear catálogos 
+ CREATE\_DATABASE: es necesario para crear bases de datos
+ CREATE\_TABLE: es necesario para crear tablas
+ DELETE: es necesario para eliminar datos de una tabla
+ DESCRIBE: es necesario para leer los metadatos 
+ DROP: es necesario para eliminar una tabla o base de datos
+ INSERT: es necesario cuando la entidad principal debe insertar datos en una tabla
+ SELECT: es necesario cuando la entidad principal necesita seleccionar datos de una tabla

Para obtener más información, consulte [Lake Formation permissions reference](https://docs.aws.amazon.com/lake-formation/latest/dg/lf-permissions-reference.html) en la Guía para desarrolladores de AWS Lake Formation.

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


**Información general**  

|  |  | 
| --- |--- |
| Nombre de operación | LoadNamespaceMetadata | 
| Tipo | API del catálogo de REST de Iceberg | 
| Ruta de REST | GET/iceberg/v1/catalogs/{catalog}/namespaces/{ns} | 
| Acción de IAM | glue:GetDatabase | 
| Permisos de Lake Formation | ALL, DESCRIBE, SELECT | 
| Evento de CloudTrail | glue:GetDatabase | 
| Definición de API abierta | https://github.com/apache/iceberg/blob/apache-iceberg-1.6.1/open-api/rest-catalog-open-api.yaml\#L302 | 

****Consideraciones y limitaciones****
+ El parámetro de ruta del catálogo debe seguir el estilo descrito en la sección [Parámetros de prefijo y ruta de catálogo](connect-glu-iceberg-rest.md#prefix-catalog-path-parameters).
+ Solo puede especificar un espacio de nombres de un solo nivel en el parámetro de ruta de REST. Para obtener más información, consulte la sección [Parámetro de ruta de espacio de nombres](connect-glu-iceberg-rest.md#ns-path-param).

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


**Información general**  

|  |  | 
| --- |--- |
| Nombre de operación | UpdateNamespaceProperties | 
| Tipo | API del catálogo de REST de Iceberg | 
| Ruta de REST | POST /iceberg/v1/catalogs/{catalog}/namespaces/{ns}/properties | 
| Acción de IAM | glue:UpdateDatabase | 
| Permisos de Lake Formation | ALL, ALTER | 
| Evento de CloudTrail | glue:UpdateDatabase | 
| Definición de API abierta | https://github.com/apache/iceberg/blob/apache-iceberg-1.6.1/open-api/rest-catalog-open-api.yaml\#L400 | 

****Consideraciones y limitaciones****
+ El parámetro de ruta del catálogo debe seguir el estilo descrito en la sección [Parámetros de prefijo y ruta de catálogo](connect-glu-iceberg-rest.md#prefix-catalog-path-parameters).
+ Solo puede especificar un espacio de nombres de un solo nivel en el parámetro de ruta de REST. Para obtener más información, consulte la sección [Parámetro de ruta de espacio de nombres](connect-glu-iceberg-rest.md#ns-path-param).