Managed Databases - Create Or Update

リファレンス

サービス:: SQL Database

API バージョン:: 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 Resource Manager 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: 外部バックアップファイルから復元してデータベースを作成します。照合順序、StorageContainerUri、StorageContainerSasToken を指定する必要があります。復旧: geo レプリケートされたバックアップを復元してデータベースを作成します。 RecoverableDatabaseId は、復元する回復可能なデータベースリソース ID として指定する必要があります。 RestoreLongTermRetentionBackup: 長期保有バックアップから復元してデータベースを作成します (longTermRetentionBackupResourceId が必要)。
properties.lastBackupName		string	このマネージドデータベースを復元するための最後のバックアップファイル名。
properties.longTermRetentionBackupResourceId		string (arm-id)	このマネージドデータベースの復元に使用する長期保有バックアップの名前。
properties.recoverableDatabaseId		string (arm-id)	このデータベースの作成操作に関連付けられている回復可能なデータベースのリソース識別子。
properties.restorableDroppedDatabaseId		string (arm-id)	このデータベースの作成時に復元する、復元可能な削除されたデータベースリソース ID。
properties.restorePointInTime		string (date-time)	条件付きの。 createMode が PointInTimeRestore の場合、この値は必須です。新しいデータベースを作成するために復元されるソースデータベースの時点 (ISO8601形式) を指定します。
properties.sourceDatabaseId		string (arm-id)	このデータベースの作成操作に関連付けられているソースデータベースのリソース識別子。
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 host '{0}' は SQL から解決できません。サーバー '{1}'。 400 InvalidBackupRetentionPeriod - {0} の保持日数が有効な構成ではありません。有効なバックアップリテンション期間 (日数) は、{1} から {2} の間である必要があります 400 ManagedDatabaseNameInUse - Database '{0}' は既に存在します。別のデータベース名を選択します。 400 NoMoreSpaceInManagedInstance - マネージドインスタンスがストレージ制限に達しました。マネージドインスタンスのストレージ使用量は、(%d) MB を超えることはできません。 400 ManagedInstanceUpdateSloInProgress - "マネージドインスタンス '{0}のサービスレベルの変更が進行中であるため、操作を完了できませんでした。' 進行中の操作が完了するまで待ってから、もう一度やり直してください。 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 - AKV エンドポイント '{0}' は、サーバー '{1}' 上の SQL から到達できません。 400 ServerNotFound - 要求されたサーバーが見つかりませんでした。 400 UnsupportedServiceName - 指定された名前には、サポートされていない Unicode 文字が 1 つ以上含まれているため、無効な名前です。 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 - 差分バックアップの 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 - 差分バックアップの DifferentialBaseGuid が完全バックアップの BackupSetGuid と一致しないため、復元プランが壊れています。 400 IncompatiblePhysicalLayoutTooFewDataFiles - データベースバックアップに互換性のない物理レイアウトが含まれています。バックアップにデータファイルが見つかりません。 400 CorruptedPagesInBackupSet - RESTORE でバックアップセット内の 1 つ以上の破損したページが検出されたため、操作が中止されました。 400 IncompatiblePhysicalLayoutNonOnlineDataFilesExist - データベースバックアップに互換性のない物理レイアウトが含まれています。オンライン以外のデータファイルが存在します。 400 CorruptedPagesListMaintenance - チェックサムなしで作成されたバックアップの処理中に内部エラーが発生したため、操作が中止されました。 400 IncompatiblePhysicalLayoutWrongNumberOfLogFiles - データベースバックアップには、互換性のない物理レイアウトが含まれています。複数のログファイルはサポートされていません。 400 IncompatiblePhysicalLayoutNonOnlineLogFilesExist - データベースバックアップに互換性のない物理レイアウトが含まれています。オンライン以外のログファイルが存在します。 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 - ユーザーが、リソースにロックが適用されているサブネット内の最後のマネージドインスタンスを削除しようとしました。 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.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"),
            com.azure.core.util.Context.NONE);
    }

    // Use "Map.of" if available
    @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

応答のサンプル

状態コード:: 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"
}

状態コード:: 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"
}

状態コード:: 202

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

要求のサンプル

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.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"),
            com.azure.core.util.Context.NONE);
    }

    // Use "Map.of" if available
    @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

応答のサンプル

状態コード:: 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"
}

状態コード:: 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"
}

状態コード:: 202

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

要求のサンプル

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.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"),
            com.azure.core.util.Context.NONE);
    }

    // Use "Map.of" if available
    @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

応答のサンプル

状態コード:: 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"
}

状態コード:: 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"
}

状態コード:: 202

Creates a new managed database using point in time restore

要求のサンプル

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.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"),
            com.azure.core.util.Context.NONE);
    }

    // Use "Map.of" if available
    @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

応答のサンプル

状態コード:: 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"
}

状態コード:: 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"
}

状態コード:: 202

Creates a new managed database with maximal properties

要求のサンプル

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.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", "fakeTokenPlaceholder")),
            com.azure.core.util.Context.NONE);
    }

    // Use "Map.of" if available
    @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

応答のサンプル

状態コード:: 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"
}

状態コード:: 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"
}

状態コード:: 202

Creates a new managed database with minimal properties

要求のサンプル

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.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"),
            com.azure.core.util.Context.NONE);
    }

    // Use "Map.of" if available
    @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

応答のサンプル

状態コード:: 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"
}

状態コード:: 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"
}

状態コード:: 202

定義

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

CatalogCollationType

列挙

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

値	説明
DATABASE_DEFAULT
SQL_Latin1_General_CP1_CI_AS