华为云用户手册

响应示例 状态码： 200 OK [ { "result" : "error", "status" : "completed", "stages" : [ { "result" : "success", "status" : "completed", "name" : "initial", "parameters" : null, "order" : 1, "dsl_method" : "initial", "display_name" : "源代码" }, { "result" : "success", "status" : "completed", "name" : "state_3", "parameters" : null, "order" : 2, "dsl_method" : "build", "display_name" : "构建" } ], "executor" : "devcloud_xxx", "pipeline_name" : "PipelineSvc测试勿删_继续执行", "pipeline_id" : "92a65e2337174fabbdbccda97ab7ffad", "detail_url" : "https://xxxxx", "modify_url" : "https://xxxxxx", "start_time" : "2022-09-09 00:00:00", "end_time" : "2022-09-09 00:00:24", "build_id" : "25" } ]

响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 [数组元素] Array of PipelineExecuteStates objects OK 表4 PipelineExecuteStates 参数 参数类型 描述 result String 流水线执行结果。取值及含义：success：成功；error：失败；aborted：终止 status String 流水线执行状态.取值和含义:waiting:等待;running:执行中;verifying:待审核;suspending:挂起;completed:完成 stages Array of Stages objects 阶段执行情况 executor String 执行人 pipeline_name String 流水线名字 pipeline_id String 流水线ID build_id String 流水线执行ID detail_url String 流水线详情页URL modify_url String 流水线编辑页URL start_time String 开始执行时间 end_time String 结束执行时间 表5 Stages 参数 参数类型 描述 result String 阶段执行结果。取值及含义：success：成功；error：失败；aborted：终止 status String 阶段执行状态。取值和含义:waiting:等待;running:执行中;verifying:待审核;suspending:挂起;completed:完成 name String 阶段名字 parameters Object 阶段运行参数 order Integer 阶段顺序 dsl_method String 阶段类型 display_name String 阶段显示名称 状态码： 400 表6 响应Body参数 参数 参数类型 描述 error_msg String 错误信息 error_code String 错误码

请求示例 启动流水线。 指定启动时的运行参数为”ServiceName:pipeline-Test”和”version:1.0.0”。 { "build_params" : [ { "name" : "ServiceName", "value" : "pipeline-Test" }, { "name" : "version", "value" : "1.0.0" } ] }

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token，通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 表3 请求Body参数 参数 是否必选 参数类型 描述 build_params 否 Array of StartPipelineBuildParams objects 启动流水线时的构建参数 表4 StartPipelineBuildParams 参数 是否必选 参数类型 描述 name 是 String 构建参数名 value 是 String 构建参数值，最大长度为8192

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 data Array of RuleSet objects 规则实例列表 total Long 总数 表5 RuleSet 参数 参数类型 描述 id String 规则模版实例ID name String 规则模版实例名称 type String 类型 version String 版本 operator String 最近操作人 operate_time Long 最近操作时间 is_valid Boolean 是否生效 level String 租户级、项目级 is_public Boolean 是否系统级 状态码： 400 表6 响应Body参数 参数 参数类型 描述 error_msg String 错误信息 error_code String 错误码

响应示例 状态码： 200 OK { "data" : [ { "id" : "30782f30c92e4c1dbc3c596075970d67", "name" : "DJtest创建租户级策略-apitest-rKaG", "level" : "tenant", "is_valid" : true, "version" : "67e915e472554f719abe513c28728d9f", "operator" : "devcloud_xxx", "is_public" : false, "operate_time" : 1692695390000 }, { "id" : "4f5fb96022974a2781174584f799d8c2", "name" : "DJtest创建租户级策略-apitest-S190", "level" : "tenant", "is_valid" : true, "version" : "61ebfef577c34406b5647ac1d83e7bb8", "operator" : "devcloud_xxx", "is_public" : false, "operate_time" : 1692695390000 } ], "total" : 333 }

URI GET /v2/{domain_id}/tenant/rule-sets/query 表1 路径参数 参数 是否必选 参数类型 描述 domain_id 是 String 租户ID 表2 Query参数 参数 是否必选 参数类型 描述 offset 是 Integer 偏移量，表示从此偏移量开始查询，offset大于等于0 limit 是 Integer 每页显示的条目数量 include_tenant_rule_set 是 Boolean 是否包含租户级规则 name 否 String 策略名称，用于模糊查询 is_valid 否 Boolean 是否有效 type 否 String 规则集类型 cloud_project_id 否 String 项目ID

响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 offset Integer 起始偏移 limit Integer 每页大小 total Integer 总数 templates Array of PipelineTemplateSimpleVO objects 流水线模板列表 表4 PipelineTemplateSimpleVO 参数 参数类型 描述 id String 模板ID name String 模板名称 icon String 模板图标 manifest_version String 版本 language String 模板语言 description String 模板描述 is_system Boolean 是否系统模板 region String 模板局点 domain_id String 模板所属租户ID creator_id String 模板创建人ID creator_name String 模板创建人名称 updater_id String 模板更新人ID create_time Integer 创建时间 update_time Integer 更新时间 is_collect Boolean 是否收藏 is_show_source String 是否展示流水线源 stages Array of stages objects 模板编排stages 表5 stages 参数 参数类型 描述 name String 阶段名称 sequence Integer 阶段顺序 状态码： 400 表6 响应Body参数 参数 参数类型 描述 error_msg String 错误信息 error_code String 错误码

响应示例 状态码： 200 OK { "offset" : 0, "limit" : 3, "total" : 19, "templates" : [ { "id" : "e908740fe06e44a28f30c0f3c81b2ad5", "name" : "Serverless-maven编译部署", "icon" : "maven60", "manifest_version" : "3.0", "language" : "Java", "description" : "Serverless-maven编译构建、打包部署模板", "is_system" : true, "region" : "system", "domain_id" : "system", "creator_id" : "system", "creator_name" : "system", "updater_id" : "e908740fe06e44a28f30c0f3c81b2ad5", "create_time" : 1671172288000, "update_time" : 1677640980000, "is_collect" : true, "is_show_source" : null, "stages" : [ { "name" : "构建和检查", "sequence" : 0 }, { "name" : "部署和测试", "sequence" : 1 } ] }, { "id" : "ac3b3b9a6cb64ef6b732c8f8459ab578", "name" : "Node构建容器镜像", "icon" : "npm60", "manifest_version" : "3.0", "language" : "Node.js", "description" : "使用Node构建容器镜像，推送到SWR存储", "is_system" : true, "region" : "system", "domain_id" : "system", "creator_id" : "system", "creator_name" : "system", "updater_id" : "ac3b3b9a6cb64ef6b732c8f8459ab578", "create_time" : 1671172288000, "update_time" : 1677640980000, "is_collect" : true, "is_show_source" : null, "stages" : [ { "name" : "构建", "sequence" : 0 } ] }, { "id" : "8ea4d170ba0d45d9b1b647a9780ebcf8", "name" : "新手上路", "icon" : null, "manifest_version" : "3.0", "language" : "java", "description" : "流水线新手体验模板", "is_system" : true, "region" : "system", "domain_id" : "system", "creator_id" : "system", "creator_name" : "system", "updater_id" : "ac3b3b9a6cb64ef6b732c8f8459ab578", "create_time" : 1680769082000, "update_time" : 1680770243000, "is_collect" : false, "is_show_source" : null, "stages" : [ { "name" : "代码检查", "sequence" : 0 }, { "name" : "构建阶段", "sequence" : 1 }, { "name" : "部署发布", "sequence" : 2 } ] } ] }

请求参数 表2 请求Body参数 参数 是否必选 参数类型 描述 language 否 String 模板语言 is_system 否 Boolean 是否系统模板 name 否 String 模板名称 offset 否 Long 偏移量，表示从此偏移量开始查询，offset大于等于0，默认为0 limit 否 Long 每次查询的条目数量。 sort_key 否 String 用于排序的字段，非必选。取值为：name, create_time sort_dir 否 String 排序类型，非必选。asc按排序字段升序，desc按排序字段降序

请求示例 POST https://{endpoint}/v1/ce8df55870164338a72d7e828a966a2a/agent-plugin/publish-draft { "plugin_name" : "testteset", "display_name" : "testteset", "version" : "0.0.1", "plugin_attribution" : "custom" }

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。 通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 表3 请求Body参数 参数 是否必选 参数类型 描述 plugin_name 否 String 插件名 display_name 否 String 展示名 version 否 String 版本号 plugin_attribution 否 String 插件属性 version_attribution 否 String 版本属性

请求示例 获取流水线列表。 指定查询的项目ID为”e12ed176898d4841aa9881fe9b933c87”，创建人ID为”847a5317086c41798469d0868535943a”，并根据流水线名称降序排序。 POST https://{endpoint}/v3/pipelines/list { "pipeline_name" : "", "project_ids" : "e12ed176898d4841aa9881fe9b933c87", "creator_ids" : "847a5317086c41798469d0868535943a", "executor_ids" : "847a5317086c41798469d0868535943a", "status" : "waiting,running,verifying,handling,suspending,completed", "outcome" : "error,success,aborted", "sort_key" : "pipeline_name", "sort_dir" : "desc", "git_url" : "", "offset" : 4, "limit" : 10 }

响应示例 状态码： 200 OK { "offset" : 0, "limit" : 10, "total" : 88, "result" : [ { "project_id" : "e12ed176898d4841aa9881fe9b933c87", "project_name" : "Pipeline_Beta_自动测试", "pipeline_id" : "d33f98177c3e44f8841b005e1badcaed", "pipeline_name" : "马云多仓", "creator_id" : "847a5317086c41798469d0868535943a", "creator_name" : "大Beta测试账号", "executor_id" : "847a5317086c41798469d0868535943a", "executor_name" : "大Beta测试账号", "start_time" : "2022-09-08 17:08:02", "create_time" : "2022-07-28 17:02:11", "watched" : "true" }, { "project_id" : "e12ed176898d4841aa9881fe9b933c87", "project_name" : "Pipeline_Beta_自动测试", "pipeline_id" : "2ec08a45031c4d2896292a48b7fb1a30", "pipeline_name" : "门禁专用测试_勿删", "creator_id" : "847a5317086c41798469d0868535943a", "creator_name" : "大Beta测试账号", "executor_id" : "847a5317086c41798469d0868535943a", "executor_name" : "大Beta测试账号", "start_time" : "2022-09-08 16:52:03", "create_time" : "2020-10-29 17:05:02", "watched" : "true" } ] }

请求参数 表1 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token，通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 表2 请求Body参数 参数 是否必选 参数类型 描述 pipeline_name 否 String 流水线名字。查询时进行模糊匹配。 project_ids 否 String 项目id，有多个值时用逗号分隔，id个数取值[0,10]，非必选。如果该参数有值，则获取对应项目下的流水线列表；如果没有值，则获取用户有权限的所有项目的流水线列表 creator_ids 否 String 创建人id，有多个值时用逗号分隔，id个数取值[0,10]，非必选 executor_ids 否 String 执行人id。有多个值时用逗号分隔，id个数取值[0,10]，非必选 status 否 String 流水线运行状态.取值和含义:waiting:等待;running:执行中;verifying:待审核;suspending:挂起;completed:完成 outcome 否 String 流水线执行结果。取值及含义：success：成功；error：失败；aborted：终止 sort_key 否 String 用于排序的字段。取值为：pipeline_name,create_time,start_time sort_dir 否 String 排序方式。asc按排序字段升序，desc按排序字段降序 git_url 否 String 代码仓地址。仅支持codehub仓库，如：git@codehub.XXX.git offset 否 Integer 偏移量。表示从此偏移量开始查询，offset大于等于0，默认取值为0 limit 否 Integer 每次查询的条目数量。取值[10-50]，默认取值为10

响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 offset Integer 偏移量,表示从此偏移量开始查询,offset大于等于0 limit Integer 每次查询的条目数量 total Integer 总条目数量 result Array of PipelineBasicInfo objects 流水线列表 表4 PipelineBasicInfo 参数 参数类型 描述 project_id String 项目id project_name String 项目名称 pipeline_id String 流水线id pipeline_name String 流水线名称 creator_id String 流水线创建人id creator_name String 流水线创建人名字 executor_id String 流水线执行人id executor_name String 流水线执行人名字 start_time String 启动时间 create_time String 创建时间 watched String 用户是否关注流水线：true（关注），false（未关注） 状态码： 400 表5 响应Body参数 参数 参数类型 描述 error_msg String 错误信息 error_code String 错误码

响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 [数组元素] Array of PipelineGroupVo objects OK 表4 PipelineGroupVo 参数 参数类型 描述 id String 分组ID domain_id String 租户ID project_id String 项目ID name String 分组名 parent_id String 父分组ID path_id String 分组路径ID ordinal Integer 序号 creator String 创建用户ID updater String 更新用户ID create_time Long 创建时间 update_time Long 更新时间 children Array of PipelineGroupVo objects 子分组列表 状态码： 400 表5 响应Body参数 参数 参数类型 描述 error_msg String 错误信息 error_code String 错误码

响应示例 状态码： 200 OK [ { "id" : "894daf0db79c4ccb839490770fa06596", "domain_id" : "ce8df55870164338a72d7e828a966a2a", "project_id" : "d80a8a6530324b7bac972cbb8a9f28ec", "name" : "新建分组22", "parent_id" : "", "path_id" : "894daf0db79c4ccb839490770fa06596", "ordinal" : 2, "creator" : "847a5317086c41798469d0868535943a", "updater" : null, "create_time" : 1698487536000, "update_time" : null, "children" : null }, { "id" : "2ca78947b25847a9ab68a07d8ef1347b", "domain_id" : "ce8df55870164338a72d7e828a966a2a", "project_id" : "d80a8a6530324b7bac972cbb8a9f28ec", "name" : "新建分组11", "parent_id" : "", "path_id" : "2ca78947b25847a9ab68a07d8ef1347b", "ordinal" : 1, "creator" : "847a5317086c41798469d0868535943a", "updater" : null, "create_time" : 1698487008000, "update_time" : null, "children" : null }, { "id" : "58d55f8a646443a984e7399632b3963e", "domain_id" : "ce8df55870164338a72d7e828a966a2a", "project_id" : "d80a8a6530324b7bac972cbb8a9f28ec", "name" : "G2", "parent_id" : "", "path_id" : "58d55f8a646443a984e7399632b3963e", "ordinal" : 0, "creator" : "847a5317086c41798469d0868535943a", "updater" : "847a5317086c41798469d0868535943a", "create_time" : 1698484566000, "update_time" : 1698485674000, "children" : [ { "id" : "d805c90bf99049d3a49e83d2024df6b8", "domain_id" : "ce8df55870164338a72d7e828a966a2a", "project_id" : "d80a8a6530324b7bac972cbb8a9f28ec", "name" : "新建分组3", "parent_id" : "58d55f8a646443a984e7399632b3963e", "path_id" : "58d55f8a646443a984e7399632b3963e.d805c90bf99049d3a49e83d2024df6b8", "ordinal" : 1, "creator" : "847a5317086c41798469d0868535943a", "updater" : "847a5317086c41798469d0868535943a", "create_time" : 1698487527000, "update_time" : 1698487868000, "children" : null }, { "id" : "ebb779b3b9f742e181b1f6829fa1aca0", "domain_id" : "ce8df55870164338a72d7e828a966a2a", "project_id" : "d80a8a6530324b7bac972cbb8a9f28ec", "name" : "新建分组", "parent_id" : "58d55f8a646443a984e7399632b3963e", "path_id" : "58d55f8a646443a984e7399632b3963e.ebb779b3b9f742e181b1f6829fa1aca0", "ordinal" : 0, "creator" : "847a5317086c41798469d0868535943a", "updater" : null, "create_time" : 1698485344000, "update_time" : null, "children" : [ { "id" : "1b80aa3df0984e9caffefdc4e557524e", "domain_id" : "ce8df55870164338a72d7e828a966a2a", "project_id" : "d80a8a6530324b7bac972cbb8a9f28ec", "name" : "新建分组4", "parent_id" : "ebb779b3b9f742e181b1f6829fa1aca0", "path_id" : "58d55f8a646443a984e7399632b3963e.ebb779b3b9f742e181b1f6829fa1aca0.1b80aa3df0984e9caffefdc4e557524e", "ordinal" : 2, "creator" : "847a5317086c41798469d0868535943a", "updater" : null, "create_time" : 1698487502000, "update_time" : null, "children" : null }, { "id" : "6bc8a3cda52c41fe84d71c9ff86161ea", "domain_id" : "ce8df55870164338a72d7e828a966a2a", "project_id" : "d80a8a6530324b7bac972cbb8a9f28ec", "name" : "新建分组3", "parent_id" : "ebb779b3b9f742e181b1f6829fa1aca0", "path_id" : "58d55f8a646443a984e7399632b3963e.ebb779b3b9f742e181b1f6829fa1aca0.6bc8a3cda52c41fe84d71c9ff86161ea", "ordinal" : 1, "creator" : "847a5317086c41798469d0868535943a", "updater" : null, "create_time" : 1698486710000, "update_time" : null, "children" : null } ] } ] } ]

响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 id String 策略ID name String 策略名称 level String 策略级别 parent_id String 父策略ID version String 策略版本 is_valid Boolean 是否启用 is_public Boolean 是否系统级策略 creator String 创建人 create_time String 创建时间 updater String 更新人 update_time String 更新时间 content OpenSourceRuleContent object 策略规则详情 表4 OpenSourceRuleContent 参数 参数类型 描述 version_set VersionSetProperty object 开源依赖 security SecurityProperty object 漏洞 license LicenseProperty object 许可证 表5 VersionSetProperty 参数 参数类型 描述 enable Boolean 是否启用 rules Array of VersionSetRule objects 规则列表 表6 VersionSetRule 参数 参数类型 描述 enable Boolean 是否开启 ecosystem String 依赖类型 package_name String 包名称 package_version String 包版本 description String 规则说明 predicate String 比较规则 表7 SecurityProperty 参数 参数类型 描述 enable Boolean 是否启用 rules SecurityRule object 规则详情 表8 SecurityRule 参数 参数类型 描述 severity severity object 漏洞级别 cve cve object 漏洞编号 表9 severity 参数 参数类型 描述 enable Boolean 是否启用 values Array of strings 漏洞等级 表10 cve 参数 参数类型 描述 enable Boolean 是否启用 values Array of strings 漏洞编号 表11 LicenseProperty 参数 参数类型 描述 enable Boolean 是否开启 rules Array of rules objects 规则列表 表12 rules 参数 参数类型 描述 values Array of strings license详情 predicate String 比较规则 状态码： 400 表13 响应Body参数 参数 参数类型 描述 error_msg String 错误信息 error_code String 错误码

响应示例 状态码： 200 OK { "id" : "60eab9fd2b144f619a3563b2e0036a61", "name" : "创建开源治理策略-20231020154413", "level" : "project", "version" : "a108f6b1effb4b03a9505288f8801e65", "is_valid" : true, "is_public" : false, "creator" : "847a5317086c41798469d0868535943a", "create_time" : "2023-10-20T15:44:41", "updater" : "847a5317086c41798469d0868535943a", "update_time" : "2023-10-20T15:44:41", "content" : { "version_set" : { "enable" : true, "rules" : [ { "enable" : true, "ecosystem" : "Maven", "package_name" : "springboot", "package_version" : "2.5", "description" : "", "predicate" : "eq" } ] }, "security" : { "enable" : true, "rules" : { "severity" : { "enable" : true, "values" : [ "Critical", "High", "Medium" ] }, "cve" : { "enable" : false, "values" : [ "" ] } } }, "license" : { "enable" : true, "rules" : [ { "predicate" : "contain", "values" : [ ] } ] } } }

约束与限制 按需计费云数据库绑定的资源（弹性公网IP）可能不支持随实例同步变更计费模式，请参考表1查看绑定资源的计费规则及处理措施。 表1 弹性公网IP计费模式变更规则 资源 计费模式 计费方式 带宽类型 是否支持随GeminiDB Mongo按需转包年/包月 处理措施 弹性公网IP 按需计费 按带宽计费 独享带宽 是 在控制台的弹性公网IP页面进行按需转包年/包月操作。 详细内容，请参见变更弹性公网IP计费方式。 弹性公网IP 按需计费 按流量计费 独享带宽 否 按需、按流量计费EIP不支持直接转为包年/包月EIP。变更方法如下： 先转为按需、按带宽计费的EIP。 再由按需、按带宽计费EIP转为包年/包月EIP。 详细内容，请参见变更弹性公网IP计费方式。

自动备份策略 系统按照自动备份策略，对数据库进行自动备份，备份将以压缩包的形式存储在对象存储服务中，以保证用户数据的机密性和持久性。建议您定期对数据库进行备份，当数据库故障或数据损坏时，可以通过备份恢复数据库。由于开启备份会损耗数据库读写性能，建议您选择业务低峰时间段启动自动备份。 创建数据库实例时，系统默认开启自动备份策略，默认开启的自动备份策略设置如下： 图1 开启备份策略 保留天数：自动备份可保留天数默认为7天。可设置保留天数范围为1~35天。新的全量备份未超过保留天数前系统会一直保留，直至新的全量备份超过保留天数后才会删除。 增加保留天数，可提升数据可靠性，请根据需要设置。 减少保留天数，会针对已有的备份文件生效，即超出备份保留天数的已有备份文件（包括全量备份和增量备份）会被自动删除，但手动备份不会自动删除，请您谨慎选择。 保留天数小于7天，系统每天都会进行自动备份。 系统会自动检测已有的自动备份文件，若备份文件超过用户自定义的数据保留天数，则将其删除。 备份时间段：默认为24小时中，间隔一小时的随机的一个时间段，例如04:00～05:00。备份时间段以GMT时区保存。如果碰到夏令时或冬令时切换，备份时间段会因时区变化而改变。 假如保留天数设置为“2”，表示超过两天的全量备份和增量备份会被自动删除。即周一产生的备份会在周三删除，同理，周二产生的备份会在周四删除。 全量备份文件自动删除策略： 已有备份文件超出备份天数后会自动删除，考虑到数据完整性，自动删除时仍然会保留最近的一次超过保留天数的全量备份，保证在保留天数内的数据可正常恢复。 假如备份周期选择“周一”、“周二”，保留天数设置为“2”，备份文件的删除策略如下： 本周一产生的全量备份，会在本周四当天自动删除。原因如下： 本周二的全量备份在本周四当天超过保留天数，按照全量备份文件自动删除策略，会保留最近的一个超过保留天数的全量备份（即本周二的备份会被保留），因此周四当天删除本周一产生的全量备份文件。 本周二产生的全量备份，会在下周三当天自动删除。原因如下： 下周一产生的全量备份在下周三超过保留天数，按照全量备份文件自动删除策略，会保留最近的一个超过保留天数的全量备份（即下周一的备份会被保留），因此下周三当天删除本周二产生的全量备份。 备份周期：默认为全选。 全选：选择一周内的每一天。系统每天都会进行自动备份。 选择周期：选择一周内的一天或几天。系统会在所选时间进行自动备份。 备份周期对应的备份开始时间1小时内，系统会自动触发全量备份。备份所需时间由备份数据量决定，备份数据量越大，备份所需时间越长。 实例创建成功后，您可根据业务需要设置自动备份策略。系统将按照您设置的自动备份策略对数据库进行备份。 关闭自动备份策略后，自动备份将会立即停止。

约束与限制 包年/包月的云数据库绑定的资源（弹性公网IP）可能不支持随云数据库同步变更计费模式，请参考表1查看绑定资源的计费规则及处理措施。 表1 弹性公网IP计费模式变更规则 资源 计费模式 计费方式 带宽类型 是否支持随GeminiDB Mongo包年/包月转按需 处理措施 弹性公网IP 包年/包月 按带宽计费 独享带宽 否 在控制台的弹性公网IP页面进行按需转包年/包月操作。 详细内容，请参见变更弹性公网IP计费方式。 弹性公网IP 包年/包月 按流量计费 独享带宽 否 包年/包月EIP不支持直接转为按需、按流量计费EIP。变更方法如下： 先转为按需、按带宽计费EIP。 再由按需、按带宽计费EIP转为按需、按流量计费EIP。 详细内容，请参见变更弹性公网IP计费方式。

操作场景 标签管理服务（Tag Management Service，简称TMS）用于用户在云平台，通过统一的标签管理各种资源。标签管理服务与各服务共同实现标签管理能力，标签管理服务提供全局标签管理能力，各服务维护自身标签管理 。 为GeminiDB Mongo实例添加标签，可以方便用户识别和管理拥有的GeminiDB Mongo资源。您可以在创建实例时添加标签，也可以在实例创建完成后，在实例详情页添加标签。 标签添加成功后，您可以通过搜索标签键或值，快速查询关联的资源信息。

使用须知 建议您先在标签管理服务系统中设置预定义标签。 标签由“键”和“值”组成，每个标签中的一个“键”只能对应一个“值”。关于标签键和标签值的命名规则，请参见表1。 每个实例默认最多支持10个标签配额，如果您需要使用更多标签，可以联系客服申请至20个标签配额。 标签命名需要满足表1规则。 表1 命名规则 参数 规则 示例 标签键 不能为空。 对于每个实例，每个标签的键唯一。 长度不超过36个字符。 只能包含数字、英文字母、下划线、中划线和中文。 Organization 标签值 可以为空。 长度不超过43个字符。 只能包含数字、英文字母、下划线、点、中划线和中文。 nosql_01

在费用中心续费 登录管理控制台。 单击“控制台”页面上方“费用与成本”，在下拉菜单中选择“续费管理”。 进入“续费管理”页面。 自定义查询条件。 可在“手动续费项”、“自动续费项”、“到期转按需项”、“到期不续费项”页签查询全部待续费资源，对资源进行手动续费的操作。 图3 续费管理 所有需手动续费的资源都可归置到“手动续费项”页签，具体操作请参见如何恢复为手动续费。 手动续费资源。 单个续费：在资源页面找到需要续费的资源，单击操作列的“续费”。 图4 单个续费 批量续费：在资源页面勾选需要续费的资源，单击列表左上角的“批量续费”。 图5 批量续费 选择续费时长，判断是否勾选“统一到期日”，将到期时间统一到各个月的某一天（详细介绍请参见统一包年/包月资源的到期日）。确认配置费用后单击“去支付”。 图6 续费确认 进入支付页面，选择支付方式，确认付款，支付订单后即可完成续费。

使用须知 SSL连接需要具有一定的操作权限，如需使用，请联系客服申请相应的权限。 开启或关闭SSL会导致实例重启，请谨慎操作。 开启SSL后，可以通过SSL方式连接数据库，具有更高的安全性。 出于安全原因，不安全的加密算法已被禁用。GeminiDB Mongo支持的安全加密算法对应的加密套件如表1所示。 表1 安全加密算法对应的加密套件说明 版本 支持的TLS版本 支持的加密算法套件 4.0 TLS 1.2 DHE-RSA-AES256-GCM-SHA384 DHE-RSA-AES128-GCM-SHA256 用户的客户端所在服务器需要支持对应的TLS版本以及对应的加密算法套件，否则会连接失败。 关闭SSL，可以采用非SSL方式连接数据库。

操作场景 SSL（Secure Socket Layer，安全套接层），位于可靠的面向连接的网络层协议和应用层协议之间的一种协议层。SSL通过互相认证、使用数字签名确保完整性、使用加密确保私密性，以实现客户端和服务器之间的安全通讯。 认证用户和服务器，确保数据发送到正确的客户端和服务器。 加密数据以防止数据中途被窃取。 维护数据的完整性，确保数据在传输过程中不被改变。 SSL连接开启后，可以通过SSL方式连接实例，提高数据安全性。

使用须知 默认情况下，一个租户可以创建500条安全组规则。 为一个安全组设置过多的安全组规则会增加首包延时，因此，建议一个安全组内的安全组规则不超过50条。 目前一个GeminiDB Mongo实例仅允许绑定一个安全组。 内网和公网连接实例时，需要配置的安全组规则请参见表1。 表1 安全组规则说明 场景 配置的安全组规则说明 内网连接实例 使用内网连接GeminiDB Mongo实例时，设置安全组规则分为以下两种情况： ECS与GeminiDB Mongo实例在相同安全组时，默认ECS与GeminiDB Mongo实例互通，无需设置安全组规则。 ECS与GeminiDB Mongo实例在不同安全组时，需要为GeminiDB Mongo和ECS分别设置安全组规则。 设置GeminiDB Mongo安全组规则：为GeminiDB Mongo所在安全组配置相应的入方向规则，具体操作请参见操作步骤。 设置ECS安全组规则：安全组默认规则为出方向上数据报文全部放行，此时，无需对ECS配置安全组规则。当在ECS所在安全组为非默认安全组且出方向规则非全放通时，需要为ECS所在安全组配置相应的出方向规则。具体操作请参见《弹性云服务器用户指南》中“设置安全组规则”章节。 公网连接实例 使用公网连接GeminiDB Mongo实例时，需要为GeminiDB Mongo所在安全组配置相应的入方向规则。具体操作请参见操作步骤。

前提条件 已创建CCM私有证书。若未创建CCM私有证书，请参见《云证书管理服务用户指南》中“申请私有证书”章节先创建证书。 创建证书时需要将待连接的数据库IP信息添加到证书中，即“配置证书的AltName信息”。若不配置该信息，则会导致数据库连接失败。 若您在创建实例时选择证书功能，此处“证书的AltName信息”只能添加弹性公网IP，因为此时待连接的数据库实例尚未创建成功，无对应的内网IP地址生成，故无法将内网IP地址添加到证书的AltName信息处。 若您是在创建实例成功后，使用重置证书的功能来切换证书信息，此处“证书的AltName信息”可以添加数据库实例所有节点的内网IP地址或者弹性公网IP地址。 图1 创建CCM私有证书 其余参数配置，请参见《云证书管理服务用户指南》中“申请私有证书”章节进行设置。