Backup Policies - Create Or Update

バックアップ コンテナーに属するバックアップ ポリシーを作成または更新します

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataProtection/backupVaults/{vaultName}/backupPolicies/{backupPolicyName}?api-version=2026-07-01

URI パラメーター

Name / 必須 型 説明
backupPolicyName
path True

string

resourceGroupName
path True

string

minLength: 1
maxLength: 90

リソース グループの名前。 名前は大文字と小文字を区別しません。

subscriptionId
path True

string (uuid)

ターゲット サブスクリプションの ID。 値は UUID である必要があります。

vaultName
path True

string

バックアップ ボールトの名前。

api-version
query True

string

minLength: 1

この操作に使用する API バージョン。

要求本文

Name 型 説明
properties BaseBackupPolicy:

BackupPolicy

BaseBackupPolicyResource のプロパティ

応答

Name 型 説明
200 OK

BaseBackupPolicyResource

リソース 'BaseBackupPolicyResource' 更新操作に成功しました

Other Status Codes

CloudError

予期しないエラー応答。

セキュリティ

azure_auth

Azure Active Directory OAuth2 フロー。

型: oauth2
フロー: implicit
Authorization URL (承認 URL): https://login.microsoftonline.com/common/oauth2/authorize

スコープ

Name 説明
user_impersonation あなたのユーザー アカウントになりすます

例

CreateOrUpdate BackupPolicy

要求のサンプル

PUT https://management.azure.com/subscriptions/04cf684a-d41f-4550-9f70-7708a3a2283b/resourceGroups/000pikumar/providers/Microsoft.DataProtection/backupVaults/PrivatePreviewVault/backupPolicies/OSSDBPolicy?api-version=2026-07-01

{
  "properties": {
    "datasourceTypes": [
      "OssDB"
    ],
    "objectType": "BackupPolicy",
    "policyRules": [
      {
        "name": "BackupWeekly",
        "backupParameters": {
          "backupType": "Full",
          "objectType": "AzureBackupParams"
        },
        "dataStore": {
          "dataStoreType": "VaultStore",
          "objectType": "DataStoreInfoBase"
        },
        "objectType": "AzureBackupRule",
        "trigger": {
          "objectType": "ScheduleBasedTriggerContext",
          "schedule": {
            "repeatingTimeIntervals": [
              "R/2019-11-20T08:00:00-08:00/P1W"
            ]
          },
          "taggingCriteria": [
            {
              "isDefault": true,
              "tagInfo": {
                "tagName": "Default"
              },
              "taggingPriority": 99
            },
            {
              "criteria": [
                {
                  "daysOfTheWeek": [
                    "Sunday"
                  ],
                  "objectType": "ScheduleBasedBackupCriteria",
                  "scheduleTimes": [
                    "2019-03-01T13:00:00Z"
                  ]
                }
              ],
              "isDefault": false,
              "tagInfo": {
                "tagName": "Weekly"
              },
              "taggingPriority": 20
            }
          ]
        }
      },
      {
        "name": "Default",
        "isDefault": true,
        "lifecycles": [
          {
            "deleteAfter": {
              "duration": "P1W",
              "objectType": "AbsoluteDeleteOption"
            },
            "sourceDataStore": {
              "dataStoreType": "VaultStore",
              "objectType": "DataStoreInfoBase"
            }
          }
        ],
        "objectType": "AzureRetentionRule"
      },
      {
        "name": "Weekly",
        "isDefault": false,
        "lifecycles": [
          {
            "deleteAfter": {
              "duration": "P12W",
              "objectType": "AbsoluteDeleteOption"
            },
            "sourceDataStore": {
              "dataStoreType": "VaultStore",
              "objectType": "DataStoreInfoBase"
            }
          }
        ],
        "objectType": "AzureRetentionRule"
      }
    ]
  }
}

応答のサンプル

{
  "name": "OSSDBPolicy",
  "type": "Microsoft.DataProtection/backupVaults/backupPolicies",
  "id": "/subscriptions/04cf684a-d41f-4550-9f70-7708a3a2283b/resourceGroups/000pikumar/providers/Microsoft.DataProtection/backupVaults/PrivatePreviewVault/backupPolicies/OSSDBPolicy",
  "properties": {
    "datasourceTypes": [
      "OssDB"
    ],
    "objectType": "BackupPolicy",
    "policyRules": [
      {
        "name": "BackupWeekly",
        "backupParameters": {
          "backupType": "Full",
          "objectType": "AzureBackupParams"
        },
        "dataStore": {
          "dataStoreType": "VaultStore",
          "objectType": "DataStoreInfoBase"
        },
        "objectType": "AzureBackupRule",
        "trigger": {
          "objectType": "ScheduleBasedTriggerContext",
          "schedule": {
            "repeatingTimeIntervals": [
              "R/2019-11-20T08:00:00-08:00/P1W"
            ]
          },
          "taggingCriteria": [
            {
              "isDefault": true,
              "tagInfo": {
                "id": "Default_",
                "tagName": "Default"
              },
              "taggingPriority": 99
            },
            {
              "criteria": [
                {
                  "daysOfTheWeek": [
                    "Sunday"
                  ],
                  "objectType": "ScheduleBasedBackupCriteria",
                  "scheduleTimes": [
                    "2019-03-01T13:00:00Z"
                  ]
                }
              ],
              "isDefault": false,
              "tagInfo": {
                "id": "Weekly_",
                "tagName": "Weekly"
              },
              "taggingPriority": 20
            }
          ]
        }
      },
      {
        "name": "Default",
        "isDefault": true,
        "lifecycles": [
          {
            "deleteAfter": {
              "duration": "P1W",
              "objectType": "AbsoluteDeleteOption"
            },
            "sourceDataStore": {
              "dataStoreType": "VaultStore",
              "objectType": "DataStoreInfoBase"
            }
          }
        ],
        "objectType": "AzureRetentionRule"
      },
      {
        "name": "Weekly",
        "isDefault": false,
        "lifecycles": [
          {
            "deleteAfter": {
              "duration": "P12W",
              "objectType": "AbsoluteDeleteOption"
            },
            "sourceDataStore": {
              "dataStoreType": "VaultStore",
              "objectType": "DataStoreInfoBase"
            }
          }
        ],
        "objectType": "AzureRetentionRule"
      }
    ]
  }
}

定義

Name 説明
AbsoluteDeleteOption

期間を指定した削除オプション

AbsoluteMarker
AdhocBasedTaggingCriteria

アドホック バックアップのタグ付けの基準

AdhocBasedTriggerContext

アドホック トリガー コンテキスト

AzureBackupParams

Azure バックアップ パラメーター

AzureBackupRule

Azure バックアップ 規則

AzureRetentionRule

Azure リテンション期間ルール

BackupPolicy

ルール ベースのバックアップ ポリシー

BackupSchedule

バックアップのスケジュール

BaseBackupPolicyResource

BaseBackupPolicy リソース

CloudError

Azure Backup からのエラー応答。

CopyOnExpiryOption

[有効期限時にコピー] オプション

createdByType

リソースを作成した ID の種類。

CustomCopyOption

コピーする期間ベースのカスタム オプション

DataStoreInfoBase

DataStoreInfo ベース

DataStoreTypes

データストアの種類。Operational/Vault/Archive

Day

曜日

DayOfWeek
Error

リソース管理エラー応答。

ErrorAdditionalInfo

リソース管理エラーの追加情報

ImmediateCopyOption

即時コピー オプション

Month
RetentionTag

保持タグ

ScheduleBasedBackupCriteria

スケジュール ベースのバックアップ条件

ScheduleBasedTriggerContext

スケジュール ベースのトリガー コンテキスト

SourceLifeCycle

ソース LifeCycle

systemData

リソースの作成と最後の変更に関連するメタデータ。

TaggingCriteria

タグ付けの条件

TargetCopySetting

ターゲット コピーの設定

WeekNumber

AbsoluteDeleteOption

期間を指定した削除オプション

Name 型 説明
duration

string

指定された期間が経過した後の削除期間

objectType string:

AbsoluteDeleteOption

特定のオブジェクトの型 - 逆シリアル化に使用されます

AbsoluteMarker

値 説明
AllBackup
FirstOfDay
FirstOfMonth
FirstOfWeek
FirstOfYear

AdhocBasedTaggingCriteria

アドホック バックアップのタグ付けの基準

Name 型 説明
tagInfo

RetentionTag

保持タグ情報

AdhocBasedTriggerContext

アドホック トリガー コンテキスト

Name 型 説明
objectType string:

AdhocBasedTriggerContext

特定のオブジェクトの型 - 逆シリアル化に使用されます

taggingCriteria

AdhocBasedTaggingCriteria

アドホック バックアップの保持タグを含む抽出条件のタグ付け。

AzureBackupParams

Azure バックアップ パラメーター

Name 型 説明
backupType

string

BackupType ;フル/インクリメンタルなど

objectType string:

AzureBackupParams

特定のオブジェクトの型 - 逆シリアル化に使用されます

AzureBackupRule

Azure バックアップ 規則

Name 型 説明
backupParameters BackupParameters:

AzureBackupParams

BackupParameters ベース

dataStore

DataStoreInfoBase

DataStoreInfo ベース

name

string

objectType string:

AzureBackupRule

trigger TriggerContext:

トリガー コンテキスト

AzureRetentionRule

Azure リテンション期間ルール

Name 型 説明
isDefault

boolean

lifecycles

SourceLifeCycle[]

ソース LifeCycle

name

string

objectType string:

AzureRetentionRule

BackupPolicy

ルール ベースのバックアップ ポリシー

Name 型 説明
datasourceTypes

string[]

バックアップ管理のデータソースの種類

objectType string:

BackupPolicy

policyRules BasePolicyRule[]:

各バックアップタイプのルール (完全/増分/ログなど) を含むポリシー ルール ディクショナリ

BackupSchedule

バックアップのスケジュール

Name 型 説明
repeatingTimeIntervals

string[]

バックアップスケジュールを定義する時間間隔を繰り返す。

各値は以下のフォーマットに従う必要があります: R/YYYY-MM-DDThh:mm:ss[.fff][Z|(+/-)hh:mm]/Duration

以下に挙げる正確なフォーマットのみがサポートされています。 その他のISO 8601バリエーションは認められていません。

対応時間フォーマット:

  • Thh:mm:ss.fff (ミリ秒単位で)
  • Thh:mm:ss (秒数付き)
  • Thh:mm (時間と分のみ)

上記のいずれかにタイムゾーンインジケーター(Z、 +hh:mm、または -hh:mm)を付け加えることができます。

サポートされていない形式には、 T1430、 T143045、 T14.5などのコンパクトな表記法が含まれます。

例:

  • R/2023-10-15T14:30:00Z/P1W
  • R/2023-10-15T14:30:45.123+05:30/P1D
  • R/2023-10-15T14:30Z/P1D
timeZone

string

スケジュールのためのタイムゾーン。

対応するタイムゾーン指標には以下が含まれます:

  • 「Z」はUTCの鍵です
  • '+00:00'
  • '+05:30'
  • '-08:00'

例:

  • 2023-10-15T14:30:45Z
  • 2023-10-15T14:30:45.123+05:30
  • 2023-10-15 T14:30-08:00

BaseBackupPolicyResource

BaseBackupPolicy リソース

Name 型 説明
id

string (arm-id)

リソースの完全修飾リソース ID。 例: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"

name

string

リソースの名前

properties BaseBackupPolicy:

BackupPolicy

BaseBackupPolicyResource のプロパティ

systemData

systemData

createdBy および modifiedBy 情報を含む Azure Resource Manager メタデータ。

type

string

リソースの種類。 例: "Microsoft.Compute/virtualMachines" または "Microsoft.Storage/storageAccounts"

CloudError

Azure Backup からのエラー応答。

Name 型 説明
error

Error

リソース管理エラー応答。

CopyOnExpiryOption

[有効期限時にコピー] オプション

Name 型 説明
objectType string:

CopyOnExpiryOption

特定のオブジェクトの型 - 逆シリアル化に使用されます

createdByType

リソースを作成した ID の種類。

値 説明
User
Application
ManagedIdentity
Key

CustomCopyOption

コピーする期間ベースのカスタム オプション

Name 型 説明
duration

string

指定された期間の後にコピーされたデータ

objectType string:

CustomCopyOption

特定のオブジェクトの型 - 逆シリアル化に使用されます

DataStoreInfoBase

DataStoreInfo ベース

Name 型 説明
dataStoreType

DataStoreTypes

データストアの種類。Operational/Vault/Archive

objectType

string

右の継承型を初期化するために使用される Datasource オブジェクトの型

DataStoreTypes

データストアの種類。Operational/Vault/Archive

値 説明
OperationalStore
VaultStore
ArchiveStore

Day

曜日

Name 型 説明
date

integer (int32)

月の日付

isLast

boolean

日付が月の最後の日付かどうか

DayOfWeek

値 説明
Friday
Monday
Saturday
Sunday
Thursday
Tuesday
Wednesday

Error

リソース管理エラー応答。

Name 型 説明
additionalInfo

ErrorAdditionalInfo[]

エラーに関する追加情報。

code

string

エラー コード。

details

Error[]

エラーの詳細。

message

string

エラー メッセージ。

target

string

エラーの対象。

ErrorAdditionalInfo

リソース管理エラーの追加情報

Name 型 説明
info

object

追加情報。

type

string

追加情報の種類。

ImmediateCopyOption

即時コピー オプション

Name 型 説明
objectType string:

ImmediateCopyOption

特定のオブジェクトの型 - 逆シリアル化に使用されます

Month

値 説明
April
August
December
February
January
July
June
March
May
November
October
September

RetentionTag

保持タグ

Name 型 説明
eTag

string

保持タグのバージョン。

id

string

保持タグのバージョン。

tagName

string

保持タグ名を保持ルールに関連付けます。

ScheduleBasedBackupCriteria

スケジュール ベースのバックアップ条件

Name 型 説明
absoluteCriteria

AbsoluteMarker[]

AllBackup、FirstOfDay、FirstOfWeek、FirstOfMonthなどの絶対マーカー値が含まれています。 これらの値は列挙の列挙 AbsoluteMarker に含まれるべきです。

daysOfMonth

Day[]

これは、月の最後の 1 から 28 の他の賢明な月の日です

daysOfTheWeek

DayOfWeek[]

日曜日/月曜日/T..../土曜日にする必要があります

monthsOfYear

Month[]

1 月/2 月/....../12 月にする必要があります

objectType string:

ScheduleBasedBackupCriteria

特定のオブジェクトの型 - 逆シリアル化に使用されます

scheduleTimes

string[] (date-time)

バックアップのスケジュール時刻の一覧

weeksOfTheMonth

WeekNumber[]

最初/2/3/4/最後にする必要があります

ScheduleBasedTriggerContext

スケジュール ベースのトリガー コンテキスト

Name 型 説明
objectType string:

ScheduleBasedTriggerContext

特定のオブジェクトの型 - 逆シリアル化に使用されます

schedule

BackupSchedule

このバックアップのスケジュール

taggingCriteria

TaggingCriteria[]

指定されたスケジュールに適用できるタグの一覧。

SourceLifeCycle

ソース LifeCycle

Name 型 説明
deleteAfter DeleteOption:

AbsoluteDeleteOption

削除オプション

sourceDataStore

DataStoreInfoBase

DataStoreInfo ベース

targetDataStoreCopySettings

TargetCopySetting[]

ターゲット コピーの設定

systemData

リソースの作成と最後の変更に関連するメタデータ。

Name 型 説明
createdAt

string (date-time)

リソース作成のタイムスタンプ (UTC)。

createdBy

string

リソースを作成した ID。

createdByType

createdByType

リソースを作成した ID の種類。

lastModifiedAt

string (date-time)

リソースの最終変更のタイムスタンプ (UTC)

lastModifiedBy

string

リソースを最後に変更した ID。

lastModifiedByType

createdByType

リソースを最後に変更した ID の種類。

TaggingCriteria

タグ付けの条件

Name 型 説明
criteria BackupCriteria[]:

ScheduleBasedBackupCriteria[]

トリガーされたバックアップにタグを適用できるかどうかを決定する条件。

isDefault

boolean

タグが既定かどうかを指定します。

tagInfo

RetentionTag

保持タグ情報

taggingPriority

integer (int64)

保持タグの優先度。

TargetCopySetting

ターゲット コピーの設定

Name 型 説明
copyAfter CopyOption:

CustomCopyOption または ImmediateCopyOption を指定できます。

dataStore

DataStoreInfoBase

ターゲット データストアの情報

WeekNumber

値 説明
First
Fourth
Last
Second
Third