Console
    Start free

    MCP Tools Reference: dataplex.googleapis.com

    Tool: list_data_products

    List Data Products in a particular project.

    The following sample demonstrate how to use curl to invoke the list_data_products MCP tool.

    Curl Request 
      
curl  
--location  
 'https://dataplex.googleapis.com/mcp' 
  
 \ 
--header  
 'content-type: application/json' 
  
 \ 
--header  
 'accept: application/json, text/event-stream' 
  
 \ 
--data  
 '{ 
 "method": "tools/call", 
 "params": { 
 "name": "list_data_products", 
 "arguments": { 
 // provide these details according to the tool' 
s  
MCP  
specification  
 } 
  
 } 
,  
 "jsonrpc" 
:  
 "2.0" 
,  
 "id" 
:  
 1 
 } 
 '

    Input Schema

    Request message for DataProductService.ListDataProducts method.

    ListDataProductsRequest

    JSON representation 
     { 
 "parent" 
 : 
 string 
 , 
 "pageSize" 
 : 
 integer 
 , 
 "filter" 
 : 
 string 
 }
    Fields
    parent

    string

    Required. The project to which the request should be attributed in the following form: projects/{project}/locations/{location} .
    pageSize

    integer

    Optional. The maximum number of data products to return. The service may return fewer than this value. If unspecified, at most 50 data products will be returned. The maximum value is 1000; values above 1000 will be coerced to 1000.
    filter

    string

    Optional. The filter expression used to filter the list of data products.

    Output Schema

    Response message for DataProductService.ListDataProducts method.

    ListDataProductsResponse

    JSON representation 
     { 
 "dataProducts" 
 : 
 [ 
 { 
 object (  DataProduct 
 
) 
 } 
 ] 
 }
    Fields
    dataProducts[]

    object ( DataProduct )

    The list of data products that match the list request.

    DataProduct

    JSON representation 
     { 
 "name" 
 : 
 string 
 , 
 "uid" 
 : 
 string 
 , 
 "displayName" 
 : 
 string 
 , 
 "createTime" 
 : 
 string 
 , 
 "updateTime" 
 : 
 string 
 , 
 "etag" 
 : 
 string 
 , 
 "labels" 
 : 
 { 
 string 
 : 
 string 
 , 
 ... 
 } 
 , 
 "description" 
 : 
 string 
 , 
 "icon" 
 : 
 string 
 , 
 "ownerEmails" 
 : 
 [ 
 string 
 ] 
 , 
 "assetCount" 
 : 
 integer 
 , 
 "accessGroups" 
 : 
 { 
 string 
 : 
 { 
 object (  AccessGroup 
 
) 
 } 
 , 
 ... 
 } 
 }
    Fields
    name

    string

    Identifier. Resource name of the data product. Format: projects/{project_id_or_number}/locations/{location_id}/dataProducts/{data_product_id} .
    uid

    string

    Output only. System generated unique ID for the data product. This ID will be different if the data product is deleted and re-created with the same name.
    displayName

    string

    Required. User-friendly display name of the data product.
    createTime

    string ( Timestamp format)

    Output only. The time at which the data product was created.

    Uses RFC 3339, where generated output will always be Z-normalized and use 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" or "2014-10-02T15:01:23+05:30" .
    updateTime

    string ( Timestamp format)

    Output only. The time at which the data product was last updated.

    Uses RFC 3339, where generated output will always be Z-normalized and use 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" or "2014-10-02T15:01:23+05:30" .
    etag

    string

    Optional. This checksum is computed by the server based on the value of other fields, and may be sent on update and delete requests to ensure the client has an up-to-date value before proceeding.
    labels

    map (key: string, value: string)

    Optional. User-defined labels for the data product.

    Example:

    { "environment": "production", "billing": "marketing-department" }

    An object containing a list of "key": value pairs. Example: { "name": "wrench", "mass": "1.3kg", "count": "3" } .
    description

    string

    Optional. Description of the data product.
    icon

    string ( bytes format)

    Optional. Base64 encoded image representing the data product. Max Size: 3.0MiB Expected image dimensions are 512x512 pixels, however the API only performs validation on size of the encoded data. Note: For byte fields, the content of the fields are base64-encoded (which increases the size of the data by 33-36%) when using JSON on the wire.

    A base64-encoded string.
    ownerEmails[]

    string

    Required. Emails of the data product owners.
    assetCount

    integer

    Output only. Number of data assets associated with this data product.
    accessGroups

    map (key: string, value: object ( AccessGroup ))

    Optional. Data product access groups by access group id as key. If data product is used only for packaging data assets, then access groups may be empty. However, if a data product is used for sharing data assets, then at least one access group must be specified.

    Example:

    { "analyst": { "id": "analyst", "displayName": "Analyst", "description": "Access group for analysts", "principal": { "googleGroup": "analysts@example.com" } } }

    An object containing a list of "key": value pairs. Example: { "name": "wrench", "mass": "1.3kg", "count": "3" } .

    Timestamp

    JSON representation 
     { 
 "seconds" 
 : 
 string 
 , 
 "nanos" 
 : 
 integer 
 }
    Fields
    seconds

    string ( int64 format)

    Represents seconds of UTC time since Unix epoch 1970-01-01T00:00:00Z. Must be between -62135596800 and 253402300799 inclusive (which corresponds to 0001-01-01T00:00:00Z to 9999-12-31T23:59:59Z).
    nanos

    integer

    Non-negative fractions of a second at nanosecond resolution. This field is the nanosecond portion of the duration, not an alternative to seconds. Negative second values with fractions must still have non-negative nanos values that count forward in time. Must be between 0 and 999,999,999 inclusive.

    LabelsEntry

    JSON representation 
     { 
 "key" 
 : 
 string 
 , 
 "value" 
 : 
 string 
 }
    Fields
    key

    string

    value

    string

    AccessGroupsEntry

    JSON representation 
     { 
 "key" 
 : 
 string 
 , 
 "value" 
 : 
 { 
 object (  AccessGroup 
 
) 
 } 
 }
    Fields
    key

    string

    value

    object ( AccessGroup )

    AccessGroup

    JSON representation 
     { 
 "id" 
 : 
 string 
 , 
 "displayName" 
 : 
 string 
 , 
 "description" 
 : 
 string 
 , 
 "principal" 
 : 
 { 
 object (  Principal 
 
) 
 } 
 }
    Fields
    id

    string

    Required. Unique identifier of the access group within the data product. User defined. Eg. "analyst", "developer", etc.
    displayName

    string

    Required. User friendly display name of the access group. Eg. "Analyst", "Developer", etc.
    description

    string

    Optional. Description of the access group.
    principal

    object ( Principal )

    Required. The principal entity associated with this access group.

    Principal

    JSON representation 
     { 
 // Union field type 
can be only one of the following: 
 "googleGroup" 
 : 
 string 
 // End of list of possible types for union field type 
. 
 }
    Fields
    Union field type . The type of the principal entity. type can be only one of the following:
    googleGroup

    string

    Optional. Email of the Google Group, as per https://cloud.google.com/iam/docs/principals-overview#google-group .

    Tool Annotations

    Destructive Hint: ❌ | Idempotent Hint: ❌ | Read Only Hint: ✅ | Open World Hint: ❌
    Create a Mobile Website
    View Site in Mobile | Classic
    Share by: