DownloadAgentSpecViaOss - 下载 AgentSpec-智能体构建和治理平台 AgentCore-阿里云帮助中心

接口说明

获取指定 AgentSpec 的 OSS 预签名下载地址，用于下载 AgentSpec ZIP 包。

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

操作

访问级别

资源类型

条件关键字

关联操作

agentcore:DownloadAgentSpecViaOss

get

*AgentSpec

acs:agentcore:{#regionId}:{#accountId}:workspace/{#workspaceId}/agent-spec/{#agentSpecName}

无

GET /workspaces/{workspaceId}/agent-specs/{agentSpecName}/actions/download-via-oss HTTP/1.1

名称	类型	必填	描述	示例值
agentSpecVersion	string	否	版本号，不填则下载 latest 标签对应的版本	1.0.0

调用“下载 AgentSpec”接口时，请按参数定义传入：工作空间 ID、AgentSpec 唯一名称、版本号，不填则下载 latest 标签对应的版本。

名称	类型	描述	示例值
	object	RestResult
data	string	返回数据。	https://example.com/artifacts/example.zip
requestId	string	请求 ID。	A1B2C3D4-E5F6-47A8-90AB-CDEF12345678

“下载 AgentSpec”接口的响应包含：请求 ID、返回数据。

正常返回示例

JSON格式

{
  "data": "https://example.com/artifacts/example.zip",
  "requestId": "A1B2C3D4-E5F6-47A8-90AB-CDEF12345678"
}

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	AgentSpecNotFound	Not found: %s.
409	ResourceAlreadyExist	Resource already exists: %s.	指定的资源已存在

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

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