All Products
Search
Document Center

DataWorks:ListSkills

Last Updated:Jun 07, 2026

Lists the Skills in your account.

Operation description

Request

This operation lists the Skills in your account. You can filter the results by criteria such as a search keyword and visibility level.

  • Q: An optional search keyword for a fuzzy match on Skill names.

  • Visibility: An optional parameter to filter Skills by their visibility level. You can specify multiple values.

  • MaxResults: An optional parameter that specifies the maximum number of results to return per page.

  • NextToken: An optional pagination token for retrieving the next page of results. Omit this parameter for the first request. For subsequent requests, pass the NextToken value from the previous response to fetch the next page.

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 parameters

Parameter

Type

Required

Description

Example

MaxResults

integer

No

The maximum number of results to return per page.

20

NextToken

string

No

The pagination token for the next page of results. Omit this for the first request. For subsequent requests, set this to the NextToken from the previous response.

5

Q

string

No

The search keyword for a fuzzy match on Skill names.

analysis

Visibility

array

No

Filters the results by visibility level. You can specify multiple values.

string

No

The visibility level.

123456

Response elements

Element

Type

Description

Example

object

The returned data.

RequestId

string

The request ID.

824F80BA-1778-5D8A-BAFF-668A4D9C4CC7

PagingInfo

object

The pagination information.

TotalCount

integer

The total number of results that match the query.

100

MaxResults

integer

The maximum number of results returned in this response.

100

NextToken

string

The token for the next page of results. This parameter is null or empty if all results have been returned.

5

Skills

array<object>

The list of Skills.

object

Name

string

The Skill name.

my-skill

Description

string

The Skill description.

数据分析技能

CreatorId

string

The creator ID.

123456

ModifierId

string

The modifier ID.

123456

Visibility

string

The visibility level.

TENANT

GmtCreateTime

string

The creation time.

1780555634000

Examples

Success response

JSON format

{
  "RequestId": "824F80BA-1778-5D8A-BAFF-668A4D9C4CC7",
  "PagingInfo": {
    "TotalCount": 100,
    "MaxResults": 100,
    "NextToken": "5",
    "Skills": [
      {
        "Name": "my-skill",
        "Description": "数据分析技能",
        "CreatorId": "123456",
        "ModifierId": "123456",
        "Visibility": "TENANT",
        "GmtCreateTime": "1780555634000"
      }
    ]
  }
}

Error codes

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.