华为云用户手册

规划实例区域 负载均衡器选择区域时需要注意以下事项： 选择距离业务目标客户距离最近的区域，可以减少网络时延以及提高下载速度。 共享型负载均衡不支持跨区域关联后端服务器，因此在创建共享型负载均衡时，需选择与后端服务器相同的区域。 独享型负载均衡可通过以下方式实现跨区域、跨VPC添加后端服务器： 通过使用云连接服务实现跨区域间通信，详见《云连接用户指南》。 通过ELB的跨VPC后端功能实现跨VPC添加后端服务器，详见《弹性负载均衡用户指南》。

添加按需套餐包 添加按需套餐包需要先参照创建按需规格添加计费因子，再按照如下步骤添加按需套餐包。 单击“添加套餐包”按钮； 按照页面要求填写“套餐包名称”“周期类型”“可购买的周期类型”“资源重置规则”“套餐包内容”“价格”； “套餐包内容”需添加“计费项”（不推荐一个套餐包下配多个计费项），选择计费项后进行套餐包内容含量设置； 资源重置规则：不可重置指套餐包内容含量为购买有效期内总使用量；按年/按月重置指套餐包内容含量为单位年/月的使用量，套餐包内容总量为单年/月使用量*购买有效期年/月数。举例：购买3个月周期的流量套餐包，套餐包内容含量为1000GB/月，如按月重置，则每月可使用1000GB，如不可重置，则3个月总使用量为1000GB。 填写完成即该套餐包设置已完成，如需再次添加套餐包，可点击下方“添加套餐包”按钮继续添加。 按需套餐包全部添加完成后，填写完成【业务信息】页面内容并提交商品审核。 按需套餐包发布成功后将在页面购买选项中显示，如下图所示，请谨慎填写。

配置思路 登录防火墙，主要配置以下内容。 配置公网地址和内网地址。 （可选）配置静态路由。在配置公网地址时采用了静态IP的方式，且没有配置默认网关，此场景下需要配置静态路由。 配置NAT策略（easy-ip方式），以便内网用户可以直接使用防火墙的公网IP地址来访问Internet。 （可选）配置DHCP参数，如果客户需要防火墙作为DHCP服务器，为内网交换机/PC分配IP地址。 加载云服务组件包。加载云服务组件包后才支持华为乾坤。 配置防火墙与云平台对接。 配置边界防护与响应服务、 漏洞扫描服务 、 云日志 审计服务业务参数。

DHCP服务器规划（可选） 如果客户需要防火墙作为DHCP服务器，为内网交换机/PC分配IP地址。那么请参考如下内容完成数据规划。 表2 DHCP服务器规划 作为DHCP服务器的接口 可分配IP地址范围 子网掩码 默认网关 DNS服务器 GE0/0/6 10.1.1.1-10.1.1.253 255.255.255.0 10.1.1.254 首选DNS：2.2.2.2 （可选）备用DNS：2.2.3.3

IP地址规划 表1 IP地址规划 接口 IP地址获取方式 IP地址示例 备注 上行接口GE0/0/7 静态IP地址 IP地址：1.1.1.1 IP地址的获取方式支持静态IP、DHCP和PPPoE。请根据实际情况进行选择。 IP地址、DNS和PPPoE的拨号信息等需要向租户获取。 子网掩码：255.255.255.0 默认网关：1.1.1.254 首选DNS：2.2.2.2 （可选）备用DNS：2.2.3.3 DHCP方式 防火墙作为DHCP客户端，由DHCP服务器为防火墙分配IP地址和 DNS地址 。 PPPoE方式 通过拨号向PPPoE Server（运营商设备）拨号获得IP地址、DNS地址。 下行接口GE0/0/6 静态IP地址 IP地址：10.1.1.1 业务接口。 漏洞扫描 服务和云日志审计服务共用此接口。 子网掩码：255.255.255.0

操作步骤 选择“面板”，在界面右上方单击“当前设备未激活，功能不可用。点击跳转到设备激活向导页面进行激活”，进入“设备激活向导”界面。 单击“开始一键检测”，然后在“确认”界面，单击“确定”。待连通性检测完成通过，单击“下一步”。 配置License授权编码、客户名称后单击“激活”。待激活设备成功后，单击“下一步”。 您购买的license中必须包括软件基础License，激活设备后功能才可用。 License授权编码是License授权证书中的 Entitlement ID (LAC)，如下图所示。 配置用户体验计划，此处直接单击“下一步”。

背景信息 对于USG6308E-B/USG6318E-B/USG6338E-B/USG6358E-B/USG6378E-B/USG6388E-B/USG6398E-B、USG6000E-E03/USG6000E-E07、USG6303E，需要激活设备后才能使用其功能。 V600R007C20SPC601及之后版本，整机部件编码带“-003”的USG6325E/6335E/6355E/6365E/6385E，需要激活设备后才能使用其功能。

计费模式概述 购买专属主机仅提供包年/包月的计费模式。 购买专属主机后，您可以在专属主机中创建指定规格的E CS 。购买专属主机后，您可以在专属主机中创建指定规格的ECS。专属主机中创建的ECS免费，ECS关联的镜像、弹性公网IP、云硬盘、云备份等资源采取按需计费的方式单独收费。 包年/包月：一种预付费模式，即先付费再使用，按照订单的购买周期进行结算。购买周期越长，享受的折扣越大。 按需计费：一种后付费模式，即先使用再付费，按照镜像、弹性公网IP、云硬盘、云备份等实际使用时长计费，秒级计费，按小时结算。 表1列出了三种计费模式的区别。 表1 计费模式 计费模式 包年/包月 按需计费 付费方式 预付费 按照订单的购买周期结算。 后付费 按照云服务器实际使用时长计费。 计费周期 按订单的购买周期计费。 秒级计费，按小时结算。 适用计费项 专属主机 镜像、弹性公网IP、云硬盘、云备份等 关机计费 专属主机按订单的购买周期计费。 ECS关机对包年/包月的专属主机计费无影响。 ECS关机后，镜像不计费，其他绑定资源（弹性公网IP、云硬盘、云备份等）正常计费。 变更计费模式 专属主机仅支持包年/包月计费模式，不支持变更计费模式。 镜像、弹性公网IP、云硬盘、云备份等仅支持按需计费模式，不支持变更计费模式。 变更规格 支持变更专属主机中ECS的实例规格，不支持变更专属主机规格。 变更ECS时，不涉及变更ECS关联的镜像、弹性公网IP、云硬盘、云备份等资源的规格。 父主题： 计费模式

计费说明 专属主机的计费项由专属主机、专属主机中ECS关联的镜像、弹性公网IP、云硬盘、云备份等费用组成。具体内容如表1所示。 标 * 的计费项为必选计费项。 表1 专属主机计费项 计费项 计费项说明 适用的计费模式 计费公式 * 专属主机 计费因子：专属主机。不同规格的专属主机类型支持不同规格的的ECS，提供不同的ECS计算和存储能力。 包年/包月计费 实例规格单价 * 购买时长 实例规格单价以专属主机价格详情中的价格为准。 * 镜像 公共镜像：除银河麒麟（KylinOS）、统信（UnionTechOS）收费外，其他公共镜像免费。 私有镜像：系统盘镜像和数据盘镜像可免费使用，整机镜像需收取云备份的存储费用。 如果私有镜像是由市场镜像创建的云服务器创建的，则会根据云市场价格收取镜像费用。 共享镜像：来源于他人共享的系统盘镜像、数据盘镜像可免费使用，来源于他人共享的整机镜像需收取云备份的存储费用。 如果共享镜像是由市场镜像创建的云服务器创建的，则会根据云市场价格收取镜像费用。 市场镜像：以镜像供应商提供的信息为准。 按需计费 镜像单价 * 购买时长 镜像单价以售卖页和云市场镜像显示的价格为准。 * 云硬盘（系统盘） 计费因子：云硬盘类型、容量。创建ECS实例时会默认购买40GiB的系统盘，用户可以根据需要调整该容量。 购买云硬盘成功后，将立即开始计费，计费与其是否被使用无关。 按需计费 云硬盘单价 * 购买时长 云硬盘单价请参见弹性 云服务器价格 详情中的“磁盘价格”，或者云硬盘价格详情。 云硬盘（数据盘） 如有额外的存储需求，您需要购买数据盘。 计费因子：云硬盘类型、容量。 按需计费 云硬盘单价 * 购买时长 公网带宽 如有互联网访问需求，您需要购买弹性公网IP。 计费因子：带宽费、流量费和IP保有费。 按需计费模式支持按带宽计费、按流量计费和加入共享带宽三种计费方式，分别收取带宽费+IP保有费、流量费+IP保有费、带宽费+IP保有费。 按需计费 带宽费支持使用带宽加油包抵扣，流量费支持使用共享流量包抵扣。 按固定带宽值采用阶梯计费 0Mbit/s~5Mbit/s（含）：均为一个统一的单价 大于5Mbit/s：按每Mbit/s计费 公网带宽单价请参见弹性云服务器价格详情中的“带宽价格”，或者弹性公网IP价格详情。 在创建弹性云服务器过程中，可能还会涉及一些高级配置的费用，如主机安全、云备份。具体如表2所示。 表2 高级配置计费项 计费项 计费项说明 主机安全 如有主机安全防护需求，您需要开启安全防护能力，包含主机安全基础防护和高阶防护。 可免费开启基础防护，开启后，将为您的主机提供四大安全防御能力：主机安全基础版防御（免费赠送一个月，超过一个月后自动取消）、账号破解防护、弱口令检测、恶意程序检测等功能。 付费开启高阶防护，即购买企业版主机安全，在漏洞修复、病毒查杀和等保场景中必备。 详细计费信息请参见 企业主机安全 价格详情。 云备份 如有备份需求，您需要购买备份存储库，用来存放服务器产生的备份副本。 按照存储库容量计费，详细计费信息请参见云备份价格详情。

计费示例 假设您在2023/03/08 15:50:04购买了一台包年/包月专属主机，购买时长为一个月，并在到期前手动续费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 您需要为每个计费周期预先付费，各项ECS资源单独计费，计费公式如表3所示。 表3 计费公式 资源类型 计费公式 资源单价 专属主机 专属主机类型单价 * 购买时长 以专属主机价格详情中的价格为准。

计费场景 某用户于2023/03/18 10:30:00购买了一台包年包月的s7类型专属主机，购买时长为1个月。于2023/03/18 15:30:00创建了一台按需计费的ECS，规格配置如下： 规格：s7.large.2（2vCPUs，4GiB） 镜像：Windows Server 2019 标准版 系统盘：通用型SSD，40GiB 数据盘：通用型SSD，100GiB 公网带宽：6Mbit/s 用了一段时间后，用户发现ECS当前规格无法满足业务需要，于2023/04/20 9:00:00扩容规格为s7.xlarge.2（4vCPUs，8GiB）。因为该专属主机打算长期使用下去，又续费1个月。那么在3~5月份，该专属主机总共产生多少费用呢？

计费构成分析 可按照资源类型分为两部分：包周期资源专属主机和ECS关联的按需资源。 专属主机 在2023/03/18 10:30:00 ~ 2023/05/18 23:59:59期间为包年/包月计费，计费时长为2个月，费用计算如下。 专属主机类型单价 * 购买时长=26,875.47元/月*2月=53,750.94元 按需资源 ECS关联的按需资源在2023/03/18 15:30:00~ 2023/05/18 23:59:59期间为按需计费，计费时长为1472.5小时，费用计算如下： 由此可见，在3~5月份，该专属主机总共产生的费用为：53,750.94 + 1042.97 = 54793.91 元。

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

在续费管理页面开通自动续费 登录管理控制台。 单击“控制台”页面上方“费用与成本”，在下拉菜单中选择“续费管理”。 进入“续费管理”页面。 自定义查询条件。 可在“自动续费项”页签查询已经开通自动续费的资源。 可对“手动续费项”、“到期转按需项”、“到期不续费项”页签的资源开通自动续费。 图2 续费管理 为包年/包月资源开通自动续费。 单个资源开通自动续费：选择需要开通自动续费的专属主机，单击操作列“开通自动续费”。 批量资源开通自动续费：选择需要开通自动续费的专属主机，单击列表左上角的“开通自动续费”。 选择续费时长，并根据需要设置自动续费次数，单击“开通”。

删除卫星影像 您可根据实际需求删除卫星影像。状态为“迁入中”、“迁出中”、“删除中”的卫星影像无法删除。 登录KooMap管理控制台。 在左侧导航栏选择“卫星影像”下的“数据管理”菜单，然后在右侧页面单击“影像数据”页签。 单个或批量删除卫星影像。 单个删除：单击卫星影像操作列“更多”，选择“删除”。 批量删除：勾选待删除的卫星影像，单击“批量操作”，选择“批量删除”。批量删除总数最多100条。 在确认删除对话框中输入“DELETE”，单击“确定”，删除卫星影像。

预览成果影像 您可在界面预览COG格式的成果影像。 历史处理的成果影像如果不是COG格式，则不支持在线预览。 登录KooMap管理控制台。 在左侧导航栏选择“卫星影像”下的“数据管理”菜单，然后在右侧页面单击“影像数据”页签。 选择“数据类型”为“成果数据”的卫星影像，单击操作列“预览”，进入“影像预览”界面。 在“影像预览”界面，您可根据需求预览成果影像。 图1 影像预览界面 ：单击此按钮，放大预览影像。 ：单击此按钮，缩小预览影像。 ：单击此按钮，刷新预览影像。 ：单击此按钮，在预览界面左下角拖动红框，预览圈定范围内的影像。

迁移卫星影像 您可根据实际需求将KooMap存储空间内的卫星影像迁移到OBS。状态为“迁入中”、“迁出中”、“迁入失败”和“删除中”的卫星影像不能迁移。单个或批量迁移的单条卫星影像文件都需满足：文件总大小不能大于10TB，总个数最多1万个。 登录KooMap管理控制台。 在左侧导航栏选择“卫星影像”下的“数据管理”菜单，然后在右侧页面单击“影像数据”页签。 单个或批量迁移卫星影像。 单个迁移：单击卫星影像操作列“更多”，选择“迁移”。 批量迁移：勾选待迁移的卫星影像，单击“批量操作”，选择“批量迁移”。批量迁移总数最多100条。 在弹出来的页面设置迁出的桶 域名 和路径。 表1 迁移卫星影像说明 参数 说明 桶域名 必填项。 根据界面提示输入OBS桶访问域名。 示例：example-bucket.obs.cn-north-4.myhuaweicloud.com example-bucket：OBS桶名 .obs.cn-north-4.myhuaweicloud.com：域名 迁出路径 必填项。 根据界面提示输入影像迁出路径。 路径参考格式为：path/to/files 单击“确定”，迁移卫星影像。 迁移过程中“运行状态”为“迁出中”，迁移成功后，“运行状态”变更为“完成”。

查看成果数据/原始数据列表 您可根据实际需求查看成果数据/原始数据列表。 登录KooMap管理控制台。 在左侧导航栏选择“卫星影像”下的“数据管理”菜单，然后在右侧页面单击“影像数据”页签。 单击蓝色字体“成果数据”或“原始数据”，分别查看原始数据或成果数据列表。 单击“成果数据”：查看处理成当前成果数据用到的所有原始数据列表。 图2 查看原始数据列表 单击“原始数据”：查看使用当前原始数据处理后的所有成果数据列表。 图3 查看成果数据列表

成本分配 成本管理的基础是树立成本责任制，让各部门、各业务团队、各责任人参与进来，为各自消耗云服务产生的成本负责。企业可以通过成本分配的方式，将云上成本分组，归集到特定的团队或项目业务中，让各责任组织及时了解各自的成本情况。 华为云成本中心支持通过多种不同的方式对成本进行归集和重新分配，您可以根据需要选择合适的分配工具。 通过关联账号进行成本分配 企业主客户可以使用关联账号对子客户的成本进行归集，从而对子账号进行财务管理。详细介绍请参见通过关联账号维度查看成本分配。 通过企业项目进行成本分配 在进行成本分配之前，建议开通企业项目并做好企业项目的规划，可以根据企业的组织架构或者业务项目来划分。在购买云资源时选择指定企业项目，新购云资源将按此企业项目进行成本分配。详细介绍请参见通过企业项目维度查看成本分配。 通过成本标签进行成本分配 标签是华为云为了标识云资源，按各种维度（例如用途、所有者或环境）对云资源进行分类的标记。推荐企业使用预定义标签进行成本归集，具体流程如下： 详细介绍请参见通过成本标签维度查看成本分配。 使用成本单元进行成本分配 企业可以使用成本中心的“成本单元”来拆分公共成本。公共成本是指多个部门共享的计算、网络、存储或资源包产生的云成本，或无法直接通过企业项目、成本标签分配的云成本。这些成本不能直接归属于单一所有者，因此不能直接归属到某一类别。使用拆分规则，可以在各团队或业务部门之间公平地分配这些成本。详细介绍请参见使用成本单元查看成本分配。

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

获取驱动包 单击此处获取 GaussDB 驱动包“GaussDB_driver.zip”。 单击此处获取GaussDB驱动包校验包“GaussDB_driver.zip.sha256”。 为了防止软件包在传递过程或存储期间被恶意篡改，下载软件包时需下载对应的校验包对软件包进行校验，校验方法如下： 上传软件包和软件包校验包到虚拟机（Linux操作系统）的同一目录下。 执行如下命令，校验软件包完整性。 cat GaussDB_driver.zip.sha256 | sha256sum --check 如果回显OK，则校验通过。 GaussDB_driver.zip: OK

GLOBAL_SESSION_STAT_ACTIVITY 显示集群内各节点上正在运行的线程相关的信息。 表1 GLOBAL_SESSION_STAT_ACTIVITY字段 名称 类型 描述 coorname text CN节点名称。 datid oid 用户会话在后台连接到的数据库OID。 datname text 用户会话在后台连接到的数据库名称。 pid bigint 后台线程ID。 usesysid oid 登录该后台的用户OID。 usename text 登录该后台的用户名。 application_name text 连接到该后台的应用名。 client_addr inet 连接到该后台的客户端的IP地址。如果此字段是null，它表明通过服务器机器上UNIX套接字连接客户端或者这是内部进程，如autovacuum。 client_hostname text 客户端的主机名，这个字段是通过client_addr的反向DNS查找得到。这个字段只有在启动log_hostname且使用IP连接时才非空。 client_port integer 客户端用于与后台通讯的TCP端口号，如果使用Unix套接字，则为-1。 backend_start timestampwith time zone 该过程开始的时间，即当客户端连接服务器时间。 xact_start timestampwith time zone 启动当前事务的时间，如果没有事务是活跃的，则为null。如果当前查询是首个事务，则这列等同于query_start列。 query_start timestampwith time zone 开始当前活跃查询的时间，如果state的值不是active，则这个值是上一个查询的开始时间。 state_change timestampwith time zone 上次状态改变的时间。 waiting boolean 如果后台当前正等待锁则为true。 enqueue text 工作负载管理资源状态。 state text 该后台当前总体状态。可能值是： active：后台正在执行一个查询。 idle：后台正在等待一个新的客户端命令。 idle in transaction：后台在事务中，但是目前无法执行查询。 idle in transaction (aborted)：后台在事务中，但事务中有语句执行失败。 fastpath function call：后台正在执行一个fast-path函数。 disabled：如果后台禁用track_activities，则报告这个状态。 说明： 普通用户只能查看到自己帐户所对应的会话状态。即其他帐户的state信息为空。例如以judy用户连接数据库后，在pg_stat_activity中查看到的普通用户joe及初始用户omm的state信息为空： postgres=# SELECT datname, usename, usesysid,state,pid FROM pg_stat_activity; datname | usename | usesysid | state | pid ----------+---------+----------+--------+-----------------postgres | omm | 10 | |139968752121616 postgres | omm | 10 | |139968903116560 db_tpcds | judy | 16398 | active |139968391403280 postgres | omm | 10 | |139968643069712 postgres | omm | 10 | |139968680818448 postgres | joe | 16390 | |139968563377936 (6 rows) resource_pool name 用户使用的资源池。 query_id bigint 查询语句的ID。 query text 该后台的最新查询。如果state状态是active（活跃的），此字段显示当前正在执行的查询。所有其他情况表示上一个查询。 父主题： Session/Thread

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

配置参数 表1 新增Pull Request评论 参数 说明 仓库名 填写GitHub中代码仓库的名字。 仓库所有者 填写GitHub中代码仓库的Owner。 pullRequest编号 填写要新增评论的pullRequest编号。 内容 填写评论的具体内容。 表2 关闭Pull Request 参数 说明 仓库名 填写GitHub中代码仓库的名字。 仓库所有者 填写GitHub中代码仓库的Owner。 pullRequest编号 填写要关闭评论的pullRequest编号。 表3 创建Issue 参数 说明 仓库名 填写GitHub中代码仓库的名字。 仓库所有者 填写GitHub中代码仓库的Owner。 标题 填写新建Issue的标题。 内容 填写新建Issue的具体内容。

创建JIRA连接 登录CodeArts Link控制台。 在左侧导航栏选择“连接器”，在连接器页面单击“新建连接”。 选择“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访问其账户和相关数据。

创建JIRA连接 登录CodeArts Link控制台。 在左侧导航栏选择“连接器”，在连接器页面单击“新建连接”。 选择“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

配置参数 参数 说明 语言 选择编写脚本使用的编程语言，当前只支持ES5版本的JavaScript语言。 输出到变量 脚本处理的结果将存入该变量，后续步骤可通过“${变量名}”的方式引用当前脚本处理结果。 内容 编写脚本内容。 可通过变量的形式引用前序步骤中的数据，请参考引用变量。 当需要解析JSON格式的内容数据时，可通过“JSON.parse('${body}')”的方式将内容数据转换为JSON对象，然后进行数据解析。 脚本处理组件可以生成一个输出结果并传给后续步骤，用户需要在脚本的末尾指定要输出的变量名称，例如： function getUser(){ return {"id": ${property.id},"name":"${property.name}"}; } var user=getUser(); user; 说明： 如果需要编写函数或者逻辑代码块，需使用“{”和“}”围绕代码块。 图1 脚本处理

创建CodeArts TestPlan连接 登录CodeArts Link控制台。 在左侧导航栏选择“连接器”，在连接器页面单击“新建连接”。 选择“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。

配置参数 表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