All Products
Search
Document Center

DataWorks:GetMetaCollection

Last Updated:Nov 04, 2025

Queries the information about a collection in Data Map. Collections include categories and data albums.

Debugging

You can run this interface directly in OpenAPI Explorer, saving you the trouble of calculating signatures. After running successfully, OpenAPI Explorer can automatically generate SDK code samples.

Authorization information

There is currently no authorization information disclosed in the API.

Request parameters

ParameterTypeRequiredDescriptionExample
IdstringYes

The collection ID.

category.123

Response parameters

ParameterTypeDescriptionExample
object

The response.

RequestIdstring

The request ID.

1AFAE64E-D1BE-432B-A9****
MetaCollectionobject

The collection details.

Idstring

The collection ID.

category.123
Typestring

The collection type. Valid values:

  • Category
  • Album
  • AlbumCategory: Album subcategory.
Category
ParentIdstring

The parent collection ID. This parameter can be empty.

category.12
Namestring

The collection name.

test_category
Descriptionstring

The collection description.

test
CreateTimelong

The creation time in milliseconds.

1668568601000
ModifyTimelong

The last modified time in milliseconds.

1668568601000
CreateUserstring

The ID of the creator.

456789
Administratorsarray

The list of administrator IDs. Valid only for the album type. The IDs must belong to users in the same tenant. Multiple IDs can be specified.

administratorslong

The ID of the administrator.

765432

Examples

Sample success responses

JSONformat

{
  "RequestId": "1AFAE64E-D1BE-432B-A9****",
  "MetaCollection": {
    "Id": "category.123",
    "Type": "Category",
    "ParentId": "category.12\n\n",
    "Name": "test_category",
    "Description": "test",
    "CreateTime": 1668568601000,
    "ModifyTime": 1668568601000,
    "CreateUser": 456789,
    "Administrators": [
      765432
    ]
  }
}

Error codes

For a list of error codes, visit the Service error codes.