接口描述 查询Postgresql实例IP白名单。 请求方法 GET URI /v1/whitelist/query 请求参数 名称 位置 类型 必选 说明 prodInstId query Long 是 实例id 响应参数 名称 类型 说明 message String 消息提示 statusCode Integer 状态码 returnObj List IP白名单列表 示例 请求示例 /v1/whiteList/queryIPWhiteList?prodInstId15 响应示例 { "message": "SUCCESS", "opMessage": "", "returnObj": [ "127.0.0.1", "192.168.174.1" ], "statusCode": 800 } 错误码 访问ErrorCodes说明文档查看更多错误码。

参数 说明 部门管理员 部门的运维管理员，主要负责云堡垒机系统的管理。除用户管理和角色管理模块之外，部门管理员拥有其他全部模块的配置权限。 策略管理员 用户权限策略管理员，负责主机运维的权限策略管理。主要负责策略权限的配置，拥有用户组管理、资源组管理和访问策略管理等模块的配置权限。 审计管理员 运维结果审计管理员，查询管理系统审计数据。主要负责查阅和管理系统的审计数据，拥有实时会话、历史会话和系统日志等模块的配置权限。 运维员 访问系统的普通用户和操作人员。主要负责资源的运维，拥有主机运维、应用运维和工单授权管理的权限。

此小节介绍云堡垒机的系统部门。 “部门”是用于划分组织结构，标识用户和资源的组织。系统默认有一个部门“总部”，仅可在“总部”基础上创建部门分支，且“总部”不可删除。根据部门划分用户组织结构后，下级部门用户不能查看上级部门信息，包括上级部门组织结构、用户、主机资源、应用资源、应用发布服务器、资源账户，以及上级部门配置的策略信息和运维审计数据。 不同部门的用户，仅同部门和上级部门管理员可管理用户。 仅系统管理员admin或拥有“部门”模块权限的用户，可管理系统部门组织结构，包括新建部门、编辑部门、删除部门、查询部门用户和查询部门资源等。 新建部门 云堡垒机默认“总部”为系统最上级部门，仅可在“总部”基础上创建部门分支。 前提条件 已获取“部门”模块操作权限。 操作步骤 1 登录云堡垒机系统。 2 在左侧导航树中，选择“部门”，进入部门管理页面。 3 单击页面右上角的“新建”，弹出“新建部门”窗口。 4 选择“上级部门”，输入待新建的“部门名称”，并根据需要输入简要“部门描述”。 说明 系统内自定义的“部门名称”不能重复； 上级部门仅能在已有部门目录树中选择。 5 单击“确定”，返回部门管理页面，查看新建的部门。

本小节主要介绍如何在任务中心查看任务内容。 任务中心是系统执行任务接收状态提示管理中心。 任务类型：导入用户、导入主机、导入云主机、导入应用、导入应用服务器、导入帐户、帐户改密、AD域同步、系统维护（升级和还原）、生成视频、帐户同步、帐户验证、配置备份、自动运维、导入动态令牌、安装Agent。 任务状态共有3种，分别包括“进行中”、“已完成”、“已停止”。 操作步骤 1. 登录云堡垒机系统。 2. 单击右上角，展开任务中心小窗口，可查看最新三条“执行中”任务。 3. 单击“查看更多”，进入任务中心列表页面。 4. 查询任务。在搜索框中输入关键字，根据任务标题内容快速查询任务。 5. 查看任务列表。在任务列表可以查看到正在进行的任务、已完成的任务和被停止的任务。 6. 查看任务详情。 1. 单击目标任务名称，进入任务详情页面。 2. 可查看任务基本信息和任务执行结果。

修改基本信息 1. 登录云堡垒机系统。 2. 选择右上角用户名，单击“个人中心”，进入个人中心管理页面 3. 单击“编辑”，弹出基本信息修改窗口。 4. 输入用户“姓名”、“手机”或“邮箱”。 5. 单击“确定”，返回个人基本信息页面。修改后用户姓名、手机号码、邮箱地址立即生效。

USBKey登录 使用动态令牌登录 1 选择“动态令牌”方式。 2 依次输入用户登录名、帐户登录密码。 3 在已签发硬件令牌上获取动态口令，输入6位OTP口令。 4 单击“登录”，验证通过后即可登录系统。 Azure AD用户登录 1 单击“使用Azure AD登录”，跳转到Microsoft登录页面。 2 按步骤依次输入用户登录名和密码。 用户登录名需加邮箱后缀，例如zhang@example.com。 3 单击“登录”，验证通过后即可登录系统。

变更规格注意事项 软件版本要求 变更规格到 专业版 ，系统软件版本需在V3.2.16.0及以上，否则变更规格后的专业版功能不能生效。 系统数据备份与还原 变更规格前请务必备份系统重要数据，以免因变更规格失败而导致系统数据丢失。 变更规格后请根据实际需求将备份数据重新载入系统，还原系统配置。 变更规格时间 整个变更规格过程包括变更规格前准备、后台变更规格、变更规格后验证，共需60min左右。后台变更规格全程需30min左右，期间CBH系统需要关闭，会导致业务中断。 为了减少变更规格对系统运行的影响，请尽量选择在业务量较低时进行变更规格操作。

此小节介绍变更堡垒机规格准备事项。 确认变更规格前系统环境 在变更规格前，需确认并记录当前系统版本信息和授权规格，包括“版本号”、“设备系统”、“授权资源数”和“授权资源并发连接数”。 步骤 1 登录云堡垒机系统。 步骤 2 确认和记录系统版本。 选择“系统 > 关于系统”，查看系统版本信息。 记录“版本号”和“设备系统”。 说明 “设备系统”为V3.2.16.0及以上，才能变更规格系统到专业版 ，否则请先升级系统版本。 步骤 3 确认和记录授权信息。 1. 选择“系统 > 系统维护 > 授权许可”，查看当前授权规格。 2. 记录“授权资源数”和“授权资源并发连接数”。 备份系统数据 为避免因变更规格失败而导致系统数据丢失，变更规格前请务必备份重要系统数据，包括系统配置、资源账户、审计日志等重要数据。 备份系统配置 通过备份和还原系统配置数据，可复用变更规格前系统配置数据。 系统配置文件包括部门、用户、资源、策略、工单、运维、审计和系统模块的全部配置数据。 步骤 1 登录云堡垒机系统。 步骤 2 选择“系统 > 系统维护 > 配置备份与还原”。 步骤 3 单击“新建”创建备份，备份系统配置数据。 步骤 4 单击“下载”，导出系统配置文件保存于本地。

创建方式 说明 新建单个用户 单个用户仅能逐一创建，适用于创建单个管理员用户。 Excel文件批量导入用户 按照Excel模板要求配置用户信息，再导入系统。批量添加用户，适用于批量创建运维用户。 同步AD域用户 同步AD域服务器的用户。同步成功后，使用AD域用户帐号和密码登录CBH系统，AD域服务器同时提供认证服务。

步骤 说明 配置策略基本信息 可配置文件传输权限、用户登录IP限制、用户登录时段限制、策略有效期等信息。 关联用户或用户组 关联用户：赋权给单个系统用户，该用户角色需同时有“主机运维”和“应用运维”模块权限，才能正常获取运维资源权限。 关联用户组：批量赋权给整个用户组成员。赋权后，新加入组的用户即刻拥有该访问控制权限。 关联资源账户或账户组 关联资源账户：授权访问单个资源账户。 关联账户组：授权访问整个账户组。授权后，新加入组的资源账户可立即被赋权用户访问。

审计类型 审计内容 实时会话 实时监控当前运维会话，查看运维用户和资源的会话详情，中断有高危风险的会话。 历史会话 运维会话视频：无需设置，全程录屏记录运维会话操作，可在线播放或下载操作视频。 运维会话详情：用户运维会话详情，可在线查看或导出Excel文件。 详情内容包括资源会话信息 、 系统会话信息 、 运维记录 、 文件传输 、协同会话的详细操作记录。 运维报表 以折线图的形式，从多方面呈现用户运维资源随时间变化的趋势，并可生成运维资源综合分析报告。 系统日志 系统登录日志：用户登录系统的详细记录，可在线查看或导出Excel文件。 系统操作日志：用户系统操作的详细记录，可在线查看或导出Excel文件。 系统报表 以柱状图的形式，从多方面统计用户登录系统和系统操作次数，并可生成系统管理综合分析报告。

此小节介绍云堡垒机欠费说明。 欠费影响 对于包年/包月CBH资源，用户已经预先支付了资源费用，因此在帐户出现欠费的情况下，已有的包年/包月CBH资源仍可正常使用。然而，对于涉及费用的操作，如新购CBH、升级CBH规格、续费订单等，用户将无法正常进行。 避免和处理欠费 欠费后需要及时充值。 您可以在“费用中心 > 总览”页面设置“可用额度预警”功能。 当产生欠费后，请您及时充值使可用额度大于0。 停止计费 对于包年/包月计费模式的资源，例如包年/包月的CBH实例，用户在购买时会一次性付费，服务将在到期后自动停止使用。 如果在计费周期内不再使用包年/包月资源，您可以执行退订操作，系统将根据资源是否属于五天无理由退订、是否使用代金券和折扣券等条件返还一定金额到您的帐户。 如果您已开启“自动续费”功能，为避免继续产生费用，请在自动续费扣款日之前关闭自动续费。

计费项 计费项说明 适用的计费模式 计费公式 性能规格 计费因子：资产数、并发数、实例版本 包年/包月 实例规格单价 购买时长实例规格单价 实例类型 单机：不购买备用堡垒机 主备：为堡垒机购买备用堡垒机，可自由选择可用区 包年/包月 单机：性能规格计费价格 1 主备：性能规格计费价格 2

此小节介绍计费概述。 通过阅读本文，您可以快速了解云堡垒机CBH的计费模式、计费项、续费、欠费等主要计费信息。 计费模式 云堡垒机提供包年/包月计费模式。包年/包月是一种预付费模式，即先付费再使用，按照订单的购买周期进行结算，因此在购买之前，您必须确保帐户余额充足。关于包年/包月计费模式的详细介绍请参见计费说明。 计费项 云堡垒机的计费项只由性能规格费用组成。了解每种计费项的计费因子、计费公式等信息，请参考计费项。 如需了解实际场景下的计费样例以及各计费项在不同计费模式下的费用计算过程，请参见计费样例。 续费 包年/包月云堡垒机在到期后会影响云堡垒机的正常运行。如果您想继续使用云堡垒机，需要在规定的时间内为云堡垒机进行续费，否则云堡垒机实例将会自动释放，数据也可能会丢失。续费包括手动续费和自动续费两种方式，您可以根据需求选择。了解更多关于续费的信息，请参见续费概述。 欠费 在使用云服务时，帐户的可用额度小于待结算的账单，即被判定为帐户欠费。欠费后，可能会影响云服务资源的正常运行，需要及时充值。详细介绍请参见欠费说明。 停止计费 当云服务资源不再使用时，可以将他们退订或删除，从而避免继续收费。详细介绍请参见停止计费。

名称 类型 说明 message String 消息提示 statusCode Integer 状态码 returnObj Boolean true:已加密 false:未加密

名称 位置 类型 必选 说明 prodInstId body Long 是 实例id mode body String 是 修改模式： cover：用ipList中的IP覆盖原白名单 delete：把ipList的IP从白名单中移除,如果有白名单中不存在的IP，会被跳过 append：把ipList中的IP加入白名单 ipList body List 是 IP列表

关系数据库MySQL版已对接天翼云统一身份认证服务（IAM），可实现账号委托功能。账号委托的操作步骤如下： 操作步骤 1. 进入IAM的控制中心页面 2. 在左侧导航栏点击“委托”，进入账号委托管理页面。 3. 点击右上角的“创建委托”，进入创建委托页面。 4. 选择“可信实体类型”，点击“下一步”。 5. 填写“委托名称”、“备注”、“委托账号”，点击“完成”。即可完成账号委托。

本页主要介绍企业项目迁移的相关步骤。 操作场景 该功能支持实例迁移到不同的企业项目，在不释放实例的情况下进行转换，方便企业进行管理相关实例。 操作步骤 1. 登陆天翼云官网，右上角点击“我的”，选择“帐号中心”。 2. 进入到帐号中心管理页面，左侧边栏点击“统一身份认证”。 3. 选择“企业项目”，并点击想要迁移的项目右侧的“查看资源”。 4. 选择想要迁出的资源所在的资源池以及产品类型，可以在右侧“资源名称”进行搜索。 5. 选择完毕，点击“迁出”，并选择要目标企业项目。需要注意，若当前资源与其他资源间存在绑定关系，迁移此资源，可能影响部分子用户下相关资源无法查看。 6. 回到管理控制台，右上角选择目标企业项目，可以查看到以上步骤中迁出的实例。

本文主要介绍只读账号的使用场景，约束限制和创建方法。 注意 仅西南1资源池支持该功能，具体支持情况以控制台页面展示为准。更多资源池信息，请参见功能概览。 使用场景 只读账号是一类仅有读权限的账号，默认从数据库集群中的备节点（或只读实例）中读取数据。用户可以在控制台实例管理页的账号管理页中，设置只读账号和读策略，从而实现账号级别的读写分离。 约束限制 当前最多仅支持创建5个只读账号。 只读账号基于数据库代理读写分离实现，故需要提前购买数据库代理实例并开启读写分离。 单机版实例因为只有一个节点，不支持创建只读账号。 创建只读账号 注意 只读账号基于数据库代理实现，故需要提前购买数据库代理实例。 1. 在天翼云官网首页的顶部菜单栏，选择产品 > 数据库 > 关系型数据库 > 关系数据库MySQL版 ，进入关系数据库MySQL产品页面。然后单击管理控制台 ，进入概览页面。 2. 在左侧导航栏，选择MySQL > 实例管理，进入实例列表页面。然后在顶部菜单栏，选择区域和项目。 3. 在实例列表中，单击目标实例名称，进入实例基本信息页面。 4. 单击账号管理，进入账号管理页面。 5. 单击创建账号。 6. 在创建账号对话框中，选择创建只读账号，并选择数据库，设置账号密码。 7. 设置完毕，即可创建只读账号。

本页主要介绍设置数据库只读的影响和步骤。 注意 仅II类型资源池支持该功能，具体支持情况以控制台页面展示为准。更多资源池信息，请参见功能概览。 使用场景 对于一些非常重要，历史性的数据库，数据仅供查询和审计使用，不应再被修改，可将实例设置为只读状态，以防误操作。 说明 设置数据库只读后，将不可进行写入操作，请谨慎设置。 操作步骤 1. 在天翼云官网首页的顶部菜单栏，选择产品 > 数据库 > 关系型数据库 > 关系数据库MySQL版 ，进入关系数据库MySQL产品页面。然后单击管理控制台 ，进入概览页面。 2. 在左侧导航栏，选择MySQL > 实例管理，进入实例列表页面。然后在顶部菜单栏，选择区域和项目。 3. 在实例列表中，单击目标实例名称，进入实例基本信息页面。 4. 在实例信息栏，找到实例id 行，点击右侧的设置数据库只读。 5. 在弹窗中仔细阅读提示，并点击确认即可。 6. 此时数据库成为只读状态，如想改为可读写状态，点击实例id旁 的设置数据库读写即可。

本文介绍了故障恢复相关说明。 RDSPostgreSQL支持多种备份恢复策略，为您的数据库实例提供多种故障恢复能力。 RDSPostgreSQL会根据用户自定义备份策略自动创建数据库实例的备份。您可指定实例自动备份的备份周期、备份开始时间、备份保留期（1~180天）保存实例的数据。RDSPostgreSQL提供了多种恢复实例数据的方式，用以满足不同的使用场景： 通过备份文件恢复实例。 将实例恢复到指定时间点 。 多可用区 可用区指在同一区域下，电力、网络隔离的物理区域，可用区之间内网互通，不同可用区之间物理隔离。RDSPostgreSQL支持在主备实例将主备节点部署于同一个可用区或多个可用区，以提供故障切换能力和高可用性。 注意 不同资源池因IaaS资源能力等原因，加载版本有所差异，详见

关系数据库MySQL版提供多种日志服务和审计服务，您可以根据需要查看或开启相关服务。本文为您详细介绍关系数据库MySQL版的日志与审计。 关系数据库MySQL版提供的日志服务和审计服务如下： 支持通过管理控制台查看数据库错误日志，包括数据库主库和从库运行的错误信息，帮助您分析数据库系统中存在的问题。 错误日志的详细介绍，请参见查看错误日志。 说明 错误日志默认保留7天。 数据库慢日志用来记录执行时间超过当前慢日志阈值“longquerytime”（默认1秒）的语句，通过管理控制台查看慢日志的日志明细、统计分析情况，帮助您找出执行效率低的语句，进行优化。 慢日志的详细介绍，请参见查看慢日志 。 支持开通SQL审计功能，系统会将所有的SQL操作记录下来存入日志文件，以提供针对数据增删改查等操作的审计行为。 SQL审计的详细介绍和开通配置方法，请参见开启SQL审计日志。 关系数据库MySQL版支持设置Binlog日志参数，您可以根据需要修改相关参数。 Binlog日志的参数设置，请参见参数设置。 关系数据库MySQL版支持查看参数应用日志，您可以根据需要查看参数应用的情况。 参数应用日志介绍，请参见查看参数组应用记录。

配置项 配置说明 模型接口地址 说明 此处通常是/v1，但实际情况也可能有所不同。只需要去掉/chat/completions，前面全部保留即可。 API密钥 header 'Authorization: Bearer skXXXX'：复制 skXXXX填入“API密钥”输入框。 说明 密钥不一定是 sk 开头，根据实际情况填写即可。 也可能没有密码，没有密码可不填。 模型名称 "model": "Qwen/Qwen2.532BInstruct"：注意这里的模型名称要完全一致的填入 “模型名称” 输入框。

选择入侵防御页签，可对终端设置暴力破解行为、扫描行为检测。 防暴力破解是指对系统登录行为进行一定的限制，防止账号被爆破。 配置防暴力破解 功能 ：通过AI哨兵引擎提供的多种异常检测算法，根据真实的业务数据对暴力破解行为进行AI大模型上下文分析、跨终端关联分析。支持SSHFTPRDPSMBMSSQLWINRM多种类型。 使用场景：适用于需要自定义修改配置策略模板防暴力破解场景。 1. 选择防暴力破解页签。 2. 点击防暴力破解图标，置于开启状态（开启AI哨兵模式、开启普通模式），即可开启防暴力破解。 配置效果验证 1. 在防暴力破解策略中自定义配置并下发策略至客户端。 2. 对终端的系统账户进行登录操作，并且多次使用错误的口令尝试。 3. 在管理平台日志查看日志。 1. 当登录失败次达到设置阀值后锁定该IP地址。 2. 用户可以查看并解除已临时锁定的IP清单。 3. 生成防爆力破解日志。

配置 说明 系统性能监控 用于监控系统性能监控，支持配置CPU监控、内存监控、网络IO监控和磁盘使用监控。 开启报警：监控项匹配达到规则阈值进行日志记录。 开启熔断：监控项匹配达到规则阈值进行自动熔断，客户端不提供处理能力。 开启恢复：达到熔断条件后匹配达到预设规则将自动恢复客户端能力。 Agent性能监控 用于监控Agent性能监控，支持配置CPU监控、内存监控。 开启报警：监控项匹配达到规则阈值进行日志记录。 开启熔断：监控项匹配达到规则阈值进行自动熔断，客户端不提供处理能力。 开启恢复：达到熔断条件后匹配达到预设规则将自动恢复客户端能力。

参数 说明 开关 启用/禁用：控制是否启用抗DDoS功能 每分钟请求次数 限制每分钟的最大请求数 每小时请求次数 限制每小时的最大请求数 每天请求次数 限制每天的最大请求数

参数 说明 开关 响应模版：启用/禁用自定义响应模版 模版内容 设置违规时的响应文本 占位符 支持使用{category}、{explanation}、{engineType}、{score}等占位符

当您执行了查询分析语句后，态势感知（专业版）支持通过图表统计的形式对查询和分析的结果进行可视化展示。同时，还支持将指标保存为卡片，方便后续在布局中使用。 目前支持以下图表类型： 表格 折线图 柱状图 饼图

本小节介绍Agent的默认安装路径。 在Linux/Windows操作系统的主机中安装Agent时，安装过程中不提供安装路径的选择，默认安装在以下路径中，如表所示。 Agent的默认安装路径 操作系统 默认安装路径 Linux /usr/local/hostguard/ Windows C:Program Files (x86)HostGuard

本节介绍如何确认入侵账号是否登录成功。 若已开启入侵检测告警通知，当有帐号被破解，或有帐号破解风险时，您会立即收到告警通知。 也可以在“入侵检测”页面在线查看攻击IP的拦截情况。 若想进一步确定，可以在Linux主机上的“/var/log/secure”和“/var/log/message”查看日志，或使用last命令查看是否有异常登录记录。

介绍云服务器列表看不到购买服务器的解决方案。 云服务器列表仅显示以下主机的防护状态： 在所选区域购买的云主机 已接入所选区域的其他云主机 解决方法：若未找到您的主机，请切换到正确的区域后再进行查找。

本小节介绍费用账单。 费用账单 账单上报周期 包周期、按需计费模式的资源完成支付后，会实时上报一条账单到计费系统进行结算。 查看指定资源的账单 1、登陆管理中心，进入管理中心界面。 2、选择账单管理，点击“账单管理”，可以查看最近时间内的消费情况。 3、选择账单管理，点击“流水账单”，输入产品名称可以查看流水账单。 4、选择账单管理，点击“账单详情”，输入产品名称可以查看账单详情。