华为云用户手册

URI GET /v1/{project_id}/test-suites 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID，获取方式请参见获取项目ID。 最小长度：0 最大长度：64 表2 Query参数 参数 是否必选 参数类型 描述 offset 否 Integer 查询偏移 最小值：0 最大值：2147483647 limit 否 Integer 查询数量 最小值：0 最大值：2147483647

响应参数 状态码： 200 表2 响应Body参数 参数 参数类型 描述 code String 响应码 最小长度：0 最大长度：1024 message String 响应消息 最小长度：0 最大长度：10240 test_case CaseInfoDetail object 用例详情 表3 CaseInfoDetail 参数 参数类型 描述 case_id Integer 用例ID 最小值：0 最大值：2147483647 name String 用例名称 最小长度：0 最大长度：1024 case_type Integer 用例类型（0：常规用例；） 最小值：0 最大值：2147483647 contents Array of Contents objects 用例脚本信息 数组长度：0 - 1024 for_loop_params Array of objects 旧版本逻辑控制器字段，当前已未使用 数组长度：0 - 10240 increase_setting Array of objects 梯度递增 数组长度：0 - 10240 stages Array of TestCaseStage objects 阶段信息 数组长度：0 - 1024 status Integer 状态，0：已删除；1：启用；2：禁用 最小值：0 最大值：2147483647 temp_id Integer 用例ID 最小值：0 最大值：2147483647 sort Integer 排序字段 directory_id Integer 用例所属目录ID（旧版接口可不传） 最小值：0 最大值：2147483647 setup_contents Array of Contents objects 前置步骤 user_replicas Integer 执行器个数 最小值：0 最大值：2147483647 collect_log_policy Integer 日志采集策略（0-请求模式；1-用例模式） 最小值：0 最大值：32 link_app_list Array of integers 关联全链路应用列表 case_info CaseDoc object 文本用例信息 表4 TestCaseStage 参数 参数类型 描述 operate_mode Integer 压力阶段模式，0：时长模式；1：次数模式 name String 阶段名称 time Integer 压测时长（单位：秒） start_time Integer 开始时间 end_time Integer 结束时间 issue_num Integer 最大并发数 count Integer 次数模式发送总次数 pressure_mode Integer 压力模式，0：并发模式；1：TPS模式；2：摸高模式；3：浪涌并发模式；4：浪涌TPS模式；5：震荡并发模式；6：震荡TPS模式；7：智能摸高模式 tps_value Integer TPS模式下TPS值 current_user_num Integer 起始并发数 current_tps Integer 起始TPS值 voltage_regulating_mode Integer 调压模式，0：自动调压模式；1：手动调压模式 maximum Integer 浪涌/浪涌模式下最大并发数 minimum Integer 浪涌/浪涌模式下最小并发数 loop_count Integer 震荡/浪涌次数 max_duration Integer 浪涌模式下峰值持续时间 ramp_up Integer 摸高模式下爬坡时长（单位：秒） peak_load_kpis StageKpiItems object 摸高指标 step_duration Integer 智能摸高模式下单步执行时长 step_size Integer 智能摸高模式下递增并发数 表5 StageKpiItems 参数 参数类型 描述 average_response_time StageKpiItem object 平均响应时间 success_rate StageKpiItem object 成功率 表6 StageKpiItem 参数 参数类型 描述 comparison String 比较符 value Integer 比较值 表7 Contents 参数 参数类型 描述 content_id Integer 事务ID，若不为0表示此卡片为事务；为0表示非事务 最小值：0 最大值：2147483647 content Array of Content objects 内容 数组长度：0 - 1000 index Integer 排序索引标识 最小值：0 最大值：2147483647 selected_temp_name String 选择的事务或者用例名称 最小长度：0 最大长度：40960 data Object 数据（循环、条件控制器作用的数据） data_type Integer 数据指令类型（0：默认请求卡片；1：数据指令；201：循环指令；202：条件指令；301：集合点；203：vu百分比控制器；204：吞吐量控制器；302：插件请求） 最小值：0 最大值：2147483647 conditions Object 若类型为202：条件指令，该字段为条件配置 is_disabled Boolean 是否禁用 表8 Content 参数 参数类型 描述 content_type Integer 用例卡片类型（1：思考时间；2：报文；3：检查点；4：变量提取） 最小值：0 最大值：2147483647 content ContentInfo object 内容 表9 ContentInfo 参数 参数类型 描述 body_type Integer body类型（0：字符串；1：form-data格式；3：x-www-form-urlencoded格式） 最小值：0 最大值：2147483647 bodys Array of objects bodys check_end_length Object TCP/UDP协议返回数据长度 check_end_str Object TCP/UDP协议返回结束符 check_end_type Object TCP/UDP协议返回结束类型，1：返回数据长度；2：结束符 connect_timeout Integer 超时时间 最小值：0 最大值：2147483647 connect_type Integer 连接设置，当前版本已未使用 最小值：0 最大值：2147483647 headers Array of ContentHeader objects 请求头 数组长度：0 - 1024 http_version String HTTP版本 最小长度：0 最大长度：1024 method String HTTP方法 最小长度：0 最大长度：1024 name String 用例名称 最小长度：0 最大长度：1024 protocol_type Integer 协议类型（1：HTTP；2：HTTPS；3：TCP；4：UDP；7：HLS/RTMP；9：WebSocket；10：HTTP-FLV） 最小值：0 最大值：2147483647 return_timeout Integer 响应超时 最小值：0 最大值：2147483647 return_timeout_param String 响应超时参数 最小长度：0 最大长度：40960 url String 请求地址 最小长度：0 最大长度：40960 rtmp_url String rtmp地址 最小长度：0 最大长度：40960 flv_url String flv地址 最小长度：0 最大长度：40960 bitrate_type Integer 分辨率策略 最小值：0 最大值：128 duration Integer 持续时间 最小值：0 最大值：2147483647 retry_delay Integer HLS重试延迟时间 最小值：0 最大值：2147483647 retry_time Integer HLS重试次数 最小值：0 最大值：2147483647 表10 ContentHeader 参数 参数类型 描述 key String 键 最小长度：0 最大长度：40960 value String 值 最小长度：0 最大长度：40960 表11 CaseDoc 参数 参数类型 描述 description String 用例描述信息 最小长度：0 最大长度：2147483647 label_names Array of strings 标签 preparation String 前置条件 最小长度：0 最大长度：2147483647 rank Integer 用例等级（0-L0；1-L1；2-L2；3-L3；4-L4；） 最小值：0 最大值：64 status_code Integer 状态（0-新建；5-设计中；6-测试中；7-完成；） steps Array of steps objects 测试步骤 表12 steps 参数 参数类型 描述 expect_result String 步骤描述 最小长度：0 最大长度：2147483647 test_step String 预期结果 最小长度：0 最大长度：2147483647

响应参数 状态码： 200 表2 响应Body参数 参数 参数类型 描述 code String 响应码 最小长度：0 最大长度：1024 message String 响应消息 最小长度：0 最大长度：1024 taskInfo TaskInfo object 任务详情 表3 TaskInfo 参数 参数类型 描述 bench_concurrent Integer 基准并发 最小值：0 最大值：2147483647 case_list Array of CaseInfoDetail objects 用例ID列表 数组长度：0 - 1000 create_time String 创建时间 description String 描述信息 最小长度：0 最大长度：1024 name String 任务名称 最小长度：0 最大长度：1024 operate_mode Integer 任务模式（0：时长模式；1：次数模式；2：混合模式） 最小值：0 最大值：2147483647 project_id Integer 任务所属工程ID 最小值：0 最大值：2147483647 related_temp_running_data Array of RelatedTempRunningData objects 最近一次运行的报告简略信息，包括运行任务ID，即本对象的task_run_info_id。运行用例ID，即本对象的related_temp_running_id。 数组长度：0 - 1024 run_status Integer 任务运行状态（9：等待运行；0：运行中；1：暂停；2：结束； 3：异常中止；4：用户主动终止（完成状态）；5：用户主动终止） 最小值：0 最大值：2147483647 update_time String 任务更新时间 最小长度：0 最大长度：1024 parallel Boolean 任务间用例是否并行执行 表4 CaseInfoDetail 参数 参数类型 描述 case_id Integer 用例ID 最小值：0 最大值：2147483647 name String 用例名称 最小长度：0 最大长度：1024 case_type Integer 用例类型（0：常规用例；） 最小值：0 最大值：2147483647 contents Array of Contents objects 用例脚本信息 数组长度：0 - 1024 for_loop_params Array of objects 旧版本逻辑控制器字段，当前已未使用 数组长度：0 - 10240 increase_setting Array of objects 梯度递增 数组长度：0 - 10240 stages Array of TestCaseStage objects 阶段信息 数组长度：0 - 1024 status Integer 状态，0：已删除；1：启用；2：禁用 最小值：0 最大值：2147483647 temp_id Integer 用例ID 最小值：0 最大值：2147483647 sort Integer 排序字段 directory_id Integer 用例所属目录ID（旧版接口可不传） 最小值：0 最大值：2147483647 setup_contents Array of Contents objects 前置步骤 user_replicas Integer 执行器个数 最小值：0 最大值：2147483647 collect_log_policy Integer 日志采集策略（0-请求模式；1-用例模式） 最小值：0 最大值：32 link_app_list Array of integers 关联全链路应用列表 case_info CaseDoc object 文本用例信息 表5 TestCaseStage 参数 参数类型 描述 operate_mode Integer 压力阶段模式，0：时长模式；1：次数模式 name String 阶段名称 time Integer 压测时长（单位：秒） start_time Integer 开始时间 end_time Integer 结束时间 issue_num Integer 最大并发数 count Integer 次数模式发送总次数 pressure_mode Integer 压力模式，0：并发模式；1：TPS模式；2：摸高模式；3：浪涌并发模式；4：浪涌TPS模式；5：震荡并发模式；6：震荡TPS模式；7：智能摸高模式 tps_value Integer TPS模式下TPS值 current_user_num Integer 起始并发数 current_tps Integer 起始TPS值 voltage_regulating_mode Integer 调压模式，0：自动调压模式；1：手动调压模式 maximum Integer 浪涌/浪涌模式下最大并发数 minimum Integer 浪涌/浪涌模式下最小并发数 loop_count Integer 震荡/浪涌次数 max_duration Integer 浪涌模式下峰值持续时间 ramp_up Integer 摸高模式下爬坡时长（单位：秒） peak_load_kpis StageKpiItems object 摸高指标 step_duration Integer 智能摸高模式下单步执行时长 step_size Integer 智能摸高模式下递增并发数 表6 StageKpiItems 参数 参数类型 描述 average_response_time StageKpiItem object 平均响应时间 success_rate StageKpiItem object 成功率 表7 StageKpiItem 参数 参数类型 描述 comparison String 比较符 value Integer 比较值 表8 Contents 参数 参数类型 描述 content_id Integer 事务ID，若不为0表示此卡片为事务；为0表示非事务 最小值：0 最大值：2147483647 content Array of Content objects 内容 数组长度：0 - 1000 index Integer 排序索引标识 最小值：0 最大值：2147483647 selected_temp_name String 选择的事务或者用例名称 最小长度：0 最大长度：40960 data Object 数据（循环、条件控制器作用的数据） data_type Integer 数据指令类型（0：默认请求卡片；1：数据指令；201：循环指令；202：条件指令；301：集合点；203：vu百分比控制器；204：吞吐量控制器；302：插件请求） 最小值：0 最大值：2147483647 conditions Object 若类型为202：条件指令，该字段为条件配置 is_disabled Boolean 是否禁用 表9 Content 参数 参数类型 描述 content_type Integer 用例卡片类型（1：思考时间；2：报文；3：检查点；4：变量提取） 最小值：0 最大值：2147483647 content ContentInfo object 内容 表10 ContentInfo 参数 参数类型 描述 body_type Integer body类型（0：字符串；1：form-data格式；3：x-www-form-urlencoded格式） 最小值：0 最大值：2147483647 bodys Array of objects bodys check_end_length Object TCP/UDP协议返回数据长度 check_end_str Object TCP/UDP协议返回结束符 check_end_type Object TCP/UDP协议返回结束类型，1：返回数据长度；2：结束符 connect_timeout Integer 超时时间 最小值：0 最大值：2147483647 connect_type Integer 连接设置，当前版本已未使用 最小值：0 最大值：2147483647 headers Array of ContentHeader objects 请求头 数组长度：0 - 1024 http_version String HTTP版本 最小长度：0 最大长度：1024 method String HTTP方法 最小长度：0 最大长度：1024 name String 用例名称 最小长度：0 最大长度：1024 protocol_type Integer 协议类型（1：HTTP；2：HTTPS；3：TCP；4：UDP；7：HLS/RTMP；9：WebSocket；10：HTTP-FLV） 最小值：0 最大值：2147483647 return_timeout Integer 响应超时 最小值：0 最大值：2147483647 return_timeout_param String 响应超时参数 最小长度：0 最大长度：40960 url String 请求地址 最小长度：0 最大长度：40960 rtmp_url String rtmp地址 最小长度：0 最大长度：40960 flv_url String flv地址 最小长度：0 最大长度：40960 bitrate_type Integer 分辨率策略 最小值：0 最大值：128 duration Integer 持续时间 最小值：0 最大值：2147483647 retry_delay Integer HLS重试延迟时间 最小值：0 最大值：2147483647 retry_time Integer HLS重试次数 最小值：0 最大值：2147483647 表11 ContentHeader 参数 参数类型 描述 key String 键 最小长度：0 最大长度：40960 value String 值 最小长度：0 最大长度：40960 表12 CaseDoc 参数 参数类型 描述 description String 用例描述信息 最小长度：0 最大长度：2147483647 label_names Array of strings 标签 preparation String 前置条件 最小长度：0 最大长度：2147483647 rank Integer 用例等级（0-L0；1-L1；2-L2；3-L3；4-L4；） 最小值：0 最大值：64 status_code Integer 状态（0-新建；5-设计中；6-测试中；7-完成；） steps Array of steps objects 测试步骤 表13 steps 参数 参数类型 描述 expect_result String 步骤描述 最小长度：0 最大长度：2147483647 test_step String 预期结果 最小长度：0 最大长度：2147483647 表14 RelatedTempRunningData 参数 参数类型 描述 task_run_info_id Integer 运行任务ID，即报告ID。启动任务（更新任务状态或批量启停任务）接口，会返回运行任务ID。 最小值：0 最大值：2147483647 related_temp_running_id Integer 运行用例ID。对应其他（如报告）接口的运行用例ID（case_run_id）。 最小值：0 最大值：2147483647 temp_id Integer 用例ID 最小值：0 最大值：2147483647 temp_name String 用例名称 最小长度：0 最大长度：4096 content_method_url Array of strings 请求信息，包括请求名称、方法、URL信息 related_temp_running_data Array of TempRunningData objects 最近一次运行的报告简略信息 表15 TempRunningData 参数 参数类型 描述 content_method_url Array of strings 请求信息，包括请求名称，方法，url信息 crawler_status Integer 请求运行状态（0：正常返回；1：解析失败； 2：比对失败； 3：响应超时；） related_temp_running_id Integer 运行用例ID。对应其他（如报告）接口的运行用例ID（case_run_id）。 task_run_info_id Integer 运行任务ID，即报告ID。启动任务（更新任务状态或批量启停任务）接口，会返回运行任务ID。 temp_id Integer 用例或者事务ID temp_name String 用例或者事务名称 temp_running_status Integer 运行状态（9：表示等待运行；0：表示运行中；2：表示结束；3：异常中止；4：用户主动终止（完成状态）；5：用户主动终止（终止中状态））

响应示例 状态码： 200 success { "code" : "SV CS TG.CPTS.0000000", "extend" : [ ], "message" : "success", "tasks" : [ { "bench_concurrent" : 100, "description" : "", "id" : 52631, "name" : "task1", "operate_mode" : 2, "parallel" : true, "task_run_info" : { "id" : 0, "run_type" : 0 }, "update_time" : "2022-01-05T11:16:08.415954+08:00" }, { "bench_concurrent" : 100, "description" : "", "id" : 52621, "name" : "task2", "operate_mode" : 2, "parallel" : true, "task_run_info" : { "id" : 0, "run_type" : 0 }, "update_time" : "2021-12-31T15:43:53.014385+08:00" } ] }

响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 code String 响应码 最小长度：0 最大长度：1024 extend Array of strings 扩展信息 最小长度：0 最大长度：1024 数组长度：0 - 1024 message String 响应消息 最小长度：0 最大长度：1024 tasks Array of Task objects 工程集详细信息 数组长度：0 - 1000 表4 Task 参数 参数类型 描述 bench_concurrent Integer 基准并发 最小值：0 最大值：2147483647 description String 描述信息 最小长度：0 最大长度：1024 id Integer 任务ID 最小值：0 最大值：2147483647 name String 任务名称 最小长度：0 最大长度：1024 operate_mode Integer 任务压测模式 最小值：0 最大值：2147483647 task_run_info TaskRunInfo object 任务运行信息 update_time String 更新时间 最小长度：0 最大长度：1024 parallel Boolean 任务间用例是否并行执行 表5 TaskRunInfo 参数 参数类型 描述 id Integer 任务ID 最小值：0 最大值：2147483647 run_type Integer 任务类型（0：旧版本任务；1：新版本任务） 最小值：0 最大值：2147483647

URI GET /v1/{project_id}/all-tasks/{test_suite_id} 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID，获取方式请参见获取项目ID。 最小长度：0 最大长度：64 test_suite_id 是 Integer 测试工程ID 最小值：0 最大值：2147483647 表2 Query参数 参数 是否必选 参数类型 描述 offset 否 Integer 查询偏移 最小值：0 最大值：2147483647 limit 否 Integer 查询数量 最小值：0 最大值：2147483647

请求参数 表2 请求Body参数 参数 是否必选 参数类型 描述 cluster_id 是 Integer 资源组ID 最小值：-1 最大值：2147483647 cluster_type 是 String 资源组类型（共享资源组：shared-cluster-internet；私有资源组：private-cluster） 最小长度：0 最大长度：1024 without_package 是 Integer 套餐包VUM不足的情况下用户选择是不是要走按需计费模式（当前版本固定值：0） 最小值：0 最大值：2147483647 network_info 是 NetworkInfo object 网络信息 status 是 Integer 状态（9：启动任务；2：停止任务） 最小值：0 最大值：2147483647 enterprise_project_id 否 String 企业项目ID 最小长度：0 最大长度：64 表3 NetworkInfo 参数 是否必选 参数类型 描述 network_type 是 String 网络类型（固定值：internet） 最小长度：0 最大长度：1024

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 code String 响应码 最小长度：0 最大长度：1024 message String 响应消息 最小长度：0 最大长度：1024 extend String 扩展信息 最小长度：0 最大长度：1024 result UpdateTaskStatusResult object 状态更新结果 表5 UpdateTaskStatusResult 参数 参数类型 描述 task_run_id Integer 运行任务ID，即报告ID 最小值：0 最大值：2147483647

请求示例 启动一个任务，任务的所属工程ID是1，任务的id是1，使用共享资源组启动。 /v1/{project_id}/test-suites/1/tasks/1 { "cluster_id" : 0, "enterprise_project_id" : "0", "cluster_type" : "shared-cluster-internet", "without_package" : 0, "network_info" : { "network_type" : "internet" }, "status" : 9 } 启动一个任务，任务的所属工程ID是1，任务的id是1。 /v1/{project_id}/test-suites/1/tasks/1 { "cluster_id" : -1, "enterprise_project_id" : "0", "cluster_type" : "shared-cluster-internet", "network_info" : { "network_type" : "internet" }, "status" : 2, "without_package" : 0 }

URI POST /v1/{project_id}/test-suites/{test_suite_id}/tasks/{task_id} 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID，获取方式请参见获取项目ID。 最小长度：0 最大长度：64 test_suite_id 是 Integer 测试工程ID 最小值：0 最大值：2147483647 task_id 是 Integer 任务ID 最小值：0 最大值：2147483647

响应参数 状态码： 200 表2 响应Body参数 参数 参数类型 描述 code String 状态码 message String 描述 directory Array of ProjectDirectory objects 用例集 表3 ProjectDirectory 参数 参数类型 描述 id Integer id name String 名称 status Integer 状态（0：已删除，1：启用，2：停用） create_time String 创建时间 update_time String 更新时间 parent_id Integer 父ID type Integer 类型（1：目录，2：用例）

响应示例 状态码： 200 success { "code" : "SVCSTG.CPTS.0000000", "directory" : [ { "id" : 57667, "name" : "directory1", "status" : 1, "create_time" : "2022-09-02T11:12:04.308643+08:00", "update_time" : "2022-09-02T11:12:04.315547+08:00", "parent_id" : 0, "type" : 1 } ], "message" : "success" }

请求参数 表2 请求Body参数 参数 是否必选 参数类型 描述 app_id 是 Integer 应用ID 最小值：1 最大值：2147483647 address 是 String 探针的内网地址 最小长度：0 最大长度：1024 version 是 String 探针的版本 最小长度：0 最大长度：1024 agent_id 否 String 探针ID，非必填，不填是注册探针，填了是更新探针配置 最小长度：0 最大长度：1024 alias 否 String 探针别名 最小长度：0 最大长度：1024

响应示例 状态码： 200 success { "code" : "SVCSTG.CPTS.0000000", "message" : "success", "project" : { "create_time" : "2022-01-18T15:20:42.373585+08:00", "description" : "", "group" : "e061922ca2684c1e9c761df238826261", "id" : 122025, "name" : "工程名称", "source" : 0, "update_time" : "2022-01-20T14:11:21.719585+08:00" } }

响应参数 状态码： 200 表2 响应Body参数 参数 参数类型 描述 code String 响应码 最小长度：0 最大长度：1024 message String 响应消息 最小长度：0 最大长度：1024 project Project object 工程信息 表3 Project 参数 参数类型 描述 create_time String 创建时间 最小长度：0 最大长度：1024 description String 描述 最小长度：0 最大长度：1024 group String 租户ID（domain_id） 最小长度：0 最大长度：1024 id Integer 工程ID 最小值：0 最大值：2147483647 name String 工程名称 最小长度：0 最大长度：1024 source Integer 来源（0-PerfTest；2-CloudTest） 最小值：0 最大值：2147483647 update_time String 更新时间 最小长度：0 最大长度：1024

URI DELETE /v1/{project_id}/test-suites/{test_suite_id}/directory/{directory_id} 表1 路径参数 参数 是否必选 参数类型 描述 directory_id 是 Integer 目录ID 最小值：0 最大值：2147483647 project_id 是 String 项目ID，获取方式请参见获取项目ID。 最小长度：0 最大长度：64 test_suite_id 是 Integer 测试工程ID 最小值：0 最大值：2147483647

步骤五：配置DNS解析 全球加速实例配置完成后，需要配置DNS智能解析，实现海外用户解析到全球加速Anycast IP，国内用户仍解析到杭州自建IDC公网IP。 本文以配置华为云DNS解析为例，请按照以下步骤操作： 进入公网域名列表页面。 在“公网域名”页面的域名列表的“域名”列，单击域名的名称。 进入“解析记录”页面。 在页面右上角，单击“添加记录集”。 在“添加记录集”页面，根据界面提示为域名添加3条A类型记录集，详细请参见表5。 图7 设置记录集参数 表5 A类型记录集参数说明 参数 参数说明 主机记录 解析域名的前缀。 例如创建的域名为“example.com”，其“主机记录”设置包括： www：用于网站解析，表示解析的域名为“www.example.com”。 空：用于网站解析，表示解析的域名为“example.com”。 主机记录置为空，还可用于为空头域名“@”添加解析。 *：用于泛解析，表示解析的域名为“*.example.com”，匹配“example.com”的所有子域名。 类型 记录集的类型，此处选择A类型。 别名 用于是否将此记录集关联至云服务资源实例。 本实践中该参数保持默认配置。 别名记录 “别名”参数设置选择“是”时，该项必选。 用于设置记录集关联的华为云服务资源实例。 记录集支持关联的华为云服务资源实例包括：云速建站、 Web应用防火墙 。 本实践中该参数保持默认配置。 线路类型 解析的线路类型用于DNS服务器在解析域名时，根据访问者的来源，返回对应的服务器IP地址。 3个A类型记录集分别选择“全网默认”、“地域解析 ＞ 中国大陆”、“地域解析 ＞ 全球”。 TTL(秒) 解析记录在本地DNS服务器的缓存时间，以秒为单位。 默认值：300秒 取值范围为：1~2147483647 如果您的服务地址经常更换，建议TTL值设置相对小些，反之，建议设置相对大些。 本实践中该参数保持默认配置。 值 域名对应的IPv4地址。 本实践中需要根据不同线路类型的解析记录配置不同的值，具体如下： 全网默认、中国大陆线路类型：云下IDC的公网IP。 全球：全球加速实例分配的加速IP地址。 权重 可选参数，返回解析记录的权重比例。 默认值：1 取值范围：0~1000 本实践中该参数保持默认配置。 标签 可选参数，记录集的标识，包括键和值，每个记录集可以创建10个标签。 描述 可选参数，对域名的描述。 长度不超过255个字符。 单击“确定”。 返回“解析记录”页面。 添加完成后，您可以在域名对应的记录集列表中查看已添加的记录集(“中国大陆”，“全网默认”解析到杭州自建IDC公网IP，“全球”解析到全球加速服务Anycast IP地址)。当记录集的状态显示为“正常”时，表示记录集添加成功。

步骤三：配置监听器 创建全球加速实例后，您需要为全球加速实例配置监听器。监听器负责监听连接请求，并根据流量转发策略将请求流量分发至终端节点。 根据界面提示配置监听器的相关参数，详细请参见表3。 图6 添加监听器 表3 添加监听器 参数 说明 名称 监听器名称。 只能由中文、英文字母、数字、中划线组成。 长度范围：1-64个字符。 前端协议 客户端与监听器建立流量分发连接的协议。 取值范围：TCP、UDP。 前端端口 客户端与监听器建立流量分发连接的端口。 端口取值在1-65535之间，端口范围用“-”连接，多个端口或端口范围以逗号隔开。 例如：1-10，11-50，51，52-200 客户端亲和性 会话保持。 支持选择“关闭”或“按源IP保持会话”。 TCP和UDP协议仅支持“按源IP保持会话”。 按源IP保持会话：基于源IP地址的简单会话保持，将请求的源IP地址作为散列键（HashKey），从静态分配的散列表中找出对应的服务器。即来自同一IP地址的访问请求会被转发到同一台后端服务器上进行处理。 标签 监听器的标识，包括键和值。可以为监听器创建20个标签。 说明： 如果已经通过TMS的预定义标签功能预先创建了标签，则可以直接选择对应的标签键和值。 预定义标签的详细内容，请参见预定义标签简介。 如您的组织已经设定全球加速服务的相关标签策略，则需按照标签策略规则为监听器添加标签。标签如果不符合标签策略的规则，则可能会导致监听器创建失败，请联系组织管理员了解标签策略详情。 描述 监听器描述。 长度范围：不超过255个字符。

步骤四：配置终端节点组和终端节点 根据界面提示配置终端节点组和终端节点的相关参数，终端节点组区域选择“上海一”（上海一Region离客户杭州自建IDC距离最短）详细请参见表4。 表4 添加终端节点组和终端节点 类型 参数 说明 终端节点组 名称 终端节点组名称。 每个监听器下每个区域只允许关联一个终端节点组。 只能由中文、英文字母、数字、中划线组成。 长度范围：1-64个字符。 区域 终端节点组所属区域。 本实践选择“上海一” 描述 终端节点组描述。 长度范围：不超过255个字符。 流量调度 配置到不同终端节点组的流量比例。 如果增加流量调度比例，将有更多的请求分发到此终端节点组。 如果将流量调度比例设置为0，则不会将任何请求分发到此终端节点组。 取值范围为：[0-100]。 说明： 如果监听器中有多个终端节点组，分配流量时优先选择时延最低的终端节点组，并按照该终端节点组的流量调度值分配流量，然后再向其他终端节点组分配其余流量。 终端节点 终端节点充当客户端的接触点，加速实例跨正常运行的终端节点分发传入流量。 本实践中选择自定义IP或者自定义域名。 健康检查配置 是否开启 开启或者关闭健康检查。 关闭健康检查可能会导致业务请求转发至异常的后端服务器。 前端协议 健康检查目前支持选择TCP协议。 默认：TCP协议。 前端端口 健康检查端口号。 取值范围：[1，65535]。 高级配置 检查间隔(秒) 每次健康检查响应的最大间隔时间。 取值范围：[1-60]。 超时时间(秒) 每次健康检查响应的最大超时时间。 取值范围：[1-60]。 最大重复次数 健康检查最大的重试次数。 取值范围：[1-10]。

资源成本与规划 本节介绍最佳实践中资源规划情况，包含以下内容： 表1 云下IDC应用通过华为云全球加速优化用户访问的资源和成本规划 资源 资源说明 数量 费用 加速实例 按照每个全球加速实例的创建时长收费。 按小时计费，创建时长不满1小时按1小时收费。 实例费=实例单价*创建时长 1 请参见全球加速价格详情。 数据传输 通过全球加速服务转发的流量费用，按GB收费。 从一个全球加速接入点到一个应用部署区域之间的流量，定义流量大的方向为主方向，按照每条流量的主方向收费。 数据传输费=流量单价*使用量 根据实际转发的流量 公网解析记录 根据不同地区的用户添加如下3条A类型解析记录： 线路类型选择“全网默认”，解析记录值配置为云下IDC的公网IP。 线路类型选择“地域解析 ＞ 中国大陆”，解析记录值配置为云下IDC的公网IP。 线路类型选择“地域解析 ＞ 全球”，解析记录值配置为全球加速实例分配的加速IP地址。 3 免费

步骤一：跨境申请 根据中华人民共和国工业和信息化部（简称工信部）相关法律、行政法规规定，中国大陆只有三大运营商具备跨境业务运营资质。所以涉及跨中国大陆访问的业务场景，都需要通过跨境资质审核。 进入全球加速跨境申请管理界面。 在跨境申请管理页面，单击“跨境申请”。 进入中国联通跨境云服务在线申请页面。 图1 跨境申请 在跨境云服务在线申请页面，根据提示配置相关参数，并上传相关材料。 “华为云ID”指用户在华为云管理控制台的“账号ID”，从控制台获取账号ID的步骤如下： 登录管理控制台。 鼠标悬停在右上角的用户名，选择下拉列表中的“我的凭证”。 图2 我的凭证 在“API凭证”页面的项目列表中查看并获取账号ID。 图3 获取账号ID 单击“立即申请”。

方案概述 应用场景：客户网站服务器部署在中国大陆的非华为云数据中心杭州自建机房中，国内用户直接访问杭州IDC的公网IP，但是由于跨国公网不稳定、大陆跨境经常丢包等因素，通过华为云全球加速服务优化海外用户访问，实现访问加速。 方案架构：客户应用部署在杭州自建机房，域名已经通过DNS解析到杭州公网IP，并且已经完成备案对外提供Web服务，海外用户可以使用全球加速服务，全球用户访问就近接入华为云骨干网快速传输到华为云华东-上海一Region出公网到杭州自建IDC公网IP。

步骤二：购买全球加速实例 跨境资质申请完成后，购买全球加速实例。 登录全球加速控制台。 在全球加速页面，单击“购买全球加速服务”。 图4 购买全球加速实例 根据界面提示配置相关参数，加速地域选择中国大陆以外，详细请参见表2。 图5 创建全球实例 表2 创建全球加速实例 参数 说明 名称 用户将要创建的全球加速实例的名称。 只能由中文、英文字母、数字、中划线组成。 长度范围：1-64个字符。 企业项目 企业项目是一种云资源管理方式，企业项目管理服务提供统一的云资源按项目管理，以及项目内的资源管理、成员管理。 您可以使用已有企业项目，也可以新建企业项目。 加速区域 加速区域指需要进行访问加速的区域。 支持选择“中国大陆以外”或“中国大陆”，默认选择“中国大陆以外”。 本实践中请选择“中国大陆以外”。 标签 全球加速的标识，包括键和值。可以为全球加速实例创建20个标签。 说明： 如果已经通过TMS的预定义标签功能预先创建了标签，则可以直接选择对应的标签键和值。 预定义标签的详细内容，请参见预定义标签简介。 如您的组织已经设定全球加速服务的相关标签策略，则需按照标签策略规则为加速实例添加标签。标签如果不符合标签策略的规则，则可能会导致加速实例创建失败，请联系组织管理员了解标签策略详情。 描述 全球加速实例描述。 长度范围：不超过255个字符。 单击“下一步”，进入监听器配置页面。

步骤三：配置终端节点组和终端节点 根据界面提示配置终端节点组和终端节点的相关参数，本实践监听器需要创建两个终端节点组，一个地域选择“上海一”，另外一个地域选择“广州”，详细请参见表4。 表4 添加终端节点组和终端节点 类型 参数 说明 终端节点组 名称 终端节点组名称。 每个监听器下每个区域只允许关联一个终端节点组。 只能由中文、英文字母、数字、中划线组成。 长度范围：1-64个字符。 区域 终端节点组所属区域。 本实践监听器创建两个终端节点组，一个上海一，一个广州 描述 终端节点组描述。 长度范围：不超过255个字符。 流量调度 配置到不同终端节点组的流量比例。 如果增加流量调度比例，将有更多的请求分发到此终端节点组。 如果将流量调度比例设置为0，则不会将任何请求分发到此终端节点组。 取值范围为：[0-100]。 本实践监听器创建的两个终端节点组流量调度各取值100 说明： 如果监听器中有多个终端节点组，分配流量时优先选择时延最低的终端节点组，并按照该终端节点组的流量调度值分配流量，然后再向其他终端节点组分配其余流量。 终端节点 终端节点充当客户端的接触点，加速实例跨正常运行的终端节点分发传入流量。 本实践中需要创建两个终端节点组并分别配置终端节点，上海一终端节点选择自定义IP，输入上海自建IDC的公网IP。广州终端节点选择华为云EIP 健康检查配置 是否开启 开启或者关闭健康检查。 关闭健康检查可能会导致业务请求转发至异常的后端服务器。 前端协议 健康检查目前支持选择TCP协议。 默认：TCP协议。 前端端口 健康检查端口号。 取值范围：[1，65535]。 高级配置 检查间隔(秒) 每次健康检查响应的最大间隔时间。 取值范围：[1-60]。 超时时间(秒) 每次健康检查响应的最大超时时间。 取值范围：[1-60]。 最大重复次数 健康检查最大的重试次数。 取值范围：[1-10]。

步骤四：配置DNS解析 全球加速实例配置完成后，需要配置DNS解析到全球加速服务Anycast IP，实现域名高可靠容灾。 本文以配置华为云DNS解析为例，请按照以下步骤操作： 进入公网域名列表页面。 在“公网域名”页面的域名列表的“域名”列，单击域名的名称。 进入“解析记录”页面。 在页面右上角，单击“添加记录集”。 在“添加记录集”页面，根据界面提示为域名添加1条A类型记录集，详细请参见表5。 图4 设置记录集参数 表5 A类型记录集参数说明 参数 参数说明 主机记录 解析域名的前缀。 例如创建的域名为“example.com”，其“主机记录”设置包括： www：用于网站解析，表示解析的域名为“www.example.com”。 空：用于网站解析，表示解析的域名为“example.com”。 主机记录置为空，还可用于为空头域名“@”添加解析。 *：用于泛解析，表示解析的域名为“*.example.com”，匹配“example.com”的所有子域名。 类型 记录集的类型，此处选择A类型。 别名 用于是否将此记录集关联至云服务资源实例。 本实践中该参数保持默认配置。 别名记录 “别名”参数设置选择“是”时，该项必选。 用于设置记录集关联的华为云服务资源实例。 记录集支持关联的华为云服务资源实例包括：云速建站、Web应用防火墙。 本实践中该参数保持默认配置。 线路类型 解析的线路类型用于DNS服务器在解析域名时，根据访问者的来源，返回对应的服务器IP地址。 A类型记录集分别选择“全网默认”。 TTL(秒) 解析记录在本地DNS服务器的缓存时间，以秒为单位。 默认值：300秒 取值范围为：1~2147483647 如果您的服务地址经常更换，建议TTL值设置相对小些，反之，建议设置相对大些。 本实践中该参数保持默认配置。 值 域名对应的IPv4地址。 本实践中解析记录的值为全球加速实例分配的加速IP地址。 权重 可选参数，返回解析记录的权重比例。 默认值：1 取值范围：0~1000 本实践中该参数保持默认配置。 标签 可选参数，记录集的标识，包括键和值，每个记录集可以创建10个标签。 描述 可选参数，对域名的描述。 长度不超过255个字符。 单击“确定”。 返回“解析记录”页面。 添加完成后，您可以在域名对应的记录集列表中查看已添加的记录集。当记录集的状态显示为“正常”时，表示记录集添加成功。

资源成本与规划 本节介绍最佳实践中资源规划情况，包含以下内容： 表1 通过全球加速部署云上云下多活容灾的资源和成本规划 资源 资源说明 数量 费用 加速实例 按照每个全球加速实例的创建时长收费。 按小时计费，创建时长不满1小时按1小时收费。 实例费=实例单价*创建时长 1 请参见全球加速价格详情。 数据传输 通过全球加速服务转发的流量费用，按GB收费。 从一个全球加速接入点到一个应用部署区域之间的流量，定义流量大的方向为主方向，按照每条流量的主方向收费。 数据传输费=流量单价*使用量 根据实际转发的流量 公网解析记录 根据不同地区的用户添加1条A类型解析记录。 记录集选择“全网默认”，解析记录值配置为全球加速实例分配的加速IP地址。 1 免费

步骤一：购买全球加速实例 跨境资质申请完成后，购买全球加速实例。 登录全球加速控制台。 在全球加速页面，单击“购买全球加速服务”。 图1 购买全球加速实例 根据界面提示配置相关参数，详细请参见表2。 图2 创建全球实例 表2 创建全球加速实例 参数 说明 名称 用户将要创建的全球加速实例的名称。 只能由中文、英文字母、数字、中划线组成。 长度范围：1-64个字符。 企业项目 企业项目是一种云资源管理方式，企业项目管理服务提供统一的云资源按项目管理，以及项目内的资源管理、成员管理。 您可以使用已有企业项目，也可以新建企业项目。 加速区域 加速区域指需要进行访问加速的区域。 支持选择“中国大陆以外”或“中国大陆”，默认选择“中国大陆以外”。 本实践中请选择“中国大陆”。 标签 全球加速的标识，包括键和值。可以为全球加速实例创建20个标签。 说明： 如果已经通过TMS的预定义标签功能预先创建了标签，则可以直接选择对应的标签键和值。 预定义标签的详细内容，请参见预定义标签简介。 如您的组织已经设定全球加速服务的相关标签策略，则需按照标签策略规则为加速实例添加标签。标签如果不符合标签策略的规则，则可能会导致加速实例创建失败，请联系组织管理员了解标签策略详情。 描述 全球加速实例描述。 长度范围：不超过255个字符。 单击“下一步”，进入监听器配置页面。

步骤二：配置监听器 创建全球加速实例后，您需要为全球加速实例配置监听器。监听器负责监听连接请求，并根据流量转发策略将请求流量分发至终端节点。 根据界面提示配置监听器的相关参数，详细请参见表3。 图3 添加监听器 表3 添加监听器 参数 说明 名称 监听器名称。 只能由中文、英文字母、数字、中划线组成。 长度范围：1-64个字符。 前端协议 客户端与监听器建立流量分发连接的协议。 取值范围：TCP、UDP。 前端端口 客户端与监听器建立流量分发连接的端口。 端口取值在1-65535之间，端口范围用“-”连接，多个端口或端口范围以逗号隔开。 例如：1-10，11-50，51，52-200 客户端亲和性 会话保持。 支持选择“关闭”或“按源IP保持会话”。 TCP和UDP协议仅支持“按源IP保持会话”。 按源IP保持会话：基于源IP地址的简单会话保持，将请求的源IP地址作为散列键（HashKey），从静态分配的散列表中找出对应的服务器。即来自同一IP地址的访问请求会被转发到同一台后端服务器上进行处理。 标签 监听器的标识，包括键和值。可以为监听器创建20个标签。 说明： 如果已经通过TMS的预定义标签功能预先创建了标签，则可以直接选择对应的标签键和值。 预定义标签的详细内容，请参见预定义标签简介。 如您的组织已经设定全球加速服务的相关标签策略，则需按照标签策略规则为监听器添加标签。标签如果不符合标签策略的规则，则可能会导致监听器创建失败，请联系组织管理员了解标签策略详情。 描述 监听器描述。 长度范围：不超过255个字符。

步骤六：配置DNS解析 全球加速实例配置完成后，需要配置DNS解析，实现海外用户加速访问。 本文以配置华为云DNS解析为例，请按照以下步骤操作： 进入公网域名列表页面。 在“公网域名”页面的域名列表的“域名”列，单击域名的名称。 进入“解析记录”页面。 在页面右上角，单击“添加记录集”。 在“添加记录集”页面，根据界面提示为域名添加3条记录集，详细请参见表5。 图7 设置记录集参数 表5 记录集参数说明 参数 参数说明 主机记录 解析域名的前缀。 例如创建的域名为“example.com”，其“主机记录”设置包括： www：用于网站解析，表示解析的域名为“www.example.com”。 空：用于网站解析，表示解析的域名为“example.com”。 主机记录置为空，还可用于为空头域名“@”添加解析。 *：用于泛解析，表示解析的域名为“*.example.com”，匹配“example.com”的所有子域名。 类型 记录集的类型，此处选择A类型。 别名 用于是否将此记录集关联至云服务资源实例。 本实践中该参数保持默认配置。 别名记录 “别名”参数设置选择“是”时，该项必选。 用于设置记录集关联的华为云服务资源实例。 记录集支持关联的华为云服务资源实例包括：云速建站、Web应用防火墙。 本实践中该参数保持默认配置。 线路类型 解析的线路类型用于DNS服务器在解析域名时，根据访问者的来源，返回对应的服务器IP地址。 3个记录集分别选择“全网默认”、“地域解析 ＞ 中国大陆”、“地域解析 ＞ 全球”。 TTL(秒) 解析记录在本地DNS服务器的缓存时间，以秒为单位。 默认值：300秒 取值范围为：1~2147483647 如果您的服务地址经常更换，建议TTL值设置相对小些，反之，建议设置相对大些。 本实践中该参数保持默认配置。 值 域名对应的IPv4地址。 本实践中需要根据不同线路类型的解析记录配置不同的值，具体如下： 全网默认、中国大陆线路类型：国内公网IP地址。 全球：CDN服务的CNAME地址。 权重 可选参数，返回解析记录的权重比例。 默认值：1 取值范围：0~1000 本实践中该参数保持默认配置。 标签 可选参数，记录集的标识，包括键和值，每个记录集可以创建10个标签。 描述 可选参数，对域名的描述。 长度不超过255个字符。 单击“确定”。 返回“解析记录”页面。 添加完成后，您可以在域名对应的记录集列表中查看已添加的记录集(“中国大陆”，“全网默认”解析到上海一EIP，“全球”解析到CDN服务CNAME地址)。当记录集的状态显示为“正常”时，表示记录集添加成功。

步骤一：跨境申请 根据中华人民共和国工业和信息化部（简称工信部）相关法律、行政法规规定，中国大陆只有三大运营商具备跨境业务运营资质。所以涉及跨中国大陆访问的业务场景，都需要通过跨境资质审核。 进入全球加速跨境申请管理界面。 在跨境申请管理页面，单击“跨境申请”。 进入中国联通跨境云服务在线申请页面。 图1 跨境申请 在跨境云服务在线申请页面，根据提示配置相关参数，并上传相关材料。 “华为云ID”指用户在华为云管理控制台的“账号ID”，从控制台获取账号ID的步骤如下： 登录管理控制台。 鼠标悬停在右上角的用户名，选择下拉列表中的“我的凭证”。 图2 我的凭证 在“API凭证”页面的项目列表中查看并获取账号ID。 图3 获取账号ID 单击“立即申请”。