All Products
Search
Document Center

Data Lake Formation:ListShareReceivers

Last Updated:Sep 22, 2025

Lists the receivers of a share.

Try it now

Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

Test

RAM authorization

No authorization for this operation. If you encounter issues with this operation, contact technical support.

Request syntax

GET /dlf/v1/share/shares/{share}/receivers HTTP/1.1

Request parameters

Parameter

Type

Required

Description

Example

share

string

No

The share name.

share_name

pageToken

string

No

The token to retrieve the next page of results. If the response does not include this token, pass an empty string ("").

""

maxResults

integer

No

The maximum number of records to return.

1000

Response elements

Element

Type

Description

Example

object

The list of share receivers.

receivers

array

The list of receivers.

Receiver

A receiver.

nextPageToken

string

The token to retrieve the next page of results. If this parameter is null, it indicates that this is the last page of results.

“”

Examples

Success response

JSON format

{
  "receivers": [
    {
      "receiverName": "",
      "receiverTenantId": 0,
      "comment": "",
      "createdBy": "",
      "createdAt": 0,
      "updatedBy": "",
      "updatedAt": 0
    }
  ],
  "nextPageToken": "“”"
}

Error codes

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.