次の方法で共有

Backup Short Term Retention Policies - Update

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

データベースの短期保持ポリシーを更新します。

PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/databases/{databaseName}/backupShortTermRetentionPolicies/default?api-version=2021-11-01

URI パラメーター

名前 / 必須 型 説明
databaseName
 path True

string

データベースの名前。
policyName
 path True

ShortTermRetentionPolicyName

ポリシー名。 常に "default" にする必要があります。
resourceGroupName
 path True

string

リソースを含むリソース グループの名前。 この値は、Azure Resource Manager API またはポータルから取得できます。
serverName
 path True

string

サーバーの名前。
subscriptionId
 path True

string

Azure サブスクリプションを識別するサブスクリプション ID。
api-version
 query True

string

要求に使用する API バージョン。

要求本文

名前 型 説明
properties.diffBackupIntervalInHours

DiffBackupIntervalInHours (int32)

差分バックアップ間隔 (時間単位)。 これは、各差分バックアップがサポートされる間隔時間です。 これはライブ データベースにのみ適用されますが、削除されたデータベースには適用されません。
properties.retentionDays

integer (int32)

バックアップの保有期間 (日数)。 ポイントインタイム リストアがサポートされる日数です。

応答

名前 型 説明
200 OK

BackupShortTermRetentionPolicy

ポリシーが正常に更新されました。
202 Accepted

受け入れられた
Other Status Codes

エラー応答: ***

  • 400 InvalidParameterValue - パラメーターに無効な値が指定されました。

  • 400 InvalidBackupRetentionPeriod - {0} の保持日数が有効な構成ではありません。 有効なバックアップリテンション期間 (日数) は、{1} から {2} の間である必要があります

  • 400 InvalidDiffBackupIntervalHours - {0} の差分バックアップ間隔時間が有効な構成ではありません。 有効な差分バックアップ間隔は {1} 時間である必要があります。

  • 400 FeatureDisabledOnSelectedEdition - ユーザーは、現在のデータベース エディションで無効になっている機能を使用しようとしました。

  • 404 SubscriptionDoesNotHaveServer - 要求されたサーバーが見つかりませんでした

  • 404 ServerNotInSubscriptionResourceGroup - 指定されたサーバーが、指定されたリソース グループとサブスクリプションに存在しません。

  • 404 ResourceNotFound - 要求されたリソースが見つかりませんでした。

  • 404 SourceDatabaseNotFound - ソース データベースが存在しません。

  • 404 CannotFindObject - オブジェクトが存在しないか、アクセス許可がないため、オブジェクトが見つかりません

  • 409 ConflictingDatabaseOperation - データベースには既にいくつかの操作があり、現在の操作は完了するまで待機する必要があります。

  • 409 ConflictingSystemOperationInProgress - データベースでシステム メンテナンス操作が進行中であり、それ以上の操作が完了するまで待機する必要があります。

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

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

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

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

例

Update the short term retention policy for the database.

要求のサンプル

PATCH https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/resourceGroup/providers/Microsoft.Sql/servers/testsvr/databases/testdb/backupShortTermRetentionPolicies/default?api-version=2021-11-01

{
  "properties": {
    "retentionDays": 7,
    "diffBackupIntervalInHours": 24
  }
}

応答のサンプル

状態コード:
200 
{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Sql/resourceGroups/resourceGroup/servers/testsvr/databases/testdb/backupShortTermRetentionPolicies/default",
  "name": "default",
  "type": "Microsoft.Sql/servers/databases/backupShortTermRetentionPolicies",
  "properties": {
    "retentionDays": 7,
    "diffBackupIntervalInHours": 24
  }
}
状態コード:
202

定義

名前 説明
BackupShortTermRetentionPolicy

短期アイテム保持ポリシー。
DiffBackupIntervalInHours

差分バックアップ間隔 (時間単位)。 これは、各差分バックアップがサポートされる間隔時間です。 これはライブ データベースにのみ適用されますが、削除されたデータベースには適用されません。
ShortTermRetentionPolicyName

ポリシー名。 常に "default" にする必要があります。

BackupShortTermRetentionPolicy

Object

短期アイテム保持ポリシー。

名前 型 説明
id

string

リソース ID。
name

string

リソース名。
properties.diffBackupIntervalInHours

DiffBackupIntervalInHours (int32)

差分バックアップ間隔 (時間単位)。 これは、各差分バックアップがサポートされる間隔時間です。 これはライブ データベースにのみ適用されますが、削除されたデータベースには適用されません。
properties.retentionDays

integer (int32)

バックアップの保有期間 (日数)。 ポイントインタイム リストアがサポートされる日数です。
type

string

リソースの種類。

DiffBackupIntervalInHours

列挙

差分バックアップ間隔 (時間単位)。 これは、各差分バックアップがサポートされる間隔時間です。 これはライブ データベースにのみ適用されますが、削除されたデータベースには適用されません。

値 説明
12
24

ShortTermRetentionPolicyName

列挙

ポリシー名。 常に "default" にする必要があります。

値 説明
default