スナップショット情報を一覧表示します。
操作説明
この API オペレーションは、現在のアカウントに表示される MicroSandbox スナップショットのリストを返します。
有効期限が切れておらず、Available ステータスのスナップショットのみが返されます。
4 つのフィルタリング方法がサポートされています: アカウントレベルでの一覧表示、関数によるフィルタリング、関数およびソース会話 ID によるフィルタリング、作成時の関数、ソース会話 ID、およびオペレーターによるフィルタリングです。
結果は、作成時間とスナップショット ID の降順で安定してページネーションされます。
ListSnapshots はクエリに検索インデックスを使用するため、短い期間内に結果整合性の遅延が発生する可能性があります。GetSnapshot およびスナップショットからの会話の作成では、プライマリテーブルからの強一貫性読み込みが使用されます。
今すぐお試しください
テスト
RAM 認証
リクエスト構文
GET /2023-03-30/snapshots HTTP/1.1リクエストパラメーター
|
パラメーター |
型 |
必須 / 任意 |
説明 |
例 |
| functionName |
string |
任意 |
関数名。 |
my-func |
| sessionId |
string |
任意 |
スナップショットの作成元のソース会話 ID。指定する場合は、functionName も指定する必要があります。 |
test-session-id-1 |
| qualifier |
string |
任意 |
関数のエイリアス。 |
alias |
| limit |
integer |
任意 |
返されるスナップショットの最大値。有効な値: 1～100。デフォルト値: 20。 |
20 |
| nextToken |
string |
任意 |
さらに結果を取得するために使用されるページネーショントークン。 |
caeba0be03****f84eb48b699f0a4883 |
レスポンスフィールド
|
フィールド |
型 |
説明 |
例 |
| ListSnapshotsOutput |
返されるスナップショット情報のリスト。 |
例
成功レスポンス
JSONJSON
{
"nextToken": "",
"snapshots": [
{
"snapshotId": "550e8400-e29b-41d4-a716-446655440000",
"status": "Available",
"createdTime": "2026-07-30T10:00:00Z",
"expiredTime": "2026-08-29T10:00:00Z",
"description": "本番環境用スナップショット",
"sourceSessionId": "custom-test-会話-id",
"functionName": "my-関数",
"qualifier": "production",
"resolvedVersion": "1",
"imageRepository": "registry-vpc.cn-hangzhou.aliyuncs.com/example/関数",
"imageDigest": "sha256:0123456789abcdef",
"osType": "linux",
"memoryMB": 3072,
"cpu": 2,
"diskSizeMB": 10240,
"artifactMemUsedSizeInB": 1073741824,
"artifactDiskUsedSizeInB": 2147483648,
"startCommand": "/code/start.sh",
"readyCommand": "/code/ready.sh",
"envs": {
"key": ""
}
}
]
}エラーコード
|
HTTP ステータスコード |
エラーコード |
エラーメッセージ |
説明 |
|---|---|---|---|
| 400 | IdempotentParameterMismatch | The request uses the same client token as a previous, but non-identical request. Do not reuse a client token with different requests, unless the requests are identical. |
完全なリストについては、「エラーコード」をご参照ください。
変更履歴
完全なリストについては、「変更履歴」をご参照ください。