# AWS Glue Apache Iceberg 用の 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 メタデータにアクセスする場合、アプリケーションは `glue:getCatalog` IAM アクションを必要とする IAM ロールを引き受けます。 データカタログとそのオブジェクトへのアクセスは、IAM、Lake Formation、または Lake Formation ハイブリッドモードのアクセス許可を使用して管理できます。 データカタログのフェデレーティッドカタログには、Lake Formation に登録されたデータロケーションがあります。Lake Formation は Data Catalog と連動して、データカタログに対するユーザーアクセスを管理するためのデータベーススタイルのアクセス許可を提供します。 IAM、AWS Lake Formation、Lake Formation のいずれかのハイブリッドモードのアクセス許可を使用することで、デフォルトのカタログデータとそのオブジェクトへのアクセスを管理できます。 Lake Formation のマネージド型オブジェクトでデータを作成、挿入、または削除するには、IAM ユーザーまたはロールに特定のアクセス許可を設定する必要があります。 + CREATE\_CATALOG – カタログの作成に必要 + CREATE\_DATABASE – データベースの作成に必要 + CREATE\_TABLE – テーブルの作成に必要 + DELETE – テーブルからのデータの削除に必要 + DESCRIBE – メタデータの読み取りに必要 + DROP – テーブルまたはデータベースのドロップ/削除に必要 + INSERT – プリンシパルがデータをテーブルに挿入する必要がある場合に必要 + SELECT – プリンシパルがテーブルからデータを選択する必要がある場合に必要 詳細については、「AWS Lake Formation デベロッパーガイド」の「[Lake Formation permissions reference](https://docs.aws.amazon.com/lake-formation/latest/dg/lf-permissions-reference.html)」を参照してください。 ## LoadNamespaceMetadata **一般的な情報** | | | | --- |--- | | オペレーション名 | LoadNamespaceMetadata | | タイプ | Iceberg REST Catalog API | | REST パス | GET/iceberg/v1/catalogs/{catalog}/namespaces/{ns} | | IAM アクション | glue:GetDatabase | | Lake Formation 許可 | ALL, DESCRIBE, SELECT | | CloudTrail のイベント | glue:GetDatabase | | Open 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 Path パラメータでは、単一レベルの名前空間のみを指定できます。詳細については「[名前空間パスパラメータ](connect-glu-iceberg-rest.md#ns-path-param)」セクションを参照してください。 ## UpdateNamespaceProperties **一般的な情報** | | | | --- |--- | | オペレーション名 | UpdateNamespaceProperties | | タイプ | Iceberg REST Catalog API | | REST パス | POST /iceberg/v1/catalogs/{catalog}/namespaces/{ns}/properties | | IAM アクション | glue:UpdateDatabase | | Lake Formation 許可 | ALL, ALTER | | CloudTrail のイベント | glue:UpdateDatabase | | Open 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 Path パラメータでは、単一レベルの名前空間のみを指定できます。詳細については「[名前空間パスパラメータ](connect-glu-iceberg-rest.md#ns-path-param)」セクションを参照してください。