Release Notes

Product Introduction

Overview

Strengths

Use Cases

Purchase Guide

Billing Overview

Refund

Payment Overdue

Configuration Adjustment Fees

Getting Started

Complete Process for New User Activation

DLC Data Import Guide

Quick Start with Data Analytics in Data Lake Compute

Quick Start with Permission Management in Data Lake Compute

Quick Start with Partition Table

Enabling Data Optimization

Cross-Source Analysis of EMR Hive Data

Standard Engine Configuration Guide

Configuring Data Access Policy

Operation Guide

Console Operation Introduction

Development Guide

Runtime Environment

SparkJar Job Development Guide

PySpark Job Development Guide

Query Performance Optimization Guide

UDF Function Development Guide

System Restraints

Client Access

JDBC Access

TDLC Command Line Interface Tool Access

Third-party Software Linkage

Python Access

Practical Tutorial

Accessing DLC Data with Power BI

Table Creation Practice

Using Apache Airflow to Schedule DLC Engine to Submit Tasks

Direct Query of DLC Internal Storage with StarRocks

Spark cost optimization practice

DATA + AI

Using DLC to Analyze CLS Logs

Using Role SSO to Access DLC

Resource-Level Authentication Guide

Implementing Tencent Cloud TCHouse-D Read and Write Operations in DLC

DLC Native Table

SQL Statement

SuperSQL Statement

Overview of Standard Spark Statement

Overview of Standard Presto Statement

Reserved Words

API Documentation

History

Introduction

API Category

Making API Requests

Data Table APIs

Task APIs

Metadata APIs

Service Configuration APIs

Permission Management APIs

Database APIs

Data Source Connection APIs

Data Optimization APIs

Data Engine APIs

Resource Group for the Standard Engine APIs

Data Types

Error Codes

General Reference

Error Codes

Quotas and limits

Operation Guide on Connecting Third-Party Software to DLC

FAQs

FAQs on Permissions

FAQs on Engines

FAQs on Features

FAQs on Spark Jobs

DLC Policy

Data Privacy And Security Agreement

Service Level Agreement

UpgradeDataEngineImage

PDF

Focus Mode

Font Size

Last updated: 2025-11-13 20:53:27

1. API Description

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

This API is used to upgrade the engine image.

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: UpgradeDataEngineImage.
Version	Yes	String	Common Params. The value used for this API: 2021-01-25.
Region	Yes	String	Common Params. For more information, please see the list of regions supported by the product.
DataEngineId	Yes	String	Engine ID

3. Output Parameters

Parameter Name	Type	Description
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 Upgrading the Engine Image Version

Input Example

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

{
    "DataEngineId": "DataEngine-xx"
}

Output Example

{
    "Response": {
        "RequestId": "abc"
    }
}

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

Tencent Cloud CLI 3.0

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	The operation failed.
FailedOperation.NoPermissionToUseTheDataEngine	The user does not have permission to specify the engine.
InternalError	An internal error occurred.
InternalError.InternalSystemException	The business system is abnormal. Please try again or submit a ticket to contact us.
InvalidParameter.DataEngineExecTypeNotMatch	The parameter ExecType passing to the specified cluster is invalid. Currently, only SQL or BATCH is supported.
InvalidParameter.DataEnginePayModeTypeNotMatch	The specified cluster payment type does not match. Currently, it only supports 0: postpaid and 1: prepaid.
InvalidParameter.ImageClusterParametersFormatNotJson	The specified cluster image Cluster parameter format is not JSON.
InvalidParameter.ImageEngineTypeNotMatch	The specified engine type does not match. Currently, only SparkSQL, PrestoSQL, and SparkBatch are supported.
InvalidParameter.ImageIsPublicNotMatch	The specified isPublic does not match. Currently, it only supports 1: public and 2: private.
InvalidParameter.ImageParameterNotFound	The specified cluster image parameter does not exist.
InvalidParameter.ImageSessionParametersFormatNotJson	The specified cluster image Session parameter format is not JSON.
InvalidParameter.ImageStateNotMatch	The specified state does not match. Currently, it only supports 1: initializing, 2: online, 3: offline.
InvalidParameter.ImageUserRecordsTypeNotMatch	The specified cluster image UserRecords does not match. Currently, it only supports: 1: parentVersion; 2: childVersion; 3: pySpark.
InvalidParameter.ParameterNotFoundOrBeNone	The parameter is not found or empty.
ResourceNotFound.DataEngineConfigInstanceNotFound	The specified cluster configuration instance does not exist.
ResourceNotFound.DataEngineConfigInstanceNotUnique	The specified cluster configuration instance already exists.
ResourceNotFound.DataEngineNotActivity	The specified cluster is not running.
ResourceNotFound.DataEngineNotFound	The specified engine does not exist.
ResourceNotFound.DataEngineNotMultiVersion	The specified cluster is not a multi-version type and does not support this operation.
ResourceNotFound.DataEngineNotUnique	The specified engine already exists.
ResourceNotFound.ImageSessionConfigNotFound	The specified cluster image Session configuration does not exist.
ResourceNotFound.ImageSessionConfigNotUnique	The specified cluster image Session configuration already exists.
ResourceNotFound.ImageVersionNotFound	The specified cluster image version does not exist.

Help and Support

Was this page helpful?

You can also Contact sales or Submit a Ticket for help.

Help us improve! Rate your documentation experience in 5 mins.

Feedback

tencent cloud

Data Lake Compute