服务账号

服务账号是供自动化任务、Agent 或其他非人工应用使用的组织身份，不占用成员席位。 服务账号产生的用量独立统计。设置 Credits 上限后，可以限制单个服务账号在统计周期内的用量。使用前，管理员需要先为组织开通服务账号按量付费。

​

使用前准备

• 当前账号具有 Qoder 组织的管理权限。
• 如需开通或管理按量付费，请准备一个有权限管理对应 Qoder 组织的阿里云账号。
• 准备好用于保存凭证的服务端密钥管理工具。

​

开通服务账号按量付费

服务账号按量付费按 Qoder 组织开启，仅对服务账号产生的用量计费。开启后，服务账号按实际使用的 Credits 计费并在使用后结算，其他 Qoder 功能仍沿用原有计费方式。 当前按量付费价格如下，实际价格以阿里云控制台展示为准。 服务账号按量付费由阿里云管理，Qoder 管理控制台仅展示同步后的状态。未开通时，服务账号及其凭证均不可用。

​

开通步骤

1. 使用有权限的阿里云账号登录阿里云控制台。
2. 打开对应 Qoder 组织的详情页，找到“服务账号按量付费”。
3. 查看当前单价和计费说明，实际价格以阿里云控制台展示为准。
4. 开启服务账号按量付费，并在确认窗口中确认。
5. 返回 Qoder 管理控制台，进入“成员 > 服务账号”，刷新页面并确认状态已更新。

如果在阿里云关闭服务账号按量付费，已有服务账号及其凭证将停止使用，但历史用量仍会保留。需要再次使用时，请在阿里云重新开启，然后返回 Qoder 刷新状态。

​

创建服务账号

1. 在 Qoder 管理控制台进入“成员 > 服务账号”。
2. 单击“创建”。
3. 填写服务账号名称和描述。按需设置“Credits 上限”，不填写表示不设置限额。建议使用能够区分用途和环境的名称，例如 support-agent-prod。
4. 单击“创建”。

​

管理凭证

打开服务账号行末的“…”菜单，可以直接创建凭证。选择“编辑”后，还可以在“现有凭证”中查看凭证名称和脱敏后的凭证值，并管理单个凭证。

​

创建凭证

1. 打开服务账号行末的“…”菜单，选择“创建凭证”。也可以进入“编辑”，在“现有凭证”区域单击“创建凭证”。
2. 复制新凭证并保存到服务端密钥管理工具中。
3. 将凭证配置到调用方，并验证调用正常。

凭证明文只显示一次。关闭窗口后无法再次查看，未保存时需要重新创建凭证。 创建新凭证不会影响已有凭证。需要平滑更换凭证时，请先创建新凭证并切换调用方，再吊销旧凭证。

​

轮转凭证

1. 进入服务账号的“编辑”页面，在“现有凭证”中找到需要轮转的凭证。
2. 打开该凭证行末的“…”菜单，选择“轮转凭证”。
3. 按页面提示完成轮转，复制新凭证并更新调用方。

轮转后，原凭证将无法继续使用。请确保调用方可以及时更新，避免调用中断。

​

吊销凭证

1. 进入服务账号的“编辑”页面，在“现有凭证”中找到需要吊销的凭证。
2. 打开该凭证行末的“…”菜单，选择“吊销凭证”，阅读影响说明后确认。

吊销后，仍使用该凭证的调用会立即失败。同一服务账号下的其他可用凭证不受影响。

​

查看用量和调整上限

服务账号列表展示每个服务账号的“用量 / 限额”，单位为 Credits。 如需调整上限，打开服务账号行末的“…”菜单，选择“编辑”，修改“Credits 上限”并保存。上限调整后立即生效，清空该字段表示不设置限额。 设置上限后，当服务账号达到当前统计周期的 Credits 上限时，新的调用会暂停。管理员提高上限后，服务账号可在当前统计周期内恢复调用。进入下一个统计周期后，用量重新计算，已配置的上限继续保留。

​

归档服务账号

不再需要某个服务账号时，打开其操作菜单并选择“归档”。 归档后，该服务账号及其全部凭证将无法使用，且不能恢复。归档前，请先停止相关自动化任务，或将其迁移到其他服务账号。

​

服务账号无法使用

遇到调用失败时，按以下顺序检查：

1. 确认组织已开通服务账号按量付费，且 Qoder 中已同步为开启状态。
2. 确认服务账号未归档，当前凭证未吊销或轮转。
3. 查看当前统计周期的用量是否已达到 Credits 上限。
4. 如果阿里云账号欠费，请先在阿里云完成充值。结清欠费后，服务会自动恢复，无需重新开启服务账号按量付费。