> ## Documentation Index
> Fetch the complete documentation index at: https://docs.squarecloud.app/llms.txt
> Use this file to discover all available pages before exploring further.

# 列出 snapshot

> 获取所有 snapshot 的列表。

<ParamField header="Authorization" type="string" placeholder="API Key" required>
  你账户的 API 密钥。你可以在[账户设置](https://squarecloud.app/zh/account/security)中找到它。
</ParamField>

### 参数

<ParamField query="scope" type="string" default="applications">
  指定要检索的 snapshot 类型。

  * `applications`（默认）：返回应用的 snapshot
  * `databases`：返回数据库的 snapshot
</ParamField>

### 响应

<ResponseField name="status" type="string">
  指示调用是否成功。成功时为 `success`，否则为 `error`。
</ResponseField>

<ResponseField name="response" type="object">
  响应的内容。

  <Expandable title="展开对象">
    <ResponseField name="name" type="string">
      该 snapshot 所属应用的 ID。
    </ResponseField>

    <ResponseField name="size" type="number">
      snapshot 的大小，单位为字节。
    </ResponseField>

    <ResponseField name="modified" type="string">
      snapshot 最后一次修改的日期。
    </ResponseField>

    <ResponseField name="key" type="string">
      snapshot 的 AWS 访问密钥。
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseExample>
  ```json Response theme={null}
  {
    "status": "success",
    "response": [
      {
        "name": "1d2cdc0d6ebd435c91315c6329d12eab",
        "size": 12900705,
        "modified": "2024-06-27T06:23:42.326Z",
        "key": "AWSAccessKeyId=accesskey"
      },
      {
        "name": "1d2cdc0d6ebd435c91315c6329d12eab",
        "size": 12900705,
        "modified": "2024-06-26T07:05:40.000Z",
        "key": "AWSAccessKeyId=accesskey"
      }
    ]
  }
  ```
</ResponseExample>

<Note>下载所需 snapshot 的 URL 格式为：[https://snapshots.squarecloud.app/applications/\{accountID}/\{name}.zip?\{key}](https://snapshots.squarecloud.app/applications/\{accountID}/\{name}.zip?\{key})</Note>