ListSnapshots - Function Compute - Centre de documentation Alibaba Cloud

Description de l'opération

Cette opération d'API répertorie les instantanés MicroSandbox visibles pour le compte actuel.
Seuls les instantanés non expirés dont l'état est Available sont renvoyés.
Quatre méthodes de filtrage sont prises en charge : listage au niveau du compte, filtrage par fonction, filtrage par fonction et identifiant de session source, et filtrage par fonction, identifiant de session source et qualificateur au moment de la création.
Les résultats sont paginés selon un ordre décroissant stable en fonction de l'heure de création et de l'identifiant de l'instantané.
ListSnapshots utilise un index de recherche pour les requêtes, ce qui peut entraîner des délais de cohérence éventuelle sur une courte période. GetSnapshot et la création d'une session à partir d'un instantané utilisent des lectures à forte cohérence depuis la table principale.

Testez maintenant

Testez cette API dans OpenAPI Explorer, sans signature manuelle. Les appels réussis génèrent automatiquement du code SDK correspondant à vos paramètres. Téléchargez-le avec une sécurité intégrée des identifiants pour une utilisation locale. Testez cette API dans OpenAPI Explorer, sans signature manuelle. Les appels réussis génèrent automatiquement du code SDK correspondant à vos paramètres. Téléchargez-le avec une sécurité intégrée des identifiants pour une utilisation locale.

Test

Autorisation RAM

Aucune autorisation n'est requise pour cette opération. En cas de problème, contactez le support technique.

Syntaxe de la requête

GET /2023-03-30/snapshots HTTP/1.1

Paramètres de requête

Paramètre	Type	Requis	Description	Exemple
functionName	string	Non	Le nom de la fonction.	my-func
sessionId	string	Non	L'identifiant de la session source à partir de laquelle l'instantané a été créé. Lorsqu'il est spécifié, functionName doit également être spécifié.	test-session-id-1
qualifier	string	Non	L'alias de la fonction.	alias
limit	integer	Non	Le nombre maximal d'instantanés à renvoyer. Valeurs valides : 1 à 100. Valeur par défaut : 20.	20
nextToken	string	Non	Le jeton de pagination utilisé pour récupérer d'autres résultats.	caeba0be03****f84eb48b699f0a4883

Éléments de réponse

Élément	Type	Description	Exemple
	ListSnapshotsOutput	La liste des informations sur les instantanés renvoyée.

Exemples

JSON format

{
  "nextToken": "",
  "snapshots": [
    {
      "snapshotId": "550e8400-e29b-41d4-a716-446655440000",
      "status": "Available",
      "createdTime": "2026-07-30T10:00:00Z",
      "expiredTime": "2026-08-29T10:00:00Z",
      "description": "Instantané pour l'environnement de production",
      "sourceSessionId": "custom-test-session-id",
      "functionName": "my-function",
      "qualifier": "production",
      "resolvedVersion": "1",
      "imageRepository": "registry-vpc.cn-hangzhou.aliyuncs.com/example/function",
      "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": ""
      }
    }
  ]
}

Codes d'erreur

Code de statut HTTP	Code d'erreur	Message d'erreur	Description
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.

Consultez Codes d'erreur pour la liste complète.

Notes de version

Consultez Notes de version pour la liste complète.