华为云用户手册

前提条件 自建Nacos迁移，需创建 CS E Nacos服务作为目标端，创建CSE Nacos实例，详情请参考创建注册配置中心。 使用Nacos Sync组件进行同步迁移，Nacos Sync组件依赖Mysql进行部署，需要创建Mysql实例，并创建数据库与表，请参考购买RDS for MySQ L实例 创建按需计费的MySQL 5.7版本的实例，其规格为通用型2vCPUs|4GB，参考更改安全组修改安全组配置，开放所有端口。 组件部署在ECS中，请参考自定义购买ECS创建按需计费、X86架构的4vCPUs|8GB规格、公共镜像为EulerOS-EulerOS 2.9 64bit的弹性云服务器，且网络配置需绑定弹性公网IP，具体操作请参考绑定弹性公网IP，使用与MySQL同样的安全组，还需在ECS中安装JRE 8。 同步任务需要双边网络互通，所以您自建的Nacos、CSE Nacos、Mysql和ECS实例需要处于同一个网段下，能够网络互通，并且组件的配置安全组规则完成。

方案简介 本文介绍一种基于Nacos Sync的注册中心迁移方案，方案适用于在华为云上自建Nacos的用户。 Nacos Sync是一款开源组件，支持注册中心的双向同步与平滑迁移，通过配置同步任务的方式，进行服务的迁移，Nacos Sync能使源集群的服务信息和CSE Nacos的服务信息保持同步，从而实现自建配置注册中心和CSE Nacos之间的平滑迁移，适用于对业务不中断有诉求的用户。 Nacos Sync支持开源Nacos版本为1.4.1至2.1.0。 如图示，用户通过Nacos Sync组件，将注册订阅在自建Nacos的服务实例，实时同步至CSE的Nacos，实现服务实例的双向注册。

支持的云手机实例规格 表2 physical.rx1.xlarge可部署的云手机规格 规格名称 配置 rc1.se CPU&内存：4vCPUs | 8GB 屏幕分辨率：1280x720 DPI：320 渲染帧率：30fps 手机开数：60 rc1.plus CPU&内存：6vCPUs | 12GB 屏幕分辨率：1280x720 DPI：320 渲染帧率：60fps 手机开数：30 rx1.cp.c60.d32.e1v1.qemu CPU&内存：2vCPUs | 3.0GB | 32GB 屏幕分辨率：960x540 手机开数：60 EIP/VIP：1/1 表3 physical.rx2.32xlarge.4可部署的云手机规格 规格名称 配置 rc2.se CPU&内存：5vCPUs | 10GB 屏幕分辨率：1280x720 DPI：320 渲染帧率：30fps 手机开数：100 rc2.plus CPU&内存：6vCPUs | 12GB 屏幕分辨率：1280x720 DPI：320 渲染帧率：30fps 手机开数：80 rc2.pro CPU&内存：8vCPUs | 16GB 屏幕分辨率：1280x720 DPI：320 渲染帧率：60fps 手机开数：60 rc2.max CPU&内存：16vCPUs | 24GB 屏幕分辨率：1920x1080 DPI：440 渲染帧率：30fps 手机开数：40 rc2.pro_max CPU&内存：20vCPUs | 32GB 屏幕分辨率：1920x1080 DPI：440 渲染帧率：30fps 手机开数：20 表4 physical.rx3.32xlarge.4可部署的云手机规格 规格名称 配置 rc3.se CPU&内存：5vCPUs | 10GB 屏幕分辨率：1280x720 DPI：320 渲染帧率：30fps 手机开数：100 rc3.plus CPU&内存：6vCPUs | 12GB 屏幕分辨率：1280x720 DPI：320 渲染帧率：60fps 手机开数：90 rc3.pro CPU&内存：8vCPUs | 16GB 屏幕分辨率：1920x1080 DPI：440 渲染帧率：60fps 手机开数：60 rc3.max CPU&内存：16vCPUs | 24GB 屏幕分辨率：1920x1080 DPI：440 渲染帧率：60fps 手机开数：40 rc3.pro_max CPU&内存：20vCPUs | 32GB 屏幕分辨率：1920x1080 DPI：440 渲染帧率：60fps 手机开数：20 “手机开数”是指一台服务器可以虚拟出的云手机数量。例如：手机开数为60，表示购买一台服务器，实际可以得到60台云手机。 手机磁盘存储大小以及网络等其他配置可在购买时自定义。

规格2.0切换指南 云手机已上线解耦了存储与网络的新版实例规格，推荐您按照下表对应关系选择与原1.0实例规格对应的2.0实例规格进行购买。 2.0手机规格 开数 1.0手机规格 服务器规格 rc1.plus 30 rx1.cp.c15.d46.e1v1 physical.rx1.xlarge physical.rx1.xlarge.cg rx1.cp.c30.d23.e1v1 physical.rx1.xlarge rx1.cp.c30.d23.e5v5 physical.rx1.xlarge rx1.cp.dedicated.c30.d25.e3v3 physical.rx1.xlarge.dedicated rc1.se 60 rx1.cp.c45.d15.e1v1 physical.rx1.xlarge rx1.cp.dedicated.c45.d10.e1v1.a250 physical.rx1.xlarge.dedicated rx1.cp.c60.d10.e0v1 physical.rx1.xlarge rx1.cp.c60.d10.e0v60 physical.rx1.xlarge rx1.cp.c60.d10.e1v1 physical.rx1.xlarge rx1.cp.c60.d8.e1v1.a200 physical.rx1.xlarge rx1.cp.dedicated.c60.d16.e1v1 physical.rx1.xlarge.dedicated rx1.cp.dedicated.c60.d18.e1v1 physical.rx1.xlarge.dedicated rx1.cp.dedicated.c60.d18.e5v5 physical.rx1.xlarge.dedicated rx1.cp.dedicated.c60.d8.e1v1.a200 physical.rx1.xlarge.dedicated rx1.cp.vp.c60.d10.e1v1 physical.rx1.xlarge rs1.se 75 rx1.cp.c75.d11.e5v5.br75 physical.rx1.xlarge rx1.cp.c75.d15.e1v1 physical.rx1.xlarge rx1.cp.dedicated.c75.d11.e1v1 physical.rx1.xlarge.dedicated rx1.cp.dedicated.c75.d15.e1v1 physical.rx1.xlarge.dedicated rx1.cp.dedicated.c75.d15.e5v5 physical.rx1.xlarge.dedicated rx1.cp.dedicated.c75.d6.e1v1.a200 physical.rx1.xlarge.dedicated rx1.cp.c90.d6.e1v1 physical.rx1.xlarge rc2.max 40 kg1.cg.c20.d30SSD.e1v1 physical.kg1.4xlarge.cg kg1.cg.c20.d50SSD.e1v1 physical.kg1.4xlarge.cg kg1.cg.c20.d50SSD.e1v1.s400 physical.kg1.4xlarge.cg kg1.cp.c20.d64SSD.e1v1 physical.kg1.4xlarge.cp kg1.cg.c30.d50SSD.e1v1 physical.kg1.4xlarge.cg kg1.cp.c31.d20SSD.e3v3 physical.kg1.4xlarge.cp kg1.cp.c31.d32GPSSD.e1v1 physical.kg1.4xlarge.cp kg1.cp.c31.fd32GPSSD.e3v3 physical.kg1.4xlarge.cp kg1.cp.dedicated.c31.d100GPSSD.e1v1.a4096 physical.kg1.4xlarge.cp.dedicated R2c.xlarge.4 physical.kg1.4xlarge.cp kg1.cg.c40.d30SSD.e1v1 physical.kg1.4xlarge.cg kg1.cg.c40.d30SSD.e1v1.a200 physical.kg1.4xlarge.cg kg1.cp.c40.d32GPSSD.e1v1 physical.kg1.4xlarge.cp kg1.cg.c48.d500SSD.e1v1.s500 physical.kg1.4xlarge.cg rc2.pro 60 kg1.cg.c60.d30SSD.e1v1.s800 physical.kg1.4xlarge.cg kg1.cg.c60.d50SSD.e1v1 physical.kg1.4xlarge.cg kg1.cp.c60.d10GPSSD.e1v1.a300 physical.kg1.4xlarge.cp kg1.cp.c60.d16GPSSD.e1v1 physical.kg1.4xlarge.cp kg1.cp.c60.d16SSD.e1v1 physical.kg1.4xlarge.cp kg1.cp.c60.d32GPSSD.e1v1 physical.kg1.4xlarge.cp kg1.cp.c60.d32SSD.e5v5 physical.kg1.4xlarge.cp kg1.cp.c60.d64GPSSD.e1v1 physical.kg1.4xlarge.cp kg1.cp.c60.d64SSD.e1v1 physical.kg1.4xlarge.cp kg1.cp.c60.fd20GPSSD.e5v5 physical.kg1.4xlarge.cp kg1.cp.dedicated.c60.fd30GPSSD.e1v1.a700 physical.kg1.4xlarge.cp.dedicated R2s.xlarge.2 physical.kg1.4xlarge.cp rc2.plus 80 kg1.cp.c80.d30GPSSD.e1v1 physical.kg1.4xlarge.cp rc2.se 100 kg1.cp.c90.d14.e1v1 physical.kg1.4xlarge.a.cp kg1.cp.c100.d10GPSSD.e0v100 physical.kg1.4xlarge.cp kg1.cp.c100.d10GPSSD.e100v100 physical.kg1.4xlarge.cp kg1.cp.c100.d10GPSSD.e1v1 physical.kg1.4xlarge.cp kg1.cp.c100.d10SSD.e1v1 physical.kg1.4xlarge.cp kg1.cp.c100.d16GPSSD.e1v1 physical.kg1.4xlarge.cp kg1.cp.c100.d16SSD.e0v100 physical.kg1.4xlarge.cp kg1.cp.c100.d16SSD.e0v20 physical.kg1.4xlarge.cp kg1.cp.c100.d16SSD.e10v10 physical.kg1.4xlarge.cp kg1.cp.c100.d16SSD.e1v1 physical.kg1.4xlarge.cp kg1.cp.c100.d32SSD.e1v1 physical.kg1.4xlarge.cp kg1.cp.c100.fd16GPSSD.e10v10 physical.kg1.4xlarge.cp kg1.cp.c100.fd24GPSSD.e0v1 physical.kg1.4xlarge.cp kg1.cp.dedicated.c100.d10GPSSD.e1v1.a1024 physical.kg1.4xlarge.cp.dedicated rx2.cp.dedicated.c100.d45GPSSD.e1v1 physical.rx2.32xlarge.4.dedicated rs2.plus 124 kg1.cp.c120.d10GPSSD.e1v1 physical.kg1.4xlarge.cp kg1.cp.c120.d10SSD.e1v1 physical.kg1.4xlarge.cp kg1.cp.c120.d16GPSSD.e1v1 physical.kg1.4xlarge.cp kg1.cp.c120.fd16GPSSD.e1v1 physical.kg1.4xlarge.cp kg1.cp.c120.fd16GPSSD.e2v2 physical.kg1.4xlarge.cp kg1.cp.c130.d10GPSSD.e1v1 physical.kg1.4xlarge.cp kg1.cp.dedicated.c120.fd10GPSSD.e1v1 physical.kg1.4xlarge.cp.dedicated kg1.cp.dedicated.c120.fd18GPSSD.e1v1 physical.kg1.4xlarge.cp.dedicated rs2.se 150 kg1.cp.c150.d10GPSSD.e1v1 physical.kg1.4xlarge.cp kg1.cp.c150.fd10GPSSD.e0v1 physical.kg1.4xlarge.cp kg1.cp.c150.fd10GPSSD.e1v1 physical.kg1.4xlarge.cp kg1.cp.c150.fd10GPSSD.e2v2 physical.kg1.4xlarge.cp kg1.cp.c150.fd15GPSSD.e10v10 physical.kg1.4xlarge.cp kg1.cp.dedicated.c150.d10GPSSD.e1v1.a1024 physical.kg1.4xlarge.cp.dedicated kg1.cp.dedicated.c150.d8GPSSD.e1v1.a500 physical.kg1.4xlarge.cp.dedicated kg1.cp.dedicated.c150.fd10GPSSD.e1v1 physical.kg1.4xlarge.cp.dedicated rx2.cp.dedicated.c150.d30GPSSD.e1v1 physical.rx2.32xlarge.4.dedicated rx2.cp.dedicated.c150.d8GPSSD.e1v1 physical.rx2.32xlarge.4.dedicated rx2.cp.dedicated.c150.d8GPSSD.e1v1.a500 physical.rx2.32xlarge.4.dedicated rs2a.pro 72 kg1.cp.c72.d10.e1v1 physical.kg1.4xlarge.a.cp kg1.cp.c72.d18.e1v1 physical.kg1.4xlarge.a.cp rc3.pro_max 20 rx3.cp.c14.d32GPSSD.e1v1 physical.rx3.32xlarge.4 rx3.cp.c20.d32GPSSD.e1v1 physical.rx3.32xlarge.4 rc3.max 40 rx3.cp.c30.d32GPSSD.e1v1 physical.rx3.32xlarge.4 rc3.pro 60 rx3.cp.c60.d27GPSSD.e0v60.a100 physical.rx3.32xlarge.4 rc3.plus 90 rx3.cp.c90.d16GPSSD.e1v1 physical.rx3.32xlarge.4 rx3.cp.dedicated.c90.d16GPSSD.e1v1 physical.rx3.32xlarge.4.dedicated rs3.plus 124 rx3.cp.c120.d10GPSSD.e0v120 physical.rx3.32xlarge.4 rx3.cp.c120.d10GPSSD.e1v1 physical.rx3.32xlarge.4 rs3.se 150 rx3.cp.c150.d10GPSSD.e1v1 physical.rx3.32xlarge.4 rx3.cp.c150.d10GPSSD.e1v1.a1024 physical.rx3.32xlarge.4 rx3.cp.dedicated.c150.d30GPSSD.e10v10 physical.rx3.32xlarge.4.dedicated rx3.cp.dedicated.c150.d30GPSSD.e1v1 physical.rx3.32xlarge.4.dedicated rx3.cp.dedicated.c150.d8GPSSD.e1v1.a3400 physical.rx3.32xlarge.4.dedicated rx3.cp.dedicated.c150.d8GPSSD.e1v1.a500 physical.rx3.32xlarge.4.dedicated rx3.cp.sp.c150.d10GPSSD.e1v1 physical.rx3.32xlarge.4

云手机服务器规格 表1 云手机服务器规格 规格名称 配置 physical.rx1.xlarge CPU：Hi1616 (2*32Core*2.4GHz) 内存：256GB DDR4 RAM 本地磁盘：2*1.2T SAS + 800G SSD 网卡：2*10GE GPU算力（FP32) : 11.67 TFLOPS physical.rx2.32xlarge.4 CPU：Kunpeng 920 (2*64Core*2.6GHz) 内存：512GB DDR4 RAM 本地磁盘：N/A 网卡：2*10GE GPU算力（FP32) : 19.45 TFLOPS physical.rx3.32xlarge.4 CPU：Kunpeng 920 (2*64Core*2.6GHz) 内存：512GB DDR4 RAM 本地磁盘：N/A 网卡：2*25GE GPU算力（FP32) : 35.66 TFLOPS

功能更新说明 发布日期 更新模块 更新内容 2020/6/10 控制台 开通 隐私保护通话 支持业务调研 2019/9/30 控制台 控制台新增催审功能 2019/8/1 控制台 控制台新增号码批量转移功能 2019/4/30 控制台 控制台新增查询业务详单功能 2019/3/4 接口 “短信通知接口”支持失败重传机制、支持获取短信发送结果 “AX/AXB/AXE模式绑定接口”支持X号码对应城市严格匹配模式 2019/2/1 接口 新增“X号码状态通知接口” “短信通知接口”支持获取用户发送的短信内容 “获取录音文件下载地址接口”录音下载地址有效期变更为3天 2018/12/17 接口 “AX模式设置临时被叫接口”新增设置临时被叫关系保持时间功能 2018/12/7 接口&控制台 新增AXE模式 控制台应用管理新增一键添加默认放音文件功能 2018/11/5 控制台 控制台新增放音文件管理功能 控制台添加应用新增可定制选项

典型使用场景 模式 简介 应用场景 AXB AXB模式下的隐私保护号码主要在一对一场景下使双方隐私都得到保护，既能保持双方正常通话，又隐藏了通话双方的真实号码。 网约打车、外卖派送、线上医生问诊等。 AX AX模式下的隐私保护号码主要在一对N场景下对单方号码进行隐私保护，A对外的号码都以X替代，所有与A的通话都通过X建立，保护A号码不泄露。 咨询行业、快递服务等。 AXE 在AX的基础上增加了分机号的概念，A对外的号码都以隐私号X+分机号替代，保护A号码不泄露，提高号码利用率，降低号码成本。 快递服务、外卖等。 X X模式下的隐私保护号码主要在N对N场景对号码进行保护。 说明： X模式暂不支持申请。 物流、在线客服等。 AXYB AXYB模式下的隐私保护号码主要在一对多互动场景对号码进行保护。通话都通过隐私号码建立，保证通话双方的号码不泄露。 派送、汽车救援、租车等。 注：开通/使用隐私保护通话业务，请参考隐私保护通话使用全流程。

步骤二：创建RocketMQ实例 使用RocketMQ进行消息生产和消费时，必须先创建RocketMQ实例。实例中的虚拟机资源会存储Topic信息。 进入购买RocketMQ实例页面。 在“快速购买”页签，设置实例基础配置，如图2所示，配置详情请参考表2。 表2 设置实例基础配置 参数 说明 计费模式 选择“按需计费”，即先使用再付费，按照RocketMQ实例实际使用时长计费，秒级计费，按小时结算。 区域 不同区域的云服务产品之间内网互不相通。请就近选择靠近您业务的区域，可减少网络时延，提高访问速度。 选择“华北-北京四”。 可用区 可用区指在同一区域下，电力、网络隔离的物理区域，可用区之间内网互通，不同可用区之间物理隔离。 选择1个可用区。 图2 设置实例基础配置 设置实例规格和存储空间，如图3所示，配置详情请参考表3。 表3 设置实例规格和存储空间 参数 说明 套餐规格 选择“综合推荐”中的“入门规格”。针对入门级用户，提供兼容RocketMQ协议的基础版小规格实例，适用于性能诉求不高、时延容忍度较高的成本敏感业务或者预发环境等。 存储空间 根据实际需要选择存储RocketMQ数据的磁盘类型和磁盘大小。 RocketMQ实例创建后，磁盘类型不支持修改。 磁盘类型选择“超高I/O”，磁盘大小设置为“200GB”。 图3 设置实例规格和存储空间 设置实例网络环境信息，如图4所示，配置详情请参考表4。 表4 设置实例网络环境信息 参数 说明 虚拟私有云 虚拟私有云在RocketMQ实例创建完成后，不支持修改。 选择准备工作中设置好的虚拟私有云。 子网 子网在RocketMQ实例创建完成后，不支持修改。 选择准备工作中设置好的子网。 安全组 选择准备工作中设置好的安全组。 图4 设置实例网络环境信息 设置实例的访问方式，如图5所示，配置详情请参考表5。 表5 设置实例访问方式 参数 说明 公网访问 开启公网访问需要绑定弹性IP地址。此处选择关闭公网访问。 加密方式 开启SSL，表示服务端与客户端之间通过密文传输，安全性较高，性能较低。此处选择配置为“SSL”。 图5 设置实例访问方式 设置实例高级配置，如图6所示，配置详情请参考表6，其他参数保持默认设置。 表6 设置实例高级配置 参数 说明 实例名称 实例名称支持自定义，但需要符合命名规则：长度为4~64个字符，由英文字母开头，只能由英文字母、数字、中划线、下划线组成。 此处配置为“rocketmq-test”。 企业项目 该参数针对企业用户使用。企业项目是对企业不同项目间资源的分组和管理，属于逻辑隔离。 此处选择“default”。 ACL访问控制 开启ACL访问控制可以对生产消息和消费消息进行权限管理。此处选择关闭ACL访问控制。 标签 标签是RocketMQ实例的标识。此处不设置标签。 描述 描述是对实例的补充说明。此处不填写描述信息。 图6 设置实例高级配置 填写完上述信息后，单击“确认订单”，进入“确认配置”页面。 确认实例信息无误后，勾选“华为云用户协议”，并单击“提交”请求。 在实例列表页面，查看RocketMQ实例是否创建成功。 创建实例大约需要3到15分钟，此时实例的“状态”为“创建中”。 当实例的“状态”变为“运行中”时，说明实例创建成功。 当实例的“状态”变为“创建失败”，请删除创建失败的实例，然后重新创建。如果重新创建仍然失败，请联系客服。 实例创建成功后，单击实例名称，进入实例基本信息页面。 记录实例的连接地址，便于生产和消费消息时使用。 图7 记录实例连接地址

相关信息 如果您想了解关于RocketMQ的相关概念，请参考RocketMQ基本概念。 RocketMQ实例创建时，如果消费者客户端与生产者客户端无需通过密文传输，那么您可以关闭SSL。此时连接RocketMQ实例生产和消费消息的操作请参见使用客户端连接RocketMQ（关闭SSL）。 如果您需要创建多个用户并为其赋予不同的Topic和消费组权限，以达到用户之间的权限隔离，那么您需要先开启ACL访问控制并配置ACL用户，具体操作请参考开启RocketMQ ACL访问和配置RocketMQ ACL用户。 如果您需要通过公网访问RocketMQ实例，请参见配置RocketMQ实例的公网访问。

步骤四：连接RocketMQ实例生产和消费消息 在ECS环境中进入“rocketmq-tutorial/bin”目录。 cd rocketmq-tutorial/bin 运行生产普通消息命令。 命令示例如下： JAVA_OPT=-Dtls.enable=true sh mqadmin sendMessage -n "10.xxx.xxx.89:8100;10.xxx.xxx.144:8100" -t Topic01 -p "hello rocketmq" 10.xxx.xxx.89:8100;10.xxx.xxx.144:8100：表示RocketMQ实例的“连接地址”，即11中记录的连接地址。 Topic01：表示RocketMQ实例下创建的Topic名称，即4中创建的Topic名称。 hello rocketmq：表示生产消息的内容。 运行消费普通消息命令。 命令示例如下： JAVA_OPT=-Dtls.enable=true sh mqadmin consumeMessage -n "10.xxx.xxx.89:8100;10.xxx.xxx.144:8100" -t Topic01 如上图中BODY显示的内容即为消费消息的内容。 如需停止消费使用Ctrl+C命令退出。

步骤三：创建Topic Topic，即消息主题，消息发送与接收的基本单元。创建RocketMQ实例成功后，需要手动创建Topic，然后才能进行生产消息和消费消息。 单击RocketMQ实例的名称，进入实例基本信息页面。 在左侧导航栏，单击“Topic管理”，进入“Topic管理”页面。 单击“创建Topic”，弹出“创建Topic”页面。 参考表7，填写Topic名称和配置信息。 表7 Topic参数说明 参数 说明 Topic名称 填写Topic的名称。此处配置为“Topic01”。 消息类型 选择消息的类型。此处选择“普通”。 描述 描述是对Topic的补充说明。此处不填写描述信息。 图8 创建Topic 配置完成后，单击“确定”，完成Topic的创建。

操作流程 图1 RocketMQ使用流程 准备工作。 在创建RocketMQ实例前，您需要完成注册华为云并实名认证、为账户充值、为用户添加操作权限、创建VPC和子网、创建安全组、创建弹性云服务器并配置环境的准备工作。 创建RocketMQ实例。 在创建实例时，您需要开启SSL、关闭ACL，并配置已创建的VPC和子网、安全组。 创建Topic。 在实例创建成功后，您需要创建Topic，用于发送与接收消息。 连接RocketMQ实例生产和消费消息。 使用客户端连接实例，并通过命令行生产消费消息。

按照不同的消费需求，创建不同的LogConsumerConfig 指定消费开始时间，不指定结束时间。 // 设置batchSize = 500，即每次拉取500条。 LogConsumerConfig config = new LogConsumerConfig("TEST_REGION_NAME", "TEST_PROJECT","TEST_ LOG _GROUP_ID","TEST_LOG_STREAM_ID","AC CES S_KEY_ID","ACCESS_KEY_SECRET","CONSUMER_GROUP_NAME", 1685444710000000000L, 500); // 如果需要按照日志组/日志流名称消费 LogConsumerConfig config = new LogConsumerConfig("TEST_REGION_NAME", "TEST_PROJECT","TEST_LOG_GROUP_NAME","TEST_LOG_STREAM_NAME", true ,"ACCESS_KEY_ID","ACCESS_KEY_SECRET","CONSUMER_GROUP_NAME", 1685444710000000000L, 500); 指定消费开始时间，且指定结束时间。 // 设置batchSize = 500，即每次拉取500条 LogConsumerConfig config = new LogConsumerConfig("TEST_REGION_NAME", "TEST_PROJECT","TEST_LOG_GROUP_ID","TEST_LOG_STREAM_ID","ACCESS_KEY_ID","ACCESS_KEY_SECRET","CONSUMER_GROUP_NAME",1685444710000000000L, 1685445470192043318L, 500); // 如果需要按照日志组/日志流名称消费 LogConsumerConfig config = new LogConsumerConfig("TEST_REGION_NAME", "TEST_PROJECT","TEST_LOG_GROUP_NAME","TEST_LOG_STREAM_NAME", true ,"ACCESS_KEY_ID","ACCESS_KEY_SECRET","CONSUMER_GROUP_NAME",1685444710000000000L, 1685445470192043318L, 500); 指定ConsumerPosition（BEGIN_CURSOR、END_CURSOR） // 指定 BEGIN_CURSOR 开始消费 LogConsumerConfig config = new LogConsumerConfig("TEST_REGION_NAME", "TEST_PROJECT","TEST_LOG_GROUP_ID","TEST_LOG_STREAM_ID", "ACCESS_KEY_ID","ACCESS_KEY_SECRET","CONSUMER_GROUP_NAME", ConsumerPosition.BEGIN_CURSOR); // 指定 END_CURSOR 开始消费 LogConsumerConfig config = new LogConsumerConfig("TEST_REGION_NAME", "TEST_PROJECT","TEST_LOG_GROUP_ID","TEST_LOG_STREAM_ID", "ACCESS_KEY_ID","ACCESS_KEY_SECRET","CONSUMER_GROUP_NAME", ConsumerPosition.END_CURSOR); 支持使用临时AK、SK、STS-Token消费数据（若使用临时STS-Token, 则AK、SK需要填写与STS-Token配套的临时AK、SK）。 创建STS-Token更新类DemoLogConsumerSTSToken.java （由于临时凭证会存在过期，为了不影响您的消费业务，需要实时更新临时凭证） import com.huaweicloud.lts.consumer.interfaces.ILogConsumerSTSToken; import com.huaweicloud.lts.producer.STSTokenConfig; public class DemoLogConsumerSTSToken implements ILogConsumerSTSToken { @Override // SDK会定期从此方法中获取临时AK, 临时SK, 临时securityToken. 如果临时认证信息有变化, 在此方法中实现即可 public STSTokenConfig getSTSTokenConfig() { String accessKeyId = ""; String accessKeySecret = ""; String securityToken = ""; return new STSTokenConfig(accessKeyId, accessKeySecret, securityToken); } } 创建LogConsumerConfig // 指定消费开始时间，不指定结束时间 LogConsumerConfig config = new LogConsumerConfig("TEST_REGION_NAME", "TEST_PROJECT","TEST_LOG_GROUP_ID","TEST_LOG_STREAM_ID", new DemoLogConsumerSTSToken("ACCESS_KEY_ID","ACCESS_KEY_SECRET","STS-TOKEN"), "CONSUMER_GROUP_NAME", 1685444710000000000L); // 指定消费开始时间，且指定结束时间 LogConsumerConfig config = new LogConsumerConfig("TEST_REGION_NAME", "TEST_PROJECT","TEST_LOG_GROUP_ID","TEST_LOG_STREAM_ID", new DemoLogConsumerSTSToken("ACCESS_KEY_ID","ACCESS_KEY_SECRET","STS-TOKEN"), "CONSUMER_GROUP_NAME", 1685444710000000000L, 1685445470192043318L); // 指定 BEGIN_CURSOR LogConsumerConfig config = new LogConsumerConfig("TEST_REGION_NAME", "TEST_PROJECT","TEST_LOG_GROUP_ID","TEST_LOG_STREAM_ID", new DemoLogConsumerSTSToken("ACCESS_KEY_ID","ACCESS_KEY_SECRET","STS-TOKEN"), "CONSUMER_GROUP_NAME", ConsumerPosition.BEGIN_CURSOR); // 指定 END_CURSOR LogConsumerConfig config = new LogConsumerConfig("TEST_REGION_NAME", "TEST_PROJECT","TEST_LOG_GROUP_ID","TEST_LOG_STREAM_ID", new DemoLogConsumerSTSToken("ACCESS_KEY_ID","ACCESS_KEY_SECRET","STS-TOKEN"), "CONSUMER_GROUP_NAME", ConsumerPosition.END_CURSOR); 开启跨云消费日志。此功能仅适用于开发调测，对于消费性能不做保障 LogConsumerConfig config = new LogConsumerConfig（....）; config.setEnableLocalTest(true); 开启消费历史数据。 LogConsumerConfig config = new LogConsumerConfig（....）; config.setHistoryQuery(true); 使用自定义IP消费日志 LogConsumerConfig config = new LogConsumerConfig（....）; config.setProxyIp("127.0.0.1:8102");

产品功能 API生命周期管理 包括API的创建、发布、下线和删除的完整生命周期管理功能。通过API生命周期管理功能，您可以快速、高效地开放成熟的业务能力。 云原生网关 API网关将流量入口和微服务治理能力融合，用一个网关去同时支持了k8s Ingress和Gateway API的功能，不仅大幅提升了性能，还简化了架构，降低了部署和运维成本。 便捷调试工具 API网关提供页面调试工具，您可以使用该工具添加HTTP头部参数与body体参数，对API进行调试，简化API开发，降低API的开发维护成本。 版本管理 API可以发布到不同的环境，如果您需要再次发布此API到之前已发布的环境，那么此次的发布版本将立即覆盖之前的版本。API网关支持查看API发布历史（如版本、发布说明、发布时间和发布环境），并支持回滚到任一API历史版本，以便满足业务灰度发布、版本升级、回滚等需求。 环境变量 环境变量是指在环境上创建可管理的一种变量，该变量固定在环境上。当API发布到不同环境时，发布过程中变量标识会被相应环境的变量值替换，API本身定义不变。通过创建环境变量，实现同一个API，在不同环境中调用不同的后端服务。 精细流量控制 针对不同的业务等级、用户等级，可实施API的请求频率、用户的请求频率、应用（凭据）的请求频率和源IP的请求频率的管控，用于保障后端服务的稳定运行。 针对API调用path、query、header等参数精细化配置不同的流量的限制。 流量控制的时间单位可以是秒、分钟、小时或天。 针对特殊的应用（凭据）和租户设置特殊的流控限制。 监控告警 提供实时、可视化的API监控，包括：API请求次数、API调用延迟和API错误信息，通过监控面板更清晰地了解API的调用情况，识别可能影响业务的潜在风险。 安全防护 域名 访问认证支持TLS1.1、TLS1.2防护，支持mTLS双向认证。 访问控制策略主要用来控制访问API的IP地址和账户，您可以通过设置IP地址或账户的黑白名单来拒绝/允许某个IP地址或账户访问API。 断路器策略是API网关在后端服务出现性能问题时保护系统的机制，支持通过熔断降级的方式保护后端服务。 身份认证策略支持通过AKSK、Token等多种方式进行服务认证，支持用户通过函数自定义API访问认证逻辑，支持对后端服务进行证书校验，支持签名密钥用于后端服务验证API网关的身份。 VPC通道（负载通道） 在API网关中创建VPC通道来访问VPC环境中的资源，并将部署在VPC中的后端服务开放为API。VPC通道具有负载均衡功能，可对接服务器、微服务注册中心，支持后端流量的均衡、灰度策略，从而实现后端服务的负载均衡。 模拟响应 API网关支持设置模拟的API后端响应，支持利用Mock响应支持熔断降级、重定向等场景。 API云商店 将华为云上创建的API通过华为云商店开放给合作伙伴及第三方开发者，从而实现业务能力变现。目前仅支持共享版API上架云商店。 HTTP2.0 API网关支持HTTP/2（超文本传输协议第2版）访问协议，通常称之HTTP2.0。拥有Binary Format二进制格式、MultiPlexing多路复用和Header压缩的能力，改进传输性能，实现低延迟和高吞吐量。 Binary Format二进制格式 HTTP1.x以文本的形式传输，而HTTP2.0将所有传输信息分割为更小的消息和帧，并对它们采用二进制格式编码。相对于字符串（文本）解析，二进制格式解析更方便且不易出错，提升传输性能。 MultiPlexing多路复用 在二进制格式的基础上，HTTP2.0不再依赖多个连接去实现并行处理、发送请求及响应。 同域名下所有通信都在单个连接上完成；每个连接可以承载任意数量的消息；消息由一个或多个帧组成，多个帧之间可以乱序发送，最后可以根据帧首部的流标识重新组合。从而实现低延迟，提升效率。 Header压缩 HTTP2.0使用encoder来减少需要传输的Header大小，客户端与服务端各自保存一份Header fields表，避免重复header传输，减少传输大小，实现高吞吐量。 由于HTTP2.0是强依赖网络稳定性的，建议用户在使用HTTP2.0时使用比较稳定的网络场景，而且客户端须支持HTTP2.0。 如果当前实例不支持HTTP2.0，请联系技术支持升级实例。 如需关闭HTTP2.0协议，在API网关控制台的“配置参数”页面中的“request_custom_config”参数下关闭HTTP/2协议即可。

APIG控制台功能依赖的角色或策略 表2 APIG控制台依赖服务的角色或策略 控制台功能 依赖服务 需配置角色/策略 导入CSE微服务 微服务引擎 CSE IAM 用户设置了APIG FullAccess权限后，需要增加CSE ReadOnlyAccess权限后才能导入CSE微服务。 对接 APM 应用 应用性能管理 APM IAM用户设置了APIG FullAccess权限后，需要增加以下权限点：“apm:apm2BusinessBusiness:list”，“apm:apm2Admin:create”，“apm:apm2Admin:update”，“apm:apm2Admin:delete”，“apm:apm2Admin:get”才能为APIG实例绑定APM应用列表。

API网关系统角色 默认情况下，管理员创建的IAM用户没有任何权限，需要将其加入用户组，并给用户组授予策略或角色，才能使得用户组中的用户获得对应的权限，这一过程称为授权。授权后，用户就可以基于被授予的权限对云服务进行操作。 API网关服务部署时通过物理区域划分，为项目级服务。授权时，“作用范围”需要选择“区域级项目”，然后在指定区域（如北京1）对应的项目（cn-north-1）中设置相关权限，并且该权限仅对此项目生效；如果在“所有项目”中设置权限，则该权限在所有区域项目中都生效。访问API网关服务时，需要先切换至授权区域。 权限根据授权精细程度分为角色和策略，策略是角色的升级版。 角色：IAM最初提供的一种根据用户的工作职能定义权限的粗粒度授权机制。该机制以服务为粒度，提供有限的服务相关角色用于授权。由于华为云各服务之间存在业务依赖关系，因此给用户授予角色时，可能需要一并授予依赖的其他角色，才能正确完成业务。角色并不能满足用户对精细化授权的要求，无法完全达到企业对权限最小化的安全管控要求。 策略：IAM最新提供的一种细粒度授权的能力，可以精确到具体服务的操作、资源以及请求条件等。基于策略的授权是一种更加灵活的授权方式，能够满足企业对权限最小化的安全管控要求。例如：针对API网关服务，管理员能够控制IAM用户进行指定的管理操作。权限策略以API接口为粒度进行权限拆分，API网关服务支持的API授权项请参见权限策略支持的授权项。 如表1所示，包括了API网关的所有系统角色和策略。 表1 API网关的系统角色或策略 系统角色/策略名称 描述 类别 依赖关系 APIG Administrator API网关服务的管理员权限。拥有该权限的用户可以使用专享版和共享版API网关服务的所有功能。 系统角色 如果在操作过程中涉及其他服务资源的创建、删除、变更等，则还需要在同项目中勾选对应服务的Administrator权限。 APIG FullAccess API网关服务所有权限。拥有该权限的用户可以使用专享版API网关服务的所有功能。 系统策略 无。 APIG ReadOnlyAccess API网关服务的只读访问权限。拥有该权限的用户只能查看专享版API网关服务的各类信息。 系统策略 无。 以上系统角色或策略的具体权限内容，可以从IAM服务控制台查看。例如APIG FullAccess的策略内容为： { "Version": "1.1", "Statement": [ { "Action": [ "apig:*:*", "vpc:*:get*", "vpc:*:list*", "vpc:ports:create", "vpc:ports:update", "vpc:ports:delete", "vpc:publicIps:update", "FunctionGraph:function:listVersion", "FunctionGraph:function:list", "FunctionGraph:function:getConfig", "ecs:servers:list", "lts:groups:list", "lts:logs:list", "lts:topics:list" ], "Effect": "Allow" } ] }

SDK列表 提供了API网关支持的SDK列表，您可以在GitHub仓库查看SDK更新历史、获取安装包以及查看指导文档。查看接口请参考“ApigClient”/“apig_client”文件。 在开始使用之前，请确保您安装的是最新版本的SDK。使用过时的版本可能会导致兼容性问题或无法使用最新功能。您可以在 SDK中心 查询版本信息。 如果无法正常打开GitHub仓库，请检查您所使用的网络是否可以正常访问公网。由于GitHub的服务器部署在国外，国内用户访问时容易遇到无法打开的情况，请切换网络后再尝试打开。 表1 SDK列表 编程语言 Github地址 Reference Java huaweicloud-sdk-java-v3 Java SDK使用指导 Python huaweicloud-sdk-python-v3 Python SDK使用指导 Go huaweicloud-sdk-go-v3 Go SDK使用指导 PHP huaweicloud-sdk-php-v3 PHP SDK使用指导 Node.js huaweicloud-sdk-nodejs-v3 Nodejs SDK使用指导

为私有依赖库聚合仓添加代理 已创建聚合仓，可参考新建私有依赖库。 进入私有依赖库，在左侧边栏中选择对应聚合仓的仓库名称。 单击页面右侧“代理设置”。 单击“添加代理”，选择“公开源”或“自定义源”。 用户可以在“自定义源”中选择“第三方仓库”或“华为本地仓库”两种代理类型。 第三方仓库（设置第三方仓库或者由用户自行创建的仓库为代理源）： 用户选择第三方仓库后，单击“代理名称”的下拉列表，在下拉列表中选择自定义代理源。新建自定义代理源请参考自定义代理源。 华为本地仓库（设置华为本地仓库为代理源，用户只能选择自己作为仓库管理员的本地仓库） 用户在镜像仓名称的下拉列表中，可以选择私有依赖库中的本地仓库。 单击“确定”，完成添加代理。 单击操作列中的，可以修改镜像仓名称、代理账号、代理密码。用户无法编辑华为本地仓库的代理源。 单击操作列中的，可以删除对应的代理。

不同格式的本地仓库其他参数说明 除了公共配置信息外，每种格式仓库对应了不同的配置项，详情如表2所示。 表2 不同格式仓库其他参数说明 仓库格式 参数名 是否必填项 说明 Maven 关联项目 是 在下拉列表选择需要关联的项目名称。 路径包含规则 否 输入需要添加的路径，单击“+”可添加多条。例如添加demo，即demo/**/*，从demo的二级目录开始算且不含demo。 使用时，只有匹配了路径包含规则的制品允许上传。默认所有制品路径都被允许。 构建时，只允许以该路径开头的Maven文件上传到私有库。 路径排除规则 否 输入需要添加的路径，单击“+”可添加多条。 例如添加demo，即demo/**/*，从demo的二级目录开始算且不含demo。 构建时，不允许以该路径开头的Maven文件上传到私有库。 版本策略 是 包括“Release”与“Snapshot”两个选项。 系统提供“Release”和“Snapshot”两个仓库，默认勾选“Release”仓库；也可以根据自己团队的需求，勾选生成一个“Snapshot”仓库。 NPM 路径包含规则 否 输入需要添加的路径，单击“+”可添加多条。例如添加demo，即demo/**/*，从demo的二级目录开始算且不含demo。 构建时，只允许以该路径开头的NPM文件上传到私有库。 路径排除规则 否 输入需要添加的路径，单击“+”可添加多条。 构建时，不允许以该路径开头的npm文件上传到私有库。 RPM 路径包含规则 否 输入需要添加的路径，单击“+”可添加多条。例如添加demo，即demo/**/*，从demo的二级目录开始算且不含demo。 构建时，只允许以该路径开头的RPM二进制文件上传到私有库。 路径排除规则 否 输入需要添加的路径，单击“+”可添加多条。 构建时，不允许以该路径开头的RPM二进制文件上传到私有库。 PyPI 路径包含规则 否 输入需要添加的路径，单击“+”可添加多条。例如添加demo，即demo/**/*，从demo的二级目录开始算且不含demo。 构建时，只允许在“setup.py”文件中的“name”值与添加的路径匹配的PyPI依赖包上传到私有库。 路径排除规则 否 输入需要添加的路径，单击“+”可添加多条。 构建时，不允许在“setup.py”文件中的“name”值与添加的路径匹配的PyPI依赖包上传到私有库。 Go 路径包含规则 否 输入需要添加的路径，单击“+”可添加多条。例如添加demo，即demo/**/*，从demo的二级目录开始算且不含demo。 构建时，只允许以该路径开头的go文件上传到私有库。 路径排除规则 否 输入需要添加的路径，单击“+”可添加多条。 构建时，不允许以该路径开头的go文件上传到私有库。 Conan 路径包含规则 否 输入需要添加的路径，单击“+”可添加多条。例如添加demo，即demo/**/*，从demo的二级目录开始算且不含demo。 构建时，只允许以该路径开头的Conan类型文件上传到私有库。 路径排除规则 否 输入需要添加的路径，单击“+”可添加多条。 不允许在本地客户端上传以该路径开头的Conan文件到私有库。 NuGet 路径包含规则 否 输入需要添加的路径，单击“+”可添加多条。例如添加demo，即demo/**/*，从demo的二级目录开始算且不含demo。 构建时，只允许以该路径开头的NuGet类型文件上传到私有库。 路径排除规则 否 输入需要添加的路径，单击“+”可添加多条。 不允许在本地客户端上传以该路径开头的NuGet文件到私有库。 CocoaPods 路径包含规则 否 输入需要添加的路径，单击“+”可添加多条。例如添加demo，即demo/**/*，从demo的二级目录开始算且不含demo。 构建时，只允许以该路径开头的CocoaPods类型文件上传到私有库。 路径排除规则 否 输入需要添加的路径，单击“+”可添加多条。 构建时，不允许以该路径开头的cocoapods文件上传到私有库。 Generic 路径包含规则 否 输入需要添加的路径，单击“+”可添加多条。例如添加demo，即demo/**/*，从demo的二级目录开始算且不含demo。 构建时，只允许以该路径开头的Generic文件推送到私有库。 路径排除规则 否 输入需要添加的路径，单击“+”可添加多条。 构建时，不允许以该Generic文件的文件推送到私有库。 OHPM 路径包含规则 否 输入需要添加的路径，单击“+”可添加多条。例如添加demo，即demo/**/*，从demo的二级目录开始算且不含demo。 构建时，只允许以该路径开头的OHPM文件推送到私有库。 路径排除规则 否 输入需要添加的路径，单击“+”可添加多条。 构建时，不允许以该OHPM文件的文件推送到私有库。 原生-Docker 路径包含规则 否 输入需要添加的路径，单击“+”可添加多条。例如添加demo，即demo/**/*，从demo的二级目录开始算且不含demo。 构建时，只允许以该路径开头的镜像文件推送到私有库。 路径排除规则 否 输入需要添加的路径，单击“+”可添加多条。 镜像推送时，不允许以该路径开头的镜像文件推送到私有库。

设置昵称 当前用户只能给自己设置昵称，该昵称对所有项目成员可见。 在设置工作项处理人时，默认优先显示昵称，如果未设置昵称则显示用户名。 进入CodeArts首页。 登录CodeArts控制台，单击，选择区域。 单击“前往工作台”。 如果当前账号采用的是历史计费模式（详情请参见历史计费模式说明），则单击“立即使用”。 在导航栏中单击用户名，在弹框中单击用户名后的。 如果关闭了“设置个人昵称”开关（操作方法请参考昵称设置），则属于IAM用户无法设置昵称，显示为灰色。 在弹框中输入要设置的昵称（昵称长度不能超过30个字符），单击“确定”完成设置。 图1 设置昵称 刷新页面，页面右上角用户名处将显示新昵称。如果未显示请刷新页面。

设置 消息通知 规则 CodeArts消息通知有两种方式：浏览器桌面通知、邮件通知。 浏览器桌面通知：消息通知将发送至PC端桌面，内容包括代码检查、编译构建、部署、流水线任务的执行结果。 邮件通知：根据各服务通知设置，CodeArts将发送消息通知至的对应成员的邮箱中。 通过“消息设置”页面，可以配置当前用户是否接收CodeArts各服务消息通知。 进入CodeArts首页。 登录CodeArts控制台，单击，选择区域。 单击“前往工作台”。 如果当前账号采用的是历史计费模式（详情请参见历史计费模式说明），则单击“立即使用”。 在导航栏中单击用户名，选择“个人设置”。 页面默认跳转至“消息设置”页面，根据需要可以完成以下配置。 表1 设置消息通知规则 操作 说明 设置勿扰时间 根据需要单击“勿扰时段设置”开关。 如果需要修改勿扰时段，单击“更改设置”，根据需要在弹框中设置开始时间与结束时间，单击“确定”。设置成功后，页面中将显示更新后的时段。 开启/关闭通知 根据需要勾选“开启”或“关闭”。 如果需要修改接收消息通知的邮箱，单击邮箱后的“更改设置”，根据页面提示修改邮箱地址。

购买并配置云容器引擎 本节中使用的是云容器引擎CCE。 通过控制台可购买CCE集群。 其中集群及节点的必要配置建议参照表1与表2，表中未涉及的可根据实际情况选择。 表1 CCE集群购买配置 配置分类 配置项 配置建议 基础配置 集群类型 选择“CCE Standard 集群”。 计费模式 选择“按需计费”。 集群名称 输入自定义名称。 集群版本 根据需要选择，建议选择最新版本。 网络配置 容器网络模型 选择“容器隧道网络”。 虚拟私有云 选择已有的虚拟私有云，如果列表中没有合适的选项，单击“新建虚拟私有云”完成创建。 默认节点子网 选择已有的子网，如果列表中没有合适的选项，单击“新建子网”完成创建。 容器网段 勾选“自动设置网段”。 表2 节点配置 配置分类 配置项 配置建议 节点配置 计费模式 选择“按需计费”。 节点类型 选择“弹性云服务器-虚拟机”。 节点规格 选择2vCPUs 8GiB及以上规格即可。 操作系统 选择公共镜像中的Euler镜像。 节点名称 输入自定义名称 。 登录方式 选择“密码”。 密码 输入自定义密码 。 网络配置 节点IP 选择“自动分配”。 弹性公网IP 选择“自动创建”。

方案架构 系统升级时，开发人员第一次部署应用会创建出一组灰度负载，此时灰度负载中的系统版本为新版本，此时Service将部分流量转发至灰度负载上，由测试人员在灰度负载中进行版本验证。版本验证结束后，开发人员开始第二次部署应用升级现网服务，此时Service将全部流量转发至灰度负载上并升级现网服务，现网服务升级到最新版本后，Service将全部流量转发回现网负载并释放灰度负载，完成新系统的发布。 图1 灰度发布原理

前提条件 已有可用项目，如果没有，请先新建 CodeArts 项目。 具有创建应用的权限，参考权限管理。 服务包含以下资源，并定义为v1版本： 已有CCE集群，示例：cce-demo； CCE集群中已创建无状态工作负载，示例：deployment-doc； CCE集群中已创建服务，示例：service-doc； CCE集群中已创建路由，示例：ingress-doc； CCE集群中已安装nginx-ingress插件。

安装Nginx 添加该应用步骤可以在主机上安装Nginx，信息配置如下所示。 表1 参数说明 参数项 说明 步骤显示名称 步骤添加后在部署步骤显示的名称。仅支持汉字、英文字母、数字、空格、或-_,;:./()（）符号，其中空格不可在名称开头或结尾使用，长度为1-128。 环境 选择当前资源类型为主机集群的环境，作为部署对象。 Nginx版本 Nginx的版本。 Nginx安装路径 Nginx的安装路径。 控制选项 配置是否启用该操作。 失败后继续运行：当前步骤部署失败后，应用是否继续部署后续的步骤。 使用sudo权限执行：配置是否使用sudo权限部署该步骤。 若在部署过程中遇到问题，可参考该步骤的常见问题解决办法。 父主题： 配置CodeArts Deploy应用的软件安装类部署步骤

编辑应用基本信息 选择目标应用，单击图标，单击“编辑”，进入“部署步骤”页面。 单击“基本信息”，切换到“基本信息”页面，可根据需要对名称、描述、执行主机等信息进行修改。 表1 参数说明 参数项 说明 名称 必填。应用的名称。 所属项目 默认。该应用的归属项目。如果账号下没有项目请您在项目选择框中选择“新建项目”会先弹出“新建项目”页面，这时建立的项目是Scrum。 描述 可选。对应用的描述。 执行主机 可选。资源池是部署软件包时执行部署命令的物理环境的集合，您可以使用华为云托管的官方资源池，您也可以将自有的服务器作为自托管资源池托管到华为云，托管方式请参考自托管资源池场景。 注意：如果租户账号已配置“全内网安全访问”功能（仅限白名单用户使用），则“执行主机”功能默认选择“自托管资源池”且不可更改。 来自流水线 可选。开启后，只能通过流水线驱动执行，不能单独执行。 修改完所有信息，单击“保存”，保存该应用。

配置防火墙 检查机器的防火墙配置，配置防火墙允许SSH协议端口被访问，否则会导致连通性验证失败，以下详细介绍不同操作系统的防火墙配置方式。 Linux防火墙配置方式 表1 Linux防火墙配置方式 操作系统系列 配置方式 CentOS/EulerOS系列/UnionTechOS 查看本机是否安装SSH软件包。 rpm -qa | grep ssh 若回显内容中包含openssh-server，则说明已安装。 如果没有SSH软件包，执行以下命令。 yum install openssh-server 开启SSH服务。 service sshd start 打开sshd的配置文件。 vi /etc/ssh/sshd_config 去除监听端口前的注释。 重启SSH服务。 sudo service sshd restart 查看是否开放22端口。 netstat -ntpl | grep 22 说明： 如果您对整体部署过程的安全性有较高的要求，不能面向全IP开放以上端口，可配置访问IP白名单。 在sshd_config文件末尾添加以下命令，并保存: AllowUsers {User}@{IP} 执行命令重启SSH服务： sudo service sshd restart 其中User为自有主机白名单用户名，IP为白名单IP，白名单需包含CodeArts的IP网段。 全部区域（Region）： 中国站： 49.4.3.11 139.159.226.153 以上IP地址均为部署服务官方资源池对外开放IP，用于与目标主机、代理主机通信。 Debian系列 以root身份登录系统，安装ufw。 apt install ufw 开放22端口。 ufw allow 22/tcp 查看是否开放22端口。 ufw status 若ufw状态为inactive，则执行以下命令启动ufw ufw enable 说明： 如果您对整体部署过程的安全性有较高的要求，不能面向全IP开放以上端口，可配置访问IP白名单。 执行以下命令，添加ip白名单: ufw allow from {IP} to any port 22 其中IP为白名单IP，白名单需包含CodeArts的IP网段。 查看ufw的规则列表： ufw status numbered 禁用SSH连接规则（将源Ip为Anywhere的规则禁用，达到白名单限制目的）： ufw delete {Number} 其中Number为待禁用规则编号 全部区域（Region）： 中国站： 49.4.3.11 139.159.226.153 以上IP地址均为部署服务官方资源池对外开放IP，用于与目标主机、代理主机通信。 Ubuntu系列 查看本机IP。 ifconfig 查看22端口是否被占用。 netstat -nltp|grep 22 若无端口进程，依次执行以下命令。 sudo apt-get install openssh-server sudo apt-get install ufw sudo ufw enable sudo ufw allow 22 说明： 如果您对整体部署过程的安全性有较高的要求，不能面向全IP开放以上端口，可配置访问IP白名单。 执行以下命令，添加ip白名单: sudo ufw allow from {IP} to any port 22 其中IP为白名单IP，白名单需包含CodeArts的IP网段。 查看ufw的规则列表： ufw status numbered 禁用SSH连接规则（将源Ip为Anywhere的规则禁用，达到白名单限制目的）： ufw delete {Number} 其中Number为待禁用规则编号 全部区域（Region）： 中国站： 49.4.3.11 139.159.226.153 以上IP地址均为部署服务官方资源池对外开放IP，用于与目标主机、代理主机通信。 Windows防火墙配置方式 本节操作以Windows2012操作系统为例。 在Windows目标主机的控制面板中选择“Windows 防火墙设置”。 选择“高级设置”。 选择“入站规则”。 选择“新建规则”。 规则类型选择“端口”，然后单击“下一步”。 协议和端口分别勾选“TCP”和“特定本地端口”，端口号设置为5986，然后单击“下一步”。 操作选择“允许连接”，然后单击“下一步”。 配置文件选择全部，然后单击“下一步”。 最后，输入规则名称，单击“完成”。到此步骤，您已经完成对目标主机的防火墙配置。 如果您需要通过代理主机连接目标主机，则需要重复步骤1~9对代理主机进行同样的防火墙配置。并按照步骤4添加代理机监听端口的入站规则，如54端口。 如果您对整体部署过程的安全性有较高的要求，不能面向全IP开放以上端口，可在目标主机上配置访问IP白名单。（可选步骤） 在Windows主机的控制面板中选择“Windows 防火墙设置”。 选择“高级设置”。 选择“入站规则”。 选择“新建规则”。 规则类型选择“自定义”，然后单击“下一步”。 程序选择所有程序，然后单击“下一步”。 协议类型和本地端口分别勾选“TCP”和“特定本地端口”，端口号设置为5986，然后单击“下一步”。 作用域设置中，此规则应用于任何本地IP地址，远程IP地址选择”下列IP地址”，添加白名单地址，然后单击“下一步”。 操作选择“允许连接”，然后单击“下一步”。 配置文件选择全部，然后单击“下一步”。 最后，输入规则名称，单击“完成”。到此步骤，您已经完成对目标主机的IP访问白名单配置。 如果您需要通过代理主机连接目标主机，则需要重复a~k在代理主机上进行同样的IP访问白名单配置。并添加代理机监听端口的入站规则，如54端口。

前置准备 已有目标主机或代理主机，若需要申请可参考申请弹性云主机（可选）。过程中可能产生费用，详情可参考ECS计费说明。 已有弹性公网IP，在申请ECS的过程中可同时申请EIP，若需要单独申请可参考申请EIP（可选）。 申请ECS后需要配置安全组，可参考配置安全组。 为确保主机连通性验证通过，您需要对机器进行以下配置操作： 若您的机器为刚申请的云主机，可参考配置安全组进行端口配置。 若您的机器为自有主机，可参考配置防火墙进行端口配置。

请求参数说明 参数名称 参数类型 是否必选 描述 bucketName str 必选 参数解释： 桶名。 约束限制： 桶的名字需全局唯一，不能与已有的任何桶名称重复，包括其他用户创建的桶。 桶命名规则如下： 3～63个字符，数字或字母开头，支持小写字母、数字、“-”、“.”。 禁止使用IP地址。 禁止以“-”或“.”开头及结尾。 禁止两个“.”相邻（如：“my..bucket”）。 禁止“.”和“-”相邻（如：“my-.bucket”和“my.-bucket”）。 同一用户在同一个区域多次创建同名桶不会报错，创建的桶属性以第一次请求为准。 默认取值： 无 extensionHeaders dict 可选 参数解释： 接口的拓展头域。 取值范围： 参考自定义头域。 默认取值： 无

返回结果说明 类型 说明 GetResult 参数解释： SDK公共结果对象。 表1 GetResult 参数名称 参数类型 描述 status int 参数解释： HTTP状态码。 取值范围： 状态码是一组从2xx（成功）到4xx或5xx（错误）的数字代码，状态码表示了请求响应的状态。完整的状态码列表请参见状态码。 默认取值： 无 reason str 参数解释： HTTP文本描述。 默认取值： 无 errorCode str 参数解释： OBS服务端错误码，当status参数小于300时为空。 默认取值： 无 errorMessage str 参数解释： OBS服务端错误描述，当status参数小于300时为空。 默认取值： 无 requestId str 参数解释： OBS服务端返回的请求ID。 默认取值： 无 indicator str 参数解释： OBS服务端返回的错误定位码。 默认取值： 无 hostId str 参数解释： 请求的服务端ID，当status参数小于300时为空。 默认取值： 无 resource str 参数解释： 发生错误时相关的桶或对象，当status参数小于300时为空。 默认取值： 无 header list 参数解释： 响应消息头列表，由多个元组构成。每个元组均包含两个元素，代表响应头的键值对。 默认取值： 无 body object 参数解释： 操作成功后的结果数据，当status大于300时为空。该值根据调用接口的不同而不同，参见“桶相关接口”章节和“对象相关接口”章节的详细描述。 默认取值： 无