更新任务

调试 #

请求参数 #

下表仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数。

返回参数 #

本接口无特有的返回参数。更多信息请见返回结构。

请求示例 #

POST https://open.volcengineapi.com
{
    "Name": "test_name",
    "TaskId": "t-uuid",
    "CrossVpc": {
        "VpcId": "vpc-xxxxxx",
        "SubnetIds": [
            {
                "Key": "name1",
                "Value": "value1"
            }
        ],
        "SecurityGroupId": "sg-xxxxxx"
    },
    "DaftTask": {
        "Envs": [
            {
                "Key": "ray.xxx",
                "Value": "a"
            }
        ],
        "Yaml": "Entrypoint 或 Yaml 必须选一种",
        "Image": "python:3.9",
        "Configs": [
            {
                "Key": "ray.xxx",
                "Value": "a"
            }
        ],
        "RunEnvs": [
            {
                "Key": "ray.xxx",
                "Value": "b"
            }
        ],
        "ImageType": "BuiltIn",
        "Entrypoint": "python /opt/main.py",
        "ImageCredential": {
            "Password": "123456",
            "UserName": "admin"
        }
    },
    "TaskType": "Daft",
    "TosMount": {
        "AccessKey": "AKxxxxxx",
        "SecretKey": "xxxxxx==",
        "TosMountPaths": [
            {
                "Source": "tos://test-bucket/test",
                "MountPath": "/mnt/test"
            }
        ]
    },
    "SparkTask": {
        "Args": [
            "--flag1",
            "value1"
        ],
        "Envs": [
            {
                "name": "spark.xxx",
                "value": "a"
            }
        ],
        "Image": "python:3.9",
        "Configs": [
            {
                "Key": "name1",
                "Value": "value1"
            }
        ],
        "ImageType": "BuiltIn",
        "JarTosUrl": "tos://xx.jar",
        "SparkType": "PySpark",
        "JarMainClass": "com.volcengine.Test",
        "ScriptTosUrl": "tos://xx.py",
        "DependencyFiles": [
            "tos://xx.txt"
        ],
        "ImageCredential": {
            "Password": "123456",
            "UserName": "admin"
        },
        "DependencyJarTosUrls": [
            "tos://xx.jar"
        ],
        "DependencyPythonTosUrls": [
            "tos://xx.zip",
            "tos://xx.py"
        ]
    },
    "PythonTask": {
        "Args": [
            "--a",
            "value1",
            "--b"
        ],
        "Envs": [
            {
                "name": "a",
                "value": "value1"
            }
        ],
        "Image": "python:3.9",
        "RunEnvs": [
            {
                "name": "b",
                "value": "b"
            }
        ],
        "ImageType": "BuiltIn",
        "Entrypoint": "python /code/xx.py",
        "ImageCredential": {}
    },
    "ClientToken": "uuid-xxxxxx",
    "Description": "for test",
    "NasMountPaths": [
        {
            "MountPath": "/test/nas/dst",
            "VolumePath": "/test/nas/src",
            "FileSystemId": "nas-uuid",
            "AccessPointId": "nas-access-point-uuid"
        }
    ],
    "TimeoutMinutes": 60,
    "VepfsMountPaths": [
        {
            "MountPath": "/mnt/vepfs",
            "VolumePath": "/folder1/",
            "FileSystemId": "vepfs-xxxxxx",
            "AccessPointId": "ap-xxx"
        }
    ],
    "DatasetMountPaths": [
        {
            "MountPath": "/test/data/dst",
            "DatasetName": "ds-uuid"
        }
    ],
    "DatasetCodeReviewId": "cr-uuid"
}

返回示例 #

{
    "ResponseMetadata": {
        "Action": "UpdateTask",
        "Region": "cn-beijing",
        "Service": "las_ai_qa",
        "Version": "2025-08-15",
        "RequestId": "20230604110420****100232280022D31",
        "Deprecated": false
    }
}

错误码 #

下表为您列举了该接口与业务逻辑相关的错误码。公共错误码请参见公共错误码文档。