Backup Policies - Create Or Update

サービス:: Data Protection

API バージョン:: 2025-07-01

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

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

URI パラメーター

名前	/	必須	型	説明
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 バージョン。

要求本文

名前	型	説明
properties	BaseBackupPolicy: BackupPolicy	BaseBackupPolicy (英語) BaseBackupPolicyResource プロパティ

応答

名前	型	説明
200 OK	BaseBackupPolicyResource	[OK]
Other Status Codes	CloudError	操作が失敗した理由を説明するエラー応答。

セキュリティ

azure_auth

Azure Active Directory OAuth2 フロー

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

スコープ

名前	説明
user_impersonation	ユーザーアカウントを偽装します。

例

CreateOrUpdate BackupPolicy

要求のサンプル

HTTP

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

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

応答のサンプル

状態コード:: 200

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

定義

名前	説明
AbsoluteDeleteOption	AbsoluteDeleteオプション
AbsoluteMarker	"AllBackup" / "FirstOfDay" / "FirstOfWeek" / "FirstOfMonth" などの絶対値が含まれており、AbsoluteMarker 列挙型の一部である必要があります
AdhocBasedTaggingCriteria	AdhocBasedTaggingCriteria (アドホックベースのタグ付け基準)
AdhocBasedTriggerContext	アドホックベースのトリガーコンテキスト
AzureBackupParams	AzureBackupParams
AzureBackupRule	AzureBackupRule
AzureRetentionRule	AzureRetentionRule
BackupPolicy	バックアップポリシー
BackupSchedule	バックアップスケジュール
BaseBackupPolicyResource	BaseBackupPolicyリソース
CloudError	クラウドエラー
CopyOnExpiryOption	CopyOnExpiryオプション
createdByType	リソースを作成した ID の種類。
CustomCopyOption	カスタムコピーオプション
DataStoreInfoBase	データストア情報ベース
DataStoreTypes	データストアの種類。Operational/Vault/Archive
Day	一日
DayOfWeek	日曜日/月曜日/T..../土曜日にする必要があります
Error	リソース管理エラー応答。
ErrorAdditionalInfo	リソース管理エラーの追加情報。
ImmediateCopyOption	イミディエイトコピーオプション
Month	1 月/2 月/....../12 月にする必要があります
RetentionTag	リテンションタグ
ScheduleBasedBackupCriteria	ScheduleBasedBackupCriteria (スケジュールベースのバックアップ基準)
ScheduleBasedTriggerContext	スケジュールベーストリガーコンテキスト
SourceLifeCycle	ソースライフサイクル
systemData	リソースの作成と最後の変更に関連するメタデータ。
TaggingCriteria	タグ付け基準
TargetCopySetting	TargetCopySetting (ターゲットコピー設定)
WeekNumber	最初/2/3/4/最後にする必要があります

AbsoluteDeleteOption

Object

AbsoluteDeleteオプション

名前	型	説明
duration	string	指定された期間が経過した後の削除期間
objectType	string: AbsoluteDeleteOption	特定のオブジェクトの型 - 逆シリアル化に使用されます

AbsoluteMarker

列挙

"AllBackup" / "FirstOfDay" / "FirstOfWeek" / "FirstOfMonth" などの絶対値が含まれており、AbsoluteMarker 列挙型の一部である必要があります

値	説明
AllBackup
FirstOfDay
FirstOfMonth
FirstOfWeek
FirstOfYear

AdhocBasedTaggingCriteria

Object

AdhocBasedTaggingCriteria (アドホックベースのタグ付け基準)

名前	型	説明
tagInfo	RetentionTag	リテンションタグ保持タグ情報

AdhocBasedTriggerContext

Object

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

名前	型	説明
objectType	string: AdhocBasedTriggerContext	特定のオブジェクトの型 - 逆シリアル化に使用されます
taggingCriteria	AdhocBasedTaggingCriteria	AdhocBasedTaggingCriteria (アドホックベースのタグ付け基準) アドホックバックアップの保持タグを含む抽出条件のタグ付け。

AzureBackupParams

Object

AzureBackupParams

名前	型	説明
backupType	string	BackupType ;フル/インクリメンタルなど
objectType	string: AzureBackupParams	特定のオブジェクトの型 - 逆シリアル化に使用されます

AzureBackupRule

Object

AzureBackupRule

名前	型	説明
backupParameters	BackupParameters: AzureBackupParams	バックアップパラメータ BackupParameters ベース
dataStore	DataStoreInfoBase	データストア情報ベース DataStoreInfo ベース
name	string
objectType	string: AzureBackupRule
trigger	TriggerContext: AdhocBasedTriggerContext ScheduleBasedTriggerContext	トリガーコンテキストトリガーコンテキスト

AzureRetentionRule

Object

AzureRetentionRule

名前	型	説明
isDefault	boolean
lifecycles	SourceLifeCycle[]	ソースライフサイクルソース LifeCycle
name	string
objectType	string: AzureRetentionRule

BackupPolicy

Object

バックアップポリシー

名前	型	説明
datasourceTypes	string[]	バックアップ管理のデータソースの種類
objectType	string: BackupPolicy
policyRules	BasePolicyRule[]: AzureBackupRule[] AzureRetentionRule[]	各バックアップタイプのルール (完全/増分/ログなど) を含むポリシールールディクショナリ

BackupSchedule

Object

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

名前	型	説明
repeatingTimeIntervals	string[]	ISO 8601 の繰り返し時間間隔形式
timeZone	string	スケジュールのタイムゾーン。例: 太平洋標準時

BaseBackupPolicyResource

Object

BaseBackupPolicyリソース

名前	型	説明
id	string	リソース ID は、リソースへの完全なパスを表します。
name	string	リソースに関連付けられているリソース名。
properties	BaseBackupPolicy: BackupPolicy	BaseBackupPolicy (英語) BaseBackupPolicyResource プロパティ
systemData	systemData	リソースの作成と最後の変更に関連するメタデータ。
type	string	リソースの種類は、Namespace/ResourceType/ResourceType/..フォームの完全なパスを表します。

CloudError

Object

クラウドエラー

名前	型	説明
error	Error	リソース管理エラー応答。

CopyOnExpiryOption

Object

CopyOnExpiryオプション

名前	型	説明
objectType	string: CopyOnExpiryOption	特定のオブジェクトの型 - 逆シリアル化に使用されます

createdByType

列挙

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

値	説明
User
Application
ManagedIdentity
Key

CustomCopyOption

Object

カスタムコピーオプション

名前	型	説明
duration	string	指定された期間の後にコピーされたデータ
objectType	string: CustomCopyOption	特定のオブジェクトの型 - 逆シリアル化に使用されます

DataStoreInfoBase

Object

データストア情報ベース

名前	型	説明
dataStoreType	DataStoreTypes	データストアの種類。Operational/Vault/Archive
objectType	string	右の継承型を初期化するために使用される Datasource オブジェクトの型

DataStoreTypes

列挙

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

値	説明
OperationalStore
VaultStore
ArchiveStore

Day

Object

一日

名前	型	説明
date	integer (int32)	月の日付
isLast	boolean	日付が月の最後の日付かどうか

DayOfWeek

列挙

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

値	説明
Friday
Monday
Saturday
Sunday
Thursday
Tuesday
Wednesday

Error

Object

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

名前	型	説明
additionalInfo	ErrorAdditionalInfo[]	エラーの追加情報。
code	string	エラーコード。
details	Error[]	エラーの詳細。
message	string	エラーメッセージ。
target	string	エラーターゲット。

ErrorAdditionalInfo

Object

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

名前	型	説明
info	object	追加情報。
type	string	追加情報の種類。

ImmediateCopyOption

Object

イミディエイトコピーオプション

名前	型	説明
objectType	string: ImmediateCopyOption	特定のオブジェクトの型 - 逆シリアル化に使用されます

Month

列挙

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

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

RetentionTag

Object

リテンションタグ

名前	型	説明
eTag	string	保持タグのバージョン。
id	string	保持タグのバージョン。
tagName	string	保持タグ名を保持ルールに関連付けます。

ScheduleBasedBackupCriteria

Object

ScheduleBasedBackupCriteria (スケジュールベースのバックアップ基準)

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

Object

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

名前	型	説明
objectType	string: ScheduleBasedTriggerContext	特定のオブジェクトの型 - 逆シリアル化に使用されます
schedule	BackupSchedule	バックアップスケジュールこのバックアップのスケジュール
taggingCriteria	TaggingCriteria[]	指定されたスケジュールに適用できるタグの一覧。

SourceLifeCycle

Object

ソースライフサイクル

名前	型	説明
deleteAfter	DeleteOption: AbsoluteDeleteOption	削除オプション削除オプション
sourceDataStore	DataStoreInfoBase	データストア情報ベース DataStoreInfo ベース
targetDataStoreCopySettings	TargetCopySetting[]	TargetCopySetting (ターゲットコピー設定) ターゲットコピーの設定

systemData

Object

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

名前	型	説明
createdAt	string (date-time)	リソース作成のタイムスタンプ (UTC)。
createdBy	string	リソースを作成した ID。
createdByType	createdByType	リソースを作成した ID の種類。
lastModifiedAt	string (date-time)	リソースの最終変更のタイムスタンプ (UTC)
lastModifiedBy	string	リソースを最後に変更した ID。
lastModifiedByType	createdByType	リソースを最後に変更した ID の種類。

TaggingCriteria

Object

タグ付け基準

名前	型	説明
criteria	BackupCriteria[]: ScheduleBasedBackupCriteria[]	トリガーされたバックアップにタグを適用できるかどうかを決定する条件。
isDefault	boolean	タグが既定かどうかを指定します。
tagInfo	RetentionTag	リテンションタグ保持タグ情報
taggingPriority	integer (int64)	保持タグの優先度。

TargetCopySetting

Object

TargetCopySetting (ターゲットコピー設定)

名前	型	説明
copyAfter	CopyOption: CopyOnExpiryOption CustomCopyOption ImmediateCopyOption	コピーオプション CustomCopyOption または ImmediateCopyOption を指定できます。
dataStore	DataStoreInfoBase	データストア情報ベースターゲットデータストアの情報

WeekNumber

列挙

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

値	説明
First
Fourth
Last
Second
Third

次の方法で共有

Backup Policies - Create Or Update

URI パラメーター

要求本文

応答

セキュリティ

azure_auth

スコープ

例

CreateOrUpdate BackupPolicy

要求のサンプル

応答のサンプル

定義

AbsoluteDeleteOption

AbsoluteMarker

AdhocBasedTaggingCriteria

AdhocBasedTriggerContext

AzureBackupParams

AzureBackupRule

AzureRetentionRule

BackupPolicy

BackupSchedule

BaseBackupPolicyResource

CloudError

CopyOnExpiryOption

createdByType

CustomCopyOption

DataStoreInfoBase

DataStoreTypes

Day

DayOfWeek

Error

ErrorAdditionalInfo

ImmediateCopyOption

Month

RetentionTag

ScheduleBasedBackupCriteria

ScheduleBasedTriggerContext

SourceLifeCycle

systemData

TaggingCriteria

TargetCopySetting

WeekNumber