CreateDataAgentSkillMeta - 创建注册DataAgent技能-数据管理 DMS-阿里云帮助中心

CreateDataAgentSkillMeta 创建注册DataAgent技能

调试

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

调试

授权信息

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

操作：是指具体的权限点。
访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用前面加 * 表示。
- 对于不支持资源级授权的操作，用全部资源表示。
条件关键字：是指云产品自身定义的条件关键字。
关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作

访问级别

资源类型

条件关键字

关联操作

dms:CreateDataAgentSkillMeta

create

*全部资源

*

无

请求语法

POST  HTTP/1.1

请求参数

名称	类型	必填	描述	示例值
WorkspaceId	string	否	工作空间 ID。	tmbbtfv8***********zuqko6
SkillId	string	否	技能 ID。当指定传入该参数时，表示覆盖上传技能，原技能内容将被覆盖。注意：原技能名称和新上传的技能名称需要保持一致	ski-04pomiln*************j0
SkillName	string	否	技能名称默认可不传，后台会解析 UploadLocation 对应的 zip 包获取技能名称	data-query-skill
Description	string	否	技能描述默认可不传，后台会解析 UploadLocation 对应的 zip 包获取技能描述	This is a demo skill description.
UploadLocation	string	否	技能 ZIP 文件上传完整路径格式：DescribeSkillFileUploadSignature 接口返回的 UploadDir 字段拼接上文件名示例：${UploadDir}/${Filename}	data_agent/skill_upload/174483****/20251219T**Z/n87bgtx6dk****/data-query-skill.zip

返回参数

名称	类型	描述	示例值
	object	Schema of Response
RequestId	string	Id of the request	E0D21075-CD3E-4D98-8264-FD8AD04A63B6
Success	boolean	请求是否成功，返回值如下： true：请求成功。 false：请求失败。	true
ErrorCode	string	错误码。	InvalidTid
ErrorMessage	string	系统级请求失败时返回的错误信息。	Specified parameter Tid is not valid.
Data	object	返回结构体
SkillId	string	技能 ID	ski-04pomiln*************j0
SkillName	string	技能名称	data-query-skill
Description	string	技能描述	This is a demo skill description.
SkillFrom	string	技能来源	User
SkillStatus	string	技能状态 INIT：未就绪 ACTIVE：活跃 INVALID：非法	ACTIVE
Enabled	integer	是否可用，取值为 true 或 false。	true
Region	string	地域	cn-hangzhou
AliyunUid	string	阿里云账户 ID	20372822********
AliyunParentUid	string	阿里云主账号 ID	16738266********
WorkspaceId	string	工作空间 ID	11if52e44**********edbv6
GmtCreated	string	创建时间	2025-12-11T14:04:32.000+00:00
GmtModified	string	修改时间	2025-12-11T14:04:32.000+00:00
ParseError	string	技能解析错误信息当技能状态为 INVALID 时，会返回解析错误信息	SKILL.md file not exist.
CreatorUserName	string	创建者名称	HaoY*****

示例

正常返回示例

JSON格式

{
  "RequestId": "E0D21075-CD3E-4D98-8264-FD8AD04A63B6",
  "Success": true,
  "ErrorCode": "InvalidTid",
  "ErrorMessage": "Specified parameter Tid is not valid.",
  "Data": {
    "SkillId": "ski-04pomiln*************j0",
    "SkillName": "data-query-skill",
    "Description": "This is a demo skill description.",
    "SkillFrom": "User",
    "SkillStatus": "ACTIVE",
    "Enabled": 0,
    "Region": "cn-hangzhou",
    "AliyunUid": "20372822********",
    "AliyunParentUid": "16738266********",
    "WorkspaceId": "11if52e44**********edbv6",
    "GmtCreated": "2025-12-11T14:04:32.000+00:00",
    "GmtModified": "2025-12-11T14:04:32.000+00:00",
    "ParseError": "SKILL.md file not exist.",
    "CreatorUserName": "HaoY*****\n"
  }
}

错误码

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

变更历史

更多信息，参考变更详情。