指定されたリージョンに自動スナップショットポリシーを作成します。自動スナップショットの繰り返し頻度、保持期間、およびクロスリージョンバックアップ設定を指定して、システムクラウドディスクまたはデータクラウドディスクのスナップショットバックアップを作成できます。
操作説明
この操作の呼び出し前に、自動スナップショットポリシーの作成 を読み取りください。
この操作の呼び出し時は、次の項目に注意してください。
-
各 Alibaba Cloud アカウントにつき、リージョンごとに自動スナップショットポリシーを最大値 100 個まで作成できます。ディスクの自動スナップショットの数がクォータに達すると、新しいスナップショットタスクが開始されたときに、システムは自動スナップショットポリシーによって作成された最も古い自動スナップショットを削除します。
-
ECS インスタンスに保留中の停止または再起動タスクがある場合、システムは自動スナップショットポリシーを実行することはありません。
-
クロスリージョンスナップショットレプリケーションが有効になっており、暗号化パラメーターが設定されていない場合、暗号化されたスナップショットはデフォルトで送信先リージョンのサービスキーを使用して暗号化されます。クロスリージョンスナップショットレプリケーションの詳細については、「スナップショットのコピー」を参照してください。
自動スナップショットポリシーを作成した後、 ApplyAutoSnapshotPolicy を呼び出してポリシーをターゲットディスクに適用します。自動スナップショットポリシーを変更するには、 ModifyAutoSnapshotPolicyEx を呼び出します。
今すぐお試しください
テスト
RAM 認証
|
アクション |
アクセスレベル |
リソースタイプ |
条件キー |
依存アクション |
|
ecs:CreateAutoSnapshotPolicy |
create |
*AutoSnapshotPolicy。
|
なし | なし |
リクエストパラメーター
|
パラメーター |
型 |
必須 / 任意 |
説明 |
例 |
| regionId |
string |
必須 |
自動スナップショットポリシーのリージョン ID。 DescribeRegions を呼び出して、最新のリージョンリストを照会できます。 |
cn-hangzhou |
| autoSnapshotPolicyName |
string |
任意 |
自動スナップショットポリシーの名前。名前は 2~128 文字である必要があります。名前は英字で始める必要があり、http:// または https:// で始めることはできません。名前には数字、コロン (:)、アンダースコア (_)、およびハイフン (-) を含めることができます。 デフォルト値: null。 |
TestName |
| timePoints |
string |
必須 |
自動スナップショットが作成されるポイント。時刻は 協定世界時 (UTC)+8 で表示されます。単位: 時間。有効な値: 0~23。00:00~23:00 の 24 ポイントに対応します。たとえば、1 は 01:00 を示します。形式の説明:
説明
ディスクに large な量のデータが含まれており、単一の自動スナップショットの作成に必須となる時間が連続する 2 つのポイントの間隔を超えた場合、次のポイントは自動的にスキップされます。たとえば、自動スナップショット作成のポイントとして 09:00、10:00、11:00、および 12:00 をセットしたとします。ディスクに large な量のデータが含まれているため、スナップショットの作成は 09:00 に開始され、10:20 に完了し、80 分かかります。システムは 10:00 のポイントをスキップし、次の自動スナップショットを 11: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 |
| CopyEncryptionConfiguration |
object |
任意 |
スナップショットの地理的冗長性に関するバックアップの暗号化パラメーターオブジェクト。 |
|
| Arn |
array<object> |
任意 |
説明
このパラメーターは公開されていません。 |
|
|
object |
任意 |
|||
| AssumeRoleFor |
integer |
任意 |
説明
このパラメーターは公開されていません。 |
1000000000 |
| RoleType |
string |
任意 |
説明
このパラメーターは公開されていません。 |
hide |
| Rolearn |
string |
任意 |
説明
このパラメーターは公開されていません。 |
hide |
| Encrypted |
boolean |
任意 |
クロスリージョンスナップショットバックアップの暗号化を有効にするかどうかを指定します。有効な値:
デフォルト値: false。 |
false |
| KMSKeyId |
string |
任意 |
クロスリージョンの暗号化されたスナップショットバックアップに使用される KMS キー ID。 |
0e478b7a-4262-4802-b8cb-00d3fb40826X |
| ResourceGroupId |
string |
任意 |
リソースグループ ID。 |
rg-aek2kkmhmhs**** |
| Tag |
array<object> |
任意 |
自動スナップショットポリシーのタグ。 |
|
|
object |
任意 |
|||
| Key |
string |
任意 |
自動スナップショットポリシーのタグキー。N の有効な値: 1~20。タグキーは空の文字列にすることはできません。タグキーの長さは最大 128 文字で、aliyun または acs: で始めることはできません。タグキーに http:// または https:// を含めることはできません。 |
TestKey |
| Value |
string |
任意 |
自動スナップショットポリシーのタグ値。N の有効な値: 1~20。タグ値は空の文字列にすることができます。タグ値の長さは最大 128 文字で、acs: で始めることはできません。タグ値に http:// または https:// を含めることはできません。 |
TestValue |
| AssociationType |
string |
任意 |
自動スナップショットポリシーとターゲットリソース間の関連付けタイプ。有効な値:
デフォルト値: AssociatedWithDisk。 説明
現在、インスタンスのタグとの関連付けをサポートしているのは次のリージョンのみです:マレーシア (クアラルンプール)、マレーシア (ジョホール)、フィリピン (マニラ)、イギリス (ロンドン)、フランス (パリ)、サウジアラビア (リヤド) - パートナー、UAE (ドバイ)、中国北部 5 (フフホト)、中国北西部 2 (中衛)、中国南西部 1 (成都)、ブラジル (サンパウロ)、タイ (バンコク)、中国南部 3 (広州)、中国南部 2 (河源)、中国 (香港)、ドイツ (フランクフルト)、メキシコ、アメリカ (バージニア)、中国東部 1 (杭州)、中国北部 1 (青島)、中国北部 2 (北京)、中国東部 2 (上海)、シンガポール、日本 (東京)。 |
AssociatedWithDisk |
| TargetTags |
array<object> |
任意 |
ターゲットリソースタグのリスト。自動スナップショットポリシーはタグに基づいてターゲットリソースをマッチングします。
このパラメーターは |
|
|
object |
任意 |
ターゲットリソースタグ。 |
||
| Key |
string |
任意 |
タグキー。 N の有効な値: 1~5。 タグキーは空の文字列にすることはできません。タグキーの長さは最大 128 文字で、aliyun または acs: で始めることはできません。タグキーに http:// または https:// を含めることはできません。 |
TestKey |
| Value |
string |
任意 |
タグ値。 N の有効な値: 1~5。 タグ値の長さは最大 128 文字で、 説明
空の値または空の文字列を渡すと、任意の値を示します。 |
TestValue |
レスポンスフィールド
|
フィールド |
型 |
説明 |
例 |
|
object |
|||
| AutoSnapshotPolicyId |
string |
自動スナップショットポリシーの ID。 |
sp-bp12m37ccmxvbmi5**** |
| RequestId |
string |
リクエスト ID |
473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E |
例
成功レスポンス
JSONJSON
{
"AutoSnapshotPolicyId": "sp-bp12m37ccmxvbmi5****",
"RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E"
}
エラーコード
|
HTTP ステータスコード |
エラーコード |
エラーメッセージ |
説明 |
|---|---|---|---|
| 400 | DiskCategory.OperationNotSupported | The type of the specified disk does not support creating a snapshot. | 現在のディスクタイプはこの操作をサポートしていません。 |
| 400 | InvalidSnapshotPolicyName.Malformed | The specified autoSnapshotPolicyName is malformed. | |
| 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 Encrypted parameter must be set to true when KMSKeyId is specified. Please adjust the parameters and try again. | |
| 400 | InvalidParameter.KmsNotEnabled | The operation failed because KMS is not activated. Please activate KMS in the KMS console and try again. | |
| 400 | InvalidParameter.Encrypted.KmsNotEnable | The operation failed because KMS is not activated. Please activate KMS in the KMS console and try again. | |
| 400 | InvalidParam.EncryptedMismatch | Creating a disk from a shared encrypted image requires encryption with your own KMS key. Please set the Encrypted parameter to true. | |
| 400 | InvalidAssociationType.Malformed | The specified parameter AssociationType is invalid. Please check the valid range for this parameter. | |
| 400 | MissingParameter.TargetTags | When the parameter AssociationType is set to AssociatedWithInstanceTag, the TargetTags parameter is required. | |
| 400 | InvalidTargetTags.NotSupported | When the parameter AssociationType is set to AssociatedWithDisk, the TargetTags parameter is not supported. | |
| 400 | InvalidTargetTagKey.Malformed | The specified TargetTag.n.Key [%s] is not valid. | |
| 400 | InvalidTargetTagValue.Malformed | The specified TargetTag.n.Value [%s] is not valid. | |
| 400 | Duplicate.TargetTagKey | Duplicate keys exist in the specified parameter TargetTags. Please ensure key uniqueness. | |
| 400 | InvalidTargetTag.LimitExceed | The number [%s] of the specified parameter TargetTag exceeds the limit [%s]. | |
| 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 does not have permission to access your KMS key. Please verify that the specified KMS key has authorized the ECS service. | |
| 403 | InvalidOperation.KMSKeyIdNotFound | The specified KMSKeyId does not exist. Please verify that the key ID is correct and that the key resides in the current region. | |
| 403 | Abs.InvalidAction.RegionNotSupport | This region does not support this action. | このリージョンではこの操作はサポートされていません。 |
| 403 | InvalidParameter.KMSKeyId.CMKNotEnabled | The specified KMS key must be in an enabled state. Please enable the key in the KMS console and try again. | |
| 403 | InvalidParameter.KMSKeyId.CMKUnauthorized | The specified KMS key is not authorized for the ECS service. Please grant the ECS service permission to use the key in the KMS console and try again. | |
| 403 | InvalidStorageLocationArn.Malformed | The specified parameter StorageLocationArn is malformed. | |
| 403 | InvalidOperation.UserNotInWhiteList | The current user is temporarily unable to use this feature. Please submit a ticket for assistance. | |
| 404 | InvalidResourceGroup.NotFound | The ResourceGroup provided does not exist in our records. | Record にリソースグループが見つかりません。 |
完全なリストについては、「エラーコード」をご参照ください。
変更履歴
完全なリストについては、「変更履歴」をご参照ください。