Partilhar via


Databases - Rename

Muda o nome de uma base 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 do URI

Name Em Necessário Tipo Description
databaseName
path True

string

O nome da base de dados a mudar o nome.

resourceGroupName
path True

string

O nome do grupo de recursos que contém o recurso. Pode obter este valor a partir da API do Azure Resource Manager ou do portal.

serverName
path True

string

O nome do servidor.

subscriptionId
path True

string

O ID da subscrição que identifica uma subscrição do Azure.

api-version
query True

string

A versão da API a utilizar para o pedido.

Corpo do Pedido

Name Necessário Tipo Description
id True

string

O ID de destino do recurso

Respostas

Name Tipo Description
200 OK

O nome da base de dados foi mudado com êxito.

Other Status Codes

Respostas de Erro: ***

  • 400 InvalidResourceMoveRequest – o pedido de movimentação de recursos é inválido.

  • 400 InvalidMoveTargetResourceId – o identificador do recurso de destino no pedido de movimentação é inválido.

  • 400 MismatchingSubscriptionWithUrl – a subscrição fornecida não correspondeu à subscrição no URL.

  • 400 MismatchingResourceGroupNameWithUrl – o nome do grupo de recursos fornecido não corresponde ao nome no URL.

  • 400 MismatchingServerNameWithUrl – o nome do servidor fornecido não corresponde ao nome no URL.

  • 400 InvalidIdentifier – o identificador contém NULL ou um caráter unicode inválido.

  • 400 DatabaseNameInUse – a base de dados já existe. Escolha um nome de base de dados diferente.

  • 400 TokenTooLong – o token fornecido é demasiado longo.

  • 400 CannotMoveOrDropSyncMetadataDatabase – não é possível remover a base de dados utilizada como base de dados de metadados de sincronização.

  • 400 UnsupportedServiceName – o nome especificado é um nome inválido porque contém um ou mais carateres unicode não suportados.

  • 400 CannotUseReservedDatabaseName – não é possível utilizar o nome da base de dados reservada nesta operação.

  • 400 CannotMoveOrDropJobAccountDatabase – não é possível remover a base de dados associada à conta de tarefa.

  • 404 SourceDatabaseNotFound – a base de dados de origem não existe.

  • 409 InvalidOperationForDatabaseInReplicationRelationship – foi executada uma operação de propagação de replicação numa base de dados que já se encontra numa relação de replicação.

Exemplos

Renames a database.

Pedido de amostra

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 da amostra

Definições

ResourceMoveDefinition

Contém as informações necessárias para efetuar uma movimentação de recursos (mudar o nome).

Name Tipo Description
id

string

O ID de destino do recurso