华为云用户手册

直播任务退出说明 直播任务退出说明，如表2所示。 表2 直播任务退出说明 直播任务退出场景 操作说明 租户自行退出直播任务 租户可通过下述方式，退出直播任务。 在MetaStudio控制台开播页面，停止直播任务。 调用结束数字人智能直播任务接口，停止直播任务。 服务自动关停直播任务 下述场景下， 生成的直播视频流没有观看者，服务为保障租户利益，会自动关停直播任务。 在MetaStudio控制台开播，且没有配置RTMP推流时，用户关闭了视频播放窗口一段时间以后，约2~3分钟。 调用API开播，且没有配置RTMP推流时，客户端退出RTC房间一段时间以后，约2~3分钟。 特殊退出场景 如果直播内容涉及安全合规风险，服务运维人员，会通过运维界面，直接冻结直播任务。

常见问题 Q：Windows和Linux环境的编译兼容性问题 A： Windows环境 编译器兼容性问题： 在Windows上，不同的C++编译器（如Visual C++、MinGW等）可能会与SDK的构建系统产生兼容性问题。例如，SDK可能在构建过程中依赖特定的编译器特性或标准库实现，而Visual C++和MinGW在某些C++标准支持程度上有所差异。 对于依赖的其他库（如FreeType），其头文件和库文件路径也需要正确地添加到项目的包含路径和库路径环境变量中。如果这些路径设置不正确，在编译过程中会出现头文件无法找到或链接库错误的情况。 DLL依赖问题： 一些库可能以动态链接库（DLL）的形式提供，在Windows上运行时，可能会出现DLL缺失或版本不匹配的问题。 Linux环境 包管理器依赖问题： SDK需要特定版本的运行时g++库支持C++语言特性，但系统默认的版本可能较旧，导致在构建过程中出现语法错误。 在Linux不同发行版存在不同，这可能会导致在安装和配置过程中出现混淆。 权限问题： 对于使用多用户环境的情况，不同用户可能对SDK相关的文件和目录有不同的权限。这可能会导致一些用户能够成功构建和运行应用，而其他用户则因为权限问题无法进行相同的操作。 库路径和链接问题： Linux系统在链接库文件时，依赖于特定的库路径设置（如LD_LIBRARY_PATH环境变量）。如果这些路径没有正确设置，应用可能无法找到所需的共享库。例如，在运行时应用可能无法加载OCCT库，因为系统无法在指定的库路径中找到该库。 与Windows不同，Linux上的库文件命名和版本管理遵循一定的规则（如.so文件的命名和版本号约定）。如果库文件的名称或版本不符合这些规则，或者在链接过程中指定了错误的库名称或版本，会导致链接错误。 Q：为什么使用SDK时，抛出了许可证相关的异常？ A：请检查许可证的有效性，例如产品名称是否匹配，是否超过有效期限，并使用有效的许可证。

应用场景 由于传统的工业软件以单点工具为基础，各软件的底层数据表达形式不一致，导致上下游软件之间无法直接传递和共享异构几何数据格式。在企业进行工业设计、工业建模、工业制造的过程中，不同的建模软件和工具使用不同的模型格式，从而使得模型的跨平台使用变得困难。DEE SDK（几何数据转换引擎）能够兼容这些模型，并对商业私有格式、中立格式等进行有效地解析，并输出为通用的中立格式。用户可以指定所需的目标格式，并携带相关的参数，进行模型转换，并得到目标模型文件。

方案优势 高可扩展性 易于添加新功能：随着业务需求的不断变化和发展，系统需要不断添加新的功能模块。在插件式架构中，新功能可以以插件的形式独立开发和添加，无需对整个系统的代码进行大规模的修改。 支持第三方开发：插件式架构允许第三方开发者为系统开发插件，可以较快地扩展了系统的功能范围。 低耦合性 功能模块独立：插件与系统的其他部分以及其他插件之间的耦合度较低。每个插件都可以独立地进行开发、测试和维护，不会影响到系统的其他部分。 独立测试：由于插件的独立性，每个插件都可以单独进行测试，当某个插件需要维护或升级时，只需要对该插件进行修改和测试。 高开发效率 并行开发：插件式架构支持多团队的并行开发，不同的开发团队可以同时开发不同的插件，提高了开发效率。 快速迭代：插件的开发和发布相对独立，这使得开发者可以快速地迭代和发布插件，及时响应市场需求和用户反馈。

应用场景 产品设计评估：在汽车、机械装备、电子产品等行业，可以利用轻量化渲染引擎快速创建产品的三维模型，并通过渲染生成逼真的外观图像。这有助于设计师从不同角度观察产品的外观效果，评估设计的美观性和合理性，及时发现并修改设计中的缺陷。 结构设计与优化：对于复杂的机械结构或电子产品内部结构设计，通过对模型进行渲染，可以查看不同工况下的结构应力、变形等情况，从而对结构进行优化，提高产品的性能和可靠性。 设备可视化管理：对于大型工业设备、工厂设施等，利用渲染引擎可以创建设备的三维模型，并将设备的运行状态、维护记录等信息与模型进行关联。管理人员可以通过可视化的界面实时监控设备的运行情况，及时发现设备的故障和异常，提高设备的管理效率和可靠性。

方案架构 采用插件式架构： 图1 插件式CAx软件架构 主应用框架 构建桌面端C++应用的主体框架，包括应用的初始化、窗口管理、事件循环等基本功能。例如，使用MFC（Microsoft Foundation Classes）、Qt、Tk/Tcl等框架搭建应用的基本结构，确保应用能够正常运行并提供一个容器来集成3D查看器插件。 3D查看器插件模块 插件接口层：定义一组标准的插件接口，用于与主应用框架进行通信和交互。这些接口包括加载模型、控制查看器、获取查看器状态等功能的函数指针或者抽象类。通过这些接口，主应用可以在不了解3D查看器内部实现细节的情况下，调用其功能。 SDK集成层：在插件内部，将SDK集成进来。这包括将SDK的库文件连接到插件项目中，以及处理SDK与插件接口层之间的适配。例如，将SDK的模型加载函数封装成符合插件接口层定义的函数，使得主应用可以通过统一的接口来加载不同格式的模型。 资源管理子模块：管理3D查看器插件所需要的资源，如字体、模型文件等。对于字体资源，确保在桌面应用环境下能够正确加载和显示；对于模型文件，提供资源路径的管理和转换功能，以便插件能够根据主应用的资源管理策略正确地访问模型文件。

常见问题 Q：Windows和Linux环境的编译兼容性问题？ A： Windows环境 不同的C++编译器（如Visual C++、MinGW等）可能会与SDK的构建系统产生兼容性问题。例如，SDK可能在构建过程中依赖特定的编译器特性或标准库实现，而Visual C++和MinGW在某些C++标准支持程度上有所差异。 对于依赖的其他库（如FreeType），其头文件和库文件路径也需要正确地添加到项目的包含路径和库路径环境变量中。如果这些路径设置不正确，在编译过程中会出现头文件无法找到或链接库错误的情况。 一些库可能以动态链接库（DLL）的形式提供，在Windows上运行时，可能会出现DLL缺失或版本不匹配的问题。例如，本SDK依赖于某些系统级的DLL（如OpenGL相关的DLL），如果这些DLL版本过旧或者不存在，可能会导致应用程序在运行时崩溃或出现图形渲染错误。 Linux环境 包管理器依赖问题： SDK需要特定版本的运行时g++库支持C++语言特性，但系统默认的版本可能较旧，导致在构建过程中出现语法错误。 在Linux不同发行版存在不同，这可能会导致在安装和配置过程中出现混淆。 权限问题： 对于使用多用户环境的情况，不同用户可能对SDK相关的文件和目录有不同的权限。这可能会导致一些用户能够成功构建和运行应用，而其他用户则因为权限问题无法进行相同的操作。 库路径和链接问题： Linux系统在链接库文件时，依赖于特定的库路径设置（如LD_LIBRARY_PATH环境变量）。如果这些路径没有正确设置，应用可能无法找到所需的共享库。例如，在运行时应用可能无法加载OCCT库，因为系统无法在指定的库路径中找到该库。 与Windows不同，Linux上的库文件命名和版本管理遵循一定的规则（如.so文件的命名和版本号约定）。如果库文件的名称或版本不符合这些规则，或者在链接过程中指定了错误的库名称或版本，会导致链接错误。 Q：Windows和Linux环境的性能和优化问题 A： Windows环境 图形驱动和硬件加速问题： Windows上的图形驱动程序对于3D图形渲染的性能有很大影响。如果图形驱动没有正确安装或者版本过旧，可能会导致3D查看器的性能下降，如出现画面卡顿、渲染错误等问题。 不同的硬件设备（如NVIDIA、AMD或Intel的显卡）在Windows上支持的OpenGL版本可能存在不同。 系统资源管理问题： 与Linux相比，Windows在某些情况下可能会对文件I/O操作进行更多的缓存和预读处理。这可能会对SDK的数据交换过程产生影响，例如在频繁读取和写入模型文件时，Windows的缓存策略可能会导致数据不一致或者性能下降。 Linux环境 图形栈和兼容性问题： Linux系统有多种图形栈（如X11、Wayland等）可供选择。不同的图形栈可能对3D查看器的性能和兼容性产生不同的影响。例如，某些图形库（如OpenGL）在Wayland下的性能可能不如在X11下，或者可能会出现一些兼容性问题，如无法正确显示某些图形元素。 不同Linux发行版对于图形驱动的安装和配置方式也有所不同。 内存和缓存优化问题： Linux系统提供了多种工具和机制来优化内存和缓存的使用。然而，对于SDK来说，可能需要根据具体的应用场景进行适当的调整。例如，在处理大型3D模型时，可能需要调整系统的内存缓存参数（如/proc/sys/vm相关的参数）来提高数据访问速度，但如果调整不当，可能会导致系统性能下降或者内存泄漏。 与Windows不同，Linux在文件I/O缓存方面可能有更灵活的配置选项。例如，可以使用不同的缓存策略（如direct I/O、O_DIRECT标志等）来优化模型文件的读取和写入，但这些策略需要根据具体的硬件和应用需求进行选择，否则可能会影响数据交换的性能。

应用场景 NCAD是一款功能强大的开发工具包，专为CAD（计算机辅助设计）、CAE（计算机辅助工程）和CAM（计算机辅助制造）领域中的几何建模、修复与优化任务设计。它提供了完整的解决方案，涵盖了从几何形状修复、特征识别、简化到仿真准备及网格修复等多个功能，帮助开发者快速构建高效的工程应用，提升设计、分析与制造过程的精准度和效率。 NCAD在多个行业中有着广泛的应用，尤其适用于以下场景： CAD系统开发：为开发高效的计算机辅助设计系统提供全面的几何建模、修复和特征识别支持，简化复杂设计任务。 CAE仿真准备：对复杂的CAD模型进行简化与优化，包括几何形状的修复和生成网格的修复，生成符合仿真分析需求的网格，减少仿真计算时间和资源消耗。 3D打印准备：自动修复和优化3D打印模型的几何数据，确保STL或其他文件格式符合3D打印要求，避免错误打印。

方案架构 NCAD提供了模块化的架构，能够灵活地集成到现有的CAD、CAE或CAM工作流中。其核心架构包括以下几个模块： 几何修复模块： 自动检测并修复几何模型中的错误，如非流形边界、重叠面、无效面等。 修复错误的拓扑关系，确保模型的可用性。 完全可定制的管道，支持灵活排序修复的顺序 特征识别模块： 对CAD模型中的特征（如孔、槽、壁等）进行自动识别和提取。 支持多种复杂的几何特征识别，包括非规则形状的特征提取。 几何简化模块： 对复杂的CAD模型进行简化，保留关键几何信息的同时减少冗余数据。 提供多种简化策略，适用于不同精度和计算需求。 仿真准备模块： 提供干扰修复、对称检测、规范几何体检测等通用仿真的前期准备算法。 提供中面查找、梁模型、表面焊接和点焊接等结构分析的前期准备算法，也提供部分CFD的准备算法。 网格修复模块： 自动修复生成的网格文件，确保没有漏洞、非流形边界等问题。 优化网格质量，提高仿真和分析的精度与稳定性。 数据交换模块： 支持常见的BRep、STEP、STL格式的导入与导出，确保与其他软件系统的兼容性。 支持多种数据格式之间的转换，简化数据交换过程。

方案优势 NCAD工具包为开发者提供了一整套高效、可靠的解决方案，具有以下几大优势： 高度集成与模块化：NCAD提供了一套完整的工具集，所有功能模块之间无缝衔接，用户可根据实际需求选择性集成，节省开发时间和资源。 自动化与智能化：NCAD在几何修复、特征识别及网格修复方面具备高度自动化的能力，减少人工干预，提高工作效率。特征识别与几何简化过程也经过优化，能够自动调整，适应不同类型的模型。 高精度与可靠性：NCAD内部采用高精度的数学算法，保证几何修复和网格生成的准确性，为复杂的工程仿真提供稳定的基础数据。 高效的数据处理能力：优化的算法使得NCAD在大规模模型和复杂几何体的处理上表现出色。无论是在处理高精度零件模型还是在生成超大规模的仿真网格时，NCAD都能保持高效的处理速度。 用户友好与易于集成：NCAD提供清晰易懂的文档、示例代码及开发工具包，帮助开发人员快速上手，并且其API设计简洁，易于与现有项目或软件进行集成。

准备工作 开发技能 熟悉C++语言，能够编写C++语言代码。 熟悉CAD建模相关知识。 了解OCCT几何建模相关知识。 了解C++构建相关工具（cmake等）。 开发环境 Windows 10+ Visual Studio 2017+或适用于Visual Studio 2017+的Microsoft Visual生成工具 CMake 3.7+ Linux： gcc g++ gdb CMake 3.7+ 许可准备 开发和使用DEE SDK需要获取DEE SDK许可文件。

常见问题 Q：为什么使用SDK时，抛出了许可证相关的异常？ A：请检查许可证的有效性，例如产品名称是否匹配，是否超过有效期限，并使用有效的许可证。 Q：为什么导入文件时，出现异常？ A：请检查文件是否能在指定的路径下查找到，并检查输入文件是否为DEE SDK支持的文件类型。 Q：为什么转换后得到的结果文件中，不包含PMI的信息？ A：此参数在默认情况下被设置为false，如果您需要此信息，请使用Base_WriterParameters::WritePMI()方法更改此项输出参数为true。

添加合规规则时，规则参数指的是什么？ 规则参数和合规策略是对应的，例如：您选择了“资源具有指定的标签”预设策略，则需要配置该预设策略对应的规则参数“key”和“value”的具体值。 预设策略的规则参数无法增删，但是您可以根据需要为其设置不同的参数值，将合规策略重用于不同的方案。 自定义策略的规则参数由您自行配置，您可以根据需要为自定义策略添加不同的规则参数，最多可添加10个。 图1 规则参数赋值

添加“iam-password-policy”、“iam-user-mfa-enabled”等合规规则后，为什么没有合规评估结果？ 资源合规的数据来源于Config服务在资源清单页面所收集到的全部资源。请检查相关资源在资源清单页面中是否正常展示，如未正常展示，可能是由于您没有开启资源记录器导致未收集到相应的资源数据。 如果您需要使用这些合规规则，请开启资源记录器并收集相关的资源数据；如不需要使用这些规则，请停用未收集资源数据对应的合规规则，避免造成混淆或产生不必要的费用。

组织合规规则和组织合规包创建完成后，为什么会在部分组织成员账号中部署异常，且提示“tracker-config needs to be enabled”？ 是因为这些组织成员账号未开启资源记录器导致的部署异常。 Config服务的相关功能均依赖于资源记录器收集的资源数据，因此账号必须开启资源记录器才可正常使用合规规则和合规规则包功能。 在组织合规规则和组织合规规则包场景下，除下发规则和合规规则包的组织管理员或Config服务的委托管理员之外，所部署的组织成员账号也需要开启资源记录器，才能正常下发合规规则和合规规则包。

调用API获取项目ID 项目ID可以通过调用 IAM 的查询指定条件下的项目信息API获取。 获取项目ID的接口为“GET https://{Endpoint}/v3/projects/”，其中{Endpoint}为IAM的终端节点，可以从地区和终端节点管理员处获取。接口的认证鉴权请参见认证鉴权。 响应示例如下，其中projects下的“id”即为项目ID。 { "projects": [ { "domain_id": "65382450e8f64ac0870cd180d14e684b", "is_domain": false, "parent_id": "65382450e8f64ac0870cd180d14e684b", "name": "xxxxxxxx", "description": "", "links": { "next": null, "previous": null, "self": "https://www.example.com/v3/projects/a4a5d4098fb4474fa22cd05f897d6b99" }, "id": "a4a5d4098fb4474fa22cd05f897d6b99", "enabled": true } ], "links": { "next": null, "previous": null, "self": "https://www.example.com/v3/projects" } }

修订记录 表1 修订记录 发布日期 修订记录 2023-06-16 附录增加获取项目ID、获取账号ID章节。 API增加获取项目ID的指导链接。 请求示例增加描述。 2023-06-06 新增以下接口： 删除任务、获取任务关联的用例列表、创建任务、批量启停任务。 创建用例、修改用例、查询用例、删除用例。 查询报告汇总数据、查询用例的AW曲线图、查询用例报告详情、查询任务报告的用例列表。 全链路压测管理相关接口。 目录管理相关接口。 2023-04-18 “云性能测试服务 CPTS”改名为“性能测试 CodeArts PerfTest”，更新服务名称。 2021-09-15 新增以下接口： 创建工程、查询工程、修改工程、删除工程、查询导入进度。 修改任务、删除任务、创建任务、更新任务状态。 用例管理相关接口。 创建变量、修改变量。 事务管理相关接口。 查询PerfTest任务离线报告列表。 2021-07-30 第一次正式发布。

响应消息体 响应消息体通常以结构化格式返回，与响应消息头中Content-type对应，传递除响应消息头之外的内容。 对于获取用户Token接口，返回如下消息体。为篇幅起见，这里只展示部分内容。 { "token": { "expires_at": "2019-02-13T06:52:13.855000Z", "methods": [ "password" ], "catalog": [ { "endpoints": [ { "region_id": "az-01", ...... 当接口调用出错时，会返回错误码及错误信息说明，错误响应的Body体格式如下所示。 { "error_msg": "The format of message is error", "error_code": "AS.0001" } 其中，error_code表示错误码，error_msg表示错误描述信息。

API概览 API分类 接口 说明 工程管理 查询工程集 按项目ID查询工程集分页数据。 创建工程 新增工程对象。 查询工程 按测试工程ID查询工程数据。 修改工程 按条件更新工程数据。 删除工程 按测试工程ID删除工程数据。 查询导入进度 按条件查询导入工程的进度。 任务管理 查询任务集 按测试工程ID查询任务集分页数据。 查询任务（旧版） 按任务ID查询任务数据。 修改任务（旧版） 按条件更新任务数据。 删除任务（旧版） 按任务ID删除任务数据。 创建任务（旧版） 新增任务数据。 更新任务状态（旧版） 按条件更新任务状态，如启动任务，停止任务等。 修改任务关联用例 按任务ID修改关联该任务的用例。 删除任务 按任务ID删除任务数据。 获取任务关联的用例列表 按任务ID查询该任务关联的用例信息。 创建任务 新增任务数据。 批量启停任务 批量启动、删除任务。 用例管理 创建用例（旧版） 新增用例数据。 删除用例（旧版） 按用例ID删除用例数据。 修改用例（旧版） 按条件更新用例数据。 调试用例 按测试工程ID、任务ID、用例ID以及资源组信息调试用例。 创建用例 新增用例数据。 修改用例 按条件更新用例数据。 查询用例 按用例ID查询用例的详细信息。 删除用例 按用例ID删除用例数据。 全局变量管理 查询全局变量 按条件查询全局变量列表。 创建变量 新增全局变量数据。 修改变量 按条件更新全局变量数据。 删除全局变量 按变量ID删除全局变量。 事务管理 查询事务集 按测试工程ID查询事务分页数据。 创建事务 新增事务数据。 查询事务 按事务ID查询事务数据。 修改事务 按条件更新事务数据。 删除事务 按事务ID删除用例数据。 报告管理 查询报告 按条件查询报告列表。 查询PerfTest任务离线报告列表 按任务ID查询离线报告列表。 查询用例的AW曲线图 获取用例的AW曲线图获取接口。 查询用例报告详情 查询单个用例的详情数据。 查询任务报告的用例列表 查询当前任务用例列表接口。 全链路压测管理 全链路压测探针上报健康状态 按时间戳上报全链路压测探针的健康状态。 全链路压测探针获取配置信息 按应用ID查询全链路压测探针配置信息。 目录管理 创建目录 新增目录数据。 查询用例树 按条件查询目录数据。 修改目录 按目录ID更新目录数据。 删除目录 按目录ID删除目录数据。

基本概念 账号 用户注册云平台时的账号，账号对其所拥有的资源及云服务具有完全的访问权限，可以重置用户密码、分配用户权限等。由于账号是付费主体，为了确保账号安全，建议您不要直接使用账号进行日常管理工作，而是创建用户并使用他们进行日常管理工作。 用户 由账号在IAM中创建的用户，是云服务的使用人员，具有身份凭证（密码和访问密钥）。 在我的凭证下，您可以查看账号ID和用户ID。通常在调用API的鉴权过程中，您需要用到账号、用户和密码等信息。 区域（Region） 从地理位置和网络时延维度划分，同一个Region内共享弹性计算、块存储、对象存储、VPC网络、弹性公网IP、镜像等公共服务。Region分为通用Region和专属Region，通用Region指面向公共租户提供通用云服务的Region；专属Region指只承载同一类业务或只面向特定租户提供业务服务的专用Region。 详情请参见区域和可用区。 可用区（AZ，Availability Zone） 一个AZ是一个或多个物理数据中心的集合，有独立的风火水电，AZ内逻辑上再将计算、网络、存储等资源划分成多个集群。一个Region中的多个AZ间通过高速光纤相连，以满足用户跨AZ构建高可用性系统的需求。 项目 云平台的区域默认对应一个项目，这个项目由系统预置，用来隔离物理区域间的资源（计算资源、存储资源和网络资源），以默认项目为单位进行授权，用户可以访问您账号中该区域的所有资源。如果您希望进行更加精细的权限控制，可以在区域默认的项目中创建子项目，并在子项目中创建资源，然后以子项目为单位进行授权，使得用户仅能访问特定子项目中资源，使得资源的权限控制更加精确。查看项目ID，请参考获取项目ID。 图1 项目隔离模型 企业项目 企业项目是项目的升级版，针对企业不同项目间资源的分组和管理，是逻辑隔离。企业项目中可以包含多个区域的资源，且项目中的资源可以迁入迁出。 关于企业项目ID的获取及企业项目特性的详细信息，请参见《企业管理服务用户指南》。

概述 性能测试（CodeArts PerfTest）是一项为基于HTTP/HTTPS/TCP/UDP/HLS/RTMP/WEBSOCKET/HTTP-FLV/MQTT等协议构建的云应用提供性能测试的服务。服务支持快速模拟大规模并发用户的业务高峰场景，可以很好的支持报文内容和时序自定义、多事务组合的复杂场景测试，测试完成后会为您提供专业的测试报告呈现您的服务质量。 您可以使用本文档提供API，对性能测试服务进行相关操作，如创建、删除、查询工程等。支持的全部操作请参见API概览。

响应参数 状态码： 201 表4 响应Body参数 参数 参数类型 描述 code String 响应码 json CreateVariableResultJson object 响应json message String 响应消息 表5 CreateVariableResultJson 参数 参数类型 描述 variable_id Integer 变量ID 状态码： 501 表6 响应Body参数 参数 参数类型 描述 - String response message

请求参数 表2 请求Body参数 参数 是否必选 参数类型 描述 [数组元素] 是 Array of UpdateVariableRequestBody objects 修改变量请求体 表3 UpdateVariableRequestBody 参数 是否必选 参数类型 描述 id 是 Integer 变量ID name 是 String 变量名称 variable_type 是 Integer 变量类型（1：整数；2：枚举；3：文件；5：文本） variable 是 Array of objects 变量值

请求示例 修改一个事务，事务的id是1，事务所属的工程ID是1，包括修改事务的请求信息。 /v1/{project_id}/templates/1 { "contents" : [ { "content" : [ { "content" : { "body_type" : 0, "bodys" : [ ], "check_end_length" : null, "check_end_str" : null, "check_end_type" : null, "connect_timeout" : 5000, "connect_type" : 1, "headers" : [ { "key" : "Content-Type", "value" : "application/json" } ], "http_version" : "HTTP/1.1", "method" : "GET", "name" : "Msg-31445", "protocol_type" : 2, "return_timeout" : 5000, "return_timeout_param" : null, "url" : "https://www.domain-example.com" }, "content_type" : 2 } ], "content_id" : 2346, "index" : 0 } ], "description" : "", "enable_pre" : false, "for_loop_params" : [ ], "id" : 1, "name" : "transaction_test", "project_id" : 1, "temp_type" : 0 }

请求参数 表2 请求Body参数 参数 是否必选 参数类型 描述 id 是 Integer 事务ID project_id 是 Integer 工程ID name 是 String 事务名称 temp_type 否 Integer 事务类型 description 否 String 描述信息 for_loop_params 否 Array of objects 旧版本逻辑控制器字段，当前已未使用 enable_pre 否 Boolean 是否启用预置事务，当前版本未使用 contents 否 Array of TempContentInfo objects 事务脚本信息 表3 TempContentInfo 参数 是否必选 参数类型 描述 content_id 否 Integer 报文id或者事务ID或者插件ID content 否 Array of Content objects 内容 index 否 Integer 索引 data 否 Object 数据指令内容 data_type 否 Integer 数据指令类型（0：默认请求卡片；1：数据指令；201：循环指令；202：条件指令；301：集合点；203：vu百分比控制器；204：吞吐量控制器；302：插件请求） 表4 Content 参数 是否必选 参数类型 描述 content_type 否 Integer 用例卡片类型（1：思考时间；2：报文；3：检查点；4：变量提取） content 否 ContentInfo object 内容 表5 ContentInfo 参数 是否必选 参数类型 描述 body_type 否 Integer body类型（0：字符串；1：form-data格式；3：x-www-form-urlencoded格式） 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 超时时间 connect_type 否 Integer 连接设置，当前版本未使用 headers 否 Array of ContentHeader objects 请求头 http_version 否 String HTTP版本 method 否 String HTTP方法 name 否 String 用例名称 protocol_type 否 Integer 协议类型（1：HTTP；2：HTTPS；3：TCP；4：UDP；7：HLS/RTMP；9：WebSocket；10：HTTP-FLV） return_timeout 否 Integer 响应超时 return_timeout_param 否 String 响应超时参数 url 否 String 请求地址 rtmp_url 否 String rtmp地址 flv_url 否 String flv地址 bitrate_type 否 Integer 分辨率策略 duration 否 Integer 持续时间 retry_delay 否 Integer HLS重试延迟时间 retry_time 否 Integer HLS重试次数 表6 ContentHeader 参数 是否必选 参数类型 描述 key 否 String 键 value 否 String 值

请求示例 启动一个任务，任务的所属工程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 }

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

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 code String 响应码 message String 响应消息 extend String 扩展信息 result UpdateTaskStatusResult object 状态更新结果 表5 UpdateTaskStatusResult 参数 参数类型 描述 task_run_id Integer 运行任务ID，即报告ID 状态码： 501 表6 响应Body参数 参数 参数类型 描述 - String response message

请求示例 修改一个任务，任务ID是1，任务名修改为task，任务关联的用例ID集合为16674，16675。 /v3/{project_id}/tasks/1 { "name" : "task", "parallel" : false, "project_id" : 17543, "operate_mode" : 2, "case_id_list" : [ 16674, 16675 ] }

响应示例 状态码： 200 success { "code" : "SV CS TG.CPTS.0000000", "message" : "success", "taskInfo" : { "bench_concurrent" : 100, "case_list" : [ { "case_id" : 211751, "case_type" : 0, "contents" : [ { "content_id" : 0, "content" : [ { "content_type" : 2, "content" : { "body_type" : 0, "bodys" : [ ], "check_end_length" : null, "check_end_str" : null, "check_end_type" : null, "connect_timeout" : 5000, "connect_type" : 1, "headers" : [ { "key" : "Content-Type", "value" : "application/json" } ], "http_version" : "HTTP/1.1", "method" : "GET", "name" : "Msg-43147", "protocol_type" : 1, "return_timeout" : 5000, "return_timeout_param" : null, "url" : "https://www.example.com" } } ], "index" : 0, "selected_temp_name" : "", "data" : null, "data_type" : 0, "conditions" : null } ], "for_loop_params" : [ ], "increase_setting" : [ ], "sort" : 1, "stages" : [ ], "status" : 1, "temp_id" : 0, "user_replicas" : 0 }, { "case_id" : 213142, "case_type" : 0, "contents" : null, "for_loop_params" : [ ], "increase_setting" : [ ], "sort" : 2, "stages" : [ ], "status" : 1, "temp_id" : 0, "user_replicas" : 0 } ], "create_time" : "2022-01-18T15:20:50.466972+08:00", "description" : "", "name" : "task", "operate_mode" : 2, "parallel" : false, "project_id" : 122025, "related_temp_running_data" : [ ], "run_status" : 2, "update_time" : "2022-01-20T15:00:44.284053+08:00" } }