华为云用户手册

到期后影响 图3描述了包年/包月GeminiDB Influx实例各个阶段的状态。购买后，在计费周期内实例正常运行，此阶段为有效期；实例到期而未续费时，将陆续进入宽限期和保留期。 图3 包年/包月GeminiDB Influx实例生命周期 到期预警 包年/包月GeminiDB Influx实例在到期前第7天内，系统将向用户推送到期预警消息。预警消息将通过邮件、短信和站内信的方式通知到华为云账号的创建者。 到期后影响 当您的包年/包月GeminiDB Influx实例到期未续费，首先会进入宽限期，实例状态变为“已过期”。宽限期内您可以正常访问GeminiDB Influx实例，但以下操作将受到限制： 变更实例规格 包年/包月转按需 退订 如果您在宽限期内仍未续费包年/包月GeminiDB Influx实例，那么就会进入保留期，实例状态变为“已冻结”，您将无法对处于保留期的包年/包月资源执行任何操作。 保留期到期后，若包年/包月GeminiDB Influx实例仍未续费，那么实例将被释放，数据无法恢复。 华为云根据客户等级定义了不同客户的宽限期和保留期时长。 关于续费的详细介绍请参见续费概述。

适用计费项 包年包月包含以下计费项。 表1 适用计费项 计费项 说明 实例规格 对所选的实例规格进行计费，包括vCPU和内存。 存储空间 对数据库存储空间进行计费，包年包月计费方式的存储空间如果超过当前容量，超出的部分将按需计费。 备份空间 GeminiDB Influx提供了部分免费存储空间，用于存放您的备份数据，其总容量为您购买存储容量的100%。 备份存储用量超过购买存储容量的100%，超出部分将按照备份计费标准收费，计费方式为按需计费（每小时扣费一次），不足一小时按照实际使用时长收费。 冷存储空间（可选） GeminiDB Influx提供了冷存储空间，适用于数据量大，查询频率低的业务场景，购买冷存储空间会额外计费。 公网带宽（可选） GeminiDB Influx实例支持公网访问，公网访问会产生带宽流量费；GeminiDB Influx数据库实例在云内部网络产生的流量不计费。 假设您计划购买一个规格为2vCPUs 8GB，3个节点，存储空间容量为100GB，冷存储空间容量为500GB的GeminiDB Influx实例。在购买数据库实例页面底部，您将看到所需费用的明细（不包含备份空间费用），如图1所示。 图1 配置费用 配置费用将包括以下部分： 数据库实例：根据所选实例规格计算的费用。 数据库存储：对数据库存储空间进行计费。 备份空间费用，使用后按照统一标准计费，购买时不包含在配置费用中，可通过云数据库 GeminiDB价格详情查看。

计费示例 假设您在2023/03/08 15:50:04购买了一个包年/包月GeminiDB Influx实例（规格：2 vCPUs 8GB，节点数量：3，存储空间：100GB，备份空间：110GB（赠送100GB，后续收费空间10GB），冷存储空间：500GB），计费资源包括实例规格（vCPU、内存、节点数量）、存储空间、备份空间、公网带宽。购买时长为一个月，并在到期前手动续费1个月，则： 第一个计费周期为：2023/03/08 15:50:04 ~ 2023/04/08 23:59:59 第二个计费周期为：2023/04/08 23:59:59 ~ 2023/05/08 23:59:59 2023/04/08 23:59:59~2023/05/01 23:59:59期间，使用免费备份空间50GB。 2023/05/01 23:59:59~2023/05/08 23:59:59期间，使用计费备份空间10GB，计费时长168小时。 您需要为每个计费周期预先付费，各项GeminiDB Influx资源单独计费，计费公式如表2所示。 表2 计费公式 资源类型 计费公式 资源单价 实例规格（vCPU和内存） 实例规格单价 * 购买时长 * 节点数量 请参见云数据库 GeminiDB价格详情中的“集群-规格费用”。 存储空间 存储空间单价 * 购买时长 * 存储空间(GB) 请参见云数据库 GeminiDB价格详情中的“集群磁盘空间计费信息”。 备份空间 备份空间单价 *计费时长 * ( 备份空间 - 存储空间)(GB) 说明： 计费时长：备份超过免费空间大小的使用时长。 请参见云数据库 GeminiDB价格详情中的“备份空间计费信息”。 冷存储空间 存储空间单价 * 购买时长 * 存储空间(GB) 请参见云数据库 GeminiDB价格详情中的“冷存储空间计费信息”。 公网带宽 按固定带宽值计费 请参见弹性公网IP价格详情。 图2给出了上述示例配置的费用计算过程。 图中价格仅供参考，实际计算请以云数据库 GeminiDB价格详情中的价格为准。 图2 包年/包月GeminiDB Influx费用计算示例

计费周期 包年/包月GeminiDB Influx实例的计费周期是根据您购买的时长来确定的（以UTC+8时间为准）。一个计费周期的起点是您开通或续费资源的时间（精确到秒），终点则是到期日的23:59:59。 例如，如果您在2023/03/08 15:50:04购买了一台时长为一个月的GeminiDB Influx实例，那么其计费周期为：2023/03/08 15:50:04 ~ 2023/04/08 23:59:59。

变更配置后对计费的影响 当前包年/包月GeminiDB Influx实例的规格不满足您的业务需要时，您可以在控制台发起变更规格操作，变更时系统将按照如下规则为您计算变更费用： 实例升配：新配置价格高于老配置价格，此时您需要支付新老配置的差价。 实例降配：新配置价格低于老配置价格，此时华为云会将新老配置的差价退给您。 实例降配会影响云数据库性能，通常不建议您这样操作。这里以资源升配且无任何优惠的场景为例，假设您在2023/04/08购买了一个包年/包月GeminiDB Influx实例（4vCPUs 16GB 3节点），购买时长为1个月，计划在2023/04/18变更规格为8vCPUs 32GB 3节点。旧配置价格为3956.80 元/月，新配置价格为7663.60 元/月。计算公式如下： 升配费用=新配置价格*剩余周期-旧配置价格*剩余周期 公式中的剩余周期为每个自然月的剩余天数/对应自然月的最大天数。本示例中，剩余周期=12（4月份剩余天数）/ 30（4月份最大天数）+ 8（5月份剩余天数）/ 31（5月份最大天数）=0.6581，代入公式可得升配费用=7663.6*0.6581-3956.8*0.6581=2439.44（元） 更多信息请参见变更资源规格费用说明。

适用场景 包年/包月计费模式需要用户预先支付一定时长的费用，适用于长期、稳定的业务需求。以下是一些适用于包年/包月计费模式的业务场景： 稳定业务需求：对于长期运行且资源需求相对稳定的业务，如企业官网、在线商城、博客等，包年/包月计费模式能提供较高的成本效益。 长期项目：对于周期较长的项目，如科研项目、大型活动策划等，包年/包月计费模式可以确保在整个项目周期内资源的稳定使用。 业务高峰预测：如果能预测到业务高峰期，如电商促销季、节假日等，可提前购买包年/包月资源以应对高峰期的需求，避免资源紧张。 数据安全要求高：对于对数据安全性要求较高的业务，包年/包月计费模式可确保资源的持续使用，降低因资源欠费而导致的数据安全风险。

包年/包月资源 对于包年/包月计费模式的资源，例如包年/包月的GeminiDB Influx实例，用户在购买时会一次性付费，服务将在到期后自动停止使用。 如果在计费周期内不再使用包年/包月资源，您可以执行退订操作，系统将根据资源是否属于五天无理由退订、是否使用代金券和折扣券等条件返还一定金额到您的账户。详细的退订规则请参见云服务退订规则概览。 如果您已开启“自动续费”功能，为避免继续产生费用，请在自动续费扣款日（默认为到期前7日）之前关闭自动续费。

续费相关的功能 包年/包月实例续费相关的功能如表1所示。 表1 续费相关的功能 功能 说明 手动续费 包年/包月实例从购买到被自动删除之前，您可以随时在控制台为实例续费，以延长实例的使用时间。 自动续费 开通自动续费后，实例会在每次到期前自动续费，避免因忘记手动续费而导致资源被自动删除。 在一台包年/包月实例生命周期的不同阶段，您可以根据需要选择一种方式进行续费，具体如图1所示。 图1 实例生命周期 实例从购买到到期前，处于正常运行阶段，资源状态为“使用中”。 到期后，资源状态变为“已过期”。 到期未续费时，实例首先会进入宽限期，宽限期到期后仍未续费，资源状态变为“已冻结”。 超过宽限期仍未续费将进入保留期，如果保留期内仍未续费，资源将被自动删除。 华为云根据客户等级定义了不同客户的宽限期和保留期时长。 实例到期前均可开通自动续费，到期前7日凌晨3:00首次尝试自动续费，如果扣款失败，每天凌晨3:00尝试一次，直至实例到期或者续费成功。到期前7日自动续费扣款是系统默认配置，您也可以根据需要修改此扣款日。

适用计费项 按需计费包含以下计费项。 表1 适用计费项 计费项 说明 实例规格 对所选的实例规格进行计费，包括vCPU和内存。 存储空间 对数据库存储空间进行计费，按需计费的存储空间费用按照实际使用量每小时计费。 备份空间 GeminiDB Influx提供了部分免费存储空间，用于存放您的备份数据，其总容量为您购买存储容量的100%。 备份存储用量超过购买存储容量的100%，超出部分将按照备份计费标准收费，计费方式为按需计费（每小时扣费一次），不足一小时按照实际使用时长收费。 冷存储空间（可选） GeminiDB Influx提供了冷存储空间，适用于数据量大，查询频率低的业务场景，购买冷存储空间会额外计费。 公网带宽（可选） GeminiDB Influx实例支持公网访问，公网访问会产生带宽流量费；GeminiDB Influx数据库实例在云内部网络产生的流量不计费。 假设您计划购买一个规格为2CPUs 8GB，3个节点，存储空间容量为100GB，冷存储空间容量为500GB的GeminiDB Influx实例。在购买数据库实例页面底部，您将看到所需费用的明细（不包含备份空间费用），如图1所示。 图1 配置费用 配置费用将包括以下部分： 云数据库虚拟机：根据所选配置（包括vCPU和内存）计算的费用。 云数据库存储空间：根据所选存储空间计算的费用。 备份空间费用，使用后按照统一标准计费，购买时不包含在配置费用中，可通过云数据库 GeminiDB价格详情查看。

计费周期 按需计费GeminiDB Influx实例按秒计费，每一个小时整点结算一次费用（以GMT+8时间为准），结算完毕后进入新的计费周期。计费的起点以GeminiDB Influx实例创建成功的时间点为准，终点以实例删除时间为准。 实例从创建到启动需要一定时长，计费的起点是创建成功的时间点，而非开始创建的时间。您可以在实例详情页“基本信息”页签查看这个时间，创建成功的时间点对应界面上的“创建时间”。 例如，您在8:45:30购买了一个按需计费的GeminiDB Influx实例，相关资源包括计算资源（vCPU和节点数量）、存储容量和备份存储，然后在8:55:00将其删除，则计费周期为8:00:00 ~ 9:00:00，在8:45:30 ~ 8:55:30间产生费用，该计费周期内的计费时长为600秒。

计费示例 假设您在2023/04/18 9:59:30购买了一个按需计费实例（规格：2vCPUs 8GB，节点数量：3，存储容量：100GB，备份存储：110GB（赠送100GB，后续收费空间10GB），冷存储空间容量：500GB），计费资源包括计算资源（vCPU和节点数量）和存储容量，然后在2023/04/18 10:45:46将其删除，则： 第一个计费周期为9:00:00 ~ 10:00:00，在9:59:30 ~ 10:00:00间产生费用，该计费周期内的计费时长为30秒。 第二个计费周期为10:00:00 ~ 11:00:00，在10:00:00 ~ 10:45:46间产生费用，该计费周期内的计费时长为2746秒。 10:00:00 ~ 10:45:00期间，使用免费备份空间。 10:45:00 ~ 10:45:46期间，使用计费备份空间10GB，计费时长46秒。 您需要为每个计费周期付费，各项GeminiDB Influx实例单独计费，计费公式如表2所示。产品价格详情中标出了实例的每小时价格，您需要将每小时价格除以3600，得到每秒价格。 表2 计费公式 资源类型 计费公式 资源单价 计算资源（vCPU和节点数量） 实例规格单价 * 计费时长 请参见云数据库 GeminiDB价格详情中的“集群-规格费用”。 存储容量 存储容量单价 * 购买时长 请参见云数据库 GeminiDB价格详情中的“集群磁盘空间计费信息”。 备份空间 备份空间单价 * 计费时长 * ( 备份容量 - 存储空间)(GB) 说明： 计费时长：备份超过免费空间大小的使用时长。 请参见云数据库 GeminiDB价格详情中的“备份空间计费信息。 冷存储空间 存储空间单价 * 购买时长 * 存储空间(GB) 请参见云数据库 GeminiDB价格详情中的“冷存储空间计费信息”。 公网流量 按固定带宽值采用阶梯计费 0Mbit/s~5Mbit/s（含）：均为一个统一的单价 大于5Mbit/s：按每Mbit/s计费 请参见弹性云服务器价格详情中的“带宽价格”，或者弹性公网IP价格详情。 图2给出了上述示例配置的费用计算过程。 图中价格仅供参考，实际计算请以云数据库 GeminiDB价格详情中的价格为准。 在按需付费模式下，价格计算器上的金额如果遇小数点，则保留小数点后两位，第三位四舍五入。如遇四舍五入后不足￥0.01，则按￥0.01展示。 图2 按需计费GeminiDB Influx费用计算示例

变更配置后对计费的影响 如果您在购买按需计费实例后变更了实例配置，会产生一个新订单并开始按新配置的价格计费，旧订单自动失效。 如果您在一个小时内变更了实例配置，将会产生多条计费信息。每条计费信息的开始时间和结束时间对应不同配置在该小时内的生效时间。 例如，您在9:00:00购买了一台按需计费实例，实例规格为 4vCPUs 16GB，并在9:30:00升配为 8vCPUs 32GB，那么在9:00:00 ~ 10:00:00间会产生两条计费信息。 第一条对应9:00:00 ~ 9:30:00，实例规格按照 4vCPUs 16GB计费。 第二条对应9:30:00 ~ 10:00:00，实例规格按照 8vCPUs 32GB计费。

修订记录 发布日期 更新特性 2023-08-02 第二十七次正式发布。 新增如下接口： 查询实例可搭建双活关系的Region。 2023-04-28 第二十六次正式发布。 应用参数模板，新增GeminiDB Influx单节点实例支持此功能。 修改指定实例的参数，新增GeminiDB Influx单节点实例支持此功能。 2023-03-31 第二十五次正式发布。 查询所有实例规格信息，新增计划下线时间和替换接口。 获取参数模板列表，新增计划下线时间和替换接口。 查询资源实例，新增计划下线时间和替换接口。 2023-03-06 第二十四次正式发布。 新增如下接口： 创建数据库账号 修改数据库账号权限 重置数据库账号密码 删除数据库账号 获取数据库账号列表和详情 获取实例数据库列表 2022-10-30 第二十三次正式发布。 新增如下接口： 判断弱密码 修改数据库端口 修改副本集跨网段访问配置 删除扩容失败的节点 查询创建实例或扩容节点时需要的IP数量 查询磁盘自动扩容策略 参数模板比较 复制参数模板 查询支持参数模板的接口信息 查询数据库错误日志信息 设置慢日志脱敏状态 2022-09-30 第二十二次正式发布。 新增如下接口： 查询参数模板可应用的实例列表。 查询实例参数的修改历史。 查询参数模板应用历史。 创建冷数据存储 扩容冷数据存储 绑定/解绑弹性公网IP 切换实例SSL开关 重启实例 设置磁盘自动扩容策略 暂停/恢复容灾实例间数据同步 创建手动备份 2022-08-30 第二十一次正式发布。 新增如下接口： 查询可恢复的实例列表。 查询实例可恢复的时间段。 删除手动备份。 恢复到已有实例。 2022-07-30 第二十次正式发布。 新增如下接口： 获取容灾实例主/备角色信息。 容灾实例备升主。 容灾实例主降备。 2022-07-15 第十九次正式发布。 新增如下接口： 校验实例是否可以与指定实例建立/解除容灾关系。 搭建实例与特定实例的容灾关系。 解除实例与指定实例的容灾关系。 2022-07-01 第十八次正式发布。 数据库补丁升级，GeminiDB Cassandra支持补丁升级。 扩容实例的节点数量，GeminiDB Influx支持扩容节点数量。 2022-06-02 第十七次正式发布。 查询实例列表和详情，新增字段“lb_port”和“subnet_id”。 扩容实例的节点数量，新增字段“subnet_id”。 2022-03-18 第十六次正式发布。 缩容实例的节点数量，GeminiDB Cassandra包年/包月实例支持缩容节点数量。 2021-09-03 第十五次正式发布。 变更实例规格，GeminiDB Redis支持规格变更。 2021-08-27 第十四次正式发布。 新增接口查询专属资源列表。 创建实例、查询实例列表和详情增加参数“dedicated_resouce_id”。 2021-07-30 第十三次正式发布。 查询数据库规格、获取参数模板列表，增加“offset”和“limit”参数。 查询资源实例，“resource_instances”修改为“resource-instances”。 GeminiDB Redis新增如下接口： 查询数据库版本信息 查询数据库规格 创建实例 删除实例 查询实例列表和详情 扩容实例存储容量 扩容实例的节点数量 缩容实例的节点数量 修改实例的管理员密码 修改实例名称 变更实例安全组 GeminiDB Influx新增如下接口： 变更实例安全组 GeminiDB Mongo新增如下接口： 扩容实例存储容量 修改实例的管理员密码 修改实例名称 变更实例安全组 2021-05-18 第十二次正式发布。 错误码，新增英文错误信息。 2021-04-15 第十一次正式发布。 GeminiDB Redis监控指标更新。 2020-12-30 第十次正式发布。 GeminiDB Influx支持如下API： 查询数据库版本信息 查询数据库规格 创建实例 删除实例 查询实例列表和详情 扩容实例存储容量 修改实例的管理员密码 修改实例名称 查询自动备份策略 设置自动备份策略 2020-11-30 第九次正式发布。 GeminiDB Influx支持如下API： 获取参数模板列表 创建参数模板 修改参数模板参数 应用参数模板 修改指定实例的参数 获取指定参数模板的参数 查询实例参数配置 删除参数模板 2020-10-30 第八次正式发布。 资源标签支持20个配额。 扩容实例存储容量，支持磁盘步长为1。 2020-09-30 第七次正式发布。 GeminiDB Mongo支持如下API： 创建实例 删除实例 获取参数模板列表 创建参数模板 修改参数模板参数 应用参数模板 修改指定实例的参数 查询实例参数配置 获取指定参数模板的参数 删除参数模板 2020-08-30 第六次正式发布。 GeminiDB Influx新增2个监控指标上报CES。 GeminiDB Redis新增监控30个指标。 查询实例列表和详情，查询数据库版本信息和查询数据库规格，支持GeminiDB Mongo实例。 新增获取参数模板列表 新增创建参数模板 新增修改参数模板参数 新增应用参数模板 新增修改指定实例的参数 新增查询实例参数配置 新增获取指定参数模板的参数 新增删除参数模板 新增变更实例规格 新增修改实例的管理员密码 新增修改实例名称 新增变更实例安全组 新增查询自动备份策略 新增设置自动备份策略 2020-07-30 第五次正式发布。 新增包周期实例，创建实例和查询实例列表和详情 新增扩容实例存储容量 新增扩容实例的节点数量 新增缩容实例的节点数量 2020-04-30 第四次正式发布。 新增监控指标。 2020-03-31 第三次正式发布。 新增策略和授权项说明 新增云数据库 GeminiDB授权项说明 新增部分监控指标。 2020-03-13 第二次正式发布。 新增查询数据库慢日志 2019-11-18 第一次正式发布。

支持的授权项 策略包含系统策略和自定义策略，如果系统策略不满足授权要求，管理员可以创建自定义策略，并通过给用户组授予自定义策略来进行精细的访问控制。策略支持的操作与API相对应，授权项列表说明如下： 权限：允许或拒绝某项操作。 对应API接口：自定义策略实际调用的API接口。 授权项(Action)：自定义策略中支持的Action，在自定义策略中的Action中写入授权项，可以实现授权项对应的权限功能。 IAM项目(Project)/企业项目(Enterprise Project)：自定义策略的授权范围，包括IAM项目与企业项目。授权范围如果同时支持IAM项目和企业项目，表示此授权项对应的自定义策略，可以在IAM和企业管理两个服务中给用户组授权并生效。如果仅支持IAM项目，不支持企业项目，表示仅能在IAM中给用户组授权并生效，如果在企业管理中授权，则该自定义策略不生效。关于IAM项目与企业项目的区别，详情请参见IAM与企业管理的区别。 云数据库 GeminiDB支持的自定义策略授权项请参见云数据库 GeminiDB授权项说明。

请求方法 HTTP请求方法（也称为操作或动词），它告诉服务你正在请求什么类型的操作。 表2 HTTP方法 方法 说明 GET 请求服务器返回指定资源。 PUT 请求服务器更新指定资源。 POST 请求服务器新增资源或执行特殊操作。 DELETE 请求服务器删除指定资源，如删除对象等。 在获取用户Token的URI部分，您可以看到其请求方法为“POST”，则其请求为： POST https://iam.cn-north-1.myhuaweicloud.com/v3/auth/tokens

请求消息头 附加请求头字段，如指定的URI和HTTP方法所要求的字段。例如定义消息体类型的请求头“Content-Type”，请求鉴权信息等。 详细的公共请求消息头字段请参见表3。 表3 公共请求消息头 名称 描述 是否必选 示例 Content-Type 发送的实体的MIME类型。推荐用户默认使用application/json，如果API是对象、镜像上传等接口，媒体类型可按照流类型的不同进行确定。 是 application/json Content-Length 请求body长度，单位为Byte。 POST请求为可选，GET请求该字段值留空。 3495 X-Project-Id project id，项目编号。请参考获取项目ID章节获取项目编号。 否 e9993fc787d94b6c886cbaa340f9c0f4 X-Auth-Token 用户Token。 请求响应成功后在响应消息头中包含的“X-Subject-Token”的值即为Token值。 是 注：以下仅为Token示例片段 MIIPAgYJKoZIhvcNAQcCo...ggg1BBIINPXsidG9rZ 对于获取用户Token接口，由于不需要认证，所以只添加“Content-Type”即可，添加消息头后的请求如下所示。 POST https://iam.cn-north-1.myhuaweicloud.com/v3/auth/tokens Content-Type: application/json

请求消息体（可选） 该部分可选。请求消息体通常以结构化格式（如JSON或XML）发出，与请求消息头中Content-Type对应，传递除请求消息头之外的内容。若请求消息体中的参数支持中文，则中文字符必须为UTF-8编码。 每个接口的请求消息体内容不同，也并不是每个接口都需要有请求消息体（或者说消息体为空），GET、DELETE操作类型的接口就不需要消息体，消息体具体内容需要根据具体接口而定。 对于获取用户Token接口，您可以从接口的请求部分看到所需的请求参数及参数说明。将消息体加入后的请求如下所示，加粗的斜体字段需要根据实际值填写，其中username为用户名，domianname为用户所属的账号名称，********为用户登录密码，xxxxxxxxxxxxxxxxxx为project的名称，如“”“cn-north-1”，您可以从地区和终端节点获取。 scope参数定义了Token的作用域，上面示例中获取的Token仅能访问project下的资源。您还可以设置Token的作用域为某个账号下所有资源或账号的某个project下的资源，详细定义请参见获取用户Token。 POST https://iam.cn-north-1.myhuaweicloud.com/v3/auth/tokens Content-Type: application/json { "auth": { "identity": { "methods": [ "password" ], "password": { "user": { "name": "username", "password": "********", "domain": { "name": "domianname" } } } }, "scope": { "project": { "name": "xxxxxxxxxxxxxxxxxx" } } } } 到这里为止这个请求需要的内容就具备齐全了，您可以使用curl、Postman或直接编写代码等方式发送请求调用API。对于获取用户Token接口，返回的响应消息头中“x-subject-token”就是需要获取的用户Token。有了Token之后，您就可以使用Token认证调用其他API。

请求URI 请求URI由如下部分组成： {URI-scheme}://{Endpoint}/{resource-path}?{query-string} 尽管请求URI包含在请求消息头中，但大多数语言或框架都要求您从请求消息中单独传递它，所以在此单独强调。 表1 URI中的参数说明 参数 描述 URI-scheme 表示用于传输请求的协议，当前所有API均采用HTTPS协议。 Endpoint 指定承载REST服务端点的服务器域名或IP，不同服务不同区域的Endpoint不同，您可以从地区和终端节点获取。 例如IAM服务在“华北-北京一”区域的Endpoint为“iam.cn-north-1.myhuaweicloud.com”。 resource-path 资源路径，也即API访问路径。从具体API的URI模块获取，例如“获取用户Token”API的resource-path为“/v3/auth/tokens”。 query-string 查询参数，是可选部分，并不是每个API都有查询参数。查询参数前面需要带一个“？”，形式为“参数名=参数取值”，例如“limit=10”，表示查询不超过10条数据。 例如您需要获取IAM在“华北-北京一”区域的Token，则需使用“华北-北京一”区域的Endpoint（iam.cn-north-1.myhuaweicloud.com），并在获取用户Token的URI部分找到resource-path（/v3/auth/tokens），拼接起来如下所示。 https://iam.cn-north-1.myhuaweicloud.com/v3/auth/tokens 图1 URI示意图 为查看方便，在每个具体API的URI部分，只给出resource-path部分，并将请求方法写在一起。这是因为URI-scheme都是HTTPS，而Endpoint在同一个区域也相同，所以简洁起见将这两部分省略。

请求示例 URI样例 PUT https://gaussdb-nosql.cn-north-4.myhuaweicloud.com/v3/054e292c9880d4992f02c0196d3ea468/redis/instances/3d39c18788b54a919bab633874c159dfin12/db-users/privilege 修改2个数据库账号权限。将test1账号权限修改为只读，数据库名称列表修改为[ "1", "2" ]，将test2账号权限修改为读写，数据库名称列表修改为[ "3", "4" ] { "users" : [ { "name" : "test1", "privilege" : "ReadOnly", "databases" : [ "1", "2" ] }, { "name" : "test2", "privilege" : "ReadWrite", "databases" : [ "3", "4" ] } ] }

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。 表3 请求Body参数 参数 是否必选 参数类型 描述 users 否 Array of objects 修改数据库账号权限请求体。详情请参考表4。 表4 ModifyDbUserPrivilegeRequestBody 参数 是否必选 参数类型 描述 name 是 String 账号名称 privilege 是 String 账号权限。 取值"ReadOnly"：账号为只读权限； 取值"ReadWrite"：账号为读写权限。 databases 否 Array of strings 账号授权database列表。不传值则对账号授权的db不做修改。

URI GET /v3/{project_id}/redis/instances/{instance_id}/databases 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 租户在某一region下的project ID。获取方法请参见获取项目ID。 instance_id 是 String 实例ID。 表2 Query参数 参数 是否必选 参数类型 描述 offset 否 Integer 索引位置，偏移量。 从第一条数据偏移offset条数据后开始查询，默认为0。 取值必须为数字，且不能为负数。 limit 否 Integer 查询个数上限值。 取值范围：1~100。 不传该参数时，默认查询前100条信息。

请求示例 URI样例 PUT https://gaussdb-nosql.cn-north-4.myhuaweicloud.com/v3/054e292c9880d4992f02c0196d3ea468/redis/instances/3d39c18788b54a919bab633874c159dfin12/db-users/password 重置“db_user1”账号密码 { "name" : "db_user1", "password" : "********" }

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。 表3 请求Body参数 参数 是否必选 参数类型 描述 name 是 String 账号名称 password 是 String 需重置的密码。 密码长度为8~32位。 密码需包含大写字母、小写字母、数字和特殊字符中的至少两种，支持的特殊字符为~ ! @ # % ^ * - _ = +? $ () & 。

请求示例 开启磁盘自动扩容策略 URI样例 POST https://gaussdb-nosql.cn-north-7.myhuaweicloud.com/v3/619d3e78f61b4be68bc5aa0b59edcf7b/instances/disk-auto-expansion 开启磁盘自动扩容策略，设置自动扩容阈值为90，扩容步长为10%，通过自动扩容所能达到的存储空间上限为600GB { "instance_ids" : [ "93e4b3eda14349b1b870f72829bc3b9bin06" ], "policy" : { "threshold" : 90, "step" : 10, "size" : 600 } } 关闭磁盘自动扩容策略 URI样例 POST https://gaussdb-nosql.cn-north-7.myhuaweicloud.com/v3/619d3e78f61b4be68bc5aa0b59edcf7b/instances/disk-auto-expansion 关闭磁盘自动扩容策略 { "instance_ids" : [ "93e4b3eda14349b1b870f72829bc3b9bin06" ], "switch_option":"off" }

URI GET /v3/{project_id}/redis/instances/{instance_id}/db-users 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 租户在某一region下的project ID。获取方法请参见获取项目ID。 instance_id 是 String 实例ID。 表2 Query参数 参数 是否必选 参数类型 描述 name 否 String 数据库账号名。若传此参数，则查询指定账号的信息，否则返回所有数据库账号信息。 offset 否 Integer 索引位置，偏移量。 从第一条数据偏移offset条数据后开始查询，默认为0。 取值必须为数字，且不能为负数。 limit 否 Integer 查询个数上限值。 取值范围：1~100。 不传该参数时，默认查询前100条信息。

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 users Array of objects 数据库用户信息列表。详情请参考表5。 total_count Integer 总记录数。 表5 DbUserInfo 参数 参数类型 描述 name String 账号名称。 type String 账号类型。 rwuser：管理员用户 acluser：普通用户 privilege String 账号权限。 取值"ReadOnly"：账号为只读权限； 取值"ReadWrite"：账号为读写权限。 databases Array of strings 账号已授权的数据库名称列表。

响应示例 状态码： 200 Success. { "users" : [ { "name" : "db_user1", "type" : "rwuser", "privilege" : "ReadWrite", "databases" : [ "1", "2" ] }, { "name" : "db_user2", "type" : "acluser", "privilege" : "ReadWrite", "databases" : [ "1", "2" ] } ], "total_count" : 2 }

请求示例 URI样例 POST https://gaussdb-nosql.cn-north-4.myhuaweicloud.com/v3/v3/0549b4a43100d4f32f51c01c2fe4acdb/redis/054e292c9880d4992f02c0196d3ein12/db-users 创建2个数据库账号。第一个账号名为“redis1”，密码为"****"，权限为只读，数据库名称列表为[ "1", "2" ] { "users" : [ { "name" : "redis1", "password" : "****", "privilege" : "ReadOnly", "databases" : [ "1", "2" ] }, { "name" : "redis2", "password" : "****", "privilege" : "ReadOnly", "databases" : [ "1", "2" ] } ] }

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。 表3 请求Body参数 参数 是否必选 参数类型 描述 users 否 Array of objects 需要创建的账号列表。详情请参考表4。 表4 UserForCreation 参数 是否必选 参数类型 描述 name 是 String 账号名称。不能为空，长度不超过36个字符，以字母开头，仅包含数字、字母、中划线、下划线。 password 是 String 密码长度为8~32位。 密码需包含大写字母、小写字母、数字和特殊字符中的至少两种，支持的特殊字符为~ ! @ # % ^ * - _ = +? $ () &。 最小长度：8 最大长度：32 databases 是 Array of strings 账号授权的数据库名称列表，至少指定一个数据库，或指定"all"来选择所有数据库。 privilege 是 String 账号权限。 取值"ReadOnly"：账号为只读权限； 取值"ReadWrite"：账号为读写权限。

请求示例 URI样例 DELETE https://gaussdb-nosql.cn-north-4.myhuaweicloud.com/v3/375d8d8fad1f43039e23d3b6c0f60a19/redis/instances/9136fd2a9fcd405ea4674276ce36dae8in12/db-users 请求体样例 { "names" : [ "test1", "test2" ] }