Dela via


Databases - Rename

Byter namn på en databas.

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

URI-parametrar

Name I Obligatorisk Typ Description
databaseName
path True

string

Namnet på databasen som ska byta namn.

resourceGroupName
path True

string

Namnet på resursgruppen som innehåller resursen. Du kan hämta det här värdet från Azure Resource Manager-API:et eller portalen.

serverName
path True

string

Namnet på servern.

subscriptionId
path True

string

Det prenumerations-ID som identifierar en Azure-prenumeration.

api-version
query True

string

DEN API-version som ska användas för begäran.

Begärandetext

Name Obligatorisk Typ Description
id True

string

Mål-ID för resursen

Svar

Name Typ Description
200 OK

Databasen har bytt namn.

Other Status Codes

Felsvar: ***

  • 400 InvalidResourceMoveRequest – begäran om resursflytt är ogiltig.

  • 400 InvalidMoveTargetResourceId – Målresursidentifieraren i flyttbegäran är ogiltig.

  • 400 MismatchingSubscriptionWithUrl – den angivna prenumerationen matchade inte prenumerationen i URL:en.

  • 400 MismatchingResourceGroupNameWithUrl – Det angivna resursgruppsnamnet matchade inte namnet i URL:en.

  • 400 MismatchingServerNameWithUrl – det angivna servernamnet matchade inte namnet i URL:en.

  • 400 InvalidIdentifier – identifieraren innehåller NULL eller ett ogiltigt unicode-tecken.

  • 400 DatabaseNameInUse – Databasen finns redan. Välj ett annat databasnamn.

  • 400 TokenTooLong – den angivna token är för lång.

  • 400 CannotMoveOrDropSyncMetadataDatabase – Det går inte att ta bort databasen som används som databas för synkroniseringsmetadata.

  • 400 UnsupportedServiceName – Det angivna namnet är ett ogiltigt namn eftersom det innehåller ett eller flera unicode-tecken som inte stöds.

  • 400 CannotUseReservedDatabaseName – Det går inte att använda reserverade databasnamn i den här åtgärden.

  • 400 CannotMoveOrDropJobAccountDatabase – Det går inte att ta bort databasen som är associerad med jobbkontot.

  • 404 SourceDatabaseNotFound – källdatabasen finns inte.

  • 409 InvalidOperationForDatabaseInReplicationRelationship – En replikerings seeding-åtgärd utfördes på en databas som redan finns i en replikeringsrelation.

Exempel

Renames a database.

Exempelbegäran

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

Exempelsvar

Definitioner

ResourceMoveDefinition

Innehåller den information som krävs för att utföra en resursflytt (byt namn).

Name Typ Description
id

string

Mål-ID för resursen