华为云用户手册

支持在线卸载云硬盘的操作系统 支持在线卸载云硬盘的操作系统包括如下两个部分： 第一部分请参见外部镜像文件的镜像格式和操作系统类型。 第二部分如表1所示。 表1 支持在线卸载云硬盘的操作系统 操作系统 版本 CentOS 7.3 64bit 7.2 64bit 6.8 64bit 6.7 64bit Debian 8.6.0 64bit 8.5.0 64bit Fedora 25 64bit 24 64bit SUSE SUSE Linux Enterprise Server 12 SP2 64bit SUSE Linux Enterprise Server 12 SP1 64bit SUSE Linux Enterprise Server 11 SP4 64bit SUSE Linux Enterprise Server 12 64bit OpenSUSE 42.2 64bit 42.1 64bit Oracle Linux Server release 7.3 64bit 7.2 64bit 6.8 64bit 6.7 64bit Ubuntu Server 16.04 64bit 14.04 64bit 14.04.4 64bit Windows（不支持在线卸载SCSI类型的云硬盘） Windows Server 2008 R2 Enterprise 64bit Windows Server 2012 R2 Standard 64bit Windows Server 2016 R2 Standard 64bit Redhat Linux Enterprise 7.3 64bit 6.8 64bit 对于其他操作系统的云服务器，请先关机然后再进行卸载磁盘操作，避免由于云硬盘设备与云服务器在线卸载不兼容而产生未知问题。

操作系统监控指标说明 表1 操作系统监控支持的监控指标 指标 指标名称 指标含义 取值范围 测量对象 监控周期（原始指标） cpu_usage （Agent）CPU使用率 该指标用于统计测量对象当前CPU使用率。 单位：百分比 采集方式（Linux）：通过计算采集周期内/proc/stat中的变化得出cpu使用率。用户可以通过top命令查看 %Cpu(s)值。 采集方式（Windows）：通过WindowsAPI GetSystemTimes获取。 0~100% 云服务器 1分钟 load_average5 （Agent） 5分钟平均负载 该指标用于统计测量对象过去5分钟的CPU平均负载。 采集方式（Linux）：通过/proc/loadavg中load5/逻辑CPU个数得到。用户可以通过top命令查看load5值。 Windows系统暂不支持CPU负载指标。 ≥0 云服务器 1分钟 mem_usedPercent （Agent）内存使用率 该指标用于统计测量对象的内存使用率。 单位：百分比 采集方式（Linux）：通过/proc/meminfo文件获取,(MemTotal-MemAvailable)/MemTotal 采集方式（Windows）：计算方法为（ 已用内存量/内存总量*100%）。 0~100% 云服务器 1分钟 mountPointPrefix_disk_free （Agent）磁盘剩余存储量 该指标用于统计测量对象磁盘的剩余存储空间。 单位：GB 采集方式（Linux）：执行df -h命令，查看Avail列数据。挂载点前缀路径长度不能超过64个字符，必须以字母开头，只能包含0-9/a-z/A-Z/-/./~。 采集方式（Windows）：使用WMI接口GetDiskFreeSpaceExW获取磁盘空间数据。挂载点前缀路径长度不能超过64个字符，必须以字母开头，只能包含0-9/a-z/A-Z/-/./~。 ≥0 GB 云服务器 1分钟 mountPointPrefix_disk_usedPercent （Agent）磁盘使用率 该指标用于统计测量对象磁盘使用率，以百分比为单位。计算方式为: 磁盘已用存储量/磁盘存储总量。 单位：百分比 采集方式（Linux）：通过计算Used/Size得出。挂载点前缀路径长度不能超过64个字符，必须以字母开头，只能包含0-9/a-z/A-Z/-/./~。 采集方式（Windows）：使用WMI接口GetDiskFreeSpaceExW获取磁盘空间数据。挂载点前缀路径长度不能超过64个字符，必须以字母开头，只能包含0-9/a-z/A-Z/-/./~。 0~100% 云服务器 1分钟 disk_ioUtils （Agent）磁盘I/O使用率 该指标用于统计测量对象磁盘I/O使用率。 单位：百分比 采集方式（Linux）： 通过计算采集周期内/proc/diskstats中对应设备第十三列数据的变化得出磁盘I/O使用率。 挂载点前缀路径长度不能超过64个字符，必须以字母开头，只能包含0-9/a-z/A-Z/-/./~。 采集方式（Windows）：暂不支持。 0~100% 云服务器 1分钟 disk_inodesUsedPercent （Agent）inode已使用占比 该指标用于统计测量对象当前磁盘已使用的inode占比。 单位：百分比 采集方式（Linux）：执行df -i命令，查看IUse%列数据。挂载点前缀路径长度不能超过64个字符，必须以字母开头，只能包含0-9/a-z/A-Z/-/./~。 Windows系统暂不支持文件系统类监控指标。 0~100% 云服务器 1分钟 net_bitSent （Agent）入网带宽 该指标用于统计测量对象网卡每秒接收的比特数。 单位：bit/s 采集方式（Linux）：通过计算采集周期内/proc/net/dev中的变化得出。 采集方式（Windows）：使用WMI中MibIfRow对象获取网络指标数据。 ≥ 0 bits/s 云服务器 1分钟 net_bitRecv （Agent）出网带宽 该指标用于统计测量对象网卡每秒发送的比特数。 单位：bit/s 采集方式（Linux）：通过计算采集周期内/proc/net/dev中的变化得出。 采集方式（Windows）：使用WMI中MibIfRow对象获取网络指标数据。 ≥ 0 bits/s 云服务器 1分钟 net_packetRecv （Agent）网卡包接收速率 该指标用于统计测量对象网卡每秒接收的数据包数。 单位：Count/s 采集方式（Linux）：通过计算采集周期内/proc/net/dev中的变化得出。 采集方式（Windows）：使用WMI中MibIfRow对象获取网络指标数据。 ≥ 0 counts/s 云服务器 1分钟 net_packetSent （Agent）网卡包发送速率 该指标用于统计测量对象网卡每秒发送的数据包数。 单位：Count/s 采集方式（Linux）：通过计算采集周期内/proc/net/dev中的变化得出。 采集方式（Windows）：使用WMI中MibIfRow对象获取网络指标数据。 ≥ 0 counts/s 云服务器 1分钟 net_tcp_total （Agent）所有状态的TCP连接数总和 该指标用于统计测量对象网卡所有状态的TCP连接数总和。 ≥0 云服务器 1分钟 net_tcp_established （Agent）处于ESTABLISHED状态的TCP连接数量 该指标用于统计测量对象网卡处于ESTABLISHED状态的TCP连接数量。 ≥0 云服务器 1分钟

Java语言API示例 本示例以图像标签为例介绍如何使用JAVA调用API。 package com.huawei.ais.demo;import com.huawei.ais.sdk.util.HttpClientUtils;import java.io.File;import java.io.IOException;import java.net.URISyntaxException;import org.apache.http.Header;import org.apache.http.HttpResponse;import org.apache.http.entity.StringEntity;import org.apache.commons.codec.binary.Base64;import org.apache.commons.io.FileUtils;import org.apache.commons.io.IOUtils;import com.alibaba.fastjson.JSONObject;import org.apache.http.entity.ContentType;import org.apache.http.message.BasicHeader;/** * 此demo仅供测试使用，强烈建议使用SDK * 使用前需配置依赖jar包。jar包可通过下载SDK获取 */public class ImageTaggingDemo {public static void main(String[] args) throws URISyntaxException, UnsupportedOperationException, IOException{TokenDemo();}public static void TokenDemo() throws URISyntaxException, UnsupportedOperationException, IOException {String url = "https://{endpoint}/v2/{project_id}/image/tagging";String token = "用户获取得到的实际token值";String imgPath = "data/image-tagging.jpg"; //File path or URL of the image to be recognized.JSONObject params = new JSONObject();try {if (imgPath.indexOf("http://") != -1 || imgPath.indexOf("https://") != -1) {params.put("url", imgPath);} else {byte[] fileData = FileUtils.readFileToByteArray(new File(imgPath));String fileBase64Str = Base64.encodeBase64String(fileData);params.put("image", fileBase64Str);}Header[] headers = new Header[]{new BasicHeader("X-Auth-Token", token), new BasicHeader("Content-Type", ContentType.APPLICATION_JSON.toString())};StringEntity stringEntity = new StringEntity(params.toJSONString(), "utf-8");HttpResponse response = HttpClientUtils.post(url, headers, stringEntity);String content = IOUtils.toString(response.getEntity().getContent(), "utf-8");System.out.println(content);}catch (Exception e) {e.printStackTrace();}}} 表1 参数说明 参数 参数说明 url API请求URL，例如本示例中https://{endpoint}/v2/{project_id}/image/tagging。 token Token是用户的访问令牌，承载了用户的身份、权限等信息，用户调用API接口时，需要使用Token进行鉴权。 获取Token方法请参见认证鉴权。 imgPath 图片路径。支持图片文件路径或图片url路径。其中，图片的url路径支持公网http/https url或OBS提供的url。 父主题： 应用示例

示例 请求示例（图片文件为BASE64字符串） POST https://image.cn-north-1.myhuaweicloud.com/v1.0/vision/dark-enhance Request Header: Content-Type:application/jsonX-Auth-Token: MIINRwYJKoZIhvcNAQcCoIINODCCDTQCAQExDTALBglghkgBZQMEAgEwgguVBgkqhkiG... Request Body:{ "image":"/9j/4AAQSkZJRgABAgEASABIAAD/4RFZRXhpZgAATU0AKgAAAAgABwESAAMAAAABAAEAAAEaAAUAAAABAAAAYgEbAAUAAAABAAAAagEoAAMAAAABAAIAAAExAAIAAAAcAAAAcgEyAAIAAAAUAAAAjodpAAQAAAABAAAApAAAANAACvyAAAAnEAAK/IAAACcQQWRvYmUgUGhvdG9zaG9wIENTMyBXaW5kb3dzADIwMTc6MTA6MjAgMTA6NDU6MzYAAAAAA6ABAAMAAAAB//8AAKACAAQAAAABAAALIKADAAQAAAABAAAGQAAAAAAAAAAGAQMAAwAAAAEABgAAARoABQAAAAEAAAEeARsABQAAAAEAAAEmASgAAwAAAAEAAgAAAgEABAAAAAEAAAEuAgIABAAAAAEAABAj...", "brightness":0.9} 成功响应示例 { "result":"/9j/4AAQSkZJRgABAgEASABIAAD/4RFZRXhpZgAATU0AKgAAAAgABwESAAMAAAABAAEAAAEaAAUAAAABAAAAYgEbAAUAAAABAAAAagEoAAMAAAABAAIAAAExAAIAAAAcAAAAcgEyAAIAAAAUAAAAjodpAAQAAAABAAAApAAAANAACvyAAAAnEAAK/IAAACcQQWRvYmUgUGhvdG9zaG9wIENTMyBXaW5kb3dzADIwMTc6MTA6MjAgMTA6NDU6MzYAAAAAA6ABAAMAAAAB//8AAKACAAQAAAABAAALIKADAAQAAAABAAAGQAAAAAAAAAAGAQMAAwAAAAEABgAAARoABQAAAAEAAAEeARsABQAAAAEAAAEmASgAAwAAAAEAAgAAAgEABAAAAAEAAAEuAgIABAAAAAEAABAj..."} 失败响应示例 { "error_code": "AIS.0105", "error_msg": "Recognize Failed"}

响应消息 图片为BASE64字符串响应参数请参见表2。 表2 响应参数说明 名称 类型 说明 result String 调用成功时表示图片文件BASE64字符串。 调用失败时无此字段。 error_code String 调用失败时的错误码，具体请参见错误码。 调用成功时无此字段。 error_msg String 调用失败时的错误信息。 调用成功时无此字段。 图片为文件类型响应参数请参见表3。 表3 响应参数说明 名称 类型 说明 error_code String 调用失败时的错误码，具体请参见错误码。 调用成功时无此字段。 error_msg String 调用失败时的错误信息。 调用成功时无此字段。

使用临时授权请求鉴权 开启公共读授权访问，虽然使用比较方便，但若对于敏感的信息，例如个人的私有数据，存在泄露风险。此场景下，可以考虑OBS提供的临时授权功能。 OBS服务支持用户对OBS服务中的对象构造一个特定URL，URL中会包含鉴权信息，任何用户都可以通过该URL访问OBS中的对象，但该URL只在Expires指定的失效时间内有效。该方式用于在不提供给其他人Secret Access Key的情况下，让其他人能够执行自己定义的操作。 进一步了解和使用OBS临时授权功能，请参见《对象存储服务SDK参考》对应语言的“授权访问”章节的相关内容，下载相关的SDK及示例代码，并进行相关的编码开发，以支持相关的URL获取。

请求消息 请求参数请参见表1。 表1 请求参数说明 名称 是否必选 类型 说明 image 与file二选一 String 图片文件BASE64编码串。要求base64编码后大小不超过10MB，支持JPEG、PNG、BMP、WEBP格式。 file 与image二选一 File 图片文件。 说明： 不推荐使用该请求参数。 为了保持兼容服务端，对此类接口的支持能力，保留该请求参数，但不再展示该参数对应的请求示例和响应示例。 brightness 否 Float 亮度值，亮度值设置的越高，亮度越大。默认值0.9，取值范围[0,1]。

示例 请求示例 POST https://image.cn-north-1.myhuaweicloud.com/v1.0/bgm/recognition Request Header: Content-Type:application/jsonX-Auth-Token: MIINRwYJKoZIhvcNAQcCoIINODCCDTQCAQExDTALBglghkgBZQMEAgEwgguVBgkqhkiG... Request Body:{ "url": "https://BucketName.obs.myhuaweicloud.com/ObjectName"} 成功响应示例 { "result": { "audio_name": "my heart will go on" }} 失败响应示例 { "error_code": "AIS.0014", "error_msg": "The JSON format of the input data is incorrect."}

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。 用于获取操作API的权限。获取方法请参见获取Token接口，响应消息头中X-Subject-Token的值即为Token。 表3 请求Body参数 参数 是否必选 参数类型 描述 image 否 String 与url二选一 图像数据，base64编码，要求base64编码后大小不超过10M，最短边至少1px，最长边最大10000px，支持JPEG/PNG/BMP/WEBP格式。 url 否 String 与image二选一 图片的URL路径，目前支持: 公网HTTP/HTTPS URL 华为云OBS提供的URL，使用OBS数据需要进行授权。包括对服务授权、临时授权、匿名公开授权。详情参见配置OBS服务的访问权限。 说明： 接口响应时间依赖于图片的下载时间，如果图片下载时间过长，会返回接口调用失败。 请保证被检测图片所在的存储服务稳定可靠，建议您使用华为云OBS存储。

请求示例 “endpoint”即调用API的请求地址，不同服务不同区域的“endpoint”不同，具体请参见终端节点。 例如，服务部署在“华北-北京四”区域的“endpoint”为“image.cn-north-4.myhuaweicloud.com”，请求URL为“https://image.cn-north-4.myhuaweicloud.com/v2/{project_id}}/image/description”，“project_id”为项目ID，获取方法请参见获取项目ID和名称。 方式一：使用图片的BASE64编码，对输入图像进行画面描述，图像数据为/9j/4AAQSkZJRgABAgEASABIAAD/4RFZRXhpZgAATU0AKgAAAAgABwESAAMAAAABAAEAAAEaAAUAAAABAAAAYgEbAA... POST https://{endpoint}/v2/{project_id}/image/description{ "image" : "/9j/4AAQSkZJRgABAgEASABIAAD/4RFZRXhpZgAATU0AKgAAAAgABwESAAMAAAABAAEAAAEaAAUAAAABAAAAYgEbAA...", "url" : ""} 方式二：使用图片URL，对输入图像进行画面描述，图像URL路径为https://BucketName.obs.myhuaweicloud.com/ObjectName POST https://{endpoint}/v2/{project_id}/image/description{ "image" : "", "url" : "https://BucketName.obs.myhuaweicloud.com/ObjectName"}

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 result result Object 图像描述结果信息。 表5 ImageDescriptionInstance 参数 参数类型 描述 description String 图像描述。 状态码： 400 表6 响应Body参数 参数 参数类型 描述 error_code String 调用失败时的错误码，具体请参见错误码。 调用成功时无此字段。 error_msg String 调用失败时的错误信息。 调用成功时无此字段。

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。 用于获取操作API的权限。获取方法请参见获取Token接口，响应消息头中X-Subject-Token的值即为Token。 表3 请求Body参数 参数 是否必选 参数类型 描述 image 否 String 图像数据，base64编码，输入图像范围200px-1080px，支持JPG/PNG/BMP/JPEG/WEBP格式。 url 否 String 与image二选一 图片的URL路径，目前支持: 公网HTTP/HTTPS URL 华为云OBS提供的URL，使用OBS数据需要进行授权。包括对服务授权、临时授权、匿名公开授权。详情参见配置OBS服务的访问权限。 说明： 接口响应时间依赖于图片的下载时间，如果图片下载时间过长，会返回接口调用失败。 请保证被检测图片所在的存储服务稳定可靠，建议您使用华为云OBS存储。 lmage不支持跨区域OBS，OBS的区域需要和服务保持一致。 scale 否 Integer 图片放大倍数。目前支持2倍，3倍，4倍，默认放大为2倍。

请求示例 方式一：使用图片的BASE64编码，产出高分辨率的图像数据，图片放大倍数为2倍。 POST https://{endpoint}/v2/{project_id}/image/image-super-resolution{ "image" : "/9j/4AAQSkZJRgABAgEASABIAAD/4RFZRXhpZgAATU0AKgAAAAgABwESAAMAAAABAAEAAAEaAAUAAAABAAAAYgEbAA...", "scale" : 2} 方式二：使用图片的url，产出高分辨率的图像数据，图片放大倍数为2倍。 POST https://{endpoint}/v2/{project_id}/image/image-super-resolution{ "url" : "https://BucketName.obs.myhuaweicloud.com/ObjectName", "scale" : 2}

响应示例 状态码： 200 成功响应结果 { "result": { "result_base64": "iVBORw0KGgoAAAANSUhEUgAAAgAAAAIACAIAAAB…" }} 状态码： 400 失败响应结果 { "error_code" : "AIS.0005", "error_msg" : "The service does not exist."}

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 result result object 图像超分结果信息。 表5 result 参数 参数类型 描述 result_base64 String 超分结果图片的base64码。 状态码： 400 表6 响应Body参数 参数 参数类型 描述 error_code String 调用失败时的错误码，具体请参见错误码。 调用成功时无此字段。 error_msg String 调用失败时的错误信息。 调用成功时无此字段。

终端节点 终端节点即调用API的请求地址，不同服务不同区域的终端节点不同，您可以从地区和终端节点中查询所有服务的终端节点。 图像识别的终端节点如表1所示，请您根据业务需要选择对应区域的终端节点。 表1 图像识别的终端节点 区域名称 区域 终端节点（Endpoint） 华北-北京一 cn-north-1 image.cn-north-1.myhuaweicloud.com 华北-北京四 cn-north-4 image.cn-north-4.myhuaweicloud.com 华东-上海一 cn-east-3 image.cn-east-3.myhuaweicloud.com 父主题： 使用前必读

响应示例 状态码： 200 成功响应结果 { "result" : [ { "confidence" : 0.44977834820747375, "face_detail" : { "h" : 280, "w" : 186, "x" : 163, "y" : 117 }, "label" : "xxx" } ]} 状态码： 400 失败响应结果 { "error_code" : "AIS.0005", "error_msg" : "The service does not exist."}

请求示例 “endpoint”即调用API的请求地址，不同服务不同区域的“endpoint”不同，具体请参见终端节点。 例如，服务部署在“华北-北京四”区域的“endpoint”为“image.cn-north-4.myhuaweicloud.com”，请求URL为“https://image.cn-north-4.myhuaweicloud.com/v2/{project_id}}/image/celebrity-recognition”，“project_id”为项目ID，获取方法请参见获取项目ID和名称。 方式一：使用图片的BASE64编码，识别图中人物，返回人物信息及人脸坐标，置信度的阈值为0.48。 POST https://{endpoint}/v2/{project_id}/image/celebrity-recognition{ "image" : "/9j/4AAQSkZJRgABAgEASABIAAD/4RFZRXhpZgAATU0AKgAAAAgABwESAAMAAAABAAEAAAEaAAUAAAABAAAAYgEbAA...", "url" : "", "threshold" : 0.48} 方式二：使用图片URL，识别图中人物，返回人物信息及人脸坐标，置信度的阈值为0.48。 POST https://{endpoint}/v2/{project_id}/image/celebrity-recognition{ "image" : "", "url" : "https://BucketName.obs.myhuaweicloud.com/ObjectName", "threshold" : 0.48}

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。 用于获取操作API的权限。获取方法请参见获取Token接口，响应消息头中X-Subject-Token的值即为Token。 表3 请求Body参数 参数 是否必选 参数类型 描述 image 否 String 与url二选一 图片文件Base64编码字符串。要求base64编码后大小不超过10M。 检测人脸部分不小于40*40像素。 支持JPEG/PNG/BMP/WEBP格式。 url 否 String 与image二选一。 图片的URL路径，目前支持： 公网HTTP/HTTPS URL 华为云OBS提供的URL，使用OBS数据需要进行授权。包括对服务授权、临时授权、匿名公开授权。详情参见配置OBS服务的访问权限。 说明： 接口响应时间依赖于图片的下载时间，如果图片下载时间过长，会返回接口调用失败。 请保证被检测图片所在的存储服务稳定可靠，建议您使用华为云OBS存储。 threshold 否 Float 置信度的阈值（0~1），低于此置信数的标签，将不会返回。 默认值：0.48。

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 result Array of CelebrityRecognitionResultBody objects 调用成功时表示调用结果。 调用失败时无此字段。 表5 CelebrityRecognitionResultBody 参数 参数类型 描述 confidence Float 置信度，取值范围 0-1。 face_detail Object 名人的面部信息，包括4个值： h：人脸区域高度 w：人脸区域宽度 x：人脸区域左上角到y轴距离 y：人脸区域左上角到x轴距离 label String label为对应的名人信息。 状态码： 400 表6 响应Body参数 参数 参数类型 描述 error_code String 调用失败时的错误码，具体请参见错误码。 调用成功时无此字段。 error_msg String 调用失败时的错误信息。 调用成功时无此字段。

请求消息 表1 请求参数说明 名称 是否必选 类型 说明 image false String 与url二选一。 图像数据，base64编码，要求base64编码后大小不超过10MB，最短边至少15px，最长边最大4096px，支持JPEG、PNG、BMP、WEBP格式。 url false String 与image二选一。 图片的URL路径，目前支持： 公网HTTP/HTTPS URL OBS提供的URL，使用OBS数据需要进行授权。包括对服务授权、临时授权、匿名公开授权。详情参见配置OBS服务的访问权限。 说明： 接口响应时间依赖于图片的下载时间，如果图片下载时间过长，会返回接口调用失败。 请保证被检测图片所在的存储服务稳定可靠，推荐使用OBS服务存储图片数据。 lmage不支持跨区域OBS，OBS的区域需要和服务保持一致。 language false String zh：返回标签的语言类型为中文。 en：返回标签的语言类型为英文。 默认值为zh。 limit false Integer 最多返回的标签数，默认值：30。 threshold false Float 置信度的阈值（0~100），输入非该范围内值算法即取默认值。 默认值：0。

响应消息 响应参数请参见表2。 表2 响应参数说明 名称 类型 说明 result JSON 调用成功时为图像标签内容。 调用失败时无此字段。 tags List 标签列表集合。 confidence Float 置信度，取值范围（0~100）。 tag String 标签名称。 type String 标签的类别。有以下三种类别： object：实体标签 scene：场景标签 concept：概念标签 i18n_tag JSON 标签的国际化字段。（i18n只是个国际化标志，无特殊含义）。 zh：中文 en：英文 error_code String 调用失败时的错误码，具体请参见错误码。 调用成功时无此字段。 error_msg String 调用失败时的错误信息。 调用成功时无此字段。

基本概念 账号 用户注册华为云时的账号，账号对其所拥有的资源及云服务具有完全的访问权限，可以重置用户密码、分配用户权限等。由于账号是付费主体，为了确保账号安全，建议您不要直接使用账号进行日常管理工作，而是创建用户并使用他们进行日常管理工作。 IAM用户 由账号在IAM中创建的用户，是云服务的使用人员，具有身份凭证（密码和访问密钥）。 在我的凭证下，您可以查看账号ID和用户ID。通常在调用API的鉴权过程中，您需要用到账号、用户和密码等信息。 区域（Region） 指云资源所在的物理位置，同一区域内可用区间内网互通，不同区域间内网不互通。通过在不同地区创建云资源，可以将应用程序设计的更接近特定客户的要求，或满足不同地区的法律或其他要求。 可用区（Availability Zone） 一个可用区是一个或多个物理数据中心的集合，有独立的风火水电，AZ内逻辑上再将计算、网络、存储等资源划分成多个集群。一个Region中的多个AZ间通过高速光纤相连，以满足用户跨AZ构建高可用性系统的需求。 父主题： 使用前必读

请求示例 “endpoint”即调用API的请求地址，不同服务不同区域的“endpoint”不同，具体请参见终端节点。 例如，服务部署在“华北-北京四”区域的“endpoint”为“image.cn-north-4.myhuaweicloud.com”，请求URL为“https://image.cn-north-4.myhuaweicloud.com/v2/{project_id}}/image/tagging”，“project_id”为项目ID，获取方法请参见获取项目ID和名称。 方式一：使用图片的BASE64编码，对待处理图片返回图像标签内容及相应置信度，返回标签的语言类型为中文，置信度的阈值为70。 POST https://{endpoint}/v2/{project_id}/image/tagging{ "image" : "/9j/4AAQSkZJRgABAgEASABIAAD/4RFZRXhpZgAATU0AKgAAAAgABwESAAMAAAABAAEAAAEaAAUAAAABAAAAYgEbAA...", "url" : "", "language" : "zh", "limit" : 5, "threshold" : 70.0} 方式二：使用图片URL，对待处理图片返回图像标签内容及相应置信度，返回标签的语言类型为中文，置信度的阈值为70。 POST https://{endpoint}/v2/{project_id}/image/tagging{ "image" : "", "url" : "https://BucketName.obs.myhuaweicloud.com/ObjectName", "language" : "zh", "limit" : 5, "threshold" : 70.0}

响应示例 状态码： 200 成功响应结果 { "result" : { "tags" : [ { "confidence" : "37.51", "instances" : [ { "confidence" : "92.38", "bounding_box" : { "height" : 133.32496056189905, "top_left_x" : 53.134917332575874, "top_left_y" : 254.21347984900842, "width" : 117.5866567171537 } } ], "tag" : "人", "i18n_tag" : { "en" : "person", "zh" : "人" }, "type" : "人类", "i18n_type" : { "en" : "Human", "zh" : "人类" } } ] }} 状态码： 400 失败响应结果 { "error_code" : "AIS.0005", "error_msg" : "The service does not exist."}

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。 用于获取操作API的权限。获取方法请参见获取Token接口，响应消息头中X-Subject-Token的值即为Token。 表3 请求Body参数 参数 是否必选 参数类型 描述 image 否 String 与url二选一。 图像数据，base64编码，要求base64编码后大小不超过10M，最短边至少1px，最长边最大4096px，支持JPEG/PNG/BMP/WEBP格式。 url 否 String 与image二选一。 图片的URL路径，目前支持： 公网HTTP/HTTPS URL OBS提供的URL，使用OBS数据需要进行授权。包括对服务授权、临时授权、匿名公开授权。详情参见配置OBS服务的访问权限。 说明： 接口响应时间依赖于图片的下载时间，如果图片下载时间过长，会返回接口调用失败。 请保证被检测图片所在的存储服务稳定可靠，推荐使用OBS服务存储图片数据。 lmage不支持跨区域OBS，OBS的区域需要和服务保持一致。 language 否 String zh：返回标签的语言类型为中文。 en：返回标签的语言类型为英文。 默认值为zh。 threshold 否 Float 置信度的阈值（0~100），低于此置信数的标签，将不会返回。 默认值：60 最小值：0 最大值：100 limit 否 Integer 最多返回的tag数（取值范围：1-150）。

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 result result object 调用成功时为图像标签内容。 调用失败时无此字段。 表5 result 参数 参数类型 描述 tags Array of ImageTaggingItemBody objects 标签列表集合。 表6 ImageTaggingItemBody 参数 参数类型 描述 confidence String 置信度，将Float型置信度转为String类型返回，取值范围：0-100。 type String 标签的类别。有以下三种类别： object：实体标签 scene：场景标签 concept：概念标签 tag String 标签名称。 i18n_tag i18n_tag object 标签的多种语言输出。 i18n_type i18n_type object 标签类别的多种语言输出。 instances Array of ImageTaggingInstance objects 目标检测框信息，为空则表示没有目标检测框。 表7 i18n_tag 参数 参数类型 描述 zh String 中文标签。 en String 英文标签。 表8 i18n_type 参数 参数类型 描述 zh String 中文标签类别。 en String 英文标签类别。 表9 ImageTaggingInstance 参数 参数类型 描述 bounding_box BoundingBoxFloat Object 目标检测框位置信息。 confidence String 检测标签置信度，将Float型置信度转为String类型返回，Float取值范围（0~100）。 表10 BoundingBoxFloat 参数 参数类型 描述 width Double 检测框区域宽度。 height Double 检测框区域高度。 top_left_x Double 检测框左上角到垂直轴距离。 top_left_y Double 检测框左上角到水平轴距离。 状态码： 400 表11 响应Body参数 参数 参数类型 描述 error_code String 调用失败时的错误码，具体请参见错误码。 调用成功时无此字段。 error_msg String 调用失败时的错误信息。 调用成功时无此字段。

响应消息 图片文件为BASE64字符串响应参数请参见表2。 表2 响应参数说明 名称 类型 说明 result String 调用成功时表示图片文件BASE64字符串。 调用失败时无此字段。 error_code String 调用失败时的错误码，具体请参见错误码。 调用成功时无此字段。 error_msg String 调用失败时的错误信息。 调用成功时无此字段。 图片为文件类型响应参数请参见表3。 表3 响应参数说明 名称 类型 说明 error_code String 调用失败时的错误码，具体请参见错误码。 调用成功时无此字段。 error_msg String 调用失败时的错误信息。 调用成功时无此字段。

示例 请求示例（方式一：使用图片的BASE64编码） POST https://image.cn-north-1.myhuaweicloud.com/v1.0/vision/defog Request Header: Content-Type:application/jsonX-Auth-Token: MIINRwYJKoZIhvcNAQcCoIINODCCDTQCAQExDTALBglghkgBZQMEAgEwgguVBgkqhkiG... Request Body:{ "image":"/9j/4AAQSkZJRgABAgEASABIAAD/4RFZRXhpZgAATU0AKgAAAAgABwESAAMAAAABAAEAAAEaAAUAAAABAAAAYgEbAAUAAAABAAAAagEoAAMAAAABAAIAAAExAAIAAAAcAAAAcgEyAAIAAAAUAAAAjodpAAQAAAABAAAApAAAANAACvyAAAAnEAAK/IAAACcQQWRvYmUgUGhvdG9zaG9wIENTMyBXaW5kb3dzADIwMTc6MTA6MjAgMTA6NDU6MzYAAAAAA6ABAAMAAAAB//8AAKACAAQAAAABAAALIKADAAQAAAABAAAGQAAAAAAAAAAGAQMAAwAAAAEABgAAARoABQAAAAEAAAEeARsABQAAAAEAAAEmASgAAwAAAAEAAgAAAgEABAAAAAEAAAEuAgIABAAAAAEAABAj...", "gamma":1.5, "natural_look":true} 请求示例（方式二：使用图片文件） POST https://image.cn-north-1.myhuaweicloud.com/v1.0/vision/defog Request Header: X-Auth-Token: MIINRwYJKoZIhvcNAQcCoIINODCCDTQCAQExDTALBglghkgBZQMEAgEwgguVBgkqhkiG... Request Body(form-data):file:File(图片文件)gamma:1.5natural_look:true 方式一：图片文件为BASE64字符串。 成功响应示例 { "result":"/9j/4AAQSkZJRgABAgEASABIAAD/4RFZRXhpZgAATU0AKgAAAAgABwESAAMAAAABAAEAAAEaAAUAAAABAAAAYgEbAAUAAAABAAAAagEoAAMAAAABAAIAAAExAAIAAAAcAAAAcgEyAAIAAAAUAAAAjodpAAQAAAABAAAApAAAANAACvyAAAAnEAAK/IAAACcQQWRvYmUgUGhvdG9zaG9wIENTMyBXaW5kb3dzADIwMTc6MTA6MjAgMTA6NDU6MzYAAAAAA6ABAAMAAAAB//8AAKACAAQAAAABAAALIKADAAQAAAABAAAGQAAAAAAAAAAGAQMAAwAAAAEABgAAARoABQAAAAEAAAEeARsABQAAAAEAAAEmASgAAwAAAAEAAgAAAgEABAAAAAEAAAEuAgIABAAAAAEAABAj..."} 失败响应示例 { "error_code": "AIS.0105", "error_msg": "Recognize Failed"} 方式二：图片为文件类型。 响应样例 成功时返回图片文件字节流。 失败响应样例 { "error_code": "AIS.0105", "error_msg": "Recognize Failed"}

请求消息 请求参数请参见表1。 表1 请求参数说明 名称 是否必选 类型 说明 image 与file二选一 String 图片文件BASE64编码字符串。要求base64编码后大小不超过10MB，支持JPEG、PNG、BMP、WEBP格式。 file 与image二选一 File 图片文件。 gamma 否 Float gamma矫正值，默认为1.5，取值范围：[0.1,10]。 natural_look 否 Boolean 是否保持自然观感，默认是true。如果选择false，则图像只追求去雾效果，图像视觉效果可能不自然。