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

Databases - Rename

参考

服务:: SQL Database

API 版本:: 2021-11-01

重命名数据库。

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/databases/{databaseName}/move?api-version=2021-11-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		错误响应： *** 400 InvalidResourceMoveRequest - 资源移动请求无效。 400 InvalidMoveTargetResourceId - 移动请求中的目标资源标识符无效。 400 MismatchingSubscriptionWithUrl - 提供的订阅与 URL 中的订阅不匹配。 400 MismatchingResourceGroupNameWithUrl - 提供的资源组名称与 URL 中的名称不匹配。 400 MismatchingServerNameWithUrl - 提供的服务器名称与 URL 中的名称不匹配。 400 InvalidIdentifier - 标识符包含 NULL 或无效的 unicode 字符。 400 DatabaseNameInUse - 数据库已存在。请选择其他数据库名称。 400 TokenTooLong - 提供的令牌太长。 400 CannotMoveOrDropSyncMetadataDatabase - 无法删除用作同步元数据数据库的数据库。 400 UnsupportedServiceName - 指定的名称是无效名称，因为它包含一个或多个不受支持的 unicode 字符。 400 CannotUseReservedDatabaseName - 此操作中不能使用保留的数据库名称。 400 CannotMoveOrDropJobAccountDatabase - 无法删除与作业帐户关联的数据库。 404 SourceDatabaseNotFound - 源数据库不存在。 409 InvalidOperationForDatabaseInReplicationRelationship - 对已在复制关系中的数据库执行复制种子设定操作。

名称

类型

说明

200 OK

已成功重命名数据库。

Other Status Codes

错误响应： ***

400 InvalidResourceMoveRequest - 资源移动请求无效。
400 InvalidMoveTargetResourceId - 移动请求中的目标资源标识符无效。
400 MismatchingSubscriptionWithUrl - 提供的订阅与 URL 中的订阅不匹配。
400 MismatchingResourceGroupNameWithUrl - 提供的资源组名称与 URL 中的名称不匹配。
400 MismatchingServerNameWithUrl - 提供的服务器名称与 URL 中的名称不匹配。
400 InvalidIdentifier - 标识符包含 NULL 或无效的 unicode 字符。
400 DatabaseNameInUse - 数据库已存在。请选择其他数据库名称。
400 TokenTooLong - 提供的令牌太长。
400 CannotMoveOrDropSyncMetadataDatabase - 无法删除用作同步元数据数据库的数据库。
400 UnsupportedServiceName - 指定的名称是无效名称，因为它包含一个或多个不受支持的 unicode 字符。
400 CannotUseReservedDatabaseName - 此操作中不能使用保留的数据库名称。
400 CannotMoveOrDropJobAccountDatabase - 无法删除与作业帐户关联的数据库。
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=2021-11-01

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


import com.azure.resourcemanager.sql.models.ResourceMoveDefinition;

/**
 * Samples for Databases Rename.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/RenameDatabase.json
     */
    /**
     * Sample code: Renames a database.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void renamesADatabase(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getDatabases()
            .renameWithResponse("Default-SQL-SouthEastAsia", "testsvr", "testdb", new ResourceMoveDefinition().withId(
                "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/databases/newtestdb"),
                com.azure.core.util.Context.NONE);
    }
}

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

示例响应

状态代码:: 200

定义

ResourceMoveDefinition

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

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

通过