スナップショットの名前、説明、または保持期間を変更します。
今すぐお試しください
テスト
RAM 認証
|
アクション |
アクセスレベル |
リソースタイプ |
条件キー |
依存アクション |
|
ecs:ModifySnapshotAttribute |
update |
*Snapshot
|
なし | なし |
リクエストパラメーター
|
パラメーター |
型 |
必須 / 任意 |
説明 |
例 |
| SnapshotId |
string |
必須 |
スナップショットの ID。 |
s-bp199lyny9bb47pa**** |
| SnapshotName |
string |
任意 |
スナップショットの表示名。名前の長さは 2~128 文字である必要があります。先頭は英字または漢字にする必要があり、http:// または https:// で始めることはできません。数字、コロン (:)、アンダースコア (_)、ハイフン (-) を含めることができます。自動スナップショットとの名前の競合を防ぐため、名前の先頭を auto にすることはできません。 |
testSnapshotName |
| Description |
string |
任意 |
スナップショットの説明。説明は空にすることができ、最大 256 文字です。http:// または https:// で始めることはできません。 |
testDescription |
| DisableInstantAccess |
boolean |
任意 |
スナップショットがすぐにアクティブな状態になるスナップショット即時アクセス特徴のシャットダウンを開始するかどうかを指定します。有効な値:
デフォルト値: false。 説明
[非推奨] このパラメーターは非推奨です。ESSD ディスク (ESSD (エンタープライズ SSD)、標準 SSD とは異なる) の標準スナップショットは、デフォルトで即時アクセス にアップグレードされます。追加の設定は不要で、追加料金も発生しません。 |
false |
| RetentionDays |
integer |
任意 |
スナップショットの保持期間 (日数)。このパラメーターを指定すると、保持期間はスナップショットの 作成時間 から計算されます。作成時間は、ISO 8601 規格の yyyy-MM-ddTHH:mm:ssZ 初期化および 協定世界時 (UTC)+0 で表示されます。有効な値: 1~65536。 説明
スナップショットの保持期間は延長のみ可能です。既存のスナップショットの保持期間を短縮することはできません。 |
10 |
レスポンスフィールド
|
フィールド |
型 |
説明 |
例 |
|
object |
|||
| RequestId |
string |
リクエスト ID |
473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E |
例
成功レスポンス
JSONJSON
{
"RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E"
}
エラーコード
|
HTTP ステータスコード |
エラーコード |
エラーメッセージ |
説明 |
|---|---|---|---|
| 400 | InvalidSnapshotName.Malformed | The specified SnapshotName is malformed. | |
| 400 | NoAttributeToModify | No attribute to be modified in this request. | |
| 400 | InvalidRetentionDays.Malformed | The specified RetentionDays is not valid. | 指定された保持日数の値は無効です。RetentionDays パラメーター値が正しいかどうかを確認してください。 |
| 400 | InvalidOperation.DecreaseRetentionDaysUnsupported | The requested operation to decrease retention days for the snapshot is not supported. | スナップショットの保持期間の短縮はサポートされていません。 |
| 400 | InvalidSnapshotId.NotReady | The specified snapshot has not completed yet. | 指定されたスナップショットは完了していません。 |
| 400 | IncorrectDiskStatus.CreatingSnapshot | A previous snapshot creation is in process. | 現在のディスクのスナップショットが作成中です。スナップショットの作成が完了するまで待ってから、もう一度お試しください。 |
| 403 | InvalidOperation.ResourceManagedByCloudProduct | The current operation is not supported because the resource is managed by a cloud product. Please contact the relevant cloud product to confirm the reason. | クラウドサービスのマネージドセキュリティグループは変更操作をサポートしていません。 |
| 403 | InvalidOperation.DefaultFreeSnapshotNotSupport | The specified snapshot is a default free snapshot and does not support this operation. | 指定されたスナップショットはデフォルトの無料スナップショットであるため、現在の操作はサポートされていません。 |
| 404 | InvalidDescription.Malformed | The specified parameter Description is not valid. Please ensure that the description is 2 to 256 characters long and does not start with "http://" or "https://" and try again. | 指定されたリソースの説明の形式が無効です。説明は 2 ~ 256 文字で、http:// または https:// で始めることはできません。 |
| 404 | InvalidSnapshotId.NotFound | The specified SnapshotId does not exist. | |
| 404 | InvalidSnapshotDisableInstantAccess.Malformed | The specified DisableInstantAccess is not valid! |
完全なリストについては、「エラーコード」をご参照ください。
変更履歴
完全なリストについては、「変更履歴」をご参照ください。