更新时间:2025-09-19 GMT+08:00

重试实例任务

功能介绍

用户可以调用此接口对运行失败的实例任务进行重试。

调试

您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。

URI

POST /v5/iot/{project_id}/iotda-instances/{instance_id}/tasks/{task_id}/retry

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

参数说明:项目ID。获取方法请参见 获取项目ID

instance_id

String

参数说明:实例ID。

取值范围:长度不超过36,由小写字母[a-f]、数字、连接符(-)的组成。

task_id

String

参数说明:实例任务Id。

取值范围:长度不超过64,由小写字母[a-f]、数字、连接符(-)的组成。

请求参数

响应参数

状态码:200

表2 响应Body参数

参数

参数类型

描述

task_id

String

参数说明:实例任务Id。

取值范围:长度不超过64,由小写字母[a-f]、数字、连接符(-)的组成。

type

String

参数说明:实例任务类型。

取值范围

  • CREATE:创建实例任务

  • MODIFY:实例规格变更任务

  • DELETE:实例删除任务

  • FREEZE:实例冻结任务

  • UNFREEZE:实例解冻任务

  • UPDATE_ACCESS_CONFIG:修改实例接入信息任务

  • UPDATE_ALLOW_LISTS: 修改实例接入白名单任务

  • OPEN_SNAT:启用实例SNAT配置任务

status

String

参数说明:任务状态。

取值范围

  • PENDING:等待执行

  • RUNNING:执行中

  • SUCCESS:执行成功

  • FAILED:执行失败

status_detail

String

参数说明:任务状态描述。

create_time

String

参数说明:实例任务的创建时间。格式为:"yyyy-MM-dd'T'HH:mm:ss.SSS'Z'"

start_time

String

参数说明:实例任务的开始时间。格式为:"yyyy-MM-dd'T'HH:mm:ss.SSS'Z'"

end_time

String

参数说明:实例任务的结束时间。格式为:"yyyy-MM-dd'T'HH:mm:ss.SSS'Z'"

target_config

TargetConfig object

实例规格变更时,实例的目标规格配置。

operate_window

OperateWindow object

实例维护时间窗,用户在变更实例规格时,可以指定在该时间窗内进行变更。

progress

Integer

参数说明:任务进度"

表3 TargetConfig

参数

参数类型

描述

flavor

Flavor object

参数说明:设备接入实例的规格参数。

charge_mode

String

参数说明:实例的付费方式。

取值范围

  • prePaid:包年/包月

  • postPaid:按需计费

表4 Flavor

参数

参数类型

描述

type

String

参数说明:待创建设备接入实例的规格名称。详情请参见产品规格说明中的规格编码。

size

Integer

参数说明:待创建设备接入标准版实例的单元数量。详情请参见产品规格说明。当instance_type是standard时,该参数必填。

表5 OperateWindow

参数

参数类型

描述

start_time

String

参数说明:变更时间窗开始时间,UTC时间,格式为:"HH:mm"

end_time

String

参数说明:变更时间窗结束时间,UTC时间,格式为:"HH:mm"

请求示例

重试实例任务详情。

GET https://{endpoint}/v5/iot/{project_id}/iotda-instances/{instance_id}/tasks/{task_id}/retry

响应示例

状态码:200

OK

{
  "task_id" : "075f413d-a3bb-4243-974d-8eb9221c1234",
  "type" : "MODIFY",
  "status" : "RUNNING",
  "create_time" : "2021-08-19T01:52:49.493Z",
  "start_time" : "2021-08-19T01:52:49.492Z",
  "end_time" : "2021-08-19T01:52:49.492Z",
  "target_config" : {
    "flavor" : {
      "type" : "iotda.standard.s2",
      "size" : 2
    }
  },
  "operate_window" : {
    "start_time" : "18:00",
    "end_time" : "22:00"
  },
  "progress" : 80
}

状态码

状态码

描述

200

OK

400

Bad Request

401

Unauthorized

403

Forbidden

错误码

请参见错误码