调用 GetDataAgentThemeUploadSignature 接口获取 DataAgent 主题文件上传所需的 OSS 直传凭证。获取凭证后，请通过 PostObject 方式将主题文件直传至 OSS，上传完成后携带返回的 ThemeId 调用 CreateDataAgentTheme 接口完成主题创建。 您可以参考 https://help.aliyun.com/zh/oss/user-guide/client-direct-transmission/ 文档完成主题上传。
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
|
操作 |
访问级别 |
资源类型 |
条件关键字 |
关联操作 |
|
dms:GetDataAgentThemeUploadSignature |
get |
*全部资源
|
无 | 无 |
请求语法
POST HTTP/1.1请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| ThemeId |
string |
否 |
主题 UUID，默认无需传入，后台会自动生成 UUID 返回。仅当签名过期时，可以传入该参数重新生成签名。 |
0f8b2c1d-****-****-****-9a3e5f7b1c2d |
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
Schema of Response |
||
| Data |
object |
返回结构体 |
|
| ExpireTime |
string |
policy 过期时间（ISO 8601 UTC） |
2026-01-01T14:53:41Z |
| ObjectKey |
string |
目标 object key（policy 精确锁定） |
dart/174****/0f8b****/theme.zip |
| OssCredential |
string |
指明派生密钥的参数集 |
STS.NXzWrLJ6fp**********/20260101/cn-hangzhou/oss/aliyun_v4_request |
| OssDate |
string |
签名时间（yyyyMMdd'T'HHmmss'Z'） |
20260101T135341Z |
| OssSecurityToken |
string |
上传到 OSS 使用的 STS token，1 小时有效 |
CAIS4gJ1q6Ft5B2yfSjIr5vPHMj4p+lHx/utUUjg13ptZ+5u3oDzkzz2IHhMdXlrCOgYt/8xnG1V6f8flrJ/ToQAX0HfatZq5ZkS9AqnaoXM/te496IFg5D9y7dIs8GgjqHoeOzcYI73WJXEMiLp9EJaxb/9ak/RPTiMOoGIjphKd8keWhLCAxNNGNZRIHkJyqZYTwyzU8ygKRn3mGHdIVN1sw5n8wNF5L+439eX52i17jS46JdM/9ysesH5NpQxbMwkDYnk5oEsKPqdihw3wgNR6aJ7gJZD/Tr6pdyHCzFTmU7ea7uEqYw3clYiOPBnRvEd8eKPnPl5q/HVm2Hs0wxKNuxOSCXZS4yp3MLeH+ekJgOGwWFHz9qnOLmtQXqV22tMCRpzXIj6Zlmz+/reI6iNW+Ory74mxSFbrz3ZP4yv+o+Yv3QbMVumcySkKVbBbVvnv0R8GNsIC2lMUbp+rfShhfFuG2QagAECCyigwAlSAryrFmteD+EVuvxvi0NE7zDJLbUkhek6dcY+/u5V5jcmvL67cQ7bTNk+9lV8WDCvtoCD9ucqTaHweJEd8fS2DaFedAMDf8BfZa2C1CTLhVXdSgE2WORYbMqidelRm7dH3fTbZVvryWKDaveDRLt5J/Qfs********** |
| OssSignature |
string |
V4 签名值 |
9bebe0900716bdefaab899781c7bdfd614ec6ed711e0de5ddf6f5a********** |
| OssSignatureVersion |
string |
签名版本，固定 OSS4-HMAC-SHA256 |
OSS4-HMAC-SHA256 |
| Policy |
string |
policy JSON 的 base64 值 |
eyJjb25kaXRpb25zIjpbeyJ4LW9zcy1jcmVkZW50aWFsIjoiU1RTLk5YeldyTEo2ZnA5RlNuUTN6OGthQjFFWH********** |
| ThemeId |
string |
本次生成/复用的主题业务标识，上传完成后 CreateDataAgentTheme 携带它完成元数据注册 |
0f8b2c1d****a3e5f7b1c2d |
| UploadDir |
string |
上传目录前缀 |
dart/174****/0f8b**** |
| UploadHost |
string |
PostObject 目标地址（公网） |
https://**********.oss-cn-hangzhou.aliyuncs.com |
| ErrorCode |
string |
错误码，请求异常时返回。 |
UnknownError |
| ErrorMessage |
string |
调用失败时，返回的错误信息。 |
UnknownError |
| RequestId |
string |
请求 ID，用于定位日志，排查问题。 |
67E910F2-4B62-5B0C-ACA3-7547695C**** |
| Success |
boolean |
请求是否成功，返回值如下：
|
示例
正常返回示例
JSON格式
{
"Data": {
"ExpireTime": "2026-01-01T14:53:41Z",
"ObjectKey": "dart/174****/0f8b****/theme.zip",
"OssCredential": "STS.NXzWrLJ6fp**********/20260101/cn-hangzhou/oss/aliyun_v4_request",
"OssDate": "20260101T135341Z",
"OssSecurityToken": "CAIS4gJ1q6Ft5B2yfSjIr5vPHMj4p+lHx/utUUjg13ptZ+5u3oDzkzz2IHhMdXlrCOgYt/8xnG1V6f8flrJ/ToQAX0HfatZq5ZkS9AqnaoXM/te496IFg5D9y7dIs8GgjqHoeOzcYI73WJXEMiLp9EJaxb/9ak/RPTiMOoGIjphKd8keWhLCAxNNGNZRIHkJyqZYTwyzU8ygKRn3mGHdIVN1sw5n8wNF5L+439eX52i17jS46JdM/9ysesH5NpQxbMwkDYnk5oEsKPqdihw3wgNR6aJ7gJZD/Tr6pdyHCzFTmU7ea7uEqYw3clYiOPBnRvEd8eKPnPl5q/HVm2Hs0wxKNuxOSCXZS4yp3MLeH+ekJgOGwWFHz9qnOLmtQXqV22tMCRpzXIj6Zlmz+/reI6iNW+Ory74mxSFbrz3ZP4yv+o+Yv3QbMVumcySkKVbBbVvnv0R8GNsIC2lMUbp+rfShhfFuG2QagAECCyigwAlSAryrFmteD+EVuvxvi0NE7zDJLbUkhek6dcY+/u5V5jcmvL67cQ7bTNk+9lV8WDCvtoCD9ucqTaHweJEd8fS2DaFedAMDf8BfZa2C1CTLhVXdSgE2WORYbMqidelRm7dH3fTbZVvryWKDaveDRLt5J/Qfs**********",
"OssSignature": "9bebe0900716bdefaab899781c7bdfd614ec6ed711e0de5ddf6f5a**********",
"OssSignatureVersion": "OSS4-HMAC-SHA256",
"Policy": "eyJjb25kaXRpb25zIjpbeyJ4LW9zcy1jcmVkZW50aWFsIjoiU1RTLk5YeldyTEo2ZnA5RlNuUTN6OGthQjFFWH**********\n",
"ThemeId": "0f8b2c1d****a3e5f7b1c2d",
"UploadDir": "dart/174****/0f8b****",
"UploadHost": "https://**********.oss-cn-hangzhou.aliyuncs.com"
},
"ErrorCode": "UnknownError",
"ErrorMessage": "UnknownError",
"RequestId": "67E910F2-4B62-5B0C-ACA3-7547695C****",
"Success": true
}错误码
访问错误中心查看更多错误码。
变更历史
更多信息，参考变更详情。