ListSkills-阿里云帮助中心

Retrieves a list of Skills.

Operation description

Prerequisites

Ensure that the service provider has enabled modification and configured the modification parameters when creating the service.

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

POST  HTTP/1.1

Request parameters

Parameter	Type	Required	Description	Example
Filter	array<object>	No	The filters for querying Skills.
	object	No	A filter object.
Value	array	No	The filter values. You can specify a maximum of 10 values.
	string	No	A filter value.	s-xxxx
Name	string	No	The filter name. Valid values: `SkillId`: The Skill ID. An exact match is performed. `SkillSpaceId`: The ID of the SkillSpace. An exact match is performed. `SkillName`: The Skill name. `MatchType`: The match type for `SkillName`. Valid values: `exact` (exact match), `prefix` (prefix match), and `fuzzy` (fuzzy match). `SkillType`: The Skill type. Valid values: `official` and `custom`. `Keyword`: The keyword for a fuzzy match on the Skill name or Skill description. `SkillLabels`: The Skill labels. A fuzzy match is performed.	SkillId
NextToken	string	No	The token for the next page of results. Leave this parameter empty for the first request. For subsequent requests, use the `NextToken` value from the previous response.	AAAAAWns8w4MmhzeptXVRG0PUEU=
MaxResults	integer	No	The maximum number of entries to return per page.	20
NeedDownloadUrl	boolean	No	Specifies whether to return the download URL of the Skill package.	false

Response elements

Element	Type	Description	Example
	object	The response body.
RequestId	string	The request ID.	06BF8F22-02DC-4750-83DF-3FFC11C065EA
NextToken	string	The token to retrieve the next page of results. This parameter is empty when all results have been returned.	AAAAAWns8w4MmhzeptXVRG0PUEU=
MaxResults	integer	The maximum number of entries returned per page.	20
TotalCount	integer	The total number of entries that match the query.	100
Skills	array<object>	A list of Skills.
	object	The details of a Skill.
SkillId	string	The Skill ID.	s-111111
SkillName	string	The Skill name.	reimbursement-print
SkillDescription	string	The Skill description.	1111
SkillLabels	array	The Skill labels.
	string	A Skill label.	category:frontend-development
SkillSpaceId	string	The ID of the SkillSpace to which the Skill belongs.	ss-11111
CreateTime	string	The creation time of the Skill.	2026-05-10T02:22:18Z
UpdateTime	string	The last update time of the Skill.	2025-11-03T22:58:52Z
DownloadUrl	string	The download URL of the Skill package. This parameter is returned only if `NeedDownloadUrl` is set to `true`.	https://testts-1.oss-cn-beijing.aliyuncs.com/app/yyb_9.1.1.zip

Examples

Success response

JSON format

{
  "RequestId": "06BF8F22-02DC-4750-83DF-3FFC11C065EA",
  "NextToken": "AAAAAWns8w4MmhzeptXVRG0PUEU=",
  "MaxResults": 20,
  "TotalCount": 100,
  "Skills": [
    {
      "SkillId": "s-111111",
      "SkillName": "reimbursement-print",
      "SkillDescription": "1111",
      "SkillLabels": [
        "category:frontend-development"
      ],
      "SkillSpaceId": "ss-11111",
      "CreateTime": "2026-05-10T02:22:18Z",
      "UpdateTime": "2025-11-03T22:58:52Z",
      "DownloadUrl": "https://testts-1.oss-cn-beijing.aliyuncs.com/app/yyb_9.1.1.zip"
    }
  ]
}

Error codes

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.