Backup Short Term Retention Policies - Update

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

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

URI パラメーター

Name In Required Type Description
databaseName
path True
  • string

データベースの名前。

policyName
path True

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

resourceGroupName
path True
  • string

リソースが含まれているリソース グループの名前。 この値は、Azure リソース マネージャー API またはポータルから取得できます。

serverName
path True
  • string

サーバーの名前。

subscriptionId
path True
  • string

Azure サブスクリプションを識別するサブスクリプション ID。

api-version
query True
  • string

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

要求本文

Name Type Description
properties.retentionDays
  • integer

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

応答

Name Type Description
200 OK

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

202 Accepted

承認済み

Other Status Codes

エラー応答: ***

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

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

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

Sample Request

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

{
  "properties": {
    "retentionDays": 14
  }
}

Sample Response

{
  "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": 14
  }
}

定義

BackupShortTermRetentionPolicy

短期保持ポリシー。

ShortTermRetentionPolicyName

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

BackupShortTermRetentionPolicy

短期保持ポリシー。

Name Type Description
id
  • string

リソースの ID

name
  • string

リソース名。

properties.retentionDays
  • integer

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

type
  • string

リソースの種類。

ShortTermRetentionPolicyName

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

Name Type Description
default
  • string