次の方法で共有

Managed Databases - Update

  • リファレンス
サービス:
SQL Database
API バージョン:
2021-11-01

既存のデータベースを更新します。

PATCH 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 のバージョン。

要求本文

名前 型 説明
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

このマネージド データベースの復元に使用する長期保有バックアップの名前。
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

データベースが正常に更新されました。
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 RestoreableDroppedDatabaseIdGivenForRestoreWithSourceDatabaseId - sourceDatabaseId が復元作成モードで既に指定されている場合、restoreableDroppedDatabaseId を指定できません

  • 400 CannotUseReservedDatabaseName - この操作では予約データベース名を使用できません。

  • 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 - データベースでシステムメンテナンス操作が進行中であり、完了するまでそれ以上の操作を待機する必要があります。

  • 429 SubscriptionTooManyCreateUpdateRequests - 使用可能なリソースによって処理できる最大要求数を超える要求。

  • 429 SubscriptionTooManyRequests - 使用可能なリソースによって処理できる最大要求を超える要求。

  • 500 ActivateOrDeactivateWorkflowThrottling - 同時実行ワークフローが多すぎるため、アクティブ化または非アクティブ化ワークフローが失敗しました

  • 503 DatabaseUnavailable - データベースが使用できないため、操作に失敗しました。

  • 503 TooManyRequests - 使用可能なリソースによって処理できる最大要求数を超える要求。

  • 504 RequestTimeout - サービス要求が許可されたタイムアウトを超えました。

例

Updates a managed database with maximal properties
Updates a managed database with minimal properties

Updates a managed database with maximal properties

要求のサンプル

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

{
  "tags": {
    "tagKey1": "TagValue1"
  }
}

応答のサンプル

状態コード:
200 
{
  "tags": {
    "tagKey1": "TagValue1"
  },
  "location": "southeastasia",
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/databases/testdb",
  "name": "testdb"
}
状態コード:
202

Updates a managed database with minimal properties

要求のサンプル

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

{
  "tags": {
    "tagKey1": "TagValue1"
  }
}

応答のサンプル

状態コード:
200 
{
  "tags": {
    "tagKey1": "TagValue1"
  },
  "location": "southeastasia",
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/databases/testdb",
  "name": "testdb"
}
状態コード:
202

定義

名前 説明
CatalogCollationType

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

マネージド データベース リソース。
ManagedDatabaseCreateMode

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

データベースの状態です。
ManagedDatabaseUpdate

マネージド データベースの更新。

CatalogCollationType

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

名前 型 説明
DATABASE_DEFAULT

string

SQL_Latin1_General_CP1_CI_AS

string

ManagedDatabase

マネージド データベース リソース。

名前 型 説明
id

string

リソースの ID
location

string

リソースの場所。
name

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.creationDate

string

データベースの作成日。
properties.defaultSecondaryLocation

string

geo ペアリージョン。
properties.earliestRestorePoint

string

特定の時点の復元の最も古い復元ポイント。
properties.failoverGroupId

string

このマネージド データベースが属するインスタンス フェールオーバー グループ リソース識別子。
properties.lastBackupName

string

このマネージド データベースの復元用の最後のバックアップ ファイル名。
properties.longTermRetentionBackupResourceId

string

このマネージド データベースの復元に使用する長期保有バックアップの名前。
properties.recoverableDatabaseId

string

このデータベースの作成操作に関連付けられている回復可能なデータベースのリソース識別子。
properties.restorableDroppedDatabaseId

string

このデータベースの作成時に復元する復元可能な削除されたデータベース リソース ID。
properties.restorePointInTime

string

条件 付き。 createMode が PointInTimeRestore の場合、この値は必須です。 新しいデータベースを作成するために復元されるソース データベースの時点 (ISO8601形式) を指定します。
properties.sourceDatabaseId

string

このデータベースの作成操作に関連付けられているソース データベースのリソース識別子。
properties.status

ManagedDatabaseStatus

データベースの状態です。
properties.storageContainerSasToken

string

条件 付き。 createMode が RestoreExternalBackup の場合、この値は必須です。 ストレージ コンテナーの sas トークンを指定します。
properties.storageContainerUri

string

条件 付き。 createMode が RestoreExternalBackup の場合、この値は必須です。 この復元のバックアップが格納されるストレージ コンテナーの URI を指定します。
tags

object

リソース タグ。
type

string

リソースの種類。

ManagedDatabaseCreateMode

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

名前 型 説明
Default

string

PointInTimeRestore

string

Recovery

string

RestoreExternalBackup

string

RestoreLongTermRetentionBackup

string

ManagedDatabaseStatus

データベースの状態です。

名前 型 説明
Creating

string

Inaccessible

string

Offline

string

Online

string

Restoring

string

Shutdown

string

Updating

string

ManagedDatabaseUpdate

マネージド データベースの更新。

名前 型 説明
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.creationDate

string

データベースの作成日。
properties.defaultSecondaryLocation

string

geo ペアリージョン。
properties.earliestRestorePoint

string

特定の時点の復元の最も古い復元ポイント。
properties.failoverGroupId

string

このマネージド データベースが属するインスタンス フェールオーバー グループ リソース識別子。
properties.lastBackupName

string

このマネージド データベースの復元用の最後のバックアップ ファイル名。
properties.longTermRetentionBackupResourceId

string

このマネージド データベースの復元に使用する長期保有バックアップの名前。
properties.recoverableDatabaseId

string

このデータベースの作成操作に関連付けられている回復可能なデータベースのリソース識別子。
properties.restorableDroppedDatabaseId

string

このデータベースの作成時に復元する復元可能な削除されたデータベース リソース ID。
properties.restorePointInTime

string

条件 付き。 createMode が PointInTimeRestore の場合、この値は必須です。 新しいデータベースを作成するために復元されるソース データベースの時点 (ISO8601形式) を指定します。
properties.sourceDatabaseId

string

このデータベースの作成操作に関連付けられているソース データベースのリソース識別子。
properties.status

ManagedDatabaseStatus

データベースの状態です。
properties.storageContainerSasToken

string

条件 付き。 createMode が RestoreExternalBackup の場合、この値は必須です。 ストレージ コンテナーの sas トークンを指定します。
properties.storageContainerUri

string

条件 付き。 createMode が RestoreExternalBackup の場合、この値は必須です。 この復元のバックアップが格納されるストレージ コンテナーの URI を指定します。
tags

object

リソース タグ。