> ## 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.

# 列出快照

> 获取指定应用程序的快照列表。

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

### 参数

<ParamField path="app_id" type="string" placeholder="Application ID" required>
  应用程序的 ID。你可以在应用程序控制台的 URL 中找到它。
</ParamField>

### 响应

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

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

  <Expandable title="展开对象">
    <ResponseField name="name" type="string">
      你所获取快照的来源应用程序的 ID。
    </ResponseField>

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

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

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

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

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