Databases - Rename

Služba:

SQL Database

Verze rozhraní API:

2021-11-01

Přejmenuje databázi.

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

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
databaseName	path	True	string	Název databáze, která se má přejmenovat.
resourceGroupName	path	True	string	Název skupiny prostředků, která prostředek obsahuje. Tuto hodnotu můžete získat z rozhraní API Resource Manager Azure nebo z portálu.
serverName	path	True	string	Název serveru.
subscriptionId	path	True	string	ID předplatného, které identifikuje předplatné Azure.
api-version	query	True	string	Verze rozhraní API, která se má použít pro požadavek.

Text požadavku

Name	Vyžadováno	Typ	Description
id	True	string	ID cíle prostředku

Odpovědi

Name	Typ	Description
200 OK		Databáze se úspěšně přejmenovala.
Other Status Codes		Chybové odpovědi: *** 400 InvalidResourceMoveRequest – žádost o přesun prostředku je neplatná. 400 InvalidMoveTargetResourceId – identifikátor cílového prostředku v žádosti o přesun je neplatný. 400 MismatchingSubscriptionWithUrl – zadané předplatné neodpovídá předplatnému v adrese URL. 400 MismatchingResourceGroupNameWithUrl – Zadaný název skupiny prostředků neodpovídá názvu v adrese URL. 400 MismatchingServerNameWithUrl – zadaný název serveru neodpovídá názvu v adrese URL. 400 InvalidIdentifier – identifikátor obsahuje hodnotu NULL nebo neplatný znak unicode. 400 DatabaseNameInUse – Databáze už existuje. Zvolte jiný název databáze. 400 TokenTooLong – zadaný token je příliš dlouhý. 400 CannotMoveOrDropSyncMetadataDatabase – Nelze odstranit databázi používanou jako databázi metadat synchronizace. 400 UnsupportedServiceName –zadaný název je neplatný, protože obsahuje jeden nebo více nepodporovaných znaků unicode. 400 CannotUseReservedDatabaseName – v této operaci nelze použít název rezervované databáze. 400 CannotMoveOrDropJobAccountDatabase – Nelze odstranit databázi přidruženou k účtu úlohy. 404 SourceDatabaseNotFound – zdrojová databáze neexistuje. 409 InvalidOperationForDatabaseInReplicationRelationship – U databáze, která je již ve vztahu replikace, byla provedena operace seeding replikace.

Příklady

Renames a database.

Ukázkový požadavek

HTTP

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"
}

Java

import com.azure.core.util.Context;
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"),
                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

Ukázková odpověď

Stavový kód:

200

Definice

ResourceMoveDefinition

Obsahuje informace potřebné k provedení přesunu (přejmenování).

Name	Typ	Description
id	string	ID cíle prostředku