Class RecipientsAPI


  • @Generated
    public class RecipientsAPI
    extends Object
    Databricks Recipients REST API
    • Constructor Detail

      • RecipientsAPI

        public RecipientsAPI​(ApiClient apiClient)
        Regular-use constructor
      • RecipientsAPI

        public RecipientsAPI​(RecipientsService mock)
        Constructor for mocks
    • Method Detail

      • create

        public RecipientInfo create​(CreateRecipient request)
        Create a share recipient.

        Creates a new recipient with the delta sharing authentication type in the metastore. The caller must be a metastore admin or has the **CREATE_RECIPIENT** privilege on the metastore.

      • delete

        public void delete​(String name)
      • delete

        public void delete​(DeleteRecipientRequest request)
        Delete a share recipient.

        Deletes the specified recipient from the metastore. The caller must be the owner of the recipient.

      • get

        public RecipientInfo get​(GetRecipientRequest request)
        Get a share recipient.

        Gets a share recipient from the metastore if:

        * the caller is the owner of the share recipient, or: * is a metastore admin

      • list

        public Iterable<RecipientInfo> list​(ListRecipientsRequest request)
        List share recipients.

        Gets an array of all share recipients within the current metastore where:

        * the caller is a metastore admin, or * the caller is the owner. There is no guarantee of a specific ordering of the elements in the array.

      • rotateToken

        public RecipientInfo rotateToken​(long existingTokenExpireInSeconds,
                                         String name)
      • rotateToken

        public RecipientInfo rotateToken​(RotateRecipientToken request)
        Rotate a token.

        Refreshes the specified recipient's delta sharing authentication token with the provided token info. The caller must be the owner of the recipient.

      • update

        public void update​(String name)
      • update

        public void update​(UpdateRecipient request)
        Update a share recipient.

        Updates an existing recipient in the metastore. The caller must be a metastore admin or the owner of the recipient. If the recipient name will be updated, the user must be both a metastore admin and the owner of the recipient.