华为云用户手册

微版本响应样例 如果“version”和“min_version”这两个值为空字符串，说明此endpoint不支持微版本。其中： version： 最大微版本号。 min_version：最小微版本号。 客户端应该指定最大和最小微版本范围内的微版本号去访问endpoint。客户端通过以下HTTP header指定微版本号： X-OpenStack-Nova-API-Version: 2.4 从微版本2.27开始，也可以用以下header指定微版本： Openstack-API-Version: compute 2.27 如下响应样例中支持的最大微版本为“2.14”，最小微版本为“2.1”： { "versions": [ { "id": "v2.0", "links": [ { "href": "http://openstack.example.com/v2/", "rel": "self" } ], "status": "SUPPORTED", "version": "", "min_version": "", "updated": "2011-01-21T11:33:21Z" }, { "id": "v2.1", "links": [ { "href": "http://openstack.example.com/v2.1/", "rel": "self" } ], "status": "CURRENT", "version": "2.14", "min_version": "2.1", "updated": "2013-07-23T11:33:21Z" } ] }

API风格说明 当前E CS 服务对外开放两类风格的API： ECS服务自定义规范的API（以下简称ECS API） 顺从OpenStack社区标准原生规范的API 两种风格不同，功能相近。OpenStack风格API主要用于满足您在开源生态工具方面的对接需求，在某些功能上ECS API在OpenStack社区的API基础上，做了功能增强。为了更好的使用OpenStack风格API，建议您提前了解OpenStack相关概念与知识。

微版本号介绍 微版本说明：标识API中小的改动。当接口URI使用v2.1版本的时候，用户可以指定微版本号使用相应API的新功能。使用查询API版本信息列表（废弃），可以查询当前支持的主版本和支持的最大与最小的微版本。 微版本的使用说明：用户想要使用微版本特性，需要在请求Openstack接口时，在请求头中加入微版本头：X-OpenStack-Nova-API-Version或者Openstack-API-Version，例如使用微版本2.26需要在https的请求头中加入： X-OpenStack-Nova-API-Version: 2.26或Openstack-API-Version: compute 2.26 当用户使用v2.1接口不传入微版本头时，默认使用的微版本Openstack-API-Version: compute 2.1(X-OpenStack-Nova-API-Version: 2.1)。

微版本请求样例 假设使用弹性云服务器详情信息列表API接口查询"OS-EXT-SRV-ATTR:hostname"字段。 使用v2接口，不加微版本号 GET: https://{Endpoint}/v2/74610f3a5ad941998e91f076297ecf27/servers/detail 其中{Endpoint}为 IAM 的终端节点，请参考终端节点获取。 Headers: Content-Type application/json X-Auth-Token ${token} 响应消息体： { "servers": [ { "tenant_id": "74610f3a5ad941998e91f076297ecf27", "addresses": { "05d4fb93-84e5-4964-853b-32992ffef627": [ { "OS-EXT-IPS-MAC:mac_addr": "fa:16:3e:20:17:95", "OS-EXT-IPS:type": "fixed", "addr": "192.168.0.228", "version": 4 }, { "OS-EXT-IPS-MAC:mac_addr": "fa:16:3e:20:17:95", "OS-EXT-IPS:type": "floating", "addr": "192.168.51.61", "version": 4 } ] }, "metadata": {}, "OS-EXT-STS:task_state": null, "OS-DCF:diskConfig": "MANUAL", "OS-EXT-AZ:availability_zone":"az1-dc1", "links": [ { "rel": "self", "href": "https://None/v2.1/74610f3a5ad941998e91f076297ecf27/servers/89c312bb-285a-4026-a237-d441908c2f9e" }, { "rel": "bookmark", "href": "https://None/74610f3a5ad941998e91f076297ecf27/servers/89c312bb-285a-4026-a237-d441908c2f9e" } ], "OS-EXT-STS:power_state": 1, "id": "89c312bb-285a-4026-a237-d441908c2f9e", "os-extended-volumes:volumes_attached": [ { "id": "c70c4b8e-33bd-4d1f-ab16-14a5a38cdeaf" } ], "OS-EXT-SRV-ATTR:host": "pod05.test.01", "image": { "links": [ { "rel": "bookmark", "href": "https://None/74610f3a5ad941998e91f076297ecf27/images/1189efbf-d48b-46ad-a823-94b942e2a000" } ], "id": "1189efbf-d48b-46ad-a823-94b942e2a000" }, "OS-SRV-USG:terminated_at": null, "accessIPv4": "", "accessIPv6": "", "created": "2018-05-11T03:21:56Z", "hostId": "fc7a8ff86bac050f0d9454b1b078dcc97060e819acbf06f04c3e338f", "OS-EXT-SRV-ATTR:hypervisor_hostname": "nova012@7", "key_name": "id_rsa", "flavor": { "links": [ { "rel": "bookmark", "href": "https://None/74610f3a5ad941998e91f076297ecf27/flavors/s3.small.1" } ], "id": "s3.small.1" }, "security_groups": [ { "name": "default" } ], "config_drive": "", "OS-EXT-STS:vm_state": "active", "OS-EXT-SRV-ATTR:instance_name": "instance-0016c624", "user_id": "f79791beca3c48159ac2553fff22e166", "name": "zt-test", "progress": 0, "OS-SRV-USG:launched_at": "2018-05-11T03:22:16.701600", "updated": "2018-05-11T03:22:51Z", "status": "ACTIVE" } ] } 结论：响应消息体中没有"OS-EXT-SRV-ATTR:hostname"字段。 使用v2.1接口，加微版本号 GET: https://{Endpoint}/v2.1/74610f3a5ad941998e91f076297ecf27/servers/detail 其中{Endpoint}为IAM的终端节点，请参考终端节点获取。 Headers: Content-Type application/json X-Auth-Token ${token} X-OpenStack-Nova-API-Version 2.26 响应消息体： { "servers": [ { "tenant_id": "74610f3a5ad941998e91f076297ecf27", "addresses": { "05d4fb93-84e5-4964-853b-32992ffef627": [ { "OS-EXT-IPS-MAC:mac_addr": "fa:16:3e:20:17:95", "OS-EXT-IPS:type": "fixed", "addr": "192.168.0.228", "version": 4 }, { "OS-EXT-IPS-MAC:mac_addr": "fa:16:3e:20:17:95", "OS-EXT-IPS:type": "floating", "addr": "192.168.51.61", "version": 4 } ] }, "metadata": {}, "OS-EXT-STS:task_state": null, "description": "zt-test", "OS-EXT-SRV-ATTR:hostname": "zt-test", "OS-DCF:diskConfig": "MANUAL", "OS-EXT-AZ:availability_zone":"az-test-01", "links": [ { "rel": "self", "href": "https://None/v2.1/74610f3a5ad941998e91f076297ecf27/servers/89c312bb-285a-4026-a237-d441908c2f9e" }, { "rel": "bookmark", "href": "https://None/74610f3a5ad941998e91f076297ecf27/servers/89c312bb-285a-4026-a237-d441908c2f9e" } ], "OS-EXT-STS:power_state": 1, "id": "89c312bb-285a-4026-a237-d441908c2f9e", "os-extended-volumes:volumes_attached": [ { "delete_on_termination": true, "id": "c70c4b8e-33bd-4d1f-ab16-14a5a38cdeaf" } ], "locked": false, "OS-EXT-SRV-ATTR:kernel_id": "", "OS-EXT-SRV-ATTR:host":"pod05.test.01" , "OS-EXT-SRV-ATTR:ramdisk_id": "", "image": { "links": [ { "rel": "bookmark", "href": "https://None/74610f3a5ad941998e91f076297ecf27/images/1189efbf-d48b-46ad-a823-94b942e2a000" } ], "id": "1189efbf-d48b-46ad-a823-94b942e2a000" }, "accessIPv4": "", "OS-SRV-USG:terminated_at": null, "accessIPv6": "", "OS-EXT-SRV-ATTR:launch_index": 0, "created": "2018-05-11T03:21:56Z", "OS-EXT-SRV-ATTR:user_data": null, "hostId": "fc7a8ff86bac050f0d9454b1b078dcc97060e819acbf06f04c3e338f", "OS-EXT-SRV-ATTR:reservation_id": "r-pbqmaxer", "OS-EXT-SRV-ATTR:root_device_name": "/dev/vda", "host_status": "UP", "OS-EXT-SRV-ATTR:hypervisor_hostname": "nova012@7", "tags": [], "key_name": "id_rsa", "flavor": { "links": [ { "rel": "bookmark", "href": "https://None/74610f3a5ad941998e91f076297ecf27/flavors/s3.small.1" } ], "id": "s3.small.1" }, "security_groups": [ { "name": "default" } ], "config_drive": "", "OS-EXT-STS:vm_state": "active", "OS-EXT-SRV-ATTR:instance_name": "instance-0016c624", "user_id": "f79791beca3c48159ac2553fff22e166", "name": "zt-test", "progress": 0, "OS-SRV-USG:launched_at": "2018-05-11T03:22:16.701600", "updated": "2018-05-11T03:22:51Z", "status": "ACTIVE" } ] } 结论：响应消息体中有"OS-EXT-SRV-ATTR:hostname"字段。

版本号介绍 弹性云服务器所提供的接口分为ECS接口与OpenStack原生接口。推荐您使用ECS接口。 Openstack API可以使用v2和v2.1两个版本号，v2.1版本支持v2版本所有功能，且v2.1版本支持微版本。如果使用Openstack API推荐用户使用v2.1接口。 若使用v2版本的openstack API接口，只需要把对应的API接口URI中的v2.1版本号改为v2版本号即可。

Flexus X实例开启性能模式后，性能可以提升多少？ Flexus云服务器X实例采用了柔性算力进行性能QoS保障，可以在绝大多数时间提供接近独享实例的性能QoS保障，但在极少时间内仍然存在性能波动的可能，这种保障无法满足对业务性能稳定性要求苛刻的场景（如渲染、HPC等）。为了满足此类业务场景需要，Flexus云服务器X实例推出了性能模式。开启性能模式后，Flexus云服务器X实例采取底层物理绑核技术，提供极致稳定的QoS保障能力，您可以获得非常稳定的性能保障。 因此，性能模式是一种性能保障能力，而不是性能提升或性能优化的能力。 父主题： 性能模式

不想使用Flexus X实例的性能模式了怎么办？如何计费呢？ 如果您不想使用性能模式，可以通过“变更规格”功能，关闭性能模式。变更规格具体操作详见变更Flexus X实例规格。 如果您的Flexus X实例是按需计费模式：关闭性能模式后，立即生效，此后根据关闭性能模式后的规格费用计费。 如果您的Flexus X实例是包年/包月计费模式：关闭性能模式后，立即生效，并根据剩余有效期退还相应费用。 图1 通过“变更规格”功能关闭性能模式 父主题： 性能模式

远程登录Flexus X实例时需要输入的用户名和密码是什么？ 远程登录Flexus X实例时，Windows系统Flexus X实例的默认用户名是Administrator；Linux系统Flexus X实例默认用户名是root。 如果您在购买Flexus X实例时设置了密码，远程登录时请输入输入此密码，如果您遗忘了密码，可重置密码后输入新密码登录Flexus X实例。重置密码具体操作详见重置Flexus X实例密码。 父主题： 密码

步骤2：使用IAM账户 获取Token 以获取华北-北京四（cn-north-4）区域的Token为例。 POST https://iam.cn-north-4.myhuaweicloud.com/v3/auth/tokens Request Header: Content-Type: application/json Request Body: { "auth": { "identity": { "methods": [ "password" ], "password": { "user": { "name": "username", //子账户名称 "password": "********", //子账户密码 "domain": { "name": "domainname" //主账户名称 } } } }, "scope": { "project": { "name": "project name" //区 域名 称，如cn-north-4 } } } }

自然语言处理 服务支持哪几种语言？ 自然语言处理服务各个API接口支持的语言如表1所示。 表1 NLP支持语言 接口类型 接口 支持语言 自然语言处理基础 接口 分词 中文（zh）、英文（en） 多粒度分词 中文（zh）、英文（en） 依存句法分析 中文（zh） 命名实体识别（基础版） 中文（zh）、英文（en）、西班牙文（es） 命名实体识别（领域版） 中文（zh） 文本相似度（基础版） 中文（zh）、英文（en） 文本相似度（高级版） 中文（zh） 句向量 中文（zh） 实体链接 中文（zh） 关键词抽取 中文（zh） 事件抽取 中文（zh） 成分句法分析 中文（zh） 语言生成 接口 文本摘要（基础版） 中文（zh）、英文（en） 文本摘要（领域版） 中文（zh） 诗歌生成 中文（zh） 语言理解 接口 情感分析（基础版） 中文（zh）、英文（en） 情感分析（领域版） 中文（zh） 文本分类 中文（zh） 属性级情感分析 中文（zh） 属性级情感分析（高级版） 中文（zh） 实体级情感分析 中文（zh） 意图理解 中文（zh） 文档分类 中文（zh） 机器翻译 接口 文本翻译 翻译支持的原语言和目标语言请见表2 语种识别 支持识别的文本语种请见表3 文档翻译任务创建 文档翻译当前仅支持中英互译 文档翻译状态查询 文档当前仅支持中英互译 表2 文本翻译支持的语言列表 语种名称 语言代码 阿拉伯语（即将下线） ar 德语（即将下线） de 俄语（即将下线） ru 法语（即将下线） fr 韩语（即将下线） ko 葡萄牙语（即将下线） pt 日语（即将下线） ja 泰语（即将下线） th 土耳其语（即将下线） tr 西班牙语（即将下线） es 英语 en 越南语（即将下线） vi 中文（简体） zh 自动检测输入语种并翻译成目标语种，您需要指定目标语种（即将下线）。 auto 表3 语种识别支持的语言列表 语种名称 语言代码 阿拉伯语 ar 爱沙尼亚语 et 保加利亚语 bg 冰岛语 is 波兰语 pl 波斯尼亚语 bs 波斯语 fa 丹麦语 da 德语 de 俄语 ru 法语 fr 芬兰语 fi 高棉语 km 韩语 ko 加泰罗尼亚语 ca 捷克语 cs 克罗地亚语 hr 拉脱维亚语 lv 立陶宛语 lt 罗马尼亚语 ro 马耳他语 mt 马来西亚语 ms 北马其顿语 mk 孟加拉语 bn 缅甸语 my 南非荷兰语 af 挪威语 no 葡萄牙语 pt 日语 ja 瑞典语 sv 塞尔维亚语 sr 斯洛伐克语 sk 斯洛文尼亚语 sl 斯瓦希里语 sw 泰语 th 土耳其语 tr 威尔士语 cy 乌尔都语 ur 乌克兰语 uk 西班牙语 es 希伯来语 he 希腊语 el 匈牙利语 hu 意大利语 it 印地语 hi 印尼语 id 英语 en 越南语 vi 中文 zh 无法识别语种 unk

问题描述 用户在调用语义理解api时，为什么报“The API does not exist or has not been published in the environment“错误？ 接口调用地址url: https://nlp-ext.cn-north-4.myhuaweicloud.com/0ade47a66b8025572f42c0157eb7c94b/nlg/summarization

自然语言处理基础版和领域版的区别 自然语言处理基础版接口和领域版接口基于不同算法实现，对相同文本，基础版和领域版的结果有所差别。根据测试数据，领域版效果一般优于基础版。 自然语言处理基础版接口和领域版接口所支持的计费模式也有所区别，详情请见计费说明。 表1 区分基础版和领域版的接口 接口类型 接口 自然语言处理基础服务接口 命名实体识别（基础版） 命名实体识别（领域版） 文本相似度（基础版） 文本相似度（领域版） 语言生成服务接口 文本摘要（基础版） 文本摘要（领域版） 语言理解服务接口 情感分析（基础版） 情感分析（领域版）

自然语言处理服务有哪些调用限制？ 各API所需资源不同，因此对应的限制不同，具体参看下表： 表1 NLP服务调用限制 API 单用户QPS 分词 20 多粒度分词 2 依存句法分析 2 命名实体识别（基础版） 20 命名实体识别（领域版） 20 文本相似度（基础版） 20 文本相似度（高级版） 2 句向量 20 实体链接 20 关键词抽取 20 事件抽取 2 文本摘要（基础版） 20 文本摘要（领域版） 2 诗歌生成 10 情感分析（基础版） 20 情感分析（领域版） 20 文本分类 20 意图理解 20 文本翻译 10 语种识别 10 文档翻译任务创建 1 文档翻译任务查询 10

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。 弹性负载均衡 用户私有服务 接口 无 弹性负载均衡：适用于高访问量业务和对可靠性和容灾性要求较高的业务。 云服务器 用户私有服务 接口 无 ECS：作为服务器使用。 裸金属服务器 用户私有服务 接口 无 BMS：作为服务器使用。

响应消息 响应参数如表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”时，表示无大小限制。 maxTotal RAM Size 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”时，表示无数量限制。

响应示例 { "limits": { "rate": [], "absolute": { "maxServerMeta": 128, "maxPersonality": 5, "totalServerGroupsUsed": 0, "maxImageMeta": 128, "maxPersonalitySize": 10240, "maxTotalRAMSize": 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 } } }

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。

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

基本概念 账号 用户注册时的账号，账号对其所拥有的资源及云服务具有完全的访问权限，可以重置用户密码、分配用户权限等。由于账号是付费主体，为了确保账号安全，建议您不要直接使用账号进行日常管理工作，而是创建用户并使用用户进行日常管理工作。 用户 由账号在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的获取及企业项目特性的详细信息，请参见《企业管理用户指南》。

响应示例 { "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 } ] }