华为云用户手册

CarbonData特性 SQL功能：CarbonData与Spark SQL完全兼容，支持所有可以直接在Spark SQL上运行的SQL查询操作。 简单的Table数据集定义：CarbonData支持易于使用的DDL（数据定义语言）语句来定义和创建数据集。CarbonData DDL十分灵活、易于使用，并且足够强大，可以定义复杂类型的Table。 便捷的数据管理：CarbonData为数据加载和维护提供多种数据管理功能，支持加载历史数据以及增量加载新数据。CarbonData加载的数据可以基于加载时间进行删除，也可以撤销特定的数据加载操作。 CarbonData文件格式是HDFS中的列式存储格式。该格式具有许多新型列存储文件的特性。例如，分割表，压缩模式等。CarbonData具有以下独有的特点： 伴随索引的数据存储：由于在查询中设置了过滤器，可以显著加快查询性能，减少I/O扫描次数和CPU资源占用。CarbonData索引由多个级别的索引组成，处理框架可以利用这个索引来减少需要安排和处理的任务，也可以通过在任务扫描中以更精细的单元（称为blocklet）进行skip扫描来代替对整个文件的扫描。 可选择的数据编码：通过支持高效的数据压缩和全局编码方案，可基于压缩/编码数据进行查询，在将结果返回给用户之前，才将编码转化为实际数据，这被称为“延迟物化”。 支持一种数据格式应用于多种用例场景：例如交互式OLAP-style查询，顺序访问（big scan），随机访问（narrow scan）。

HBase开源增强特性：HFS HBase文件存储模块（HBase FileStream，简称HFS）是HBase的独立模块，它作为对HBase与HDFS接口的封装，应用在MRS的上层应用，为上层应用提供文件的存储、读取、删除等功能。 在Hadoop生态系统中，无论是HDFS，还是HBase，均在面对海量文件的存储的时候，在某些场景下，都会存在一些很难解决的问题： 如果把海量小文件直接保存在HDFS中，会给NameNode带来极大的压力。 由于HBase接口以及内部机制的原因，一些较大的文件也不适合直接保存到HBase中。 HFS的出现，就是为了解决需要在Hadoop中存储海量小文件，同时也要存储一些大文件的混合的场景。简单来说，就是在HBase表中，需要存放大量的小文件（10MB以下），同时又需要存放一些比较大的文件（10MB以上）。 HFS为以上场景提供了统一的操作接口，这些操作接口与HBase的函数接口类似。

HBase开源增强特性：HBase热点自愈 该功能适用于MRS 3.3.0及之后版本。 HBase是一个分布式的KV数据库，Region是HBase数据管理的最小单元。如果用户在规划表和设计rowkey不合理，请求过于集中在少量固定Region时，会导致业务压力集中在单节点，造成业务侧可感知的性能下降甚至请求失败。 HBase服务增加了MetricController实例，开启热点检测能力，能够监控每个RegionServer节点的请求流量，通过聚合分析，识别出请求偏高的节点和Region，有助于快速发现热点问题；并提供一定的热点问题自愈能力，比如热点Region自动转移或Split。对于无法提供自愈的热点场景（单rowkey热点、顺序写热点等），提供了热点限流的能力，避免单点问题影响同节点的其他正常业务。

HBase开源增强特性：使用HAR文件格式拆分WAL文件 该内容适用于MRS 3.2.0及之后版本。 当RegionServer发生故障或重启时，HMaster会使用ServerCrashProcedure对RegionServer的业务进行恢复，恢复过程中包括拆分WAL文件。在WAL文件拆分过程中，会产生大量的小文件，可能造成HDFS的性能瓶颈，导致服务恢复时间过长。 本功能主要在拆分过程中将原本的小文件写入到HAR文件中，旨在减少拆分WAL过程中产生的小文件，从而缩短RegionServer恢复时长。

HBase开源增强特性：支持多点分割 当用户在HBase创建Region预先分割的表时，用户可能不知道数据的分布趋势，所以Region的分割可能不合适，所以当系统运行一段时间后，Region需要重新分割以获得更好的查询性能，HBase只会分割空的Region。 HBase自带的Region分割只有当Region到达设定的Threshold后才会进行分割，这种分割被称为单点分割。 为了实现根据用户的需要动态分割Region以获得更好的性能这一目标，开发了多点分割又称动态分割，即把空的Region预先分割成多个Region。通过预先分割，避免了因为Region空间不足出现Region分割导致性能下降的现象。 图2 多点分割

HBase开源增强特性：容灾增强 主备集群之间的容灾能力可以增强HBase数据的高可用性，主集群提供数据服务，备用集群提供数据备份，当主集群出现故障时，备集群可以提供数据服务。相比开源Replication功能，做了如下增强： 备集群白名单功能，只接受指定集群IP的数据推送。 开源版本中replication是基于WAL同步，在备集群回放WAL实现数据备份的。对于BulkLoad，由于没有WAL产生，BulkLoad的数据不会replicate到备集群。通过将BulkLoad操作记录在WAL上，同步至备集群，备集群通过WAL读取BulkLoad操作记录，将对应的主集群的HFile加载到备集群，完成数据的备份。 开源版本中HBase对于系统表ACL做了过滤，ACL信息不会同步至备集群，通过新加一个过滤器org.apache.hadoop.hbase.replication.SystemTableWALEntryFilterAllowACL，允许ACL信息同步至备集群，用户可以通过配置hbase.replication.filter.sytemWALEntryFilter使用该过滤其实现ACL同步。 备集群只读限制，备集群只接受备集群节点内的内置管理用户对备集群的HBase进行修改操作，即备集群节点之外的HBase客户端只能对备集群的HBase进行读操作。

HBase开源增强特性：Phoenix CsvBulkLoad工具导入支持用户自定义分隔符 该内容适用于MRS 3.2.0及之后版本。 Phoenix开源CsvBulkLoad工具当前仅支持指定单个字符作为数据分割符，当用户数据文件中可能包含任意字符时，一般会采用特殊的字符串作为分隔符，为了满足此类场景，增加了对用户自定义分隔符的支持，用户可以采用限定长度内的任意可见字符进行组合作为分隔符来导入数据文件。

HBase开源增强特性：Batch TRSP HBase 2.x内核版本使用HBase Procedure框架重写了region assignment的逻辑（AMV2）。每个Region的open或者close都会有一个TransitRegionStateProcedure(TRSP)与之关联。当RegionServer因为故障或重启需要恢复业务时，HMaster会为每个需要恢复的Region创建一个TRSP，大量的TRSP需要把数据持久化到Proc WAL文件中并且需要跟RegionServer进行RPC交互，可能造成HMaster性能瓶颈，导致服务恢复时间过长。 本功能主要通过在TRSP中添加attach region的方式，利用一个TRSP将一个RegionServer所有的Region进行恢复处理，RegionServer也将进行Region的批量open/close并一次性全部上报给HMaster。 该特性只支持将Region恢复到原来的RegionServer，因此该优化生效的前提为HMaster在创建TRSP时，故障或重启的RegionServer已经重新上线。因此，该特性主要用于优化HBase重启或者服务故障恢复的时长，如果是少量RegionServer发生故障，可能因为HMaster在RegionServer重新上线前已经创建了TRSP而不生效。 该内容适用于MRS 3.2.0及之后版本。

HBase开源增强特性：HBase双读 在HBase存储场景下，因为GC、网络抖动、磁盘坏道等原因，很难保证99.9%的查询稳定性。为了满足用户大数据量随机读低毛刺的要求，新增了HBase双读特性。 HBase双读特性是建立在主备集群容灾能力之上，两套集群同时产生毛刺的概率要远远小于一套集群，即采用双集群并发访问的方式，保证查询的稳定性。当用户发起查询请求时，同时查询两个集群的HBase服务，在等待一段时间（最大容忍的毛刺时间）后，如果主集群没有返回结果，则可以使用响应最快的集群数据。原理图如下：

Doris简介 Doris是一个基于MPP架构的高性能、实时的分析型数据库，以极速易用的特点被人们所熟知，仅需亚秒级响应时间即可返回海量数据下的查询结果，不仅可以支持高并发的点查询场景，也能支持高吞吐的复杂分析场景。基于此，Apache Doris能够较好的满足报表分析、即席查询、统一数仓构建、数据湖联邦查询加速等使用场景，用户可以在此之上构建用户行为分析、AB实验平台、日志检索分析、用户画像分析、订单分析等应用。更多相关介绍请参见Apache Doris。 该组件当前为公测阶段，若需使用需联系技术支持申请白名单开通。

Doris基本概念 在Doris中，数据都以表（Table）的形式进行逻辑上的描述。 Row&Column 一张表包括行（Row）和列（Column）： Row：即用户的一行数据。 Column： 用于描述一行数据中不同的字段。 Column可以分为两大类：Key和Value。从业务角度看，Key和Value可以分别对应维度列和指标列。从聚合模型的角度来说，Key列相同的行，会聚合成一行。其中Value列的聚合方式由用户在建表时指定。 Tablet&Partition 在Doris的存储引擎中，用户数据被水平划分为若干个数据分片（Tablet，也称作数据分桶）。每个Tablet包含若干数据行。各个Tablet之间的数据没有交集，并且在物理上是独立存储的。 多个Tablet在逻辑上归属于不同的分区（Partition）。一个Tablet只属于一个Partition，而一个Partition包含若干个Tablet。因为Tablet在物理上是独立存储的，所以可以视为Partition在物理上也是独立。Tablet是数据移动、复制等操作的最小物理存储单元。 若干个Partition组成一个Table。Partition可以视为是逻辑上最小的管理单元。数据的导入与删除，只能针对一个Partition进行。 数据模型 Doris的数据模型主要分为3类：Aggregate、Unique、Duplicate。 Aggregate模型 导入数据时，对于Key列相同的行会聚合成一行，而Value列会按照设置的AggregationType进行聚合。 AggregationType目前有以下四种聚合方式： SUM：求和，多行的Value进行累加。 REPLACE：替代，下一批数据中的Value会替换之前导入过的行中的Value。 MAX：保留最大值。 MIN：保留最小值。 Unique模型 在某些多维分析场景下，用户更关注的是如何保证Key的唯一性，即如何获得Primary Key唯一性约束。因此，引入了Unique数据模型。 读时合并 Unique模型的读时合并实现完全可以用Aggregate模型中的REPLACE方式替代，其内部的实现方式和数据存储方式也完全一样。 写时合并 Unique模型的写时合并实现，不同于Aggregate模型，查询性能更接近于Duplicate模型，在有主键约束需求的场景上相比Aggregate模型有较大的查询性能优势，尤其是在聚合查询以及需要用索引过滤大量数据的查询中。 在开启了写时合并选项的Unique表中，数据在导入阶段就会去将被覆盖和被更新的数据进行标记删除，同时将新的数据写入新的文件。在查询时，所有被标记删除的数据都会在文件级别被过滤，读取出的数据就都是最新的数据，消除了读时合并中的数据聚合过程，并且能够在很多情况下支持多种谓词的下推。因此在许多场景都能带来比较大的性能提升，尤其是在有聚合查询的情况下。 Duplicate模型 在某些多维分析场景下，数据既没有主键，也没有聚合需求。可以引入Duplicate数据模型来满足这类需求。 这种数据模型区别于Aggregate和Unique模型。数据完全按照导入文件中的数据进行存储，不会有任何聚合。即使两行数据完全相同，也都会保留。 而在建表语句中指定的DUPLICATE KEY，只是用来指明底层数据按照指定的列进行排序。 数据模型的选择建议 因为数据模型在建表时就已经确定，且无法修改。所以，选择一个合适的数据模型非常重要。 Aggregate模型可以通过预聚合，极大地降低聚合查询时所需扫描的数据量和查询的计算量，非常适合有固定模式的报表类查询场景。但是该模型对count(*)查询不友好。同时因为固定了Value列上的聚合方式，在进行其他类型的聚合查询时，需要考虑语义正确性。 Unique模型针对需要唯一主键约束的场景，可以保证主键唯一性约束。但是无法利用ROLLUP等预聚合带来的查询优势。 Unique模型仅支持整行更新，如果用户既需要唯一主键约束，又需要更新部分列（例如将多张源表导入到一张Doris表的场景），则可以考虑使用Aggregate模型，同时将非主键列的聚合类型设置为REPLACE_IF_NOT_NULL。 Duplicate适合任意维度的Ad-hoc查询。虽然同样无法利用预聚合的特性，但是不受聚合模型的约束，可以发挥列存模型的优势（只读取相关列，而不需要读取所有Key列）。

Doris架构 Doris整体架构如下图所示，FE和BE节点可以横向无限扩展。 图1 Doris架构 表1 参数说明 名称 说明 MySQL Tools Doris采用MySQL协议，高度兼容MySQL语法，支持标准 SQL，用户可以通过各类客户端工具来访问Doris，并支持与 BI工具无缝对接。 FE 主要负责用户请求的接入、查询解析规划、元数据的管理、节点管理相关工作。 BE 主要负责存储数据、执行查询计划、副本负载均衡。 Leader Leader为Follower组中选举出来的一种角色。 Follower 一条元数据日志需要在多数Follower节点写入成功，才算成功。 DBalancer 将TCP和HTTPS请求根据配置的策略转发到FE节点，使得FE节点之间的数据连接尽量均衡。 当用户需要使用客户端命令连接FE节点或者访问FE节点的WebUI时，可通过DBalancer实例进行连接或者访问，其方式与直接访问FE节点的方式一致，只需将端口号修改为DBalancer对应的端口号，DBalancer实例就会将请求转发到FE节点，实现了FE节点之间的负载均衡。 Doris采用MPP的模型，节点间和节点内都是并行执行，适用于多个大表的分布式Join。 支持向量化的查询引擎、AQE（ Adaptive Query Execution ）技术、CBO 和 RBO 结合的优化策略、热数据缓存查询等。

MRS集群保留JDK说明 MRS集群是租户完全可控的大数据应用开发平台，用户基于平台开发业务后，将业务程序部署到大数据平台运行。由于需要具备开发调测能力，因此要在MRS集群中保留JDK。 此外，MRS集群功能中如下关键特性也强依赖JDK。 HBase BulkLoad HBase BulkLoad支持用户自定义proto文件将数据文件中的字段导入HBase，该特性需要使用JDK将用户自定义的proto文件转换成Java文件，然后编译成Class文件运行。 组件进程堆栈信息采集 MRS集群内角色或实例的堆栈信息采集功能依赖于JDK，具体参见“采集堆栈信息”章节。 安全风险说明：JDK中包含javac、jmap、jdb等调测工具，攻击者可以利用调测工具调试业务进程，可能造成进程中敏感信息泄露。但是此类攻击需要攻击者拿到集群节点的Shell权限后才可以执行，MRS集群部署在VPC内，有安全组控制访问，故不将MRS集群暴露给不可信网络即可消解该风险。 父主题： 安全

第三方平台直播画面突然中断是怎么回事？ 可能是MetaStudio控制台自动退出登录导致。 排查和修改方法，如下所示： 在MetaStudio控制台直播间开播成功时，需要参考图1，单击URL地址右侧的拦截图标，从下拉框中选择允许弹出窗口。 图1 直播间开播 单击“完成”，会新增弹出如图2和图3所示的2个浏览器窗口。 MetaStudio控制台超过10分钟不操作，默认会退出登录，导致第三方直播平台的直播画面也中断。需要确保图3的窗口始终是打开的，直播过程中一定不能关闭，这样第三方直播平台的直播才能顺利完成。 图2 直播窗口 图3 确保直播过程不中断的窗口 父主题： 视频直播

请求示例 购买云手机服务器 POST https://{CPH Endpoint}/v2/{project_id}/cloud-phone/servers { "server_name" : "cph-kertus-1110", "server_model_name" : "physical.kg1.4xlarge.cp", "phone_model_name" : "kg1.cp.c20.d64SSD.e1v1", "image_id" : "20060220200717f201120a2300000e91", "count" : 1, "keypair_name" : "keypair", "ports" : [ { "name" : "myServer1", "listen_port" : 20000, "internet_accessible" : "false" }, { "name" : "myServer2", "listen_port" : 20001, "internet_accessible" : "true" } ], "extend_param" : { "charging_mode" : 0, "period_type" : 2, "period_num" : 1, "is_auto_pay" : 0 }, "tenant_vpc_id" : "fca063f6-b942-42a8-9004-e5545f58d6a2", "nics" : [ { "subnet_id" : "f1cbfc37-eb42-4357-a0ec-9e4f11950908" } ], "public_ip" : { "eip" : { "type" : "5_bgp" } }, "band_width" : { "band_width_share_type" : 0, "band_width_size" : 300, "band_width_charge_mode" : 1 } }

响应示例 状态码： 200 OK { "request_id" : "1564567b8bab40f34711234cb80d8574", "order_id" : "CS1710111105S8IPB", "product_id" : "00301-25217-0--0", "server_ids" : [ "1234567b8bab40ffb711234cb80d0234", "1678567b8bab40f93711234cb80d0764" ] }

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。 通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 表3 请求Body参数 参数 是否必选 参数类型 描述 server_name 是 String 云手机服务器名称，不超过60个字符，只支持英文字母、数字、汉字、下划线和中划线。批量购买会在服务器名称后自动添加序号，比如设置此参数为server-1，那么创建的云手机服务器名称会自动按序增加数字后缀，比如为server-1-0001。 server_model_name 是 String 云手机服务器规格，不超过64个字节。 phone_model_name 是 String 云手机规格，不超过64个字节。 image_id 是 String 云手机镜像ID，不超过32个字节。 count 是 Integer 购买的云手机服务器个数，最多可购买10台。 keypair_name 否 String 密钥对名称，不超过64个字节，用于云手机ADB登录。 ports 否 Array of Port objects 云手机启用的应用端口，云手机服务会做端口转发。 extend_param 是 extend_param object 计费模式参数。 tenant_vpc_id 是 String 租户自定义的VPC ID，为待创建的云服务器所属的虚拟私有云（简称VPC），需要指定已创建VPC的ID，UUID格式。 nics 是 Array of Nic objects 租户自定义的网卡的结构体，为待创建的云服务器的网卡信息。 public_ip 是 public_ip object 租户自定义的弹性公网IP结构体。 配置云服务器的弹性IP信息的方式， 自动分配，需要指定新创建弹性IP的信息； 使用已有，需要指定已经购买的EIP ID。 phone_count_per_ip 否 Integer 多少个手机共用一个vip。默认为手机开数，表示所有手机共享1个vip。取值范围：1到手机规格开数。 phone_data_volume 否 phone_data_volume object 手机磁盘结构体，2.0规格必选。 server_share_data_volume 否 server_share_data_volume object 共享存储磁盘结构体，2.0规格可选。 band_width 是 band_width object 云手机使用的带宽信息。 availability_zone 否 String 待创建云服务器所在的可用区，需要指定可用区（AZ）的名称。如上海一可用区1为cn-east-3a。 表4 Port 参数 是否必选 参数类型 描述 name 是 String 应用端口名称，不超过16个字节，系统关键服务名称不能使用"adb"和"vnc"。 listen_port 是 Integer 端口号，大于等于10000，小于等于50000。 internet_accessible 是 String 为"true"则映射出公网访问（忽略大小写）。 为其他则不映射。 表5 extend_param 参数 是否必选 参数类型 描述 charging_mode 是 Integer 计费类型。 0：包周期 period_type 是 Integer 订购周期类型。 2：月 3：年 period_num 是 Integer 订购周期数。 当订购周期为月时，取值范围[1, 9]。 当订购周期为年时，取值范围[1,10]。 is_auto_pay 否 Integer 是否自动付款。默认不自动付款。 1：自动付款 0：不自动付款 is_auto_renew 否 Integer 是否自动续订。默认不自动续订。 1：自动续订 0：不自动续订 enterprise_project_id 否 String 企业项目ID。 该字段不传（或传为字符串“0”），则将资源绑定给默认企业项目。 表6 Nic 参数 是否必选 参数类型 描述 subnet_id 是 String 租户自定义的子网 ID，为待创建的云服务器所属的子网。 需要指定tenant_vpc_id对应VPC下已创建的子网（subnet）的网络ID，UUID格式。 ipv6_enable 否 Boolean 是否支持ipv6。 取值为true时，标识此网卡支持ipv6。 ipv6_bandwidth 否 ipv6_bandwidth object 绑定的共享带宽信息，详情请参见 ipv6_bandwidth数据结构说明。 表7 ipv6_bandwidth 参数 是否必选 参数类型 描述 band_width_id 是 String ipv6绑定的共享带宽ID。 表8 public_ip 参数 是否必选 参数类型 描述 ids 否 Array of strings 指定已有的EIP进行服务器创建，当前只支持传入一个已有的EIP ID。 eip 否 eip object 配置服务器自动分配弹性IP时，创建弹性IP的配置参数，详情见 eip 结构体。 count 否 Integer Eip数量。默认为1，不需要Eip可设置为0，取值范围为0到手机IP数。 表9 eip 参数 是否必选 参数类型 描述 type 是 String 弹性公网IP的类型。 5_telcom：电信 5_union：联通 5_bgp：全动态BGP 5_sbgp：静态BGP 表10 phone_data_volume 参数 是否必选 参数类型 描述 volume_type 是 String 磁盘类型，只支持如下类型： SSD GPSSD size 是 Integer 磁盘大小，单位GB，取值范围[10，32768]。 表11 server_share_data_volume 参数 是否必选 参数类型 描述 volume_type 是 String 磁盘类型，只支持如下类型： SSD GPSSD size 是 Integer 磁盘大小，单位GB，取值范围[10，32768]。 表12 band_width 参数 是否必选 参数类型 描述 band_width_id 否 String 云手机服务器的带宽唯一标识。 band_width_size 否 Integer 云手机服务器的带宽大小。 band_width_charge_mode 是 Integer 云手机服务器带宽的计费方式。 0：bandwidth, 按带宽计费 1：traffic, 按流量计费 band_width_share_type 是 Integer 云手机服务器的带宽类型。 0：per，独享带宽 1：whole，共享带宽

功能介绍 购买云手机服务器，支持您复用已有的VPC网络管理云手机服务器，支持云手机服务器复用您已购买的共享带宽等资源。 请确保您已具有虚拟私有云资源，创建服务器需要指定一个已有的虚拟私有云，否则无法创建服务器。同时请确保您的账号至少具有VPC ReadOnlyAccess权限，以便虚拟私有云资源可以被选取到。 请确保您的账号已成功创建密钥对，并具有查询密钥对列表的细粒度权限ecs:serverKeypairs:list。若需要创建密钥对，请确保账号具有创建密钥对的细粒度权限ecs:serverKeypairs:create。 请确保已正确创建委托（委托名称cph_admin_trust，委托服务CPH），委托未被删除， 确保委托包含VPC FullAccess权限，委托及权限校验失败将导致云服务器创建失败。创建委托时委托类型选择“云服务”，云服务选择“CPH”，即允许CPH调用云服务。 请确保您使用的账号具有Security Administrator权限。 请确保您有足够的服务器及网络配额，配额校验不通过将导致创建失败。

请求示例 切换云手机服务器 POST https://{CPH Endpoint}/v2/{project_id}/cloud-phone/servers/{server_id}/change { "phone_model_name" : "kg1.cp.c20.d64SSD.e1v1", "image_id" : "20060220200717f201120a2300000e91", "keypair_name" : "keypair", "ports" : [ { "name" : "myServer1", "listen_port" : 20000, "internet_accessible" : "false" }, { "name" : "myServer2", "listen_port" : 20001, "internet_accessible" : "true" } ], "extend_param" : { "enterprise_project_id" : "0" }, "tenant_vpc_id" : "fca063f6-b942-42a8-9004-e5545f58d6a2", "nics" : [ { "subnet_id" : "f1cbfc37-eb42-4357-a0ec-9e4f11950908" } ], "public_ip" : { "eip" : { "type" : "5_bgp" } }, "band_width" : { "band_width_share_type" : 0, "band_width_size" : 300, "band_width_charge_mode" : 1 } }

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。 通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 表3 请求Body参数 参数 是否必选 参数类型 描述 phone_model_name 是 String 云手机规格，不超过64个字节。 image_id 是 String 云手机镜像ID，不超过32个字节。 keypair_name 否 String 密钥对名称，不超过64个字节，用于云手机ADB登录。 ports 否 Array of Port objects 云手机启用的应用端口，云手机服务会做端口转发。 extend_param 否 extend_param object 扩展字段。 tenant_vpc_id 是 String 租户自定义的VPC ID，为待创建的云服务器所属的虚拟私有云（简称VPC），需要指定已创建VPC的ID，UUID格式。 nics 是 Array of Nic objects 租户自定义的网卡的结构体，为待创建的云服务器的网卡信息。 public_ip 是 public_ip object 租户自定义的弹性公网IP结构体。 配置云服务器的弹性IP信息的方式， 自动分配，需要指定新创建弹性IP的信息； 使用已有，需要指定已经购买的EIP ID。 phone_count_per_ip 否 Integer 多少个手机共用一个vip。默认为手机开数，表示所有手机共享1个vip。取值范围：1到手机规格开数。 phone_data_volume 否 phone_data_volume object 手机磁盘结构体，2.0规格必选。 server_share_data_volume 否 server_share_data_volume object 共享存储磁盘结构体，2.0规格可选。 band_width 是 band_width object 云手机使用的带宽信息。 表4 Port 参数 是否必选 参数类型 描述 name 是 String 应用端口名称，不超过16个字节，系统关键服务名称不能使用"adb"和"vnc"。 listen_port 是 Integer 端口号，大于等于10000，小于等于50000。 internet_accessible 是 String 为"true"则映射出公网访问（忽略大小写）。 为其他则不映射。 表5 extend_param 参数 是否必选 参数类型 描述 enterprise_project_id 否 String 企业项目ID。 该字段不传（或传为字符串“0”），则将资源绑定给默认企业项目。 表6 Nic 参数 是否必选 参数类型 描述 subnet_id 是 String 租户自定义的子网 ID，为待创建的云服务器所属的子网。 需要指定tenant_vpc_id对应VPC下已创建的子网（subnet）的网络ID，UUID格式。 ipv6_enable 否 Boolean 是否支持ipv6。 取值为true时，标识此网卡支持ipv6。 ipv6_bandwidth 否 ipv6_bandwidth object 绑定的共享带宽信息，详情请参见 ipv6_bandwidth数据结构说明。 表7 ipv6_bandwidth 参数 是否必选 参数类型 描述 band_width_id 是 String ipv6绑定的共享带宽ID。 表8 public_ip 参数 是否必选 参数类型 描述 ids 否 Array of strings 指定已有的EIP进行服务器创建，当前只支持传入一个已有的EIP ID。 eip 否 eip object 配置服务器自动分配弹性IP时，创建弹性IP的配置参数，详情见 eip 结构体。 count 否 Integer Eip数量。默认为1，不需要Eip可设置为0，取值范围为0到手机IP数。 表9 eip 参数 是否必选 参数类型 描述 type 是 String 弹性公网IP的类型。 5_telcom：电信 5_union：联通 5_bgp：全动态BGP 5_sbgp：静态BGP 表10 phone_data_volume 参数 是否必选 参数类型 描述 volume_type 是 String 磁盘类型，只支持如下类型： SSD GPSSD size 是 Integer 磁盘大小，单位GB，取值范围[10，32768]。 表11 server_share_data_volume 参数 是否必选 参数类型 描述 volume_type 是 String 磁盘类型，只支持如下类型： SSD GPSSD size 是 Integer 磁盘大小，单位GB，取值范围[10，32768]。 表12 band_width 参数 是否必选 参数类型 描述 band_width_id 否 String 云手机服务器的带宽唯一标识。 band_width_size 否 Integer 云手机服务器的带宽大小。 band_width_charge_mode 是 Integer 云手机服务器带宽的计费方式。 0：bandwidth, 按带宽计费 1：traffic, 按流量计费 band_width_share_type 是 Integer 云手机服务器的带宽类型。 0：per，独享带宽 1：whole，共享带宽

响应示例 状态码： 200 OK { "server_name" : "cph-418540-1620-40-old-1", "availability_zone" : "br-iaas-odin1a", "addresses" : [ { "public_ip" : "10.246.xxx.xxx", "server_ip" : "172.31.22.245", "intranet_ip" : "172.31.22.245", "access_ip" : "10.246.xxx.xxx" } ], "metadata" : { "product_id" : "OFFI451249149551403012", "order_id" : "CS2007271727F9XJE" }, "create_time" : "2020-01-01T00:00:00Z", "vpc_id" : "12021c68-730f-41fa-9884-11c616f4c9ad", "phone_model_name" : "kg1.cg.c40.d30SSD.e1v1.old", "subnet_cidr" : "172.31.0.0/16", "keypair_name" : "KeyPair-1230", "resource_project_id" : "06a5b529fa80d28b2f53c014024bed44", "server_id" : "6edb89150bc742aa81fc8ac4ff047297", "server_model_name" : "physical.kg1.4xlarge.cg", "update_time" : "2020-01-01T00:00:00Z", "cidr" : "172.31.0.0/16", "vpc_cidr" : "172.31.0.0/16", "subnet_id" : "5784d2fe-fefd-42f0-a7f1-e88454d8bc0f", "request_id" : "91d5bf46a817466daa25fc5824ab9717", "status" : 5, "network_version" : "v1", "security_groups" : [ ] }

响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 request_id String 请求的唯一标识ID。 server_name String 云手机服务器名称， 不超过65字符，只支持英文字母、数字、汉字、下划线和中划线。 availability_zone String 云手机服务器所在的可用区。 server_id String 云手机服务器的唯一标识，不超过32个字节。 server_model_name String 云手机服务器规格名称，不超过64个字节。 phone_model_name String 云手机规格名称，不超过64个字节。 keypair_name String 连接云手机所使用的密钥对的名称，不超过64个字节。 status Integer 服务器状态。 0、1、3、4：创建中 2：异常 5：正常 8：冻结 10：关机 11：关机中 12：关机失败 13：开机中 vpc_id String 云手机服务器所属虚拟私有云（简称VPC）的ID。网络版本 network_version 取值为“v1”时，表示云手机服务器所属资源租户的VPC ID；取值为“v2”时，表示租户创建服务器时指定 VPC 的 VPC ID。 cidr String 云手机服务器所属虚拟私有云（简称VPC）的网段。网络版本 network_version 取值为“v1”时，表示云手机服务器所属资源租户的VPC CIDR；取值为“v2”时，表示租户创建服务器时指定 VPC 的 VPC CIDR。 vpc_cidr String 云手机服务器所属虚拟私有云（简称VPC）的网段。网络版本 network_version 取值为“v1”时，表示云手机服务器所属资源租户的VPC CIDR；取值为“v2”时，表示租户创建服务器时指定 VPC 的 VPC CIDR。 subnet_id String 云手机服务器所属子网的ID。仅在网络版本 network_version 取值为“v2”时，该取值表示租户创建服务器时指定子网的 ID；网络版本取值为“v1”时，该字段表示云手机服务器所属资源租户的子网ID。 subnet_cidr String 云手机服务器所属子网的网段。网络版本 network_version取值为“v2”时，表示租户创建服务器时指定子网的 CIDR；取值为“v1”时，表示云手机服务器所属资源租户的子网CIDR。 resource_project_id String 云手机服务器的项目ID。 metadata metadata object 订单以及产品相关信息。 addresses Array of Address objects 云手机服务器的IP相关信息。 band_widths Array of Bandwidth objects 云手机服务器带宽信息的结构体数组。 volumes Array of Volume objects 云手机服务器卷信息的结构体数组。 share_volume_info share_volume_info object 云手机服务器的共享存储相关信息。 network_version String 是否为自定义网络的云手机服务器标识。"v1"，非自定义网络的云手机服务器。"v2"，自定义网络的云手机服务器。支持按照网络版本字段进行筛选。 enterprise_project_id String 云手机服务器所属企业项目ID。 security_groups Array of strings 服务器扩展网卡绑定的安全组信息。 系统定义网络的服务器，该字段返回为空列表。 create_time String 创建时间， 时间格式为UTC，YYYY-MM-DDTHH:MM:SSZ。 update_time String 更新时间， 时间格式为UTC，YYYY-MM-DDTHH:MM:SSZ。 表4 metadata 参数 参数类型 描述 product_id String 产品ID，不超过64个字节。 order_id String 订单ID，不超过64个字节。 表5 Address 参数 参数类型 描述 intranet_ip String 云手机服务器的内网IP，过期字段。 access_ip String 云手机服务器的公网IP，过期字段。 server_ip String 云手机服务器的内网IP，新增字段。 public_ip String 云手机服务器的公网IP，新增字段。 表6 Bandwidth 参数 参数类型 描述 band_width_name String 云手机服务器的带宽名称。 band_width_id String 云手机服务器的带宽唯一标识。 band_width_size Integer 云手机服务器的带宽大小。 band_width_charge_mode Integer 云手机服务器带宽的计费方式。 0：bandwidth, 按带宽计费 1：traffic, 按流量计费 band_width_share_type Integer 云手机服务器的带宽类型。 0：per，独享带宽 1：whole，共享带宽 create_time String 带宽创建时间， 时间格式为UTC，YYYY-MM-DDTHH:MM:SSZ。 update_time String 带宽更新时间， 时间格式为UTC，YYYY-MM-DDTHH:MM:SSZ。 表7 Volume 参数 参数类型 描述 volume_name String 云手机服务器的硬盘名称。 volume_id String 云手机服务器的硬盘唯一标识。 volume_size Integer 云手机服务器的硬盘大小，单位G。 volume_type String 云手机服务器的硬盘类型。 create_time String 硬盘创建时间， 时间格式为UTC，YYYY-MM-DDTHH:MM:SSZ。 update_time String 硬盘更新时间， 时间格式为UTC，YYYY-MM-DDTHH:MM:SSZ。 表8 share_volume_info 参数 参数类型 描述 volume_type String 共享存储磁盘类型。 size Integer 共享存储大小，单位G。 version Integer 共享存储版本： 0：共享存储1.0 1：共享存储2.0

错误码说明 当您调用API时，如果遇到“APIGW”开头的错误码，请参见API网关错误码进行处理。 状态码 错误码 错误信息 描述 处理措施 400 Ecs.0000 Request error. Try again later or contact customer service. 请求数据错误 请参考返回的error message信息检查请求体 400 Ecs.0001 Insufficient ECS quota. Contact customer service to increase quota. 租户云服务器配额不足 请参考返回的error message申请扩大相应资源的配额 400 Ecs.0002 A system exception occurred. Try again later or contact customer service. 提交任务失败 请联系技术支持进行定位 403 Ecs.0003 You do not have permission to perform this operation. Contact customer service to obtain permission. 账户受限 请参考返回的error message，检查是否余额不足，账号被冻结等 400 Ecs.0004 A system exception occurred. Try again later or contact customer service. 升权失败 请参考返回的error message，或者联系技术支持 400 Ecs.0005 Invalid parameter values. Contact customer service. 参数非法 请参考接口文档检查请求体是否为一个正确的json体 400 Ecs.0006 Invalid parameter values. Contact customer service. 市场镜像没有产品编号 请检查镜像参数 400 Ecs.0007 A system exception occurred. Try again later or contact customer service. 镜像相关属性非法 请调整规格或者镜像类型 400 Ecs.0008 A system exception occurred. Try again later or contact customer service. Flavor相关属性非法 请联系技术支持排查flavor注册是否合法 400 Ecs.0009 Another flavor must be used for resizing. Flavor未变更 变更云服务器规格时选择与原规格不同的Flavor 400 Ecs.0010 The private IP address is already being used. Select another IP address. 私有IP地址已经被使用 请更换Port 400 Ecs.0011 Ensure the password meets the password complexity requirements. 密码不符合系统要求复杂度 请检查密码的长度并修改 400 Ecs.0012 The subnet does not contain enough IP addresses. Release some IP addresses or select a different subnet. IP地址不足 请检查子网的FIP是否已经被使用完 400 Ecs.0013 The current EIP quota limit has been reached. Apply to increase the quota. EIP配额不足 EIP配额不足，请申请扩大EIP配额 400 Ecs.0014 Incorrect VPC, subnet, or security group parameter values. VPC参数不合法 请检查子网是否都属于同一个虚拟机私有云 400 Ecs.0015 Invalid disk type for this type of ECS. Select a valid disk type and try again. 该类型磁盘不适用于该类型云服务器 请检查卷的volume_type是否与Flavor匹配 400 Ecs.0016 You do not have permission to access this AZ. Request OBT permission and try again. 创建云服务器时，没有对应Flavor的公测权限。 变更云服务器规格时，没有对应Flavor的公测权限。 请申请公测权限或者更换其他规格。 400 Ecs.0017 The status of the selected disk does not meet the attachment requirements on the ECS. Select an available disk for attaching. 系统盘或数据盘所属云服务器和待挂载云服务器不同 请检查卷metadata中__system__server_id是否和待挂载的虚拟机uuid相同 400 Ecs.0018 The selected flavor has been sold out. Try another flavor. Flavor已售罄 请更换其他规格 400 Ecs.0019 The selected flavor has been canceled. Try another flavor. Flavor已下线 请更换其他规格 400 Ecs.0021 Insufficient EVS disk quota. Contact customer service to increase quota. 云硬盘配额不足 申请扩大云硬盘配额 400 Ecs.0022 Insufficient ECS group quota. Contact customer service to increase quota. 云服务器组超过用户配额 申请扩大云服务器组配额 400 Ecs.0023 project_id in token mismatches with project_id in url. token无效或者token中的tenantId和URL中的tenantId不匹配 申请合法的token或者检查URL中的项目ID 400 Ecs.0025 EVS is not authorized to obtain KMS keys for encrypting EVS disks. 未授权EVS获取KMS密钥加密云硬盘 请授权EVS获取KMS密钥加密云硬盘 400 Ecs.0027 The ECSs of this flavor cannot be created. Flavor属于私有规格，禁止使用。 请更换其他规格 400 Ecs.0028 The ECSs of this flavor cannot be created. 用户已加入该Flavor黑名单，禁止使用该规格 请更换其他规格 400 Ecs.0029 The flavor does not exist. Flavor不存在或已下线 请更换其他规格 400 Ecs.0030 The ECS has been frozen and does not support specifications modification. 云服务器被冻结 请检查账户是否被冻结或者联系技术支持 400 Ecs.0031 The image does not exist. 镜像不存在 请更换镜像 400 Ecs.0032 The image is not in Active state. 镜像状态错误，非Active状态 请更换镜像 400 Ecs.0034 The full-ECS backup does not exist or has been deleted. 整机备份不存在或已被删除. 请更换镜像 400 Ecs.0036 The flavor does not support automatic recovery. 当前规格不支持自动恢复 请更换规格 400 Ecs.0037 The flavor does not support SCSI disks. 当前规格不支持挂载SCSI类型的磁盘 请更换规格或者类型 400 Ecs.0038 The subnet does not exist. 子网不存在 请调整网络参数 400 Ecs.0039 The specified IP address does not belong to the subnet. 指定的IP不属于该子网 请修改指定的私有IP 400 Ecs.0041 Invalid description field. 描述字段不合法 请修改云服务描述字段 400 Ecs.0042 The number of attached data disks exceeds the maximum allowed limit. 挂载数据盘的个数超过限制 请调整挂载数据盘的个数 400 Ecs.0043 The disk type does not exist. 磁盘类型不存在 请修改磁盘类型 400 Ecs.0044 The disk of this type has been sold out. 该类型磁盘已售罄 请修改磁盘类型 400 Ecs.0045 The bandwidth exceeds the maximum allowed limit. 带宽大小超过限制 请调整带宽的大小 400 Ecs.0046 When creating an ECS using an image, ensure that the type of the attached data disk is the same as that required by the image. 云服务器的磁盘类型必须与快照镜像对应的磁盘一致 请调整磁盘类型 400 Ecs.0048 Ensure that the image status is Normal and that the status of the CSBS backup associated with the image is Available or Creating, and try again later. 整机镜像的状态不可用 请检查整机镜像的状态 400 Ecs.0049 The selected enterprise project has been disabled. Enable the project or select another project. 企业项目状态非法 请修改企业项目的状态 400 Ecs.0050 The number of NICs attached to the ECS exceeds the quota. 云服务器所挂网卡数超过限制。 请调整网卡的个数 400 Ecs.0051 Only SCSI disks can be attached to the ECSs of this flavor. 云服务器只能挂载scsi磁盘 请调整磁盘类型 400 Ecs.0052 Only SCSI system disks can be attached to the ECSs of this flavor. 云服务器只能挂载scsi系统盘 请调整系统盘的磁盘类型 400 Ecs.0053 Only SCSI data disks can be attached to the ECSs of this flavor. 云服务器只能挂载scsi数据盘 请调整数据盘的磁盘类型 400 Ecs.0057 The disk has already been attached to the ECS and you cannot repeatedly attach it. 云服务器已挂载当前磁盘 请替换一个新的磁盘挂载 400 Ecs.0058 You do not have permission to use a third-party image to create ECSs. 镜像的provideId和当前账号的不匹配 请检查账户权限及镜像 400 Ecs.0062 The flavor does not support the driver mode. 规格不支持设置网卡驱动类型 请更换规格 400 Ecs.0064 The VPC ID in the request is inconsistent with that in the main subnet ID. 请求体中的vpcId与主网卡的vpcId不一致 请调整网卡参数 403 Ecs.0066 This operation cannot be performed because real-name authentication has not been completed. 未实名认证受限 请检查账户是否未实名认证受限 403 Ecs.0067 Insufficient account balance. 余额不足受限 请检查账户是否余额不足受限 403 Ecs.0068 This operation cannot be performed by partners. 成为合作伙伴受限 请检查账户是否成为合作伙伴受限 403 Ecs.0069 You have not associated a payment method with your account. 未完善支付信息受限 请检查账户是否未完善支付信息受限 403 Ecs.0070 Insufficient budget. Contact the enterprise administrator and request for a budget increase. 企业部门账号预算不足受限 请检查账户是否企业部门账号预算不足受限 403 Ecs.0071 This operation cannot be performed because your account has been suspended. 黑产账号受限 请检查账户是否黑产账号受限 400 Ecs.0073 The system disk is being backed up. Wait until the execution is complete and try again. 系统卷处于卷备份过程中 系统卷处于备份中时，禁止删除系统卷 400 Ecs.0074 Window images do not support external users. 外部用户禁止创建windows虚拟机 外部用户（非内部用户、非第三方创建镜像）禁止购买windows镜像 400 Ecs.0075 Partners only support Windows images. 合作伙伴只支持购买windows镜像 合作伙伴只支持购买windows镜像 400 Ecs.0076 The spot block specification does not support the selected predefined duration. 购买的竞价实例时长超过最长限制 请调整购买竞价实例时长 400 Ecs.0077 The number of durations exceeds the maximum limit of the spot block ECS. 购买的“竞价实例时长”的个数超过最大限制 请调整购买“竞价实例时长”的个数 400 Ecs.0081 Scheduled deletion is not supported. 不支持定时销毁功能 请参考返回的error message信息检查请求体 400 Ecs.0082 Incorrect time format. 自动释放格式错误。需要使用 UTC 时间，格式为：yyyy-MM-ddTHH:mm:ssZ 请参考返回的error message信息检查请求体 403 Ecs.0083 The scheduled time has been reached. 自动销毁时间已经过期 请参考返回的error message信息检查请求体 400 Ecs.0084 Scheduled deletion is not supported. 包年/包月实例auto_terminate_time 必须为空 请参考返回的error message信息检查请求体 400 Ecs.0085 The server does not have the interface. 虚拟机没有该网卡 请更换网卡 400 Ecs.0086 The interface is not the primary interface. 网卡不是主网卡 请更换网卡 400 Ecs.0089 Tag policy compliance verification failed. Tag policy合规性校验不通过 请检查Tag policy策略，或者联系技术支持。 400 Ecs.0090 Image license type is BYOL, the BYOL feature is not supported at this time. 当前区域不支持BYOL镜像相关特性。 请更换镜像，或者联系技术支持。 400 Ecs.0100 The ECS status does not meet requirements. Make the ECS in the required status and try again. 云服务器状态不符合要求 云服务器状态不支持当前操作，请延后操作 400 Ecs.0101 The system disk is currently unresponsive. Try again later or contact customer service. 系统盘状态异常 具体原因请联系技术支持 400 Ecs.0102 The data disk is currently unresponsive. Try again later or contact customer service. 系统盘状态不支持卸载 请检查系统盘的状态 400 Ecs.0103 The disk can be attached to a server only if it exists and the state must be in the available. Make sure the disk state is available and try again. 云磁盘状态不可用 检查卷的状态或者联系技术支持更改卷状态 400 Ecs.0104 The number of EVS disks that can be attached to the ECS exceeds the maximum number allowed. Decrease the number of EVS disks to be attached and try again. 云服务器可挂载云硬盘槽位不足 请调整挂载磁盘数 400 Ecs.0105 No system disk found. Attach the system disk to the ECS and try again. 云服务器系统盘查询失败 请检查云服务器是否挂载有系统盘 400 Ecs.0106 A network exception occurred. Try again later or contact customer service. 网络状态异常 具体原因请联系技术支持进行定位 403 Ecs.0110 Contact the main account to obtain permission. 客户端禁止，权限不足 权限不足，请确认token权限，详情请参考接口返回的error message 400 Ecs.0111 The EVS disk has been detached from the ECS. Refresh the disk list and check the disk. 磁盘没有挂载至服务列表中 请检查所选磁盘信息是否已经挂载，或者更换新的磁盘 400 Ecs.0112 The ECS is not billed on a pay-per-use basis. 非按需类型云服务器不能迁移 非按需类型云服务器不能迁移，如有疑问请联系技术支持 404 Ecs.0114 The ECS does not exist. 云服务器不存在 请检查云服务器是否已经创建 400 Ecs.0118 The number of ECSs exceeds the maximum allowed limit. 批量操作的任务数超过最大限制 请检查批量操作任务中云服务器的数量 400 Ecs.0119 An encrypted disk with an unavailable key cannot be attached to an ECS. 云服务器无法挂载密钥已禁用的加密磁盘 请更改密钥的状态。 400 Ecs.0120 The yearly/monthly ECS cannot be rebuilt. 包年/包月虚拟机禁止rebuild 包年/包月虚拟机禁止rebuild，如有疑问请联系技术支持 400 Ecs.0121 The disk cannot be attached to the ECS because the disk and the ECS are in different failure domains. 挂卷失败 虚拟机和卷的故障域不一致 选择和虚拟机故障域匹配的卷挂载 400 Ecs.0201 Failed to create the NIC. Try again later or contact customer service. 创建网卡失败 请参考返回的error message，或者联系技术支持 400 Ecs.0202 Failed to create the system disk. Try again later or contact customer service. 创建系统盘失败 请参考返回的error message，或者联系技术支持 400 Ecs.0203 Failed to create the data disk. Try again later or contact customer service. 创建数据盘失败 请参考返回的error message，或者联系技术支持 400 Ecs.0204 Failed to create the ECS. Try again later or contact customer service. 创建云服务器失败 请参考返回的error message，或者联系技术支持 400 Ecs.0205 Failed to attach the data disk. Try again later or contact customer service. 挂载数据盘失败 请参考返回的error message，或者联系技术支持 400 Ecs.0207 Failed to modify the ECS specifications. Try again later or contact customer service. 变更云服务器规格失败 请参考返回的error message，或者联系技术支持 400 Ecs.0208 A system exception occurred. Try again later or contact customer service. 更新镜像metadata失败 请参考返回的error message，或者联系技术支持 400 Ecs.0209 Failed to modify the ECS specifications. Try again or contact customer service. 确认变更云服务器规格失败 请参考返回的error message，或者联系技术支持 400 Ecs.0210 A system exception occurred. Try again later or contact customer service. 创建浮动IP失败 请参考返回的error message，或者联系技术支持 400 Ecs.0211 Failed to create the NIC. Try again later or contact customer service. 创建网卡Qos失败 请参考返回的error message，或者联系技术支持 400 Ecs.0212 Failed to assign the private IP address. Try again later or contact customer service. 创建私有IP地址失败 具体原因请联系技术支持 400 Ecs.0213 Failed to update the port attributes. Try again later or contact customer service. 更新端口属性失败 请参考返回的error message，或者联系技术支持 400 Ecs.0214 Failed to create the network. Try again later or contact customer service. 创建网络失败 请参考返回的error message，或者联系技术支持 400 Ecs.0216 Failed to create the subnet. Try again later or contact customer service. 创建子网失败 请参考返回的error message，或者联系技术支持 400 Ecs.0217 Failed to attach the NIC. Try again later or contact customer service. 挂载端口失败 请参考返回的error message，或者联系技术支持 400 Ecs.0219 Failed to create the ECS. Try again later or contact customer service. 创建云服务器失败 请参考返回的error message，或者联系技术支持 400 Ecs.0221 Cold migration from a dedicated host to the same dedicated host is not supported. 迁移云服务器失败 请参考返回的error message，或者联系技术支持 400 Ecs.0226 Failed to start. 启动云服务器失败 请参考返回的error message，或者联系技术支持 400 Ecs.0227 Failed to reboot. 重启云服务器失败 请参考返回的error message，或者联系技术支持 400 Ecs.0235 The hypervisor of current flavor is KVM, system volume of whole image can't be SCSI. 使用整机镜像创建云服务器失败。 使用QingTian架构的规格 400 Ecs.0301 Failed to query the ECS. Try again later or contact customer service. 查询云服务器失败 请参考返回的error message，或者联系技术支持 400 Ecs.0302 Failed to query the ECS quota of the tenant. Try again later or contact customer service. 查询租户云服务器配额失败 请参考返回的error message，或者联系技术支持 400 Ecs.0303 Failed to query the ECS specifications. Try again later or contact customer service. 查询规格失败 请参考返回的error message，或者联系技术支持 400 Ecs.0304 Failed to query the image. Try again later or contact customer service. 查询镜像失败 请联系技术支持确认镜像是否注册正确，或者联系技术支持确认其他原因 400 Ecs.0306 Failed to query the backup. Try again later or contact customer service. 查询备份失败 请参考返回的error message，或者联系技术支持 400 Ecs.0307 Failed to query the port. Try again later or contact customer service. 查询端口失败 请参考返回的error message，或者联系技术支持 400 Ecs.0308 Failed to query the ECS quota of the tenant. Try again later or contact customer service. 查询租户云服务器配额失败 请参考返回的error message，或者联系技术支持 400 Ecs.0309 Failed to create the NIC. Try again later or contact customer service. 查询网卡Qos失败 请参考返回的error message，或者联系技术支持 400 Ecs.0310 A system exception occurred. Try again later or contact customer service. 查询网络失败 请参考返回的error message，或者联系技术支持 400 Ecs.0311 Failed to obtain the disk type. Try again later or contact customer service. 查询卷类型失败 请参考返回的error message，或者联系技术支持 400 Ecs.0313 ECS group query failed. 查询云服务组失败 请参考返回的error message，或者联系技术支持 400 Ecs.0314 The key pair does not exist. Refresh the key pair list and check key pair 请求OpenStack查询keypair失败 请参考返回的error message，或者联系技术支持 400 Ecs.0315 Failed to call the nova API to query the auto recovery status. 查询云服务器是否设置auto recovery失败 请参考返回的error message，或者联系技术支持 400 Ecs.0319 Insufficient resources for this flavor. Try another flavor. flavor容量不足 申请扩大flavor容量 400 Ecs.0320 AZ query failed. 查询可用区失败 请参考返回的error message，或者联系技术支持 400 Ecs.0321 Console logs query failed. 查询云服务器控制台日志失败 请参考返回的error message，或者联系技术支持 400 Ecs.0322 Subnet query failed. 查询子网详情失败 请参考返回的error message，或者联系技术支持 400 Ecs.0323 Failed to query the NIC attached to the ECS. 查询虚拟机挂载网卡失败 请参考返回的error message，或者联系技术支持 400 Ecs.0401 Failed to release the port. Try again later or contact customer service. 回滚端口失败 请参考返回的error message，或者联系技术支持 400 Ecs.0402 Failed to release the system disk. Try again later or contact customer service. 回滚系统卷失败 请参考返回的error message，或者联系技术支持 400 Ecs.0403 Failed to release the ECS. Try again later or contact customer service. 回滚云服务器失败 联系技术支持定位回滚服务器失败原因 400 Ecs.0405 Failed to release the data disk. Try again later or contact customer service. 回滚数据盘失败 请参考返回的error message，或者联系技术支持 400 Ecs.0501 Failed to delete the ECS. Try again later or contact customer service. 删除云服务器失败 请稍后重新执行操作 400 Ecs.0502 Failed to delete the private IP address. Try again later or contact customer service. 删除私有IP失败 请参考返回的error message，或者联系技术支持 400 Ecs.0503 Failed to obtain the system disk. Try again later or contact customer service. 查询系统卷失败 请参考返回的error message，或者联系技术支持 400 Ecs.0507 Failed to delete the NIC. Try again later or contact customer service. 删除网卡失败 请检查网卡类型 400 Ecs.0510 Yearly/Monthly ECSs do not support changing OSs. 包年/包月弹性云服务器不支持变更操作系统 按包年包月计费的，且使用的市场镜像的云服务器不支持切换操作系统 400 Ecs.0513 server %s is the cycle order and not be deleted by ordinary user 普通用户不允许删除包年/包月弹性云服务器 包周弹性云服务器请执行退订操作 501 Ecs.0603 ther commands are being executed. Try again later. 当前已有其他命令执行，请稍后1分钟重试 请稍后1分钟重试 400 Ecs.0605 ECS locked. 云服务器被锁定 请检查云服务器是否被锁定，若想继续操作请先将云服务器解锁。 400 Ecs.0610 Failed to reset the ECS password. 重置密码失败 请稍后重新执行操作，或者联系技术支持 400 Ecs.0611 Batch operation failed. 批量请求操作失败 根据返回的详细错误信息，修改错误后重新进行请求处理 400 Ecs.0612 Failed to check whether plug-ins have been installed. 校验弹性云服务器是否安装插件请求失败 请稍后重新执行操作，或者联系技术支持 400 Ecs.0613 The ECS has no plug-ins installed. 弹性云服务器未安装插件 安装插件 404 Ecs.0614 The ECS does not exist. 弹性云服务器不存在 检查弹性云服务器是否存在 500 Ecs.0615 The thread list is empty. 服务器处理请求异常 系统内部错误。 请联系技术支持进行定位 400 Ecs.0616 Failed to update the ECS name. 弹性云服务器修改失败 请稍后重新执行操作，或者联系技术支持 400 Ecs.0617 Failed to modify attribute. Please try again later or contact customer service. 修改云服务器挂载的磁盘属性失败 请参考返回的错误信息，或者联系技术支持 400 Ecs.0618 Failed to change the IP address of the ECS NIC. 修改云服务器网卡IP失败 请参考返回的error message，或者联系技术支持 400 Ecs.0701 Failed to obtain the order or product. Try again later or contact customer service. 查询订单或者产品失败 请联系技术支持进行定位 400 Ecs.0702 Failed to get the demand price or spot price. Try again later or contact customer service. 查询价格失败 查询价格接口异常，请联系技术支持 400 Ecs.0703 The single instance price limit cannot be less than the spot price. 用户出价小于当前现价 用户出价小于竞价实例市场价格，请提高竞价实例出价 400 Ecs.0704 Spot ECSs do not support specifications modification. 竞价型实例不允许切换规格 竞价实例不允许切换规格 400 Ecs.0705 Automatic recovery cannot be enabled on spot ECSs. 竞价型实例不允许开启自动恢复 竞价实例不允许开启自动恢复 400 Ecs.0706 RIs cannot be split or combined. 合并拆分预留实例失败 请联系技术支持进行定位 400 Ecs.0707 The product has not been registered. 购买的该产品不存在 请联系技术支持进行定位 400 Ecs.0802 The specifications of an ECS created using a Red Hat image cannot be modified. 弹性云服务器不支持变更规格 特定镜像的弹性云服务器不支持变更规格 400 Ecs.0803 When modifying the specifications of an ECS created on a DeH, specify the DeH. DEH弹性云服务器变更规格需指定专属主机的ID 请修改变更规格请求体 400 Ecs.0804 The ECS flavor cannot be switched to the target flavor. Change the target flavor. 弹性云服务器不支持变更到目标规格 请更换其他规格 400 Ecs.0805 A large-memory ECS cannot be switched to a general computing ECS. 超大内存型 Flavor不能与普通Flavor互切 超大内存型 Flavor不能与普通Flavor互切 400 Ecs.0806 H2 ECSs do not support specifications modification. 高性能计算型II代实例不支持变更规格 高性能计算型II代实例不支持变更规格 400 Ecs.0807 The number of ECS NICs exceeds the maximum number allowed on the target ECS. Uninstall excess NICs. 弹性云服务器网卡个数超过目标规格云服务器网卡的挂载限制 请卸载多余网卡 400 Ecs.0808 The Xen ECS created using a UEFI image does not support specifications modification. UEFI镜像的XEN弹性云服务器不支持变更规格 UEFI镜像的XEN弹性云服务器不支持变更规格 400 Ecs.0809 The number of VBD disks exceeds the maximum number allowed on the target ECS. Uninstall excess disks. VBD磁盘数量超过目标规格弹性云服务器的挂载限制 请卸载多余磁盘 400 Ecs.0810 The ECS flavor is the same as the target flavor. 目标规格与弹性云服务器当前规格一样 请更换其他规格 400 Ecs.0811 Install the required drivers on the ECS and then change Xen to KVM. 当前规格不支持从xen切换到 kvm 请安装驱动脚本 400 Ecs.0812 Current flavor %s can not resize to flavor %s. 当前规格变更到目标规格需要执行驱动检查脚本 请执行驱动检查脚本 详细操作，请参见： KVM实例变更为QingTian实例（Linux） KVM实例变更为QingTian实例（Windows） 400 Ecs.0813 Change flavor %s to flavor %s is risky, the driver needs to be installed. 当前规格切换到目标规格存在风险 执行驱动检查脚本后，入参传force参数且值为true，忽略风险。 400 Ecs.0901 Yearly/Monthly DeHs cannot be allocated. 不支持创建包年/包月的DEH 请更换其他规格 400 Ecs.0902 Spot ECSs do not support Marketplace images. 竞价实例不支持使用市场镜像 请更换其他镜像 400 Ecs.0903 Spot ECSs do not support automatic recovery. 竞价实例不支持自动恢复 请更换其他规格 400 Ecs.0904 UEFI images cannot be used to create Xen ECSs. UEFI镜像不支持创建XEN实例 请更换其他规格 400 Ecs.0905 The number of tags exceeds the maximum allowed limit. 标签的个数超过限制 请减少标签的个数 400 Ecs.0906 Failed to comply with tag character set specifications. 标签的属性非法 请重新制定标签 400 Ecs.0907 Invalid tag character set. 标签字符集不合法 请重新制定标签 400 Ecs.0908 The tag key cannot be duplicate. 标签的键重复 请重新制定标签 400 Ecs.0909 The flavor does not support the disk type. 当前规格不支持该磁盘类型 请更换其他规格或者磁盘类型 400 Ecs.0910 Invalid NIC settings for creating a HANA ECS. 创建HANA实例的网卡参数不合法 请调整网卡参数 400 Ecs.0911 Invalid dedicated storage type of the disk. 磁盘的专属存储类型参数不合法 请调整专属存储类型参数 400 Ecs.0912 Invalid disk encryption key. 磁盘加密属性参数不合法 请调整磁盘加密属性参数 400 Ecs.0913 The number of ECSs to be created exceeds the maximum allowed limit 创建云服务器个数超过限制 请减少创建的云服务器个数 400 Ecs.0914 The length of the ECS name exceeds the maximum allowed limit. 云服务器名称长度超过限制 请调整云服务器名称参数 400 Ecs.0915 The length of the ECS name exceeds the maximum allowed limit. 云服务器名称包含非法字符 请调整云服务器名称参数 400 Ecs.0919 The NIC has been attached to another instance. 端口状态不允许挂载 请更换网卡端口。 400 Ecs.1000 A system exception occurred. Try again later or contact customer service. 调用Nova接口处理请求异常 系统内部调用异常，请稍后重试或请联系技术支持 400 Ecs.1001 A system exception occurred. Try again later or contact customer service. 访问OpenStack异常 OpenStack异常导致云服务器状态异常，请联系技术支持 400 Ecs.1002 A system exception occurred. Try again later or contact customer service. 访问OpenStack超时 如果您正在执行切换VPC、挂载/卸载网卡、挂载/卸载磁盘、切换/重装操作系统等操作，请关闭资源后再重试操作。 如果重试后仍超时，请联系技术支持。 400 Ecs.1100 A system exception occurred. Try again later or contact customer service. 访问IAM失败 请参考返回的error message，或者联系技术支持 400 Ecs.1200 A system exception occurred. Try again later or contact customer service. 访问VPC失败 请参考返回的error message，或者联系技术支持 400 Ecs.1201 A system exception occurred. Try again later or contact customer service. 访问VPC超时 任务超时，具体原因请联系技术支持 400 Ecs.1300 A system exception occurred. Try again later or contact customer service. 访问EVS超时 请参考返回的error message，或者联系技术支持 400 Ecs.7000 Check whether your account balance is sufficient for the order, whether there are orders pending payment, and whether the order is being processed. Try again later or contact customer service. 创建订单失败 请查看账户余额是否足够支付订单，是否有订单待支付以及是否订单处理中，或者联系技术支持 403 Pdp.0001 Policy doesn't allow %s to be performed. API鉴权失败 请参考API授权项列表，在IAM增加相关权限 202 Common.0024 exceeds flow over limit 请求流控 请求并发过高，请稍后重试。 400 Common.0002 The request body cannot be left blank. 请求消息体为空 请检查请求body体 400 Common.0011 Failed to query system tasks. 无效JobId 请确认JobId参数来源是否正确 400 Common.0018 The project ID in the URL is different from that in the token. token无效，token中的project_id和URL中的project_id不一致 请检查租户的token是否正确 400 Common.0020 A system exception occurred. Try again later or contact customer service. 任务重试失败 请联系技术支持 400 Common.0021 Sub job fail! 查询Job异常 请稍后重试，或联系技术支持 400 Common.0022 Mission fail! 提交Job异常 请联系技术支持 400 Common.0999 The system was broken, exit. 任务退出 请联系技术支持 400 Common.0025 Query job Error because %s. 查询Job异常 请稍后重试，或联系技术支持 400 Common.0026 Fail to get Region Info 查询AZ信息异常 请稍后重试，或联系技术支持 401 Common.0013 Invalid token. token不合法 请检查租户的token是否正确 500 Common.0001 A system exception occurred. Try again later or contact customer service. 系统异常 请联系技术支持 503 Common.1503 Api flow control Error because %s. API流控 正在执行的API过多，请稍后重试。

背景信息 接口返回的错误码与Error Message不具有一一对应关系，表中只是列出比较常见的一种Error Message。 本服务接口以异步接口居多，有的错误码是在查询任务的返回体中体现的，http状态码有可能不是很准确。 本服务对网络、存储等服务具有强依赖性，Error Message显示依赖服务的错误消息时，处理措施需要联系技术支持。 在管理控制台进行操作时，如果显示错误码，错误码说明请参见《弹性云服务器用户指南》的常见问题“针对管理控制台的异常提示信息，应该如何处理”。

数据结构(查询云服务器详情) 表1 address参数 参数 参数类型 描述 version String IP地址版本。 “4”：代表IPv4。 “6”：代表IPv6。 addr String IP地址。 primary Boolean 是否是主网卡。 true：主网卡。 false：辅助网卡。 OS-EXT-IPS:type String IP地址类型。 fixed：代表私有IP地址。 floating：代表浮动IP地址。 OS-EXT-IPS-MAC:mac_addr String MAC地址。 OS-EXT-IPS:port_id String IP地址对应的端口ID。 表2 flavor参数 参数 参数类型 描述 id String 云服务器规格ID。 name String 云服务器规格名称。 disk String 该云服务器规格对应要求系统盘大小，0为不限制。 此字段在本系统中无效。 vcpus String 该云服务器规格对应的CPU核数。 ram String 该云服务器规格对应的内存大小，单位为MB。 表3 security_groups参数 参数 参数类型 描述 name String 安全组名称或者UUID。 id String 安全组ID。 错误信息属性具体结构如下： 表4 fault参数 参数 参数类型 描述 message String 故障信息 code Integer 故障代码 details String 故障详情 created String 故障时间，ISO8601格式 表5 os-extended-volumes:volumes_attached 参数 参数 参数类型 描述 id String 磁盘ID，格式为UUID。 delete_on_termination String 删除云服务器时是否一并删除该磁盘。 true：是 false：否 微版本2.3及以上版本支持。 bootIndex String 云硬盘启动顺序。 0为系统盘。 非0为数据盘。 device String 云硬盘挂载盘符，即磁盘挂载点。 表6 metadata参数 参数 参数类型 描述 charging_mode String 云服务器的计费类型。 “0”：按需计费（即postPaid-后付费方式）。 “1”：按包年包月计费（即prePaid-预付费方式）。 "2"：竞价实例计费 metering.order_id String 按“包年/包月”计费的云服务器对应的订单ID。 metering.product_id String 按“包年/包月”计费的云服务器对应的产品ID。 vpc_id String 云服务器所属的虚拟私有云ID。 EcmResStatus String 云服务器的冻结状态。 normal：云服务器正常状态（未被冻结）。 freeze：云服务器被冻结。 说明： 当云服务器被冻结或者解冻后，系统默认添加该字段，且该字段必选。 metering.image_id String 云服务器操作系统对应的镜像ID。 metering.imagetype String 镜像类型，目前支持： 公共镜像（gold） 私有镜像（private） 共享镜像（shared） metering.resourcespeccode String 云服务器对应的资源规格。 metering.resourcetype String 云服务器对应的资源类型。 取值为“1”，代表资源类型为云服务器。 cascaded.instance_extrainfo String 系统内部虚拟机扩展信息。 image_name String 云服务器操作系统对应的镜像名称。 agency_name String 委托的名称。 委托是由租户管理员在统一身份认证服务（Identity and Access Management，IAM）上创建的，可以为弹性云服务器提供访问云服务器的临时凭证。 os_bit String 操作系统位数，一般取值为“32”或者“64”。 os_type String 操作系统类型，取值为：Linux、Windows。 __support_agent_list String 云服务器是否支持主机安全服务、主机监控。 “hss”：主机安全服务 “ces”：主机监控 lockCheckEndpoint String 回调URL，用于检查云服务器的加锁是否有效。 如果有效，则云服务器保持锁定状态。 如果无效，解除锁定状态，删除失效的锁。 lockSource String 云服务器来自哪个服务。 订单加锁（ORDER） lockSourceId String 云服务器的加锁来自哪个ID。 lockSource为“ORDER”时，lockSourceId为订单ID。 lockScene String 云服务器的加锁类型。 按需转包年/包月（TO_PERIOD_LOCK） virtual_env_type String IOS镜像创建虚拟机，"virtual_env_type": "IsoImage" 属性； 非IOS镜像创建虚拟机，在19.5.0版本以后创建的虚拟机将不会添加virtual_env_type 属性，而在此之前的版本创建的虚拟机可能会返回"virtual_env_type": "FusionCompute"属性 。 说明： virtual_env_type属性不允许用户增加、删除和修改。 表7 sys_tags参数 参数 参数类型 描述 key String 系统标签的Key值 value String 系统标签的value值 表8 image 参数 参数 参数类型 描述 id String 镜像id 您可以根据镜像ID查询更多镜像信息，详细内容，请参见查询镜像列表。 父主题： 数据结构

准备Dockerfile Dockerfile是用于构建镜像的文本文件，其中包含了构建镜像所需的指令和说明。了解Dockerfile更详细说明，请参见Docker官网。 单击仓库名称，进入代码仓库。 单击文件列表上方“新建”，在下拉列表中选择“新建文件”。 图1 新建文件 输入文件名Dockerfile，文件详情输入以下命令行。 FROM openjdk:8-alpine ADD target /demo COPY ./target/demoapp.jar /demo CMD ["java","-jar","/demo/demoapp.jar"] 输入备注信息，单击“确定”。

产品功能 在使用云日志服务LTS之前，建议您先通过表1了解LTS提供的主要功能。 表1 产品功能 功能 说明 端云全场景日志接入 支持40+云服务、主机/容器、移动端、跨云、多语言SDK、多账号汇聚，满足全场景客户丰富的日志接入需求。 海量日志存储搜索 对采集的日志数据，可以通过关键字查询、模糊查询等方式简单快速地进行查询，支持百亿日志秒级搜索，千亿日志迭代搜索，PB级智能冷存储。 SQL统计和可视化图表 LTS提供多种开箱即用的日志仪表盘模板，用户接入日志后即可快速分析。 将日志分析的结果使用可视化图表呈现出来，支持表格、折线图、饼图、柱状图、地图等统计图表，或将统计图表汇聚在仪表盘上统一呈现，方便运营分析。 日志监控与日志告警 支持对存储在云日志服务中的日志数据进行关键词统计或SQL统计，通过在一定时间段内日志中关键字出现次数，实时监控服务运行状态；支持自定义告警内容，支持短信/邮件/微信/钉钉/HTTP多渠道通知。 日志转储 主机和云服务的日志数据上报至云日志服务后，支持自定义存储时间。超出存储时间的日志数据将会被自动删除，对于需要长期存储的日志数据（日志持久化），云日志服务提供转储功能，可以将日志转储至对象存储服务（OBS）中长期保存。日志转储基于复制的转储机制，在LTS设置的存储时间内转储至OBS的日志，不会在LTS被删除。 同时LTS还支持转储DWS/DIS/DLI/DMS，让用户实现日志数据便捷在云服务间流转，快速构建水平解决方案。 日志消费与加工 LTS提供DSL日志加工的能力，内置200＋函数，可以实现一站式日志规整、富化、脱敏、过滤、分裂等功能；另外结合定时SQL统计，可以对数据实现聚合统计。 支持用户使用SDK消费LTS日志，可以获取全量日志数据，可以作为流计算的数据源（SDK消费功能邀测中，暂未开放）。

操作场景 本章节指导您通过查询消息功能查看具体的消息内容，以及确定消息是否生产/消费成功。 分布式消息服务RocketMQ版提供三种消息查询的方法：按Topic查询、按Message ID查询和按Message Key查询。 按Topic查询：查询某时间段内指定Topic下所有的消息。此方法属于范围查询，查询到的消息可能比较多。 按Message ID查询：查询指定Message ID的消息。此方法属于精确查找，可以快速查询到某一条消息。 按Message Key查询：查询指定Message Key的消息。此方法属于精确查找，可以快速查询到某一条消息。

消息清理机制 无论消息是否被消费，RocketMQ的消息默认保留时间为48小时，最长保留时间为720小时。RocketMQ消息存储在CommitLog文件中，CommitLog文件大小为1GB，当一个CommitLog文件写满后，会生成一个新的CommitLog文件。RocketMQ删除消息是删除CommitLog文件，而不是删除一条消息。CommitLog文件为顺序写入，当最后写入的一条消息过期时，表示CommitLog文件过期。满足如下任意一个条件，CommitLog文件将会被清理： 每天凌晨4点会清理过期的文件，部分老实例由于未设置时区，清理时间为每天中午12点。 当磁盘使用率达到70%时，会立刻清理过期的文件。 当磁盘使用率达到85%时，会从最早创建的文件开始清理，不管文件是否已过期，直到磁盘空间充足。

查询消息轨迹 在待查询消息所在行，单击“消息轨迹”。 查看消息的轨迹，确定是否生产/消费成功。 消息轨迹的参数说明如表1所示。 表1 消息轨迹的参数说明 参数 参数说明 生产者状态 生产者状态如下： 发送成功：消息发送成功，服务端已经成功存储消息。 提交成功：允许消费者消费此事务消息。 回滚：事务消息将被丢弃，不允许消费者消费此事务消息。 未知，待确认：事务消息状态暂时无法确定，等待固定时间后，服务端向生产者进行消息回查。 生产耗时 生产者发送消息的耗时。 生产地址 生产者的IP地址和端口号。 消费者状态 消费者状态如下： 消费成功 消费超时 消费异常 消费返回NULL 消费失败 消费时间 消费消息的时间。 消费耗时 消费者消费消息的耗时。 消费地址 消费者的IP地址和端口号。