# Apache Iceberg용 AWS Glue REST API 사양
이 섹션에는 AWS Glue Iceberg REST 카탈로그 및 AWS Glue 익스텐션 API에 대한 사양과 이러한 API를 사용할 때의 고려 사항이 포함되어 있습니다.
AWS Glue Data Catalog 엔드포인트에 대한 API 요청은 AWS Signature Version 4(SigV4)를 사용하여 인증됩니다. AWS SigV4에 대한 자세한 내용은 [API 요청용 AWS Signature Version 4](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_sigv.html) 섹션을 참조하세요.
AWS Glue 서비스 엔드포인트 및 AWS Glue 메타데이터에 액세스할 때 애플리케이션은 IAM 작업이 필요한 `glue:getCatalog` IAM 역할을 수임합니다.
Data Catalog 및 해당 객체에 대한 액세스는 IAM, Lake Formation 또는 Lake Formation 하이브리드 모드 권한을 사용하여 관리할 수 있습니다.
Data Catalog의 페더레이션 카탈로그에는 Lake Formation에 등록된 데이터 위치가 있습니다. Lake Formation은 Data Catalog와 연동하며 Data Catalog 객체에 대한 사용자 액세스를 관리할 수 있는 데이터베이스 스타일 권한을 제공합니다.
IAM, AWS Lake Formation 또는 Lake Formation 하이브리드 모드 권한을 사용하여 기본 Data Catalog 및 해당 객체에 대한 액세스를 관리할 수 있습니다.
Lake Formation 관리형 객체에서 데이터를 생성, 삽입 또는 삭제하려면 IAM 사용자 또는 역할에 대한 권한을 설정해야 합니다.
+ CREATE\_CATALOG – 카탈로그를 생성하는 데 필요합니다.
+ CREATE\_DATABASE – 데이터베이스를 생성하는 데 필요합니다.
+ CREATE\_TABLE – 테이블을 생성하는 데 필요합니다.
+ DELETE - 테이블에서 데이터를 삭제하는 데 필요합니다.
+ DESCRIBE - 메타데이터를 읽는 데 필요합니다.
+ DROP - 테이블 또는 데이터베이스를 삭제하는 데 필요합니다.
+ INSERT - 위탁자가 테이블에 데이터를 삽입해야 할 때 필요합니다.
+ SELECT - 위탁자가 테이블에서 데이터를 선택해야 할 때 필요합니다.
자세한 내용은 AWS Lake Formation 개발자 가이드에서 [Lake Formation 권한 참조](https://docs.aws.amazon.com/lake-formation/latest/dg/lf-permissions-reference.html)를 참조하세요.
## LoadNamespaceMetadata
**일반 정보**
| | |
| --- |--- |
| 작업 이름 | LoadNamespaceMetadata |
| 유형 | Iceberg REST 카탈로그 API |
| REST 경로 | GET/iceberg/v1/catalogs/{catalog}/namespaces/{ns} |
| IAM 작업 | glue:GetDatabase |
| Lake Formation 권한 | ALL, DESCRIBE, SELECT |
| CloudTrail 이벤트 | glue:GetDatabase |
| API 정의 열기 | https://github.com/apache/iceberg/blob/apache-iceberg-1.6.1/open-api/rest-catalog-open-api.yaml\#L302 |
****고려 사항 및 제한 사항****
+ 카탈로그 경로 파라미터는 [접두사 및 카탈로그 경로 파라미터](connect-glu-iceberg-rest.md#prefix-catalog-path-parameters) 섹션에 설명된 스타일을 따라야 합니다.
+ REST 경로 파라미터에는 단일 수준 네임스페이스만 지정할 수 있습니다. 자세한 내용은 [네임스페이스 경로 파라미터](connect-glu-iceberg-rest.md#ns-path-param) 섹션을 참조하세요.
## UpdateNamespaceProperties
**일반 정보**
| | |
| --- |--- |
| 작업 이름 | UpdateNamespaceProperties |
| 유형 | Iceberg REST 카탈로그 API |
| REST 경로 | POST /iceberg/v1/catalogs/{catalog}/namespaces/{ns}/properties |
| IAM 작업 | glue:UpdateDatabase |
| Lake Formation 권한 | ALL, ALTER |
| CloudTrail 이벤트 | glue:UpdateDatabase |
| API 정의 열기 | https://github.com/apache/iceberg/blob/apache-iceberg-1.6.1/open-api/rest-catalog-open-api.yaml\#L400 |
****고려 사항 및 제한 사항****
+ 카탈로그 경로 파라미터는 [접두사 및 카탈로그 경로 파라미터](connect-glu-iceberg-rest.md#prefix-catalog-path-parameters) 섹션에 설명된 스타일을 따라야 합니다.
+ REST 경로 파라미터에는 단일 수준 네임스페이스만 지정할 수 있습니다. 자세한 내용은 [네임스페이스 경로 파라미터](connect-glu-iceberg-rest.md#ns-path-param) 섹션을 참조하세요.