你当前正在访问 Microsoft Azure Global Edition 技术文档网站。如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

Databases - Rename

服务:: SQL Database

API 版本:: 2023-08-01

重命名数据库。

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/databases/{databaseName}/move?api-version=2023-08-01

URI 参数

名称	在	必需	类型	说明
databaseName	path	True	string	要重命名的数据库的名称。
resourceGroupName	path	True	string	包含资源的资源组的名称。可以从 Azure 资源管理器 API 或门户获取此值。
serverName	path	True	string	服务器的名称。
subscriptionId	path	True	string	标识 Azure 订阅的订阅 ID。
api-version	query	True	string	要用于请求的 API 版本。

请求正文

名称	必需	类型	说明
id	True	string	资源的目标 ID

响应

名称	类型	说明
200 OK		已成功重命名数据库。
Other Status Codes	ErrorResponse	错误响应： *** 400 InvalidResourceMoveRequest - 资源移动请求无效。 400 InvalidMoveTargetResourceId - 移动请求中的目标资源标识符无效。 400 MismatchingSubscriptionWithUrl - 提供的订阅与 URL 中的订阅不匹配。 400 MismatchingResourceGroupNameWithUrl - 提供的资源组名称与 URL 中的名称不匹配。 400 不匹配ServerNameWithUrl - 提供的服务器名称与 URL 中的名称不匹配。 400 UnsupportedServiceName - 指定的名称是无效的名称，因为它包含一个或多个不受支持的 unicode 字符。 400 TokenTooLong - 提供的令牌太长。 400 DatabaseNameInUse - 数据库已存在。选择其他数据库名称。 400 CannotMoveOrDropJobAccountDatabase - 无法删除与作业帐户关联的数据库。 400 CannotUseReservedDatabaseName - 不能在此作中使用保留的数据库名称。 400 CannotMoveOrDropSyncMetadataDatabase - 无法删除用作同步元数据数据库的数据库。 400 InvalidIdentifier - 标识符包含 NULL 或无效的 unicode 字符。 404 SourceDatabaseNotFound - 源数据库不存在。 409 InvalidOperationForDatabaseInReplicationRelationship - 对已在复制关系中的数据库执行复制种子设定作。

名称

类型

说明

200 OK

已成功重命名数据库。

Other Status Codes

ErrorResponse

错误响应： ***

400 InvalidResourceMoveRequest - 资源移动请求无效。
400 InvalidMoveTargetResourceId - 移动请求中的目标资源标识符无效。
400 MismatchingSubscriptionWithUrl - 提供的订阅与 URL 中的订阅不匹配。
400 MismatchingResourceGroupNameWithUrl - 提供的资源组名称与 URL 中的名称不匹配。
400 不匹配ServerNameWithUrl - 提供的服务器名称与 URL 中的名称不匹配。
400 UnsupportedServiceName - 指定的名称是无效的名称，因为它包含一个或多个不受支持的 unicode 字符。
400 TokenTooLong - 提供的令牌太长。
400 DatabaseNameInUse - 数据库已存在。选择其他数据库名称。
400 CannotMoveOrDropJobAccountDatabase - 无法删除与作业帐户关联的数据库。
400 CannotUseReservedDatabaseName - 不能在此作中使用保留的数据库名称。
400 CannotMoveOrDropSyncMetadataDatabase - 无法删除用作同步元数据数据库的数据库。
400 InvalidIdentifier - 标识符包含 NULL 或无效的 unicode 字符。
404 SourceDatabaseNotFound - 源数据库不存在。
409 InvalidOperationForDatabaseInReplicationRelationship - 对已在复制关系中的数据库执行复制种子设定作。

示例

Renames a database.

POST https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/databases/testdb/move?api-version=2023-08-01

{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/databases/newtestdb"
}

using Azure;
using Azure.ResourceManager;
using System;
using System.Collections.Generic;
using System.Threading.Tasks;
using Azure.Core;
using Azure.Identity;
using Azure.ResourceManager.Models;
using Azure.ResourceManager.Sql.Models;
using Azure.ResourceManager.Sql;

// Generated from example definition: specification/sql/resource-manager/Microsoft.Sql/stable/2023-08-01/examples/RenameDatabase.json
// this example is just showing the usage of "Databases_Rename" operation, for the dependent resources, they will have to be created separately.

// get your azure access token, for more details of how Azure SDK get your access token, please refer to https://free.blessedness.top/en-us/dotnet/azure/sdk/authentication?tabs=command-line
TokenCredential cred = new DefaultAzureCredential();
// authenticate your client
ArmClient client = new ArmClient(cred);

// this example assumes you already have this SqlDatabaseResource created on azure
// for more information of creating SqlDatabaseResource, please refer to the document of SqlDatabaseResource
string subscriptionId = "00000000-1111-2222-3333-444444444444";
string resourceGroupName = "Default-SQL-SouthEastAsia";
string serverName = "testsvr";
string databaseName = "testdb";
ResourceIdentifier sqlDatabaseResourceId = SqlDatabaseResource.CreateResourceIdentifier(subscriptionId, resourceGroupName, serverName, databaseName);
SqlDatabaseResource sqlDatabase = client.GetSqlDatabaseResource(sqlDatabaseResourceId);

// invoke the operation
SqlResourceMoveDefinition sqlResourceMoveDefinition = new SqlResourceMoveDefinition(new ResourceIdentifier("/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/databases/newtestdb"));
await sqlDatabase.RenameAsync(sqlResourceMoveDefinition);

Console.WriteLine("Succeeded");

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

示例响应

状态代码:: 200

定义

名称	说明
ErrorAdditionalInfo	资源管理错误附加信息。
ErrorDetail	错误详细信息。
ErrorResponse	错误响应
ResourceMoveDefinition	包含执行资源移动（重命名）所需的信息。

ErrorAdditionalInfo

Object

资源管理错误附加信息。

名称	类型	说明
info	object	其他信息。
type	string	其他信息类型。

ErrorDetail

Object

错误详细信息。

名称	类型	说明
additionalInfo	ErrorAdditionalInfo[]	错误附加信息。
code	string	错误代码。
details	ErrorDetail[]	错误详细信息。
message	string	错误消息。
target	string	错误目标。

ErrorResponse

Object

错误响应

名称	类型	说明
error	ErrorDetail	错误对象。

ResourceMoveDefinition

Object

包含执行资源移动（重命名）所需的信息。

名称	类型	说明
id	string	资源的目标 ID

通过

Databases - Rename

URI 参数

请求正文

响应

示例

Renames a database.

示例请求

示例响应

定义

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

ResourceMoveDefinition