Databases - Export

Hizmet:: SQL Database

API Sürümü:: 2023-08-01

Veritabanını dışarı aktarır.

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

URI Parametreleri

Name	İçinde	Gerekli	Tür	Description
databaseName	path	True	string	Veritabanının adı.
resourceGroupName	path	True	string	Kaynağı içeren kaynak grubunun adı. Bu değeri Azure Resource Manager API'sinden veya portaldan alabilirsiniz.
serverName	path	True	string	Sunucunun adı.
subscriptionId	path	True	string	Azure aboneliğini tanımlayan abonelik kimliği.
api-version	query	True	string	İstek için kullanılacak API sürümü.

İstek Gövdesi

Name	Gerekli	Tür	Description
administratorLogin	True	string	Yönetici oturum açma adı.
administratorLoginPassword	True	string	Yönetici oturum açma parolası.
storageKey	True	string	Depolama anahtarı.
storageKeyType	True	StorageKeyType	Depolama anahtarı türü.
storageUri	True	string	Depolama Uri'si.
authenticationType		string	Kimlik doğrulama türü.
networkIsolation		NetworkIsolationSettings	İstek için ağ yalıtımını etkinleştirmek için isteğe bağlı kaynak bilgileri.

Yanıtlar

Name	Tür	Description
200 OK	ImportExportOperationResult	Veritabanı başarıyla dışarı aktarıldı.
202 Accepted		Veritabanını dışarı aktarma işlemi devam ediyor. Üst Bilgiler Location: string
Other Status Codes	ErrorResponse	Hata Yanıtları: *** 400 MissingImportExportInputParameters - ImportExport giriş parametreleri eksik. 400 InvalidImportExportInputParameter - İçeri/dışarı aktarma isteği geçersiz bir giriş parametresi nedeniyle başarısız oldu. 400 PolybaseImportAuthenticationTypeNotSupported - Kimlik doğrulama türü parametresi PolybaseImport işlemi için desteklenmiyor. 400 DatabaseExtensionsInvalidOperationMode - Veritabanı uzantısı için geçersiz operationMode parametresi. 400 DatabaseExtensionsInvalidStorageKeyType - Depolama anahtarı türünün 'StorageAccessKey' ile olması gerekir. 400 DatabaseExtensionsMissingStorageUri - Depolama URI'si boş olamaz. AuthenticationType ManagedIdentity ise 400 SQLPasswordSpecifiedWithManagedIdentity - administratorLoginPassword belirtilmemelidir. 400 InvalidSqlAuthType - Sql kimlik doğrulama türü geçersiz olduğundan ImportExport işlemi başarısız oldu 400 BlobAlreadyExist - Depolama blobu zaten mevcut olduğundan ImportExport işlemi başarısız oldu 400 InvalidImportExportOperationResourceLocks - Özel Bağlantı kaynaklarındaki kilitler nedeniyle İçeri/Dışarı Aktarma isteği geçersiz. 400 DatabaseInvalidSkuPropertyCombination - İstenen sku'nun özellikleri tutarsız. Lütfen geçerli bir bileşimin belirtildiğini denetleyin. Daha fazla bilgi için bkz. https://docs.microsoft.com/en-us/rest/api/sql/capabilities/listbylocation#serviceobjectivecapability. 400 ImportExportJobError - ImportExport işlemi başarısız oldu. 400 BlockedByOutboundFirewall - Giden güvenlik duvarı kuralları isteği engelledi. 400 InvalidOperationType - Geçerli bir işlem türü sağlayın. 400 InvalidMaxSizeTierCombination - Belirtilen katman, belirtilen veritabanı maksimum boyutunu desteklemiyor. 400 InvalidTier - Kullanıcı geçersiz bir katman belirtti. 400 CannotUseReservedDatabaseName - Bu işlemde ayrılmış veritabanı adı kullanılamaz. 400 InvalidImportExportParameter - İçeri/Dışarı Aktarma isteği geçersiz bir giriş parametresi nedeniyle başarısız oldu. 400 InvalidSku - Kullanıcı geçersiz bir sku belirtti. 400 InvalidTierSkuCombination - Belirtilen katman belirtilen sku'yu desteklemiyor. 400 InvalidImportExportStorageCredentials - İçeri/Dışarı Aktarma işlemi geçersiz depolama kimlik bilgileri nedeniyle başarısız oldu 400 InvalidImportExportStorageAuthType - İçeri/Dışarı Aktarma işlemi geçersiz depolama kimlik doğrulaması türünden dolayı başarısız oldu 400 InvalidImportExportStorageKeyFormat - İçeri/Dışarı Aktarma işlemi geçersiz depolama anahtarı biçimi nedeniyle başarısız oldu 400 LongImportExportStorageUri - İçeri/Dışarı Aktarma işlemi uzun depolama URI'sine bağlı olarak başarısız oldu 400 LargeExportDatabaseSize - Veritabanı desteklenen boyut üst sınırından büyük olduğundan dışarı aktarma işlemi başarısız oldu 400 FeatureDisabledOnSelectedEdition - Kullanıcı geçerli veritabanı sürümünde devre dışı bırakılmış bir özelliği kullanmaya çalıştı. 400 UnSupportedImportExportEdition - ImportExport işlemi geçersiz bir sürümü hedeflediğinden başarısız oldu 400 InvalidImportExportStorageURI - Depolama URI'si geçersiz olduğundan ImportExport işlemi başarısız oldu 404 DatabaseDoesNotExist - Kullanıcı bu sunucu örneğinde var olmayan bir veritabanı adı belirtti. 404 ServerNotInSubscription - Belirtilen sunucu belirtilen abonelikte yok. 404 ServerNotInSubscriptionResourceGroup - Belirtilen sunucu belirtilen kaynak grubunda ve abonelikte yok. 404 ResourceNotFound - Mevcut olmayan bir kaynağı belirten geçersiz istek. 404 ImportExportOperationIdNotFound - İçeri veya dışarı aktarma işlemi kimliği bulunamıyor. 404 OperationIdNotFound - Kimliği olan işlem yok. 409 ImportExportOperationInProgress - Veritabanında devam eden bir içeri veya dışarı aktarma işlemi var. 409 CannotCancelOperation - Yönetim işlemi iptal edilemeyen bir durumda. 409 OperationCancelled - İşlem kullanıcı tarafından iptal edildi. 409 İşlem Kesildi - Kaynak üzerindeki işlem, aynı kaynak üzerindeki başka bir işlem tarafından kesildiği için tamamlanamadı. 429 SubscriptionTooManyCreateUpdateRequests - Kullanılabilir kaynaklar tarafından işlenebilen maksimum isteğin ötesindeki istekler. 429 SubscriptionTooManyRequests - Kullanılabilir kaynaklar tarafından işlenebilen maksimum isteğin ötesindeki istekler. 500 OperationTimedOut - İşlem zaman aşımına uğradı ve otomatik olarak geri alındı. Lütfen işlemi yeniden deneyin. 503 TooManyRequests - Kullanılabilir kaynaklar tarafından işlenebilen maksimum isteğin ötesindeki istekler.

Name

Tür

Description

200 OK

ImportExportOperationResult

Veritabanı başarıyla dışarı aktarıldı.

202 Accepted

Veritabanını dışarı aktarma işlemi devam ediyor.

Üst Bilgiler

Location: string

Other Status Codes

ErrorResponse

Hata Yanıtları: ***

400 MissingImportExportInputParameters - ImportExport giriş parametreleri eksik.
400 InvalidImportExportInputParameter - İçeri/dışarı aktarma isteği geçersiz bir giriş parametresi nedeniyle başarısız oldu.
400 PolybaseImportAuthenticationTypeNotSupported - Kimlik doğrulama türü parametresi PolybaseImport işlemi için desteklenmiyor.
400 DatabaseExtensionsInvalidOperationMode - Veritabanı uzantısı için geçersiz operationMode parametresi.
400 DatabaseExtensionsInvalidStorageKeyType - Depolama anahtarı türünün 'StorageAccessKey' ile olması gerekir.
400 DatabaseExtensionsMissingStorageUri - Depolama URI'si boş olamaz.
AuthenticationType ManagedIdentity ise 400 SQLPasswordSpecifiedWithManagedIdentity - administratorLoginPassword belirtilmemelidir.
400 InvalidSqlAuthType - Sql kimlik doğrulama türü geçersiz olduğundan ImportExport işlemi başarısız oldu
400 BlobAlreadyExist - Depolama blobu zaten mevcut olduğundan ImportExport işlemi başarısız oldu
400 InvalidImportExportOperationResourceLocks - Özel Bağlantı kaynaklarındaki kilitler nedeniyle İçeri/Dışarı Aktarma isteği geçersiz.
400 DatabaseInvalidSkuPropertyCombination - İstenen sku'nun özellikleri tutarsız. Lütfen geçerli bir bileşimin belirtildiğini denetleyin. Daha fazla bilgi için bkz. https://docs.microsoft.com/en-us/rest/api/sql/capabilities/listbylocation#serviceobjectivecapability.
400 ImportExportJobError - ImportExport işlemi başarısız oldu.
400 BlockedByOutboundFirewall - Giden güvenlik duvarı kuralları isteği engelledi.
400 InvalidOperationType - Geçerli bir işlem türü sağlayın.
400 InvalidMaxSizeTierCombination - Belirtilen katman, belirtilen veritabanı maksimum boyutunu desteklemiyor.
400 InvalidTier - Kullanıcı geçersiz bir katman belirtti.
400 CannotUseReservedDatabaseName - Bu işlemde ayrılmış veritabanı adı kullanılamaz.
400 InvalidImportExportParameter - İçeri/Dışarı Aktarma isteği geçersiz bir giriş parametresi nedeniyle başarısız oldu.
400 InvalidSku - Kullanıcı geçersiz bir sku belirtti.
400 InvalidTierSkuCombination - Belirtilen katman belirtilen sku'yu desteklemiyor.
400 InvalidImportExportStorageCredentials - İçeri/Dışarı Aktarma işlemi geçersiz depolama kimlik bilgileri nedeniyle başarısız oldu
400 InvalidImportExportStorageAuthType - İçeri/Dışarı Aktarma işlemi geçersiz depolama kimlik doğrulaması türünden dolayı başarısız oldu
400 InvalidImportExportStorageKeyFormat - İçeri/Dışarı Aktarma işlemi geçersiz depolama anahtarı biçimi nedeniyle başarısız oldu
400 LongImportExportStorageUri - İçeri/Dışarı Aktarma işlemi uzun depolama URI'sine bağlı olarak başarısız oldu
400 LargeExportDatabaseSize - Veritabanı desteklenen boyut üst sınırından büyük olduğundan dışarı aktarma işlemi başarısız oldu
400 FeatureDisabledOnSelectedEdition - Kullanıcı geçerli veritabanı sürümünde devre dışı bırakılmış bir özelliği kullanmaya çalıştı.
400 UnSupportedImportExportEdition - ImportExport işlemi geçersiz bir sürümü hedeflediğinden başarısız oldu
400 InvalidImportExportStorageURI - Depolama URI'si geçersiz olduğundan ImportExport işlemi başarısız oldu
404 DatabaseDoesNotExist - Kullanıcı bu sunucu örneğinde var olmayan bir veritabanı adı belirtti.
404 ServerNotInSubscription - Belirtilen sunucu belirtilen abonelikte yok.
404 ServerNotInSubscriptionResourceGroup - Belirtilen sunucu belirtilen kaynak grubunda ve abonelikte yok.
404 ResourceNotFound - Mevcut olmayan bir kaynağı belirten geçersiz istek.
404 ImportExportOperationIdNotFound - İçeri veya dışarı aktarma işlemi kimliği bulunamıyor.
404 OperationIdNotFound - Kimliği olan işlem yok.
409 ImportExportOperationInProgress - Veritabanında devam eden bir içeri veya dışarı aktarma işlemi var.
409 CannotCancelOperation - Yönetim işlemi iptal edilemeyen bir durumda.
409 OperationCancelled - İşlem kullanıcı tarafından iptal edildi.
409 İşlem Kesildi - Kaynak üzerindeki işlem, aynı kaynak üzerindeki başka bir işlem tarafından kesildiği için tamamlanamadı.
429 SubscriptionTooManyCreateUpdateRequests - Kullanılabilir kaynaklar tarafından işlenebilen maksimum isteğin ötesindeki istekler.
429 SubscriptionTooManyRequests - Kullanılabilir kaynaklar tarafından işlenebilen maksimum isteğin ötesindeki istekler.
500 OperationTimedOut - İşlem zaman aşımına uğradı ve otomatik olarak geri alındı. Lütfen işlemi yeniden deneyin.
503 TooManyRequests - Kullanılabilir kaynaklar tarafından işlenebilen maksimum isteğin ötesindeki istekler.

Örnekler

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.

Örnek isteği

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

Örnek yanıt

Durum kodu:: 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"
}

Durum kodu:: 202

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

Exports a database.

Örnek isteği

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

Örnek yanıt

Durum kodu:: 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"
}

Durum kodu:: 202

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

Tanımlar

Name	Description
ErrorAdditionalInfo	Kaynak yönetimi hatası ek bilgileri.
ErrorDetail	Hata ayrıntısı.
ErrorResponse	Hata yanıtı
ExportDatabaseDefinition	Dışarı aktarma veritabanı işlemini gerçekleştirmek için gereken bilgileri içerir.
ImportExportOperationResult	ImportExport işlemi sonuç kaynağı.
NetworkIsolationSettings	Özel uç nokta bağlantısı oluşturulacak ARM kaynaklarını içerir.
PrivateEndpointConnectionRequestStatus	Özel uç nokta bağlantı istekleri durumunu içerir.
StorageKeyType	Depolama anahtarı türü.

ErrorAdditionalInfo

Nesne

Kaynak yönetimi hatası ek bilgileri.

Name	Tür	Description
info	object	Ek bilgiler.
type	string	Ek bilgi türü.

ErrorDetail

Nesne

Hata ayrıntısı.

Name	Tür	Description
additionalInfo	ErrorAdditionalInfo[]	Hata ek bilgileri.
code	string	Hata kodu.
details	ErrorDetail[]	Hata ayrıntıları.
message	string	Hata iletisi.
target	string	Hata hedefi.

ErrorResponse

Nesne

Hata yanıtı

Name	Tür	Description
error	ErrorDetail	Hata nesnesi.

ExportDatabaseDefinition

Nesne

Dışarı aktarma veritabanı işlemini gerçekleştirmek için gereken bilgileri içerir.

Name	Tür	Description
administratorLogin	string	Yönetici oturum açma adı.
administratorLoginPassword	string	Yönetici oturum açma parolası.
authenticationType	string	Kimlik doğrulama türü.
networkIsolation	NetworkIsolationSettings	İstek için ağ yalıtımını etkinleştirmek için isteğe bağlı kaynak bilgileri.
storageKey	string	Depolama anahtarı.
storageKeyType	StorageKeyType	Depolama anahtarı türü.
storageUri	string	Depolama Uri'si.

ImportExportOperationResult

Nesne

ImportExport işlemi sonuç kaynağı.

Name	Tür	Description
id	string	Kaynak Kimliği.
name	string	Kaynak adı.
properties.blobUri	string	Blob Uri'si.
properties.databaseName	string	Veritabanı adı.
properties.errorMessage	string	Hata mesajı.
properties.lastModifiedTime	string	Son değiştirme zamanı.
properties.privateEndpointConnections	PrivateEndpointConnectionRequestStatus[]	Bu istekle ilişkili özel uç noktaların durumunu alır.
properties.queuedTime	string	Kuyruğa alınan süre.
properties.requestId	string (uuid)	İstek Kimliği.
properties.requestType	string	İstek türü.
properties.serverName	string	Sunucu adı.
properties.status	string	İşlem durumu.
type	string	Kaynak türü.

NetworkIsolationSettings

Nesne

Özel uç nokta bağlantısı oluşturulacak ARM kaynaklarını içerir.

Name	Tür	Description
sqlServerResourceId	string (arm-id)	Bu isteğin hedefi olan SQL sunucusunun kaynak kimliği. Ayarlanırsa, SQL sunucusu için özel uç nokta bağlantısı oluşturulur. İşlemin hedefi olan sunucuyla eşleşmelidir.
storageAccountResourceId	string (arm-id)	BACPAC dosyasını depolamak için kullanılan depolama hesabının kaynak kimliği. Ayarlanırsa, depolama hesabı için özel uç nokta bağlantısı oluşturulur. StorageUri parametresi için kullanılan depolama hesabıyla eşleşmelidir.

PrivateEndpointConnectionRequestStatus

Nesne

Özel uç nokta bağlantı istekleri durumunu içerir.

Name	Tür	Description
privateEndpointConnectionName	string	Özel uç noktanın bağlantı adı.
privateLinkServiceId	string	Özel uç noktanın oluşturulduğu kaynak kimliği.
status	string	Bu özel uç nokta bağlantısının durumu.

StorageKeyType

Numaralandırma

Depolama anahtarı türü.

Değer	Description
SharedAccessKey
StorageAccessKey

Aracılığıyla paylaş

Databases - Export

URI Parametreleri

İstek Gövdesi

Yanıtlar

Örnekler

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

Örnek isteği

Örnek yanıt

Exports a database.

Örnek isteği

Örnek yanıt

Tanımlar

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

ExportDatabaseDefinition

ImportExportOperationResult

NetworkIsolationSettings

PrivateEndpointConnectionRequestStatus

StorageKeyType