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 參數

名稱	位於	必要	類型	Description
databaseName	path	True	string	要重新命名的資料庫名稱。
resourceGroupName	path	True	string	包含資源的資源群組名稱。您可以從 Azure 資源管理員 API 或入口網站取得這個值。
serverName	path	True	string	伺服器的名稱。
subscriptionId	path	True	string	可識別 Azure 訂用帳戶的訂用帳戶識別碼。
api-version	query	True	string	要用於要求的 API 版本。

要求本文

名稱	必要	類型	Description
id	True	string	資源的目標標識碼

回應

名稱	類型	Description
200 OK		已成功重新命名資料庫。
Other Status Codes		錯誤回應： ≦ 400 InvalidResourceMoveRequest - 資源移動要求無效。 400 InvalidMoveTargetResourceId - 移動要求中的目標資源標識符無效。 400 MatchingSubscriptionWithUrl - 提供的訂用帳戶不符合 URL 中的訂用帳戶。 400 MatchingResourceGroupNameWithUrl - 提供的資源組名與 URL 中的名稱不符。 400 不相符ServerNameWithUrl - 提供的伺服器名稱與 URL 中的名稱不符。 400 InvalidIdentifier - 識別碼包含 NULL 或無效的 Unicode 字元。 400 DatabaseNameInUse - 資料庫已經存在。請選擇其他資料庫名稱。 400 TokenTooLong - 提供的令牌太長。 400 CannotMoveOrDropSyncMetadataDatabase - 無法卸除用來作為同步元數據資料庫的資料庫。 400 UnsupportedServiceName - 指定的名稱是無效的名稱，因為它包含一或多個不支援的 Unicode 字元。 400 CannotUseReservedDatabaseName - 無法在此作業中使用保留的資料庫名稱。 400 CannotMoveOrDropJobAccountDatabase - 無法卸除與作業帳戶相關聯的資料庫。 404 SourceDatabaseNotFound - 源資料庫不存在。 409 InvalidOperationForDatabaseInReplicationRelationship - 已在復寫關聯性中的資料庫上執行複寫植入作業。

名稱

類型

Description

200 OK

已成功重新命名資料庫。

Other Status Codes

錯誤回應： ≦

400 InvalidResourceMoveRequest - 資源移動要求無效。
400 InvalidMoveTargetResourceId - 移動要求中的目標資源標識符無效。
400 MatchingSubscriptionWithUrl - 提供的訂用帳戶不符合 URL 中的訂用帳戶。
400 MatchingResourceGroupNameWithUrl - 提供的資源組名與 URL 中的名稱不符。
400 不相符ServerNameWithUrl - 提供的伺服器名稱與 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

包含執行資源移動所需的資訊， (重新命名) 。

名稱	類型	Description
id	string	資源的目標標識碼

共用方式為