华为云用户手册

直播间配置约束 直播间配置限制，如表1所示。 表1 直播间限制 直播间配置 限制 文本驱动 每个单场景中所有段落输入文字的总量需大于200字。 每个段落的文本字符数量需小于2000，如果包含 语音合成 标记语言SSML标签，需小于3000。 整个直播间所有段落的文本总字符数，如果包含语音合成标记语言SSML标签时，需小于30万。 音频驱动 每个单场景上传音频的时长需大于1分钟，大小不超过100M。 视频格式 视频支持的格式为：MP4、M4V、MKV、MOV、FLV、3GP、WMV和AVI。 说明： 在直播间制作界面，如果添加视频，且视频格式为FLV、3GP、WMV、AVI时，无法展示视频播放效果，仅能图片展示。这是浏览器不兼容导致的，但是不影响直播效果。直播过程中，这些插入的视频可以正常播放和展示。 视频要求如下所示： 分辨率最大支持1080P。 帧率小于等于30fps。 编码为AV1、H264或H265格式。 AV1、H265编码格式目前支持Chrome浏览器，不支持Edge浏览器。 视频采样格式为YUV420。 视频素材总大小小于1GB。 同时叠加的视频总数量为3，包含互动时配置的视频。 音频格式 音频支持的格式为：MP3、M4A、WAV。 音频要求如下所示： 仅提取单声道音频。 音频素材总大小小于500MB。 图片格式 图片支持的格式为：PNG、JPG、JPEG。 图片要求如下所示： 分辨率最大支持1080P。 图片素材总大小小于500MB。 字幕 字幕中正常断句的符号，如中文符号、，。：；！？….. 等；英文符号,.:;!?...等，系统会自动去除。 如果自动去除的符号在一段文字中间，自动去除后，会再增加一个空格。 如果自动去除的符号在段落末尾，仅直接去除。 有些符号不会自动去除，如中文符号“”《》（）·~——等；英文符号""《》()·~--等。 透明背景 视频直播 不支持透明背景设置，仅视频制作和智能交互支持。

直播播放说明 直播播放说明，如表3所示。 表3 直播播放说明 直播播放配置 操作说明 租户控制直播播放的配置 为保障主播可以截取到完整的直播视频，MetaStudio直播服务提供了控制直播播放的配置。 启动直播前，Console控制台界面，需要去勾选“加载完自动直播”（即配置项“play_policy.auto_play_script”设置为“FALSE”）。启动直播任务后，会等待租户的开始直播指令（如果接口调用的方式，会通过RTSA COMMAND指令发送play_start指令），才会启动直播，否则数字人一直保持静默状态。

操作步骤 配置代理服务器。 安装squid软件。 修改配置文件squid.conf的内容。 http_port 3128 cache_mem 64 MB maximum_object_size 4 MB cache_dir ufs /var/spool/squid 100 16 256 access_log /var/log/squid/access.log acl localnet src 192.168.0.0/16 http_access allow localnet http_access deny all http_port为squid指定的端口，acl localnet src为需要访问代理服务器的服务器内网IP（根据实际情况设置，一般设置为源端服务器内网网段。也可以设置为0.0.0.0/0以允许所有服务器访问代理）。 初始化squid。 启动squid并设置为开机自启。 在源端服务器下载并注册迁移Agent。 源端为Linux系统 在源端服务器执行如下命令，下载迁移Agent。 curl -x http://代理机器ip:代理端口 -O https://sms-resource-cn-cn-north-4.obs.cn-north-4.myhuaweicloud.com/ SMS -Agent.tar.gz 迁移Agent下载完成后，执行如下命令，解压软件包。 tar -zxvf SMS-Agent.tar.gz 进入SMS-Agent/agent/config目录，修改auth.cfg文件内容。 proxy_addr为代理服务器内网ip地址，允许源端服务器通过代理服务器的3128端口访问 主机迁移服务 ，非目的端地址。 启动迁移Agent，输入目的端服务器所在华为云账号的AK和SK。 当界面出现successfully!时，表示SMS-Agent启动成功，并开始给 主机迁移 服务上传源端服务器信息。 源端为Windows系统 下载并安装迁移Agent。 源端系统为Windows Server 2019/Windows Server 2016/Windows Server 2012/Windows 10/Windows 8.1时，在源端powershell中运行如下命令，下载迁移Agent。 Invoke-WebRequest -Proxy http://代理机器ip:代理端口 -Uri https://sms-resource-cn-cn-north-4.obs.cn-north-4.myhuaweicloud.com/SMS-Agent-Py3.exe -OutFile C:\\SMS-Agent-Py3.exe -UseBasicParsing 源端系统为Windows Server 2008/Windows 7时，通过代理服务器下载Py2版本的迁移Agent，然后传送到源端服务器并安装。 详细安装介绍请参见安装Windows版的SMS-Agent。 安装完成后，进入SMS-Agent图形界面，输入目的端服务器所在华为云账号的AK和SK，并启动Agent。 若不使用HTTPS代理，请选择：直连。 若使用HTTPS代理，请选择：使用代理，并输入代理服务器IP、端口、代理用户名、密码。（本文中的代理服务器是用来举例，未设置代理用户名和密码，故不填写） 代理服务器IP为代理服务器内网IP地址，允许源端服务器通过代理服务器的3128端口访问主机迁移服务，非目的端地址。 当界面显示：上传源端信息成功！等待服务端命令时，表示Windows版的SMS-Agent启动成功，请访问华为云控制台主机迁移服务界面进行后续操作。 Windows迁移结束后，为了避免源端代理服务器配置对源端产生影响，建议将浏览器的代理服务器恢复配置。

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

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

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

准备工作 开发技能 熟悉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 第一次正式发布。

状态码 状态码如表1所示 表1 状态码 状态码 编码 错误码说明 100 Continue 继续请求。 这个临时响应用来通知客户端，它的部分请求已经被服务器接收，且仍未被拒绝。 101 Switching Protocols 切换协议。只能切换到更高级的协议。 例如，切换到HTTP的新版本协议。 201 Created 创建类的请求完全成功。 202 Accepted 已经接受请求，但未处理完成。 203 Non-Authoritative Information 非授权信息，请求成功。 204 NoContent 请求完全成功，同时HTTP响应不包含响应体。 在响应OPTIONS方法的HTTP请求时返回此状态码。 205 Reset Content 重置内容，服务器处理成功。 206 Partial Content 服务器成功处理了部分GET请求。 300 Multiple Choices 多种选择。请求的资源可包括多个位置，相应可返回一个资源特征与地址的列表用于用户终端（例如：浏览器）选择。 301 Moved Permanently 永久移动，请求的资源已被永久的移动到新的URI，返回信息会包括新的URI。 302 Found 资源被临时移动。 303 See Other 查看其它地址。 使用GET和POST请求查看。 304 Not Modified 所请求的资源未修改，服务器返回此状态码时，不会返回任何资源。 305 Use Proxy 所请求的资源必须通过代理访问。 306 Unused 已经被废弃的HTTP状态码。 400 BadRequest 非法请求。 建议直接修改该请求，不要重试该请求。 401 Unauthorized 在客户端提供认证信息后，返回该状态码，表明服务端指出客户端所提供的认证信息不正确或非法。 402 Payment Required 保留请求。 403 Forbidden 请求被拒绝访问。 返回该状态码，表明请求能够到达服务端，且服务端能够理解用户请求，但是拒绝做更多的事情，因为该请求被设置为拒绝访问，建议直接修改该请求，不要重试该请求。 404 NotFound 所请求的资源不存在。 建议直接修改该请求，不要重试该请求。 405 MethodNotAllowed 请求中带有该资源不支持的方法。 建议直接修改该请求，不要重试该请求。 406 Not Acceptable 服务器无法根据客户端请求的内容特性完成请求。 407 Proxy Authentication Required 请求要求代理的身份认证，与401类似，但请求者应当使用代理进行授权。 408 Request Time-out 服务器等候请求时发生超时。 客户端可以随时再次提交该请求而无需进行任何更改。 409 Conflict 服务器在完成请求时发生冲突。 返回该状态码，表明客户端尝试创建的资源已经存在，或者由于冲突请求的更新操作不能被完成。 410 Gone 客户端请求的资源已经不存在。 返回该状态码，表明请求的资源已被永久删除。 411 Length Required 服务器无法处理客户端发送的不带Content-Length的请求信息。 412 Precondition Failed 未满足前提条件，服务器未满足请求者在请求中设置的其中一个前提条件。 413 Request Entity Too Large 由于请求的实体过大，服务器无法处理，因此拒绝请求。为防止客户端的连续请求，服务器可能会关闭连接。如果只是服务器暂时无法处理，则会包含一个Retry-After的响应信息。 414 Request-URI Too Large 请求的URI过长（URI通常为网址），服务器无法处理。 415 Unsupported Media Type 服务器无法处理请求附带的媒体格式。 416 Requested range not satisfiable 客户端请求的范围无效。 417 Expectation Failed 服务器无法满足Expect的请求头信息。 422 UnprocessableEntity 请求格式正确，但是由于含有语义错误，无法响应。 429 TooManyRequests 表明请求超出了客户端访问频率的限制或者服务端接收到多于它能处理的请求。建议客户端读取相应的Retry-After首部，然后等待该首部指出的时间后再重试。 500 InternalServerError 表明服务端能被请求访问到，但是不能理解用户的请求。 501 Not Implemented 服务器不支持请求的功能，无法完成请求。 502 Bad Gateway 充当网关或代理的服务器，从远端服务器接收到了一个无效的请求。 503 ServiceUnavailable 被请求的服务无效。 建议直接修改该请求，不要重试该请求。 504 ServerTimeout 请求在给定的时间内无法完成。客户端仅在为请求指定超时（Timeout）参数时会得到该响应。 505 HTTP Version not supported 服务器不支持请求的HTTP协议的版本，无法完成处理。 父主题： 附录

权限说明 如果您需要对您所拥有的性能测试服务进行精细的权限管理，您可以使用 统一身份认证 服务（Identity and Access Management，简称IAM），如果华为云账号已经能满足您的要求，不需要创建独立的IAM用户，您可以跳过本章节，不影响您使用性能测试服务的其它功能。 默认情况下，新建的IAM用户没有任何权限，您需要将其加入用户组，并给用户组授予策略或角色，才能使用户组中的用户获得相应的权限，这一过程称为授权。授权后，用户就可以基于已有权限对云服务进行操作。 权限根据授权的精细程度，分为角色和策略。 角色以服务为粒度，是IAM最初提供的一种根据用户的工作职能定义权限的粗粒度授权机制。 策略以API接口为粒度进行权限拆分，授权更加精细，可以精确到某个操作、资源和条件，能够满足企业对权限最小化的安全管控要求。 如果您要允许或是禁止某个接口的操作权限，请使用策略。 账号具备所有接口的调用权限，如果使用账号下的IAM用户发起API请求时，该IAM用户必须具备调用该接口所需的权限，否则，API请求将调用失败。每个接口所需要的权限，与各个接口所对应的授权项相对应，只有发起请求的用户被授予授权项所对应的策略，该用户才能成功调用该接口。

响应消息体 响应消息体通常以结构化格式返回，与响应消息头中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表示错误描述信息。

Token认证 Token的有效期为24小时，需要使用一个Token鉴权时，可以先缓存起来，避免频繁调用。 使用Token前请确保Token离过期有足够的时间，防止调用API的过程中Token过期导致调用API失败。 Token在计算机系统中代表令牌（临时）的意思，拥有Token就代表拥有某种权限。Token认证就是在调用API的时候将Token加到请求消息头，从而通过身份认证，获得操作API的权限。 Token可通过调用获取用户Token接口获取，调用本服务API需要project级别的Token，即调用接口时，请求body中auth.scope的取值需要选择project，如下所示。 { "auth": { "identity": { "methods": [ "password" ], "password": { "user": { "name": "username", "password": "********", "domain": { "name": "domainname" } } } }, "scope": { "project": { "id": "xxxxxxxx" } } } } 获取Token 后，再调用其他接口时，您需要在请求消息头中添加“X-Auth-Token”，其值即为Token。例如Token值为“ABCDEFJ....”，则调用接口时将“X-Auth-Token: ABCDEFJ....”加到请求消息头即可，如下所示。 GET https://iam.xxx.com/v3/auth/tokens Content-Type: application/json X-Auth-Token: ABCDEFJ.... 您还可以通过这个视频教程了解如何使用Token认证：https://bbs.huaweicloud.com/videos/101333。

请求方法 HTTP请求方法（也称为操作或动词），它告诉服务你正在请求什么类型的操作。 GET：请求服务器返回指定资源。 PUT：请求服务器更新指定资源。 POST：请求服务器新增资源或执行特殊操作。 DELETE：请求服务器删除指定资源，如删除对象等。 HEAD：请求服务器资源头部。 PATCH：请求服务器更新资源的部分内容。当资源不存在的时候，PATCH可能会去创建一个新的资源。 在获取用户Token的URI部分，您可以看到其请求方法为“POST”，则其请求为： POST https://iam.xxx.com/v3/auth/tokens

请求消息体 请求消息体通常以结构化格式发出，与请求消息头中Content-type对应，传递除请求消息头之外的内容。如果请求消息体中参数支持中文，则中文字符必须为UTF-8编码。 每个接口的请求消息体内容不同，也并不是每个接口都需要有请求消息体（或者说消息体为空），GET、DELETE操作类型的接口就不需要消息体，消息体具体内容需要根据具体接口而定。 对于获取用户Token接口，您可以从接口的请求部分看到所需的请求参数及参数说明。将消息体加入后的请求如下所示，加粗的斜体字段需要根据实际值填写，其中username为用户名，domainname为用户所属的账号名称，********为用户登录密码，xxxxxxxx为project的ID，获取方法请参见获取项目ID。 POST https://iam.xxx.com/v3/auth/tokens Content-Type: application/json { "auth": { "identity": { "methods": [ "password" ], "password": { "user": { "name": "username", "password": "********", "domain": { "name": "domainname" } } } }, "scope": { "project": { "id": "xxxxxxxx" } } } } 到这里为止这个请求需要的内容就具备齐全了，您可以使用curl、Postman或直接编写代码等方式发送请求调用API。对于获取用户Token接口，返回的响应消息头中“x-subject-token”就是需要获取的用户Token。有了Token之后，您就可以使用Token认证调用其他API。

请求URI 请求URI由如下部分组成。 {URI-scheme} :// {Endpoint} / {resource-path} ? {query-string} 尽管请求URI包含在请求消息头中，但大多数语言或框架都要求您从请求消息中单独传递它，所以在此单独强调。 URI-scheme：表示用于传输请求的协议，当前所有API均采用HTTPS协议。 Endpoint：指定承载REST服务端点的服务器 域名 或IP，不同服务不同区域的Endpoint不同，您可以从地区和终端节点获取。例如IAM服务在“华北-北京一”区域的Endpoint为“iam.cn-north-1.myhuaweicloud.com”。 resource-path：资源路径，也即API访问路径。从具体API的URI模块获取，例如“获取用户Token”API的resource-path为“/v3/auth/tokens”。 query-string：查询参数，是可选部分，并不是每个API都有查询参数。查询参数前面需要带一个“？”，形式为“参数名=参数取值”，例如“limit=10”，表示查询不超过10条数据。

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