获取 Memory Store

更新时间:
复制为 MD 格式

根据 ID 获取单个 Memory Store 的详细信息。

请求头

头部

必选

说明

Authorization

Bearer

路径参数

参数

类型

必选

说明

memory_store_id

string

Memory Store ID(memstore_ 前缀)

示例请求

curl -X GET "https://api.qoder.com.cn/api/v1/cloud/memory_stores/memstore_019e3bb8d50674d9b082b73709c29c87" \
  -H "Authorization: Bearer $QODER_PAT"

示例响应

HTTP 200 OK

{
  "id": "memstore_019e3bb8d50674d9b082b73709c29c87",
  "type": "memory_store",
  "name": "doc-test-store",
  "description": "测试用",
  "status": "active",
  "entry_count": 0,
  "total_size": 0,
  "metadata": {},
  "created_at": "2026-05-18T15:33:49.449264Z",
  "updated_at": "2026-05-18T15:33:49.449264Z"
}

响应字段

字段

类型

说明

id

string

唯一标识符

type

string

固定值 "memory_store"

name

string

存储名称

description

string

存储描述

status

string

状态:active / archived / deleted

entry_count

int64

记忆条目数量

total_size

int64

总存储大小(字节)

metadata

object

自定义元数据

archived_at

string

归档时间(仅归档状态有此字段)

created_at

string

创建时间(ISO 8601)

updated_at

string

最后更新时间(ISO 8601)

错误码

HTTP

type

触发条件

401

authentication_error

未提供或无效的认证令牌

404

not_found_error

指定 ID 的 Memory Store 不存在

错误响应示例:

{
  "type": "error",
  "error": {
    "type": "not_found_error",
    "message": "MemoryStore 'memstore_nonexistent' was not found."
  }
}

完整错误信封说明详见 错误参考