nastra commented on code in PR #10722: URL: https://github.com/apache/iceberg/pull/10722#discussion_r1768131177
########## open-api/rest-catalog-open-api.yaml: ########## @@ -3103,6 +3103,81 @@ components: uuid: type: string + ADLSCredentials: + type: object + allOf: + - $ref: '#/components/schemas/Credentials' + required: + - type + properties: + type: + type: string + enum: [ "adls" ] + account-name: + type: string + account-key: + type: string + sas-token: + type: string + expires-at-ms: + type: integer + format: int64 + + GCSCredentials: + type: object + allOf: + - $ref: '#/components/schemas/Credentials' + required: + - type + - token + - expires-at-ms + properties: + type: + type: string + enum: [ "gcs" ] + token: + type: string + expires-at-ms: + type: integer + format: int64 + + S3Credentials: + type: object + allOf: + - $ref: '#/components/schemas/Credentials' + required: Review Comment: @flyrain I gave this some more thought and I don't think we should be standardizing any of the storage-related configuration in the REST spec for the following reasons: * those are all Java-specific and other languages might use other property names for the respective FileIO implementation * I think the issue is rather with documentation, since most storage-related properties aren't well documented. That means we should document those on the website and maybe in the REST spec (similar to what https://github.com/apache/iceberg/pull/10576 attempted). Documenting something in the REST spec is still different than actually defining a schema + properties for that configuration. Due to that I don't think it makes sense to introduce `storage` right now in order to duplicate and provide a subset of the `config` that's already defined in `LoadTableResponse` -- This is an automated message from the Apache Git Service. To respond to the message, please log on to GitHub and use the URL above to go to the specific comment. To unsubscribe, e-mail: issues-unsubscr...@iceberg.apache.org For queries about this service, please contact Infrastructure at: us...@infra.apache.org --------------------------------------------------------------------- To unsubscribe, e-mail: issues-unsubscr...@iceberg.apache.org For additional commands, e-mail: issues-h...@iceberg.apache.org