CreateBackupPolicy API によるランサムウェア対策バックアップの自動化 - Security Center

今すぐお試しください

この 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 ロールに付与する必要があります。

アクション

アクセスレベル

リソースタイプ

条件キー

依存アクション

yundun-sas:CreateBackupPolicy

create

*BackupPolicy

acs:yundun-sas:{#regionId}:{#accountId}:backuppolicy/*

なし

リクエストパラメーター

パラメーター	型	必須 / 任意	説明	例
Name	string	必須	ランサムウェア対策ポリシーの名前。	ServerBackUpPolicy01
Policy	object	必須	IsDefault：ランサムウェア対策ポリシーのタイプ。有効な値は次のとおりです： 1：推奨ポリシー 0：カスタムポリシー Include：保護するファイルのフォーマット。すべてのフォーマットのファイルを保護する場合は、このフィールドを [] に設定します。 Source：保護するディレクトリ。すべてのディレクトリを保護する場合は、このフィールドを [] に設定します。 ExcludeSystemPath：特定のディレクトリをランサムウェア対策ポリシーから除外するかどうかを指定します。ディレクトリを除外する場合は、このフィールドを true に設定します。ディレクトリを除外しない場合は、このフィールドを空のままにします。 Exclude：ランサムウェア対策ポリシーから除外するディレクトリ。ディレクトリを除外しない場合は、このフィールドを [] に設定します。 Schedule：データバックアップタスクの開始時刻と間隔。オフピーク時間に開始し、正時には開始しない開始時刻を指定することを推奨します。例：このフィールドを I\|1583216092\|P21D に設定した場合、データバックアップタスクは 2020-03-03 14:14:52 から開始され、3 週間間隔で実行されます。このフィールドを I\|1583216092\|PT24H に設定した場合、データバックアップタスクは 2020-03-03 14:14:52 から開始され、24 時間間隔で実行されます。 Retention：バックアップデータを保持する期間。単位：日。このフィールドを 7 に設定した場合、バックアップデータは 1 週間保持されます。このフィールドを 365 に設定した場合、バックアップデータは 1 年間保持されます。このフィールドを -1 に設定した場合、バックアップデータは永久に保持されます。 SpeedLimiter：データバックアップタスクのネットワーク帯域幅の制限。このフィールドを 0:24:30720 に設定した場合、データバックアップタスクの最大帯域幅は 00:00 から 24:00 まで 30 MB/s になります。 UseVss：VSS 機能を有効にするかどうかを指定します。この機能は Windows サーバーでのみ利用可能です。有効な値は次のとおりです： true：はい false：いいえ説明 VSS 機能は、Windows サーバー用のランサムウェア対策ポリシーを作成する場合にのみ利用できます。この機能を有効にすると、実行中のプロセスによるバックアップの失敗が大幅に減少します。VSS 機能を有効にすることを推奨します。この機能を有効にすると、exFAT および FAT32 フォーマットのディスクのデータはバックアップできません。	"{"IsDefault":1,"Include":[],"Source":[],"Schedule":"I\|1648061040\|PT24H","Retention":7,"SpeedLimiter":"","ExcludeSystemPath":true,"Exclude":["/bin/","/usr/bin/","/sbin/","/boot/","/proc/","/sys/","/srv/","/lib/","/selinux/","/usr/sbin/","/run/","/lib32/","/lib64/","/lost+found/","/var/lib/kubelet/","/var/lib/ntp/proc","/var/lib/container","Windows","Python27","Program Files (x86)","Program Files","Boot","$RECYCLE.BIN","System Volume Information","Users\Administrator\NTUSER.DAT","ProgramData","pagefile.sys","Users\Default\NTUSER.DAT","Users\Administrator\ntuser.*"],"UseVss":true}"
PolicyVersion	string	必須	ランサムウェア対策ポリシーのバージョン。値を 2.0.0 に設定します。	2.0.0
PolicyRegionId	string	任意	Alibaba Cloud にデプロイされていないサーバーのリージョン ID。説明サーバーの場所から最も近い、サポートされているリージョンの ID を指定することを推奨します。DescribeSupportRegion 操作を呼び出して、ランサムウェア対策機能がサポートされているリージョンをクエリできます。	ch-hangzhou
UuidList	array	必須	保護するサーバーの UUID。	["3bb30859-b3b5-4f28-868f-b0892c98**", "3bb30859-b3b5-4f28-868f-b0892c98**"]
	string	任意	保護するサーバーの UUID。複数の UUID はコンマ (,) で区切ります。説明 DescribeCloudCenterInstances 操作を呼び出して、サーバーの UUID をクエリできます。	3bb30859-b3b5-4f28-868f-b0892c98****

レスポンスフィールド

フィールド	型	説明	例
	object	返されたデータ。
RequestId	string	リクエスト ID。問題の特定やトラブルシューティングに使用します。	24A20733-10A0-4AF6-BE6B-E3322413BB68
BackupPolicy	object	ランサムウェア対策ポリシーに関する情報。
Id	string	ランサムウェア対策ポリシーの ID。	1301575
Status	string	ランサムウェア対策ポリシーのステータス。有効な値は次のとおりです： enabled disabled 説明ランサムウェア対策ポリシーを作成すると、ポリシーはデフォルトで有効になります。	enabled

例

成功レスポンス

JSONJSON

{
  "RequestId": "24A20733-10A0-4AF6-BE6B-E3322413BB68",
  "BackupPolicy": {
    "Id": "1301575",
    "Status": "enabled"
  }
}

エラーコード

HTTP ステータスコード	エラーコード	エラーメッセージ
400	AgentNotOnline	The agent not online.
400	AntiRansomwareCapacityUseUp	anti ransomware capacity use up
400	DataExists	data exist
500	ServerError	ServerError
403	NoPermission	caller has no permission

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

変更履歴

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