Servers - Import Database

Mengimpor bacpac ke database baru.

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

Parameter URI

Nama Dalam Diperlukan Jenis Deskripsi
resourceGroupName
path True

string

minLength: 1
maxLength: 90

Nama grup sumber daya. Nama tidak sensitif terhadap penggunaan huruf besar atau kecil.

serverName
path True

string

Nama server.

subscriptionId
path True

string (uuid)

ID langganan target. Nilainya harus sebuah UUID.

api-version
query True

string

minLength: 1

Versi API yang digunakan untuk operasi ini.

Isi Permintaan

Nama Diperlukan Jenis Deskripsi
administratorLogin True

string

Nama masuk administrator. Jika AuthenticationType adalah ManagedIdentity, bidang ini harus menentukan ID sumber daya Identitas Terkelola.

storageKey True

string

Kunci penyimpanan untuk akun penyimpanan. Jika StorageKeyType adalah ManagedIdentity, bidang ini harus menentukan ID sumber daya Identitas Terkelola.

storageKeyType True

StorageKeyType

Jenis kunci penyimpanan: StorageAccessKey, SharedAccessKey, atau ManagedIdentity.

storageUri True

string

Uri penyimpanan.

administratorLoginPassword

string (password)

Kata sandi masuk administrator. Jika AuthenticationType adalah ManagedIdentity, bidang ini tidak boleh ditentukan.

authenticationType

string

Jenis kredensial yang disediakan untuk akses ke server SQL target: SQL, ADPassword, atau ManagedIdentity.

databaseName

string

Nama database impor.

edition

string

Edisi database impor.

maxSizeBytes

string

Ukuran maksimum dalam byte untuk database impor.

networkIsolation

NetworkIsolationSettings

Informasi sumber daya opsional untuk mengaktifkan isolasi jaringan untuk permintaan.

serviceObjectiveName

string

Nama tujuan tingkat layanan dari database impor.

Respons

Nama Jenis Deskripsi
200 OK

ImportExportOperationResult

Operasi Azure berhasil diselesaikan.

202 Accepted

Operasi sumber daya diterima.

Header

  • Location: string
  • Retry-After: integer
Other Status Codes

ErrorResponse

Respons kesalahan tak terduga.

Keamanan

azure_auth

Alur OAuth2 Azure Active Directory.

Jenis: oauth2
Alur: implicit
URL Otorisasi: https://login.microsoftonline.com/common/oauth2/authorize

Cakupan

Nama Deskripsi
user_impersonation meniru akun pengguna Anda

Contoh

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.

Permintaan sampel

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

Respon sampel

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

Permintaan sampel

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

Respon sampel

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

Permintaan sampel

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

Respon sampel

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

Definisi

Nama Deskripsi
createdByType

Jenis identitas yang membuat sumber daya.

ErrorAdditionalInfo

Info tambahan kesalahan manajemen sumber daya.

ErrorDetail

Detail kesalahan.

ErrorResponse

Tanggapan kesalahan

ImportExportOperationResult

Sumber daya hasil operasi ImportExport.

ImportNewDatabaseDefinition

Berisi informasi yang diperlukan untuk melakukan operasi impor untuk database baru.

NetworkIsolationSettings

Berisi sumber daya ARM untuk membuat koneksi titik akhir privat.

PrivateEndpointConnectionRequestStatus

Berisi status permintaan koneksi titik akhir privat.

StorageKeyType

Jenis kunci penyimpanan: StorageAccessKey, SharedAccessKey atau ManagedIdentity.

systemData

Metadata yang berkaitan dengan pembuatan dan modifikasi terakhir sumber daya.

createdByType

Jenis identitas yang membuat sumber daya.

Nilai Deskripsi
User
Application
ManagedIdentity
Key

ErrorAdditionalInfo

Info tambahan kesalahan manajemen sumber daya.

Nama Jenis Deskripsi
info

object

Info tambahan.

type

string

Jenis info tambahan.

ErrorDetail

Detail kesalahan.

Nama Jenis Deskripsi
additionalInfo

ErrorAdditionalInfo[]

Info tambahan kesalahan.

code

string

Kode kesalahan.

details

ErrorDetail[]

Rincian kesalahan.

message

string

Pesan kesalahan.

target

string

Sasaran kesalahan.

ErrorResponse

Tanggapan kesalahan

Nama Jenis Deskripsi
error

ErrorDetail

Objek kesalahan.

ImportExportOperationResult

Sumber daya hasil operasi ImportExport.

Nama Jenis Deskripsi
id

string (arm-id)

ID sumber daya yang sepenuhnya memenuhi syarat untuk sumber daya. Misalnya "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"

name

string

Nama sumber daya

properties.blobUri

string

Uri Blob.

properties.databaseName

string

Nama database.

properties.errorMessage

string

Pesan kesalahan.

properties.lastModifiedTime

string

Waktu terakhir diubah.

properties.privateEndpointConnections

PrivateEndpointConnectionRequestStatus[]

Mendapatkan status titik akhir privat yang terkait dengan permintaan ini.

properties.queuedTime

string

Waktu antrean.

properties.requestId

string (uuid)

Id Permintaan.

properties.requestType

string

Jenis permintaan.

properties.serverName

string

Nama server.

properties.status

string

Status operasi.

systemData

systemData

Metadata Azure Resource Manager yang berisi informasi createdBy dan modifiedBy.

type

string

Jenis sumber daya. Misalnya "Microsoft. Komputasi/virtualMachines" atau "Microsoft. Akun penyimpanan/penyimpanan"

ImportNewDatabaseDefinition

Berisi informasi yang diperlukan untuk melakukan operasi impor untuk database baru.

Nama Jenis Deskripsi
administratorLogin

string

Nama masuk administrator. Jika AuthenticationType adalah ManagedIdentity, bidang ini harus menentukan ID sumber daya Identitas Terkelola.

administratorLoginPassword

string (password)

Kata sandi masuk administrator. Jika AuthenticationType adalah ManagedIdentity, bidang ini tidak boleh ditentukan.

authenticationType

string

Jenis kredensial yang disediakan untuk akses ke server SQL target: SQL, ADPassword, atau ManagedIdentity.

databaseName

string

Nama database impor.

edition

string

Edisi database impor.

maxSizeBytes

string

Ukuran maksimum dalam byte untuk database impor.

networkIsolation

NetworkIsolationSettings

Informasi sumber daya opsional untuk mengaktifkan isolasi jaringan untuk permintaan.

serviceObjectiveName

string

Nama tujuan tingkat layanan dari database impor.

storageKey

string

Kunci penyimpanan untuk akun penyimpanan. Jika StorageKeyType adalah ManagedIdentity, bidang ini harus menentukan ID sumber daya Identitas Terkelola.

storageKeyType

StorageKeyType

Jenis kunci penyimpanan: StorageAccessKey, SharedAccessKey, atau ManagedIdentity.

storageUri

string

Uri penyimpanan.

NetworkIsolationSettings

Berisi sumber daya ARM untuk membuat koneksi titik akhir privat.

Nama Jenis Deskripsi
sqlServerResourceId

string (arm-id)

Id sumber daya untuk server SQL yang merupakan target permintaan ini. Jika diatur, koneksi titik akhir privat akan dibuat untuk server SQL. Harus cocok dengan server yang merupakan target operasi.

storageAccountResourceId

string (arm-id)

Id sumber daya untuk akun penyimpanan yang digunakan untuk menyimpan file BACPAC. Jika diatur, koneksi titik akhir privat akan dibuat untuk akun penyimpanan. Harus cocok dengan akun penyimpanan yang digunakan untuk parameter StorageUri.

PrivateEndpointConnectionRequestStatus

Berisi status permintaan koneksi titik akhir privat.

Nama Jenis Deskripsi
privateEndpointConnectionName

string

Nama koneksi untuk titik akhir privat.

privateLinkServiceId

string

Id sumber daya tempat titik akhir privat dibuat.

status

string

Status koneksi titik akhir privat ini.

StorageKeyType

Jenis kunci penyimpanan: StorageAccessKey, SharedAccessKey atau ManagedIdentity.

Nilai Deskripsi
SharedAccessKey

KunciAksesBersama

StorageAccessKey

StorageAccessKey

ManagedIdentity

ManagedIdentity

systemData

Metadata yang berkaitan dengan pembuatan dan modifikasi terakhir sumber daya.

Nama Jenis Deskripsi
createdAt

string (date-time)

Tanda waktu pembuatan sumber daya (UTC).

createdBy

string

Identitas yang membuat sumber daya.

createdByType

createdByType

Jenis identitas yang membuat sumber daya.

lastModifiedAt

string (date-time)

Stempel waktu modifikasi terakhir sumber daya (UTC)

lastModifiedBy

string

Identitas yang terakhir mengubah sumber daya.

lastModifiedByType

createdByType

Jenis identitas yang terakhir memodifikasi sumber daya.