Servers - Import Database

Serviço:: SQL Database

Versão da API:: 2025-01-01

Importa um bacpac para um novo banco de dados.

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/import?api-version=2025-01-01

Parâmetros de URI

Nome	Em	Obrigatório	Tipo	Description
resourceGroupName	path	True	string minLength: 1 maxLength: 90	O nome do grupo de recursos. O nome não diferencia maiúsculas de minúsculas.
serverName	path	True	string	O nome do servidor.
subscriptionId	path	True	string (uuid)	A ID da assinatura de destino. O valor deve ser uma UUID.
api-version	query	True	string minLength: 1	A versão da API a ser usada para esta operação.

Corpo da solicitação

Nome	Obrigatório	Tipo	Description
administratorLogin	True	string	Nome do logon do administrador. Se AuthenticationType for ManagedIdentity, esse campo deverá especificar a ID de recurso da Identidade Gerenciada.
storageKey	True	string	Chave de armazenamento para a conta de armazenamento. Se StorageKeyType for ManagedIdentity, esse campo deverá especificar a ID de recurso da Identidade Gerenciada.
storageKeyType	True	StorageKeyType	Tipo de chave de armazenamento: StorageAccessKey, SharedAccessKey ou ManagedIdentity.
storageUri	True	string	Uri de armazenamento.
administratorLoginPassword		string (password)	Senha de logon do administrador. Se AuthenticationType for ManagedIdentity, esse campo não deverá ser especificado.
authenticationType		string	Tipo de credenciais fornecidas para acesso ao SQL Server de destino: SQL, ADPassword ou ManagedIdentity.
databaseName		string	Nome do banco de dados de importação.
edition		string	Edição do banco de dados de importação.
maxSizeBytes		string	Tamanho máximo em bytes para o banco de dados de importação.
networkIsolation		NetworkIsolationSettings	Informações opcionais de recurso para habilitar o isolamento de rede para solicitação.
serviceObjectiveName		string	Nome do objetivo de nível de serviço do banco de dados de importação.

Respostas

Nome	Tipo	Description
200 OK	ImportExportOperationResult	Operação do Azure concluída com sucesso.
202 Accepted		Operação de recurso aceita. Cabeçalhos Location: string Retry-After: integer
Other Status Codes	ErrorResponse	Uma resposta de erro inesperada.

Nome

Tipo

Description

200 OK

ImportExportOperationResult

Operação do Azure concluída com sucesso.

202 Accepted

Operação de recurso aceita.

Cabeçalhos

Location: string
Retry-After: integer

Other Status Codes

ErrorResponse

Uma resposta de erro inesperada.

Segurança

azure_auth

Azure Active Directory OAuth2 Flow.

Tipo: oauth2
Flow: implicit
URL de Autorização: https://login.microsoftonline.com/common/oauth2/authorize

Escopos

Nome	Description
user_impersonation	representar sua conta de usuário

Exemplos

Imports to a new database, using Managed Identity for the SQL server and storage account.

Imports to a new database, using private link for the SQL server and storage account.

Imports to a new database.

Imports to a new database, using Managed Identity for the SQL server and storage account.

Solicitação de exemplo

HTTP

POST https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/import?api-version=2025-01-01

{
  "administratorLogin": "/subscriptions/00000000-1111-2222-3333-444444444444/resourcegroups/rgName/providers/Microsoft.ManagedIdentity/userAssignedIdentities/identityName",
  "authenticationType": "ManagedIdentity",
  "databaseName": "testdb",
  "storageKey": "/subscriptions/00000000-1111-2222-3333-444444444444/resourcegroups/rgName/providers/Microsoft.ManagedIdentity/userAssignedIdentities/identityName",
  "storageKeyType": "ManagedIdentity",
  "storageUri": "https://test.blob.core.windows.net/test.bacpac"
}

Resposta de exemplo

Código de status:: 200

{
  "name": "9d9a794a-5cec-4f23-af70-d29511b522a4",
  "type": "Microsoft.Sql/servers/databases/importExportOperationResults",
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/databases/testdb/importExportOperationResults/9d9a794a-5cec-4f23-af70-d29511b522a4",
  "properties": {
    "blobUri": "https://test.blob.core.windows.net/test.bacpac",
    "databaseName": "testdb",
    "lastModifiedTime": "2/2/2020 8:34:47 PM",
    "queuedTime": "2/2/2020 8:33:27 PM",
    "requestId": "9d9a794a-5cec-4f23-af70-d29511b522a4",
    "requestType": "Import",
    "serverName": "testsvr.database.windows.net",
    "status": "Completed"
  }
}

Código de status:: 202

Location: https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.Sql/locations/japaneast/importExportOperationResults/00000000-0000-0000-0000-000000000000?api-version=2022-08-01

Imports to a new database, using private link for the SQL server and storage account.

Solicitação de exemplo

HTTP

POST https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/import?api-version=2025-01-01

{
  "administratorLogin": "login",
  "administratorLoginPassword": "password",
  "authenticationType": "Sql",
  "databaseName": "testdb",
  "networkIsolation": {
    "sqlServerResourceId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr",
    "storageAccountResourceId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Storage/storageAccounts/test-privatelink"
  },
  "storageKey": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx==",
  "storageKeyType": "StorageAccessKey",
  "storageUri": "https://test.blob.core.windows.net/test.bacpac"
}

Resposta de exemplo

Código de status:: 200

{
  "name": "9d9a794a-5cec-4f23-af70-d29511b522a4",
  "type": "Microsoft.Sql/servers/databases/importExportOperationResults",
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/databases/testdb/importExportOperationResults/9d9a794a-5cec-4f23-af70-d29511b522a4",
  "properties": {
    "blobUri": "https://test.blob.core.windows.net/test.bacpac",
    "databaseName": "testdb",
    "lastModifiedTime": "2/2/2020 8:34:47 PM",
    "queuedTime": "2/2/2020 8:33:27 PM",
    "requestId": "9d9a794a-5cec-4f23-af70-d29511b522a4",
    "requestType": "Import",
    "serverName": "testsvr.database.windows.net",
    "status": "Completed"
  }
}

Código de status:: 202

Location: https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.Sql/locations/japaneast/importExportOperationResults/00000000-0000-0000-0000-000000000000?api-version=2022-08-01

Imports to a new database.

Solicitação de exemplo

HTTP

POST https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/import?api-version=2025-01-01

{
  "administratorLogin": "login",
  "administratorLoginPassword": "password",
  "authenticationType": "Sql",
  "databaseName": "testdb",
  "storageKey": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx==",
  "storageKeyType": "StorageAccessKey",
  "storageUri": "https://test.blob.core.windows.net/test.bacpac"
}

Resposta de exemplo

Código de status:: 200

{
  "name": "9d9a794a-5cec-4f23-af70-d29511b522a4",
  "type": "Microsoft.Sql/servers/databases/importExportOperationResults",
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/databases/testdb/importExportOperationResults/9d9a794a-5cec-4f23-af70-d29511b522a4",
  "properties": {
    "blobUri": "https://test.blob.core.windows.net/test.bacpac",
    "databaseName": "testdb",
    "lastModifiedTime": "2/2/2020 8:34:47 PM",
    "queuedTime": "2/2/2020 8:33:27 PM",
    "requestId": "9d9a794a-5cec-4f23-af70-d29511b522a4",
    "requestType": "Import",
    "serverName": "testsvr.database.windows.net",
    "status": "Completed"
  }
}

Código de status:: 202

Location: https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.Sql/locations/japaneast/importExportOperationResults/00000000-0000-0000-0000-000000000000?api-version=2022-08-01

Definições

Nome	Description
createdByType	O tipo de identidade que criou o recurso.
ErrorAdditionalInfo	As informações adicionais do erro de gerenciamento de recursos.
ErrorDetail	O detalhe do erro.
ErrorResponse	Resposta de erro
ImportExportOperationResult	Um recurso de resultado da operação ImportExport.
ImportNewDatabaseDefinition	Contém as informações necessárias para executar a operação de importação para o novo banco de dados.
NetworkIsolationSettings	Contém os recursos do ARM para os quais criar conexão de ponto de extremidade privado.
PrivateEndpointConnectionRequestStatus	Contém o status de solicitações de conexão de ponto de extremidade privado.
StorageKeyType	Tipo de chave de armazenamento: StorageAccessKey, SharedAccessKey ou ManagedIdentity.
systemData	Metadados relativos à criação e última modificação do recurso.

createdByType

Enumeração

O tipo de identidade que criou o recurso.

Valor	Description
User
Application
ManagedIdentity
Key

ErrorAdditionalInfo

Objeto

As informações adicionais do erro de gerenciamento de recursos.

Nome	Tipo	Description
info	object	As informações adicionais.
type	string	O tipo de informação adicional.

ErrorDetail

Objeto

O detalhe do erro.

Nome	Tipo	Description
additionalInfo	ErrorAdditionalInfo[]	As informações adicionais do erro.
code	string	O código de erro.
details	ErrorDetail[]	Os detalhes do erro.
message	string	A mensagem de erro.
target	string	O destino do erro.

ErrorResponse

Objeto

Resposta de erro

Nome	Tipo	Description
error	ErrorDetail	O objeto de erro.

ImportExportOperationResult

Objeto

Um recurso de resultado da operação ImportExport.

Nome	Tipo	Description
id	string (arm-id)	ID de recurso totalmente qualificada para o recurso. Por exemplo, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
name	string	O nome do recurso
properties.blobUri	string	Uri do Blob.
properties.databaseName	string	Nome do banco de dados.
properties.errorMessage	string	Mensagem de erro.
properties.lastModifiedTime	string	Hora da última modificação.
properties.privateEndpointConnections	PrivateEndpointConnectionRequestStatus[]	Obtém o status dos pontos de extremidade privados associados a essa solicitação.
properties.queuedTime	string	Tempo na fila.
properties.requestId	string (uuid)	ID da solicitação.
properties.requestType	string	Tipo de solicitação.
properties.serverName	string	Nome de servidor.
properties.status	string	Status da operação.
systemData	systemData	Metadados do Azure Resource Manager contendo informações createdBy e modifiedBy.
type	string	O tipo do recurso. Por exemplo, "Microsoft. Compute/virtualMachines" ou "Microsoft. ContasArmazenamento/Armazenamento"

ImportNewDatabaseDefinition

Objeto

Contém as informações necessárias para executar a operação de importação para o novo banco de dados.

Nome	Tipo	Description
administratorLogin	string	Nome do logon do administrador. Se AuthenticationType for ManagedIdentity, esse campo deverá especificar a ID de recurso da Identidade Gerenciada.
administratorLoginPassword	string (password)	Senha de logon do administrador. Se AuthenticationType for ManagedIdentity, esse campo não deverá ser especificado.
authenticationType	string	Tipo de credenciais fornecidas para acesso ao SQL Server de destino: SQL, ADPassword ou ManagedIdentity.
databaseName	string	Nome do banco de dados de importação.
edition	string	Edição do banco de dados de importação.
maxSizeBytes	string	Tamanho máximo em bytes para o banco de dados de importação.
networkIsolation	NetworkIsolationSettings	Informações opcionais de recurso para habilitar o isolamento de rede para solicitação.
serviceObjectiveName	string	Nome do objetivo de nível de serviço do banco de dados de importação.
storageKey	string	Chave de armazenamento para a conta de armazenamento. Se StorageKeyType for ManagedIdentity, esse campo deverá especificar a ID de recurso da Identidade Gerenciada.
storageKeyType	StorageKeyType	Tipo de chave de armazenamento: StorageAccessKey, SharedAccessKey ou ManagedIdentity.
storageUri	string	Uri de armazenamento.

NetworkIsolationSettings

Objeto

Contém os recursos do ARM para os quais criar conexão de ponto de extremidade privado.

Nome	Tipo	Description
sqlServerResourceId	string (arm-id)	A ID do recurso para o SQL Server que é o destino dessa solicitação. Se definido, a conexão de ponto de extremidade privado será criada para o SQL Server. Deve corresponder ao servidor que é o destino da operação.
storageAccountResourceId	string (arm-id)	A ID do recurso da conta de armazenamento usada para armazenar o arquivo BACPAC. Se definido, a conexão de ponto de extremidade privado será criada para a conta de armazenamento. Deve corresponder à conta de armazenamento usada para o parâmetro StorageUri.

PrivateEndpointConnectionRequestStatus

Objeto

Contém o status de solicitações de conexão de ponto de extremidade privado.

Nome	Tipo	Description
privateEndpointConnectionName	string	O nome da conexão para o ponto de extremidade privado.
privateLinkServiceId	string	ID de recurso para a qual o ponto de extremidade privado é criado.
status	string	Status dessa conexão de ponto de extremidade privado.

StorageKeyType

Enumeração

Tipo de chave de armazenamento: StorageAccessKey, SharedAccessKey ou ManagedIdentity.

Valor	Description
SharedAccessKey	Chave de Acesso Compartilhada
StorageAccessKey	StorageAccessKey
ManagedIdentity	ManagedIdentity

systemData

Objeto

Metadados relativos à criação e última modificação do recurso.

Nome	Tipo	Description
createdAt	string (date-time)	O carimbo de data/hora da criação de recursos (UTC).
createdBy	string	A identidade que criou o recurso.
createdByType	createdByType	O tipo de identidade que criou o recurso.
lastModifiedAt	string (date-time)	O carimbo de data/hora da última modificação do recurso (UTC)
lastModifiedBy	string	A identidade que modificou o recurso pela última vez.
lastModifiedByType	createdByType	O tipo de identidade que modificou o recurso pela última vez.

Compartilhar via

Servers - Import Database

Parâmetros de URI

Corpo da solicitação

Respostas

Segurança

azure_auth

Escopos

Exemplos

Imports to a new database, using Managed Identity for the SQL server and storage account.

Solicitação de exemplo

Resposta de exemplo

Imports to a new database, using private link for the SQL server and storage account.

Solicitação de exemplo

Resposta de exemplo

Imports to a new database.

Solicitação de exemplo

Resposta de exemplo

Definições

createdByType

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

ImportExportOperationResult

ImportNewDatabaseDefinition

NetworkIsolationSettings

PrivateEndpointConnectionRequestStatus

StorageKeyType

systemData