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 do URI

Name	Em	Necessá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 um UUID.
api-version	query	True	string minLength: 1	A versão da API a utilizar para esta operação.

Corpo do Pedido

Name	Necessário	Tipo	Description
administratorLogin	True	string	Nome de login 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 o 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 login do administrador. Se AuthenticationType for ManagedIdentity, esse campo não deverá ser especificado.
authenticationType		string	Tipo de credenciais fornecidas para acesso ao servidor SQL de destino: SQL, ADPassword ou ManagedIdentity.
databaseName		string	Nome do banco de dados de importação.
edition		string	Edição da base de dados de importação.
maxSizeBytes		string	Tamanho máximo em bytes para o banco de dados de importação.
networkIsolation		NetworkIsolationSettings	Informações de recursos opcionais 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

Name	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.

Name

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
Fluxo: implicit
URL de Autorização: https://login.microsoftonline.com/common/oauth2/authorize

Âmbitos

Name	Description
user_impersonation	personificar a sua conta de utilizador

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.

Pedido de amostra

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

Código de estado:: 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 estado:: 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.

Pedido de amostra

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

Código de estado:: 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 estado:: 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.

Pedido de amostra

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

Código de estado:: 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 estado:: 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

Name	Description
createdByType	O tipo de identidade que criou o recurso.
ErrorAdditionalInfo	O erro de gerenciamento de recursos informações adicionais.
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 ARM para os quais criar conexão de ponto de extremidade privado.
PrivateEndpointConnectionRequestStatus	Contém o status das solicitações de conexão de ponto de extremidade privado.
StorageKeyType	Tipo de chave de armazenamento: StorageAccessKey, SharedAccessKey ou ManagedIdentity.
systemData	Metadados referentes à 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

Object

O erro de gerenciamento de recursos informações adicionais.

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

ErrorDetail

Object

O detalhe do erro.

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

ErrorResponse

Object

Resposta de erro

Name	Tipo	Description
error	ErrorDetail	O objeto de erro.

ImportExportOperationResult

Object

Um recurso de resultado da operação ImportExport.

Name	Tipo	Description
id	string (arm-id)	ID de recurso totalmente qualificado para o recurso. Por exemplo, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
name	string	O nome do recurso
properties.blobUri	string	Blob Uri.
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 de pontos de extremidade privados associados a essa solicitação.
properties.queuedTime	string	Tempo em fila.
properties.requestId	string (uuid)	Id da solicitação.
properties.requestType	string	Tipo de solicitação.
properties.serverName	string	Nome do servidor.
properties.status	string	Estado 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. Computação/Máquinas Virtuais" ou "Microsoft. ContasArmazenamento/Armazenamento"

ImportNewDatabaseDefinition

Object

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

Name	Tipo	Description
administratorLogin	string	Nome de login do administrador. Se AuthenticationType for ManagedIdentity, esse campo deverá especificar a ID de recurso da Identidade Gerenciada.
administratorLoginPassword	string (password)	Senha de login do administrador. Se AuthenticationType for ManagedIdentity, esse campo não deverá ser especificado.
authenticationType	string	Tipo de credenciais fornecidas para acesso ao servidor SQL de destino: SQL, ADPassword ou ManagedIdentity.
databaseName	string	Nome do banco de dados de importação.
edition	string	Edição da base de dados de importação.
maxSizeBytes	string	Tamanho máximo em bytes para o banco de dados de importação.
networkIsolation	NetworkIsolationSettings	Informações de recursos opcionais 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 o ID de recurso da Identidade Gerenciada.
storageKeyType	StorageKeyType	Tipo de chave de armazenamento: StorageAccessKey, SharedAccessKey ou ManagedIdentity.
storageUri	string	Uri de armazenamento.

NetworkIsolationSettings

Object

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

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

PrivateEndpointConnectionRequestStatus

Object

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

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

StorageKeyType

Enumeração

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

Valor	Description
SharedAccessKey	ChaveDeAcessoPartilhada
StorageAccessKey	StorageAccessKey
ManagedIdentity	ManagedIdentity

systemData

Object

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

Name	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.

Partilhar via

Servers - Import Database

Parâmetros do URI

Corpo do Pedido

Respostas

Segurança

azure_auth

Âmbitos

Exemplos

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

Pedido de amostra

Resposta da amostra

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

Pedido de amostra

Resposta da amostra

Imports to a new database.

Pedido de amostra

Resposta da amostra

Definições

createdByType

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

ImportExportOperationResult

ImportNewDatabaseDefinition

NetworkIsolationSettings

PrivateEndpointConnectionRequestStatus

StorageKeyType

systemData