CreatePolicyBindings でバックアップポリシーバインディングを自動化 - Cloud Backup

1 つ以上のデータソースをバックアップポリシーにバインドします。

操作説明

各リクエストでは、データソースを 1 つのポリシーにのみバインドできます。
Elastic Compute Service (ECS) インスタンスは、1 つのポリシーにのみバインドできます。

今すぐお試しください

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

テスト

RAM 認証

下表に、この API を呼び出すために必要な認証情報を示します。認証情報は、RAM (Resource Access Management) ポリシーを使用して定義できます。以下で各列名について説明します。

アクション：特定のリソースに対して実行可能な操作。ポリシー構文ではAction要素として指定します。
API：アクションを具体的に実行するための API。
アクセスレベル：各 API に対して事前定義されているアクセスの種類。有効な値：create、list、get、update、delete。
リソースタイプ：アクションが作用するリソースの種類。リソースレベルでの権限をサポートするかどうかを示すことができます。ポリシーの有効性を確保するため、アクションの対象として適切なリソースを指定してください。
- リソースレベルの権限を持つ API の場合、必要なリソースタイプはアスタリスク (*) でマークされます。ポリシーのResource要素で対応する ARN を指定してください。
- リソースレベルの権限を持たない API の場合、「すべてのリソース」と表示され、ポリシーのResource要素でアスタリスク (*) でマークされます。
条件キー：サービスによって定義された条件のキー。このキーにより、きめ細やかなアクセス制御が可能になります。この制御は、アクション単体に適用することも、特定のリソースに対するアクションに適用することもできます。Alibaba Cloud は、サービス固有の条件キーに加えて、すべての RAM 統合サービスに適用可能な一連の共通条件キーを提供しています。
依存アクション：ある特定のアクションを実行するために、前提として実行が必要となる他のアクション。依存アクションの権限も RAM ユーザーまたは RAM ロールに付与する必要があります。

アクション

アクセスレベル

リソースタイプ

条件キー

依存アクション

hbr:CreatePolicyBindings

create

*All Resource

*

なし

リクエストパラメーター

パラメーター	型	必須 / 任意	説明	例
PolicyId	string	任意	バックアップポリシーの ID。	po-000************8ep
PolicyBindingList	array<object>	任意	バックアップポリシーにバインドするデータソース。
	array<object>	任意	バックアップポリシーにバインドするデータソースの詳細。
PolicyBindingDescription	string	任意	関連付けの説明。	Bind data sources to a backup policy
DataSourceId	string	任意	データソースの ID。このパラメーターの意味は、SourceType パラメーターによって異なります。有効な値： UDM_ECS：ECS インスタンスの ID OSS：Object Storage Service (OSS) バケットの名前 NAS：File Storage NAS (NAS) ファイルシステムの ID COMMON_NAS：オンプレミス NAS ファイルシステムの ID ECS_FILE：ECS インスタンスの ID File：Cloud Backup クライアントの ID COMMON_FILE_SYSTEM：Cloud Parallel File Storage (CPFS) バックアップデータソースの ID	i-bp1************dl8
Disabled	string	任意	データソースのバックアップポリシーを無効にするかどうかを指定します。有効な値： true：データソースのバックアップポリシーを無効にします false：データソースのバックアップポリシーを有効にします	true
SourceType	string	任意	データソースのタイプ。有効な値： UDM_ECS：ECS インスタンス OSS：OSS バケット NAS：NAS ファイルシステム COMMON_NAS：オンプレミス NAS ファイルシステム ECS_FILE：ECS ファイル File：オンプレミスファイル COMMON_FILE_SYSTEM：CPFS ファイルシステム	UDM_ECS
Source	string	任意	SourceType パラメーターを OSS に設定した場合、Source パラメーターをバックアップするフォルダーへのパスのプレフィックスに設定します。 Source パラメーターを指定しない場合、バケット全体 (ルートディレクトリ) がバックアップされます。 SourceType パラメーターを ECS_FILE または File に設定した場合、Source パラメーターをバックアップするファイルへのパスに設定します。 Source パラメーターを指定しない場合、すべてのパスがバックアップされます。このパラメーターは、SourceType パラメーターを COMMON_FILE_SYSTEM に設定した場合に必須です。このパラメーターは、バックアップするパスを指定します。 /src パスをバックアップするには、["/src"] と入力します。ルートパスをバックアップするには、["/"] と入力します。	backup/
Include	string	任意	このパラメーターは、SourceType パラメーターを ECS_FILE、File、NAS、COMMON_NAS、または COMMON_FILE_SYSTEM に設定した場合にのみ必須です。このパラメーターは、バックアップするファイルのタイプを指定します。指定されたタイプのすべてのファイルがバックアップされます。値の長さは最大 255 文字です。	[\".doc\",\".xltm\"]
Exclude	string	任意	このパラメーターは、SourceType パラメーターを ECS_FILE、File、NAS、COMMON_NAS、または COMMON_FILE_SYSTEM に設定した場合にのみ必須です。このパラメーターは、バックアップする必要のないファイルのタイプを指定します。指定されたタイプのファイルはバックアップされません。値の長さは最大 255 文字です。	[\".doc\",\".xltm\"]
SpeedLimit	string	任意	このパラメーターは、SourceType パラメーターを ECS_FILE または File に設定した場合にのみ必須です。このパラメーターは、速度制限ルールを指定します。フォーマット： `{start}{end}{bandwidth}`。複数の速度制限ルールは、縦棒 (\|) で区切ります。速度制限ルールの時間範囲は重複できません。 start：開始時間。 end：終了時間。 bandwidth：帯域幅。単位：KB/s。	0:24:1024
AdvancedOptions	object	任意	詳細オプション。
UdmDetail	object	任意	ECS インスタンスバックアップの詳細オプション。
ExcludeDiskIdList	array	任意	保護する必要のないディスクの ID。 DiskIdList パラメーターが空でない場合、このパラメーターは無視されます。
	string	任意	保護する必要のないディスクの ID。	d-bp1************apo
DiskIdList	array	任意	保護する必要があるディスクの ID。すべてのディスクを保護する必要がある場合、このパラメーターは空です。
	string	任意	保護する必要があるディスクの ID。	d-bp1************apo
SnapshotGroup	boolean	任意	スナップショット整合性グループを作成するかどうかを指定します。スナップショット整合性グループは、すべてのディスクが企業向け SSD (ESSD) である場合にのみ作成できます。	true
AppConsistent	boolean	任意	アプリケーション整合性を有効にするかどうかを指定します。アプリケーション整合性は、すべてのディスクが ESSD である場合にのみ有効にできます。	false
RamRoleName	string	任意	このパラメーターは、AppConsistent パラメーターを true に設定した場合にのみ必須です。このパラメーターは、アプリケーション整合性スナップショットの作成に必要な Resource Access Management (RAM) ロールの名前を指定します。	AliyunECSInstanceForHbrRole
PreScriptPath	string	任意	このパラメーターは、AppConsistent パラメーターを true に設定した場合にのみ必須です。このパラメーターは、アプリケーション整合性スナップショットが作成される前に実行されるフリーズ前スクリプトのパスを指定します。	/tmp/prescript.sh
PostScriptPath	string	任意	このパラメーターは、AppConsistent パラメーターを true に設定した場合にのみ必須です。このパラメーターは、アプリケーション整合性スナップショットが作成された後に実行される解凍後スクリプトのパスを指定します。	/tmp/postscript.sh
EnableFsFreeze	boolean	任意	このパラメーターは、AppConsistent パラメーターを true に設定した場合にのみ必須です。このパラメーターは、アプリケーション整合性スナップショットが作成される前に、Linux fsfreeze を有効にしてファイルシステムを読み取り専用状態にするかどうかを指定します。デフォルト値：true。	true
TimeoutInSeconds	integer	任意	このパラメーターは、AppConsistent パラメーターを true に設定した場合にのみ必須です。このパラメーターは、I/O フリーズタイムアウト期間を指定します。デフォルト値：30。単位：秒。	30
EnableWriters	boolean	任意	このパラメーターは、AppConsistent パラメーターを true に設定した場合にのみ必須です。このパラメーターは、アプリケーション整合性スナップショットを作成するかどうかを指定します。有効な値： true：アプリケーション整合性スナップショットを作成します。 false：ファイルシステム整合性スナップショットを作成します。デフォルト値：true。	true
OssDetail	object	任意	OSS バックアップの詳細オプション。
InventoryId	string	任意	OSS インベントリの名前。このパラメーターが空でない場合、OSS インベントリはパフォーマンス最適化に使用されます。 1 億個を超える OSS オブジェクトをバックアップする場合は、インベントリリストを使用して増分バックアップを高速化することを推奨します。インベントリリストのストレージ料金は、OSS の請求書に含まれます。 OSS がインベントリリストを生成するには、一定の時間が必要です。インベントリリストが生成される前に、OSS オブジェクトのバックアップに失敗する場合があります。この場合、次のバックアップサイクルで OSS オブジェクトをバックアップできます。	oss-inventory-default
InventoryCleanupPolicy	string	任意	バックアップが完了したときにシステムがインベントリリストを削除するかどうかを指定します。このパラメーターは、OSS インベントリが使用されている場合にのみ有効です。有効な値： NO_CLEANUP：インベントリリストを削除しません。 DELETE_CURRENT：現在のインベントリリストを削除します。 DELETE_CURRENT_AND_PREVIOUS：すべてのインベントリリストを削除します。	NO_CLEANUP
IgnoreArchiveObject	boolean	任意	タスク統計および失敗したファイルリストにアーカイブタイプのオブジェクトをプロンプト表示しません。	true
FileDetail	object	任意	ファイルバックアップの詳細オプション。
UseVSS	boolean	任意	ボリュームシャドウコピーサービス (VSS) 機能を有効にするかどうかを指定します。有効な値： true：機能を有効にします。 false：機能を無効にします。	true
AdvPolicy	boolean	任意	詳細ポリシーを使用するかどうかを指定します。有効な値： true：詳細ポリシーを使用します。 false：詳細ポリシーを使用しません。	true
CommonNasDetail	object	任意	オンプレミス NAS バックアップの詳細オプション。
FullOnIncrementFail	boolean	任意	増分バックアップが失敗した場合にシステムが完全バックアップを実行するかどうかを指定します。有効な値： true：増分バックアップが失敗した場合、システムは完全バックアップを実行します。 false：増分バックアップが失敗した場合、システムは完全バックアップを実行しません。	true
FetchSliceSize	integer	任意	バックアップシャードのサイズ (ファイル数)。	100000
ClusterId	string	任意	バックアップクライアントグループの ID。オンプレミス NAS バックアップを実行すると、Cloud Backup は指定されたバックアップクライアントグループからクライアントを選択します。	cl-000**************ggu
CommonFileSystemDetail	object	任意	CPFS バックアップの詳細オプション。
FullOnIncrementFail	boolean	任意	増分バックアップが失敗した場合にシステムが完全バックアップを実行するかどうかを指定します。有効な値： true：増分バックアップが失敗した場合、システムは完全バックアップを実行します。 false：増分バックアップが失敗した場合、システムは完全バックアップを実行しません。	true
FetchSliceSize	integer	任意	バックアップシャードのサイズ (ファイル数)。	100000
CrossAccountType	string	任意	同じ Alibaba Cloud アカウント内または Alibaba Cloud アカウント間でデータをバックアップおよび復元するかどうかを指定します。デフォルト値：SELF_ACCOUNT。有効な値： SELF_ACCOUNT：同じ Alibaba Cloud アカウント内でデータをバックアップします。 CROSS_ACCOUNT：Alibaba Cloud アカウント間でデータをバックアップします。	SELF_ACCOUNT
CrossAccountUserId	integer	任意	現在の Alibaba Cloud アカウントに Alibaba Cloud アカウント間でのデータバックアップを許可するソース Alibaba Cloud アカウントの ID。	144**********732
CrossAccountRoleName	string	任意	ソース Alibaba Cloud アカウント内で作成され、現在の Alibaba Cloud アカウントに割り当てられて、現在の Alibaba Cloud アカウントが Alibaba Cloud アカウント間でデータをバックアップすることを承認する RAM ロールの名前。	hbrcrossrole

レスポンスフィールド

フィールド	型	説明	例
	object	CreatePolicyBindingsResponse
Success	boolean	呼び出しが成功したかどうかを示します。有効な値： true：呼び出しは成功しました。 false：呼び出しは失敗しました。	true
Code	string	HTTP ステータスコード。ステータスコード 200 は、呼び出しが成功したことを示します。	200
Message	string	返されるメッセージ。呼び出しが成功した場合、「successful」が返されます。呼び出しが失敗した場合、エラーメッセージが返されます。	successful
RequestId	string	リクエストの ID。	82CC5B6C-72F7-5D39-92F6-67887DF9AD46

例

成功レスポンス

JSONJSON

{
  "Success": true,
  "Code": "200",
  "Message": "successful",
  "RequestId": "82CC5B6C-72F7-5D39-92F6-67887DF9AD46"
}

エラーコード

HTTP ステータスコード	エラーコード	エラーメッセージ	説明
400	PolicyAlreadyBoundWithThisDataSource	This datasource has already been bound with the policy, please use another one.

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

変更履歴

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