ListSkills - 查询Skill列表

更新时间:
复制 MD 格式

查询Skill列表

接口说明

前提条件

请先确认服务商在创建服务时开启变配功能并完成变配参数设置。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

下表是API对应的授权信息,可以在RAM权限策略语句的Action元素中使用,用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下:

  • 操作:是指具体的权限点。

  • 访问级别:是指每个操作的访问级别,取值为写入(Write)、读取(Read)或列出(List)。

  • 资源类型:是指操作中支持授权的资源类型。具体说明如下:

    • 对于必选的资源类型,用前面加 * 表示。

    • 对于不支持资源级授权的操作,用全部资源表示。

  • 条件关键字:是指云产品自身定义的条件关键字。

  • 关联操作:是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限,操作才能成功。

操作

访问级别

资源类型

条件关键字

关联操作

computenest:ListSkills

list

*全部资源

*

请求语法

POST  HTTP/1.1

请求参数

名称

类型

必填

描述

示例值

Filter

array<object>

过滤器。

object

过滤器。

Value

array

过滤器值列表。N 的取值范围:1~10。

string

过滤器值

s-xxxxx

Name

string

过滤器名称,可选择一个或者多个名称进行查询。取值范围:

  • SkillId:Skill ID,精确匹配

  • SkillSpaceId: SkillSpace ID,精确匹配

  • SkillName:Skill 名称。

  • MatchType:匹配类型,控制 SkillName 的匹配类型,取值 exact(精确)/prefix(前缀)/fuzzy(模糊)

  • SkillType: Skill 类型,取值 official(官方)/ custom(自定义)

  • Keyword: 关键词匹配 Skill 名称或 Skill 描述,模糊匹配。

  • SkillLabels: Skill 标签, 模糊匹配。

SkillId

NextToken

string

NextToken

AAAAAWns8w4MmhzeptXVRG0PUEU=

MaxResults

integer

MaxResults 本次请求所返回的最大记录条数

20

NeedDownloadUrl

boolean

是否额外需要 Skill 压缩包下载链接

false

返回参数

名称

类型

描述

示例值

object

Schema of Response

RequestId

string

Id of the request

06BF8F22-02DC-4750-83DF-3FFC11C065EA

NextToken

string

下一页令牌

AAAAAWns8w4MmhzeptXVRG0PUEU=

MaxResults

integer

每页最大数量

20

TotalCount

integer

总数量

100

Skills

array<object>

Skill 列表

array<object>

技能详情对象

SkillId

string

Skill ID

s-xxxxx

SkillName

string

Skill 名称

skill-creator

SkillDisplayName

string

Skill 显示名

SkillDescription

string

Skill 描述

Create new skills, modify and improve existing skills, and measure skill performance.

Locales

array<object>

object

OriginalValue

string

ZhValue

string

EnValue

string

SkillLabels

array

Skill 标签集

string

Skill 标签

category:frontend-development

SkillSpaceId

string

所属 SkillSpace ID

ss-xxxxx

CreateTime

string

创建时间

2026-05-10T02:22:18Z

UpdateTime

string

更新时间

2025-11-03T22:58:52Z

DownloadUrl

string

Skill 压缩包下载链接

https://embedding-pic.oss-cn-beijing-internal.aliyuncs.com/skill-creator.zip

示例

正常返回示例

JSON格式

{
  "RequestId": "06BF8F22-02DC-4750-83DF-3FFC11C065EA",
  "NextToken": "AAAAAWns8w4MmhzeptXVRG0PUEU=",
  "MaxResults": 20,
  "TotalCount": 100,
  "Skills": [
    {
      "SkillId": "s-xxxxx",
      "SkillName": "skill-creator",
      "SkillDisplayName": "",
      "SkillDescription": "Create new skills, modify and improve existing skills, and measure skill performance. ",
      "Locales": [
        {
          "OriginalValue": "",
          "ZhValue": "",
          "EnValue": ""
        }
      ],
      "SkillLabels": [
        "category:frontend-development"
      ],
      "SkillSpaceId": "ss-xxxxx",
      "CreateTime": "2026-05-10T02:22:18Z",
      "UpdateTime": "2025-11-03T22:58:52Z",
      "DownloadUrl": "https://embedding-pic.oss-cn-beijing-internal.aliyuncs.com/skill-creator.zip"
    }
  ]
}

错误码

访问错误中心查看更多错误码。

变更历史

更多信息,参考变更详情