华为云用户手册

为已有用户组授权 给用户组授权 选择已有用户组，并授予ROMA Connect服务只读权限“ROMA ReadOnlyAccess”。 用户登录并验证权限 使用1中用户组下的用户登录控制台，切换至授权区域，验证权限： 在“服务列表”中选择应用与数据集成平台，进入ROMA Connect主界面，单击右上角“购买ROMA Connect实例”，尝试购买ROMA Connect实例，如果无法购买ROMA Connect实例，表示“ROMA ReadOnlyAccess”已生效。

脚本配置示例 { "breaker_condition":{ "breaker_type":"timeout", "breaker_mode":"counter", "unhealthy_threshold":30, "time_window":15, "open_breaker_time":15, "unhealthy_percentage":51, "min_call_threshold":20 }, "scope":"share", "downgrade_default":{ "type":"http", "passthrough_infos":null, "func_info":null, "mock_info":null, "http_info":{ "isVpc":false, "vpc_channel_id":"", "address":"10.10.10.10", "scheme":"HTTP", "method":"GET", "path":"/demo", "timeout":5000 }, "http_vpc_info":null }, "downgrade_parameters":[ { "name":"reqPath", "type":"path", "value":"path", "disabled":true, "focused":true, "id":"92002eqbpilg6g" }, { "name":"method", "type":"method", "value":"method", "disabled":true, "focused":true, "id":"tuvxetsdqvcos8" }], "downgrade_rules":[ { "rule_name":"rule-test1", "parameters":[ "reqPath", "method" ], "match_regex":"[\"reqPath\",\"==\",\"/test\"]", "downgrade_backend":{ "type":"mock", "passthrough_infos":null, "func_info":null, "mock_info":{ "status_code":200, "result_content":"{status: ok}", "headers":[] }, "http_info":null, "http_vpc_info":null }, "breaker_condition":{ "breaker_type":"timeout", "breaker_mode":"percentage", "unhealthy_threshold":30, "time_window":15, "open_breaker_time":15, "unhealthy_percentage":51, "min_call_threshold":20 } }] }

创建CodeArts Build连接 登录新版ROMA Connect控制台。 在左侧导航栏选择“连接器”，在连接器页面单击“新建连接”。 选择“CodeArts Build”连接器。 在弹窗中配置连接器信息，完成后单击“确定”。 参数 说明 连接名称 填写连接器实例名称。 描述 填写连接器的描述信息，用于识别不同的连接器。 Access Key 当前账号的AK（Access Key ID）。请参考访问密钥获取AK，如果已生成过AK/SK，找到原来已下载的AK/SK文件，文件名一般为：credentials.csv。 Secret Access Key 当前账号的SK（Secret Access Key）。请参考访问密钥获取SK，如果已生成过AK/SK，找到原来已下载的AK/SK文件，文件名一般为credentials.csv。

配置参数 表1 查询指定代码仓库最近一次成功的构建历史 参数 说明 project_id 项目ID。 region_id 区域ID。 repository_name 代码仓库名，不支持中文。 表2 获取构建历史详情信息接口 参数 说明 job_id 构建的任务ID。编辑构建任务时，浏览器URL末尾的32位数字、字母组合的字符串。 build_number 构建任务的构建编号，从1开始，每次构建递增1。 region_id 区域ID。 表3 执行构建任务 参数 说明 region_id 区域ID。 body 输入请求体内容。 表4 根据开始时间和结束时间查看构建任务的构建成功率 参数 说明 job_id 构建的任务ID。编辑构建任务时，浏览器URL末尾的32位数字、字母组合的字符串。 region_id 区域ID。 start_time 区间开始时间，格式yyyy-MM-dd。 end_time 区间结束时间，格式yyyy-MM-dd。 表5 查看任务运行状态 参数 说明 job_id 构建的任务ID。编辑构建任务时，浏览器URL末尾的32位数字、字母组合的字符串。 region_id 区域ID。 表6 查看项目下用户的构建任务列表 参数 说明 project_id 项目ID。 region_id 区域ID。 page_index 分页页码， 表示从此页开始查询， page_index大于等于0。 page_size 每页显示的条目数量，page_size小于等于100。 表7 KeyStore文件下载 参数 说明 region_id 区域ID。 file_name 下载的文件名称。 domain_id 租户ID。32位数字、小写字母组合。 表8 根据开始时间和结束时间查看构建任务的构建历史列表 参数 说明 job_id 构建的任务ID。编辑构建任务时，浏览器URL末尾的32位数字、字母组合的字符串。 region_id 区域ID。 offset 分页页码， 表示从此页开始查询， offset大于等于0。 limit 每页显示的条目数量，limit小于等于100。 start_time 区间开始时间，格式yyyy-MM-dd。开始时间和结束时间间隔不能超过30天。 end_time 区间结束时间，格式yyyy-MM-dd。开始时间和结束时间间隔不能超过30天。 表9 查看构建任务的构建历史列表 参数 说明 job_id 构建的任务ID。编辑构建任务时，浏览器URL末尾的32位数字、字母组合的字符串。 region_id 区域ID。 offset 分页页码， 表示从此页开始查询， offset大于等于0。 limit 每页显示的条目数量，limit小于等于100。 interval 距今天的时间区间（单位：天），interval小于等于30。

创建短信服务连接 登录新版ROMA Connect控制台。 在左侧导航栏选择“连接器”，在连接器页面单击“新建连接”。 选择“短信服务”连接器。 在弹窗中配置连接器信息，完成后单击“确定”。 参数 说明 连接名称 填写连接器实例名称。 App Key 接入密钥。创建消息&短信应用时，平台会自动生成APP_Key和APP_Secret，用于调用短信API时的鉴权。 App Secret 接入密钥。创建消息&短信应用时，平台会自动生成APP_Key和APP_Secret，用于调用短信API时的鉴权。 描述 填写连接器的描述信息，用于识别不同的连接器。

支持的动作 查询迭代下工作项状态的统计数据（处理人维度） 查询项目的状态列表 更新项目的领域 查询项目的领域列表 删除项目的模块 取消领域与项目的关联关系 查询项目的模块列表 创建项目的领域 查看迭代历史记录 查询关联用例 查询当前工作项已经关联的代码提交记录 / 分支创建记录 查询当前工作项已经关联的关联Wiki 查询当前工作项已经关联的工作项 查询Scrum项目的工作项流转配置 获取项目概览 获取需求统计信息 查询项目下所有工作项的历史记录 获取bug统计信息 更新工作项 按用户查询工时（多项目） 批量删除工作项 删除工作项 获取工作项历史记录 创建工作项 查询项目的工作项 高级查询工作项 查询工作项详情 获取子工作项 按用户查询工时（单项目） 获取当前用户信息 查看迭代详情 获取指定项目的迭代列表 创建项目 更新Scrum项目迭代 删除项目迭代 批量删除项目的迭代 创建Scrum项目迭代 检查项目名称是否存在 获取指定工作项的评论列表 获取工作项完成率 获取指定项目的成员用户列表 添加项目成员 查询项目列表 查询缺陷密度 查询Scrum工作项自定义字段 细粒度权限用户创建工作项 查询人均bug 创建项目的模块 更新项目的模块 更新成员在项目中的角色 批量添加项目成员 批量删除项目成员 查询需求按时完成率 获取项目详情 更新项目 删除项目

创建CodeArts Req连接 登录新版ROMA Connect控制台。 在左侧导航栏选择“连接器”，在连接器页面单击“新建连接”。 选择“CodeArts Req”连接器。 在弹窗中配置连接器信息，完成后单击“确定”。 参数 说明 连接名称 填写连接器实例名称。 描述 填写连接器的描述信息，用于识别不同的连接器。 Access Key 当前账号的AK（Access Key ID）。请参考访问密钥获取AK，如果已生成过AK/SK，找到原来已下载的AK/SK文件，文件名一般为：credentials.csv。 Secret Access Key 当前账号的SK（Secret Access Key）。请参考访问密钥获取SK，如果已生成过AK/SK，找到原来已下载的AK/SK文件，文件名一般为credentials.csv。

支持的动作 实时计算单个自定义报表 查询某个测试计划下的需求树 查询某测试计划下的操作历史 获取环境参数分组列表 通过导入仓库中的文件生成接口测试套 计划中批量添加测试用例 项目下查询测试计划列表v2 项目下创建计划 项目下查询测试计划列表 通过用例编号获取测试用例详情 批量更新测试用例结果 批量执行测试用例 更新自定义测试服务类型用例 获取测试用例详情 批量删除自定义测试服务类型用例 创建自定义测试服务类型用例 删除已注册服务 更新已注册服务 新测试类型服务注册 用户获取自己当前已经注册的服务

配置参数 表1 实时计算单个自定义报表 参数 说明 project_id 项目ID。 plan_id 分支/计划ID。 region_id 区域ID。 name 报表名称。 workpiece_type 工件类型（用例：case，测试套：suite）。 analysis_dim_row 分析维度。 compare_dim_column 对比维度。 creatorIds 创建人。 ownerIds 所属人。 ranks 级别。 releaseIds releaseId。 status 状态。 moduleIds 级别。 results 结果。 labelIds 标签。 startTime 开始时间。 endTime 结束时间。 isAssociateIssue 是否关联需求。 表2 查询某个测试计划下的需求树 参数 说明 project_id 项目ID。 plan_id 测试计划ID。 region_id 区域ID。 offset 起始偏移量。 limit 每页显示条目数量，最大支持200条。 表3 查询某测试计划下的操作历史 参数 说明 project_id 项目ID。 plan_id 测试计划ID。 region_id 区域ID。 offset 起始偏移量。 limit 每页显示的条目数量，最大支持200条。 表4 获取环境参数分组列表 参数 说明 project_id 项目ID。 region_id 区域ID。 offset 起始偏移量。 limit 每页显示的条目数量，最大支持200条。 表5 通过导入仓库中的文件生成接口测试套 参数 说明 project_id 项目ID。 region_id 区域ID。 testsuite_name 要生成的测试套名称。 repository_id 仓库ID。 repository_branch 仓库分支。 file_path 仓库中yaml或json文件的相对路径，仅支持swagger 2.0版本的yaml和json文件。 表6 计划中批量添加测试用例 参数 说明 project_id 项目ID。 plan_id 计划ID。 region_id 区域ID。 service_id 注册测试类型服务接口返回的服务ID。 testcase_id_list 计划下包含的用例个数，数组长度小于50个，只能包含一种测试类型。 表7 项目下查询测试计划列表v2 参数 说明 project_id 项目ID。 region_id 区域ID。 offset 起始偏移量。 limit 每页显示的条目数量，最大支持200条。 name 针对测试计划名称模糊查询。 current_stage 测试计划所处截断（create,design,execute,report）。 表8 项目下创建计划 参数 说明 project_id 项目ID。 region_id 区域ID。 name 计划名称。 assigned_id 处理者ID。 service_id_list 计划下包含的用例类型，数组长度小于10。 start_date 计划开始时间，要求用UTC时间表示，如2020-03-04。 end_date 计划结束时间，要求用UTC时间表示，如2020-03-04。 表9 项目下查询测试计划列表 参数 说明 project_id 项目ID。 region_id 区域ID。 name 针对测试计划名称模糊查询使用。 current_stage 测试计划所处截断（create,design,execute,report）。 offset 页号，取值范围1-20000。 limit 每页显示条目数量，取值范围1-200。 表10 通过用例编号获取测试用例详情 参数 说明 project_id 项目ID。 region_id 区域ID。 testcase_number 用例编号。 表11 批量更新测试用例结果 参数 说明 project_id 项目ID。 region_id 区域ID。 service_id 注册测试类型服务接口返回的服务ID。 testcase_id 测试用例ID。 execute_id 注册服务执行ID。 result_id 测试用例结果，（0-成功，1-失败，5-执行中，6-停止）。 end_time 用例结束执行的时间戳，在执行结束时该字段必填。 duration 执行用例持续时长ms，更新状态时该字段必传。 description 用于记录该次结果执行的备注信息。 表12 批量执行测试用例 参数 说明 project_id 项目ID。 region_id 区域ID。 service_id 注册测试类型服务接口返回的服务ID。 plan_id 测试计划ID testcase_id 测试用例ID execute_id 注册服务执行ID。 result_id 测试用例结果（0-成功，1-失败，5-执行中，6-停止）。 start_time 用例开始执行的时间戳，在执行开始时该字段必填。 表13 更新自定义测试服务类型用例 参数 说明 project_id 项目ID。 testcase_id 测试用例ID。 region_id 区域ID。 name 页面上显示的用例名称。 service_id 注册测试类型服务接口返回的服务ID。 rank_id 测试用例等级，可选值为[0，1，2，3，4]，不填默认为2。 testcase_number 用例编号，不填时自动生成。 description 测试用例描述信息。 preparation 执行该测试用例时需要满足的前置条件。 expect_result 测试用例预期结果信息。 test_step 测试步骤描述信息。 label_list 标签名称列表。 module_id 模块号。 test_version_id 测试版本号。 fix_version_id 迭代号。 assigned_id 处理者ID信息。 issue_id 用例关联的需求ID信息。 status_id 测试用例状态信息（0-新建，5-设计中，6-测试中，7-完成）。 defect_id_list 缺陷ID信息。 表14 获取测试用例详情 参数 说明 project_id 项目ID。 testcase_id 测试用例ID。 region_id 区域ID。 表15 批量删除自定义测试服务类型用例 参数 说明 project_id 项目ID。 region_id 区域ID。 service_id 注册测试类型服务接口返回的服务ID。 test_case_id_list 测试用例ID。 表16 创建自定义测试服务类型用例 参数 说明 project_id 项目ID。 region_id 区域ID。 name 页面上显示的用例名称。 service_id 该值由注册接口返回。 rank_id 测试用例等级，可选值为[0，1，2，3，4]，不填默认为2。 testcase_number 用例编号，不填时自动生成。 description 测试用例描述信息。 preparation 执行该测试用例时需要满足的前置条件。 expect_result 测试用例预期结果信息。 test_step 测试步骤描述信息。 label_list 标签名称列表。 module_id 模块号。 test_version_id 测试版本号。 fix_version_id 迭代号。 assigned_id 处理者ID信息。 issue_id 用例关联的需求ID信息。 表17 删除已注册服务 参数 说明 service_id 注册服务ID，该值由注册接口返回。 region_id 区域ID。 表18 更新已注册服务 参数 说明 service_id 注册服务ID，该值由注册接口返回。 region_id 区域ID。 service_name 测试类型名称，用于界面显示，不能使用当前保留名。 server_host 域名，服务会通过此域名进行接口调用，以https/http开头，长度小于等于128位字符。TestHub将会通过此域名下的接口，保证服务数据与客户系统数据的一致性。 表19 新测试类型服务注册 参数 说明 region_id 区域ID。 service_name 测试类型名称，用于界面显示，不能使用当前保留名。 server_host 域名，服务会通过此域名进行接口调用，以https/http开头，长度小于等于128位字符。TestHub将会通过此域名下的接口，保证服务数据与客户系统数据的一致性。 表20 用户获取自己当前已经注册的服务 参数 说明 region_id 区域ID。

创建CodeArts TestPlan连接 登录新版ROMA Connect控制台。 在左侧导航栏选择“连接器”，在连接器页面单击“新建连接”。 选择“CodeArts TestPlan”连接器。 在弹窗中配置连接器信息，完成后单击“确定”。 参数 说明 连接名称 填写连接器实例名称。 描述 填写连接器的描述信息，用于识别不同的连接器。 Access Key 当前账号的AK（Access Key ID）。请参考访问密钥获取AK，如果已生成过AK/SK，找到原来已下载的AK/SK文件，文件名一般为：credentials.csv。 Secret Access Key 当前账号的SK（Secret Access Key）。请参考访问密钥获取SK，如果已生成过AK/SK，找到原来已下载的AK/SK文件，文件名一般为credentials.csv。

配置参数 以下配置等价于使用命令ZADD key score member，可以向有序集合中添加元素，其中key是有序集合的名称，score是元素的分数，member是元素的成员值，含义为向有序集合myset中添加元素“apple”，其分数为3。 参数 说明 有序集合 zadd zrem zcard zrangebyscore/zrevrangebyscore zrange/zrevrange 键：有序集合的名称。 值：元素的成员值。 分数：元素的分数。 起始索引：分数最小值。 终止索引：分数最大值。 集合 srem sismember srandmember spop sadd 键：集合的名称。 值：元素的成员值。 哈希 hdel hlen hset/hsetnx hincrby hget hgetall 键：哈希的名称。 字段名：哈希中key的值。 值：哈希中key对应的value值。 键存在时不做操作：否对应zset操作，是对应zsetnx操作。 增量值：将哈希中的某个数值型字段增加一个指定的值。 列表 lrange lpop/rpop lpush/rpush lrem llen lindex leset 表名：数据库中数据表的名字。 插入数据：插入操作中目标记录各个字段的值。 字符串 set/setnx append setbit get incrby decrby getrange strlen 键：字符串的名称。 值：字符串的值。 过期时间（秒）：字符串的过期时间。 键存在时不做操作：否使用set命令， 是使用setnx命令。 键 del lrem expire expireat ttl persist 键：key的名称。

创建Redis连接 登录新版ROMA Connect控制台。 在左侧导航栏选择“连接器”，在连接器页面单击“新建连接”。 选择“Redis”连接器。 在弹窗中配置连接器信息，完成后单击“确定”。 参数 说明 连接名称 填写连接器实例名称。 主机IP地址 填写数据库的连接IP地址。 端口 填写数据库的连接端口号。 数据库 填写要连接的数据库名。 密码 连接数据库的密码。 描述 填写连接器的描述信息，用于识别不同的连接器。

支持的操作 获取分支目录下的文件；获取仓库统计数据；修改被流水线引用的仓库状态；判断用户是否有仓库的管理员权限；设置仓库是公开状态还是私有状态；获取一个项目下可以设置为公开状态的仓库列表；获取公开示例模板列表；获取项目下所有仓库信息；校验指定项目下的仓库名；创建仓库；根据仓库名组名获取仓库短id，用以拼接与commitid对应提交详情页面url；根据组名和仓库名查询某仓库某分支对应的提交；查询指定仓库的webhook；为指定仓库添加hook；删除指定仓库的 hook；查询某仓库对应的分支；根据仓库id查询仓库某分支对应的提交，提供更多可选参数；添加部署密钥；删除仓库部署密钥；获取仓库上一次的提交统计信息；仓库统计；查询项目下的某个仓库；删除仓库；获取仓库所有成员记录；添加仓库成员；设置成员在仓库中的角色；删除仓库成员；查看仓库的创建状态；https账号密码校验；获取ssh key列表；添加ssh key；检验私钥是否有拉取代码的权限；删除用户公钥；查询用户的所有仓库；创建项目、仓库；创建项目并fork仓库；查询项目下的所有仓库；查询某仓库的标签列表；新建标签；查询某个仓库的详细信息；查询某个仓库的提交信息；创建提交；查询某个仓库的特定提交信息；查询某个仓库的提交差异信息；查询某个仓库的文件信息；获取代码提交行数；下载仓库；新建保护分支；获取仓库分支列表；分支关联工作项；获取仓库合并请求列表；获取仓库合并请求详情。

创建CodeArts Repo连接 登录新版ROMA Connect控制台。 在左侧导航栏选择“连接器”，在连接器页面单击“新建连接”。 选择“华为云服务”类别下的“CodeArts Repo”。 在弹窗中配置连接器信息，完成后单击“确定”。 参数 说明 连接名称 填写连接器实例名称。 描述 填写连接器的描述信息，用于识别不同的连接器。 Access Key 当前账号的AK（Access Key ID）。请参考访问密钥获取AK，如果已生成过AK/SK，找到原来已下载的AK/SK文件，文件名一般为：credentials.csv。 Secret Access Key 当前账号的SK（Secret Access Key）。请参考访问密钥获取SK，如果已生成过AK/SK，找到原来已下载的AK/SK文件，文件名一般为credentials.csv。

创建JIRA连接 登录新版ROMA Connect控制台。 在左侧导航栏选择“连接器”，在连接器页面单击“新建连接”。 选择“Jira Software”连接器。 在弹窗中配置连接器信息，完成后单击“确定”。 参数 说明 连接名称 填写连接器实例名称。 连接类型 选择JIRA的连接类型。 Cloud：指在云端部署的JIRA实例，用户可以使用任何Web浏览器从任何地方访问它。 On-Premise：指本地安装的JIRA实例，需要在自己的服务器或本地PC上安装和配置JIRA。 连接地址 填写JIRA的连接地址。 当“连接类型”选择“Cloud”时，连接地址格式为https://your-domain.atlassian.net。 your-domain指组织或团队的域名，需要有有效的Jira Cloud订阅才能访问该地址。如果不确定您的Jira Cloud连接地址，可以从Atlassian账户或管理员处获取。 当“连接类型”选择“On-Premise”时，填写JIRA所在服务器的IP地址或主机名，例如：http://192.168.0.1:8080或http://jira.example.com:8080。 认证类型 选择JIRA的认证类型，支持选择“Basic”和“API Token”。 用户名 仅当“认证类型”选择“Basic”时需要配置。 连接JIRA的用户名。 密码 仅当“认证类型”选择“Basic”时需要配置。 连接JIRA的用户密码。 邮箱 仅当“认证类型”选择“API Token”时需要配置。 JIRA的邮箱。 API Token 仅当“认证类型”选择“API Token”时需要配置。 用户需要在JIRA的个人设置中生成一个API Token，API Token是一种用于身份验证的令牌，它允许JIRA用户通过API访问其账户和相关数据。 描述 填写连接器的描述信息，用于识别不同的连接器。

创建文字识别连接 登录新版ROMA Connect控制台。 在左侧导航栏选择“连接器”，在连接器页面单击“新建连接”。 选择“华为云服务”类别下的“文字识别”。 在弹窗中配置连接器信息，完成后单击“确定”。 参数 说明 连接名称 填写连接器实例名称。 Access Key 当前账号的AK（Access Key ID）。请参考访问密钥获取AK，如果已生成过AK/SK，找到原来已下载的AK/SK文件，文件名一般为：credentials.csv。 Secret Access Key 当前账号的SK（Secret Access Key）。请参考访问密钥获取SK，如果已生成过AK/SK，找到原来已下载的AK/SK文件，文件名一般为credentials.csv。 描述 填写连接器的描述信息，用于识别不同的连接器。

支持的操作 通用表格识别 通用文字识别 网络图片识别 智能分类识别 手写文字识别 身份证识别 行驶证识别 驾驶证识别 护照识别 银行卡识别 营业执照识别 道路运输证识别 车牌识别 名片识别 VIN码识别 增值税发票识别 发票验真 机动车销售发票识别 出租车发票识别 火车票识别 定额发票识别 车辆通行费发票识别 飞机行程单识别 电子面单识别 保险单识别 财务报表识别 道路运输从业资格证识别 自定义模板OCR

支持的动作 修改任务规则集 任务配置高级选项 查询任务检查失败日志 任务配置屏蔽目录 查询任务的高级选项 新建检查任务 查询任务规则集的检查参数 任务配置检查参数 设置每个项目对应语言的默认规则集配置 创建自定义规则集 查询规则集列表 查看规则集的规则列表 查询任务的已选规则集列表 删除自定义规则集 查询任务的已选规则集列表 获取规则列表接口 查询任务规则集的检查参数 终止检查任务 查询缺陷详情的统计 修改缺陷状态 查询任务执行状态 历史扫描结果查询 查询缺陷概要 查询cmertrics缺陷概要 查询缺陷详情 查询任务列表 执行检查任务 删除检查任务

创建CodeArts Check连接 登录新版ROMA Connect控制台。 在左侧导航栏选择“连接器”，在连接器页面单击“新建连接”。 选择“CodeArts Check”连接器。 在弹窗中配置连接器信息，完成后单击“确定”。 参数 说明 连接名称 填写连接器实例名称。 描述 填写连接器的描述信息，用于识别不同的连接器。 Access Key 当前账号的AK（Access Key ID）。请参考访问密钥获取AK，如果已生成过AK/SK，找到原来已下载的AK/SK文件，文件名一般为：credentials.csv。 Secret Access Key 当前账号的SK（Secret Access Key）。请参考访问密钥获取SK，如果已生成过AK/SK，找到原来已下载的AK/SK文件，文件名一般为credentials.csv。

配置参数 表1 获取项目下流水线执行状况 参数 说明 region_id 区域ID。 project_id 项目ID。 start_date 起始日期，起始日期和结束日期间隔不超过一个月，查询包含起始日期。 end_date 结束日期，起始日期和结束日期间隔不超过一个月，查询包含结束日期。 offset 偏移量，表示从此偏移量开始查询，offset大于等于0。 limit 每次查询的条目数量。 表2 获取流水线状态 参数 说明 pipeline_id 要获取状态的流水线ID。 region_id 区域ID。 build_id 要获取状态的执行ID。 表3 获取流水线列表接口 参数 说明 region_id 区域ID。 pipeline_name 流水线名字。参数存在，则进行模糊匹配。 project_ids devCloud项目ids。该参数存在，则获取对应项目下的流水线列表，逗号分隔，id个数取值[0,10]；如果不存在，则获取调用方所属租户的流水线列表。 creator_ids 创建人id。该参数存在，逗号分隔，id个数取值[0,10]。 executor_ids 执行人id。该参数存在，逗号分隔，id个数取值[0,10]。 status 流水线运行状态。取值范围：waiting,running,verifying,handling,suspending,completed。 outcome 流水线结果，标记流水线。error、success、aborted。 sort_key 用于排序的字段。取值为：pipeline_name,create_time,start_time。 sort_dir 排序类型。asc按排序字段升序，desc按排序字段降序。 git_url codehub搜索链接：git@codehub.XXX.git；gitee搜索链接：git@gitee.com.XXX.git；github搜索链接：git@github.com.XXX.git等。 offset 偏移量。表示从此偏移量开始查询，offset大于等于0，默认取值为0。 limit 每次查询的条目数量。取值[10-50]，默认取值为10。 表4 删除流水线 参数 说明 pipeline_id 要删除的流水线ID。 region_id 区域ID。 表5 批量获取流水线状态 参数 说明 region_id 区域ID。 pipeline_ids 要获取状态的流水线ID，用逗号隔开。 表6 停止流水线 参数 说明 pipeline_id 流水线ID。 region_id 区域ID。 build_id 流水线执行ID。 表7 启动流水线 参数 说明 pipeline_id 流水线ID。 region_id 区域ID。 name 构建参数名。 value 构建参数值，最大长度为8192。 表8 检查流水线创建状态 参数 说明 task_id 实例ID。 region_id 区域ID。 表9 查询模板详情 参数 说明 template_id 模板ID。 region_id 区域ID。 template_type 模板类型。 source 接口调用方。 表10 查询模板列表 参数 说明 region_id 区域ID。 template_type 模板类型。 is_build_in 是否内置模板。 offset 偏移量，表示从此偏移量开始查询，offset大于等于0。 limit 每页显示的条目数量。 name 模板名称，匹配规则为模糊匹配。 sort 排序字段。 asc 是否正序。

创建CodeArts Pipeline连接 登录新版ROMA Connect控制台。 在左侧导航栏选择“连接器”，在连接器页面单击“新建连接”。 选择“CodeArts Pipeline”连接器。 在弹窗中配置连接器信息，完成后单击“确定”。 参数 说明 连接名称 填写连接器实例名称。 描述 填写连接器的描述信息，用于识别不同的连接器。 Access Key 当前账号的AK（Access Key ID）。请参考访问密钥获取AK，如果已生成过AK/SK，找到原来已下载的AK/SK文件，文件名一般为：credentials.csv。 Secret Access Key 当前账号的SK（Secret Access Key）。请参考访问密钥获取SK，如果已生成过AK/SK，找到原来已下载的AK/SK文件，文件名一般为credentials.csv。

创建CodeArts Artifact连接 登录新版ROMA Connect控制台。 在左侧导航栏选择“连接器”，在连接器页面单击“新建连接”。 选择“CodeArts Artifact”连接器。 在弹窗中配置连接器信息，完成后单击“确定”。 参数 说明 连接名称 填写连接器实例名称。 描述 填写连接器的描述信息，用于识别不同的连接器。 Access Key 当前账号的AK（Access Key ID）。请参考访问密钥获取AK，如果已生成过AK/SK，找到原来已下载的AK/SK文件，文件名一般为：credentials.csv。 Secret Access Key 当前账号的SK（Secret Access Key）。请参考访问密钥获取SK，如果已生成过AK/SK，找到原来已下载的AK/SK文件，文件名一般为credentials.csv。

查看运行记录 登录新版ROMA Connect控制台。 在左侧导航栏选择“组合应用”，在组合应用页面单击要查看运行记录的组合应用。 在组合应用详情页面，选择“运行记录”页签，可查看该组合应用下流任务运行过程的相关记录信息。 表2 运行记录字段说明 字段 说明 开始时间 流任务的开始时间。 结束时间 流任务的结束时间。 运行ID 流任务的运行ID。 运行时间 流任务的运行时间。 状态 流任务的运行状态。 （可选）配置访问日志，实现异常监控日志的存储。 打开“启动日志记录”，然后配置日志接入信息。 表3 配置访问日志 参数 说明 日志组 选择日志流所在的日志组。 如果没有可选的日志组，单击“查看日志组”，跳转到云日志服务管理控制台，并创建一个日志组，具体操作请参考创建日志组。 日志流 选择运行监控日志要存储的日志流。 如果没有可选的日志流，单击“查看日志流”，跳转到云日志服务管理控制台，并创建一个日志流，具体操作请参考创建日志流。 选择要存储日志的时间段，完成后单击“确认配置”。

创建CodeArts Deploy连接 登录新版ROMA Connect控制台。 在左侧导航栏选择“连接器”，在连接器页面单击“新建连接”。 选择“CodeArts Deploy”连接器。 在弹窗中配置连接器信息，完成后单击“确定”。 参数 说明 连接名称 填写连接器实例名称。 描述 填写连接器的描述信息，用于识别不同的连接器。 Access Key 当前账号的AK（Access Key ID）。请参考访问密钥获取AK，如果已生成过AK/SK，找到原来已下载的AK/SK文件，文件名一般为：credentials.csv。 Secret Access Key 当前账号的SK（Secret Access Key）。请参考访问密钥获取SK，如果已生成过AK/SK，找到原来已下载的AK/SK文件，文件名一般为credentials.csv。

创建JIRA连接 登录新版ROMA Connect控制台。 在左侧导航栏选择“连接器”，在连接器页面单击“新建连接”。 选择“Jira Software”连接器。 在弹窗中配置连接器信息，完成后单击“确定”。 参数 说明 连接名称 填写连接器实例名称。 连接类型 选择JIRA的连接类型。 Cloud：指在云端部署的JIRA实例，用户可以使用任何Web浏览器从任何地方访问它。 On-Premise：指本地安装的JIRA实例，需要在自己的服务器或本地PC上安装和配置JIRA。 连接地址 填写JIRA的连接地址。 当“连接类型”选择“Cloud”时，连接地址格式为https://your-domain.atlassian.net。 your-domain指组织或团队的域名，需要有有效的Jira Cloud订阅才能访问该地址。如果不确定您的Jira Cloud连接地址，可以从Atlassian账户或管理员处获取。 当“连接类型”选择“On-Premise”时，填写JIRA所在服务器的IP地址或主机名，例如：http://192.168.0.1:8080或http://jira.example.com:8080。 认证类型 选择JIRA的认证类型，支持选择“Basic”和“API Token”。 用户名 仅当“认证类型”选择“Basic”时需要配置。 连接JIRA的用户名。 密码 仅当“认证类型”选择“Basic”时需要配置。 连接JIRA的用户密码。 邮箱 仅当“认证类型”选择“API Token”时需要配置。 JIRA的邮箱。 API Token 仅当“认证类型”选择“API Token”时需要配置。 用户需要在JIRA的个人设置中生成一个API Token，API Token是一种用于身份验证的令牌，它允许JIRA用户通过API访问其账户和相关数据。 描述 填写连接器的描述信息，用于识别不同的连接器。

配置参数 表1 创建项目 参数 说明 Project Name 项目名称。 Project Key 项目唯一标识。 Project模板类型 项目模板。 项目描述 描述。 表2 更新项目 参数 说明 update by Project Key 项目唯一标识。 Project Name 项目名称。 项目描述 描述。 表3 查询项目详情 参数 说明 Project Key 项目唯一标识。 表4 删除项目 参数 说明 delete by Project Key 项目唯一标识。 表5 创建issue 参数 说明 Project类型 项目类型。 Project Key 项目唯一标识。 Issue类型 issue类型。 优先级 issue优先级。 概要 issue概要。 提出者 请输入用户名称。 分配给 请输入用户名称。 描述 issue描述。 表6 修改issue 参数 说明 Project类型 项目类型。 Project Key 项目唯一标识。 名称 请输入issue名称或id。 Issue类型 issue类型。 优先级 issue优先级。 概要 issue概要。 提出者 请输入用户名称。 分配给 请输入用户名称。 描述 issue描述。 表7 修改issue状态 参数 说明 Issue名称 请输入issue名称或id。 转换目标状态 需要选择issue支持的状态。 表8 查询issue列表 参数 说明 Jql jira查询请求表达式。 偏移量 分页offset，默认为0。 最大返回数 分页limit。 表9 查询issue详情 参数 说明 Issue名称 请输入issue名称或id。 表10 查询issue可指派用户 参数 说明 Project Key 项目唯一标识，新建issue情况下必填。 Issue名称 请输入issue名称或id，Project Key未填时该字段必填。 JIRA用户名称 用于精确查询。 表11 添加评论 参数 说明 Issue名称 请输入issue名称或id。 可见性 指定可见人范围。 描述 评论内容。 表12 修改评论 参数 说明 Issue名称 请输入issue名称或id。 评论ID 评论的id。 描述 评论内容。 可见性 指定可见人范围。 表13 查询评论列表 参数 说明 Issue名称 请输入issue名称或id。 偏移量 分页offset，默认为0。 最大返回数 分页limit。

脚本配置示例 { "auth_request": { "method": "GET", "protocol": "HTTPS", "url_domain": "10.10.10.10", "timeout": 5000, "path": "/auth", "vpc_channel_enabled": false, "vpc_channel_info": null }, "custom_forbid_limit": 100, "carry_body": { "enabled": true, "max_body_size": 1000 }, "auth_downgrade_enabled": true, "carry_path_enabled": true, "return_resp_body_enabled": false, "carry_resp_headers": [], "simple_auth_mode_enabled": true, "match_auth": null, "rule_enabled": false, "rule_type": "allow" }

欠费影响 包年/包月 对于包年/包月ROMA Connect实例，用户已经预先支付了资源费用，因此在账户出现欠费的情况下，已有的包年/包月ROMA Connect实例仍可正常使用。然而，对于涉及费用的操作，如变更实例规格、续费订单等，用户将无法正常进行。 按需计费 当您的账号因按需ROMA Connect资源自动扣费导致欠费后，账号将变成欠费状态。欠费后，按需资源不会立即停止服务，资源进入宽限期。您需支付按需资源在宽限期内产生的费用，相关费用可在管理控制台“费用中心 ＞ 总览 ＞ 欠费金额”查看，华为云将在您充值时自动扣取欠费金额。 如果您在宽限期内仍未支付欠款，那么就会进入保留期，资源状态变为“已冻结”，您将无法对处于保留期的按需计费资源执行任何操作。 保留期到期后，若您仍未支付账户欠款，那么实例将被释放，数据无法恢复。 图1 按需计费ROMA Connect资源生命周期 华为云根据客户等级定义了不同客户的宽限期和保留期时长。

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

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