Databases - Rename

Referenz

Dienst:: SQL Database

API-Version:: 2021-11-01

Benennt eine Datenbank um.

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

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
databaseName	path	True	string	Der Name der umzubenennten Datenbank.
resourceGroupName	path	True	string	Der Name der Ressourcengruppe, die die Ressource enthält. Dieser Wert kann über die Azure-Ressourcen-Manager-API oder das Portal abgerufen werden.
serverName	path	True	string	Name des Servers
subscriptionId	path	True	string	Abonnement-ID für ein Azure-Abonnement.
api-version	query	True	string	API-Version, die für die Anforderung verwendet werden soll.

Anforderungstext

Name	Erforderlich	Typ	Beschreibung
id	True	string	Die Ziel-ID für die Ressource

Antworten

Name	Typ	Beschreibung
200 OK		Die Datenbank wurde erfolgreich umbenannt.
Other Status Codes		Fehlerantworten: *** 400 InvalidResourceMoveRequest: Die Ressourcenverschiebungsanforderung ist ungültig. 400 InvalidMoveTargetResourceId: Der Zielressourcenbezeichner in der Verschiebungsanforderung ist ungültig. 400 MismatchingSubscriptionWithUrl: Das bereitgestellte Abonnement stimmte nicht mit dem Abonnement in der URL überein. 400 MismatchingResourceGroupNameWithUrl: Der angegebene Ressourcengruppenname stimmte nicht mit dem Namen in der URL überein. 400 MismatchingServerNameWithUrl: Der angegebene Servername stimmte nicht mit dem Namen in der URL überein. 400 InvalidIdentifier: Der Bezeichner enthält NULL oder ein ungültiges Unicode-Zeichen. 400 DatabaseNameInUse: Die Datenbank ist bereits vorhanden. Wählen Sie einen anderen Datenbanknamen aus. 400 TokenTooLong: Das bereitgestellte Token ist zu lang. 400 CannotMoveOrDropSyncMetadataDatabase: Datenbank kann nicht gelöscht werden, die als Synchronisierungsmetadatendatenbank verwendet wird. 400 UnsupportedServiceName: Der angegebene Name ist ein ungültiger Name, da er mindestens ein nicht unterstütztes Unicode-Zeichen enthält. 400 CannotUseReservedDatabaseName: Der name der reservierten Datenbank kann in diesem Vorgang nicht verwendet werden. 400 CannotMoveOrDropJobAccountDatabase: Datenbank kann nicht gelöscht werden, die dem Auftragskonto zugeordnet ist. 404 SourceDatabaseNotFound: Die Quelldatenbank ist nicht vorhanden. 409 InvalidOperationForDatabaseInReplicationRelationship: Für eine Datenbank, die sich bereits in einer Replikationsbeziehung befindet, wurde ein Replikationss seeding-Vorgang ausgeführt.

Name

Typ

Beschreibung

200 OK

Die Datenbank wurde erfolgreich umbenannt.

Other Status Codes

Fehlerantworten: ***

400 InvalidResourceMoveRequest: Die Ressourcenverschiebungsanforderung ist ungültig.
400 InvalidMoveTargetResourceId: Der Zielressourcenbezeichner in der Verschiebungsanforderung ist ungültig.
400 MismatchingSubscriptionWithUrl: Das bereitgestellte Abonnement stimmte nicht mit dem Abonnement in der URL überein.
400 MismatchingResourceGroupNameWithUrl: Der angegebene Ressourcengruppenname stimmte nicht mit dem Namen in der URL überein.
400 MismatchingServerNameWithUrl: Der angegebene Servername stimmte nicht mit dem Namen in der URL überein.
400 InvalidIdentifier: Der Bezeichner enthält NULL oder ein ungültiges Unicode-Zeichen.
400 DatabaseNameInUse: Die Datenbank ist bereits vorhanden. Wählen Sie einen anderen Datenbanknamen aus.
400 TokenTooLong: Das bereitgestellte Token ist zu lang.
400 CannotMoveOrDropSyncMetadataDatabase: Datenbank kann nicht gelöscht werden, die als Synchronisierungsmetadatendatenbank verwendet wird.
400 UnsupportedServiceName: Der angegebene Name ist ein ungültiger Name, da er mindestens ein nicht unterstütztes Unicode-Zeichen enthält.
400 CannotUseReservedDatabaseName: Der name der reservierten Datenbank kann in diesem Vorgang nicht verwendet werden.
400 CannotMoveOrDropJobAccountDatabase: Datenbank kann nicht gelöscht werden, die dem Auftragskonto zugeordnet ist.
404 SourceDatabaseNotFound: Die Quelldatenbank ist nicht vorhanden.
409 InvalidOperationForDatabaseInReplicationRelationship: Für eine Datenbank, die sich bereits in einer Replikationsbeziehung befindet, wurde ein Replikationss seeding-Vorgang ausgeführt.

Beispiele

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

Beispiel für eine Antwort

Statuscode:: 200

Definitionen

ResourceMoveDefinition

Enthält die Informationen, die zum Ausführen einer Ressourcenverschiebung (Umbenennen) erforderlich sind.

Name	Typ	Beschreibung
id	string	Die Ziel-ID für die Ressource

Freigeben über