すべてのプロダクト
Search
ドキュメントセンター

:CreatePolicyV2

最終更新日:Aug 21, 2026

ポリシーを作成します。

操作説明

バックアップポリシーには、バックアップに必要な情報が記録されます。バックアップポリシーが実行されると、バックアップの進行状況と結果を記録するためのバックアップジョブが生成されます。バックアップジョブが成功すると、バックアップスナップショットが生成されます。このバックアップスナップショットを使用して復元ジョブを作成できます。

  • バックアップポリシーは、NAS バックアップ、OSS バックアップ、ECS インスタンスバックアップ、ECS ファイルバックアップ Essential エディション、ローカルファイルバックアップ、Tablestore バックアップ、CPFS バックアップなど、複数のデータソースタイプをサポートしています。

  • バックアップポリシーでは、固定間隔の単一バックアップサイクルポリシーのみがサポートされています。

  • バックアップポリシーでは、データを 1 つのバックアップボールトにのみバックアップできます。

今すぐお試しください

この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。

テスト

RAM 認証

この操作の認証情報はありません。問題が発生した場合は、アカウントマネージャーにご連絡ください。

リクエストパラメーター

パラメーター

必須 / 任意

説明

PolicyName

string

任意

ポリシー名。

毎日のローカルバックアップ + 地理的冗長性

PolicyType

string

任意

ポリシータイプ。有効な値:

  • STANDARD: 一般的なバックアップポリシー。ECS インスタンス以外のデータソースのバックアップをサポートします。

  • UDM_ECS_ONLY: ECS インスタンスバックアップポリシー。ECS インスタンスのみのバックアップをサポートします。

ポリシータイプを指定しない場合、Cloud Backup はポリシールールでバックアップボールトが指定されているかどうかに基づいてポリシータイプを自動的に設定します。

  • ポリシールールでバックアップボールトが指定されている場合: STANDARD

  • ポリシールールでバックアップボールトが指定されていない場合: UDM_ECS_ONLY

STANDARD

PolicyDescription

string

任意

ポリシーの説明。

毎日午前 10:00 に 1 回バックアップを実行し、上海へのクロスリージョンバックアップを行います。

Rules

array<object>

任意

ポリシールールのリスト。

array<object>

任意

ポリシールール。

RuleType

string

必須

ルールのタイプ。各ポリシーには、少なくとも 1 つの BACKUP ルールと正確に 1 つの TRANSITION ルールが必要です。有効な値:

  • BACKUP: バックアップルール。

  • TRANSITION: ライフサイクルルール。

  • REPLICATION: レプリケーションルール。

  • TAG: タグベースのリソース関連付けルール。

列挙値:

  • TRANSITION :

    ライフサイクルルール。

  • BACKUP :

    バックアップルール。

  • REPLICATION :

    レプリケーションルール。

  • SECURITY :

    セキュリティルール。

  • TAG :

    タグベースのリソース関連付けルール。

BACKUP

Schedule

string

任意

このパラメーターは、RuleTypeBACKUP に設定されている場合にのみ必須です。バックアップスケジュールの設定。サポートされている形式:

  • I|{startTime}|{interval}: {startTime} から指定された間隔でバックアップジョブを実行することを指定します。たとえば、I|1631685600|P1D は、2021-09-15 14:00:00 から 1 日に 1 回バックアップジョブを実行することを指定します。

    • startTime: バックアップの開始時刻。この値は UNIX タイムスタンプです。単位: 秒。

    • interval: ISO 8601 時間間隔。たとえば、PT1H は 1 時間の間隔を指定します。P1D は 1 日の間隔を指定します。

  • C|{startTime}|{crontab}: {startTime} から {crontab} 式に基づいてバックアップジョブを実行することを指定します。たとえば、C|1631685600|0 0 2 ? * 3,5,7 は、2021-09-15 14:00:00 から毎週火曜日、木曜日、土曜日の 02:00:00 にバックアップジョブを実行することを指定します。

    • startTime: バックアップの開始時刻。この値は UNIX タイムスタンプです。単位: 秒。

    • crontab: crontab 式。たとえば、0 0 2 ? * 3,5,7 は毎週火曜日、木曜日、土曜日の 02:00:00 を指定します。

逃したバックアップジョブは補償されません。前のバックアップジョブが完了していない場合、次のバックアップジョブはトリガーされません。

I|1648647166|P1D

BackupType

string

任意

このパラメーターは、RuleTypeBACKUP に設定されている場合にのみ必須です。バックアップタイプ。値を COMPLETE (完全バックアップを指定) に設定します。

列挙値:

  • ARCHIVE_BY_SEARCH :

    検索結果に基づくアーカイブ。

  • COMPLETE :

    完全バックアップ。

  • LOG :

    ログバックアップ。

  • ARCHIVE :

    アーカイブ。

  • DIFFERENTIAL :

    差分バックアップ。

  • INDEX :

    インデックス。

  • INCREMENTAL :

    増分バックアップ。

COMPLETE

Retention

integer

任意

このパラメーターは、RuleTypeBACKUPTRANSITION、または REPLICATION に設定されている場合にのみ必須です。

  • RuleTypeBACKUP に設定されている場合: バックアップの保持期間。このパラメーターの優先度は、RuleTypeTRANSITION のルールの Retention パラメーターより低くなります。最小値: 1。最大値: 364635。単位: 日。

  • RuleTypeTRANSITION に設定されている場合: バックアップの保持期間。最小値: 1。最大値: 364635。単位: 日。

  • RuleTypeREPLICATION に設定されている場合: クロスリージョンバックアップの保持期間。最小値: 1。最大値: 364635。単位: 日。

7

ReplicationRegionId

string

任意

このパラメーターは、RuleTypeREPLICATION に設定されている場合にのみ必須です。レプリケーションの送信先リージョンの ID。

cn-shanghai

ArchiveDays

integer

任意

このパラメーターは、RuleTypeTRANSITION に設定されている場合にのみ必須です。バックアップが自動的にアーカイブ層に移動されるまでの日数。バックアップは、標準層に少なくとも 30 日間、アーカイブ層に少なくとも 60 日間保持する必要があります。単位: 日。

90

RetentionRules

array<object>

任意

このパラメーターは、RuleTypeTRANSITION に設定されている場合にのみ必須です。特別な保持ルール。

object

任意

特別な保持ルール。

AdvancedRetentionType

string

任意

特別な保持ルールのタイプ。有効な値:

  • DAILY: 日次バックアップ。

  • WEEKLY: 週次バックアップ。

  • MONTHLY: 月次バックアップ。

  • YEARLY: 年次バックアップ。

YEARLY

WhichSnapshot

integer

任意

ルールが適用されるバックアップ。現在、最初のバックアップのみがサポートされています。値を 1 に設定します。

1

Retention

integer

任意

バックアップの特別な保持期間。最小値: 1。単位: 日。

730

VaultId

string

任意

このパラメーターは、RuleType が BACKUP に設定されている場合にのみ必須です。バックアップボールトの ID。

v-0001************aseg

KeepLatestSnapshots

integer

任意

少なくとも 1 つのバックアップバージョンを保持するかどうかを指定します。有効な値:

  • 0: 保持しません。

  • 1: 保持します。

1

Immutable

boolean

任意

このパラメーターは、PolicyTypeUDM_ECS_ONLY に設定され、RuleTypeSECURITY に設定されている場合にのみ必須です。バックアップロックを有効にするかどうかを指定します。

true

DataSourceFilters

array<object>

任意

このパラメーターは、RuleTypeTAG に設定されている場合にのみ必須です。データソースフィルタールール。

object

任意

SourceType

string

任意

データソースタイプ。有効な値:

  • UDM_ECS: ECS インスタンスバックアップ。このデータソースタイプは、PolicyTypeUDM_ECS_ONLY に設定されている場合にのみサポートされます。

  • OSS: OSS バックアップ。このデータソースタイプは、PolicyTypeSTANDARD に設定されている場合にのみサポートされます。

  • NAS: Alibaba Cloud NAS バックアップ。このデータソースタイプは、PolicyTypeSTANDARD に設定されている場合にのみサポートされます。

  • ECS_FILE: ECS ファイルバックアップ Essential エディション。このデータソースタイプは、PolicyTypeSTANDARD に設定されている場合にのみサポートされます。

  • OTS: Tablestore バックアップ。このデータソースタイプは、PolicyTypeSTANDARD に設定されている場合にのみサポートされます。

UDM_ECS

DataSourceIds deprecated

array

任意

非推奨。

deprecated

string

任意

非推奨。

Deprecated

TagFilters

array<object>

任意

このパラメーターは、RuleTypeTAG に設定されている場合にのみ必須です。リソースタグフィルタールール。

object

任意

Key

string

任意

タグキー。

env

Value

string

任意

タグ値。空の値は任意の値を示します。

prod

Operator

string

任意

タグマッチングルール。有効な値:

  • EQUAL: タグキーとタグ値の両方に一致します。

  • NOT: タグキーには一致しますが、タグ値には一致しません。

EQUAL

レスポンスフィールド

フィールド

説明

object

CreatePolicyResponse。

Success

boolean

リクエストが成功したかどうかを示します。有効な値:

  • true

  • false

true

Code

string

応答コード。200 は成功を示します。

200

Message

string

返されるメッセージ。リクエストが成功した場合、値 "successful" が返されます。リクエストが失敗した場合、エラーメッセージが返されます。

successful

RequestId

string

リクエスト ID。

EEC65C22-2152-5E31-8AD6-D6CBF1BFF49F

PolicyId

string

ポリシー ID。

po-000000zemnuyx2li3y9y

成功レスポンス

JSONJSON

{
  "Success": true,
  "Code": "200",
  "Message": "successful",
  "RequestId": "EEC65C22-2152-5E31-8AD6-D6CBF1BFF49F",
  "PolicyId": "po-000000zemnuyx2li3y9y"
}

エラーコード

完全なリストについては、「エラーコード」をご参照ください。

変更履歴

完全なリストについては、「変更履歴」をご参照ください。