更新时间:2024-07-31 GMT+08:00
分享

步骤1:创建事务型任务

操作场景

本章节指导用户通过调用API创建事务型任务。

URI

  • URI格式:
    • v1版本:POST http://{Endpoint}/rdm_{appID}_app/services/rdm/basic/api/v1/transaction-apis/transactions?api-count=N
    • v2版本:POST http://{Endpoint}/rdm_{appID}_app/services/rdm/basic/api/v2/transaction-apis/transactions
  • 参数说明:
    表1 URI参数说明

    参数

    是否必填

    参数类型

    描述

    Endpoint

    String

    承载REST服务端点的服务器域名或IP地址。

    appID

    String

    应用ID。

    api-count

    Integer

    说明:

    仅v1版本接口需要配置此参数。

    需要执行原子接口的数量,取值范围:1-5。

    该参数会以“?api-count=N”格式拼接在URI后面,其中“N”表示需要执行原子接口的数量。

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

用户的token。

响应参数

表3 响应Body参数

参数

参数类型

描述

result

String

调用是否成功。

  • SUCCESS:成功
  • FAIL:失败

data

List of data

事务型任务数据。

errors

List

异常信息列表。

表4 data

参数

参数类型

描述

data.transactionId

Long

事务型任务ID。

data.taskNo

Integer

原子接口的执行序号,默认为0。

data.taskCount

Integer

原子接口的数量。

说明:

仅v1版本接口会返回此参数信息。

请求示例

创建一个执行原子接口数量为2的事务型任务。

  • v1版本请求示例:
    POST https://dme.cn-north-4.huaweicloud.com/rdm_fce01234567d41828cf3473b07fa7ae2_app/services/rdm/basic/api/v1/transaction-apis/transactions?api-count=2
    X-Auth-Token: ABCDEFJ....
  • v2版本请求示例:
    POST https://dme.cn-north-4.huaweicloud.com/rdm_fce01234567d41828cf3473b07fa7ae2_app/services/rdm/basic/api/v2/transaction-apis/transactions
    X-Auth-Token: ABCDEFJ....

响应示例

  • v1版本响应示例:
     {
          "result": "SUCCESS",
          "data": [
              {
                  "transactionId": 538322343718555649,
                  "taskNo": 0,
                  "taskCount": 2
              }
          ],
          "errors": []
      }
  • v2版本响应示例:
     {
          "result": "SUCCESS",
          "data": [
              {
                  "transactionId": 538322343718555650,
                  "taskNo": 0
              }
          ],
          "errors": []
      }

相关文档