特定のリージョンに自動スナップショットポリシーを作成します。自動スナップショットポリシーでは、自動スナップショットを作成するスケジュール、自動スナップショットの保持期間、およびスナップショットのクロスリージョンレプリケーションを有効にするかどうかを指定できます。自動スナップショットポリシーを適用して、システムディスクまたはデータディスクのスナップショットを作成し、ディスクデータをバックアップできます。
操作説明
この操作を呼び出す前に、「自動スナップショットポリシーの作成」をご参照ください。
次の点にご注意ください:
1 つの Alibaba Cloud アカウントで、リージョンごとに最大 100 個の自動スナップショットポリシーを作成できます。ディスクの自動スナップショットの最大数に達し、新しいスナップショット作成タスクが作成されると、システムはディスクの最も古い自動スナップショットを削除します。
ディスクがアタッチされているインスタンスが停止中または再起動中の場合、システムは関連付けられた自動スナップショットポリシーに基づいてディスクのスナップショットを作成できません。
クロスリージョンレプリケーションが有効で、暗号化パラメーターが設定されていない場合、暗号化されたスナップショットはターゲットリージョンにコピーされ、スナップショットコピーはターゲットリージョンのサービスキーを使用して暗号化されます。クロスリージョンレプリケーションの制限事項の詳細については、「スナップショットのコピー」をご参照ください。
自動スナップショットポリシーを作成した後、ApplyAutoSnapshotPolicy 操作を呼び出してポリシーをディスクに適用します。自動スナップショットポリシーを変更する場合は、ModifyAutoSnapshotPolicyEx 操作を呼び出します。
今すぐお試しください
テスト
RAM 認証
|
アクション |
アクセスレベル |
リソースタイプ |
条件キー |
依存アクション |
|
ecs:CreateAutoSnapshotPolicy |
create |
*AutoSnapshotPolicy
|
なし | なし |
リクエストパラメーター
|
パラメーター |
型 |
必須 / 任意 |
説明 |
例 |
| regionId |
string |
必須 |
自動スナップショットポリシーを作成するリージョンの ID。 DescribeRegions 操作を呼び出して、最新のリージョンリストを照会できます。 |
cn-hangzhou |
| autoSnapshotPolicyName |
string |
任意 |
自動スナップショットポリシーの名前。長さは 2~128 文字である必要があります。名前は文字で始まる必要があり、http:// または https:// で始めることはできません。名前に使用できる文字は、英字、数字、コロン (:)、アンダースコア (_)、ハイフン (-) です。 デフォルトでは、このパラメーターは空のままです。 |
TestName |
| timePoints |
string |
必須 |
自動スナップショットを作成する時刻。時刻は UTC+8 である必要があります。単位:時間。有効値:0~23。これは 00:00:00 から 23:00:00 までの 24 の正時を表します。たとえば、1 は 01:00:00 を示します。形式の説明:
説明
自動スナップショットが作成されているときに、別の自動スナップショットを作成する予定時刻になった場合、新しいスナップショットタスクはスキップされます。これは、ディスクに大量のデータが含まれている場合に発生する可能性があります。たとえば、09:00、10:00、11:00、12:00 に自動的に作成されるようにスナップショットをスケジュールしたとします。システムは 09:00:00 にディスクのスナップショットの作成を開始します。ディスクに大量のデータが含まれているため、このプロセスは 80 分かかり、10:20:00 に終了します。システムは 10:00:00 にスケジュールされた自動スナップショットタスクをスキップし、11:00:00 にディスクの次の自動スナップショットを作成します。 |
["0", "1", … "23"] |
| repeatWeekdays |
string |
必須 |
自動スナップショットを作成する曜日。有効値:1~7。これは月曜日から日曜日までを表します。1 は月曜日を示します。形式の説明:
|
["1","2"] |
| retentionDays |
integer |
必須 |
自動スナップショットの保持期間。単位:日。有効値:
デフォルト値:-1。 |
30 |
| EnableCrossRegionCopy |
boolean |
任意 |
スナップショットのクロスリージョンレプリケーションを有効にするかどうかを指定します。
|
false |
| TargetCopyRegions |
string |
任意 |
スナップショットをコピーするターゲットリージョン。指定できるターゲットリージョンは 1 つだけです。 |
["cn-hangzhou"] |
| StorageLocationArn |
string |
任意 |
説明
このパラメーターは公開されていません。 |
null |
| CopiedSnapshotsRetentionDays |
integer |
任意 |
ターゲットリージョンでのスナップショットコピーの保持期間。単位:日。有効値:
デフォルト値:-1。 |
30 |
| Tag |
array<object> |
任意 |
自動スナップショットポリシーに追加するタグ。 |
|
|
object |
任意 |
|||
| Key |
string |
任意 |
自動スナップショットポリシーに追加するタグ N のキー。N の有効値:1~20。タグキーは空の文字列にできません。タグキーは最大 128 文字で、http:// または https:// を含めることはできません。タグキーを acs: または aliyun で始めることはできません。 |
TestKey |
| Value |
string |
任意 |
自動スナップショットポリシーに追加するタグ N の値。N の有効値:1~20。タグ値は空の文字列にできます。タグ値は最大 128 文字で、http:// または https:// を含めることはできません。タグ値を acs: で始めることはできません。 |
TestValue |
| ResourceGroupId |
string |
任意 |
リソースグループ ID。 |
rg-aek2kkmhmhs**** |
| CopyEncryptionConfiguration |
object |
任意 |
クロスリージョンスナップショットレプリケーションの暗号化パラメーター。 |
|
| Encrypted |
boolean |
任意 |
クロスリージョンスナップショットのレプリケーションと暗号化を有効にするかどうかを指定します。有効値:
デフォルト値:false。 |
false |
| KMSKeyId |
string |
任意 |
クロスリージョンスナップショットのレプリケーションと暗号化に使用される Key Management Service (KMS) キーの ID。 |
0e478b7a-4262-4802-b8cb-00d3fb40826X |
| Arn |
array<object> |
任意 |
説明
このパラメーターは公開されていません。 |
|
|
object |
任意 |
|||
| RoleType |
string |
任意 |
説明
このパラメーターは公開されていません。 |
hide |
| Rolearn |
string |
任意 |
説明
このパラメーターは公開されていません。 |
hide |
| AssumeRoleFor |
integer |
任意 |
説明
このパラメーターは公開されていません。 |
1000000000 |
レスポンスフィールド
|
フィールド |
型 |
説明 |
例 |
|
object |
|||
| AutoSnapshotPolicyId |
string |
自動スナップショットポリシー ID。 |
sp-bp12m37ccmxvbmi5**** |
| RequestId |
string |
リクエスト ID。 |
473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E |
例
成功レスポンス
JSONJSON
{
"AutoSnapshotPolicyId": "sp-bp12m37ccmxvbmi5****",
"RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E"
}
エラーレスポンス
JSONJSON
{
"RequestId":"F3CD6886-D8D0-4FEE-B93E-1B73239673DE"
"AutoSnapshotPolicyId":"p-233e6ylv0"
}
エラーコード
|
HTTP ステータスコード |
エラーコード |
エラーメッセージ |
説明 |
|---|---|---|---|
| 400 | DiskCategory.OperationNotSupported | The type of the specified disk does not support creating a snapshot. | |
| 400 | InvalidSnapshotPolicyName.Malformed | The specified autoSnapshotPolicyName is wrongly formed. | |
| 400 | Duplicate.TagKey | The Tag.N.Key contain duplicate key. | |
| 400 | InvalidTagKey.Malformed | The specified Tag.n.Key is not valid. | |
| 400 | InvalidTagValue.Malformed | The specified Tag.n.Value is not valid. | |
| 400 | InvalidParameter.EncryptedIllegal | The specified parameter Encrypted must be true when kmsKeyId is not empty. | |
| 400 | InvalidParameter.KmsNotEnabled | Failed to perform this operation because KMS is not activated. | |
| 400 | InvalidParameter.Encrypted.KmsNotEnable | Failed to perform this operation because KMS is not activated. | |
| 400 | InvalidParam.EncryptedMismatch | Creating encrypted disks with shared encrypted image requires replacing encryption keys. | |
| 403 | ParameterInvalid | The specified RegionId parameter is invalid. | |
| 403 | AutoSnapshotPolicy.QuotaExceed | The maximum number of automatic snapshot policy has been reached. | |
| 403 | InvalidAccountStatus.NotEnoughBalance | Your account does not have enough balance. | |
| 403 | InvalidAccountStatus.SnapshotServiceUnavailable | Snapshot service has not been opened yet. | |
| 403 | InvalidParameter.TargetCopyRegions | The specified TargetCopyRegions is invalid. | |
| 403 | InvalidParameter.CopiedSnapshotsRetentionDays | The specified CopiedSnapshotsRetentionDays is invalid. | |
| 403 | InvalidParameter.KMSKeyId.KMSUnauthorized | ECS service have no right to access your KMS. | |
| 403 | InvalidOperation.KMSKeyIdNotFound | The specified KMSKeyId not found, %s. | |
| 403 | Abs.InvalidAction.RegionNotSupport | This region does not support this action. | |
| 403 | InvalidParameter.KMSKeyId.CMKNotEnabled | The CMK (Customer Master Key) must be in an active state. | |
| 403 | InvalidParameter.KMSKeyId.CMKUnauthorized | The CMK(Customer Master Key) lacks authorization to add tags to the ECS service. | |
| 403 | InvalidStorageLocationArn.Malformed | The specified parameter StorageLocationArn is wrongly formed. | |
| 404 | InvalidResourceGroup.NotFound | The ResourceGroup provided does not exist in our records. |
完全なリストについては、「エラーコード」をご参照ください。
変更履歴
完全なリストについては、「変更履歴」をご参照ください。