ListSnapshots - Function Compute: Central de Documentação do Alibaba Cloud

Descrição da operação

Esta operação de API lista os snapshots do MicroSandbox visíveis para a conta atual.
Apenas snapshots não expirados no estado Available são retornados.
Quatro métodos de filtragem são suportados: listagem no nível da conta, filtragem por função, filtragem por função e ID da sessão de origem, e filtragem por função, ID da sessão de origem e qualificador no momento da criação.
Os resultados são paginados em ordem decrescente estável por hora de criação e ID do snapshot.
ListSnapshots usa um índice de pesquisa para consultas, portanto, atrasos de consistência eventual podem ocorrer dentro de um curto período. GetSnapshot e a criação de uma sessão a partir de um snapshot usam leituras fortemente consistentes da tabela primária.

Experimente agora

Experimente esta API no OpenAPI Explorer, sem necessidade de assinatura manual. Chamadas bem-sucedidas geram automaticamente código SDK correspondente aos seus parâmetros. Faça o download com segurança de credenciais integrada para uso local.

Testar

Autorização RAM

Nenhuma autorização necessária para esta operação. Se você encontrar problemas com esta operação, entre em contato com o suporte técnico.

Sintaxe da solicitação

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

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
functionName	string	Não	O nome da função.	my-func
sessionId	string	Não	O ID da sessão de origem a partir da qual o snapshot foi criado. Quando especificado, functionName também deve ser especificado.	test-session-id-1
qualifier	string	Não	O alias da função.	alias
limit	integer	Não	O número máximo de snapshots a serem retornados. Valores válidos: 1 a 100. Valor padrão: 20.	20
nextToken	string	Não	O token de paginação usado para recuperar mais resultados.	caeba0be03****f84eb48b699f0a4883

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	ListSnapshotsOutput	A lista de informações de snapshots retornada.

Exemplos

Resposta de sucesso

JSON formato

{
  "nextToken": "",
  "snapshots": [
    {
      "snapshotId": "550e8400-e29b-41d4-a716-446655440000",
      "status": "Available",
      "createdTime": "2026-07-30T10:00:00Z",
      "expiredTime": "2026-08-29T10:00:00Z",
      "description": "Snapshot para ambiente de produção",
      "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": ""
      }
    }
  ]
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
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.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.