Release Notes and Announcements

Release Notes

Product Announcements

User Guide

Product Introduction

Overview

Product Architecture

Strengths

Use Cases

Regions and AZs

Major Version Lifecycle Explanation

Features and Differences

Instance Types

Instance Specifications

Storage Types

Common Concepts

Network Environment

License Statement

Purchase Guide

Billing Overview

Product Pricing

Purchase Methods

Renewal Instructions

Payment Overdue

Refund

From Pay-as-You-Go to Monthly Subscription

Instance Adjustment Fees Description

Local Backup Space Billing

Cross-Region Backup Billing

Viewing Bill Details

Getting Started

Creating TencentDB for SQL Server Instance

Connecting to TencentDB for SQL Server Instance

Managing TencentDB for SQL Server Instance

Operation Guide

Constraints and Limits

Usage Specifications and Suggestions

Maintaining Instance

Adjusting Instance Configuration

Read-Only Instance

Network and Security

Account Management

Database Management

Data Security

Parameter Configuration

Monitoring and Alarms

Backup and Restoration

Log Management

Publish-Subscribe

SSIS

Data Migration (New)

Data Migration (Legacy)

Data Synchronization (DTS)

Practical Tutorial

TencentDB for SQL Server Methods for Regular Maintenance

TencentDB for SQL Server Optimization of Slow SQL

How to Better Use Tempdb

Cross-Account Backup Restoration

Creating VPC for TencentDB for SQL Server

Connecting Kingdee K/3 WISE to TencentDB for SQL Server

Account Permissions and Permission Control

Enabling and Disabling the CDC Feature

Shrinking a Database

API Documentation

History

Introduction

API Category

Making API Requests

Sales and fee related APIs

Instance Management related APIs

Operation and maintenance management related APIs

Network management related APIs

Account management related APIs

Database management related APIs

Security group management related APIs

Data security encryption related APIs

Parameter configuration related APIs

Extended Event related APIs

Log management related APIs

Read only instance management related APIs

Publish and subscribe related APIs

Backup related APIs

Rollback related APIs

Data migration (cold standby migration) related APIs

SQL Server Integration Services (SSIS) related APIs

Data migration (DTS old version) related APIs

Data Types

Error Codes

FAQs

Overview

Model Selection

Pricing and Selection

Connection and Network

Account and Permission

Backup and Rollback

Data Migration

Publish/Subscribe

Read-Only Instance

Version and Architecture Upgrade

Disk Space and Specification Adjustment

Monitoring and Alarms

Log-Related

Parameter Modification

Features

Performance, Space, and Memory-Related FAQs

Service Agreement

Service Level Agreement

Performance Evaluation

Performance Test Report

Glossary

ModifyDBName

PDF

Focus Mode

Font Size

Last updated: 2025-10-28 22:49:16

1. API Description

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

This API is used to rename a database.

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: ModifyDBName.
Version	Yes	String	Common Params. The value used for this API: 2018-03-28.
Region	Yes	String	Common Params. For more information, please see the list of regions supported by the product.
InstanceId	Yes	String	Instance ID
OldDBName	Yes	String	Old database name
NewDBName	Yes	String	New name of database

3. Output Parameters

Parameter Name	Type	Description
FlowId	Integer	Task flow ID
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 Modifying a database name

Input Example

https://sqlserver.intl.tencentcloudapi.com/?Action=ModifyDBName
&InstanceId=mssql-i1z41iwd
&OldDBName=test_db
&NewDBName=test_db_newname
&<Common request parameters>

Output Example

{
    "Response": {
        "FlowId": 123,
        "RequestId": "4be5990d-a4b5-49dc-b2b4-e713b6aa7ba3"
    }
}

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
InternalError.DBError	Database error
InternalError.GcsError	GCS API error.
InternalError.SystemError	System error.
InvalidParameter.InputIllegal	Input error.
InvalidParameter.ParamsAssertFailed	An error occurred while converting parameter assertion.
InvalidParameterValue.DBCharIllegal	The database name contains invalid characters.
InvalidParameterValue.DBExist	The database already exists.
InvalidParameterValue.DBNameIsKeyWrods	The database name cannot contain reserved words.
InvalidParameterValue.DBNameSame	The new database name is the same as the old one.
ResourceNotFound.DBNotFound	The database does not exist.
ResourceNotFound.InstanceNotFound	The instance does not exist.
ResourceUnavailable.DBInvalidStatus	Invalid database status.
UnauthorizedOperation.PermissionDenied	CAM authentication error.

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

TencentDB for SQL Server