文档首页/ 数字内容生产线 MetaStudio/ API参考/ 资产管理/ 数字资产管理/ 转移资产给其他用户 - TransferAsset
更新时间：2025-11-21 GMT+08:00
在线调试
CLI示例
查看PDF
分享

转移资产给其他用户 - TransferAsset

功能介绍

转移资产给其他用户

调用方法

请参见如何调用API。

授权信息

账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限，具体权限要求请参见权限和授权项。

URI

POST /v1/{project_id}/digital-assets-action/transfers

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

项目ID，获取方法请参考获取项目ID。

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

否

String

用户Token。使用Token鉴权方式时必选。

通过调用IAM服务获取用户Token接口获取。

响应消息头中X-Subject-Token的值。

Authorization

否

String

使用AK/SK方式认证时必选，携带的鉴权信息。

X-Sdk-Date

否

String

使用AK/SK方式认证时必选，请求的发生时间。

格式为(YYYYMMDD'T'HHMMSS'Z')。

X-App-UserId

否

String

第三方用户ID。不允许输入中文。
表3 请求Body参数

参数

是否必选

参数类型

描述

transfer_type

否

String

参数解释：

转移类型。默认值是TRANSFER_OUT。

约束限制：

  • 只有管理员或者开了资产转移白名单租户才有权限转出资产。

  • 普通租户有权限转回已接收成功的资产，转回给转移发起方。

  • TRANSFER_OUT: 资产转出

  • TRANSFER_BACK：资产转回

取值范围：

asset_ids

是

Array of strings

资产ID列表

dest_project_id

是

String

目标用户ID

memo

否

String

备注信息

auto_accept

否

Boolean

是否自动接收,管理员可用

默认取值：

false

auto_active

否

Boolean

是否自动激活,管理员可用

默认取值：

false

is_need_billing

否

Boolean

资产转移时，是否需要从接收方扣减资源（产生计费话单）

默认取值：

false

transfer_job_id

否

String

转移任务ID，仅在transfer_type=TRANSFER_BACK时需要填写。

响应参数

状态码：200

表4 响应Header参数

参数

参数类型

描述

X-Request-Id

String

请求ID。
表5 响应Body参数

参数

参数类型

描述

job_id

String

资产转移任务ID

状态码：400

表6 响应Body参数

参数

参数类型

描述

error_code

String

错误码。

error_msg

String

错误描述。

请求示例

POST https://{endpoint}/v1/6a6a1f8354f64dd9b9a614def7b59d83/digital-assets/transfers

{
  "asset_ids" : [ "7a6a1f8354f64dd9b9a614def7b59d86", "8a6a1f8354f64dd9b9a614def7b59d80" ],
  "dest_project_id" : "6a6a1f8354f64dd9b9a614def7b59d83",
  "memo" : "专业服务xxxx，提供资产"
}

响应示例

状态码：200

成功。

{
  "job_id" : "6a6a1f8354f64dd9b9a614def7b59d83"
}

状态码：400

请求传参异常，包含错误码及对应描述。

{
  "error_code" : "MSS.00000003",
  "error_msg" : "Invalid parameter"
}

状态码

状态码

描述

200

成功。

400

请求传参异常，包含错误码及对应描述。

错误码

请参见错误码。

父主题： 数字资产管理