华为云用户手册

创表数目计算方式 根据实例规格不同，创表需要的内存稍有不同，以4U16GB实例为例，可以简单按照单张表768MB计算。 所以创表数目上限=集群可用总内存/单表所需内存 奇数数目集群 集群可用内存=节点内存/2*(N/2+1) 偶数数目集群 集群可用内存=节点内存/2*(N/2) 例如： 3节点4U16GB实例的可用内存=16/2*(3/2+1)=16GB 创表数目上限=16*1024MB/768MB=21 4节点4U16GB实例的可用内存=16/2*(4/2)=16GB 创表数目上限=16*1024MB/768MB=21 5节点4U16GB实例可用内存=16/2*(5/2+1)=24GB 创表数目上限=24*1024MB/768MB=32 根据上述计算方式，4U16GB规格实例的节点个数和表个数对应关系，请参见表1。 表1 4U16GB规格实例的节点数和表个数对应关系 实例规格 节点数量 表个数 4U16GB 3 21 4 21 5 32 6 32 7 42 8 42 9 53 10 53 11 64 12 64 单表占用内存为768MB，表tokens个数为默认值12，如果单独设置了tokens，则需要单独计算，换算公式为（768/12）*tokens个数。 上述表个数都是按照普通表计算的，如果开启了流表，一张流表耗费的资源为2.5个普通表。 根据上述计算方式，8U32GB规格实例的节点个数和表个数对应关系，请参见表2。 表2 8U32GB规格实例的节点个数和表个数对应关系 实例规格 节点个数 表个数 8U32GB 3 22 4 22 5 34 6 34 7 45 8 45 9 56 10 56 11 68 12 68 单表占用内存为1440MB，表tokens个数为默认值12，如果单独设置了tokens，则需要单独计算，换算公式为（1440/ 12 ）* tokens个数。 上述表个数都是按照普通表计算的，如果开启了流表，一张流表耗费的资源为2.5个普通表。 根据上述计算方式，16U64GB规格节点个数和表个数对应关系，请参见表3。 表3 16U64GB规格节点个数和表个数对应关系 实例规格 节点个数 表个数 16U64GB 3 45 4 45 5 68 6 68 7 91 8 91 9 113 10 113 11 136 12 136 单表占用内存1440MB，表tokens个数为默认值12，如果单独设置了tokens，则需要单独计算，换算公式为（1440/ 12 ）* tokens个数。 上述表个数都是按照普通表计算的，如果开启了流表，一张流表耗费的资源为2.5个普通表。 根据上述计算方式，32U128GB规格节点个数和表个数对应关系，请参见表4。 表4 32U128GB规格节点个数和表个数对应关系 实例规格 节点个数 表个数 32U128GB 3 68 4 68 5 102 6 102 7 136 8 136 9 170 10 170 11 204 12 204 单表占用内存1920MB，表tokens个数为默认值12，如果单独设置了tokens，则需要单独计算。换算公式为 （1920 / 12 ）* tokens个数。 上述表个数都是按照普通表计算的，如果开启了流表，一张流表耗费的资源为2.5个普通表。

变更计费模式概述 在购买GeminiDB Cassandra后，如果发现当前计费模式无法满足业务需求，您可以变更计费模式。支持变更计费模式的GeminiDB Cassandra计费项如表1所示。 表1 支持变更计费模式的GeminiDB Cassandra计费项 计费项 变更说明 相关文档 实例规格（vCPU和节点数量） 变更GeminiDB Cassandra实例的计费模式会同时变更计算资源（vCPU和节点数量）的计费模式。 将GeminiDB Cassandra实例的计费模式从按需计费转为包年/包月，可以让您享受一定程度的价格优惠。 将GeminiDB Cassandra实例的计费模式从包年/包月转为按需计费，可以帮助您回收部分成本，并更加灵活地使用GeminiDB Cassandra资源。 说明： 包年/包月计费模式到期后，按需计费模式才会生效。 按需转包年/包月 包年/包月转按需 EIP 包年/包月EIP支持到期后转为按需、按带宽计费EIP。 按需、按带宽计费EIP支持转为包年/包月EIP。 按需、按带宽计费EIP支持和按需、按流量计费EIP互转。 具体变更方式可参考图1。 按需转包年/包月 包年/包月转按需 图1 EIP计费模式变更 父主题： 变更计费模式

自定义策略样例 示例1：授权用户创建云数据库 GeminiDB实例 { "Version": "1.1", "Statement": [ { "Effect": "Allow", "Action": [ "nosql:instance:create" ] } ] } 示例2：拒绝用户删除云数据库 GeminiDB数据库实例 拒绝策略需要同时配合其他策略使用，否则没有实际作用。用户被授予的策略中，一个授权项的作用如果同时存在Allow和Deny，则遵循Deny优先原则。 如果您给用户授予GaussDB NoSQLFullAccess的系统策略，但不希望用户拥有GaussDB NoSQLFullAccess中定义的删除云数据库 GeminiDB实例权限，您可以创建一条拒绝删除云数据库 GeminiDB实例的自定义策略，然后同时将GaussDB NoSQLFullAccess和拒绝策略授予用户，根据Deny优先原则，则用户可以对云数据库 GeminiDB执行除了删除云数据库 GeminiDB实例外的所有操作。拒绝策略示例如下： { "Version": "1.1", "Statement": [ { "Effect": "Deny" "Action": [ "nosql:instance:delete" ], } ] } 示例3：多个授权项策略 一个自定义策略中可以包含多个授权项，且除了可以包含本服务的授权项外，还可以包含其他服务的授权项，可以包含的其他服务必须跟本服务同属性，即都是项目级服务或都是全局级服务。多个授权语句策略描述如下： { "Version": "1.1", "Statement": [ { "Action": [ "nosql:instance:create", "nosql:instance:rename", "nosql:instance:delete", "vpc:publicIps:list", "vpc:publicIps:update" ], "Effect": "Allow" } ] }

请求示例 获取主实例 URI样例 GET https://{Endpoint}/v3/054e292c9880d4992f02c0196d3ea468/instances/341f3291813f4fb6a523a8448aa86570in12/instance-role 获取备实例 URI样例 GET https://{Endpoint}/v3/054e292c9880d4992f02c0196d3ea468/instances/419bdeb827c8419e88bb37f50e36c2e1in12/instance-role

响应示例 状态码： 200 Success { "histories" : [ { "instance_id" : "a2d0cf32db3e4f2aa3a684240e10b457in06", "instance_name" : "test", "applied_at" : "2022-09-20T11:17:04+0000", "apply_result" : "SUCCESS", "failure_reason": "" } ] }

URI GET https://{Endpoint}/v3/{project_id}/configurations/{config_id}/applied-histories 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 租户在某一region下的project ID。获取方法请参见获取项目ID。 config_id 是 String 参数模板id。 表2 Query参数 参数 是否必选 参数类型 描述 offset 否 Integer 索引位置，偏移量。 从第一条数据偏移offset条数据后开始查询，默认为0（偏移0条数据，表示从第一条数据开始查询）。 取值必须为数字，不能为负数。 limit 否 Integer 查询个数上限值。 取值范围: 1~100。 不传该参数时，默认查询前100条信息。

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 histories Array of ApplyHistoryRsp objects 参数模板应用历史列表。 表5 ApplyHistoryRsp 参数 参数类型 描述 instance_id String 实例ID。 instance_name String 实例名称 applied_at String 生效时间，格式为"yyyy-MM-ddTHH:mm:ssZ"。 其中，T指某个时间的开始；Z指时区偏移量，例如北京时间偏移显示为+0800。 apply_result String SUCCESS：应用成功。 APPLYING：应用中。 FAILED：应用失败。 failure_reason String 失败原因。

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 slow_log_list Array of SlowlogResult objects 具体信息。 total_record Integer 总记录数。 表5 SlowlogResult 参数 参数类型 描述 time String 执行时间。 database String 所属数据库。 query_sample String 执行语法。 type String 语句类型。 start_time String 发生时间，UTC时间。

请求示例 URI样例 查询数据库慢日志： GET https://gaussdb-nosql.cn-north-4.myhuaweicloud.com/v3/0483b6b16e954cb88930a360d2c4e663/instances/6ade8143870047b8999aba8f1891b48ein06/slowlog?start_date=2018-08-06T10:41:14+0800&end_date=2018-08-07T10:41:14+0800 URI样例 根据指定条件查询数据库慢日志： GET https://gaussdb-nosql.cn-north-4.myhuaweicloud.com/v3/0549b4a43100d4f32f51c01c2fe4acdb/instances/6ade8143870047b8999aba8f1891b48ein06/slowlog?type=SELECT&offset=1&limit=20&node_id=a7c84462483642798cf159237343135fno06&start_date=2018-08-06T10:41:14+0800&end_date=2018-08-07T10:41:14+0800

响应示例 状态码： 200 Success { "total_record" : 1, "slow_log_list" : [ { "time" : "513 ms", "database" : "cassandra", "query_sample" : "SELECT * FROM cassandra.sz_user_hw LIMIT 100;", "type" : "SELECT", "start_time" : "2020-11-15T22:49:38.643000Z" } ] }

URI POST https://{Endpoint}/v3/{project_id}/instances/{instance_id}/disaster-recovery/deconstruction 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 租户在某一region下的project ID。获取方法请参见获取项目ID。 instance_id 是 String 实例ID。

URI GET https://{Endpoint}/v3/{project_id}/instances/{instance_id}/disaster-recovery/regions 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 租户在某一region下的project ID。获取方法请参见获取项目ID。 instance_id 是 String 实例ID。

请求示例 URI样例 PUT https://gaussdb-nosql.cn-north-4.myhuaweicloud.com/v3/375d8d8fad1f43039e23d3b6c0f60a19/instances/9136fd2a9fcd405ea4674276ce36dae8in06/password 修改实例的管理员密码为"******" { "password" : "******" }

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。 表3 请求Body参数 参数 是否必选 参数类型 描述 password 是 String 数据库密码。 取值范围：长度为8~32位。必须是大写字母（A~Z）、小写字母（a~z）、数字（0~9）、特殊字符~!@#%^*-_=+?$()&至少两种的组合。仅GeminiDB Redis至少包含以下字符中的2种：大写字母、小写字母、数字和特殊字符~！@#$%^&*()-_=+？。 建议您输入高强度密码，以提高安全性，防止出现密码被暴力破解等安全风险。

接口约束 该接口支持如下数据库实例： GeminiDB Cassandra GeminiDB Influx 该接口不支持GeminiDB Influx单节点实例。 使用该接口前，需确保全量备份、增量备份和自动备份策略已开启。增量备份您可以联系客服申请开通，增量备份开通后，等下次自动备份时才会开启。 该接口目前仅支持查询实例可恢复的时间点，所以“start_time”和“end_time”的参数取值是相同的。

URI GET https://{Endpoint}/v3/{project_id}/instances/{instance_id}/backups/restorable-time-periods 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 用户在某一region下的project ID。获取方法请参见获取项目ID。 instance_id 是 String 实例Id，可以调用5.3.3 查询实例列表和详情接口获取。如果未申请实例，可以调用5.3.1 创建实例接口创建。 表2 Query参数 参数 是否必选 参数类型 描述 start_time 否 String 查询的可恢复时间段的开始时间点，为yyyy-mm-ddThh:mm:ssZ字符串格式，T指某个时间的开始，Z指时区偏移量。 例如北京时间偏移显示为+0800。默认值为当前查询时间的前一天。 end_time 否 String 查询的可恢复时间段的结束时间点，为yyyy-mm-ddThh:mm:ssZ字符串格式，T指某个时间的开始，Z指时区偏移量。 例如北京时间偏移显示为+0800。默认值为当前查询时间。 offset 否 Integer 偏移量，表示查询该偏移量后面的记录，默认值为0。 limit 否 Integer 查询返回记录的数量上限值，取值范围为0~1000，默认值为1000。

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 total_count Integer 实例可恢复时间段总数。 restorable_time_periods Array of restorableTime objects 实例可恢复的时间段。 表5 restorableTime 参数 参数类型 描述 start_time Long 可恢复时间段的开始时间点，UNIX时间戳格式，单位是毫秒，时区是UTC。 end_time Long 可恢复时间段的结束时间点， UNIX时间戳格式，单位是毫秒，时区是UTC。

请求示例 URI样例 GET https://gaussdb-nosql.cn-north-4.myhuaweicloud.com/v3/054e292c9880d4992f02c0196d3ea468/instances/a4d8ea2584e047439a667703c0684119in06/backups/restorable-time-periods?start_time=2022-06-01T18:50:20+0800&end_time=2022-06-01T19:50:20+0800&offset=0&limit=1000

请求示例 URI样例 POST https://gaussdb-nosql.cn-north-7.myhuaweicloud.com/v3/054e292c9880d4992f02c0196d3ea468/instances/054e292c9880d4992f02c0196d3ein12/disaster-recovery/precheck 校验实例是否可以与特定实例建立容灾关系 { "operation" : "construction", "disaster_recovery_instance" :{ "node_ips" : [ "10.0.1.2", "10.0.1.3", "10.0.1.4" ], "spec_code" : "geminidb.redis.xlarge.4", "vpc_cidr" : "10.0.0.0/16" } } 校验实例是否可以与特定实例解除容灾关系 { "operation" : "deconstruction" }

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。 表3 请求Body参数 参数 是否必选 参数类型 描述 operation 是 String 指定预校验的具体容灾操作。 取值construction，表示搭建实例的容灾关系。 取值deconstruction，表示解除实例的容灾关系。 disaster_recovery_instance 否 object 与当前实例建立容灾关系的实例信息。详情请参考表4。 说明： operation取值construction时该字段必须下发。 operation取值deconstruction时该字段无需下发。 表4 TargetDisasterRecoveryInstance 参数 是否必选 参数类型 描述 node_ips 是 Array of strings 与当前实例建立容灾关系实例的节点IP列表。 spec_code 是 String 与当前实例建立容灾关系实例的规格码。 vpc_cidr 是 String 与当前实例建立容灾关系实例的vpc网段。

URI POST https://{Endpoint}/v3/{project_id}/instances/{instance_id}/disaster-recovery/precheck 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 租户在某一region下的project ID。获取方法请参见获取项目ID。 instance_id 是 String 实例ID。

响应示例 状态码： 200 Success { "configuration" : { "id" : "463b4b58d0e84e2b95605dea4552fdpr06", "name" : "configuration_test", "datastore_version_name" : "3.11", "datastore_name" : "cassandra", "description" : "configuration_test", "created" : "2020-03-09T08:27:56+0800", "updated" : "2020-03-09T08:27:56+0800" } }

请求示例 URI样例 POST https://gaussdb-nosql.cn-north-4.myhuaweicloud.com/v3/375d8d8fad1f43039e23d3b6c0f60a19/configurations 创建Cassandra参数模板 { "name" : "configuration_test", "description" : "configuration_test", "values" : { "max_connections" : "10", "autocommit" : "OFF" }, "datastore" : { "type" : "cassandra", "version" : "3.11" } }

响应参数 状态码： 200 表5 响应Body参数 参数 参数类型 描述 configuration ConfigurationResult object 参数模板信息。 表6 ConfigurationResult 参数 参数类型 描述 id String 参数模板ID。 name String 参数模板名称。 datastore_version_name String 数据库版本名称。 datastore_name String 数据库名称。 description String 参数模板描述。 created String 创建时间，格式为"yyyy-MM-ddTHH:mm:ssZ"。 其中，T指某个时间的开始；Z指时区偏移量，例如北京时间偏移显示为+0800。 updated String 更新时间，格式为"yyyy-MM-ddTHH:mm:ssZ"。 其中，T指某个时间的开始；Z指时区偏移量，例如北京时间偏移显示为+0800。

请求示例 URI样例 PUT https://gaussdb-nosql.cn-north-7.myhuaweicloud.com/v3/054e292c9880d4992f02c0196d3ea468/instances/392850e624504e1490901d50b585a60din06/configurations 修改指定实例的参数 { "values" : { "request_timeout_in_ms" : "10000" } }

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。 表3 请求Body参数 参数 是否必选 参数类型 描述 size 是 Integer 待扩容到的磁盘容量。取值为整数，并且大于当前磁盘容量。 磁盘容量最大值的大小与所选接口类型以及规格相关。 GeminiDB Cassandra请参见数据库实例规格。 GeminiDB Mongo请参见数据库实例规格。 GeminiDB Influx请参见数据库实例规格。 GeminiDB Redis请参见数据库实例规格。 is_auto_pay 否 String 创建包周期实例时可指定，表示是否自动从账户中支付，此字段不影响自动续订的支付方式。 true，表示自动从账户中支付。 false，表示手动从账户中支付，默认为该方式。

响应示例 状态码： 200 Success { "id" : "07fc12a8e0e94df7a3fcf53d0b5e1605pr06", "name" : "default-cassandra-3.11", "datastore_version_name" : "3.11", "datastore_name" : "cassandra", "description" : "Default parameter group for cassandra 3.11", "created" : "2020-03-21T04:40:51+0800", "updated" : "2020-03-21T04:40:51+0800", "configuration_parameters" : [ { "name" : "concurrent_reads", "value" : "64", "restart_required" : true, "readonly" : true, "value_range" : "4-512", "type" : "integer", "description" : "Number of concurrent read threads." } ] }

响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 id String 参数模板ID。 name String 参数模板名称。 description String 参数模板描述。 datastore_version_name String 数据库版本名称。 datastore_name String 数据库名称。 created String 创建时间，格式为"yyyy-MM-ddTHH:mm:ssZ"。 其中，T指某个时间的开始；Z指时区偏移量，例如北京时间偏移显示为+0800。 updated String 更新时间，格式为"yyyy-MM-ddTHH:mm:ssZ"。 其中，T指某个时间的开始；Z指时区偏移量，例如北京时间偏移显示为+0800。 configuration_parameters Array of ConfigurationParameterResult objects 参数对象，用户基于默认参数模板自定义的参数配置。 表4 ConfigurationParameterResult 参数 参数类型 描述 name String 参数名称。 value String 参数值。 restart_required Boolean 是否需要重启。 取值为“false”，不需要重启。 取值为“true”，需要重启。 readonly Boolean 是否只读。 取值为“false”，非只读参数。 取值为“true”，只读参数。 value_range String 参数值范围。示例：Integer类型取值范围为0~1、Boolean类型取值为“true”或“false”。 type String 参数类型。取值为“string”、“integer”、“boolean”、“list”或“float”。 description String 参数描述。

响应示例 状态码： 200 Success { "histories" : [ { "parameter_name" : "mongos.connPoolMaxShardedConnsPerHost", "old_value" : "600", "new_value" : "500", "update_result" : "FAILED", "applied" : true, "updated_at" : "2022-09-20T11:17:04+0000", "applied_at" : "2022-09-20T11:17:04+0000" } ] }

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 histories Array of ConfigurationHistoryRsp objects 实例参数的修改历史列表。 表5 ConfigurationHistoryRsp 参数 参数类型 描述 parameter_name String 参数名称。 old_value String 参数旧值。 new_value String 参数新值。 update_result String 更新结果。 SUCCESS：成功。 FAILED：失败。 applied Boolean true：已生效。 false：未生效。 updated_at String 更新时间，格式为"yyyy-MM-ddTHH:mm:ssZ"。 其中，T指某个时间的开始；Z指时区偏移量，例如北京时间偏移显示为+0800。 applied_at String 生效时间，格式为"yyyy-MM-ddTHH:mm:ssZ"。 其中，T指某个时间的开始；Z指时区偏移量，例如北京时间偏移显示为+0800。