华为云用户手册

背景说明 当购买需求管理、代码托管、测试计划等单服务套餐时，租户管理员可以通过“服务级权限管理”页面，按服务为项目成员分配访问权限。 服务级权限管理仅对需求管理、代码托管、测试设计、测试计划等计费项中有“用户数”的服务生效。任何加入项目的成员均可根据实际购买情况使用代码检查、构建、部署、流水线等服务。 项目中添加成员时会根据已购买服务的套餐人数自动分配服务访问权限，直到达到套餐人数规格，您可以随时到本页面手动分配人员访问权限。 例如：团队中有5个人A、B、C、D、E， 购买2人规格需求管理套餐、3人规格代码托管套餐。创建项目后，按照A、B、C、D、E的顺序，依次将5个人加入项目。此时，A、B两人默认拥有两个服务的访问权限，C有 代码托管服务 的访问权限，D、E对两个服务没都访问权限。租户管理员可以根据实际需要，在“服务级权限管理”页面中为5个人开启或关闭两个服务的访问权限，其中最多可为2个人设置需求管理访问权限、最多可为3个人设置代码托管访问权限。 首次购买某类套餐时，按用户名升序自动分配服务访问权限，直到达到套餐人数规格；非首次购买同类套餐时，恢复为上一次的成员服务访问权限。 例如：团队中有5个人A、B、C、D、E，当前已购买5人规格需求管理套餐，并已在项目中添加5人。此时购买3人规格代码托管套餐，默认A、B、C将拥有代码托管服务的访问权限。租户管理员取消A、B的代码托管服务访问权限，并为D、E授权访问代码托管服务。当代码托管套餐到期后，C、D、E失去代码托管服务访问权限；如果再次购买3人规格代码托管套餐，则C、D、E将恢复代码托管服务的访问权限。

故障描述 客户端通过已有连接执行业务时，返回如下报错信息： 故障一 org.postgresql.util.PSQLException: An I/O error occurred while sending to the backend. 故障二 org.postgresql.util.PSQLException: The connection attempt failed ... Caused by: java.net.SocketException: Connection reset

故障二的解决方案 这类问题是由于已有连接被释放掉，使用已经释放的连接会出现这个报错。可能原因主要有以下几种： 网络链路问题 数据库重启或后端进程crash 空闲连接超时释放 解决方案： 首先排查网络连通性，判断是否有网络链路因素（丢包率、重传比例高）导致连接断开。 如果没有网络层面的问题，需要排查业务是否有其他报错导致连接断开。 如果业务上也没有其他报错，则尝试排查连接超时参数（如jdbc连接池参数sockettimeout和connecttimeout），如果设置值较小，会导致连接被主动释放。

安装Python 在开始在CodeArts IDE上使用Python前，请确保您已在计算机上安装了Python。 在Windows上，您需要手动下载并安装Python解释器。 在Linux上，您可以使用内置的Python 3安装，但为了安装其他Python包，您还需要通过get-pip.py安装 “pip” 包管理器。 接下来，运行以下命令验证Python安装： 在Windows上，请在命令提示符中运行： python --version 在Linux上，请在终端中运行： python3 --version 如果Python安装成功，输出将显示对应Python版本号显示。您也可以使用 “py -0” 命令来查看已安装的Python版本。默认解释器将由星号（*）标记。 父主题： 简介

运行测试 CodeArts IDE为运行和调试您的测试用例提供了多个选项： 在测试类的代码编辑器中，单击测试类声明旁的运行按钮（），运行该类中的所有测试。或者单击某个测试方法旁边的运行按钮来仅运行单个测试。要调试测试，请右键单击运行按钮（），并从上下文菜单中选择“调试测试”。 使用“测试”视图来管理和运行测试。 配置pytest和unittest专用的启动配置。 在命令面板（“Ctrl+Ctrl”/“Ctrl+Shift+P”）中，搜索“Test”并使用与测试相关的命令，例如“在当前文件中运行测试”或“在光标处运行测试”。 父主题： 测试

运行代码 您可以通过以下的任意方式来使用当前选定的解释器运行代码： 单击CodeArts IDE主工具栏上的“开始执行（不调试）”按钮 （），以启动内置的“当前文件”启动配置。 在代码编辑器的任意位置右键单击，并选择“在终端中运行 Python 文件”。如果您在选定的代码块上调用此命令，则可以仅运行该部分代码。 在资源管理器中右键单击Python文件，并从上下文菜单中选择“在终端中运行 Python 文件”。 父主题： 简介

搜索查询语法 搜索查询是一个字符串，用于在SmartSearch窗口（“Shift+Shift” / “Ctrl+Shift+A”）中查询对应条目，由“dataSource:stringToMatch”对组成，这些对可以通过空格或运算符连接。如果查询中省略了“dataSource”，则搜索将在所有可用的数据源中进行。使用“stringToMatch:dataSource”，即反向模式，也是可能的。 以下是可用的数据源列表： 数据源名称 数据源缩写 描述 “class”/“type” “c”/“t” 类实体 “member” - 成员实体，即类方法或类字段实体 “text” - 文本实体 “file” “fn” 文件和文件夹实体 “command” - 命令实体 父主题： 基本用法

调试代码 CodeArts的Python扩展提供了调试支持，让您能够设置断点、检查数据，在逐步执行程序时使用调试控制台。 对于快速开始项目，您可以在 “main.py” 文件的第 14 行设置一个断点。将光标悬置在 “print_hi” 调用上，然后按下 “F9” / “Ctrl+Shift+B” / “Ctrl+F8”（IDEA快捷键）。您也可以通过单击编辑器左侧的行号旁的空白区域来设置断点。 接下来需要初始化调试器，您可以按下 “F5” / “F11” / “Shift+F9”（IDEA快捷键），或者单击CodeArts IDE主工具栏上的“开始调试”按钮 （）。 CodeArts IDE将启动内置的“当前文件”启动配置，调试器将在包含断点的那一行暂停运行。此时您可以使用调试工具栏上的命令来控制程序执行，并查看“运行和调试”视图中的“变量”来检查变量。 要了解在CodeArts IDE中调试Python的更多详细信息，请参阅“Python 调试”文档。 父主题： 简介

购买激活码 在CodeArts IDE客户端完成登录并且单击“购买或管理”激活码后，将会自动跳转到CodeArts IDE控制台页面。若此时您已有未绑定的有效激活码，可跳转至步骤1.2。在该页面右上角单击“购买激活码”即可开始申请流程。 进入到激活码购买页面后，您可选择是否自动续费，激活码数量（单次购买数量最多为10），以及是否绑定当前用户（默认勾选）。勾选“绑定当前用户”可以帮您省略购买后手动绑定激活码的过程。 如果您已提前购买并绑定激活码，可省略此流程直接在CodeArts IDE客户端内完成激活。 父主题： 激活CodeArts IDE客户端

环境变量定义文件 环境变量定义文件是一个以“environment_variable=value”为形式，键值对构成的纯文本文件，其中“#”用于注释。该文件不支持多行值，但值可以引用系统中或文件中先前已定义的其他任何环境变量。有关更多信息，请参阅变量替换。环境变量定义文件可用于调试和工具执行（包括linters、格式化器、代码补全和测试工具）等场景，但不应用于终端。 默认情况下，CodeArts IDE会在当前项目文件夹中查找并加载名为“.env”的文件，并应用这些定义。这是由用户设置中的默认条目“"python.envFile": "${workspaceFolder}/.env"”来决定的。你可以更改“python.envFile”设置来使用不同的定义文件。 例如，在开发Web应用程序时，你可以使用不同的定义文件来存储不同的URL和其他设置，而不是直接在代码中设置。这样您就可以轻松地在开发服务器和生产服务器之间切换，如： dev.env file # dev.env - development configuration # API endpoint MYPROJECT_APIENDPOINT=https://my.domain.com/api/dev/ # Variables for the database MYPROJECT_DBURL=https://my.domain.com/db/dev MYPROJECT_DBUSER=devadmin MYPROJECT_DBPASSWORD=!dfka**213= prod.env file # prod.env - production configuration # API endpoint MYPROJECT_APIENDPOINT=https://my.domain.com/api/ # Variables for the database MYPROJECT_DBURL=https://my.domain.com/db/ MYPROJECT_DBUSER=coreuser MYPROJECT_DBPASSWORD=kKKfa98*11@ 然后，您可以将 “python.envFile” 设置设置为 “${workspaceFolder}/prod.env”，然后将调试配置中的 “envFile” 属性设置为 “${workspaceFolder}/dev.env”。 当使用多种方法指定环境变量时，有以下的优先顺序。 “launch.json”中直接定义的“env” 变量会覆盖“launch.json”中 “envFile”设置中定义的变量，以及“python.envFile”设置指定的“.env”文件包含的环境变量。 “launch.json”的“envFile”设置中定义的环境变量会覆盖“python.envFile”设置指定的“.env”文件包含的环境变量。 父主题： 环境变量

类型层次结构 “类型层次结构”视图显示了继承关系，允许您查看选定类的父类和子类。要打开该视图，请在右侧的“活动栏”中单击“类型层次结构”。 右键单击一个类型，选择“显示类型层次结构”，或按下 “Ctrl+H”（IDEA快捷键）。 使用“类型层次结构”视图工具栏按钮，可以切换查看子类、父类或一起查看。 ：查看父类和子类。 ：仅查看父类。 ：仅查看子类。 /: 展开/折叠列表中的所有项。 ：按字母顺序对列表进行排序。 ：刷新列表内容。 在“类型层次结构”视图中，您可以右键单击一个类，并从上下文菜单中选择“基于此类型构建”，以基于选定的类重新构建层次结构。 父主题： 代码浏览

基本用法 通过按下 “Shift+Shift” / “Ctrl+Shift+A” 来启动SmartSearch。 输入搜索请求。要缩小搜索范围，例如仅搜索类成员或CodeArts IDE命令，可以在SmartSearch窗口中通过按下“Tab”/“Shift+Tab”来切换标签页，或者使用搜索查询语法。 使用光标在条目之间导航，并按下“Enter”键跳转到相应的位置或执行命令。另外，也可以双击所需的条目。要关闭SmartSearch窗口，请按下“Escape”键。 搜索查询语法 搜索运算符 父主题： 代码搜索

编程语言的代码补全 智能代码补全是说各种代码编辑功能的总称，包括：代码补全、参数信息、快速信息和成员列表。代码补全功能有时被称为“内容辅助”或“代码提示”。 CodeArts IDE为JavaScript、TypeScript、JSON、HTML、 CSS 、S CS S和Less编程语言提供代码补全。CodeArts IDE支持任何编程语言的基于单词的补全，但也可以通过安装语言扩展来提供更丰富的代码补全。 父主题： 代码补全

从命令行新建虚拟环境 要使用“venv”手动创建虚拟环境，请使用以下命令。其中“.venv”是环境文件夹的名字。 Windows # You can also use py -3 -m venv .venv python -m venv .venv Linux # You may need to run sudo apt-get install python3-venv first python3 -m venv .venv 有关venv模块的更多详细信息，请参见Python.org上创建虚拟环境。 当您在项目文件夹内创建新的虚拟环境时，CodeArts IDE会提示您将其设置为项目解释器。 父主题： 使用Python环境

使用CamelHumps选择和导航代码 CodeArts IDE可以使用CamelHumps简化代码导航。如果editor.useCamelHumpsWords配置已启用，按下“Ctrl+Arrow”在单词之间导航会带您在CamelHump单词的各个部分之间进行导航，而不是在整个单词之间进行导航。 如果editor.honorCamelHumpsWords配置启用后，双击CamelHump单词只会选择其双击的部分，而不是整个单词。

并排编辑 您可以在垂直和水平方向打开编辑器。如果您已经打开了一个编辑器，您可以通过以下方式在现有编辑器的一侧打开另一个编辑器： 按住“Alt”或“Ctrl”键双击资源管理器中的一个文件。 按“Ctrl+\”将现有的编辑器一分为二。 资源管理器中右键单击文件，在上下文菜单中选择“在侧边打开”（“Ctrl+Enter”）。 单击编辑器右上角的。 可以将文件拖动到编辑器区域的任意一侧。 拆分编辑器时，将创建编辑器组，这些编辑器组可以容纳多个选项卡。 您可以通过“打开的编辑器”视图查看所有创建的编辑器组，您可以通过单击右侧活动栏中的打开该视图。 要快速聚焦编辑器组，请使用键盘快捷键“Ctrl+1”（聚焦第一组）、“Ctrl+2”（聚焦第二组）、“Ctrl+3”（聚焦第三组），以此类推。 新打开的文件将在当前聚焦组内打开选项卡。如有需要，您可以锁定组，以防止在其中打开新选项卡。要执行此操作，请单击组标题中的“更多操作”按钮（），然后从弹出菜单中选择“锁定组”。

代码片段 代码片段是模板，可以简化如循环或条件语句等重复代码模式的输入。CodeArts IDE为Python语言提供了多个内置的代码片段，这些片段和其他建议一起出现在代码补全（“Ctrl+I” / “Ctrl+Space”/“Ctrl+Shift+Space”）中。 代码片段通常放置在代码补全建议列表底部。要快速访问它们，请触发代码补全（“Ctrl+I”/“Ctrl+Space” /“Ctrl+Shift+Space”），然后按“Ctrl+Up”/“Up”。 常规片段 后缀片段 父主题： 代码编辑

将测试框架集成到项目中 在您的项目中启动测试框架集成： 单击CodeArts IDE底部的“测试“（）按钮来打开测试视图。 在测试视图中，单击“Configure Python Tests“按钮。 在弹出的窗口中选择测试框架来启动对应集成。 如果您选择“pytest“，Codearts会根据pytest的测试识别规范自动发现测试用例。 如果您选择“unittest“，您需要执行以下步骤来识别测试用例。 在打开的对话框中，选择包含测试源文件的项目文件夹。 在接着打开的对话框中，选择用于识别您的测试文件的文件通配符模式。 测试框架集成配置完成后，CodeArts IDE会在测试视图中展示发现的测试用例。 父主题： 测试

浏览代码 CodeArts提供了丰富的代码导航功能。例如，您可以在代码编辑器中将鼠标悬停在符号上，以查看其快速信息。通过 “Ctrl+单击” 符号，或按下 “F3” / “Alt+F11”（IDEA快捷键） / “F4”（IDEA快捷键） / “Ctrl+Enter”（IDEA快捷键） / “Ctrl+B”（IDEA快捷键），快速导航到符号的声明位置。 您也可以通过按下 “Shift+Shift” / “Ctrl+Shift+A” 来启动CodeArts IDE SmartSearch功能，立即搜索并导航到任何项目位置，查找和执行任何CodeArts IDE命令。 父主题： 简介

为什么长时间没有EIP、ELB、EVS的资源优化建议？ 若您已开通优化顾问OA，但长时间没有EIP、ELB、EVS资源优化建议，可能是以下几种原因： 您没有闲置的EIP、ELB、EVS资源。 您未开启OA的自动检查功能，且没有执行手动检查。 您不符合OA提供成本检查的条件，详见OA相关说明：https://support.huaweicloud.com/productdesc-oa/oa_01_0008.html 父主题： 成本优化

主体识别示例 本章节对主体识别AK/SK方式使用SDK进行示例说明。 主体识别示例代码只需将AK/SK信息替换为实际AK/SK，代码中可以使用初始化ImageMainObjectDetectionReq中的Image或Url配置图像信息（image和url参数二选一），示例中以url为例，配置完成后运行即可。 endpoint是华为云各服务应用区域和各服务的终端节点，详情请查看 地区和终端节点 。 主体识别调用示例代码如下： 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 package main import ( "fmt" "github.com/huaweicloud/huaweicloud-sdk-go-v3/core/auth/basic" image "github.com/huaweicloud/huaweicloud-sdk-go-v3/services/image/v2" "github.com/huaweicloud/huaweicloud-sdk-go-v3/services/image/v2/model" region "github.com/huaweicloud/huaweicloud-sdk-go-v3/services/image/v2/region" ) func main() { // 认证用的ak和sk硬编码到代码中或者明文存储都有很大的安全风险，建议在配置文件或者环境变量中密文存放，使用时解密，确保安全； // 本示例以ak和sk保存在环境变量中来实现身份验证为例，运行本示例前请先在本地环境中设置环境变量HUAWEICLOUD_SDK_AK和HUAWEICLOUD_SDK_SK。 ak := os.Getenv("HUAWEICLOUD_SDK_AK") sk := os.Getenv("HUAWEICLOUD_SDK_SK") auth := basic.NewCredentialsBuilder(). WithAk(ak). WithSk(sk). Build() client := image.NewImageClient( image.ImageClientBuilder(). WithRegion(region.ValueOf("cn-north-4")). //此处替换为您开通服务的区域 WithCredential(auth). Build()) request := &model.RunImageMainObjectDetectionRequest{} thresholdImageMainObjectDetectionReq:= float32(30) urlImageMainObjectDetectionReq:= "https://XXX.jpg" //此处替换为公网可以访问的图片地址 request.Body = &model.ImageMainObjectDetectionReq{ Threshold: &thresholdImageMainObjectDetectionReq, Url: &urlImageMainObjectDetectionReq, } response, err := client.RunImageMainObjectDetection(request) if err == nil { fmt.Printf("%+v\n", response) } else { fmt.Println(err) } } 识别结果输出到控制台表示执行成功。相关参数说明请参考主体识别API。 1 RunImageMainObjectDetectionResponse {"result":[{"label":"bounding_box","location":{"height":327.77,"top_left_x":3.7,"top_left_y":1.72,"width":463.03},"confidence":"95.73"},{"label":"main_object_box","location":{"height":328.35,"top_left_x":3.22,"top_left_y":1.5,"width":456.63},"confidence":"88.35"}]} 父主题： 使用SDK（GO）

图像标签示例 本章节对图像标签AK/SK方式使用SDK进行示例说明。 图像标签示例代码只需将AK/SK信息替换为实际AK/SK，代码中可以使用初始化ImageTaggingReq中的url或image配置图像信息（image和url参数二选一），示例中以url为例，配置完成后运行即可。 endpoint是华为云各服务应用区域和各服务的终端节点，详情请查看 地区和终端节点 。 图像标签调用示例代码如下： 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 # coding: utf-8 from huaweicloudsdkcore.auth.credentials import BasicCredentials from huaweicloudsdkcore.exceptions import exceptions from huaweicloudsdkcore.http.http_config import HttpConfig from huaweicloudsdkimage.v2 import ImageClient,RunImageTaggingRequest,ImageTaggingReq from huaweicloudsdkimage.v2.region.image_region import ImageRegion if __name__ == "__main__": # 认证用的ak和sk硬编码到代码中或者明文存储都有很大的安全风险，建议在配置文件或者环境变量中密文存放，使用时解密，确保安全； # 本示例以ak和sk保存在环境变量中来实现身份验证为例，运行本示例前请先在本地环境中设置环境变量HUAWEICLOUD_SDK_AK和HUAWEICLOUD_SDK_SK。 ak = os.getenv("HUAWEICLOUD_SDK_AK") sk = os.getenv("HUAWEICLOUD_SDK_SK") credentials = BasicCredentials(ak, sk) client = ImageClient.new_builder() \ .with_credentials(credentials) \ .with_region(ImageRegion.value_of("cn-north-1")) \ //此处替换为您开通服务的区域 .build() try: request = RunImageTaggingRequest() request.body = ImageTaggingReq( limit=50, threshold=95, language="zh", url="https://XXX.jpg" //此处替换为公网可以访问的图片地址 ) response = client.run_image_tagging(request) print(response.status_code) print(response) except exceptions.ClientRequestException as e: print(e.status_code) print(e.request_id) print(e.error_code) print(e.error_msg) 执行示例代码，控制台返回200即表示程序执行成功。相关参数说明请参考图像标签API。 1 2 3 200 {"result": {"tags": [{"confidence": "98.00", "type": "树", "tag": "树", "i18n_tag": {"zh": "树", "en": "Tree"}, "i18n_type": {"zh": "树", "en": "Tree"}, "instances": []}]}} Process finished with exit code 0 父主题： 使用SDK（Python）

图像标签示例 本章节对图像标签AK/SK方式使用SDK进行示例说明。 图像标签示例代码只需将AK/SK信息替换为实际AK/SK，代码中可以使用初始化ImageTaggingReq中的Image或Url配置图像信息（image和url参数二选一），示例中以url为例，配置完成后运行即可。 endpoint是华为云各服务应用区域和各服务的终端节点，详情请查看 地区和终端节点 。 图像标签调用示例代码如下： 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 package main import ( "fmt" "github.com/huaweicloud/huaweicloud-sdk-go-v3/core/auth/basic" image "github.com/huaweicloud/huaweicloud-sdk-go-v3/services/image/v2" "github.com/huaweicloud/huaweicloud-sdk-go-v3/services/image/v2/model" region "github.com/huaweicloud/huaweicloud-sdk-go-v3/services/image/v2/region" ) func main() { // 认证用的ak和sk硬编码到代码中或者明文存储都有很大的安全风险，建议在配置文件或者环境变量中密文存放，使用时解密，确保安全； // 本示例以ak和sk保存在环境变量中来实现身份验证为例，运行本示例前请先在本地环境中设置环境变量HUAWEICLOUD_SDK_AK和HUAWEICLOUD_SDK_SK。 ak := os.Getenv("HUAWEICLOUD_SDK_AK") sk := os.Getenv("HUAWEICLOUD_SDK_SK") auth := basic.NewCredentialsBuilder(). WithAk(ak). WithSk(sk). Build() client := image.NewImageClient( image.ImageClientBuilder(). WithRegion(region.ValueOf("cn-north-1")). //此处替换为您开通服务的区域 WithCredential(auth). Build()) request := &model.RunImageTaggingRequest{} limitImageTaggingReq:= int32(50) thresholdImageTaggingReq:= float32(95) languageImageTaggingReq:= "zh" urlImageTaggingReq:= "https://XXX.jpg" //此处替换为公网可以访问的图片地址 request.Body = &model.ImageTaggingReq{ Limit: &limitImageTaggingReq, Threshold: &thresholdImageTaggingReq, Language: &languageImageTaggingReq, Url: &urlImageTaggingReq, } response, err := client.RunImageTagging(request) if err == nil { fmt.Printf("%+v\n", response) } else { fmt.Println(err) }} 识别结果输出到控制台表示执行成功。相关参数说明请参考图像标签API。 1 2 RunImageTaggingResponse {"result": {"tags": [{"confidence": "98.01", "type": "树", "tag": "树", "i18n_tag": {"zh": "树", "en": "Tree"}, "i18n_type": {"zh": "树", "en": "Tree"}, "instances": []}]}} Process exiting with code: 0 父主题： 使用SDK（GO）

名人识别示例 本章节对名人识别AK/SK方式使用SDK进行示例说明。 名人识别示例代码只需将AK/SK信息替换为实际AK/SK，代码中可以使用CelebrityRecognitionReq中的url或image方法配置图像信息（image和url参数二选一），示例中以url为例，配置完成后运行即可。 endpoint是华为云各服务应用区域和各服务的终端节点，详情请查看 地区和终端节点 。 名人识别调用示例代码如下： using System; using System.Collections.Generic; using HuaweiCloud.SDK.Core; using HuaweiCloud.SDK.Core.Auth; using HuaweiCloud.SDK.Image; using HuaweiCloud.SDK.Image.V2; using HuaweiCloud.SDK.Image.V2.Model; using Newtonsoft.Json; namespace RunCelebrityRecognitionSolution { class Program { static void Main(string[] args){ //认证用的ak和sk硬编码到代码中或者明文存储都有很大的安全风险，建议在配置文件或者环境变量中密文存放，使用时解密，确保安全 //本示例以ak和sk保存在环境变量中来实现身份验证为例，运行本示例前请先在本地环境中设置环境变量HUAWEICLOUD_SDK_AK和HUAWEICLOUD_SDK_SK string accessKey= Environment.GetEnvironmentVariable("HUAWEICLOUD_SDK_AK", EnvironmentVariableTarget.Machine); string secretKey= Environment.GetEnvironmentVariable("HUAWEICLOUD_SDK_SK", EnvironmentVariableTarget.Machine); var config = HttpConfig.GetDefaultConfig(); config.IgnoreSslVerification = true; var auth = new BasicCredentials(ak, sk); var client = ImageClient.NewBuilder() .WithCredential(auth) .WithRegion(ImageRegion.ValueOf("cn-north-1")) //此处替换为您开通服务的区域 .WithHttpConfig(config) .Build(); var req = new RunCelebrityRecognitionRequest { }; req.Body = new CelebrityRecognitionReq() { Threshold = 0.48, Url = "https://XXX.jpg" //此处替换为公网可以访问的图片地址 }; try { var resp = client.RunCelebrityRecognition(req); var respStatusCode = resp.HttpStatusCode; Console.WriteLine(respStatusCode); Console.WriteLine(JsonConvert.DeserializeObject(resp.HttpBody)); } catch (RequestTimeoutException requestTimeoutException) { Console.WriteLine(requestTimeoutException.ErrorMessage); } catch (ServiceResponseException clientRequestException) { Console.WriteLine(clientRequestException.HttpStatusCode); Console.WriteLine(clientRequestException.ErrorCode); Console.WriteLine(clientRequestException.ErrorMsg); } catch (ConnectionException connectionException) { Console.WriteLine(connectionException.ErrorMessage); } } } } 执行示例代码文件，控制台输出名人识别结果即表示程序执行成功。相关参数说明请参考名人识别API。 1 2 3 4 5 6 7 8 9 10 11 12 13 200 { 'result': [{ 'confidence': 0.9990678852332598, 'face_detail': { 'h': 510, 'w': 357, 'x': 260, 'y': 201 }, 'label': '迈克尔·杰克逊' }] } 父主题： 使用SDK（.NET）

图像标签示例 本章节对图像标签AK/SK方式使用SDK进行示例说明。 图像标签示例代码只需将AK/SK信息替换为实际AK/SK，代码中可以使用初始化ImageTaggingReq中的url或image配置图像信息（image和url参数二选一），示例中以url为例，配置完成后运行即可。 endpoint是华为云各服务应用区域和各服务的终端节点，详情请查看 地区和终端节点 。 图像标签调用示例代码如下： using System; using System.Collections.Generic; using HuaweiCloud.SDK.Core; using HuaweiCloud.SDK.Core.Auth; using HuaweiCloud.SDK.Image; using HuaweiCloud.SDK.Image.V2; using HuaweiCloud.SDK.Image.V2.Model; using Newtonsoft.Json; namespace RunImageTaggingSolution { class Program { static void Main(string[] args) { //认证用的ak和sk硬编码到代码中或者明文存储都有很大的安全风险，建议在配置文件或者环境变量中密文存放，使用时解密，确保安全 //本示例以ak和sk保存在环境变量中来实现身份验证为例，运行本示例前请先在本地环境中设置环境变量HUAWEICLOUD_SDK_AK和HUAWEICLOUD_SDK_SK string accessKey= Environment.GetEnvironmentVariable("HUAWEICLOUD_SDK_AK", EnvironmentVariableTarget.Machine); string secretKey= Environment.GetEnvironmentVariable("HUAWEICLOUD_SDK_SK", EnvironmentVariableTarget.Machine); var config = HttpConfig.GetDefaultConfig(); config.IgnoreSslVerification = true; var auth = new BasicCredentials(ak, sk); var client = ImageClient.NewBuilder() .WithCredential(auth) .WithRegion(ImageRegion.ValueOf("cn-north-1")) //此处替换为您开通服务的区域 .WithHttpConfig(config) .Build(); var req = new RunImageTaggingRequest { }; req.Body = new ImageTaggingReq() { Limit = 50, Threshold = 95, Language = "zh", Url = "https://XXX.jpg" //此处替换为公网可以访问的图片地址 }; try { var resp = client.RunImageTagging(req); var respStatusCode = resp.HttpStatusCode; Console.WriteLine(respStatusCode); Console.WriteLine(JsonConvert.DeserializeObject(resp.HttpBody)); } catch (RequestTimeoutException requestTimeoutException) { Console.WriteLine(requestTimeoutException.ErrorMessage); } catch (ServiceResponseException clientRequestException) { Console.WriteLine(clientRequestException.HttpStatusCode); Console.WriteLine(clientRequestException.ErrorCode); Console.WriteLine(clientRequestException.ErrorMsg); } catch (ConnectionException connectionException) { Console.WriteLine(connectionException.ErrorMessage); } } } } 执行示例代码，控制台返回200即表示程序执行成功。相关参数说明请参考图像标签API。 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 200 { "result": { "tags": [ { "confidence": "98.01", "type": "树", "tag": "树", "i18n_tag": { "zh": "树", "en": "Tree" }, "i18n_type": { "zh": "树", "en": "Tree" }, "instances": [ ] } ] } } 父主题： 使用SDK（.NET）

主体识别示例 本章节对主体识别AK/SK方式使用SDK进行示例说明。 主体识别示例代码只需将AK/SK信息替换为实际AK/SK，代码中可以使用初始化ImageMainObjectDetectionReq中的url或image配置图像信息（image和url参数二选一），示例中以url为例，配置完成后运行即可。 endpoint是华为云各服务应用区域和各服务的终端节点，详情请查看 地区和终端节点 。 主体识别调用示例代码如下： 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 # coding: utf-8 from huaweicloudsdkcore.auth.credentials import BasicCredentials from huaweicloudsdkimage.v2.region.image_region import ImageRegion from huaweicloudsdkcore.exceptions import exceptions from huaweicloudsdkimage.v2 import * if __name__ == "__main__": # 认证用的ak和sk硬编码到代码中或者明文存储都有很大的安全风险，建议在配置文件或者环境变量中密文存放，使用时解密，确保安全； # 本示例以ak和sk保存在环境变量中来实现身份验证为例，运行本示例前请先在本地环境中设置环境变量HUAWEICLOUD_SDK_AK和HUAWEICLOUD_SDK_SK。 ak = os.getenv("HUAWEICLOUD_SDK_AK") sk = os.getenv("HUAWEICLOUD_SDK_SK") credentials = BasicCredentials(ak, sk) \ client = ImageClient.new_builder() \ .with_credentials(credentials) \ .with_region(ImageRegion.value_of("cn-north-4")) \ //此处替换为您开通服务的区域 .build() try: request = RunImageMainObjectDetectionRequest() request.body = ImageMainObjectDetectionReq( threshold=30, url="https://XXX.jpg" //替换为公网可以访问的图片地址 ) response = client.run_image_main_object_detection(request) print(response) except exceptions.ClientRequestException as e: print(e.status_code) print(e.request_id) print(e.error_code) print(e.error_msg) 执行示例代码文件，控制台输出主体识别结果即表示程序执行成功。相关参数说明请参考主体识别API。 1 2 3 4 5 6 7 8 { "result": [{ "label": "bounding_box", "location": {"height": 327.77, "top_left_x": 3.7, "top_left_y": 1.72, "width": 463.03}, "confidence": "95.73"}, {"label": "main_object_box", "location": {"height": 328.35, "top_left_x": 3.22, "top_left_y": 1.5, "width": 456.63}, "confidence": "88.35"}] } 父主题： 使用SDK（Python）

名人识别示例 本章节对名人识别AK/SK方式使用SDK进行示例说明。 名人识别示例代码只需将AK/SK信息替换为实际AK/SK，代码中可以使用初始化CelebrityRecognitionReq中的url或image配置图像信息（image和url参数二选一），示例中以url为例，配置完成后运行即可。 endpoint是华为云各服务应用区域和各服务的终端节点，详情请查看 地区和终端节点 。 名人识别调用示例代码如下： 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 # coding: utf-8 from huaweicloudsdkcore.auth.credentials import BasicCredentials from huaweicloudsdkcore.exceptions import exceptions from huaweicloudsdkcore.http.http_config import HttpConfig from huaweicloudsdkimage.v2 import ImageClient,RunCelebrityRecognitionRequest,CelebrityRecognitionReq from huaweicloudsdkimage.v2.region.image_region import ImageRegion if __name__ == "__main__": # 认证用的ak和sk硬编码到代码中或者明文存储都有很大的安全风险，建议在配置文件或者环境变量中密文存放，使用时解密，确保安全； # 本示例以ak和sk保存在环境变量中来实现身份验证为例，运行本示例前请先在本地环境中设置环境变量HUAWEICLOUD_SDK_AK和HUAWEICLOUD_SDK_SK。 ak = os.getenv("HUAWEICLOUD_SDK_AK") sk = os.getenv("HUAWEICLOUD_SDK_SK") credentials = BasicCredentials(ak, sk) client = ImageClient.new_builder() \ .with_credentials(credentials) \ .with_region(ImageRegion.value_of("cn-north-1")) \ //此处替换为您开通服务的区域 .build() try: request = RunCelebrityRecognitionRequest() request.body = CelebrityRecognitionReq( threshold=0, url="https://XXX.jpg" //此处替换为公网可以访问的图片地址 ) response = client.run_celebrity_recognition(request) print(response.status_code) print(response) except exceptions.ClientRequestException as e: print(e.status_code) print(e.request_id) print(e.error_code) print(e.error_msg) 执行示例代码文件，控制台输出名人识别结果即表示程序执行成功。相关参数说明请参考名人识别API。 1 2 3 4 200 {'result': [{'confidence': 0.9990678852332598, 'face_detail': {'h': 510, 'w': 357, 'x': 260, 'y': 201}, 'label': '迈克尔·杰克逊'}]} 父主题： 使用SDK（Python）

主体识别示例 本章节对主体识别AK/SK方式使用SDK进行示例说明。 主体识别示例代码只需将AK/SK信息替换为实际AK/SK，代码中可以使用ImageMainObjectDetectionReq中的url或image方法配置图像信息（image和url参数二选一），示例中以url为例，配置完成后运行即可。 endpoint是华为云各服务应用区域和各服务的终端节点，详情请查看 地区和终端节点 。 主体识别调用示例代码如下： using System; using System.Collections.Generic; using HuaweiCloud.SDK.Core; using HuaweiCloud.SDK.Core.Auth; using HuaweiCloud.SDK.Image; using HuaweiCloud.SDK.Image.V2; using HuaweiCloud.SDK.Image.V2.Model; namespace RunImageMainObjectDetectionSolution { class Program { static void Main(string[] args) { //认证用的ak和sk硬编码到代码中或者明文存储都有很大的安全风险，建议在配置文件或者环境变量中密文存放，使用时解密，确保安全 //本示例以ak和sk保存在环境变量中来实现身份验证为例，运行本示例前请先在本地环境中设置环境变量HUAWEICLOUD_SDK_AK和HUAWEICLOUD_SDK_SK string accessKey= Environment.GetEnvironmentVariable("HUAWEICLOUD_SDK_AK", EnvironmentVariableTarget.Machine); string secretKey= Environment.GetEnvironmentVariable("HUAWEICLOUD_SDK_SK", EnvironmentVariableTarget.Machine); var config = HttpConfig.GetDefaultConfig(); config.IgnoreSslVerification = true; var auth = new BasicCredentials(ak, sk); var client = ImageClient.NewBuilder() .WithCredential(auth) .WithRegion(ImageRegion.ValueOf("cn-north-4")) //此处替换为您开通服务的区域 .WithHttpConfig(config) .Build(); var req = new RunImageMainObjectDetectionRequest { }; req.Body = new ImageMainObjectDetectionReq() { Threshold = 30, Url = "https://XXX.jpg" //替换为公网可以访问的图片地址 }; try { var resp = client.RunImageMainObjectDetection(req); var respStatusCode = resp.HttpStatusCode; Console.WriteLine(respStatusCode); } catch (RequestTimeoutException requestTimeoutException) { Console.WriteLine(requestTimeoutException.ErrorMessage); } catch (ServiceResponseException clientRequestException) { Console.WriteLine(clientRequestException.HttpStatusCode); Console.WriteLine(clientRequestException.ErrorCode); Console.WriteLine(clientRequestException.ErrorMsg); } catch (ConnectionException connectionException) { Console.WriteLine(connectionException.ErrorMessage); } } } } 执行示例代码文件，控制台输出主体识别结果即表示程序执行成功。相关参数说明请参考主体识别API。 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 { "result": [{ "confidence": "95.73", "label": "bounding_box", "location": { "height": 327.77, "top_left_x": 3.7, "top_left_y": 1.72, "width": 463.03}}, { "confidence": "88.35", "label": "main_object_box", "location": { "height": 328.35, "top_left_x": 3.22, "top_left_y": 1.5, "width": 456.63} }] } 父主题： 使用SDK（.NET）

名人识别示例 本章节对名人识别AK/SK方式使用SDK进行示例说明。 名人识别示例代码只需将AK/SK信息替换为实际AK/SK，代码中可以使用初始化CelebrityRecognitionReq中的Image或Url配置图像信息（image和url参数二选一），示例中以url为例，配置完成后运行即可。 endpoint是华为云各服务应用区域和各服务的终端节点，详情请查看 地区和终端节点 。 名人识别调用示例代码如下： 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 package main import ( "fmt" "github.com/huaweicloud/huaweicloud-sdk-go-v3/core/auth/basic" image "github.com/huaweicloud/huaweicloud-sdk-go-v3/services/image/v2" "github.com/huaweicloud/huaweicloud-sdk-go-v3/services/image/v2/model" region "github.com/huaweicloud/huaweicloud-sdk-go-v3/services/image/v2/region" ) func main() { // 认证用的ak和sk硬编码到代码中或者明文存储都有很大的安全风险，建议在配置文件或者环境变量中密文存放，使用时解密，确保安全； // 本示例以ak和sk保存在环境变量中来实现身份验证为例，运行本示例前请先在本地环境中设置环境变量HUAWEICLOUD_SDK_AK和HUAWEICLOUD_SDK_SK。 ak := os.Getenv("HUAWEICLOUD_SDK_AK") sk := os.Getenv("HUAWEICLOUD_SDK_SK") auth := basic.NewCredentialsBuilder(). WithAk(ak). WithSk(sk). Build() client := image.NewImageClient( image.ImageClientBuilder(). WithRegion(region.ValueOf("cn-north-1")). //此处替换为您开通服务的区域 WithCredential(auth). Build()) request := &model.RunCelebrityRecognitionRequest{} thresholdCelebrityRecognitionReq:= float32(0.48) urlCelebrityRecognitionReq:= "https://XXX.jpg" //此处替换为公网可以访问的图片地址 request.Body = &model.CelebrityRecognitionReq{ Threshold: &thresholdCelebrityRecognitionReq, Url: &urlCelebrityRecognitionReq, } response, err := client.RunCelebrityRecognition(request) if err == nil { fmt.Printf("%+v\n", response) } else { fmt.Println(err) } } 识别结果输出到控制台表示执行成功。相关参数说明请参考名人识别API。 1 2 RunCelebrityRecognitionResponse {"result":[{"confidence":0.9990679,"face_detail":{"h":510,"w":357,"x":260,"y":201},"label":"迈克尔·杰克逊"}]} Process exiting with code: 0 父主题： 使用SDK（GO）

有哪些途径可以使用 图像搜索 的API？ 共有三种方式可以基于已构建好的请求消息发起请求。 cURL cURL是一个命令行工具，用来执行各种URL操作和信息传输。cURL充当的是HTTP客户端，可以发送HTTP请求给服务端，并接收响应消息。cURL适用于接口调试。关于cURL详细信息请参见https://curl.haxx.se/。 编码 通过编码调用接口，组装请求消息，并发送处理请求消息。 REST客户端 Mozilla、Google都为REST提供了图形化的浏览器插件，发送处理请求消息。 针对Firefox，请参见Firefox RESTClient。 针对Chrome，请参见Postman。 父主题： API使用类