账户生命周期

账户生命周期描述一个企业账户在灵渠平台上的状态流转。账户是客户企业在平台上的最高归属单元，它的状态决定这家企业当前能否接入与发起查询。状态由开通、审核、停用、启用四类运营动作驱动，状态本身记录在账户的状态字段上，可随时回看。

本页讲清三件事：账户状态机怎么流转、账户上有哪些状态字段、停用如何级联到名下的接入密钥。

1. 账户状态机

账户自提交开通申请起进入状态机。开通申请落地为「待审核」，经审核批准进入「正常」，正常账户可因人工操作或汇总信用额度达额被「停用」，停用后可再启用回到正常：

开通一个账户、并在审核通过后启用，是两个独立动作。提交开通后账户进入待审核，不直接可用；审核与审批的指派、批准、驳回流程见 审核与审批。

# 提交开通申请（账户进入待审核）
curl https://<平台入口地址>/api/v1/accounts \
  -H "Content-Type: application/json" \
  -H "Cookie: <控制台会话凭证>" \
  -d '{
    "account_name": "<企业账户名称>"
  }'

新建账户的摘要中包含账户标识与初始状态：

{
  "account_id": "<账户标识>",
  "account_name": "<企业账户名称>",
  "status": "待审核"
}

2. 账户状态字段

账户的当前状态与停用原因记录在两个字段上：

进入停用状态时，附带一个停用原因，便于运营回看是主动操作还是额度触发：

停用原因只在 status=停用 时有效。「达额」停用与 预算与限速 中的汇总信用额度「达额一并暂停」是同一条联动——账户层达额会把整个账户置为停用，名下密钥随之暂停。

3. 停用的级联效应

账户停用是账户层动作，但它会级联到子账户层：账户一旦置为停用，名下全部接入密钥一并暂停，无需逐把操作。这条级联复用了汇总信用额度「达额一并暂停」的同一套联动语义——区别只在触发源，一个由账户停用触发、一个由额度达上限触发，落到密钥层的结果一致。

# 停用账户（级联暂停名下全部接入密钥）
curl https://<平台入口地址>/api/v1/accounts/<账户标识>/suspend \
  -X POST \
  -H "Content-Type: application/json" \
  -H "Cookie: <控制台会话凭证>" \
  -d '{ "suspend_reason": "人工" }'

# 启用账户（恢复服务）
curl https://<平台入口地址>/api/v1/accounts/<账户标识>/activate \
  -X POST -H "Cookie: <控制台会话凭证>"

账户停用不删除任何密钥本体，也不影响已落账的历史用量；它只是把账户与名下密钥统一置于不可用态。逐把密钥的临时启停仍在密钥治理章自助完成，与账户层停用互不替代。

相关链接

• 用户管理总览：账户层与密钥子账户层的治理边界。
• 审核与审批：开通审核流与审批记录台账。
• 密钥治理：账户名下接入密钥的启停与轮换口径。
• 预算与限速：汇总信用额度「达额一并暂停」的联动语义。