> ## 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 path="database_id" type="string" placeholder="Database ID" required>
  数据库的 ID。
</ParamField>

### 响应

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

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

  <Expandable title="展开对象">
    <ResponseField name="name" type="string">
      你托管在 Square Cloud 上的数据库的 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":"a14b8d5e1cb7405a851eb4c075506121",
        "size":10644463,
        "modified":"2025-08-13T13:29:11.263Z",
        "key":"AWSAccessKeyId=accesskey&Expires=1757683751&Signature=VZ03MSxcNw3%2FtPezXv0IhTs0jq4%3D&versionId=45ec0b49-9af6-445e-a55c-abd7ec5278b2"
      },
      {
        "name":"a14b8d5e1cb7405a851eb4c075506121",
        "size":2742383,
        "modified":"2025-08-13T00:01:47.010Z",
        "key":"AWSAccessKeyId=accesskey&Expires=1757683751&Signature=7zw5apjyaOd1xPZl3gRgp8Y4yEs%3D&versionId=f65e1378-8717-45c5-8aec-bb233eedb5ce"
      }
    ]
  }
  ```
</ResponseExample>

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