自動スナップショットポリシーを作成します。ディスクへの自動スナップショットポリシーを適用することができます(ApplyAutoSnapshotPolicy )。また、自動スナップショットポリシー変更することができます(ModifyAutoSnapshotPolicyEx)。
説明
このインターフェースを呼び出すときに、次の点を考慮します。
各リージョンの 100 の自動スナップショットポリシーを作成できます。
ディスクは、大量のデータが含まれており、スナップショット作成時間は、2つのスケジュールされた自動スナップショット時点の間隔を超えた場合、スナップショットは、第二の時点で採取されていません。
サンプル :ジミーは午前9時、10時、11時、および12時のスケジュールされた自動スナップショットの作成を設定します。最初の自動スナップショットは9時から始まり、10時20分で終了し、実際に消費時間は80分です。したがって、10:00にスケジュール設定されたスナップショットのタスクはスキップされ、別の自動スナップショットは11:00ジミーのために作成されます。
リクエストパラメータ
名 | 型 | 必須かどうか | 説明 |
---|---|---|---|
Action | String | はい | このインターフェイスの名前。値:CreateAutoSnapshotPolicy。 |
RegionId | String | はい | 自動スナップショットポリシーの範囲。詳細については、リージョンやゾーンを参照してください。 DescribeRegions 最新のリージョンのリストを取得します。 |
TimePoints | String | はい | 自動スナップショット作成スケジュール、および測定の単位は時間です。値の範囲:[0、23]、例えば 1 00:00 から 24:00 に表す 1:00 を示しています。一日でディスクに対して複数の自動スナップショットタスクをスケジュールするときは、アレイへの時点を設定することができます。
|
RepeatWeekdays | String | はい | 自動スナップショットの繰り返し日付。測定の単位は日であると繰り返し周期が一週間です。値の範囲:月曜日から日曜日までの出発日を表す[1,7]は、例えば、 1 月曜日示します。週にディスクに対して複数の自動スナップショットタスクをスケジュールするときは、配列に RepeatWeekdays を設定することができます。
|
RetentionDays | Integer | はい | スナップショットの保持時間、および測定の単位は日です。オプションの値:
|
AutoSnapshotPolicyName | String | ノー | 自動スナップショットポリシーの名前。
|
ClientToken | String | ノー | 冪等性を保証リクエスト 。値はクライアントによって生成されます。すべての要求で一意でなければならず、最大64文字の ASCII 文字で構成されます。詳細については、 冪等性の保証 。 |
応答パラメータ
名 | 型 | 説明 |
---|---|---|
AutoSnapshotPolicyId | String | 自動スナップショットポリシーの ID。 |
例
リクエストの例
https://ecs.aliyuncs.com/?Action=CreateAutoSnapshotPolicy&RegionId=cn-hangzhou&TimePoints=[“0”, “11 ”, “21 ”]&RepeatWeekdays=[“1” ,“2” ,“4” ,“7”]&RetentionDays=30&<Common Request Parameters>
レスポンス例
XML 方式
JSON 方式
<CreateAutoSnapshotPolicyResponse> <RequestId>F3CD6886-D8D0-4FEE-B93E-1B73239673DE</RequestId> <AutoSnapshotPolicyId>p-233e6ylv0</AutoSnapshotPolicyId></CreateAutoSnapshotPolicyResponse>
{ “RequestId”:”F3CD6886-D8D0-4FEE-B93E-1B73239673DE” “AutoSnapshotPolicyId”:”p-233e6ylv0”}
エラーコード
次のエラーコードは、このインターフェイスに固有のものです。より多くのエラーコードについては、APIエラーセンター。
エラーコード | エラーメッセージ | HTTP ステータスコード | 意味 |
---|---|---|---|
AutoSnapshotPolicy.QuotaExceed | 自動スナップショットポリシーの最大数に達しました。 | 403 | アリババクラウドアカウントは、1つのリージョンで最大100の自動スナップショットポリシーを作成することができます。 |
ParameterInvalid | 指定されたRegionIdパラメータが無効です。 | 404 | 指定されたRegionId パラメータが無効です。 |
ParameterInvalid | 指定されたRepeatWeekDaysパラメータが無効です。 | 404 | 指定されたRepeatWeekDays パラメータが無効です。 |
ParameterInvalid | 指定されたRetentionDaysパラメータが無効です。 | 404 | 指定されたRetentionDays パラメータが無効です。 |
ParameterInvalid | 指定された時点のパラメータが無効です。 | 404 | 指定されたTimePoints パラメータが無効です。 |