POST /credentials – Delta Incubator Delta Sharing API

CredentialsService

post/credentials

Request body

namestring required

The credential name. The name must be unique among storage and service credentials within the metastore.

purposeinteger required

The credential purpose.

commentstring

Comment associated with the credential.

readOnlyboolean

Whether the credential is usable only for read operations. Only applicable when purpose is STORAGE.

skipValidationboolean

Supplying true to this argument skips validation of the created set of credentials.

Response

idstring

The unique identifier of the credential.

namestring

The credential name.

The name must be unique among storage and service credentials within the metastore.

purposeinteger

Indicates the purpose of the credential.

readOnlyboolean

Whether the credential is usable only for read operations.

Only applicable when purpose is STORAGE.

commentstring

User-provided free-form text description.

ownerstring

Username of current owner of credential.

createdAtstring

Time at which this credential was created, in epoch milliseconds.

createdBystring

Username of credential creator.

updatedAtstring

Time at which this credential was last updated, in epoch milliseconds.

updatedBystring

Username of user who last modified credential.

usedForManagedStorageboolean

Whether this credential is the current metastore's root storage credential.

Only applicable when purpose is STORAGE.

fullNamestring

The full name of the credential.

Changes

Changed in 5 of the 9 revisions of this API.5630

Mar 3, 2025411e17bba4902See the full diff
- ○
  added the new optional request property
  new-optional-request-property
- ○
  added the optional property to the response with the status
  response-optional-property-added
Feb 27, 202560220bae69ec3422See the full diff
- ▲
  added the new required request property
  new-required-request-property
- ▲
  added the new required request property
  new-required-request-property
- ▲
  the response property became optional for the status
  response-property-became-optional
- ●
  removed the request property
  request-property-removed
- ●
  removed the optional property from the response with the status
  response-optional-property-removed
- ●
  removed the optional property from the response with the status
  response-optional-property-removed
- ●
  removed the optional property from the response with the status
  response-optional-property-removed
- ○
  api tag CredentialsService added
  api-tag-added
- ○
  api tag CredentialService removed
  api-tag-removed
- ○
  api tag credentials removed
  api-tag-removed
- ○
  api tag unofficial removed
  api-tag-removed
- ○
  added the new optional request property
  new-optional-request-property
- ○
  added the new optional request property
  new-optional-request-property
- ○
  added the new optional request property
  new-optional-request-property
- ○
  added the new optional request property
  new-optional-request-property
- ○
  added the new optional request property
  new-optional-request-property
- ○
  added the optional property to the response with the status
  response-optional-property-added
- ○
  added the optional property to the response with the status
  response-optional-property-added
- ○
  added the optional property to the response with the status
  response-optional-property-added
- ○
  added the optional property to the response with the status
  response-optional-property-added
- ○
  added the optional property to the response with the status
  response-optional-property-added
- ○
  added the optional property to the response with the status
  response-optional-property-added
- ○
  added the optional property to the response with the status
  response-optional-property-added
- ○
  added the optional property to the response with the status
  response-optional-property-added
- ○
  added the optional property to the response with the status
  response-optional-property-added
- ○
  the response optional property became not read-only for the status
  response-optional-property-became-not-read-only
- ○
  the response optional property became not read-only for the status
  response-optional-property-became-not-read-only
- ○
  the response optional property became not read-only for the status
  response-optional-property-became-not-read-only
- ○
  the response optional property became not read-only for the status
  response-optional-property-became-not-read-only
This revision also has 9 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Feb 22, 202545486f7d0cd5125See the full diff
- ▲
  added the new required request property
  new-required-request-property
- ●
  removed the request property
  request-property-removed
- ●
  removed the request property
  request-property-removed
- ○
  added the optional property to the response with the status
  response-optional-property-added
- ○
  added the optional property to the response with the status
  response-optional-property-added
- ○
  added the optional property to the response with the status
  response-optional-property-added
- ○
  added the optional property to the response with the status
  response-optional-property-added
- ○
  added the optional property to the response with the status
  response-optional-property-added
Feb 20, 202527d7bed71eaa1See the full diff
- ○
  endpoint added
  endpoint-added
This revision also has 16 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Feb 16, 2025af378e92b27b1See the full diff
- ▲
  api path removed without deprecation
  api-path-removed-without-deprecation
This revision also has 38 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

Full history