tencent cloud

数据开发治理平台 WeData

产品动态
动态发布记录(2026年)
产品简介
产品概述
产品优势
产品架构
产品功能
应用场景
购买指南
计费概述
产品版本购买说明
执行资源购买说明
购买方式
欠费说明
退费说明
准备工作
账号和权限管理概述
添加白名单/安全组(可选)
通过 Microsoft Entra ID(Azure AD)单点登录(SSO)WeData
操作指南
管理控制台
项目管理
数据集成
Studio
数据开发
数据分析
数据科学
数据治理(with Unity Semantics)
API 文档
History
Introduction
API Category
Making API Requests
Smart Ops Related Interfaces
Project Management APIs
Resource Group APIs
Data Development APIs
Data Asset - Data Dictionary APIs
Data Development APIs
Ops Center APIs
Data Operations Related Interfaces
Data Exploration APIs
Asset APIs
Metadata Related Interfaces
Task Operations APIs
Data Security APIs
Instance Operation and Maintenance Related Interfaces
Data Map and Data Dictionary APIs
Data Quality Related Interfaces
DataInLong APIs
Platform Management APIs
Data Source Management APIs
Data Quality APIs
Platform Management APIs
Asset Data APIs
Data Source Management APIs
Data Types
Error Codes
WeData API 2025-08-06
服务等级协议
相关协议
隐私协议
数据处理和安全协议
联系我们
词汇表

ModifyTaskInfo

聚焦模式
字号
最后更新时间: 2025-11-13 20:55:24

1. API Description

Domain name for API request: wedata.intl.tencentcloudapi.com.

[Note: This version is only available to a portion of allowlist customers in the Guangzhou Region]

Update Task

A maximum of 20 requests can be initiated per second for this API.

We recommend you to use API Explorer
Try it
API Explorer provides a range of capabilities, including online call, signature authentication, SDK code generation, and API quick search. It enables you to view the request, response, and auto-generated examples.

2. Input Parameters

The following request parameter list only provides API request parameters and some common parameters. For the complete common parameter list, see Common Request Parameters.

Parameter Name Required Type Description
Action Yes String Common Params. The value used for this API: ModifyTaskInfo.
Version Yes String Common Params. The value used for this API: 2021-08-20.
Region Yes String Common Params. For more information, please see the list of regions supported by the product.
ProjectId Yes String Project ID
TaskId Yes String Task ID
DelayTime No Integer Execution time, in minutes, applicable to daily/weekly/monthly/yearly scheduling. For example, with daily scheduling, executing once at 02:00 AM every day, delayTime is 120 minutes
StartupTime No Integer Start Time
SelfDepend No Integer Self-Dependency Type 1: Sequential serial, one at a time, queued, 2: Unordered serial, one at a time, not queued, 3: Parallel, multiple at once
StartTime No String Effective Start Time, format yyyy-MM-dd HH:mm:ss
EndTime No String Effective End Time, format yyyy-MM-dd HH:mm:ss
TaskAction No String Scheduling Configuration - Elastic Cycle Configuration, applicable to Hourly/Weekly/Monthly/Yearly schedules. For hourly tasks scheduled at 0, 3, 4 o'clock, it would be '0,3,4'.
CycleType No Integer "Cycle Type 0:crontab, 1:Minute,2:Hour,3:Day,4:Week,5:Month,6:One-time,7:User driven,10:Flexible cycle Week,11:Flexible cycle Month,12:Year,13:Immediate Trigger Instant type, isolated from normal cycle scheduling task logic
CycleStep No Integer Step Length, Interval Time, minimum of 1
CrontabExpression No String Cron Expression is required only for Cron Tab Scheduling
ExecutionStartTime No String Execution Time Left Closed Interval, format: HH:mm. Applicable only to hourly scheduling. For example, for hourly tasks, it specifies the effective interval every day
ExecutionEndTime No String Execution Time Right Closed Interval, format: HH:mm. Applicable only to hourly scheduling. For example, for hourly tasks, it specifies the effective interval every day
TaskName No String New Task Name
RetryWait No Integer Failure Retry Interval, in minutes, a default value has already been provided during task creation
TryLimit No Integer Number of Retry Attempts on Failure, a default value has already been provided during task creation
Retriable No Integer Whether to Retry, 1 for yes
RunPriority No Integer Running Priority, 4 for High, 5 for Medium, 6 for Low
TaskExt.N No Array of TaskExtInfo Extended Task Configuration
ResourceGroup No String Execution Resource Group ID, needs to be created on the Resource Management Service and bind to a CVM machine
YarnQueue No String Resource Pool Queue Name
BrokerIp No String Specific Execution Machine under Resource Group, 'any' means it can run on any machine.
Notes No String Task notes
TaskParamInfos.N No Array of ParamInfo Task Parameters
SourceServer No String Source Data Source
TargetServer No String Target Data Source
DependencyWorkflow No String Supports Workflow Dependencies yes/no, default no
DependencyConfigDTOs.N No Array of DependencyConfig Dependency Configuration
ExecutionTTL No Integer Execution Duration
ScriptChange No Boolean Whether the Script has Changed
InChargeIds.N No Array of String Responsible Person ID

3. Output Parameters

Parameter Name Type Description
Data Boolean Execution Result
RequestId String The unique request ID, generated by the server, will be returned for every request (if the request fails to reach the server for other reasons, the request will not obtain a RequestId). RequestId is required for locating a problem.

4. Example

Example1 Example

Modify Task Information

Input Example

POST / HTTP/1.1
Host: wedata.intl.tencentcloudapi.com
Content-Type: application/json
X-TC-Action: ModifyTaskInfo
<Common request parameters>

{
    "ProjectId": "1492511691706699776",
    "TaskId": "20240307211852581",
    "DelayTime": 600,
    "StartupTime": 0,
    "SelfDepend": 0,
    "StartTime": "2024-03-28 00:00:00",
    "EndTime": "2024-03-29 00:00:00",
    "TaskAction": "",
    "CycleType": 3,
    "CycleStep": 1,
    "ExecutionStartTime": "00:00",
    "ExecutionEndTime": "23:59",
    "TaskName": "python_task_failed",
    "RetryWait": 5,
    "TryLimit": 5,
    "Retriable": 1,
    "RunPriority": 6,
    "TaskExt": [
        {
            "Key": "python_type",
            "Value": "python3"
        }
    ],
    "ResourceGroup": "20221229172428663695",
    "BrokerIp": "ins-g8j6pv4f",
    "InCharge": "micofywang",
    "Notes": "test",
    "TaskParamInfos": [
        {
            "ParamKey": "a",
            "ParamValue": "3"
        }
    ],
    "DependencyWorkflow": "no",
    "InChargeIds": [
        "100033435965"
    ]
}

Output Example

{
    "Response": {
        "Data": true,
        "RequestId": "d7f6c6d3-d483-4485-b600-c665c9aea28b"
    }
}

Example2 Incorrect Example

Incorrect Example

Input Example

POST / HTTP/1.1
Host: wedata.intl.tencentcloudapi.com
Content-Type: application/json
X-TC-Action: ModifyTaskInfo
<Common request parameters>

{
    "ProjectId": "1",
    "TaskId": "1"
}

Output Example

{
    "Response": {
        "Error": {
            "Code": "AuthFailure.SignatureFailure",
            "Message": "request signature verification failed, please check your signature calculation is correct."
        },
        "RequestId": "11d5af39-eac3-4960-b0d5-5cced5cdc49f"
    }
}

5. Developer Resources

SDK

TencentCloud API 3.0 integrates SDKs that support various programming languages to make it easier for you to call APIs.

Command Line Interface

6. Error Code

The following only lists the error codes related to the API business logic. For other error codes, see Common Error Codes.

Error Code Description
FailedOperation Operation Failure.

帮助和支持

本页内容是否解决了您的问题?

填写满意度调查问卷,共创更好文档体验。

文档反馈