# AWS GlueAPIs REST do para especificações do Apache Iceberg
<a name="iceberg-rest-apis"></a>

Esta seção contém especificações sobre o catálogo REST do AWS Glue para Iceberg e as APIs de extensão do AWS Glue, além de considerações sobre o uso dessas APIs. 

As solicitações de API aos endpoints do AWS Glue Data Catalog são autenticadas por meio do AWS Signature Version 4 (SigV4). Consulte a seção [AWS Signature Version 4 para solicitações de API](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_sigv.html) para saber mais sobre o AWS SigV4.

Ao acessar o endpoint de serviço do AWS Glue e os metadados do AWS Glue, a aplicação assume um perfil do IAM que exige uma ação `glue:getCatalog` do IAM. 

O acesso ao Catálogo de Dados e seus objetos pode ser gerenciado usando permissões do IAM, Lake Formation ou modo híbrido do Lake Formation.

Os catálogos federados no Catálogo de Dados têm locais de dados registrados no Lake Formation. O Lake Formation trabalha com o Catálogo de Dados para fornecer permissões no estilo de banco de dados para gerenciar o acesso de usuários a objetos do Catálogo de Dados. 

É possível usar as permissões do IAM, do AWS Lake Formation ou do modo híbrido do Lake Formation para gerenciar o acesso ao Catálogo de Dados padrão e seus objetos. 

Para criar, inserir ou excluir dados em objetos gerenciados do Lake Formation, é necessário configurar permissões específicas para o usuário ou perfil do IAM. 
+ CREATE\_CATALOG: necessária para criar catálogos 
+ CREATE\_DATABASE: necessária para criar bancos de dados
+ CREATE\_TABLE: necessária para criar tabelas
+ DELETE: necessária para excluir dados de uma tabela
+ DESCRIBE: necessária para ler metadados 
+ DROP: necessária para descartar/excluir uma tabela ou banco de dados
+ INSERT: necessária quando a entidade principal precisa inserir dados em uma tabela
+ SELECT: necessária quando a entidade principal precisa selecionar dados de uma tabela

Para obter mais informações, consulte [Referência de permissões do Lake Formation](https://docs.aws.amazon.com/lake-formation/latest/dg/lf-permissions-reference.html) no Guia do desenvolvedor do AWS Lake Formation.

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


**Informações gerais**  

|  |  | 
| --- |--- |
| Nome da operação | LoadNamespaceMetadata | 
| Tipo | API do catálogo REST do Iceberg | 
| Caminho REST | GET/iceberg/v1/catalogs/{catalog}/namespaces/{ns} | 
| Ação do IAM | glue:GetDatabase | 
| Permissões do Lake Formation | ALL, DESCRIBE, SELECT | 
| Evento do CloudTrail | glue:GetDatabase | 
| Definição da Open API | https://github.com/apache/iceberg/blob/apache-iceberg-1.6.1/open-api/rest-catalog-open-api.yaml\#L302 | 

****Considerações e limitações****
+ O parâmetro do caminho do catálogo deve seguir o estilo descrito na seção [Parâmetros de prefixo e caminho do catálogo](connect-glu-iceberg-rest.md#prefix-catalog-path-parameters).
+ É possível especificar somente um namespace de nível único no parâmetro REST Path. Para obter mais informações, consulte a seção [Parâmetro do caminho do namespace](connect-glu-iceberg-rest.md#ns-path-param).

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


**Informações gerais**  

|  |  | 
| --- |--- |
| Nome da operação | UpdateNamespaceProperties | 
| Tipo | API do catálogo REST do Iceberg | 
| Caminho REST | POST /iceberg/v1/catalogs/{catalog}/namespaces/{ns}/properties | 
| Ação do IAM | glue:UpdateDatabase | 
| Permissões do Lake Formation | ALL, ALTER | 
| Evento do CloudTrail | glue:UpdateDatabase | 
| Definição da Open API | https://github.com/apache/iceberg/blob/apache-iceberg-1.6.1/open-api/rest-catalog-open-api.yaml\#L400 | 

****Considerações e limitações****
+ O parâmetro do caminho do catálogo deve seguir o estilo descrito na seção [Parâmetros de prefixo e caminho do catálogo](connect-glu-iceberg-rest.md#prefix-catalog-path-parameters).
+ É possível especificar somente um namespace de nível único no parâmetro REST Path. Para obter mais informações, consulte a seção [Parâmetro do caminho do namespace](connect-glu-iceberg-rest.md#ns-path-param).