华为云用户手册

Token消息体中user name，domain name和project name分别指的是什么？ user name指 IAM 用户名称。 domain name指用户所属的账号名称。如果使用账号获取token，账号的user name和domain name相同。如果使用IAM用户获取token（账号可以创建多个IAM用户），user name和domain name不相同，user name为实际的用户名称。 project name指项目名称，如“cn-north-4”。获取方法参见获取用户名、用户ID、项目名称、项目ID。

什么是区域、可用区 使用区域和可用区来描述数据中心的位置，您可以在特定的区域、可用区创建资源。 区域（Region）：从地理位置和网络时延维度划分，同一个Region内共享弹性计算、块存储、对象存储、VPC网络、弹性公网IP、镜像等公共服务。Region分为通用Region和专属Region，通用Region指面向公共租户提供通用云服务的Region；专属Region指只承载同一类业务或只面向特定租户提供业务服务的专用Region。 可用区（AZ，Availability Zone）：一个AZ是一个或多个物理数据中心的集合，有独立的风火水电，AZ内逻辑上再将计算、网络、存储等资源划分成多个集群。一个Region中的多个AZ间通过高速光纤相连，以满足用户跨AZ构建高可用性系统的需求。 图1阐明了区域和可用区之间的关系。 图1 区域和可用区 目前，华为云已在全球多个地域开放云服务，您可以根据需求选择适合自己的区域和可用区。

如何选择区域？ 选择区域时，您需要考虑以下几个因素： 地理位置 一般情况下，建议就近选择靠近您或者您的目标用户的区域，这样可以减少网络时延，提高访问速度。不过，在基础设施、BGP网络品质、资源的操作与配置等方面，中国大陆各个区域间区别不大，如果您或者您的目标用户在中国大陆，可以不用考虑不同区域造成的网络时延问题。 云服务之间的关系 如果多个云服务一起搭配使用，需要注意： 不同区域的弹性云服务器、关系型数据库、 对象存储服务 内网不互通。 不同区域的弹性云服务器不支持跨区域部署在同一负载均衡器下。 资源的价格 不同区域的资源价格可能有差异，请参见华为云服务价格详情。

开通服务操作 进入 自然语言处理基础 官网，单击“立即使用”，进入 自然语言处理 控制台。 在“总览”页面，选择需要使用的服务，在操作列单击“开通服务”。 如果操作列无开通服务选项，请使用华为云账号，即当前IAM账号的主账号登录自然语言处理控制台。 图1 开通服务 在弹框中单击“确定”，确认开通服务。 服务开通成功后，开通状态将显示为“已开通”。 NLP服务开通后，暂不支持关闭。开通服务时，计费规则默认为“按需计费”。按需计费时，不使用NLP服务，则不收费。如果您购买了套餐包，套餐包扣减规则请参见计费规则。

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

操作步骤 编辑获取用户Token接口的Request URL、Header、Body，进行具体的API调用。 Request URL 格式为：https://IAM地区与终端节点地址/API接口URI 访问网址：地区与终端节点，获取IAM区域与终端节点地址。 目前自然语言处理基础、 语言生成 、 语言理解 和 机器翻译 服务的API均支持“华北-北京四”区域。 图1 IAM区域与终端节点 访问网址：获取用户Token，获取API接口的URI。 以cn-north4为例，则Request URL为：https://iam.cn-north-4.myhuaweicloud.com/v3/auth/tokens 选择API接口获取方式，并将Request URL填写至postman中。 图2 Request URL示例 Request Header key：Content-Type，value：application/json;charset=utf8 图3 Headers参数示例 Request Body 修改Request Body样例中参数。 { "auth": { "identity": { "methods": [ "password" ], "password": { "user": { "domain": { "name": "账号名" }, "name": "IAM用户名", "password": "IAM用户密码" } } }, "scope": { "domain": { "name": "账号名" } } } } 获取账号名、IAM用户名，请参见：获取账号、IAM用户、项目名称和ID。 如果未创建IAM用户，请先使用管理员账号创建IAM用户，在创建IAM用户时会设置IAM用户密码，详情请参见创建IAM用户。 如果是第三方系统用户，没有在本系统设置登录密码，可以通过系统登录页面的找回密码功能设置登录密码，并在password中输入新设置的密码。 单击“Send”，发送API请求。 在返回的响应头中查看获取的用户Token，用户调用IAM其他API接口时，可以使用该Token进行鉴权。 Token的有效期为24小时，需要使用一个Token鉴权时，可以先缓存起来，避免频繁调用。 如果返回错误码，例如401，表示认证失败，请确认Request Body中请求参数填写正确后重新发送请求。 如果您的调试结果异常，提示“Header Overflow”，可以参考故障处理解决Header溢出问题。

操作步骤 进入 API Explorer 平台获取IAM用户Token接口。 选择Region，编辑获取用户Token接口的请求参数，进行具体的API调用。 Region 在Region下拉列表选取您需要访问的区域。 Params nocatalog为非必填，如果设置该参数，返回的响应体中将不显示catalog信息。任何非空字符串都将解释为true，并使该字段生效。 Body 通过切换输入方式可以选择表单填写或文本输入请求体。 表单填写：通过表单填写完成请求体，无需了解JSON语法，参考示例填写参数值。 文本输入：通过文本输入完成请求体，可以直接在编辑框内编写JSON格式的请求体。 { "auth": { "identity": { "methods": [ "password" ], "password": { "user": { "domain": { "name": "IAM用户所属账号名" }, "name": "IAM用户名", "password": "IAM用户的登录密码" } } }, "scope": { "domain": { "name": "IAM用户所属账号名" } } } } 参数说明请参见：请求参数。 如果是第三方系统用户，没有在本系统设置登录密码，可以通过系统登录页面的找回密码功能设置登录密码，并在password中输入新设置的密码。 单击调试，发送API请求。 在返回的响应体中查看获取的用户Token，用户调用IAM其他API接口时，可以使用该Token进行鉴权。 Token的有效期为24小时，需要使用一个Token鉴权时，可以先缓存起来，避免频繁调用。 如果返回错误码，例如401，表示认证失败，请确认Request Body中请求参数填写正确后重新发送请求。

终端节点 终端节点用于在VPC和终端节点服务之间建立便捷、安全、私密的连接通道。 在同一区域中，通过购买终端节点可以实现所属VPC内云资源跨VPC访问终端节点服务。 终端节点与终端节点服务一一对应，访问不同类型终端节点服务的终端节点存在差异： 访问“接口”型终端节点服务的终端节点：是具备私有IP地址的弹性网络接口，作为接口型终端节点服务的通信入口。 访问“网关”型终端节点服务的终端节点：是一个网关，在其上配置路由，用于将流量指向网关型终端节点服务。 终端节点与终端节点服务一一对应，访问不同类型终端节点服务的终端节点存在差异。 根据终端节点访问的终端节点服务的类型，终端节点分为接口终端节点、网关终端节点。 接口终端节点：指访问“接口”型终端节点服务的终端节点，是具备私有IP地址的弹性网络接口，作为接口型终端节点服务的通信入口。 网关终端节点：指访问“网关”型终端节点服务的终端节点，是作为一个网关，在其上配置路由，用于将流量指向网关型终端节点服务。 终端节点的资源实例类型分为专业型、基础型，不同实例类型的特点如下： 专业型：新上线终端节点实例类型，目前已在华东二、中东-利雅得、华东-青岛、非洲-开罗区域开放。单实例带宽规格最大支持10Gbps、支持IPv6双栈、组织粒度的策略授权等功能。 基础型：原终端节点实例类型。 仅“拉美-墨西哥城一”、“拉美-圣保罗一”和“拉美-圣地亚哥”区域支持购买访问“网关”型终端节点服务的终端节点。 父主题： 基本概念

“网关”型终端节点服务 “网关”型是由系统配置的云服务类别的终端节点服务，用户无需创建，可以直接使用，如表1所示。 系统在不同区域支持的云服务不同，具体以管理控制台可配置的“服务列表”为准。 仅“拉美-墨西哥城一”、“拉美-圣保罗一”和“拉美-圣地亚哥”区域支持通过控制台直接选择“网关”类型的OBS终端节点服务。 其他区域的“网关”类型的OBS终端节点服务目前需要按照名称查找并关联终端节点，终端节点服务名称请提交工单或联系OBS服务运维人员获取。 表1 “网关”型终端节点服务 服务名称 服务类别 终端节点服务类型 终端节点服务示例 说明 对象存储服务 云服务 网关 以“拉美-墨西哥城一”为例： com.myhuaweicloud.na-mexico-1.obs obs：实现通过终端节点访问OBS内网地址。 请参见配置访问OBS服务内网地址的终端节点

“接口”型终端节点服务 “接口”型终端节点服务包括： 由系统配置的云服务类别的终端节点服务，用户无需创建，可以直接使用。 由用户私有服务创建的终端节点服务。 系统在不同区域支持的云服务不同，具体以管理控制台可配置的“服务列表”为准。 表2 “接口”型终端节点服务 服务名称 服务类别 终端节点服务类型 终端节点服务示例 说明 云解析服务 云服务 接口 以“华北-北京四”为例： com.myhuaweicloud.cn-north-4.dns dns：实现通过终端节点访问内网DNS。 API网关 云服务 接口 以“华北-北京四”为例： com.myhuaweicloud.cn-north-4.api api：实现通过终端节点访问API网关。 私有依赖库 云服务 接口 以“华南- 广州”为例： com.myhuaweicloud.cn-south-1.cloudartifact cloudartifact：实现通过终端节点访问CloudArtifact。 容器镜像服务 云服务 接口 以“华北-北京四”为例： com.myhuaweicloud.cn-north-4.swr swr：实现通过终端节点访问SWR。 请参见通过 VPC终端节点 访问SWR 智能边缘平台 云服务 接口 以“华北-北京四”为例： com.myhuaweicloud.cn-north-4.ief-placement com.myhuaweicloud.cn-north-4.ief-edgeaccess com.myhuaweicloud.cn-north-4.ief-telemetry ief：实现通过终端节点访问IEF，IEF包括以下三种终端节点服务类型： ief-placement：用于边缘节点的纳管和升级。 ief-edgeaccess：用于边缘节点与IEF发送边 云消息 。 ief-telemetry：边缘节点上传监控和日志数据。 请参见通过专线或VPN连接IEF 镜像源 云服务 接口 以“华北-北京四”为例： repo2.myhuaweicloud.com repo：实现通过终端节点访问镜像源。 数据接入服务 云服务 接口 以“华北-北京四”为例： com.myhuaweicloud.cn-north-4.dis dis：实现通过终端节点访问DIS。 弹性负载均衡 用户私有服务 接口 无 弹性负载均衡：适用于高访问量业务和对可靠性和容灾性要求较高的业务。 云服务器 用户私有服务 接口 无 E CS ：作为服务器使用。 裸金属服务器 用户私有服务 接口 无 BMS：作为服务器使用。

自助解封策略说明 自助解封策略规则说明如下： 对于同一防护IP，当日首次解封时间必须大于封堵时间30分钟以上才能解封。解封时间=2（n-1）*30分钟（n表示解封次数）。 例如，当日第一次解封需要封堵开始后30分钟，第二次解封需要封堵开始后60分钟，第三次解封需要封堵开始后120分钟。 对于同一防护IP，如果上次解封时间和本次封堵时间间隔小于30分钟，则本次解封时间的间隔=2n*30分钟（n表示解封次数）。 例如，该IP已解封过一次，上次解封时间为10:20，本次发生封堵时间为10:40，两者时间间隔小于30分钟，则本次需要封堵开始后120分钟才能解封，即12:40可以解封（本次发生封堵时间10:40后120分钟）。 如果您在30分钟内解封过其他任一IP，即使满足以上条件，也不能对该IP进行解封。 DDoS防护会根据风控自动调整自助解封次数和间隔时长。

相关操作 在目标调度规则所在行“操作”列，单击“删除”，可以删除该调度规则。 在目标调度规则所在行“操作”列，单击“查看详情”后，在弹出的页面中，可以查看调度规则的详细信息和添加的云资源信息。 在基本信息后，单击，可以修改调度规则名称和是否联动调度。 单击“添加资源”，在弹出的“添加联动资源”对话框中，修改、添加或删除云资源IP。 在目标资源所在行的“操作”列，单击“删除”可以删除联动防护的云资源；或者勾选待删除的云资源后，在列表左上角单击“删除”，批量删除云资源。

日志字段说明 本章节介绍了DDoS高防日志包含的日志字段。 表2 实例攻击日志字段说明 字段 说明 ip 被攻击IP。 ip_id 被攻击IP的ID。 attack_type 攻击的类型。 attack_protocol 该字段尚未使用，默认是0。 attack_start_time 攻击开始时间，毫秒级时间戳。 attack_status 攻击状态。 ATTACK：攻击中。 NORMAL：攻击结束。 drop_kbits 分钟级别的最大攻击流量，单位“bit”。 attack_pkts 分钟级别的最大攻击报文数。 duration_elapse 已结束安全事件的持续时间，单位“秒”。 end_time 攻击结束时间，毫秒级时间戳。未结束的安全事件，该字段为0。 max_drop_kbps 攻击流量的峰值，单位“kbps”。 max_drop_pps 攻击报文的峰值，单位“pps”。 表3 实例攻击详情字段说明 字段 说明 attackStatus 攻击状态。 attackType 攻击状态。 ATTACK：攻击中。 NORMAL：攻击结束。 attackTypeDescCn 攻击类型（中文）。 attackTypeDescEn 攻击类型（英文）。 attackUnit 攻击单位。 attacker 攻击来源。 attackerKbps 攻击流量峰值，单位“kbps”。 attackerPps 攻击流量峰值，单位“pps”。 direction 日志方向。 inbound：入方向。 outbound：出方向。 dropKbits 丢弃的流量总数，单位“kbits”。 dropPackets 丢弃的报文总数。 duration 攻击持续时间，单位“秒”。 handleTime 处理日志时间。 logTime 日志时间。 logType 日志类型。 maxDropKbps IP丢弃流量峰值，单位“kbps”。 maxDropPps IP丢弃流量峰值，单位“pps”。 port 端口号。 startTimeAlert 异常开始时间。 timeScale 时间标识（处理分钟级或小时级数据的标识）。 valid 是否成功解析到日志。 writeTime 持久化时间。 zoneIP 防护IP。 startTimeAttack 攻击开始时间。 startTimeKey 对于同一个攻击不同时间的唯一标识。

日志字段说明 本章节介绍了DDoS原生高级防护日志包含的日志字段。 表2 关键字段说明 字段 说明 currentConn 当前连接数。 maxInPps 入报文峰值（单位：pps）。 newConn 新建连接数。 deviceType 上报日志的设备类型。默认为“CLEAN”，清洗设备。 attackTypes 攻击类型，具体请参考表3。 zoneIP 防护的IP。 logType 日志类型。默认为“ip_attack_sum”，攻击日志。 maxDropPps 攻击报文峰值（单位：pps）。 maxInKbps 入流量峰值（单位：kbps）。 startTime 攻击开始时间。 endTime 攻击结束时间，为空时则表示攻击还未结束。 maxDropKbps 攻击流量峰值（单位：kbps）。 attackStatus 攻击状态。 ATTACK：攻击状态。 NORMAL：正常状态。 表3 攻击类型说明 数值 攻击类型 0-9 自定义服务攻击 10 Syn Flood攻击 11 Ack Flood攻击 12 SynAck Flood攻击 13 Fin/Rst Flood攻击 14 并发连接数超过阈值 15 新建连接数超过阈值 16 TCP分片报文攻击 17 TCP分片BandWidth limit攻击 18 TCP BandWidth limit攻击 19 UDP flood攻击 20 UDP分片攻击 21 UDP分片BandWidth limit攻击 22 UDP BandWidth limit攻击 23 ICMP BandWidth limit攻击 24 Other BandWidth limit攻击 25 总流量限流 26 HTTPS Flood攻击 27 HTTP Flood攻击 28 保留 29 DNS Query Flood攻击 30 DNS Reply Flood攻击 31 Sip Flood攻击 32 黑名单丢弃 33 HTTP URL行为异常 34 TCP分片abnormal丢弃流量 35 TCP abnormal丢弃流量 36 UDP分片abnormal丢弃流量 37 UDP abnormal丢弃流量 38 ICMP abnormal攻击 39 Other abnormal攻击 40 Connection Flood攻击 41 域名 劫持攻击 42 DNS投毒攻击报文 43 DNS反射攻击 44 超大DNS报文攻击 45 DNS源请求速率异常 46 DNS源回应速率异常 47 DNS域名请求速率异常 48 DNS域名回应包速率异常 49 DNS请求报文TTL异常 50 DNS报文格式异常 51 DNS Cache匹配丢弃攻击 52 端口扫描攻击 53 TCP Abnormal攻击(tcp 报文标记位异常) 54 BGP攻击 55 UDP关联防范异常 56 DNS NO such Name异常 57 Other 指纹攻击 58 防护对象限流攻击 59 HTTP慢速攻击 60 恶意软件防范 61 域名阻断 62 FILTER过滤 63 Web攻击抓包 64 SIP源限速攻击

前提条件 已拥有相关权限。 请确认升级规格的账号同时具有“CAD Administrator”和“BSS Administrator”角色，或者该账号具有“Tenant Administrator”角色。 BSS Administrator：费用中心、资源中心、账号中心的所有执行权限。项目级角色，在同项目中勾选。 Tenant Administrator：除 统一身份认证 服务外，其他所有服务的所有执行权限。

操作场景 业务接入DDoS高防后，您可以通过查看高防实例线路的DDoS攻击防护日志和防护域名的CC攻击防护日志，了解当前业务的网络安全状态。 在“概览”页面，您可以查看以下防护日志信息： DDoS攻击防护 可以查看高防实例线路的高防入流量峰值、攻击流量峰值和DDoS攻击次数信息，以及流量和报文两个维度的攻击类型分布、DDoS攻击事件、TOP5攻击类型流量清洗等信息。 CC攻击防护 可以查看防护域名请求与攻击次数、攻击类型分布、TOP5攻击源IP的次数等信息。

操作须知 DDoS高防不支持下载防护日志数据。 在“概览”页面，您可以查看以下时间段的防护日志数据： DDoS攻击防护 可以查看指定高防实例和线路“24小时”、“近3天”、“近7天”、“近30天”和“自定义”的DDoS攻击防护数据，其中，“自定义”可以配置查看近90天的DDoS攻击防护数据。 CC攻击防护 可以查看防护域名“昨天”、“今天”、“近3天”、“近7天”和“近30天”的CC攻击防护数据。

日志字段说明 本章节介绍了AntiDDoS日志包含的日志字段。 表2 全量日志字段说明 字段 说明 logType 日志类型。默认为“ip_attack_sum”，攻击日志。 deviceType 上报日志的设备类型。默认为“CLEAN”，清洗设备。 inKbps 入流量（单位：kbps）。 maxPps 入流量峰值（单位：pps）。 dropPps 丢弃的流量均值（单位：pps）。 maxAttackInBps 攻击流量峰值时刻的入流量值（单位：bps）。 currentConn 当前连接数。 zoneIP 防护的IP。 logTime 日志产生的时间。 attackType 攻击类型，对应的攻击类型请参考表3。 inPps 入流量（单位：pps）。 maxKbps 入流量峰值（单位：kbps）。 dropKbps 丢弃的流量均值（单位：kbps）。 startTime 攻击开始时间。 endTime 攻击结束时间，为空时则表示攻击还未结束。 maxAttackInConn 攻击流量峰值时刻的连接数。 newConn 新建连接数。 表3 攻击类型说明 数值 攻击类型 0-9 自定义服务攻击 10 Syn Flood攻击 11 Ack Flood攻击 12 SynAck Flood攻击 13 Fin/Rst Flood攻击 14 并发连接数超过阈值 15 新建连接数超过阈值 16 TCP分片报文攻击 17 TCP分片BandWidth limit攻击 18 TCP BandWidth limit攻击 19 UDP flood攻击 20 UDP分片攻击 21 UDP分片BandWidth limit攻击 22 UDP BandWidth limit攻击 23 ICMP BandWidth limit攻击 24 Other BandWidth limit攻击 25 总流量限流 26 HTTPS Flood攻击 27 HTTP Flood攻击 28 保留 29 DNS Query Flood攻击 30 DNS Reply Flood攻击 31 Sip Flood攻击 32 黑名单丢弃 33 HTTP URL行为异常 34 TCP分片abnormal丢弃流量 35 TCP abnormal丢弃流量 36 UDP分片abnormal丢弃流量 37 UDP abnormal丢弃流量 38 ICMP abnormal攻击 39 Other abnormal攻击 40 Connection Flood攻击 41 域名劫持攻击 42 DNS投毒攻击报文 43 DNS反射攻击 44 超大DNS报文攻击 45 DNS源请求速率异常 46 DNS源回应速率异常 47 DNS域名请求速率异常 48 DNS域名回应包速率异常 49 DNS请求报文TTL异常 50 DNS报文格式异常 51 DNS Cache匹配丢弃攻击 52 端口扫描攻击 53 TCP Abnormal攻击(tcp 报文标记位异常) 54 BGP攻击 55 UDP关联防范异常 56 DNS NO such Name异常 57 Other 指纹攻击 58 防护对象限流攻击 59 HTTP慢速攻击 60 恶意软件防范 61 域名阻断 62 FILTER过滤 63 Web攻击抓包 64 SIP源限速攻击

约束限制 最多支持配置8个Key/Value值。 配置的Key值不能跟nginx原生字段重复。 Value值可以自定义一个字符串，也可以配置为以$开头的变量。以$开头的变量仅支持配置如下字段： $time_local $request_id $connection_requests $tenant_id $project_id $remote_addr $remote_port $scheme $request_method $http_host $origin_uri $request_length $ssl_server_name $ssl_protocol $ssl_curves $ssl_session_reused

操作步骤 登录管理控制台。 请参考申请弹性公网IP在所需的区域购买DDoS防护专属EIP。 表1 专属EIP线路 区域 DDoS防护专属EIP线路名称 华南-广州 5_ddosalways1bgp 华北-北京二 5_DDoSAlways1bgp 华北-北京四 5_DDoSAlways1bgp 华东-上海一 5_ddosalways1bgp 华东-上海二 5_DDoSAlways1bgp 亚太-曼谷 5_thddosbgp 拉美-圣保罗一 5_brzddosbgp 拉美-圣地亚哥 5_DDoSAlways1bgp 非洲-约翰内斯堡 5_saddosbgp 中国-香港 5_DDoSAlways2bgp 亚太-新加坡 5_DDoSAlways1bgp 以上区域线路名称仅供参考，实际以控制台为准。

响应示例 { "limits": { "rate": [], "absolute": { "maxServerMeta": 128, "maxPersonality": 5, "totalServerGroupsUsed": 0, "maxImageMeta": 128, "maxPersonalitySize": 10240, "maxTotal RAM Size": 25165824, "maxTotalKeypairs": -1, "maxSecurityGroupRules": 20, "maxServerGroups": -1, "totalCoresUsed": 0, "totalRAMUsed": 0, "maxSecurityGroups": 10, "totalFloatingIpsUsed": 0, "totalInstancesUsed": 0, "totalSecurityGroupsUsed": 0, "maxTotalFloatingIps": 10, "maxTotalInstances": 2048, "maxTotalCores": 20480, "maxServerGroupMembers": -1 } } }

响应消息 响应参数如表2所示。 表2 响应参数 参数 参数类型 描述 limits Object 租户限制，详情请参见表3。 表3 limits参数信息 参数 参数类型 描述 rate List 值为空列表 absolute Object 租户配额限制，详情请参见表4。 表4 absolute参数信息 参数 参数类型 描述 maxServerMeta String 云服务器元数据数量限制。 值为“-1”时，表示无数量限制。 maxPersonality String 注入文件数量限制。 值为“-1”时，表示无数量限制。 totalServerGroupsUsed String 已使用的云服务器组数量。 maxImageMeta String 镜像元数据数量限制。 值为“-1”时，表示无数量限制。 maxPersonalitySize String 注入文件大小限制。 值为“-1”时，表示无大小限制。 maxTotalRAMSize String 总内存大小限制。 值为“-1”时，表示无大小限制。 maxTotalKeypairs String keypair数量限制。 值为“-1”时，表示无数量限制。 maxSecurityGroupRules String 安全组规则数量限制。 值为“-1”时，表示无数量限制。 微版本2.35及以上版本不支持。 maxServerGroups String 云服务器组数量限制。 值为“-1”时，表示无数量限制。 totalCoresUsed String 已使用的核数。 totalRAMUsed String 已使用的内存大小。 maxSecurityGroups String 安全组数量限制。 值为“-1”时，表示无数量限制。 totalFloatingIpsUsed String 已使用的浮动IP数量。 totalInstancesUsed String 已使用的云服务器数量。 totalSecurityGroupsUsed String 已使用的安全组数量。 maxTotalFloatingIps String 浮动IP数量限制。 值为“-1”时，表示无数量限制。 maxTotalInstances String 云服务器数量限制。 值为“-1”时，表示无数量限制。 maxTotalCores String 总核数限制。 值为“-1”时，表示无数量限制。 maxServerGroupMembers String 云服务器组成员数量限制。 值为“-1”时，表示无数量限制。

URI DELETE /v2.1/{project_id}/servers/{server_id}/tags/{tag} 参数说明请参见表1。 表1 参数说明 参数 是否必选 描述 project_id 是 项目ID。 获取方法请参见获取项目ID。 server_id 是 云服务器ID。 tag 是 待删除标签的key。如果未指定具体的标签key，将删除该弹性云服务器的所有标签。 说明： 系统近期对标签功能进行了升级。如果之前添加的Tag为“Key.Value”的形式，则删除的时候需要使用“Key”来删除。 例如：之前添加的tag为“a.b”,则系统升级后，删除时使用“a”。

分页查询 OpenStack API提供分页查询功能，通过在查询列表请求的url中添加limit和marker参数实现分页返回列表信息。参数说明见下表，分页显示的结果以显示对象的创建时间(create_time)升序排序，如果对象信息没有创建时间，则用对象的ID升序排序。 参数名称 类型 必选 说明 limit String 否 每页显示的条目数量，当limit超过nova配置的每页最大显示数量时，response将响应错误码403。 marker String 否 取值为上一页数据的最后一条记录的id，当marker参数为无效id时，response将响应错误码400。 响应消息中的next ref，代表了下一页的url。

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

概述 欢迎使用弹性云服务器（Elastic Cloud Server ，ECS）。弹性云服务器是由CPU、内存、镜像、云硬盘组成的一种可随时获取、弹性可扩展的计算服务器，同时它结合虚拟私有云、虚拟防火墙、数据多副本保存等能力，为您打造一个高效、可靠、安全的计算环境，确保您的服务持久稳定运行。弹性云服务器创建成功后，您就可以像使用自己的本地PC或物理服务器一样，在云上使用弹性云服务器。 本文档提供了弹性云服务器API的描述、语法、参数说明及示例等内容。支持的全部操作请参见API概览。 在调用ECS API之前，请确保已经充分了解ECS相关概念，详细信息请参见弹性云服务器的“产品介绍”。

响应示例 { "networks": [ { "id": "04468f37-500a-4a80-88da-af823e7a1d6c", "cidr_v6": null, "gateway": null, "label": "network_demo1", "broadcast": null, "netmask": null, "cidr": null, "dns2": null, "gateway_v6": null, "netmask_v6": null, "dns1": null }, { "id": "1fcff959-21d0-4ba8-976a-974cb564c977", "cidr_v6": null, "gateway": null, "label": "network_demo2", "broadcast": null, "netmask": null, "cidr": null, "dns2": null, "gateway_v6": null, "netmask_v6": null, "dns1": null } ] }

响应消息 表2 参数说明 参数 是否必选 参数类型 描述 networks 是 Array of objects 云服务器所在网络，内嵌云服务器网络详细信息。详情请参见表3所示。 表3 响应参数 参数 是否必选 参数类型 描述 id 是 String 网络的ID，UUID格式。 label 是 String 网络的名字 broadcast 是 String 固定为null cidr 是 String 固定为null cidr_v6 是 String 固定为null dns1 是 String 固定为null dns2 是 String 固定为null gateway 是 String 固定为null gateway_v6 是 String 固定为null netmask 是 String 固定为null netmask_v6 是 String 固定为null bridge 否 String 固定为null，UUID格式。

响应示例 { "servers": [ { "tenant_id": "edcb94a885a84ed3a3fdf8ea4d2741da", "vm_state": "active", "flavor": { "disk": 0, "name": "s2.medium.2", "id": "s2.medium.2", "vcpus": 1, "ram": 2048, "gpus":[], "asic_accelerators":[] }, "availability_zone": "az1-dc1", "user_id": "bb7f23e27e7e46f3aaceb5f53a158bdc", "created": "2023-03-18T09:02:36Z", "name": "ecs-5e70", "task_state": null, "in_recycle_bin": false, "id": "b37fd80e-ac67-4d02-b9f1-9891c9c0fabf", "updated": "2023-03-18T09:08:54Z", "spod_id": null, "status": "ACTIVE" }, { "tenant_id": "edcb94a885a84ed3a3fdf8ea4d2741da", "vm_state": "active", "flavor": { "disk": 0, "name": "s3.small.1", "id": "s3.small.1", "vcpus": 1, "ram": 1024, "gpus":[], "asic_accelerators":[] }, "availability_zone": "az1-dc1", "user_id": "bb7f23e27e7e46f3aaceb5f53a158bdc", "created": "2023-03-18T04:29:44Z", "name": "ecs-f680", "task_state": null, "in_recycle_bin": false, "id": "8380dcc9-0eac-4407-9f9e-df8c9eddeacd", "updated": "2023-03-18T04:40:25Z", "spod_id": null, "status": "ACTIVE" } ], "servers_links": [ { "rel": "next", "href": "" } ], "request_id": "2da856f5-95e6-437f-9f8b-ae7dc00a9ace" }

请求消息 请求参数如表2所示。 表2 请求参数 参数 是否必选 参数类型 描述 tags 是 Array of objects 标签列表，详情参见表3 action 是 String 操作标识（仅支持小写）：create（创建） 表3 tags 字段数据结构说明 参数 是否必选 参数类型 描述 key 是 String 键。 不能为空。 对于同一资源键值唯一。 长度不超过36个字符。 标签的键必须唯一且输入不能为空。 value 是 String 值。 长度不超过43个字符。