LockSnapshot - Elastic Compute Service - Alibaba Cloud ドキュメントセンター

コンプライアンスモードでスナップショットをロックして、偶発的または悪意のある削除から保護します。スナップショットがロックされている間は削除できません。

操作説明

このインターフェイスを使用して、ロック済みのスナップショットを再設定することもできます。利用可能な設定オプションは、ロックモードとロックステータスによって異なります：

スナップショットがコンプライアンスモードでロックされており、クールオフ期間内である場合、クールオフ期間とロック期間を延長または短縮できます。
スナップショットがコンプライアンスモードでロックされており、クールオフ期間が期限切れの場合、ロック期間の延長のみ可能です。

説明

クールオフ期間中にロック済みのスナップショットを再設定すると、新しいロック操作が開始されます。この操作では、個別に調整するのではなく、すべてのロックパラメーターがリセットされます。

今すぐお試しください

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

アクション

アクセスレベル

リソースタイプ

条件キー

依存アクション

ecs:LockSnapshot

update

*Snapshot

acs:ecs:{#regionId}:{#accountId}:snapshot/{#SnapshotId}

なし

リクエストパラメーター

パラメーター	型	必須 / 任意	説明	例
RegionId	string	必須	リージョン ID。DescribeRegions 操作を呼び出して、Alibaba Cloud リージョンの最新リストをクエリできます。	cn-hangzhou
SnapshotId	string	必須	スナップショット ID。	s-9dp2qojdpdfmgfmf****
LockMode	string	必須	ロックモード。有効な値： `compliance`：コンプライアンスモードでスナップショットをロックします。コンプライアンスモードのスナップショットはロック解除できず、ロック期間が満了した後にのみ削除できます。ロック期間を短縮することはできませんが、必要な RAM 権限を持つユーザーはいつでも延長できます。コンプライアンスモードでスナップショットをロックする場合、オプションでクールオフ期間を指定できます。	compliance
LockDuration	integer	必須	スナップショットをロックする期間。この期間が終了すると、ロックは自動的に解除されます。単位：日。有効な値：1～36500。	1
CoolOffPeriod	integer	必須	クールオフ期間。コンプライアンスモードでは、クールオフ期間を設定するか、スキップしてスナップショットをすぐにロックすることができます。クールオフ期間中、必要な RAM 権限を持つユーザーは、スナップショットのロックを解除したり、クールオフ期間とロック期間を変更したりできます。クールオフ期間中はスナップショットを削除できません。クールオフ期間が終了した後は、ロック期間の延長のみ可能です。単位：時間。有効な値：0～72。値 `0` は、クールオフ期間がスキップされ、スナップショットがすぐにロックされることを示します。スナップショットがすでにコンプライアンスモードでロックされている場合、ロック期間を延長するには、このパラメーターを `0` に設定する必要があります。	3
DryRun	boolean	任意	リクエストのドライランを実行するかどうかを指定します。有効な値： `true`：実際の操作を実行せずにドライランを実行します。システムは、必須パラメーター、リクエスト形式、およびサービス制限を確認します。チェックが失敗した場合、システムは対応するエラーを返します。チェックが成功した場合、システムは `DryRunOperation` エラーコードを返します。 `false` (デフォルト)：通常のリクエストを送信し、チェックが成功した後に操作を実行します。	false
ClientToken	string	任意	リクエストのべき等性を保証するために提供するトークン。トークンには ASCII 文字のみを含めることができ、長さは 64 文字を超えることはできません。詳細については、「べき等性を確保する方法」をご参照ください。	5EC38E7D-389F-1925-ABE2-D7925A8F****

レスポンスフィールド

フィールド	型	説明	例
	object	応答スキーマ
RequestId	string	リクエスト ID。	473469C7-AA6F-4DC5-B3DB-A3DC0DE3****
LockedSnapshotInfo	object	ロックされたスナップショットに関する情報。
SnapshotId	string	スナップショット ID。	s-9dp2qojdpdfmgfmf****
LockMode	string	ロックモード。指定できる値： `compliance`：スナップショットはコンプライアンスモードでロックされます。このモードでロックされたスナップショットはロック解除できず、ロック期間が満了した後にのみ削除できます。ロック期間を短縮することはできませんが、必要な RAM 権限を持つユーザーはいつでも延長できます。コンプライアンスモードでスナップショットをロックする場合、オプションでクールオフ期間を指定できます。	compliance
LockStatus	string	ロックステータス。指定できる値： `compliance-cooloff`：スナップショットはコンプライアンスモードでロックされていますが、まだクールオフ期間中です。スナップショットは削除できませんが、必要な RAM 権限を持つユーザーは、スナップショットのロックを解除したり、クールオフ期間とロック期間を延長または短縮したりできます。 `compliance`：スナップショットはコンプライアンスモードでロックされており、クールオフ期間は期限切れです。スナップショットはロック解除または削除できませんが、必要な RAM 権限を持つユーザーはロック期間を延長できます。 `expired`：ロック期間が期限切れです。スナップショットは現在ロック解除されており、削除できます。	compliance-cooloff
LockCreationTime	string	スナップショットがロックされた時刻。時刻は協定世界時 (UTC) で、ISO 8601 規格に従って `yyyy-MM-ddTHH:mm:ssZ` 形式で表されます。	2025-10-15T10:00:00Z
CoolOffPeriod	integer	コンプライアンスモードのクールオフ期間。単位：時間。	3
CoolOffPeriodExpiredTime	string	コンプライアンスモードのクールオフ期間が満了する時刻。時刻は協定世界時 (UTC) で、ISO 8601 規格に従って `yyyy-MM-ddTHH:mm:ssZ` 形式で表されます。	2025-10-15T13:00:00Z
LockDuration	integer	ロック期間。この期間が満了すると、スナップショットは自動的にロック解除されます。単位：日。	1
LockDurationStartTime	string	ロック期間が開始される時刻。時刻は協定世界時 (UTC) で、ISO 8601 規格に従って `yyyy-MM-ddTHH:mm:ssZ` 形式で表されます。 `progressing` 状態のスナップショットをロックした場合、ロック期間はスナップショットが `accomplished` 状態になったときにのみ開始されます。	2025-10-15T10:00:00Z
LockExpiredTime	string	ロックが満了する時刻。時刻は協定世界時 (UTC) で、ISO 8601 規格に従って `yyyy-MM-ddTHH:mm:ssZ` 形式で表されます。	2025-10-16T10:00:00Z

例

成功レスポンス

JSONJSON

{
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3****",
  "LockedSnapshotInfo": {
    "SnapshotId": "s-9dp2qojdpdfmgfmf****",
    "LockMode": "compliance",
    "LockStatus": "compliance-cooloff",
    "LockCreationTime": "2025-10-15T10:00:00Z",
    "CoolOffPeriod": 3,
    "CoolOffPeriodExpiredTime": "2025-10-15T13:00:00Z",
    "LockDuration": 1,
    "LockDurationStartTime": "2025-10-15T10:00:00Z",
    "LockExpiredTime": "2025-10-16T10:00:00Z"
  }
}

エラーコード

HTTP ステータスコード	エラーコード	エラーメッセージ
400	InvalidLockMode.Malformed	The specified parameter LockMode is invalid. Please check the valid range for this parameter.
400	InvalidLockDuration.ExceedRetentionDays	The specified parameter LockDuration is invalid. The LockDuration should be less than the snapshot RetentionDays.
400	InvalidCoolOffPeriod.ExceedLockDuration	The specified parameter CoolOffPeriod is invalid. The CoolOffPeriod should be less than the LockDuration.
403	InvalidOperation.SnapshotNotAvailable	The unavailable snapshot does not support locking.
403	InvalidOperation.ResourceManagedByCloudProduct	The current operation is not supported because the resource is managed by a cloud product [%s]. Please contact the relevant cloud product to confirm the reason.
403	InvalidOperation.LockSharedSnapshotUnsupported	The shared snapshot does not support locking.
403	InvalidOperation.CoolOffPeriodExpired	The snapshot is locked in compliance mode, and the cool-off period has expired. The current operation is not supported.
404	InvalidSnapshotId.NotFound	The specified snapshot is not found

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

変更履歴

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