Managed Databases - Create Or Update

リファレンス

Service:: SQL Database

API Version:: 2021-11-01

新しいデータベースを作成するか、既存のデータベースを更新します。

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

URI パラメーター

名前	/	必須	型	説明
databaseName	path	True	string	データベースの名前。
managedInstanceName	path	True	string	マネージドインスタンスの名前。
resourceGroupName	path	True	string	リソースが含まれているリソースグループの名前。この値は、Azure リソースマネージャー API またはポータルから取得できます。
subscriptionId	path	True	string	Azure サブスクリプションを識別するサブスクリプション ID。
api-version	query	True	string	要求で使用する API のバージョン。

要求本文

名前	必須	型	説明
location	True	string	リソースの場所。
properties.autoCompleteRestore		boolean	このマネージドデータベースの自動復元を完了するかどうか。
properties.catalogCollation		CatalogCollationType	メタデータカタログの照合順序。
properties.collation		string	マネージドデータベースの照合順序。
properties.createMode		ManagedDatabaseCreateMode	マネージドデータベース作成モード。 PointInTimeRestore: 既存のデータベースの特定の時点のバックアップを復元してデータベースを作成します。 SourceDatabaseName、SourceManagedInstanceName、PointInTime を指定する必要があります。 RestoreExternalBackup: 外部バックアップファイルから復元してデータベースを作成します。 Collation、StorageContainerUri、StorageContainerSasToken を指定する必要があります。回復: geo レプリケートされたバックアップを復元してデータベースを作成します。 RecoverableDatabaseId は、復元する回復可能なデータベースリソース ID として指定する必要があります。 RestoreLongTermRetentionBackup: 長期保有バックアップから復元してデータベースを作成します (longTermRetentionBackupResourceId が必要)。
properties.lastBackupName		string	このマネージドデータベースを復元するための最後のバックアップファイル名。
properties.longTermRetentionBackupResourceId		string	このマネージドデータベースの復元に使用する長期保有バックアップの名前。
properties.recoverableDatabaseId		string	このデータベースの作成操作に関連付けられている回復可能なデータベースのリソース識別子。
properties.restorableDroppedDatabaseId		string	このデータベースの作成時に復元する復元可能な削除されたデータベースリソース ID。
properties.restorePointInTime		string	条件付き。 createMode が PointInTimeRestore の場合、この値は必須です。新しいデータベースを作成するために復元されるソースデータベースの時点 (ISO8601形式) を指定します。
properties.sourceDatabaseId		string	このデータベースの作成操作に関連付けられているソースデータベースのリソース識別子。
properties.storageContainerSasToken		string	条件付き。 createMode が RestoreExternalBackup の場合、この値は必須です。ストレージコンテナーの sas トークンを指定します。
properties.storageContainerUri		string	条件付き。 createMode が RestoreExternalBackup の場合、この値は必須です。この復元のバックアップが格納されるストレージコンテナーの URI を指定します。
tags		object	リソースタグ。

応答

名前	型	説明
200 OK	ManagedDatabase	データベースが正常に更新されました。
201 Created	ManagedDatabase	データベースが正常に作成されました。
202 Accepted		同意
Other Status Codes		エラー応答: *** 400 PitrPointInTimeInvalid - ポイントインタイム {0} が無効です。有効な時点の範囲は、ソースサーバーの作成時刻の前ではなく、早い日から {1} 現在までの日数です。 400 CannotUseTrailingWhitespacesInDatabaseName - データベース名の検証に失敗しました。 400 StorageAccountFull - Managed Instance基になる Azure ストレージアカウントの合計容量に達しました。 Azure Premium Storage アカウントでの領域の割り当ては、35 TB に制限されています。 400 AkvHostNotResolvingFromNode - AKV ホスト '' は、サーバー '{0}{1}' の SQL から解決できません。 400 InvalidBackupRetentionPeriod - の保有日数 {0} が有効な構成ではありません。有効なバックアップ保有期間 (日数) は、との間 {1} である必要があります {2} 400 ManagedDatabaseNameInUse - データベース '{0}' は既に存在します。別のデータベース名を選択してください。 400 NoMoreSpaceInManagedInstance - マネージドインスタンスがストレージ制限に達しました。マネージドインスタンスのストレージ使用量が (%d) MB を超えることはできません。 400 ManagedInstanceUpdateSloInProgress - "マネージドインスタンス '{0}.' に対してサービスレベルの変更が進行中のため、操作を完了できませんでした。 Please wait for the operation in progress to complete and try again." (進行中の操作が完了するまでしばらく待ってから、やり直してください。) 400 SameKeyMaterialNotFoundOnRemoteServer - セカンダリサーバーには、プライマリサーバーの暗号化保護機能のキーマテリアルがありません。 400 SourceDatabaseNotFound - ソースデータベースが存在しません。 400 RegionDoesNotSupportVersion - ユーザーが、そのサーバーバージョンがサポートされていない場所に、指定したバージョンのサーバーを作成しようとしました。 400 PasswordNotComplex - 指定されたパスワードが十分に複雑ではありません。 400 CannotUseReservedDatabaseName - この操作で予約済みデータベース名を使用できません。 400 InvalidServerName - 無効なサーバー名が指定されています。 400 SourceServerNotFound - CreateDatabaseAsCopy API 呼び出しで指定されたソースデータベース ID のサーバー部分は、既存のサーバーにマップされません。 400 TokenTooLong - 指定されたトークンが長すぎます。 400 CurrentDatabaseSizeExceedsMaxSize - ユーザーは、データベースの最大サイズを現在の使用量よりも小さいサイズに縮小しようとしました。 400 InvalidCollation - 照合順序がサーバーによって認識されません。 400 AkvEndpointNotReachableFromNode - サーバー '' の SQL から AKV エンドポイント '{0}{1}' に到達できません。 400 ServerNotFound - 要求されたサーバーが見つかりませんでした。 400 UnsupportedServiceName - 1 つ以上のサポートされていない Unicode 文字が含まれているため、指定された名前は無効な名前です。 400 CurrentDatabaseLogSizeExceedsMaxSize - ユーザーは、現在の使用量よりもログの最大サイズが小さい SKU にデータベースを変更しようとしました。 400 DatabaseNumberLimitReached - SQL Database Managed Instanceのデータベースの最大数に達しました。 400 InvalidDatabaseCreateOrUpdateRequest - データベースの作成または更新操作の要求本文が無効です。 400 InvalidResourceId - リソース識別子が無効です。 400 InvalidSourceDatabaseId - ソースデータベース識別子が無効です。 400 InvalidRestorableDroppedDatabaseId - 復元可能な削除されたデータベース識別子が無効です 400 MismatchingResourceGroupNameWithUrl - 指定されたリソースグループ名が URL の名前と一致しませんでした。 400 MismatchingServerNameWithUrl - 指定されたサーバー名が URL の名前と一致しませんでした。 400 MismatchingSubscriptionWithUrl - 指定されたサブスクリプションが URL のサブスクリプションと一致しませんでした。 400 MissingCollation - 照合順序が必要です。 400 MissingSourceDatabaseId - ソースデータベース識別子がありません。 400 MissingRestorePointInTime - 復元ポイントインタイムが見つかりません 400 MissingStorageContainerSasToken - ストレージコンテナー SAS トークンがありません 400 MissingStorageContainerUri - ストレージコンテナー URI がありません 400 RestorableDroppedDatabaseIdGivenForRestoreWithSourceDatabaseId - sourceDatabaseId が復元作成モードで既に指定されている場合、restorableDroppedDatabaseId を指定できません 400 CannotUseReservedDatabaseName - この操作で予約済みデータベース名を使用できません。 400 InvalidLongTermRetentionManagedInstanceBackupId - Managed Instances の長期保有バックアップ識別子が無効です。 400 MiGeoRestoreWithWrongBackupStorageRedundancy - LRS/ZRS バックアップストレージ冗長性を持つマネージドインスタンスでは、Geo-Restore は許可されません。 400 UpdatingInstanceAndBackupRedundancy - インスタンスゾーンの冗長性とバックアップストレージの冗長性を同じ要求で更新することはできません。 400 ProvisioningDisabled - リソース操作承認者からのエラーメッセージをそのまま表示します(変更なし) 400 AadOnlyAuthenticationIsEnabled - Azure Active Directory のみの認証が有効になっています。システム管理者に問い合わせてください。 400 ManagementServiceFeatureDisabled - ユーザーが無効になっている機能を使用しようとしました。 400 TargetServerDoesNotExist - ターゲットサーバー {0} が存在しないか、まだ準備ができていません。存在することをチェックし、復元要求を再試行してください。 400 TargetServerRestoreNotAllowed - ターゲットサーバー {0} は現在、復元を開始できる状態ではありません。 400 BackupSetNotFound - データベースを復元するためのバックアップが見つかりませんでした。データベースを復元するには、サポートにお問い合わせください。 400 FullBackupNotFound - 完全バックアップが見つかりません。 400 MissingThumbprint - サーバー証明書が見つかりません。 400 RestoreFromStripedBackupsNotEnabled - ストライプバックアップからの復元はサポートされていません。 400 BackupSetBroken - バックアップセットが壊れています。 400 BrokenRestorePlanNoFullBackup - 完全バックアップがないため、復元プランが壊れています。 400 SqlRestoreError - インデックス {0} を使用したバックアップの復元中に再取得できないエラーが発生しました - {1}{2} 400 BrokenRestorePlanWrongLogBackupLSN - 現在のログバックアップの firstLsn が = 次のログバックアップの lastLsn ではないので <、復元プランは壊れています。 400 BrokenRestorePlanWrongDiffBackupLSN - diff バックアップの firstLsn が完全バックアップの firstLsn でないため>、復元プランが壊れています。 400 BrokenRestorePlanGapInLogBackups - 現在のログバックアップの firstLsn が prev ログバックアップの lastLsn と等しくないため、復元プランが壊れています。 400 PartiallyContainedDatabaseUnsupported - "部分包含データベースのバックアップはサポートされていません。" 400 RequiredBackupIsNotLastRestored - 指定されたバックアップファイル名が復元された最後のバックアップファイルの名前ではないので、移行を完了できません。 400 XtpInitializedDuringRestore - SQL Database Managed Instanceのレベルで復元するには、メモリ最適化ファイルグループGeneral Purpose空である必要があります。 400 FullBackupMissingChecksum - 指定された完全バックアップにチェックサムがありません。 400 FullBackupDamaged - 完全バックアップが破損している場合。 400 MissingStripeInBackupSet - 指定されたバックアップセットに 1 つ以上の欠落ストライプがあります。 400 BrokenRestorePlanWrongDiffBaseGUID - diff バックアップの DifferentialBaseGuid が完全バックアップの BackupSetGuid と一致しないため、復元計画が壊れています。 400 互換性のないPhysicalLayoutTooFewDataFiles - データベースバックアップに互換性のない物理レイアウトが含まれています。バックアップにデータファイルが見つかりません。 400 CorruptedPagesInBackupSet - RESTORE でバックアップセット内の 1 つ以上の破損したページが検出されたため、操作が中止されました。 400 互換性のないPhysicalLayoutNonOnlineDataFilesExist - データベースバックアップに互換性のない物理レイアウトが含まれています。オンライン以外のデータファイルが存在します。 400 CorruptedPagesListMaintenance - チェックサムなしで作成されたバックアップの処理中に内部エラーが発生したため、操作が中止されました。 400 互換性のないPhysicalLayoutWrongNumberOfLogFiles - データベースバックアップに互換性のない物理レイアウトが含まれています。複数のログファイルはサポートされていません。 400 互換性のないPhysicalLayoutNonOnlineLogFilesExist - データベースバックアップに互換性のない物理レイアウトが含まれています。オンライン以外のログファイルが存在します。 400 IncompatiblePhysicalLayoutTooManyNonDataLogFiles - データベースバックアップに互換性のない物理レイアウトが含まれています。データ/ログ以外のファイルが多すぎます。 400 ExternalBackupAlreadySignaledToComplete - 復元要求は完了するように既に通知されています。 400 ExternalBackupRestoreHasNotBeenStarted - 復元要求は、復元が開始された後にのみ完了できます。 400 ExternalBackupUpgradeInProgress - アップグレードが進行中のため、復元要求を完了できません。 400 IncompatiblePhysicalLayoutTooManyXTPFiles - データベースバックアップに互換性のない物理レイアウトが含まれています。 MEMORY_OPTIMIZED_DATAを含むファイルグループ内に複数のファイルが見つかりました。 400 BlobStorageFailure - Blob Storage エラーが発生しました。 400 BackupsFromMultipleDatabasesDetectedInTheContainerFromTheStart - コンテナーフォルダー内の複数のデータベースからのバックアップがあります。コンテナーフォルダーに 1 つのデータベースからのバックアップがあることを確認してください。{0} 400 ManagedIdentityIssueDetectedFromTheStart - マネージド ID が正しく設定されていません。確認してやり直してください。 400 ManagedInstanceStorageLimitHit - マネージドインスタンスがストレージ制限に達しました。 400 AutoCompleteMissingLastBackupName - 自動完全復元要求には lastBackupName パラメーターが指定されている必要があります。 400 BlobStorageServerFailure - BLOB ストレージサーバーエラーが発生しました。 400 BackupsFromMultipleDatabasesDetectedInTheContainerWhileRestoreInProgress - コンテナーフォルダー内の複数のデータベースからのバックアップがあります。コンテナーフォルダーに 1 つのデータベースからのバックアップがあることを確認してください。{0} 400 ManagedIdentityIssueDetectedWhileRestoreInProgress - マネージド ID が正しく設定されていません。確認してやり直してください。 404 SubscriptionDoesNotHaveServer - 要求されたサーバーが見つかりませんでした 404 ServerNotInSubscriptionResourceGroup - 指定されたサーバーが、指定されたリソースグループとサブスクリプションに存在しません。 404 ResourceNotFound - 要求されたリソースが見つかりませんでした。 404 CannotFindServerCertificateWithThumbprint - 拇印 '' の{0}サーバー証明書が見つかりません。 PowerShell コマンドレット 'Add-AzureRmSqlManagedInstanceTransparentDataEncryptionCertificate' を使用して証明書を作成してください。 404 CannotFindObject - オブジェクトが存在しないか、アクセス許可がないため、オブジェクトが見つかりません 404 SubscriptionNotFound - 要求されたサブスクリプションが見つかりませんでした。 404 DatabaseDoesNotExist - ユーザーがこのサーバーインスタンスに存在しないデータベース名を指定しました。 404 ServerNotInSubscription - 指定されたサブスクリプションに指定されたサーバーが存在しません。 404 RestoreSourceDatabaseNotFound - 復元可能なデータベース '' が時刻 '{0}{1}' に見つかりませんでした。 404 ServerNotInSubscriptionResourceGroup - 指定されたサーバーが、指定されたリソースグループとサブスクリプションに存在しません。 409 RemoteDatabaseExists - 宛先データベース名は既に移行先サーバーに存在します。 409 ConflictingDatabaseOperation - データベースには既にいくつかの操作があり、現在の操作は完了するまで待機する必要があります。 409 SubscriptionDisabled - サブスクリプションが無効になっています。 409 ManagementServiceDatabaseBusy - データベース '{0}' は別の操作でビジー状態です。後で操作を試してください。 409 ConflictingSystemOperationInProgress - データベースでシステムメンテナンス操作が進行中であり、それ以上の操作が完了するまで待機する必要があります。 409 ConflictingManagedInstanceOperation - マネージドインスタンスの操作は現在進行中です。 409 BackupRedundancyUpdateAndInstanceRedundancyConflict - インスタンスはマルチ az ですが、バックアップストレージはゾーン冗長から非ゾーン冗長に更新されています。 409 InstanceRedundancyUpdateWhileBackupRedundancyUpdateInProgress - バックアップストレージ冗長更新が進行中のため、インスタンスの冗長性を更新できません。 409 InstanceRedundancyUpdateAndBackupRedundancyConflict - バックアップストレージは非ゾーン冗長ですが、インスタンスの冗長性はゾーン冗長に更新されています。 409 BackupRedundancyUpdateConflict - バックアップストレージの冗長性の更新が既に進行中のため、バックアップストレージの冗長性を更新できません。 409 MiDropFailedOnAuthLocks - ユーザーが、リソースにロックが適用されているサブネット内の最後のManaged Instanceを削除しようとしました。 409 MiCreateFailedNonDelegatedSubnet - ユーザーは、Microsoft.Sql/managedInstances に委任されていないサブネットにManaged InstanceまたはManaged Instance プールをデプロイしようとしました。 412 InstanceNotReadyForBackupRedundancyUpdate - インスタンスの準備ができていないため、バックアップストレージの冗長性を更新できません。 429 SubscriptionTooManyCreateUpdateRequests - 使用可能なリソースで処理できる最大要求を超える要求。 429 SubscriptionTooManyRequests - 使用可能なリソースで処理できる最大要求を超える要求。 429 SubscriptionTooManyCreateUpdateRequests - 使用可能なリソースで処理できる最大要求を超える要求。 429 SubscriptionTooManyRequests - 使用可能なリソースで処理できる最大要求を超える要求。 429 ConflictingSubscriptionOperation - サブスクリプションの操作が現在進行中です。 500 ActivateOrDeactivateWorkflowThrottling - 同時実行ワークフローが多すぎるため、アクティブ化または非アクティブ化ワークフローが失敗しました 503 DatabaseUnavailable - データベースが使用できないため、操作に失敗しました。 503 TooManyRequests - 使用可能なリソースで処理できる最大要求を超える要求。 503 TooManyRequests - 使用可能なリソースで処理できる最大要求を超える要求。 504 RequestTimeout - サービス要求が許可されたタイムアウトを超えました。 504 RequestTimeout - サービス要求が許可されたタイムアウトを超えました。

例

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

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


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
Java

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


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
Java

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


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
Java

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


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
Java

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


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
Java

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


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

定義

名前	説明
CatalogCollationType	メタデータカタログの照合順序。
ManagedDatabase	マネージドデータベースリソース。
ManagedDatabaseCreateMode	マネージドデータベース作成モード。 PointInTimeRestore: 既存のデータベースの特定の時点のバックアップを復元してデータベースを作成します。 SourceDatabaseName、SourceManagedInstanceName、PointInTime を指定する必要があります。 RestoreExternalBackup: 外部バックアップファイルから復元してデータベースを作成します。 Collation、StorageContainerUri、StorageContainerSasToken を指定する必要があります。回復: geo レプリケートされたバックアップを復元してデータベースを作成します。 RecoverableDatabaseId は、復元する回復可能なデータベースリソース ID として指定する必要があります。 RestoreLongTermRetentionBackup: 長期保有バックアップから復元してデータベースを作成します (longTermRetentionBackupResourceId が必要)。
ManagedDatabaseStatus	データベースの状態です。

CatalogCollationType

メタデータカタログの照合順序。

名前	型	説明
DATABASE_DEFAULT	string
SQL_Latin1_General_CP1_CI_AS	string