Compartilhar via


Databases - Rename

Renomeia um banco de dados.

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

Parâmetros de URI

Nome Em Obrigatório Tipo Description
databaseName
path True

string

O nome do banco de dados a ser renomeado.

resourceGroupName
path True

string

O nome do grupo de recursos que contém o recurso. Você pode obter esse valor por meio da API do Gerenciador de Recursos do Azure ou por meio do portal.

serverName
path True

string

O nome do servidor.

subscriptionId
path True

string

A ID de assinatura que identifica uma assinatura do Azure.

api-version
query True

string

A versão da API a ser usada para a solicitação.

Corpo da solicitação

Nome Obrigatório Tipo Description
id True

string

A ID de destino para o recurso

Respostas

Nome Tipo Description
200 OK

O banco de dados foi renomeado com êxito.

Other Status Codes

Respostas de erro: ***

  • 400 InvalidResourceMoveRequest - A solicitação de movimentação de recurso é inválida.

  • 400 InvalidMoveTargetResourceId - O identificador de recurso de destino na solicitação de movimentação é inválido.

  • 400 MismatchingSubscriptionWithUrl - A assinatura fornecida não correspondeu à assinatura na URL.

  • 400 MismatchingResourceGroupNameWithUrl - O nome do grupo de recursos fornecido não correspondeu ao nome na URL.

  • 400 MismatchingServerNameWithUrl - O nome do servidor fornecido não correspondeu ao nome na URL.

  • 400 InvalidIdentifier - O identificador contém NULL ou um caractere unicode inválido.

  • 400 DatabaseNameInUse - O banco de dados já existe. Escolha um nome de banco de dados diferente.

  • 400 TokenTooLong - O token fornecido é muito longo.

  • 400 CannotMoveOrDropSyncMetadataDatabase - Não é possível descartar o banco de dados usado como banco de dados de metadados de sincronização.

  • 400 UnsupportedServiceName - O nome especificado é um nome inválido porque contém um ou mais caracteres unicode sem suporte.

  • 400 CannotUseReservedDatabaseName - Não é possível usar o nome do banco de dados reservado nesta operação.

  • 400 CannotMoveOrDropJobAccountDatabase - Não é possível descartar o banco de dados associado à conta de trabalho.

  • 404 SourceDatabaseNotFound - O banco de dados de origem não existe.

  • 409 InvalidOperationForDatabaseInReplicationRelationship - Uma operação de propagação de replicação foi executada em um banco de dados que já está em uma relação de replicação.

Exemplos

Renames a database.

Solicitação de exemplo

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

Resposta de exemplo

Definições

ResourceMoveDefinition

Contém as informações necessárias para executar uma movimentação de recurso (renomear).

Nome Tipo Description
id

string

A ID de destino para o recurso