Cloud Backup：UpdatePolicyBinding - Cloud Backup - Alibaba Cloud - - Alibaba Cloud ドキュメントセンター

ポリシーとデータソースの関連付けを変更します。

今すぐお試しください

この 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:UpdatePolicyBinding

update

*すべてのリソース。

*

なし

リクエストパラメーター

パラメーター	型	必須 / 任意	説明	例
PolicyId	string	必須	ポリシー ID。	po-000************ky9
DataSourceId	string	必須	データソース ID。	i-bp1************dtv
SourceType	string	必須	データソースタイプ。有効な値: UDM_ECS: ECS インスタンスバックアップ。 OSS: OSS バックアップ。 NAS: Alibaba Cloud NAS バックアップ。 COMMON_NAS: オンプレミス NAS バックアップ。 ECS_FILE: ECS File Backup Essential エディション。 File: オンプレミスファイルバックアップ。 COMMON_FILE_SYSTEM: CPFS バックアップ。 OTS: Tablestore バックアップ。	UDM_ECS
PolicyBindingDescription	string	任意	ポリシーバインディングの説明。	po-000**********5xx-i-2ze**********nw4
Disabled	boolean	任意	データソースに対してポリシーを一時停止するかどうかを指定します。 true: 一時停止。 false: 一時停止しない。	true
Source	string	任意	意味は SourceType の値によって異なります。 OSS: バックアップするプレフィックス。指定しない場合、バケットのルートディレクトリ全体がバックアップされます。単一のプレフィックスのみサポートされています。/backup をバックアップするには、このパラメーターを /backup に設定します。 ECS_FILE: バックアップするファイルディレクトリ。指定しない場合、すべてのディレクトリがバックアップされます。複数のディレクトリがサポートされています。/a および /b のファイルをバックアップするには、このパラメーターを ["/a", "/b"] に設定します。 File: バックアップするファイルディレクトリ。指定しない場合、すべてのディレクトリがバックアップされます。複数のディレクトリがサポートされています。/a および /b のファイルをバックアップするには、このパラメーターを ["/a", "/b"] に設定します。 COMMON_FILE_SYSTEM: 必須。バックアップするソースパス。複数のパスがサポートされています。/a および /b をバックアップするには、このパラメーターを ["/a", "/b"] に設定します。ルートパスをバックアップするには、このパラメーターを ["/"] に設定します。 COMMON_NAS: 必須。バックアップするソースパス。単一のパスのみサポートされています。/a をバックアップするには、このパラメーターを ["/a"] に設定します。ルートパスをバックアップするには、このパラメーターを ["/"] に設定します。 OTS: バックアップするデータテーブルのリスト。指定しない場合、すべてのデータテーブルがバックアップされます。複数のデータテーブルがサポートされています。データテーブル a および b をバックアップするには、このパラメーターを ["a", "b"] に設定します。	バックアップ/
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:5120
AdvancedOptions	object	任意	詳細オプション。
UdmDetail	object	任意	ECS インスタンスバックアップの詳細。
ExcludeDiskIdList	array	任意	保護する必要のないクラウドディスク ID のリスト。DiskIdList が空でない場合、このパラメーターは無視されます。
	string	任意	保護する必要のないクラウドディスク ID。	d-bp1************apo
DiskIdList	array	任意	保護が必要なクラウドディスク ID のリスト。すべてのクラウドディスクが保護されている場合、この値は空です。
	string	任意	保護が必要なクラウドディスク ID。	d-bp1************apo
SnapshotGroup	boolean	任意	スナップショット整合性グループを作成するかどうかを指定します。スナップショット整合性グループは、すべてのクラウドディスクタイプが ESSD の場合にのみサポートされます。	true
AppConsistent	boolean	任意	アプリケーション整合性スナップショットを作成するかどうかを指定します。アプリケーション整合性スナップショットは、すべてのクラウドディスクタイプが ESSD の場合にのみサポートされます。	false
RamRoleName	string	任意	このパラメーターは、AppConsistent が true に設定されている場合にのみ必須です。アプリケーション整合性スナップショットの作成に必要な RAM ロール名。	AliyunECSInstanceForHbrRole
PreScriptPath	string	任意	このパラメーターは、AppConsistent が true に設定されている場合にのみ必須です。アプリケーション整合性スナップショットの作成前に実行するフリーズ前スクリプトのパス。	/tmp/プレスクリプト.sh
PostScriptPath	string	任意	このパラメーターは、AppConsistent が true に設定されている場合にのみ必須です。アプリケーション整合性スナップショットの作成後に実行するポストスクリプトのパス。	/tmp/投稿スクリプト.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 在庫ファイルの生成には時間がかかります。在庫ファイルが生成される前にバックアップタスクが失敗する場合があります。次のサイクルを実行するまで待ってください。	30663060
InventoryCleanupPolicy	string	任意	バックアップ後に在庫ファイルを削除するかどうかを指定します。このパラメーターは、OSS 在庫が使用されている場合にのみ有効です。有効な値: NO_CLEANUP: 削除しません。 DELETE_CURRENT: 現在のファイルを削除します。 DELETE_CURRENT_AND_PREVIOUS: すべてのファイルを削除します。	NO_CLEANUP
IgnoreArchiveObject	boolean	任意	タスク統計および失敗したファイルリストからアーカイブオブジェクトを除外するかどうかを指定します。	true
CommonFileSystemDetail	object	任意	large ファイルシステムバックアップの詳細。
FullOnIncrementFail	boolean	任意	増分バックアップが失敗した場合に完全バックアップに切り替えるかどうかを指定します。有効な値: true: 失敗時に完全バックアップに切り替えます。 false: 失敗時に完全バックアップに切り替えません。	true
FetchSliceSize	integer	任意	サブタスクのスライスサイズ (ファイル数)。	100000

レスポンスフィールド

フィールド	型	説明	例
	object	UpdatePolicyBindingResponse。
Success	boolean	リクエストが成功したかどうかを示します。 true: 成功。 false: 失敗。	true
Code	string	リターンコード。値が 200 の場合は成功を示します。	200
Message	string	返されるメッセージ。リクエストが成功した場合は "successful" という値が返されます。リクエストが失敗した場合はエラーメッセージが返されます。	successful
RequestId	string	リクエスト ID。	B6F24C46-54B9-519B-9AB8-A8988D705E67

例

成功レスポンス

JSONJSON

{
  "Success": true,
  "Code": "200",
  "Message": "successful",
  "RequestId": "B6F24C46-54B9-519B-9AB8-A8988D705E67"
}

エラーコード

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

変更履歴

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