GetSkillImportFileUrl - 获取 Skill 导入地址-智能体构建和治理平台 AgentCore-阿里云帮助中心

接口说明

请求说明

获取导入 Skill ZIP 包所需的 OSS 预签名上传地址和对象名称。上传完成后，可调用 Skill OSS 上传接口完成导入。

调试

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

调试

授权信息

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

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

操作

访问级别

资源类型

条件关键字

关联操作

agentcore:GetSkillImportFileUrl

none

*Skill

acs:agentcore:{#regionId}:{#accountId}:workspace/{#workspaceId}/skill

无

请求语法

GET /workspaces/{workspaceId}/skill-actions/get-import-file-url HTTP/1.1

路径参数

名称	类型	必填	描述	示例值
workspaceId	string	是	工作空间 ID	550e8400-e29b-41d4-a716-446655440000

请求参数

名称	类型	必填	描述	示例值
contentType	string	否	上传文件 Content-Type，默认 application/zip	application/zip

调用“获取 Skill 导入地址”接口时，请按参数定义传入：工作空间 ID、上传文件 Content-Type，默认 application/zip。

返回参数

名称	类型	描述	示例值
	object	RestResult
requestId	string	请求 ID。	A1B2C3D4-E5F6-47A8-90AB-CDEF12345678
data	object	返回数据。
uploadUrl	string	OSS 预签名上传地址。	https://example.com/artifacts/example.zip
ossObjectName	string	OSS 对象名称。	imports/example.zip
contentType	string	上传文件的 Content-Type。	application/zip
maxSize	string	允许上传的最大文件大小，单位为字节。	10485760

“获取 Skill 导入地址”接口的响应包含：请求 ID、返回数据。

示例

正常返回示例

JSON格式

{
  "requestId": "A1B2C3D4-E5F6-47A8-90AB-CDEF12345678",
  "data": {
    "uploadUrl": "https://example.com/artifacts/example.zip",
    "ossObjectName": "imports/example.zip",
    "contentType": "application/zip",
    "maxSize": "10485760"
  }
}

错误码

HTTP status code	错误码	错误信息	描述
400	IllegalRequest	Illegal request: %s.	非法请求
400	InvalidParameter	Parameter error: %s.	参数错误
400	InvalidParameter.ImportFileSize	The import file size exceeds the allowed limit: %s.	导入文件大小超过限制
500	InternalError	An internal error occurred. Please try again later.	内部异常，请稍后重试；如持续失败，请提供 RequestId 排查
403	NoPermission	You are not authorized to perform this operation: %s.	无操作权限
404	NotFound	Not found: %s.	指定的工作空间、资源或版本不存在
409	ResourceAlreadyExist	Resource already exists: %s.	指定的资源已存在

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

变更历史

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