华为云用户手册

GAUSS-04741 -- GAUSS-04750 GAUSS-04741: "The count of address '%s' must be not greater than %d." SQLSTATE: 44000 错误原因：address的数量不能超过2个。 解决办法：创建DFS server时指定的address不能超过两个。 GAUSS-04742: "Unsupport ipv6 format" SQLSTATE: 44000 错误原因：DFS server的address不支持ipv6格式。 解决办法：创建DFS server的address改为ipv4格式。 GAUSS-04743: "The incorrect address format" SQLSTATE: 44000 错误原因：address的格式书写错误。 解决办法：查看正确描述address。 GAUSS-04744: "Failed to create DfsInsert handler when updating table." SQLSTATE: XX000 错误原因：系统内部错误。 解决办法：请联系技术支持工程师提供技术支持。 GAUSS-04745: "build global dfs space cache hash table failed" SQLSTATE: 42704 错误原因：系统内部错误。创建全局的HDFS连接缓存失败。 解决办法：请联系技术支持工程师提供技术支持。 GAUSS-04746: "The number of files exceeds the limit %d." SQLSTATE: 22000 错误原因：文件数量达到设定的上限值。 解决办法：请联系技术支持工程师提供技术支持。 GAUSS-04747: "could not initialize DFS space hash table" SQLSTATE: 42704 错误原因：不能创建用于缓存文件序号的hash table。 解决办法：请联系技术支持工程师提供技术支持。 GAUSS-04748: "Partition directory exceeds max length of one partition directory on attribute [%s], max allowed:%d" SQLSTATE: XX000 错误原因：存储分区表的分区目录名字长度超过了最大限制512字节。 解决办法：用户数据需要保证“分区键+分区键值”不超过512字节（含URI转码）。 GAUSS-04749: "could not initialize partition pruning result cache." SQLSTATE: XX000 错误原因：分区表导入过程中用以分区搜索的cache创建失败。 解决办法：检查机器是否有足够的内存来创建分区收索cache。 GAUSS-04750: "Unsupported data type on column:%s when forming partition signature" SQLSTATE: XX000 错误原因：分区表导入过程中发现分区键的数据类型不在支持的类型中。 解决办法：查看系统目录表是否有数据不一致情况，以创建的分区表分区列是否是不支持的分区类型。 父主题： GAUSS-04701 -- GAUSS-04800

GAUSS-01121 -- GAUSS-01130 GAUSS-01121: "cannot swap toast files by content when there's only one" SQLSTATE: XX000 错误原因：在扩容充分过程中，通过gs_switch_relfilenode函数交换两张表的物理文件时，待交换两张表中其中有一张表的toast表为空，不能交换两张表的物理文件。 解决办法：删除当前表，通过create table语法重新创建表，重建当前表的物理文件。 GAUSS-01122: "cannot swap toast files by links for system catalogs" SQLSTATE: XX000 错误原因：在扩容充分过程中，通过gs_switch_relfilenode函数交换两张表的物理文件时，不允许交换系统表的toast物理文件。 解决办法：在扩容充分过程中，通过gs_switch_relfilenode函数不允许交换系统表的物理文件，非法的操作。请确认函数的参数中是否包含有系统表的表名。 GAUSS-01123: "expected one dependency record for TOAST table, found %ld" SQLSTATE: XX000 错误原因：在扩容充分过程中，通过gs_switch_relfilenode函数交换两张表的物理文件时，由于toast表依赖的对象数大于1个，导致交换物理文件失败。 解决办法：确认toast表在pg_depend表中依赖的对象数大于1个，如果大于1个请先删除对象的依赖后再调用该函数交换物理文件。 GAUSS-01124: "expected none dependency record for partiton's TOAST table, found %ld" SQLSTATE: XX000 错误原因：重建分区表对分区文件进行交换操作处理时，如果待交换的表包含有toast表需要做toast表的文件交换。其中toast表有依赖对象，导致交换分区文件失败。 解决办法：对需要重建的分区表通过create table partition重新创建分区表。 GAUSS-01125: "expected one dependency record for CUDesc/Delta table, found %ld" SQLSTATE: XX000 错误原因：在扩容充分过程中，通过gs_switch_relfilenode函数交换两张列存表的物理文件时，由于列存表依赖的对象数大于1个，导致交换物理文件失败。 解决办法：确认列存表在pg_depend表中依赖的对象数大于1个，如果大于1个请先删除对象的依赖后再调用该函数交换物理文件。 GAUSS-01126: "expected none dependency record for partiton's CUDesc/Delta table, found %ld" SQLSTATE: XX000 错误原因：重建分区表对分区文件进行交换操作处理时，如果待交换的列存分区表需要做文件交换。其中分区列存表有依赖对象，导致交换分区文件失败。 解决办法：对需要重建的分区表通过create table partition重新创建分区表。 GAUSS-01127: "invalid statement name: must not be empty" SQLSTATE: 42P14 错误原因：非法的语句名：语句名不能为空。 解决办法：给出明确的语句名。 GAUSS-01128: "could not determine data type of parameter $%d" SQLSTATE: 42P18 错误原因：参数类型无法确定。 解决办法：修改参数值为系统可识别的类型，系统可识别类型《SQL语法参考》的“数据类型”章节。 GAUSS-01129: "utility statements cannot be prepared" SQLSTATE: 42P14 错误原因：DDL命令不能使用prepare。 解决办法：DDL语句无需prepare，直接执行即可。 GAUSS-01130: "EXECUTE does not support variable-result cached plans" SQLSTATE: XX000 错误原因：系统内部错误。 解决办法：请联系技术支持工程师提供技术支持。 父主题： GAUSS-01101 -- GAUSS-01200

GAUSS-01931 -- GAUSS-01940 GAUSS-01931: "cannot drop %s because other objects depend on it" SQLSTATE: 2BP01 错误原因：由于其他对象依赖他，无法删除这个对象。 解决办法：解除这种依赖或者删除依赖对象。 GAUSS-01932: "cannot drop desired object(s) because other objects depend on them" SQLSTATE: 2BP01 错误原因：由于其他对象依赖这些对象，无法删除这些对象。 解决办法：使用drop cascade来级联删除依赖对象。 GAUSS-01933: "invalid varlevelsup %d" SQLSTATE: XX000 错误原因：系统内部错误。 解决办法：请联系技术支持工程师提供技术支持。 GAUSS-01934: "invalid varno %d" SQLSTATE: XX000 错误原因：系统内部错误。 解决办法：请联系技术支持工程师提供技术支持。 GAUSS-01935: "already-planned subqueries not supported" SQLSTATE: XX000 错误原因：系统内部错误。 解决办法：请联系技术支持工程师提供技术支持。 GAUSS-01936: "invalid resultRelation %d" SQLSTATE: XX000 错误原因：系统内部错误。 解决办法：请联系技术支持工程师提供技术支持。 GAUSS-01937: "invalid objectSubId 0 for object class %u" SQLSTATE: XX000 错误原因：系统内部错误。 解决办法：请联系技术支持工程师提供技术支持。 GAUSS-01938: "could not find tuple for rule %u" SQLSTATE: XX000 错误原因：系统内部错误。 解决办法：请联系技术支持工程师提供技术支持。 GAUSS-01939: "no namespace name supplied" SQLSTATE: XX000 错误原因：创建namespace时，未提供namespace的名称。 解决办法：请提供namespace的名称。 GAUSS-01940: "primary keys cannot be expressions" SQLSTATE: 0A000 错误原因：主键不允许是表达式。 解决办法：请重新选择主键。 父主题： GAUSS-01901 -- GAUSS-02000

GAUSS-00821 -- GAUSS-00830 GAUSS-00821: "cannot inherit to temporary relation of another session" SQLSTATE: 42809 错误原因：ALTER TABLE INHERIT操作，不能继承到另一个会话的临时关系表。 解决办法：不支持继承到另一会话的临时关系表，建议取消本操作。 GAUSS-00822: "circular inheritance not allowed" SQLSTATE: 42P07 错误原因：ALTER TABLE INHERIT操作，不支持循环继承。 解决办法：不支持循环继承，建议取消本操作。 GAUSS-00823: "table '%s' without OIDs cannot inherit from table '%s' with OIDs" SQLSTATE: 42809 错误原因：ALTER TABLE INHERIT操作，没有OIDs的表不能继承。 解决办法：没有OIDs的表不能继承父表，建议更改修改本表具有OIDs。 GAUSS-00824: "column '%s' in child table must be marked NOT NULL" SQLSTATE: 42804 错误原因：ALTER TABLE INHERIT操作，parent table有not null限制，child table的列必需有not null限制。 解决办法：建议为child table增加not null列属性。 GAUSS-00825: "child table is missing column '%s'" SQLSTATE: 42804 错误原因：ALTER TABLE INHERIT操作，child table中有缺失的列，不能继承自parent table。 解决办法：建议添加child table中的缺失列，或取消本继承关系。 GAUSS-00826: "child table '%s' has different definition for check constraint '%s'" SQLSTATE: 42804 错误原因：ALTER TABLE INHERIT操作，child table与parent table有不同的约束定义，不能继承。 解决办法：建议将child table与parent table设置为相同的约束定义。 GAUSS-00827: "constraint '%s' conflicts with non-inherited constraint on child table '%s'" SQLSTATE: 42P17 错误原因：ALTER TABLE INHERIT操作，父表的约束与子表的非继承约束冲突，不能继承。 解决办法：建议更改子表或父表的约束限制。 GAUSS-00828: "child table is missing constraint '%s'" SQLSTATE: 42804 错误原因：ALTER TABLE INHERIT操作，子表缺少约束限制。 解决办法：建议更改此操作。 GAUSS-00829: "relation '%s' is not a parent of relation '%s'" SQLSTATE: 42P01 错误原因：ALTER TABLE NO INHERIT操作，当删除子表的父表约束时，检测出子表不存在该父表关系。 解决办法：不存在此子表父表关系，故不能直接删除。 GAUSS-00830: "typed tables cannot inherit" SQLSTATE: 42809 错误原因：ALTER TABLE OF操作，将一个表附加到复合类型时，类型表不能继承。 解决办法：检查ALTER TABLE操作，附加的继承表不能是复合类型。 父主题： GAUSS-00801 -- GAUSS-00900

GAUSS-00781 -- GAUSS-00790 GAUSS-00781: "cannot alter data type of distribute column" SQLSTATE: 0A000 错误原因：ALTER COLUMN TYPE操作，不能修改表的分布列的类型。 解决办法：暂不支持更改表的分布列的类型，只能修改非分布列的类型，可将分布列调整为其他列之后修改数据类型。 GAUSS-00782: "cannot refer to other columns in transform expression for column store table" SQLSTATE: 0A000 错误原因：列存表不支持在类型改变时更新数据引用其它列的值。 解决办法：避免列类型修改操作，通过新建表来达到同样目的。 GAUSS-00783: "transform expression must not return a set" SQLSTATE: 42804 错误原因：ALTER COLUMN TYPE操作，转换表达式不能返回集合。 解决办法：转换表达式不能返回集合，建议更改本操作。 GAUSS-00784: "cannot use subquery in transform expression" SQLSTATE: 0A000 错误原因：ALTER COLUMN TYPE操作，转换表达式不能包含子查询。 解决办法：转换表达式不能包含子查询，建议更改本操作。 GAUSS-00785: "cannot use aggregate function in transform expression" SQLSTATE: 42803 错误原因：ALTER COLUMN TYPE操作，转换表达式不能使用聚合函数。 解决办法：转换表达式不支持聚合函数，建议更改本操作。 GAUSS-00786: "cannot use window function in transform expression" SQLSTATE: 42P20 错误原因：ALTER COLUMN TYPE操作，转换表达式不能使用window函数。 解决办法：转换表达式不支持window函数，建议更改本操作。 GAUSS-00787: "column '%s' cannot be cast automatically to type %s" SQLSTATE: 42804 错误原因：ALTER COLUMN TYPE操作，列不能自动转化为某类型。 解决办法：建议指定列转换类型。 GAUSS-00788: "type of inherited column '%s' must be changed in child tables too" SQLSTATE: 42P16 错误原因：ALTER COLUMN TYPE操作，当parent table列的类型改变时，child table列类型也要随之改变。 解决办法：建议语句中指明子表随父表的变化递归变化。 GAUSS-00789: "cannot alter data type of partitioning column '%s'" SQLSTATE: 0A000 错误原因：ALTER COLUMN TYPE操作，不能更改分区表的列类型。 解决办法：分区表不支持更改列类型，建议更改本操作。 GAUSS-00790: "cannot alter type of column '%s' twice" SQLSTATE: 0A000 错误原因：ALTER COLUMN TYPE操作，不能同时两次更改某一列类型。 解决办法：不支持同时两次更改列类型，建议更改本操作。 父主题： GAUSS-00701 -- GAUSS-00800

GAUSS-00341 -- GAUSS-00350 GAUSS-00341: "cache lookup failed for opclass %u" SQLSTATE: XX000 错误原因：系统内部错误。 解决办法：请联系技术支持工程师提供技术支持。 GAUSS-00342: "Partitioned table does not support EXCLUDE index" SQLSTATE: 0A000 错误原因：特性不支持：CREATE TABLE ... CONSTRAINT语法中对于创建分区表不支持指定为排斥约束。 解决办法：修改CREATE TABLE ... CONSTRAINT语法，对于创建分区表指定为其他约束。 GAUSS-00343: "Invalid PRIMARY KEY/UNIQUE constraint for partitioned table" SQLSTATE: 0A000 错误原因：CREATE TABLE ... CONSTRAINT语法中对于创建分区表创建为主键约束或唯一（UNIQUE）约束的字段名没有包含分区表的分区键字段名。 解决办法：CREATE TABLE ... CONSTRAINT语法中对于创建分区表创建为主键约束或唯一（UNIQUE）约束的字段名必须包含分区表的分区键字段名。 GAUSS-00344: "multiple primary keys for table '%s' are not allowed" SQLSTATE: 42P16 错误原因：CREATE TABLE ... LIKE source_table语法LIKE子句中指定了多个INCLUDING INDEXES的主键。 解决办法：CREATE TABLE ... LIKE source_table语法LIKE子句中只能指定了1个INCLUDING INDEXES的主键。 GAUSS-00345: "cannot use an existing index in CREATE TABLE" SQLSTATE: 0A000 错误原因：错误的使用CREATE TABLE语法给索引字段指定约束。 解决办法："ALTER TABLE ... ADD table_constraint语法给数据表增加一个新约束"。 GAUSS-00346: "index '%s' does not exist" SQLSTATE: 42704 错误原因：CREATE/ALTER TABLE语法中用于指定约束的属性名在关系表中不存在。 解决办法：请检查CREATE/ALTER TABLE语法中用于指定约束的属性名是否在关系表中存在。 GAUSS-00347: "index '%s' is already associated with a constraint" SQLSTATE: 55000 错误原因：不支持的用法。 解决办法：创建其它的索引。 GAUSS-00348: "index '%s' does not belong to table '%s'" SQLSTATE: 55000 错误原因：CREATE/ALTER TABLE table_name语法中指定约束的属性名在table_name中不存在。 解决办法：请检查CREATE/ALTER TABLE table_name语法中指定约束的属性名是否在table_name中存在。 GAUSS-00349: "index '%s' is not valid" SQLSTATE: 55000 错误原因：CREATE/ALTER TABLE语法中用于指定约束的属性名为无效值。 解决办法：请检查CREATE/ALTER TABLE语法中用于指定约束的属性名是否为关系表或模式中存在。 GAUSS-00350: "'%s' is not a unique index" SQLSTATE: 42809 错误原因：CREATE TABLE ... CONSTRAINT语法中对于创建分区表创建为主键约束或唯一（UNIQUE）约束的字段名不是唯一索引。 解决办法：CREATE TABLE ... CONSTRAINT语法中对于创建分区表创建为主键约束或唯一（UNIQUE）约束的字段名必须保证为唯一索引。 父主题： GAUSS-00301 -- GAUSS-00400

GAUSS-00751 -- GAUSS-00760 GAUSS-00751: "cluster key for relation '%s' already exists" SQLSTATE: 42710 错误原因：ALTER TABLE ADD CONSTRAINT操作时，关系表的cluster key已经存在，不能执行。 解决办法：新增约束已经存在，建议更改新增约束。 GAUSS-00752: "constraint must be added to child tables too" SQLSTATE: 42P16 错误原因：为父表添加CONSTRAINT时，该约束必需指定给其子表添加。 解决办法：将该约束限制同时添加给子表。 GAUSS-00753: "referenced relation '%s' is not a table" SQLSTATE: 42809 错误原因：为表添加外键限制时，外键约束的参考表必须是普通表。 解决办法：外键约束的参考表只能是普通表。 GAUSS-00754: "Invalid FOREIGN KEY constraints" SQLSTATE: 42809 错误原因：分区表可以创建外键约束，但是外键约束的参考表只能为普通表，不能为分区表。 解决办法：分区表可以创建外键约束，但是外键约束的参考表不能为分区表，建议修改外键约束的参照表。 GAUSS-00755: "constraints on permanent tables may reference only permanent tables" SQLSTATE: 42P16 错误原因：普通表的外键约束限制只能参照普通表。 解决办法：建议修改外键约束限制为普通表。 GAUSS-00756: "constraints on unlogged tables may reference only permanent or unlogged tables" SQLSTATE: 42P16 错误原因：unlogged表的外键约束限制只能参照普通表或unlogged表。 解决办法：unlogged表的约束限制只能参照普通表或unlogged表。 GAUSS-00757: "constraints on temporary tables may reference only temporary tables" SQLSTATE: 42P16 错误原因：临时表的外键约束限制只能参照表临时表。 解决办法：建议更改外键约束限制或者取消本操作。 GAUSS-00758: "constraints on temporary tables must involve temporary tables of this session" SQLSTATE: 42P16 错误原因：临时表的外键约束必需参照是本地临时表。 解决办法：建议更改外键约束限制或者取消本操作。 GAUSS-00759: "number of referencing and referenced columns for foreign key disagree" SQLSTATE: 42830 错误原因：为表添加外键约束时，被约束的字段数目需要和被引用的字段数目相同。 解决办法：建议更改外键约束操作，使被约束的字段数目与被引用的字段数目相同。 GAUSS-00760: "only b-tree indexes are supported for foreign keys" SQLSTATE: XX000 错误原因：外键对应主键的索引不是b-tree索引。 解决办法：检查主键唯一约束索引是否是b-tree索引。 父主题： GAUSS-00701 -- GAUSS-00800

场景描述 了解 GaussDB (DWS)的基本功能和数据导入，对某公司与供应商的订单数据分析，分析维度如下： 分析某地区供应商为公司带来的收入，通过该统计信息可用于决策在给定的区域是否需要建立一个当地分配中心。 分析零件/供货商关系，可以获得能够以指定的贡献条件供应零件的供货商数量，通过该统计信息可用于决策在订单量大，任务紧急时，是否有充足的供货商。 分析小订单收入损失，通过查询得知如果没有小量订单，平均年收入将损失多少。筛选出比平均供货量的20％还低的小批量订单，如果这些订单不再对外供货，由此计算平均一年的损失。

支持区域 当前已上传OBS数据的区域如表1所示。 表1 区域和OBS桶名 区域 OBS桶名 华北-北京一 dws-demo-cn-north-1 华北-北京二 dws-demo-cn-north-2 华北-北京四 dws-demo-cn-north-4 华北-乌兰察布一 dws-demo-cn-north-9 华东-上海一 dws-demo-cn-east-3 华东-上海二 dws-demo-cn-east-2 华南-广州 dws-demo-cn-south-1 华南-广州友好 dws-demo-cn-south-4 中国-香港 dws-demo-ap-southeast-1 亚太-新加坡 dws-demo-ap-southeast-3 亚太-曼谷 dws-demo-ap-southeast-2 拉美-圣地亚哥 dws-demo-la-south-2 非洲-约翰内斯堡 dws-demo-af-south-1 拉美-墨西哥城一 dws-demo-na-mexico-1 拉美-墨西哥城二 dws-demo-la-north-2 莫斯科二 dws-demo-ru-northwest-2 拉美-圣保罗一 dws-demo-sa-brazil-1

应用场景 当编译构建服务提供的内置执行机构建环境不满足业务要求时，您可接入自行提供的计算资源，通过注册的方式托管到编译构建服务中，委托编译构建服务进行调度并执行构建任务。本实践我们通过“Maven构建”和“上传软件包到软件发布库”两个构建步骤来演示使用自定义执行机的构建场景。 本实践需要依赖使用的其他服务如下： 代码托管服务 ，用于存储实践中项目所使用的代码。 制品仓库服务，用于存储实践中使用的私有依赖包。

操作流程 表1 操作流程 流程 说明 新建项目 为本实践新建项目。 新建自定义执行机资源池 为本实践新建所需的自定义执行机资源池。 新建CodeArts Repo代码仓 为本实践新建存储代码的代码仓。 新建并执行编译构建任务 为本实践新建构建任务，包括“Maven构建”和“上传软件包到软件发布库”构建步骤。 查看构建任务和构建结果 为您介绍通过查看构建日志确认该实践的构建任务使用的执行机和在制品仓中查看上传的软件包。

连接Kafka网络要求 客户端可以通过公网连接Kafka实例，也可以通过内网连接Kafka实例。使用内网连接时，注意以下几点： 如果客户端和Kafka实例部署在同一个VPC内，网络默认互通。 如果客户端和Kafka实例部署在不同VPC中，由于VPC之间逻辑隔离，客户端和Kafka实例不能直接通信，需要打通VPC之间的网络。 客户端连接Kafka实例的方式如表1所示。 表1 连接方式说明 连接方式 实现方式 参考文档 公网连接 客户端通过IPv4地址访问Kafka实例：在Kafka控制台开启公网访问，配置弹性公网IP，客户端通过弹性公网IP访问Kafka实例。 客户端通过IPv6地址访问Kafka实例：在Kafka控制台开启IPv6功能，将IPv6地址加入到共享带宽中，实现客户端通过公网访问Kafka实例。 配置Kafka实例的公网访问 使用DNAT通过端口映射方式，实现客户端通过公网连接Kafka实例。 使用DNAT实现公网访问Kafka 内网连接 客户端和Kafka实例部署在同一个VPC中，此时网络默认互通。 - 客户端和Kafka实例部署在同一个Region的不同VPC中，利用 VPC终端节点 在不同VPC间建立跨VPC的连接通道，实现跨VPC访问。 使用VPCEP实现跨VPC访问Kafka 客户端和Kafka实例部署在同一个Region的不同VPC中，利用VPC对等连接将两个VPC间的网络打通，实现跨VPC访问。 对等连接 客户端连接Kafka实例前，需要在Kafka实例所属安全组中配置如下安全组规则，否则会连接失败。 创建安全组后，系统默认添加入方向“允许安全组内的弹性云服务器彼此通信”规则和出方向“放通全部流量”规则，此时使用内网通过同一个VPC访问Kafka实例，无需添加表2的规则。 表2中的源地址以全网段放通为例，可根据实际安全需要修改为客户端的IP地址。 表2 安全组规则 方向 协议 类型 端口 源地址 说明 入方向 TCP IPv4 9094 0.0.0.0/0 通过公网访问Kafka实例（明文接入）。 入方向 TCP IPv4 9092 0.0.0.0/0 使用内网通过同一个VPC访问Kafka实例（明文接入）。 使用对等连接跨VPC访问Kafka实例（明文接入）。 入方向 TCP IPv6 9192 ::/0 通过IPv6地址访问Kafka实例（关闭SSL加密）（内网和公网都适用）。 入方向 TCP IPv4 9095 0.0.0.0/0 通过公网访问Kafka实例（密文接入）。 入方向 TCP IPv4 9093 0.0.0.0/0 使用内网通过同一个VPC访问Kafka实例（密文接入）。 使用对等连接跨VPC访问Kafka实例（密文接入）。 入方向 TCP IPv6 9193 ::/0 通过IPv6地址访问Kafka实例（开启SSL加密）（内网和公网都适用）。 入方向 TCP IPv4 9011 198.19.128.0/17 通过VPC终端节点实现跨VPC访问Kafka实例（密文接入和明文接入都适用）。 入方向 TCP IPv4 9011 0.0.0.0/0 使用DNAT访问Kafka实例（密文接入和明文接入都适用）。 父主题： 配置Kafka网络连接

Redis 3.0 Proxy集群实例 D CS Redis 3.0 Proxy集群实例基于开源Redis 3.0版本构建，兼容开源codis，提供64G~1024G多种大容量规格版本，支持x86的CPU架构，用于满足百万级以上并发与大容量数据缓存的需要。Redis集群的数据分布式存储和读取，由DCS内部实现，用户无需投入开发与运维成本。 Redis集群实例由“负载均衡器”、“Proxy服务器”、“集群配置管理器”、“集群分片”共4个部分组成。 表1 Redis 3.0集群实例规格和Proxy节点数、分片数的对应关系 集群版规格 Proxy节点数 分片数（Shard） 64G 3 8 128G 6 16 256G 8 32 512G 16 64 1024G 32 128 图1 Redis 3.0 Proxy集群实例示意图 示意图说明： VPC 虚拟私有云。集群实例的内部所有服务器节点，都运行在相同VPC中。 如果Proxy集群实例没有开通公网访问，则客户端需要与集群实例处于相同VPC，并且配置安全组访问规则。 如果Proxy集群实例开通了公网访问，则客户端可以部署在外部网络，并通过集群实例绑定的弹性公网ip地址访问Redis Proxy集群实例。 相关参考：公网连接Redis3.0 Proxy实例，如何选择和配置Redis实例以及客户端的安全组。 客户应用程序 客户应用程序，即Redis集群客户端。 Redis可直接使用开源客户端进行连接，关于多语言客户端连接示例，请参考用户指南的连接缓存实例。 LB-M/LB-S 负载均衡服务器，采用主备高可用方式。Redis集群实例提供访问的IP地址和 域名 ，即为负载均衡服务器地址。 Proxy Redis集群代理服务器。用于实现Redis集群内部的高可用，以及承接客户端的高并发请求。 支持使用Proxy节点的IP连接集群实例。 Redis shard Redis集群的分片。 每个分片也是一个Redis主备实例，分片上的主实例故障时，系统会自动进行主备切换，集群正常提供服务。 某个分片的主备实例都故障，集群可正常提供服务，但该分片上的数据不能读取。 Cluster manager 集群配置管理器，用于存储集群的配置信息与分区策略。用户不能修改配置管理器的信息。

Redis 4.0/5.0/6.0基础版Proxy集群实例 Redis 4.0及以上版本的Proxy集群实例，当前仅部分区域支持，请以控制台实际上线区域为准。 DCS Redis 4.0/5.0/6.0 Proxy集群实例基于开源Redis的4.0/5.0/6.0版本构建，兼容开源codis，提供4G~1024G多种大容量规格版本。 Proxy集群每种实例规格对应的分片数，如表2所示，在创建实例时，支持自定义分片大小。当前暂时不支持自定义副本数，默认每个分片为双副本架构。 每个分片内存=实例规格/分片数，例如，集群规格为48GB的实例，分片数为6，则每个集群分片的大小为48G/6=8G。 表2 Redis 4.0/5.0/6.0基础版Proxy集群实例规格和Proxy节点数、分片数的对应关系 集群版规格 Proxy节点数 分片数 每个分片内存（GB） 4GB 3 3 1.33 8GB 3 3 2.67 16GB 3 3 5.33 24GB 3 3 8 32GB 3 3 10.67 48GB 6 6 8 64GB 8 8 8 96GB 12 12 8 128GB 16 16 8 192GB 24 24 8 256GB 32 32 8 384GB 48 48 8 512GB 64 64 8 768GB 96 96 8 1024GB 128 128 8 图2 Redis 4.0/5.0/6.0 基础版Proxy集群实例示意图 实例示意图说明： VPC 虚拟私有云。集群实例的内部所有服务器节点，都运行在相同VPC中。 客户端需要与集群实例处于相同VPC，并且实例白名单允许客户端的IP地址访问。 客户应用程序 客户应用程序，即Redis集群客户端。 Redis可直接使用开源客户端进行连接，关于多语言客户端连接示例，请参考使用客户端连接Redis。 VPC终端节点服务 VPC终端节点服务，主要是将Redis缓存实例配置为VPC终端节点支持的服务，用户可以直接通过VPC终端节点服务的地址访问。 Redis Proxy集群实例提供的IP地址和域名，即为VPC终端节点服务的地址。 ELB 弹性负载均衡服务器，采用集群高可用方式，支持多可用区部署。 Proxy Redis集群代理服务器。用于实现Redis集群内部的高可用，以及承接客户端的高并发请求。 暂不支持使用Proxy节点的IP连接集群实例。 Cluster集群 Redis集群的分片。 每个分片也是一个双副本的Redis主备实例，分片上的主节点故障时，备节点会在30秒内自动完成主备切换，切换期间访问该分片上的数据会失败，切换完成后分片恢复正常访问。 某个分片的主备节点都故障时，集群可正常提供服务，但该分片上的数据不能读取。

Cluster集群实例架构 Cluster版Redis集群兼容开源Redis的Cluster，基于smart client和无中心的设计方案，对服务器进行分片。 Cluster版Redis集群每种实例规格对应的分片数，如表1所示。 在创建DCS Cluster集群实例时，可以自定义分片大小。如果不自定义分片大小，使用系统默认分片，每个分片的大小=实例规格/分片数，例如，集群规格为48GB的实例，分片数为6，则每个集群分片的大小为48GB/6=8GB。 表1 Cluster集群实例规格和分片数的对应关系 集群版规格 分片数 4GB/8GB/16GB/24GB/32GB 3 48GB 6 64GB 8 96GB 12 128GB 16 192GB 24 256GB 32 384GB 48 512GB 64 768GB 96 1024GB 128 2048GB 128 无中心架构 Redis Cluster的任意节点都可以接收请求，但节点会将请求发送到正确的节点上执行，同时，每一个节点也是主从结构，默认包含一个主节点和一个从节点，由Redis Cluster根据选举算法决定节点主从属性。 图1 Redis Cluster无中心架构 数据预分片 Redis Cluster会预先分配16384个slot，每个Redis的server存储所有slot与redis server的映射关系。key存储在哪个slot中，由Crc16(key) mod 16384的值决定。如下图所示： 图2 Redis Cluster预分片示意图 Redis Cluster集群的每个分片也是一个Redis主备实例。当分片上的主节点故障时，该分片上的连接会有秒级中断、不可用，备节点在30秒内自动完成主备切换，单分片故障仅影响该分片上的数据访问，不影响其他分片上的数据访问。 Redis集群单分片主节点故障时，主备切换完成后，该分片原主节点（已切换为从节点）因故障不会立刻恢复，业务继续访问该分片原主节点会失败，可通过配置Redis SDK解决此类情况，具体请参见使用客户端连接Redis。

私有镜像优化过程 为了成功安装原生的XEN和KVM驱动，需要先卸载弹性云服务器操作系统中安装的PV Driver。 具体操作请参见在Linux系统中卸载PV driver。 KVM虚拟化类型请忽略此步骤。 修改grub文件磁盘标识方式为UUID。 具体操作请参见修改grub文件磁盘标识方式为UUID。 修改fstab文件磁盘标识方式为UUID。 具体操作请参见修改fstab文件磁盘标识方式为UUID。 安装原生的驱动。 对于XEN虚拟化类型，请安装原生的XEN驱动和KVM驱动。具体操作请参见怎样安装原生的XEN和KVM驱动。 对于KVM虚拟化类型，请安装原生的KVM驱动。具体操作请参见安装原生的KVM驱动。 清除日志文件、历史记录等，关闭云服务器。 具体操作请参见清除日志文件。 通过弹性云服务器创建Linux私有镜像。

可以裁剪镜像吗？ 在导入外部镜像文件时，建议您使用操作系统官方发行版本进行系统构建，避免对发行版本进行裁剪及高度定制，以减少问题发生概率。 操作系统发行版本由操作系统厂商进行不定期版本更迭，部分系统版本厂商已停止维护，不再发布问题修复及安全补丁，建议及时关注厂商公告进行系统升级更新，保证您系统的健壮性。 如果操作系统版本停止了服务与支持，您仍然可以使用该操作系统版本的 镜像服务 ，但华为云也会停止对这些镜像提供技术支持，包含新问题的定位和缺陷修复。更多操作系统的服务与支持计划请参见：镜像停止服务与支持计划。 父主题： 镜像咨询类

错误码 调用API出错后，将不会返回结果数据。调用方可根据每个API对应的错误码来定位错误原因。当调用出错时，HTTP请求返回一个4xx或5xx的HTTP状态码。返回的消息体中是具体的错误代码及错误信息。在调用方找不到错误原因时，可以联系客服，并提供错误码，以便我们尽快帮您解决问题。 异常响应样例 { "error_code": "FRS.0202", "error_msg": " The service has been freeze." } 参数说明 参数 是否必选 类型 说明 error_code 否 String 错误码。 error_msg 否 String 错误消息。 错误码说明 错误码类别 状态码 错误码 说明 处理措施 服务类公共错误 （错误码区间：1～99） 403 FRS.0002 鉴权token失败，用户token错误或者已过期。 请参考认证鉴权章节，重新获取您的token信息，并使用获取的token来调用 人脸识别服务 的接口。 400 FRS.0010 缺少请求头或者请求头为空。 请参考构造请求章节，检查公共消息头是否配置。 400 FRS.0011 缺少参数。 请检查请求参数必填参数是否遗漏。 400 FRS.0012 请求参数格式不正确。 请检查参数输入的格式是否合法。 检查必填参数是否填写完整。 检查输入数据规格是否符合约束限制。 400 FRS.0013 输入的人脸图片尺寸过大或过小。 请上传符合规范的人脸图片。 人脸图片分辨率需小于4096*4096，图片中人脸像素大于80*80，建议120*120以上。 400 FRS.0014 输入的不是json格式。 请检查body体的json格式是否合法。 400 FRS.0015 图片base64解析错误。 使用Base64图像数据时，注意编码格式要与API文档中的请求示例保持一致。图片转base64方法可参考如何获取图片的base64编码 使用本地图片文件时，请检查文件是否为图片，且图片类型满足约束。 使用图片URL地址时，请检查URL是否为OBS地址，且地址为图片文件的路径。 400 FRS.0016 上传的文件格式不支持。 请参考约束与限制章节，上传支持识别的文件格式。 400 FRS.0017 上传的body体超出允许的范围。 上传的body体超出允许的范围，请检查图片和分辨率的大小是否在允许的范围内。 请参考约束与限制章节，使用符合规定的图片。 500 FRS.0018 服务内部错误。 请联系客服提供支持。 400 FRS.0019 服务未开通。 请登录 人脸识别 管理控制台，根据业务需求，选择需要开通的服务。 400 FRS.0020 子服务未开通。 请登录人脸识别管理控制台，根据业务需求，选择需要开通的子服务。 如已开通服务，请检查开通服务的区域（或账号）与调用服务的区域（或账号）是否一致；若一致请检查API的URL是否拼写正确。 400 FRS.0021 无效OBS的url。 请参考请求样例，检查OBS的url是否正确。 400 FRS.0023 OBS上的文件大小超出范围。 请参考约束与限制章节，检查OBS中文件的大小是否符合接口要求 400 FRS.0024 OBS上的文件不存在。 请检查OBS上的文件是否存在。 400 FRS.0027 OBS未授权。 请登录人脸识别管理控制台，点击右上角“服务授权”，完成OBS授权。 403 FRS.0028 Project ID跟Token不匹配。 请检查 获取Token 的Project ID是否和请求url上的Project ID一致。 400 FRS.0032 排序字段以及类型不支持，只支持数字类型。 排序字段以及类型不支持，只支持数字类型。请参考sort语法章节查看示例。 400 FRS.0033 当前请求数太多，超过流控限制。 建议控制请求策略或者进行重试，建议扩容以增加QPS配额。 400 FRS.0035 下载地址不合法。 请参考请求样例，检查OBS的url是否正确。 400 FRS.0036 从url获取文件失败。 请使用OBS提供的url上传图片，并检查url是否正确。 服务管理错误 （错误码区间：201～300） 400 FRS.0201 此用户已经注册了。 此用户已经注册了。 400 FRS.0202 服务已经被冻结。 请联系客服提供支持。 400 FRS.0203 更新用户信息失败。 请检查输入的用户信息。 人脸库资源错误 （错误码区间：301～400） 400 FRS.0301 无法创建已经存在的人脸库。 请检查输入的人脸库名称，创建的人脸库已存在，请更换人脸库名称后重新创建。 400 FRS.0302 人脸库不存在。 请检查输入的人脸库是否存在。 400 FRS.0304 未检测到人脸，无法搜索。 请参考约束与限制章节，上传符合规范的人脸图片。 400 FRS.0305 超过最大的人脸库数量，无法创建新的人脸库。 请检查人脸库数量是否超出限制联系客服提供支持。 403 FRS.0306 超过人脸库容量限制，无法增加更多的人脸。 请新增人脸库，重新添加人脸到新的人脸库中。 人脸资源错误 （错误码区间：401～500） 400 FRS.0401 找不到对应类型的值，无法删除。 请参考人脸资源管理接口说明。 400 FRS.0402 输入的字段不存在。 请参考人脸资源管理接口说明。 400 FRS.0403 Face ID不存在。 请检查输入的Face ID是否存在。 400 FRS.0404 未检测到人脸，无法添加。 请参考约束与限制章节，上传符合规范的人脸图片。 400 FRS.0405 未定义的自定义字段，无法添加。 请检查添加的自定义字段是否存在，创建自定义字段后再进行添加。 400 FRS.0406 导入的数据类型与定义不匹配。 请检查导入的数据类型是否与定义的数据类型一致。 400 FRS.0407 批量删除未找到匹配数据。 请检查需要删除的数据信息是否存在。 人脸比对错误 （错误码区间：501～600） 400 FRS.0501 照片未检测到人脸。 请参考约束与限制章节，上传符合规范的人脸图片。 人脸搜索错误码 （错误码区间：29～31） 400 FRS.0029 过滤格式错误。 请参考人脸搜索请求参数章节，检查输入格式是否合法。 400 FRS.0030 返回字段未定义。 请参考人脸搜索请求参数章节，检查return_fields是否定义。 400 FRS.0031 排序字段不在返回字段中。 请参考人脸搜素请求参数章节，检查排序字段是否定义。 活体检测错误 （错误码区间：701～800） 400 FRS.0701 视频解析错误。 请检查视频是否有损坏。 400 FRS.0702 不支持的动作。 请参考动作活体检测的请求参数，检查输入的动作是否存在。 400 FRS.0703 Action time非法。 请检查输入是否合法。 400 FRS.0704 传入的action数量超过10个。 传入的action数量超过10个。 400 FRS.0705 匹配模式不支持。 请参考约束与限制章节，检查输入是否合法。 400 FRS.0706 视频时长不支持，限制[1-15]秒。 视频时长超过限制[1-15]秒，请使用符合时长要求的视频。 400 FRS.0707 照片未检测到人脸。 请参考约束与限制章节，检查照片中是否有人脸或者人脸是否满足约束限制。 400 FRS.0708 检查输入的人脸图片质量是否满足要求。 请参考约束与限制章节，检查输入的人脸图片质量是否满足要求。 400 FRS.0751 视频数据解析失败。 请参考约束与限制章节，检查输入的视频是否满足要求。 400 FRS.0709 检查输入的人脸图片包含多张人脸。 请检查输入的人脸图片是否包含多张人脸，静默活体检测仅支持单人脸照片。 网关错误码 错误码类别 状态码 错误码 说明 处理措施 网关类错误 （错误码区间：1～400） 404 APIG.0101 访问的API不存在或尚未在环境中发布。 请检查API的URL是否拼写正确，例如，URL中是否缺少project_id。 检查URI中的区域信息是否和调用服务配置的区域是否对应。 HTTP请求方法（POST，GET等）是否正确。 具体的URI信息请在各接口的API页面查看。 413/504 APIG.0201 请求体超过范围或者后端超时。 请检查请求的大小是否合法，请联系客服检查后端服务是否运行正常。 401 APIG.0301 IAM 身份验证信息不正确： decrypt token fail：token解析失败。 token expires：token过期。 verify aksk signature fail：AK/SK认证失败。 token解析失败，请检查获取token的方法，请求体信息是否填写正确，token是否正确；检查获取token的环境与调用的环境是否一致。 token超时（token expires） ，请重新获取token，使用不过期的token。 请检查AK/SK是否正确（AK对应的SK错误，不匹配；AK/SK中多填了空格）。 AK/SK频繁出现鉴权出错，连续错误5次以上，被锁定5分钟（5分钟内，则一直认为其是异常的鉴权请求），5分钟后解锁重新认证。 检查账号权限，是否欠费，被冻结等。 401 APIG.0307 Token需要更新 Token有效期为24小时，请使用重新获取Token调用API。 检查接口URL中的终端节点是否填写正确。部署在不同区域间的服务，不可以跨区域调用。如果调用了不同区域的接口，导致判断为Token失效，显示APIG.0307错误码。 当您调用API时，如果遇到“APIGW”开头的错误码，请参见API网关错误码进行处理。 父主题： 附录

API概览 通过使用CFW提供的接口，您可以完整的使用CFW的所有功能。 类型 说明 防火墙管理 查询防火墙信息接口，包括查询防火墙列表、查询防火墙详细信息、修改防火墙防护状态等。 EIP管理 管理EIP接口，包括开启/关闭EIP、查询EIP个数，查询EIP列表等。 ACL规则管理 ACL规则接口，包括创建、更新、删除ACL规则等接口。 黑白名单管理 管理黑白名单，包括创建、更新、删除黑/白名单等接口。 地址组管理 管理地址组，包括添加、查询、更新地址组等接口。 服务组管理 管理服务组，包括新增、查询、修改服务组等接口。 域名解析及域名组管理 管理域名组，包括添加、查询、更新域名组等接口。 IPS管理 管理IPS特性开关，包括查询IPS状态、IPS开关、查询防护模式等操作。 日志管理 管理日志接口，包括查询访问控制日志、查询攻击事件日志、查询流量日志等接口。 抓包管理 管理抓包任务，包括创建、查询、删除抓包任务等接口。

步骤三：加载网络实例 用户需要根据规划的网络连通情况，将需要进行互通的VPC实例加载到创建的云连接实例中。 进入云连接实例列表页面。 单击目标云连接实例名称，进入基本信息页面。 单击“网络实例”页签。 单击“加载网络实例”，在弹出的对话框中加载同账号网络实例。 根据表5填写对应参数后，单击“确定”。 图3 加载同账号网络实例 表5 加载同账号网络实例参数 参数 说明 账号 加载的网络实例的账号类型。 这里选择同账号。 区域 需要连接的VPC所在区域。 实例类型 需要加载到云连接实例中实现互通的实例类型。包括： 虚拟私有云（VPC） 虚拟网关（VGW） 这里选择虚拟私有云（VPC）。 VPC 需要加载到云连接实例中实现网络互通的VPC名称。 当实例类型参数选择虚拟私有云时，需要配置此参数。 VPC CIDRs 需要加载到云连接实例中实现网络互通的VPC内的网段路由。 当实例类型参数选择虚拟私有云时，需配置以下两个参数： 子网 其他网段：其中包含自定义网段的配置 备注 加载同账号网络实例备注信息。 在弹出加载成功的对话框中，如果需要继续加载网络实例，在对话框中单击“继续加载”。不需要加载可以关闭弹窗，在网络实例页签中查看已加载的网络实例信息。

步骤五：配置域间带宽 云连接实例默认跨区域互通带宽为10kbps，仅用于测试连通性，需配置域间带宽以保证业务正常使用。 单击已创建的云连接实例名称，进入基本信息页面。 单击“域间带宽”页签。 单击“配置域间带宽”，根据表7填写对应参数。 表7 配置域间带宽参数 参数 说明 互通区域 需要实现互通的区域名称。 请选择两个需要互通的区域。 带宽包 云连接实例绑定的带宽包。 带宽 两个区域实现互通的带宽。 所有基于该带宽包配置的域间带宽总和不超过带宽包的带宽，请预先做好规划。 单击“确定”，完成配置。 配置完域间带宽后，北京四和中国香港就可以进行正常通信，可通过查看路由信息验证相关配置。

步骤二：创建云连接实例 进入云连接实例列表页面。 单击页面右上方的“创建云连接”。 在弹出的对话框中根据表4填写对应参数。 表4 创建云连接实例参数 参数 说明 名称 云连接实例的名称。 长度为1~64个字符，中、英文字母，数字，下划线，中划线，点。 企业项目 企业项目是一种云资源管理方式，企业项目管理服务提供统一的云资源按项目管理，以及项目内的资源管理、成员管理。 使用场景 虚拟私有云：选择虚拟私有云场景时，网络实例类型支持选择虚拟私有云（VPC）和虚拟网关（VGW）。 标签 云连接实例的标识，包括键和值。可以为云连接实例创建20个标签。 说明： 如果已经通过TMS的预定义标签功能预先创建了标签，则可以直接选择对应的标签键和值。 预定义标签的详细内容，请参见预定义标签简介。 描述 云连接实例的描述。 长度为0~255个字符。 单击“确定”，完成云连接实例的创建。

步骤四：购买带宽包 云连接实例默认跨区域互通带宽为10kbps，仅用于测试连通性。为了实现相同大区不同区域或不同大区之间的互通，用户需要先购买带宽包，绑定到对应的云连接实例中，并配置域间带宽以保证业务正常使用。 一个云连接实例只能绑定一个相同规格的带宽包。例如，云连接实例A只能绑定一个中国大陆到亚太的带宽包。 单击已创建的云连接实例名称，进入基本信息页面。 单击“带宽包”页签。 单击“购买带宽包”，在购买带宽包页面中，根据表6填写对应参数，单击“立即购买”。 表6 购买带宽包参数 参数 说明 计费模式 包年/包月。 用户根据需要选择购买时长，按照年或月为单位进行购买。 名称 带宽包的名称。 长度为1~64个字符，支持数字，英文字母，下划线，中划线，点。 计费方式 按宽带计费。 互通类型 互通大区的类型。支持： 大区内互通：指配置域间带宽的区域在同一个大区内。 跨大区互通：指配置域间带宽的区域在不同的大区内。 互通大区 需要实现互通的区域，即配置域间带宽时涉及的区域。 带宽 带宽是所有基于该带宽包配置的域间带宽总和，请根据网络情况提前做好规划。 单位Mbit/s。 标签 带宽包的标识，包括键和值。可以为带宽包创建20个标签。 说明： 如果已经通过TMS的预定义标签功能预先创建了标签，则可以直接选择对应的标签键和值。 预定义标签的详细内容，请参见预定义标签简介。 购买时长 按照用户需求，选择对应的购买时间。 可支持自动续费。 企业项目 企业项目是一种云资源管理方式，企业项目管理服务提供统一的云资源按项目管理，以及项目内的资源管理、成员管理。 云连接实例 选择需要绑定的云连接实例名称。支持： 绑定 暂不绑定 在订单确认页面再次确认购买带宽包的信息，单击“去支付”。 在付款信息页面，单击“确认”。 在带宽包列表中可查看带宽包信息，如果“状态”为“正常”，表示购买成功。

资源成本和规划 本节介绍最佳实践中资源规划情况，包含以下内容： 表1 跨区域VPC互通资源和成本规划 区域 资源 资源说明 数量 费用 华北-北京四 VPC VPC子网：192.168.1.0/24 自定义网段：192.168.44.0/24 1 免费 中国-香港 VPC VPC子网：192.168.0.0/24 自定义网段：192.168.11.0/24 1 免费 全局 CC 跨大区（中国大陆-亚太）带宽包 1 详细请参见云连接产品价格详情。

步骤一：跨境申请 中国大陆区的VPC需要与中国大陆区外的VPC进行通信时，先要进行跨境申请，提交您的基本资料，保障跨境业务的安全性。 如果用户的网络规划中不涉及跨大区的通信时，则无需操作本步骤。 进入带宽包管理列表页面。 在带宽包管理页面，单击“立即申请”。 如果您业务主体的注册地址在中国大陆，请单击此处进入中国联通跨境云服务在线申请页面。 如果您业务主体的注册地址在中国大陆之外，请单击此处进入中国联通跨境云服务在线申请页面。 请根据您实际业务主体的注册地址来选取跨境资质申请地址。 在跨境云服务在线申请页面，选择“申请人类型”，然后根据提示配置相关参数，并上传相关材料。 请根据实际申请页面完成跨境资质申请材料的准备和上传。 表2 跨境云服务在线申请 参数 说明 客户名称 必须与《信息安全承诺书》中的“用户名称”保持一致。 华为云ID 指用户在华为云管理控制台的“账号ID”，从控制台获取账号ID的步骤如下： 登录管理控制台。 鼠标悬停在右上角的用户名，选择下拉列表中的“我的凭证”。 在“API凭证”页面的项目列表中查看并获取账号ID。 客户类型 根据企业类型选择。 经营范围 概括描述主营业务即可。 客户企业规模（人数) 仅做备案参考。 客户所属国家 申请跨境业务的主体所在国家。 客户境内外分公司所在国家 根据企业实际情况填写。 客户统一社会信用代码 - 客户法人 - 法人证件类型 - 法人证件号 - 跨境需求带宽(M) 仅做备案参考。 跨境服务生效时间 仅做备案参考。 跨境服务终止时间 仅做备案参考。 客户联系人 - 客户联系人电话 - 联系人证件类型 - 联系人证件号 - 表3 跨境申请材料 参数 说明 具体申请材料说明 签字 盖章（企业公章） 营业执照 请上传加盖过公章的营业执照照片。 盖章位置请参考相应的模板文件。 营业执照扫描件 - √ 业务协议 请下载《华为云服务跨境专线业务服务协议》后，填写签字盖章后上传扫描件。 请在签字栏处签字。 盖章需覆盖签名。 《华为云服务跨境专线业务服务协议》扫描件 √ √ 信息安全承诺书 下载《信息安全承诺书模板》 后，填写签字盖章后上传扫描件。 请在签字栏处签字。 盖章需覆盖签名。 该材料中需要填写公司名称、带宽值，带宽值可按照初始预估值填写。 《中国联通专线业务信息安全承诺书》扫描件 √ √ 联系人身份证正反面 请上传清晰的加盖公章的联系人身份证正反面。 盖章位置请参考相应的模板文件。 联系人身份证正反面 - √ 联系人授权委托书 下载《联系人授权委托书模板》 后，填写签字盖章后上传扫描件。 盖章位置请参考相应的模板文件。 《跨境业务办理授权书》扫描件 - √ 单击“立即申请”。

方案概述 应用场景 某公司的北京分部和中国香港分部需要进行私网通信和数据传输，华为云给出的解决方案是通过云连接实例，将北京和中国香港两个区域的VPC建立连接，使得两地的数据中心网络可以互访，同时可无障碍的访问VPC之上的业务系统。 云连接实例支持区域，请参见云连接实例支持区域。 方案架构 用户创建云连接实例。 加载网络示例北京VPC和中国香港VPC。 购买云连接实例带宽包分别配置域间带宽。 北京VPC和中国香港VPC通过云连接实例实现跨区域VPC互通 具体实现方式可参考图1。 图1 跨区域VPC互通 方案优势 简单灵活：只需四步，分钟级构建跨区域多VPC互通网络。 性能优异：华为全球网络基础设施能力，提供低时延、高质量体验。 约束与限制 在同一个云连接实例里，所有网络实例Subnet子网CIDR不能冲突，否则可能会引起互通问题。 在云连接实例中，同账号加载VPC网络实例，并通过其他网段引入自定义CIDR时，不能引入回环地址，组播地址或广播地址。 在同一个云连接实例里加载的所有VPC网络实例里，如果某个VPC同时创建了NAT网关，则只能同时在该VPC网络实例里通过高级配置自定义子网的方式引入默认路由“0.0.0.0/0”。

步骤二：创建云连接实例 进入云连接实例列表页面。 单击页面右上方的“创建云连接”。 在弹出的对话框中根据表3填写对应参数。 图2 创建云连接 表3 创建云连接实例参数 参数 说明 名称 云连接实例的名称。 长度为1~64个字符，中、英文字母，数字，下划线，中划线，点。 企业项目 企业项目是一种云资源管理方式，企业项目管理服务提供统一的云资源按项目管理，以及项目内的资源管理、成员管理。 使用场景 虚拟私有云：选择虚拟私有云场景时，网络实例类型支持选择虚拟私有云（VPC）和虚拟网关（VGW）。 标签 云连接实例的标识，包括键和值。可以为云连接实例创建20个标签。 说明： 如果已经通过TMS的预定义标签功能预先创建了标签，则可以直接选择对应的标签键和值。 预定义标签的详细内容，请参见预定义标签简介。 描述 云连接实例的描述。 长度为0~255个字符。 单击“确定”，完成云连接实例的创建。

步骤四：购买带宽包 云连接默认跨区域互通带宽为10kbps，仅用于测试连通性，需购买带宽包并配置域间带宽以保证业务正常使用。 为了实现网络实例跨区域互通，需要在带宽包管理页面先购买跨区域对应的跨大区或大区内的带宽包，并绑定到相应的云连接实例，支撑业务测试或部署。 在云连接实例列表中，单击实例名称“CloudConnect”，进入该云连接实例。 在云连接实例的详情页面，选择“带宽包”页签，单击“购买带宽包”。 在带宽包购买页面，您可以分别自定义该带宽包的“名称”，计费方式，互通类型，互通大区，带宽大小，购买时长，并确定是否开启自动续费，最后选择是否将购买的该带宽包资源直接绑定给某云连接实例。在本最佳实践的互通场景下，需要打通华东区域与中国香港区域以及南非区域之间的内网互通，因此“互通类型”需要选择为“跨大区互通”： 为支持华东区域与中国香港区域之间的互通，需要购买的带宽包的互通大区分别选择“中国大陆”与“亚太”，带宽选择30M。 为支持华东区域与南非区域之间的互通，需要购买的带宽包的互通大区需要分别选择“中国大陆”与“南非”，带宽选择2M。 购买带宽包时，选择绑定已经创建好的云连接实例，在确定信息选择和输入无误后，单击右下角的“立即购买”。 在订单确认页面再次确认购买带宽包的信息，单击“去支付”。 单击“确认”。 在带宽包列表中可查看带宽包信息，如果“状态”为“正常”，表示购买成功。 购买完成后，您可以在“带宽包管理”页面找到该带宽包资源，并查询到该带宽包资源的计费模式，订单信息，已绑定的云连接信息和已用/剩余带宽，可以针对该带宽包资源进行“修改带宽”、“解绑”、“续费”以及“退订”等操作。

步骤五：配置域间带宽 在购买带宽包后，在云连接实例详情页面配置需要实现互通的域间带宽，以完成不同区域之间的带宽配置，支撑不同区域的VPC内业务的网络互通。 进入创建好的云连接实例详情页面，选择“域间带宽”，单击“配置域间带宽”。 在弹出的对话框中，互通区域分别选择“华东-上海一”以及“中国-香港”，下面会自动匹配出您所购买的可以使用在该互通场景下的带宽包资源，带宽处可以输入您所需要分配在这两个区域之间的带宽，在这里，设置为30M全部分配。 重复上述操作，将购买的中国大陆到南非的2M带宽包，分配给“华东-上海一”与“非洲-约翰内斯堡”之间。 在配置完成后，可以在“域间带宽”页面查看已经分配的域间带宽配置。 通过云连接实例跨区域打通华东，中国香港和南非VPC的操作完成。 系统默认安全组规则是入方向访问受限，请确认区域内互访资源的安全组出方向、入方向规则配置正确，保证跨区域通信正常。

步骤三：加载网络实例 将需要互通的网络实例加载到同一个云连接实例里。 在云连接服务管理控制台界面上，您可以看到已创建好的云连接实例CloudConnect。单击云连接名称进入该云连接实例基本信息页面，接下来需要加载跨区域互通的网络实例VPC。 选择并进入“网络实例”页面，单击“加载网络实例”。 在“加载网络实例”弹框里，下拉“区域”菜单选择“华东-上海一”，实例类型选择“虚拟私有云（VPC）”，在“VPC”以及“VPC CIDR”的下拉菜单里分别选择要互通的VPC和对应的子网，单击“确定”，完成华东区域的VPC加载。 重复上述操作，在“加载网络实例”弹窗中，选择中国香港区域以及南非区域的虚拟私有云（VPC），并将其加载到云连接实例中。 在加载完成后，这三个区域的4个VPC网络已经基于云连接实例打通了，您可以通过查看“路由信息”页面确认当前基于云连接实例可以互通的各个区域的VPC路由条目。