更新 API Key - MemoryLake 中国站

curl -X PATCH 'https://app.memorylake.cn/openapi/memorylake/admin/v1/api-keys/9d971b8b5813eb1ecceec31354c101b4' \
  -H 'Authorization: Bearer sk_xxxxxx' \
  -H 'Content-Type: application/json' \
  -d '{
    "allowed_ips": [
      "example"
    ],
    "backup_group": "example",
    "expires_at": 1760000000,
    "group": "example",
    "name": "Example name",
    "status": "enabled"
  }'

{
  "success": true,
  "message": "Operation completed successfully",
  "data": {
    "allowed_ips": [
      "example"
    ],
    "created_at": 1760000000,
    "id": "40c8c8eba1dca6d1ba4bd63384a16d3c",
    "is_system": true,
    "key_prefix": "f6e5d4c3",
    "name": "Example name",
    "status": "enabled",
    "backup_group": "example",
    "expires_at": 1760000000,
    "group": "example",
    "key_suffix": "b2a1",
    "last_used_at": 1760000000,
    "owner": {
      "display_name": "Alice",
      "member_type": "human",
      "principal_id": "61083f9552ae2ae6bd9105e4e2763c7b"
    }
  }
}

curl -X PATCH 'https://app.memorylake.cn/openapi/memorylake/admin/v1/api-keys/9d971b8b5813eb1ecceec31354c101b4' \
  -H 'Authorization: Bearer sk_xxxxxx' \
  -H 'Content-Type: application/json' \
  -d '{
    "allowed_ips": [
      "example"
    ],
    "backup_group": "example",
    "expires_at": 1760000000,
    "group": "example",
    "name": "Example name",
    "status": "enabled"
  }'

{
  "success": true,
  "message": "Operation completed successfully",
  "data": {
    "allowed_ips": [
      "example"
    ],
    "created_at": 1760000000,
    "id": "40c8c8eba1dca6d1ba4bd63384a16d3c",
    "is_system": true,
    "key_prefix": "f6e5d4c3",
    "name": "Example name",
    "status": "enabled",
    "backup_group": "example",
    "expires_at": 1760000000,
    "group": "example",
    "key_suffix": "b2a1",
    "last_used_at": 1760000000,
    "owner": {
      "display_name": "Alice",
      "member_type": "human",
      "principal_id": "61083f9552ae2ae6bd9105e4e2763c7b"
    }
  }
}

PATCH /openapi/memorylake/admin/v1/api-keys/{id}

更改 API Key 的名称、状态、过期时间、IP 限制或路由分组。仅更改您发送的字段；不接受 null——如需清空，请发送 [] 或 ""。已过期的 Key 只有同时设置未来的 expires_at 才能启用；所有者已被删除的 Key 不可启用；用于本次请求的 Key 不能禁用自身。路由分组须为公开分组或 Key 所有者自己的分组。

所需权限： service_account:update（仅本人的 Key）或 service_account:update（全部 Key）

路径参数

string

required

API Key 的标识符

请求体

array

替换 IP / CIDR 限制。[] 表示移除。

string

备用模型路由分组。传 "" 表示清除。

integer

新的过期时间，Unix 秒级时间戳。0 = 永不过期。

string

模型路由分组。传 "" 可清除。

string

新显示名称。用量明细按每次请求时 Key 的名称保存，因此重命名会使该 Key 的历史记录分开。

string

启用或停用该 Key。已过期的 Key 只有同时设置一个未来的 expires_at 时才能启用。可选值：enabled、disabled。

curl -X PATCH 'https://app.memorylake.cn/openapi/memorylake/admin/v1/api-keys/9d971b8b5813eb1ecceec31354c101b4' \
  -H 'Authorization: Bearer sk_xxxxxx' \
  -H 'Content-Type: application/json' \
  -d '{
    "allowed_ips": [
      "example"
    ],
    "backup_group": "example",
    "expires_at": 1760000000,
    "group": "example",
    "name": "Example name",
    "status": "enabled"
  }'

响应

object

Show API Key 对象

array

允许使用此 Key 的客户端 IP 或 CIDR 范围。空数组表示不限制。

integer

创建时间，Unix 秒级时间戳

string

此 API Key 的稳定标识符

boolean

平台为自身用途创建的 Key 为 true（例如控制台 Playground）

string

Key 主体的前 8 个字符。读取类端点从不返回完整 Key。

string

显示名称

string

Key 的当前状态。可选值：enabled、disabled、expired。

string

备用模型路由分组。省略表示无。

integer

过期时间，Unix 秒级时间戳。Key 永不过期时省略。

string

此 Key 的请求所使用的模型路由分组。省略 = 所有者自己的分组。

string

Key 的后 4 个字符，用于在不返回 Key 的情况下核对某人持有的 Key。未保留明文的 Key 省略此字段。

integer

此 Key 最近一次使用的时间，Unix 秒级时间戳。为近似值——更新有节流，最多可能延迟一小时。从未使用过时省略。

object

此 Key 代表的成员——其请求携带该成员的权限，用量也计入该成员。为虚拟成员签发的 Key，即为该虚拟成员。账号已不存在时省略。

Show API Key Owner 对象

string

成员的显示名称

string

human 表示通过邀请加入，virtual 表示由所有者/管理员创建的托管身份

string

成员的 principal_id（参见 GET /members）

{
  "success": true,
  "message": "Operation completed successfully",
  "data": {
    "allowed_ips": [
      "example"
    ],
    "created_at": 1760000000,
    "id": "40c8c8eba1dca6d1ba4bd63384a16d3c",
    "is_system": true,
    "key_prefix": "f6e5d4c3",
    "name": "Example name",
    "status": "enabled",
    "backup_group": "example",
    "expires_at": 1760000000,
    "group": "example",
    "key_suffix": "b2a1",
    "last_used_at": 1760000000,
    "owner": {
      "display_name": "Alice",
      "member_type": "human",
      "principal_id": "61083f9552ae2ae6bd9105e4e2763c7b"
    }
  }
}

​路径参数

​请求体

​响应

路径参数

请求体

响应