You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@polaris.apache.org by yz...@apache.org on 2026/03/23 22:59:43 UTC

(polaris) 01/01: add delegate header

This is an automated email from the ASF dual-hosted git repository.

yzou pushed a commit to branch yzou-generic-table-data-access-header
in repository https://gitbox.apache.org/repos/asf/polaris.git

commit 3290d8eba04622528590b99225b06d778a6039f5
Author: Yun Zou <yu...@gmail.com>
AuthorDate: Mon Mar 23 15:59:30 2026 -0700

    add delegate header
---
 spec/polaris-catalog-apis/generic-tables-api.yaml | 24 +++++++++++++++++++++++
 1 file changed, 24 insertions(+)

diff --git a/spec/polaris-catalog-apis/generic-tables-api.yaml b/spec/polaris-catalog-apis/generic-tables-api.yaml
index 5946e7748b..cb42161962 100644
--- a/spec/polaris-catalog-apis/generic-tables-api.yaml
+++ b/spec/polaris-catalog-apis/generic-tables-api.yaml
@@ -63,6 +63,8 @@ paths:
       description:
         Create a generic table under the given namespace, and return the created table information as a response.
       operationId: createGenericTable
+      parameters:
+        - $ref: '#/components/parameters/generic-table-data-access'
       requestBody:
         required: true
         content:
@@ -117,6 +119,8 @@ paths:
       
         The response contains all table information passed during create.
 
+      parameters:
+        - $ref: '#/components/parameters/generic-table-data-access'
       responses:
         200:
           $ref: '#/components/responses/LoadGenericTableResponse'
@@ -182,6 +186,26 @@ components:
         type: string
       example: "sales"
 
+    generic-table-data-access:
+      name: X-Generic-Table-Access-Delegation
+      in: header
+      description: >
+        Optional signal to the server that the client supports delegated access
+        via a comma-separated list of access mechanisms. The server may choose
+        to supply access via any or none of the requested mechanisms.
+
+
+        When `vended-credentials` is included, the server may return scoped
+        storage credentials in the `storage-access-configs` field of the response.
+      required: false
+      schema:
+        type: string
+        enum:
+          - vended-credentials
+      style: simple
+      explode: false
+      example: "vended-credentials"
+
   schemas:
     CreateGenericTableRequest:
       type: object