Databases - Export

Servizio:: SQL Database

Versione API:: 2023-08-01

Esporta un database.

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

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
databaseName	path	True	string	Nome del database.
resourceGroupName	path	True	string	Nome del gruppo di risorse che contiene la risorsa. È possibile ottenere questo valore dall'API di Azure Resource Manager o dal portale.
serverName	path	True	string	Nome del server.
subscriptionId	path	True	string	ID sottoscrizione che identifica una sottoscrizione di Azure.
api-version	query	True	string	Versione dell'API da usare per la richiesta.

Corpo della richiesta

Nome	Necessario	Tipo	Descrizione
administratorLogin	True	string	Nome di accesso dell'amministratore.
administratorLoginPassword	True	string	Password di accesso dell'amministratore.
storageKey	True	string	Chiave di archiviazione.
storageKeyType	True	StorageKeyType	Tipo di chiave di archiviazione.
storageUri	True	string	URI di archiviazione.
authenticationType		string	Tipo di autenticazione.
networkIsolation		NetworkIsolationSettings	Informazioni facoltative sulle risorse per abilitare l'isolamento di rete per la richiesta.

Risposte

Nome	Tipo	Descrizione
200 OK	ImportExportOperationResult	Esportato correttamente il database.
202 Accepted		L'esportazione del database è in corso. Intestazioni Location: string
Other Status Codes	ErrorResponse	Risposte di errore: 400 MissingImportExportInputParameters - Parametri di input ImportExport mancanti. 400 InvalidImportExportInputParameter - La richiesta di importazione/esportazione non è riuscita a causa di un parametro di input non valido. 400 PolybaseImportAuthenticationTypeNotSupported - Il parametro del tipo di autenticazione non è supportato per l'operazione PolybaseImport. 400 DatabaseExtensionsInvalidOperationMode - Parametro operationMode non valido per l'estensione del database. 400 DatabaseExtensionsInvalidStorageKeyType: il tipo di chiave di archiviazione deve essere "StorageAccessKey". 400 DatabaseExtensionsMissingStorageUri: l'URI di archiviazione non può essere vuoto. 400 SQLPasswordSpecifiedWithManagedIdentity - administratorLoginPassword non deve essere specificato se authenticationType è ManagedIdentity. 400 InvalidSqlAuthType - Operazione ImportExport non riuscita perché il tipo di autenticazione sql non è valido 400 BlobAlreadyExist - Operazione ImportExport non riuscita perché il BLOB di archiviazione esiste già 400 InvalidImportExportOperationResourceLocks- La richiesta di importazione/esportazione non è valida a causa di blocchi sulle risorse collegamento privato. 400 DatabaseInvalidSkuPropertyCombination: le proprietà dello SKU richiesto non sono coerenti. Verificare che sia specificata una combinazione valida. Per altri dettagli, vedere https://docs.microsoft.com/en-us/rest/api/sql/capabilities/listbylocation#serviceobjectivecapability. 400 ImportExportJobError - L'operazione ImportExport non è riuscita. 400 BlockedByOutboundFirewall: le regole del firewall in uscita bloccavano la richiesta. 400 InvalidOperationType: specificare un tipo di operazione valido. 400 InvalidMaxSizeTierCombination: il livello specificato non supporta le dimensioni massime del database specificate. 400 InvalidTier: l'utente ha specificato un livello non valido. 400 CannotUseReservedDatabaseName: impossibile utilizzare il nome del database riservato in questa operazione. 400 InvalidImportExportParameter - La richiesta di importazione/esportazione non è riuscita a causa di un parametro di input non valido. 400 InvalidSku: l'utente ha specificato uno SKU non valido. 400 InvalidTierSkuCombination: il livello specificato non supporta lo SKU specificato. 400 InvalidImportExportStorageCredentials - Operazione di importazione/esportazione non riuscita a causa di credenziali di archiviazione non valide 400 InvalidImportExportStorageAuthType - Operazione di importazione/esportazione non riuscita a causa di un tipo di autenticazione di archiviazione non valido 400 InvalidImportExportStorageKeyFormat - Operazione di importazione/esportazione non riuscita a causa di un formato di chiave di archiviazione non valido 400 LongImportExportStorageUri - Operazione di importazione/esportazione non riuscita a causa di un URI di archiviazione lungo 400 LargeExportDatabaseSize - Operazione di esportazione non riuscita perché il database è maggiore delle dimensioni massime supportate 400 FeatureDisabledOnSelectedEdition : l'utente ha tentato di usare una funzionalità disabilitata nell'edizione del database corrente. 400 UnSupportedImportExportEdition - Operazione ImportExport non riuscita perché è destinata a un'edizione non valida 400 InvalidImportExportStorageURI - Operazione ImportExport non riuscita perché l'URI di archiviazione non è valido 404 DatabaseDoesNotExist: l'utente ha specificato un nome di database che non esiste in questa istanza del server. 404 ServerNotInSubscription - Il server specificato non esiste nella sottoscrizione specificata. 404 ServerNotInSubscriptionResourceGroup - Il server specificato non esiste nel gruppo di risorse e nella sottoscrizione specificati. 404 ResourceNotFound - Richiesta non valida che specifica una risorsa inesistente. 404 ImportExportOperationIdNotFound - Impossibile trovare l'ID operazione per l'importazione o l'esportazione. 404 OperationIdNotFound - L'operazione con ID non esiste. 409 ImportExportOperationInProgress- È in corso un'operazione di importazione o esportazione nel database. 409 CannotCancelOperation: l'operazione di gestione si trova in uno stato che non può essere annullato. 409 OperationCancelled - L'operazione è stata annullata dall'utente. 409 OperationInterrupted - Impossibile completare l'operazione sulla risorsa perché è stata interrotta da un'altra operazione sulla stessa risorsa. 429 SubscriptionTooManyCreateUpdateRequests - Richieste oltre il numero massimo di richieste che possono essere elaborate dalle risorse disponibili. 429 SubscriptionTooManyRequests - Richieste oltre il numero massimo di richieste che possono essere elaborate dalle risorse disponibili. 500 OperationTimedOut: timeout dell'operazione e rollback automatico. Ripetere l'operazione. 503 TooManyRequests - Richieste oltre il numero massimo di richieste che possono essere elaborate dalle risorse disponibili.

Nome

Tipo

Descrizione

200 OK

ImportExportOperationResult

Esportato correttamente il database.

202 Accepted

L'esportazione del database è in corso.

Intestazioni

Location: string

Other Status Codes

ErrorResponse

Risposte di errore:

400 MissingImportExportInputParameters - Parametri di input ImportExport mancanti.
400 InvalidImportExportInputParameter - La richiesta di importazione/esportazione non è riuscita a causa di un parametro di input non valido.
400 PolybaseImportAuthenticationTypeNotSupported - Il parametro del tipo di autenticazione non è supportato per l'operazione PolybaseImport.
400 DatabaseExtensionsInvalidOperationMode - Parametro operationMode non valido per l'estensione del database.
400 DatabaseExtensionsInvalidStorageKeyType: il tipo di chiave di archiviazione deve essere "StorageAccessKey".
400 DatabaseExtensionsMissingStorageUri: l'URI di archiviazione non può essere vuoto.
400 SQLPasswordSpecifiedWithManagedIdentity - administratorLoginPassword non deve essere specificato se authenticationType è ManagedIdentity.
400 InvalidSqlAuthType - Operazione ImportExport non riuscita perché il tipo di autenticazione sql non è valido
400 BlobAlreadyExist - Operazione ImportExport non riuscita perché il BLOB di archiviazione esiste già
400 InvalidImportExportOperationResourceLocks- La richiesta di importazione/esportazione non è valida a causa di blocchi sulle risorse collegamento privato.
400 DatabaseInvalidSkuPropertyCombination: le proprietà dello SKU richiesto non sono coerenti. Verificare che sia specificata una combinazione valida. Per altri dettagli, vedere https://docs.microsoft.com/en-us/rest/api/sql/capabilities/listbylocation#serviceobjectivecapability.
400 ImportExportJobError - L'operazione ImportExport non è riuscita.
400 BlockedByOutboundFirewall: le regole del firewall in uscita bloccavano la richiesta.
400 InvalidOperationType: specificare un tipo di operazione valido.
400 InvalidMaxSizeTierCombination: il livello specificato non supporta le dimensioni massime del database specificate.
400 InvalidTier: l'utente ha specificato un livello non valido.
400 CannotUseReservedDatabaseName: impossibile utilizzare il nome del database riservato in questa operazione.
400 InvalidImportExportParameter - La richiesta di importazione/esportazione non è riuscita a causa di un parametro di input non valido.
400 InvalidSku: l'utente ha specificato uno SKU non valido.
400 InvalidTierSkuCombination: il livello specificato non supporta lo SKU specificato.
400 InvalidImportExportStorageCredentials - Operazione di importazione/esportazione non riuscita a causa di credenziali di archiviazione non valide
400 InvalidImportExportStorageAuthType - Operazione di importazione/esportazione non riuscita a causa di un tipo di autenticazione di archiviazione non valido
400 InvalidImportExportStorageKeyFormat - Operazione di importazione/esportazione non riuscita a causa di un formato di chiave di archiviazione non valido
400 LongImportExportStorageUri - Operazione di importazione/esportazione non riuscita a causa di un URI di archiviazione lungo
400 LargeExportDatabaseSize - Operazione di esportazione non riuscita perché il database è maggiore delle dimensioni massime supportate
400 FeatureDisabledOnSelectedEdition : l'utente ha tentato di usare una funzionalità disabilitata nell'edizione del database corrente.
400 UnSupportedImportExportEdition - Operazione ImportExport non riuscita perché è destinata a un'edizione non valida
400 InvalidImportExportStorageURI - Operazione ImportExport non riuscita perché l'URI di archiviazione non è valido
404 DatabaseDoesNotExist: l'utente ha specificato un nome di database che non esiste in questa istanza del server.
404 ServerNotInSubscription - Il server specificato non esiste nella sottoscrizione specificata.
404 ServerNotInSubscriptionResourceGroup - Il server specificato non esiste nel gruppo di risorse e nella sottoscrizione specificati.
404 ResourceNotFound - Richiesta non valida che specifica una risorsa inesistente.
404 ImportExportOperationIdNotFound - Impossibile trovare l'ID operazione per l'importazione o l'esportazione.
404 OperationIdNotFound - L'operazione con ID non esiste.
409 ImportExportOperationInProgress- È in corso un'operazione di importazione o esportazione nel database.
409 CannotCancelOperation: l'operazione di gestione si trova in uno stato che non può essere annullato.
409 OperationCancelled - L'operazione è stata annullata dall'utente.
409 OperationInterrupted - Impossibile completare l'operazione sulla risorsa perché è stata interrotta da un'altra operazione sulla stessa risorsa.
429 SubscriptionTooManyCreateUpdateRequests - Richieste oltre il numero massimo di richieste che possono essere elaborate dalle risorse disponibili.
429 SubscriptionTooManyRequests - Richieste oltre il numero massimo di richieste che possono essere elaborate dalle risorse disponibili.
500 OperationTimedOut: timeout dell'operazione e rollback automatico. Ripetere l'operazione.
503 TooManyRequests - Richieste oltre il numero massimo di richieste che possono essere elaborate dalle risorse disponibili.

Esempio

Exports a database, using private link to communicate with SQL server and storage account.

Exports a database.

Exports a database, using private link to communicate with SQL server and storage account.

Esempio di richiesta

HTTP

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

{
  "storageKeyType": "StorageAccessKey",
  "storageKey": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx==",
  "storageUri": "https://test.blob.core.windows.net/test.bacpac",
  "administratorLogin": "login",
  "administratorLoginPassword": "password",
  "authenticationType": "Sql",
  "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"
  }
}

Risposta di esempio

Codice di stato:: 200

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

Codice di stato:: 202

Location: /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.Sql/locations/japaneast/importExportOperationResults/00000000-0000-0000-0000-000000000000

Exports a database.

Esempio di richiesta

HTTP

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

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

Risposta di esempio

Codice di stato:: 200

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

Codice di stato:: 202

Location: /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.Sql/locations/japaneast/importExportOperationResults/00000000-0000-0000-0000-000000000000

Definizioni

Nome	Descrizione
ErrorAdditionalInfo	Informazioni aggiuntive sull'errore di gestione delle risorse.
ErrorDetail	Dettagli dell'errore.
ErrorResponse	Risposta di errore
ExportDatabaseDefinition	Contiene le informazioni necessarie per eseguire l'operazione di esportazione del database.
ImportExportOperationResult	Risorsa risultato dell'operazione ImportExport.
NetworkIsolationSettings	Contiene le risorse arm per le quali creare una connessione all'endpoint privato.
PrivateEndpointConnectionRequestStatus	Contiene lo stato delle richieste di connessione dell'endpoint privato.
StorageKeyType	Tipo di chiave di archiviazione.

ErrorAdditionalInfo

Oggetto

Informazioni aggiuntive sull'errore di gestione delle risorse.

Nome	Tipo	Descrizione
info	object	Informazioni aggiuntive.
type	string	Tipo di informazioni aggiuntive.

ErrorDetail

Oggetto

Dettagli dell'errore.

Nome	Tipo	Descrizione
additionalInfo	ErrorAdditionalInfo[]	Informazioni aggiuntive sull'errore.
code	string	Codice di errore.
details	ErrorDetail[]	Dettagli dell'errore.
message	string	Messaggio di errore.
target	string	Destinazione dell'errore.

ErrorResponse

Oggetto

Risposta di errore

Nome	Tipo	Descrizione
error	ErrorDetail	Oggetto error.

ExportDatabaseDefinition

Oggetto

Contiene le informazioni necessarie per eseguire l'operazione di esportazione del database.

Nome	Tipo	Descrizione
administratorLogin	string	Nome di accesso dell'amministratore.
administratorLoginPassword	string	Password di accesso dell'amministratore.
authenticationType	string	Tipo di autenticazione.
networkIsolation	NetworkIsolationSettings	Informazioni facoltative sulle risorse per abilitare l'isolamento di rete per la richiesta.
storageKey	string	Chiave di archiviazione.
storageKeyType	StorageKeyType	Tipo di chiave di archiviazione.
storageUri	string	URI di archiviazione.

ImportExportOperationResult

Oggetto

Risorsa risultato dell'operazione ImportExport.

Nome	Tipo	Descrizione
id	string	ID risorsa.
name	string	Nome risorsa.
properties.blobUri	string	URI BLOB.
properties.databaseName	string	Nome database.
properties.errorMessage	string	Messaggio di errore.
properties.lastModifiedTime	string	Ora dell'ultima modifica.
properties.privateEndpointConnections	PrivateEndpointConnectionRequestStatus[]	Ottiene lo stato degli endpoint privati associati a questa richiesta.
properties.queuedTime	string	Tempo in coda.
properties.requestId	string (uuid)	ID richiesta.
properties.requestType	string	Tipo di richiesta.
properties.serverName	string	Nome server.
properties.status	string	Stato dell'operazione.
type	string	Tipo di risorsa.

NetworkIsolationSettings

Oggetto

Contiene le risorse arm per le quali creare una connessione all'endpoint privato.

Nome	Tipo	Descrizione
sqlServerResourceId	string (arm-id)	ID risorsa per SQL Server che è la destinazione di questa richiesta. Se impostato, verrà creata la connessione all'endpoint privato per SQL Server. Deve corrispondere al server di destinazione dell'operazione.
storageAccountResourceId	string (arm-id)	ID risorsa per l'account di archiviazione usato per archiviare il file BACPAC. Se impostato, verrà creata la connessione all'endpoint privato per l'account di archiviazione. Deve corrispondere all'account di archiviazione usato per il parametro StorageUri.

PrivateEndpointConnectionRequestStatus

Oggetto

Contiene lo stato delle richieste di connessione dell'endpoint privato.

Nome	Tipo	Descrizione
privateEndpointConnectionName	string	Nome della connessione per l'endpoint privato.
privateLinkServiceId	string	ID risorsa per cui viene creato l'endpoint privato.
status	string	Stato di questa connessione endpoint privato.

StorageKeyType

Enumerazione

Tipo di chiave di archiviazione.

Valore	Descrizione
SharedAccessKey
StorageAccessKey

Condividi tramite

Databases - Export

Parametri dell'URI

Corpo della richiesta

Risposte

Esempio

Exports a database, using private link to communicate with SQL server and storage account.

Esempio di richiesta

Risposta di esempio

Exports a database.

Esempio di richiesta

Risposta di esempio

Definizioni

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

ExportDatabaseDefinition

ImportExportOperationResult

NetworkIsolationSettings

PrivateEndpointConnectionRequestStatus

StorageKeyType