Managed Databases - Create Or Update

Service:

SQL Database

API Version:

2021-11-01

Membuat database atau pembaruan baru database yang ada.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/managedInstances/{managedInstanceName}/databases/{databaseName}?api-version=2021-11-01

Parameter URI

Nama	Dalam	Diperlukan	Jenis	Deskripsi
databaseName	path	True	string	Nama database.
managedInstanceName	path	True	string	Nama instans terkelola.
resourceGroupName	path	True	string	Nama grup sumber daya yang berisi sumber daya. Anda dapat memperoleh nilai ini dari Azure Resource Manager API atau portal.
subscriptionId	path	True	string	ID langganan yang mengidentifikasi langganan Azure.
api-version	query	True	string	Versi API yang digunakan untuk permintaan.

Isi Permintaan

Nama	Diperlukan	Jenis	Deskripsi
location	True	string	Lokasi sumber daya.
properties.autoCompleteRestore		boolean	Apakah akan menyelesaikan pemulihan otomatis database terkelola ini.
properties.catalogCollation		CatalogCollationType	Kolate katalog metadata.
properties.collation		string	Kolae database terkelola.
properties.createMode		ManagedDatabaseCreateMode	Mode pembuatan database terkelola. PointInTimeRestore: Buat database dengan memulihkan cadangan titik waktu database yang sudah ada. SourceDatabaseName, SourceManagedInstanceName, dan PointInTime harus ditentukan. RestoreExternalBackup: Buat database dengan memulihkan dari file cadangan eksternal. Kolase, StorageContainerUri, dan StorageContainerSasToken harus ditentukan. Pemulihan: Membuat database dengan memulihkan cadangan yang direplikasi secara geografis. RecoverableDatabaseId harus ditentukan sebagai ID sumber daya database yang dapat dipulihkan untuk dipulihkan. RestoreLongTermRetentionBackup: Buat database dengan memulihkan dari cadangan retensi jangka panjang (longTermRetentionBackupResourceId diperlukan).
properties.lastBackupName		string	Nama file cadangan terakhir untuk pemulihan database terkelola ini.
properties.longTermRetentionBackupResourceId		string	Nama cadangan Retensi Jangka Panjang yang akan digunakan untuk pemulihan database terkelola ini.
properties.recoverableDatabaseId		string	Pengidentifikasi sumber daya database yang dapat dipulihkan yang terkait dengan operasi pembuatan database ini.
properties.restorableDroppedDatabaseId		string	Id sumber daya database yang dihilangkan yang dapat dipulihkan untuk dipulihkan saat membuat database ini.
properties.restorePointInTime		string	Bersyarat. Jika createMode adalah PointInTimeRestore, nilai ini diperlukan. Menentukan titik waktu (ISO8601 format) database sumber yang akan dipulihkan untuk membuat database baru.
properties.sourceDatabaseId		string	Pengidentifikasi sumber daya database sumber yang terkait dengan operasi pembuatan database ini.
properties.storageContainerSasToken		string	Bersyarat. Jika createMode adalah RestoreExternalBackup, nilai ini diperlukan. Menentukan token sas kontainer penyimpanan.
properties.storageContainerUri		string	Bersyarat. Jika createMode adalah RestoreExternalBackup, nilai ini diperlukan. Menentukan uri kontainer penyimpanan tempat cadangan untuk pemulihan ini disimpan.
tags		object	Tag sumber daya.

Respons

Nama	Jenis	Deskripsi
200 OK	ManagedDatabase	Berhasil memperbarui database.
201 Created	ManagedDatabase	Berhasil membuat database.
202 Accepted		Diterima
Other Status Codes		Respons Kesalahan: *** 400 PitrPointInTimeInvalid - Titik waktu {0} tidak valid. Titik waktu yang valid berkisar dari {1} hari-hari dini hingga sekarang dan bukan sebelum waktu pembuatan server sumber. 400 CannotUseTrailingWhitespacesInDatabaseName - Validasi nama database gagal. 400 StorageAccountFull - Instans Terkelola telah mencapai total kapasitas akun penyimpanan Azure yang mendasar. Akun Azure Premium Storage dibatasi hingga 35 TB ruang yang dialokasikan. 400 AkvHostNotResolvingFromNode - Host AKV '{0}' tidak dapat diselesaikan dari SQL, di server '{1}'. 400 InvalidBackupRetentionPeriod - Hari retensi {0} bukan konfigurasi yang valid. Retensi cadangan yang valid dalam hari harus antara {1} dan {2} 400 ManagedDatabaseNameInUse - Database '{0}' sudah ada. Pilih database yang berbeda. 400 NoMoreSpaceInManagedInstance - Instans terkelola telah mencapai batas penyimpanannya. Penggunaan penyimpanan untuk instans terkelola tidak boleh melebihi (%d) MB. 400 ManagedInstanceUpdateSloInProgress - "Operasi tidak dapat diselesaikan karena perubahan tingkat layanan sedang berlangsung untuk instans terkelola '{0}.' Silakan tunggu hingga operasi yang sedang berlangsung selesai, lalu coba kembali." 400 SameKeyMaterialNotFoundOnRemoteServer - Server sekunder tidak memiliki materi kunci pelindung enkripsi server utama. 400 SourceDatabaseNotFound - Database sumber tidak ada. 400 RegionDoesNotSupportVersion - Pengguna mencoba membuat server dari versi tertentu di lokasi di mana versi server tersebut tidak didukung. 400 PasswordNotComplex - Kata sandi yang disediakan tidak cukup kompleks. 400 CannotUseReservedDatabaseName - Tidak dapat menggunakan nama database yang dipesan dalam operasi ini. 400 InvalidServerName - Nama server yang ditentukan tidak valid. 400 SourceServerNotFound - Bagian server dari id database sumber yang disediakan dalam panggilan API CreateDatabaseAsCopy tidak memetakan ke server yang ada. 400 TokenTooLong - Token yang disediakan terlalu panjang. 400 CurrentDatabaseSizeExceedsMaxSize - Pengguna mencoba mengurangi ukuran maksimum untuk database ke ukuran yang lebih kecil dari penggunaan saat ini. 400 InvalidCollation - Kolaset tidak dikenali oleh server. 400 AkvEndpointNotReachableFromNode - Titik akhir AKV '{0}' tidak dapat dijangkau dari SQL, di server '{1}'. 400 ServerNotFound - Server yang diminta tidak ditemukan. 400 UnsupportedServiceName - Nama yang ditentukan adalah nama yang tidak valid karena berisi satu atau beberapa karakter unicode yang tidak didukung. 400 CurrentDatabaseLogSizeExceedsMaxSize - Pengguna mencoba mengubah database ke sku dengan ukuran log maks yang lebih rendah daripada penggunaan saat ini. 400 DatabaseNumberLimitReached - Jumlah maksimum database untuk SQL Database Managed Instance tercapai. 400 InvalidDatabaseCreateOrUpdateRequest - Isi permintaan untuk operasi buat atau perbarui database tidak valid. 400 InvalidResourceId - Pengidentifikasi sumber daya tidak valid. 400 InvalidSourceDatabaseId - Pengidentifikasi database sumber tidak valid. 400 InvalidRestorableDroppedDatabaseId - Pengidentifikasi database yang tidak dapat dipulihkan yang tidak valid 400 MismatchingResourceGroupNameWithUrl - Nama grup sumber daya yang disediakan tidak cocok dengan nama di Url. 400 MismatchingServerNameWithUrl - Nama server yang disediakan tidak cocok dengan nama di Url. 400 MismatchingSubscriptionWithUrl - Langganan yang disediakan tidak cocok dengan langganan di Url. 400 MissingCollation - Kolabasi diperlukan. 400 MissingSourceDatabaseId - Pengidentifikasi database sumber hilang. 400 MissingRestorePointInTime - Titik pemulihan yang hilang tepat waktu 400 MissingStorageContainerSasToken - Token SAS kontainer penyimpanan hilang 400 MissingStorageContainerUri - URI kontainer penyimpanan hilang 400 RestorableDroppedDatabaseIdGivenForRestoreWithSourceDatabaseId - Tidak dapat menentukan restorableDroppedDatabaseId ketika sourceDatabaseId sudah diberikan dalam mode buat pemulihan 400 CannotUseReservedDatabaseName - Tidak dapat menggunakan nama database yang dipesan dalam operasi ini. 400 InvalidLongTermRetentionManagedInstanceBackupId - Pengidentifikasi cadangan retensi jangka panjang tidak valid untuk Instans Terkelola. 400 MiGeoRestoreWithWrongBackupStorageRedundancy - Geo-Restore tidak diizinkan untuk instans terkelola dengan redundansi penyimpanan cadangan LRS/ZRS. 400 UpdatingInstanceAndBackupRedundancy - Redundansi zona instans dan redundansi penyimpanan cadangan tidak dapat diperbarui dalam permintaan yang sama. 400 ProvisioningDisabled - Menampilkan pesan kesalahan dari otorisasi operasi sumber daya apa adanya, tanpa perubahan 400 AadOnlyAuthenticationIsEnabled - Autentikasi Khusus Azure Active Directory diaktifkan. Silakan hubungi administrator sistem Anda. 400 ManagementServiceFeatureDisabled - Pengguna mencoba menggunakan fitur yang dinonaktifkan. 400 TargetServerDoesNotExist - Server {0} target belum ada atau belum siap. Silakan periksa apakah ada dan coba lagi permintaan pemulihan. 400 TargetServerRestoreNotAllowed - Server {0} target saat ini tidak dalam keadaan yang memungkinkan pemulihan dimulai. 400 BackupSetNotFound - Tidak ada cadangan yang ditemukan untuk memulihkan database. Silakan hubungi dukungan untuk memulihkan database. 400 FullBackupNotFound - Pencadangan penuh tidak dapat ditemukan. 400 MissingThumbprint - Tidak dapat menemukan sertifikat server. 400 RestoreFromStripedBackupsNotEnabled - Memulihkan dari cadangan bergaris tidak didukung. 400 BackupSetBroken - Kumpulan cadangan rusak. 400 BrokenRestorePlanNoFullBackup - Rencana pemulihan rusak karena tidak ada pencadangan penuh. 400 SqlRestoreError - Terjadi kesalahan tidak dapat dicoba kembali saat memulihkan cadangan dengan indeks {0} - {1}{2} 400 BrokenRestorePlanWrongLogBackupLSN - Rencana pemulihan rusak karena firstLsn dari cadangan log saat ini tidak <= lastLsn dari cadangan log berikutnya. 400 BrokenRestorePlanWrongDiffBackupLSN - Rencana pemulihan rusak karena firstLsn dari cadangan diff tidak >= firstLsn dari pencadangan penuh. 400 BrokenRestorePlanGapInLogBackups - Rencana pemulihan rusak karena firstLsn dari cadangan log saat ini tidak sama dengan lastLsn cadangan log sebelumnya. 400 PartiallyContainedDatabaseUnsupported - "Pencadangan untuk database yang sebagian berisi tidak didukung." 400 RequiredBackupIsNotLastRestored - Migrasi tidak dapat diselesaikan karena nama file cadangan yang disediakan bukan nama file cadangan terakhir yang dipulihkan. 400 XtpInitializedDuringRestore - Grup file yang dioptimalkan memori harus kosong agar dapat dipulihkan pada tingkat Tujuan Umum SQL Database Managed Instance. 400 FullBackupMissingChecksum - Pencadangan penuh yang disediakan tidak memiliki checksum. 400 FullBackupDamaged - Pencadangan penuh yang disediakan rusak. 400 MissingStripeInBackupSet - Set cadangan yang disediakan memiliki satu atau beberapa garis yang hilang. 400 BrokenRestorePlanWrongDiffBaseGUID - Rencana pemulihan rusak karena DifferentialBaseGuid dari cadangan diff tidak cocok dengan BackupSetGuid dari pencadangan penuh. 400 IncompatiblePhysicalLayoutTooFewDataFiles - Cadangan database berisi tata letak fisik yang tidak kompatibel. Tidak ada file data yang ditemukan dalam cadangan. 400 CorruptedPagesInBackupSet - Operasi dibatalkan karena RESTORE mendeteksi satu atau beberapa halaman yang rusak dalam kumpulan cadangan. 400 IncompatiblePhysicalLayoutNonOnlineDataFilesExist - Cadangan database berisi tata letak fisik yang tidak kompatibel. Ada file data non-online. 400 CorruptedPagesListMaintenance - Operasi dibatalkan karena terjadi kesalahan internal saat memproses cadangan yang diambil tanpa checksum. 400 IncompatiblePhysicalLayoutWrongNumberOfLogFiles - Cadangan database berisi tata letak fisik yang tidak kompatibel. Beberapa file log tidak didukung. 400 IncompatiblePhysicalLayoutNonOnlineLogFilesExist - Cadangan database berisi tata letak fisik yang tidak kompatibel. Ada file log non-online. 400 IncompatiblePhysicalLayoutTooManyNonDataLogFiles - Cadangan database berisi tata letak fisik yang tidak kompatibel. Terlalu banyak file non-data/log. 400 ExternalBackupAlreadySignaledToComplete - Permintaan pemulihan telah disinyalkan selesai. 400 ExternalBackupRestoreHasNotBeenStarted - Permintaan pemulihan hanya dapat diselesaikan setelah pemulihan dimulai. 400 ExternalBackupUpgradeInProgress - Permintaan pemulihan tidak dapat diselesaikan, karena peningkatan sedang berlangsung. 400 IncompatiblePhysicalLayoutTooManyXTPFiles - Cadangan database berisi tata letak fisik yang tidak kompatibel. Beberapa file ditemukan dalam grup file yang berisi MEMORY_OPTIMIZED_DATA. 400 BlobStorageFailure - Kegagalan penyimpanan blob telah terjadi. 400 BackupsFromMultipleDatabasesDetectedInTheContainerFromTheStart - Ada cadangan dari beberapa database di folder kontainer. Pastikan folder kontainer memiliki cadangan dari satu database.{0} 400 ManagedIdentityIssueDetectedFromTheStart - Identitas terkelola tidak disiapkan dengan benar. Harap verifikasi dan coba lagi. 400 ManagedInstanceStorageLimitHit - Instans terkelola telah mencapai batas penyimpanannya. 400 AutoCompleteMissingLastBackupName - Permintaan pemulihan lengkapi otomatis harus memiliki parameter lastBackupName yang disediakan. 400 BlobStorageServerFailure - Kegagalan server penyimpanan blob telah terjadi. 400 BackupsFromMultipleDatabasesDetectedInTheContainerWhileRestoreInProgress - Ada cadangan dari beberapa database di folder kontainer. Pastikan folder kontainer memiliki cadangan dari satu database.{0} 400 ManagedIdentityIssueDetectedWhileRestoreInProgress - Identitas terkelola tidak disiapkan dengan benar. Harap verifikasi dan coba lagi. 404 SubscriptionDoesNotHaveServer - Server yang diminta tidak ditemukan 404 ServerNotInSubscriptionResourceGroup - Server yang ditentukan tidak ada di grup sumber daya dan langganan yang ditentukan. 404 ResourceNotFound - Sumber daya yang diminta tidak ditemukan. 404 CannotFindServerCertificateWithThumbprint - Tidak dapat menemukan sertifikat server dengan thumbprint '{0}'. Silakan gunakan Cmdlet PowerShell 'Add-AzureRmSqlManagedInstanceTransparentDataEncryptionCertificate' untuk membuat sertifikat. 404 CannotFindObject - Tidak dapat menemukan objek karena tidak ada atau Anda tidak memiliki izin 404 SubscriptionNotFound - Langganan yang diminta tidak ditemukan. 404 DatabaseDoesNotExist - Pengguna telah menentukan nama database yang tidak ada pada instans server ini. 404 ServerNotInSubscription - Server yang ditentukan tidak ada pada langganan yang ditentukan. 404 RestoreSourceDatabaseNotFound - Tidak dapat menemukan database '{0}' pada saat '{1}' yang dapat dipulihkan. 404 ServerNotInSubscriptionResourceGroup - Server yang ditentukan tidak ada di grup sumber daya dan langganan yang ditentukan. 409 RemoteDatabaseExists - Nama database tujuan sudah ada di server tujuan. 409 ConflictingDatabaseOperation - Sudah ada beberapa operasi pada database dan operasi saat ini harus menunggu sampai selesai. 409 SubscriptionDisabled - Langganan dinonaktifkan. 409 ManagementServiceDatabaseBusy - Database '{0}' sibuk dengan operasi lain. Silakan coba operasi Anda nanti. 409 ConflictingSystemOperationInProgress - Operasi pemeliharaan sistem sedang berlangsung pada database dan operasi lebih lanjut perlu menunggu sampai selesai. 409 ConflictingManagedInstanceOperation - Operasi saat ini sedang berlangsung untuk instans terkelola. 409 BackupRedundancyUpdateAndInstanceRedundancyConflict - Instansnya multi-az tetapi penyimpanan cadangan sedang diperbarui dari zona redundan ke redundansi non-zona. 409 InstanceRedundancyUpdateWhileBackupRedundancyUpdateInProgress - Tidak dapat memperbarui redundansi instans karena pembaruan redundansi penyimpanan cadangan sedang berlangsung. 409 InstanceRedundancyUpdateAndBackupRedundancyConflict - Penyimpanan cadangan adalah redundan non-zona tetapi redundansi instans sedang diperbarui ke zona redundan. 409 BackupRedundancyUpdateConflict - Tidak dapat memperbarui redundansi penyimpanan cadangan karena pembaruan redundansi penyimpanan cadangan sudah berlangsung. 409 MiDropFailedOnAuthLocks - Pengguna mencoba menghilangkan Instans Terkelola terakhir di subnet yang telah Mengunci yang diterapkan pada sumber daya. 409 MiCreateFailedNonDelegatedSubnet - Pengguna mencoba menyebarkan Instans Terkelola atau kumpulan Instans Terkelola di subnet yang tidak didelegasikan ke Microsoft.Sql/managedInstances. 412 InstanceNotReadyForBackupRedundancyUpdate - Tidak dapat memperbarui redundansi penyimpanan cadangan karena instans belum siap. 429 SubscriptionTooManyCreateUpdateRequests - Permintaan di luar permintaan maks yang dapat diproses oleh sumber daya yang tersedia. 429 SubscriptionTooManyRequests - Permintaan di luar permintaan maks yang dapat diproses oleh sumber daya yang tersedia. 429 SubscriptionTooManyCreateUpdateRequests - Permintaan di luar permintaan maks yang dapat diproses oleh sumber daya yang tersedia. 429 SubscriptionTooManyRequests - Permintaan di luar permintaan maks yang dapat diproses oleh sumber daya yang tersedia. 429 ConflictingSubscriptionOperation - Operasi saat ini sedang berlangsung untuk langganan. 500 ActivateOrDeactivateWorkflowThrottling - Alur kerja aktivasi atau penonaktifan gagal karena terlalu banyak alur kerja bersamaan 503 DatabaseUnavailable - Operasi gagal karena database tidak tersedia. 503 TooManyRequests - Permintaan di luar permintaan maks yang dapat diproses oleh sumber daya yang tersedia. 503 TooManyRequests - Permintaan di luar permintaan maks yang dapat diproses oleh sumber daya yang tersedia. 504 RequestTimeout - Permintaan layanan melebihi batas waktu yang diizinkan. 504 RequestTimeout - Permintaan layanan melebihi batas waktu yang diizinkan.

Contoh

Creates a new managed database by restoring from an external backup

Creates a new managed database from restoring a geo-replicated backup

Creates a new managed database from restoring a long term retention backup

Creates a new managed database using point in time restore

Creates a new managed database with maximal properties

Creates a new managed database with minimal properties

Creates a new managed database by restoring from an external backup

Sample Request

HTTP

PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/managedInstances/managedInstance/databases/managedDatabase?api-version=2021-11-01

{
  "properties": {
    "createMode": "RestoreExternalBackup",
    "storageContainerUri": "https://myaccountname.blob.core.windows.net/backups",
    "storageContainerSasToken": "sv=2015-12-11&sr=c&sp=rl&sig=1234",
    "collation": "SQL_Latin1_General_CP1_CI_AS",
    "autoCompleteRestore": true,
    "lastBackupName": "last_backup_name"
  },
  "location": "southeastasia"
}

Java

import com.azure.core.util.Context;
import com.azure.resourcemanager.sql.fluent.models.ManagedDatabaseInner;
import com.azure.resourcemanager.sql.models.ManagedDatabaseCreateMode;
import java.util.HashMap;
import java.util.Map;

/** Samples for ManagedDatabases CreateOrUpdate. */
public final class Main {
    /*
     * x-ms-original-file: specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/
     * ManagedDatabaseCreateRestoreExternalBackup.json
     */
    /**
     * Sample code: Creates a new managed database by restoring from an external backup.
     *
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void createsANewManagedDatabaseByRestoringFromAnExternalBackup(
        com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getManagedDatabases().createOrUpdate("Default-SQL-SouthEastAsia",
            "managedInstance", "managedDatabase",
            new ManagedDatabaseInner().withLocation("southeastasia").withCollation("SQL_Latin1_General_CP1_CI_AS")
                .withCreateMode(ManagedDatabaseCreateMode.RESTORE_EXTERNAL_BACKUP)
                .withStorageContainerUri("https://myaccountname.blob.core.windows.net/backups")
                .withStorageContainerSasToken("fakeTokenPlaceholder").withAutoCompleteRestore(true)
                .withLastBackupName("last_backup_name"),
            Context.NONE);
    }

    @SuppressWarnings("unchecked")
    private static <T> Map<String, T> mapOf(Object... inputs) {
        Map<String, T> map = new HashMap<>();
        for (int i = 0; i < inputs.length; i += 2) {
            String key = (String) inputs[i];
            T value = (T) inputs[i + 1];
            map.put(key, value);
        }
        return map;
    }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Sample Response

Status code:

200

{
  "tags": {
    "tagKey1": "TagValue1"
  },
  "location": "southeastasia",
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/managedInstances/testsvr/databases/testdb1",
  "name": "testdb1",
  "properties": {
    "collation": "SQL_Latin1_General_CP1_CI_AS",
    "status": "Online",
    "creationDate": "2017-06-07T04:41:33.937Z",
    "defaultSecondaryLocation": "North Europe"
  },
  "type": "Microsoft.Sql/managedInstances/databases"
}

Status code:

201

{
  "tags": {
    "tagKey1": "TagValue1"
  },
  "location": "southeastasia",
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/managedInstances/testsvr/databases/testdb2",
  "name": "testdb2",
  "properties": {
    "collation": "SQL_Latin1_General_CP1_CI_AS",
    "status": "Online",
    "creationDate": "2017-06-07T04:41:33.937Z",
    "defaultSecondaryLocation": "North Europe"
  },
  "type": "Microsoft.Sql/managedInstances/databases"
}

Status code:

202

Creates a new managed database from restoring a geo-replicated backup

Sample Request

HTTP

PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/managedInstances/server1/databases/testdb_recovered?api-version=2021-11-01

{
  "location": "southeastasia",
  "properties": {
    "createMode": "Recovery",
    "recoverableDatabaseId": "/subscriptions/11111111-2222-3333-4444-555555555555/resourceGroups/Default-SQL-WestEurope/providers/Microsoft.Sql/managedInstances/testsvr/recoverableDatabases/testdb"
  }
}

Java

import com.azure.core.util.Context;
import com.azure.resourcemanager.sql.fluent.models.ManagedDatabaseInner;
import com.azure.resourcemanager.sql.models.ManagedDatabaseCreateMode;
import java.util.HashMap;
import java.util.Map;

/** Samples for ManagedDatabases CreateOrUpdate. */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/ManagedDatabaseCreateRecovery.json
     */
    /**
     * Sample code: Creates a new managed database from restoring a geo-replicated backup.
     *
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void createsANewManagedDatabaseFromRestoringAGeoReplicatedBackup(
        com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getManagedDatabases().createOrUpdate("Default-SQL-SouthEastAsia",
            "server1", "testdb_recovered",
            new ManagedDatabaseInner().withLocation("southeastasia").withCreateMode(ManagedDatabaseCreateMode.RECOVERY)
                .withRecoverableDatabaseId(
                    "/subscriptions/11111111-2222-3333-4444-555555555555/resourceGroups/Default-SQL-WestEurope/providers/Microsoft.Sql/managedInstances/testsvr/recoverableDatabases/testdb"),
            Context.NONE);
    }

    @SuppressWarnings("unchecked")
    private static <T> Map<String, T> mapOf(Object... inputs) {
        Map<String, T> map = new HashMap<>();
        for (int i = 0; i < inputs.length; i += 2) {
            String key = (String) inputs[i];
            T value = (T) inputs[i + 1];
            map.put(key, value);
        }
        return map;
    }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Sample Response

Status code:

200

{
  "tags": {
    "tagKey1": "TagValue1"
  },
  "location": "southeastasia",
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/managedInstances/server1/recoverableDatabases/testdb_recovered",
  "name": "testdb_recovered",
  "properties": {
    "collation": "SQL_Latin1_General_CP1_CI_AS",
    "status": "Online",
    "creationDate": "2018-11-07T04:41:33.937Z"
  },
  "type": "Microsoft.Sql/managedInstances/databases"
}

Status code:

201

{
  "tags": {
    "tagKey1": "TagValue1"
  },
  "location": "southeastasia",
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/managedInstances/testsvr/recoverableDatabases/testdb_recovered",
  "name": "testdb_recovered",
  "properties": {
    "collation": "SQL_Latin1_General_CP1_CI_AS",
    "status": "Online",
    "creationDate": "2018-11-07T04:41:33.937Z"
  },
  "type": "Microsoft.Sql/managedInstances/databases"
}

Status code:

202

Creates a new managed database from restoring a long term retention backup

Sample Request

HTTP

PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/managedInstances/managedInstance/databases/managedDatabase?api-version=2021-11-01

{
  "properties": {
    "createMode": "RestoreExternalBackup",
    "storageContainerUri": "https://myaccountname.blob.core.windows.net/backups",
    "storageContainerSasToken": "sv=2015-12-11&sr=c&sp=rl&sig=1234",
    "collation": "SQL_Latin1_General_CP1_CI_AS"
  },
  "location": "southeastasia"
}

Java

import com.azure.core.util.Context;
import com.azure.resourcemanager.sql.fluent.models.ManagedDatabaseInner;
import com.azure.resourcemanager.sql.models.ManagedDatabaseCreateMode;
import java.util.HashMap;
import java.util.Map;

/** Samples for ManagedDatabases CreateOrUpdate. */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/ManagedDatabaseCreateRestoreLtrBackup
     * .json
     */
    /**
     * Sample code: Creates a new managed database from restoring a long term retention backup.
     *
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void createsANewManagedDatabaseFromRestoringALongTermRetentionBackup(
        com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getManagedDatabases().createOrUpdate("Default-SQL-SouthEastAsia",
            "managedInstance", "managedDatabase",
            new ManagedDatabaseInner().withLocation("southeastasia").withCollation("SQL_Latin1_General_CP1_CI_AS")
                .withCreateMode(ManagedDatabaseCreateMode.RESTORE_EXTERNAL_BACKUP)
                .withStorageContainerUri("https://myaccountname.blob.core.windows.net/backups")
                .withStorageContainerSasToken("fakeTokenPlaceholder"),
            Context.NONE);
    }

    @SuppressWarnings("unchecked")
    private static <T> Map<String, T> mapOf(Object... inputs) {
        Map<String, T> map = new HashMap<>();
        for (int i = 0; i < inputs.length; i += 2) {
            String key = (String) inputs[i];
            T value = (T) inputs[i + 1];
            map.put(key, value);
        }
        return map;
    }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Sample Response

Status code:

200

{
  "tags": {
    "tagKey1": "TagValue1"
  },
  "location": "southeastasia",
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/managedInstances/testsvr/databases/testdb1",
  "name": "testdb1",
  "properties": {
    "collation": "SQL_Latin1_General_CP1_CI_AS",
    "status": "Online",
    "creationDate": "2017-06-07T04:41:33.937Z",
    "defaultSecondaryLocation": "North Europe"
  },
  "type": "Microsoft.Sql/managedInstances/databases"
}

Status code:

201

{
  "tags": {
    "tagKey1": "TagValue1"
  },
  "location": "southeastasia",
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/managedInstances/testsvr/databases/testdb2",
  "name": "testdb2",
  "properties": {
    "collation": "SQL_Latin1_General_CP1_CI_AS",
    "status": "Online",
    "creationDate": "2017-06-07T04:41:33.937Z",
    "defaultSecondaryLocation": "North Europe"
  },
  "type": "Microsoft.Sql/managedInstances/databases"
}

Status code:

202

Creates a new managed database using point in time restore

Sample Request

HTTP

PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/managedInstances/managedInstance/databases/managedDatabase?api-version=2021-11-01

{
  "location": "southeastasia",
  "properties": {
    "createMode": "PointInTimeRestore",
    "sourceDatabaseId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/managedInstances/testsvr/databases/testdb",
    "restorePointInTime": "2017-07-14T05:35:31.503Z"
  }
}

Java

import com.azure.core.util.Context;
import com.azure.resourcemanager.sql.fluent.models.ManagedDatabaseInner;
import com.azure.resourcemanager.sql.models.ManagedDatabaseCreateMode;
import java.time.OffsetDateTime;
import java.util.HashMap;
import java.util.Map;

/** Samples for ManagedDatabases CreateOrUpdate. */
public final class Main {
    /*
     * x-ms-original-file: specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/
     * ManagedDatabaseCreatePointInTimeRestore.json
     */
    /**
     * Sample code: Creates a new managed database using point in time restore.
     *
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void
        createsANewManagedDatabaseUsingPointInTimeRestore(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getManagedDatabases().createOrUpdate("Default-SQL-SouthEastAsia",
            "managedInstance", "managedDatabase",
            new ManagedDatabaseInner().withLocation("southeastasia")
                .withRestorePointInTime(OffsetDateTime.parse("2017-07-14T05:35:31.503Z"))
                .withCreateMode(ManagedDatabaseCreateMode.POINT_IN_TIME_RESTORE).withSourceDatabaseId(
                    "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/managedInstances/testsvr/databases/testdb"),
            Context.NONE);
    }

    @SuppressWarnings("unchecked")
    private static <T> Map<String, T> mapOf(Object... inputs) {
        Map<String, T> map = new HashMap<>();
        for (int i = 0; i < inputs.length; i += 2) {
            String key = (String) inputs[i];
            T value = (T) inputs[i + 1];
            map.put(key, value);
        }
        return map;
    }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Sample Response

Status code:

200

{
  "tags": {
    "tagKey1": "TagValue1"
  },
  "location": "southeastasia",
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/managedInstances/testsvr/databases/testdb1",
  "name": "testdb1",
  "properties": {
    "collation": "SQL_Latin1_General_CP1_CI_AS",
    "status": "Online",
    "creationDate": "2017-06-07T04:41:33.937Z",
    "defaultSecondaryLocation": "North Europe"
  },
  "type": "Microsoft.Sql/managedInstances/databases"
}

Status code:

201

{
  "tags": {
    "tagKey1": "TagValue1"
  },
  "location": "southeastasia",
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/managedInstances/testsvr/databases/testdb2",
  "name": "testdb2",
  "properties": {
    "collation": "SQL_Latin1_General_CP1_CI_AS",
    "status": "Online",
    "creationDate": "2017-06-07T04:41:33.937Z",
    "defaultSecondaryLocation": "North Europe"
  },
  "type": "Microsoft.Sql/managedInstances/databases"
}

Status code:

202

Creates a new managed database with maximal properties

Sample Request

HTTP

PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/managedInstances/managedInstance/databases/managedDatabase?api-version=2021-11-01

{
  "tags": {
    "tagKey1": "TagValue1"
  },
  "location": "southeastasia"
}

Java

import com.azure.core.util.Context;
import com.azure.resourcemanager.sql.fluent.models.ManagedDatabaseInner;
import java.util.HashMap;
import java.util.Map;

/** Samples for ManagedDatabases CreateOrUpdate. */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/ManagedDatabaseCreateMax.json
     */
    /**
     * Sample code: Creates a new managed database with maximal properties.
     *
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void
        createsANewManagedDatabaseWithMaximalProperties(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getManagedDatabases().createOrUpdate("Default-SQL-SouthEastAsia",
            "managedInstance", "managedDatabase",
            new ManagedDatabaseInner().withLocation("southeastasia").withTags(mapOf("tagKey1", "TagValue1")),
            Context.NONE);
    }

    @SuppressWarnings("unchecked")
    private static <T> Map<String, T> mapOf(Object... inputs) {
        Map<String, T> map = new HashMap<>();
        for (int i = 0; i < inputs.length; i += 2) {
            String key = (String) inputs[i];
            T value = (T) inputs[i + 1];
            map.put(key, value);
        }
        return map;
    }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Sample Response

Status code:

200

{
  "tags": {
    "tagKey1": "TagValue1"
  },
  "location": "southeastasia",
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/managedInstances/testsvr/databases/testdb1",
  "name": "testdb1",
  "properties": {
    "collation": "SQL_Latin1_General_CP1_CI_AS",
    "status": "Online",
    "creationDate": "2017-06-07T04:41:33.937Z",
    "defaultSecondaryLocation": "North Europe"
  },
  "type": "Microsoft.Sql/managedInstances/databases"
}

Status code:

201

{
  "tags": {
    "tagKey1": "TagValue1"
  },
  "location": "southeastasia",
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/managedInstances/testsvr/databases/testdb2",
  "name": "testdb2",
  "properties": {
    "collation": "SQL_Latin1_General_CP1_CI_AS",
    "status": "Online",
    "creationDate": "2017-06-07T04:41:33.937Z",
    "defaultSecondaryLocation": "North Europe"
  },
  "type": "Microsoft.Sql/managedInstances/databases"
}

Status code:

202

Creates a new managed database with minimal properties

Sample Request

HTTP

PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/managedInstances/managedInstance/databases/managedDatabase?api-version=2021-11-01

{
  "location": "southeastasia"
}

Java

import com.azure.core.util.Context;
import com.azure.resourcemanager.sql.fluent.models.ManagedDatabaseInner;
import java.util.HashMap;
import java.util.Map;

/** Samples for ManagedDatabases CreateOrUpdate. */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/ManagedDatabaseCreateMin.json
     */
    /**
     * Sample code: Creates a new managed database with minimal properties.
     *
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void
        createsANewManagedDatabaseWithMinimalProperties(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getManagedDatabases().createOrUpdate("Default-SQL-SouthEastAsia",
            "managedInstance", "managedDatabase", new ManagedDatabaseInner().withLocation("southeastasia"),
            Context.NONE);
    }

    @SuppressWarnings("unchecked")
    private static <T> Map<String, T> mapOf(Object... inputs) {
        Map<String, T> map = new HashMap<>();
        for (int i = 0; i < inputs.length; i += 2) {
            String key = (String) inputs[i];
            T value = (T) inputs[i + 1];
            map.put(key, value);
        }
        return map;
    }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Sample Response

Status code:

200

{
  "location": "southeastasia",
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/managedInstances/testsvr/databases/testdb1",
  "name": "testdb1",
  "properties": {
    "collation": "SQL_Latin1_General_CP1_CI_AS",
    "status": "Online",
    "creationDate": "2017-06-07T04:41:33.937Z",
    "defaultSecondaryLocation": "North Europe"
  },
  "type": "Microsoft.Sql/managedInstances/databases"
}

Status code:

201

{
  "location": "southeastasia",
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/managedInstances/testsvr/databases/testdb2",
  "name": "testdb2",
  "properties": {
    "collation": "SQL_Latin1_General_CP1_CI_AS",
    "status": "Online",
    "creationDate": "2017-06-07T04:41:33.937Z",
    "defaultSecondaryLocation": "North Europe"
  },
  "type": "Microsoft.Sql/managedInstances/databases"
}

Status code:

202

Definisi

Nama	Deskripsi
CatalogCollationType	Kolate katalog metadata.
ManagedDatabase	Sumber daya database terkelola.
ManagedDatabaseCreateMode	Mode pembuatan database terkelola. PointInTimeRestore: Buat database dengan memulihkan cadangan titik waktu database yang sudah ada. SourceDatabaseName, SourceManagedInstanceName, dan PointInTime harus ditentukan. RestoreExternalBackup: Buat database dengan memulihkan dari file cadangan eksternal. Kolase, StorageContainerUri, dan StorageContainerSasToken harus ditentukan. Pemulihan: Membuat database dengan memulihkan cadangan yang direplikasi secara geografis. RecoverableDatabaseId harus ditentukan sebagai ID sumber daya database yang dapat dipulihkan untuk dipulihkan. RestoreLongTermRetentionBackup: Buat database dengan memulihkan dari cadangan retensi jangka panjang (longTermRetentionBackupResourceId diperlukan).
ManagedDatabaseStatus	Status database.

CatalogCollationType

Kolate katalog metadata.

Nama	Jenis	Deskripsi
DATABASE_DEFAULT	string
SQL_Latin1_General_CP1_CI_AS	string

ManagedDatabase

Sumber daya database terkelola.

Nama	Jenis	Deskripsi
id	string	ID Sumber Daya.
location	string	Lokasi sumber daya.
name	string	Nama sumber daya.
properties.autoCompleteRestore	boolean	Apakah akan menyelesaikan pemulihan otomatis database terkelola ini.
properties.catalogCollation	CatalogCollationType	Kolate katalog metadata.
properties.collation	string	Kolae database terkelola.
properties.createMode	ManagedDatabaseCreateMode	Mode pembuatan database terkelola. PointInTimeRestore: Buat database dengan memulihkan cadangan titik waktu database yang sudah ada. SourceDatabaseName, SourceManagedInstanceName, dan PointInTime harus ditentukan. RestoreExternalBackup: Buat database dengan memulihkan dari file cadangan eksternal. Kolase, StorageContainerUri, dan StorageContainerSasToken harus ditentukan. Pemulihan: Membuat database dengan memulihkan cadangan yang direplikasi secara geografis. RecoverableDatabaseId harus ditentukan sebagai ID sumber daya database yang dapat dipulihkan untuk dipulihkan. RestoreLongTermRetentionBackup: Buat database dengan memulihkan dari cadangan retensi jangka panjang (longTermRetentionBackupResourceId diperlukan).
properties.creationDate	string	Tanggal pembuatan database.
properties.defaultSecondaryLocation	string	Wilayah berpasangan geografis.
properties.earliestRestorePoint	string	Titik pemulihan paling awal untuk pemulihan titik waktu.
properties.failoverGroupId	string	Pengidentifikasi sumber daya Grup Failover Instans tempat database terkelola ini berada.
properties.lastBackupName	string	Nama file cadangan terakhir untuk pemulihan database terkelola ini.
properties.longTermRetentionBackupResourceId	string	Nama cadangan Retensi Jangka Panjang yang akan digunakan untuk pemulihan database terkelola ini.
properties.recoverableDatabaseId	string	Pengidentifikasi sumber daya database yang dapat dipulihkan yang terkait dengan operasi pembuatan database ini.
properties.restorableDroppedDatabaseId	string	Id sumber daya database yang dihilangkan yang dapat dipulihkan untuk dipulihkan saat membuat database ini.
properties.restorePointInTime	string	Bersyarat. Jika createMode adalah PointInTimeRestore, nilai ini diperlukan. Menentukan titik waktu (ISO8601 format) database sumber yang akan dipulihkan untuk membuat database baru.
properties.sourceDatabaseId	string	Pengidentifikasi sumber daya database sumber yang terkait dengan operasi pembuatan database ini.
properties.status	ManagedDatabaseStatus	Status database.
properties.storageContainerSasToken	string	Bersyarat. Jika createMode adalah RestoreExternalBackup, nilai ini diperlukan. Menentukan token sas kontainer penyimpanan.
properties.storageContainerUri	string	Bersyarat. Jika createMode adalah RestoreExternalBackup, nilai ini diperlukan. Menentukan uri kontainer penyimpanan tempat cadangan untuk pemulihan ini disimpan.
tags	object	Tag sumber daya.
type	string	Jenis sumber daya

ManagedDatabaseCreateMode

Mode pembuatan database terkelola. PointInTimeRestore: Buat database dengan memulihkan cadangan titik waktu database yang sudah ada. SourceDatabaseName, SourceManagedInstanceName, dan PointInTime harus ditentukan. RestoreExternalBackup: Buat database dengan memulihkan dari file cadangan eksternal. Kolase, StorageContainerUri, dan StorageContainerSasToken harus ditentukan. Pemulihan: Membuat database dengan memulihkan cadangan yang direplikasi secara geografis. RecoverableDatabaseId harus ditentukan sebagai ID sumber daya database yang dapat dipulihkan untuk dipulihkan. RestoreLongTermRetentionBackup: Buat database dengan memulihkan dari cadangan retensi jangka panjang (longTermRetentionBackupResourceId diperlukan).

Nama	Jenis	Deskripsi
Default	string
PointInTimeRestore	string
Recovery	string
RestoreExternalBackup	string
RestoreLongTermRetentionBackup	string

ManagedDatabaseStatus

Status database.

Nama	Jenis	Deskripsi
Creating	string
Inaccessible	string
Offline	string
Online	string
Restoring	string
Shutdown	string
Updating	string