错误码说明 当您调用API时，如果遇到“APIGW”开头的错误码，请参见API网关错误码进行处理。 状态码 错误码 错误信息 描述 处理措施 400 Ecs.0000 Request error. Try again later or contact customer service. 请求数据错误 请参考返回的error message信息检查请求体 400 Ecs.0001 Insufficient E CS 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. 系统异常 请联系技术支持 429 Common.1503 Api flow control Error because %s. API流控 正在执行的API过多，请稍后重试。

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

迁移方法详细介绍 SAP系统迁移常用的方法如表1所示。 表1 迁移工具和方法 迁移工具和方法 说明 主机迁移服务 SMS 主机迁移 服务（Server Migration Service， SMS ）是一种P2V/V2V迁移服务，可以帮您把X86物理服务器，或者私有云、公有云平台上的虚拟机迁移到华为云弹性云服务器（ECS），从而帮助您轻松地把服务器上的应用和数据迁移到华为云。 关于主机迁移服务的使用详情，请参考主机迁移服务快速入门。 说明： 华为云还提供主机迁移工具SMT（Server Migration Tool），SMS是SMT服务化后的产品，但是SMT功能更强。如有SMS无法满足的需求，可以联系华为云技术支持工程师。 SMS与SMT主要区别： 支持操作系统不同（SMS兼容操作系统列表），SMT支持更多操作系统。 SMS要求源端能够连接华为云SMS服务端（能访问互联网），如果源端与目的端是云专线或VPN打通，需要保证要迁移的源端服务器能访问SMS服务端。 镜像导出/导入 如果客户的服务器可以转换成镜像文件，且镜像文件的类型和操作系统符合外部镜像文件的镜像格式和操作系统类型，可以将源端服务器的镜像文件创建为云平台上的私有镜像，并使用该镜像快速在华为云上部署新的服务器。 更多详情请参考通过外部镜像文件创建Linux系统盘镜像与通过外部镜像文件创建Windows系统盘镜像。 数据库备份/恢复 此方法使用数据库的备份功能现将数据从源系统导出，将备份文件转移到目的系统后，再使用数据库的恢复功能使用备份进行恢复。 合理使用数据库备份恢复特性，可以降低迁移停机时间。 数据同步复制 数据库复制功能包括HANA系统复制（HANA System Replication），Oracle Data Guard，SQL Server AlwaysOn和DB2的Q复制（Q Replication）等。他们都有相似的功能，可以将数据库从一个节点复制到另一个节点。如果对停机时间有较高要求，可以考虑采用数据库复制作为数据迁移的工具。 SAP系统复制（R3load） SAP的SWPM（Software Provisioning Manager）中的系统复制(System Copy)可以通过Export/Import将SAP系统复制到一个新的系统。本文档中不会对该方案做详细描述，但是可以该方案可以用来将SAP系统迁移到华为云。 详情请查看SAP网站相关描述System Copy以及System Copy and Migration。 DMO DMO（Data Migration Option）是集成到SAP的SUM（Software Update Manager）中的数据库迁移选项，它可以执行SAP的版本升级、SAP数据库平台迁移等。本文档中不会对该方案做详细描述，但是可以该方案可以用来将SAP系统迁移到华为云。 详情请查看SAP网站相关描述Database Migration Option (DMO) of SUM。 SAP HANA经典迁移 SAP HANA经典迁移方案是使用一系列包括异构System Copy在内的过程与工具将数据库迁移到HANA的方案。本文档中不会对该方案做详细描述，但是可以该方案可以用来将SAP系统迁移到华为云。 详情请查看SAP网站相关描述Classical Migration to SAP HANA。 OMS 对象存储迁移 服务（Object Storage Migration Service，OMS）是一种线上数据迁移服务，帮助用户把对象存储数据从其他云服务商的公有云轻松、平滑地迁移到华为云。 关于对象存储迁移服务的使用详情，请参考对象存储迁移服务快速入门。 DES 数据快递服务（Data Express Service，DES）是一种海量数据传输解决方案，支持TB到PB级数据上云，通过Teleport设备或硬盘（外置USB接口、SATA接口、SAS接口类型）向华为云传输大量数据，致力于解决海量数据传输网络成本高、传输时间长等难题。 关于数据快递服务的使用详情，请参考数据快递服务快速入门。 父主题： 附录

通过API获取任务ID 任务ID还可通过调用批量创建任务API创建任务后获取。 创建任务成功后，响应示例如下，其中的“id”即为任务ID。 { "results" : [ { "id" : "e11eaf8f-71ef-4fad-8890-aed7572ajb11", "name" : "DRS-9228", "status" : "CREATING", "create_time" : "1599188556112" } ], "count" : 1 }

DDM实例状态 表1 DDM实例状态说明 状态 说明 CREATING 创建中，申请DDM实例成功之前的状态。 CREATEFAILED 创建失败，DDM实例处于创建失败的状态。 RUNNING 运行中，DDM实例可正常使用。 ERROR 故障，DDM实例不可用。 RESTARTING 重启中，DDM实例正在重启。 FREEZING 冻结中，DDM实例冻结中。 FROZEN 冻结，DDM实例处于冻结状态。 UNFREEZING 解冻中，DDM实例正在解冻中。 RESIZING 规格变更中，DDM实例规格正在变更中。 UPGRADE_VERSION_INSTANCE 升级中，版本升级中。 ROLL_BACK_DB_VERSION 回滚中，版本回滚中。 GROWING 节点扩容中。 REDUCING 节点缩容中。 RESTORE 恢复中。 BACKUP 备份中。 ONDEMAND_TO_PERIOD 转包周期中。 PERIOD_RESOURCE_SPEC_CHG 包周期资源变更校验中。 SET_CONFIGURATION 实例参数更新中。

调用API获取项目ID 项目ID还可通过调用查询指定条件下的项目信息API获取。 获取项目ID的接口为“GET https://{Endpoint}/v3/projects”，其中{Endpoint}为IAM的终端节点，可以从地区和终端节点获取。接口的认证鉴权请参见认证鉴权。 响应示例如下，例如， 对话机器人服务 部署的区域为“cn-north-4”，响应消息体中查找“name”为“cn-north-4”，其中projects下的“id”即为项目ID。 { "projects": [ { "domain_id": "65382450e8f64ac0870cd180d14e684b", "is_domain": false, "parent_id": "65382450e8f64ac0870cd180d14e684b", "name": "project_name", "description": "", "links": { "next": null, "previous": null, "self": "https://www.example.com/v3/projects/a4a5d4098fb4474fa22cd05f897d6b99" }, "id": "a4a5d4098fb4474fa22cd05f897d6b99", "enabled": true } ], "links": { "next": null, "previous": null, "self": "https://www.example.com/v3/projects" } }

从控制台获取项目ID 登录管理控制台。 在页面右上角的用户名的下拉列表中选择“我的凭证”。 图1 我的凭证 在“我的凭证”页面，获取项目ID（project_id），以及账号名、账号ID、IAM用户名和IAM用户ID。 在调用盘古API时，获取的项目id需要与盘古服务部署区域一致，例如盘古大模型当前部署在“西南-贵阳一”区域，需要获取与贵阳一区域的对应的项目id。 图2 获取项目ID 多项目时，展开“所属区域”，从“项目ID”列获取子项目ID。

错误码说明 当您调用API时，如果遇到“APIGW”开头的错误码，请参见API网关错误码进行处理。 更多服务错误码请参见API错误中心。 表1 错误码 状态码 错误码 错误信息 描述 处理措施 400 PM.02150010 目标用户非项目空间成员 目标用户非项目空间成员 将需要的用户先添加到项目空间 400 PM.02150301 删除失败 删除失败 将是这个角色的用户先修改成其他的角色，再删除 400 PM.02150302 所设置权限不可变更 所设置权限不可变更 所设置权限不可变更 400 PM.02150303 角色不存在 角色不存在 核实请求参数 400 PM.02150304 角色名不可用，请设置新名称 角色名不可用，请设置新名称 请设置新名称 400 PM.02150305 角色名冲突 角色名冲突 请设置新名称 400 PM.02150404 项目空间不存在 项目空间不存在 项目空间不存在 400 PM.02151001 项目集不存在 项目集不存在 项目集不存在 400 PM.02152001 参数错误 参数错误 参数错误 400 PM.02152002 未定义错误 未定义错误 未定义错误 400 PM.02152003 传入参数名非法 传入参数名非法 传入参数名非法 400 PM.02152004 项目集未归档 项目集未归档 项目集未归档 400 PM.02152005 项目不存在或项目已被删除 项目不存在或项目已被删除 项目不存在或项目已被删除 400 PM.02152006 该项目集还没有被关注 该项目集还没有被关注 该项目集还没有被关注 400 PM.02152007 已关注该项目集 已关注该项目集 已关注该项目集 400 PM.02152008 修改创建项目集权限的参数含有非法用户 修改创建项目集权限的参数含有非法用户 修改创建项目集权限的参数含有非法用户 400 PM.02152009 项目集已归档 项目集已归档 项目集已归档 400 PM.02152010 项目类型不被允许 项目类型不被允许 项目类型不被允许 400 PM.02152011 项目已被关联 项目已被关联 项目已被关联 400 PM.02153001 访问频率过高，请稍后再试 访问频率过高，请稍后再试 访问频率过高，请稍后再试 400 PM.02175006 CN: 参数错误: {0}; EN: Invalid Parameter: {0} 参数错误 使用正确的请求参数重试 400 PM.02175101 CN: 子节点数量超过限制：{0}; Number of sub items exceeds [{0}] 子节点数量不能超过限制 删除其他子节点后再创建，或者在其他父节点下创建 400 PM.02175103 CN: 无法修改未被接纳或已拒绝的IR; EN: Only accepted initial requirement can be edited 当前IR无法被修改（只有当提出项目空间与归属项目空间相同，或者在归属项目空间被接纳的IR才能被修改。修改IR或者在父IR下创建子项时可能发生此错误） 确认修改的IR的状态后重试 400 PM.02175104 CN: 所选IR无法操作; EN: Some of the initial requirements can not be edited 部分IR无法修改（通常是因为部分请求的IR不存在） 确认所有修改的IR都存在后重试 400 PM.02175105 CN: 无效的父IR; EN: Invalid parent. 无效的父IR（此错误发生于批量创建子IR时，父IR不一致，或者父IR的归属项目空间与子IR的提出项目空间不一致，或者指定的父IR类型不正确） 使用正确的请求参数重试 400 PM.02175106 CN: 子IR必须提给其他项目空间; EN: Can not create sub ir to current program. 子IR的提出项目空间与归属项目空间不能相同 将子IR提给其他项目空间 400 PM.02175111 CN: 当前IR下有子IR，不能删除; EN: Child IR exist, can not delete. 不能删除具有子IR的父IR 删除所有子IR后再删除父IR 400 PM.02175113 CN: 父IR不存在; EN: Parent IR not exists. 父IR不存在 在正确的父IR下创建子IR 400 PM.02175114 CN: 父IR不归属于当前项目空间，请到父IR的归属项目空间进行操作; EN: Parent IR not designated in current program, please perform in the destination program of this IR. 父IR不归属于当前项目空间 到父IR的归属项目空间中重试 400 PM.02175115 CN: 不能删除IR：不具有所有子工作项所在项目的编辑权限; EN: Missing edit permission of sub items. 不能删除IR，因为不具有所有子工作项所在项目的编辑权限 申请子工作项所在项目的编辑权限后重试 400 PM.02175200 CN: 缺少必填字段 [{0}]; EN: Missing required field [{0}] 缺少必填字段 添加必填字段后重试 400 PM.02175201 CN: 字段 [{0}] 的值不正确{1}; EN: Field [{0}] has invalid value{1} IR字段的值不正确（无具体原因时，通常是格式错误，比如时间/日期字段使用了非时间戳字符串） 使用正确的值进行请求 400 PM.02175202 CN: 预计开始日期不能晚于预计结束日期; EN: Plan start date can not be later than plan due date. 预计开始日期不能晚于预计结束日期 使用正确的预计开始日期/预计结束日期参数 400 PM.10001002 不合法的token 不合法的token 不合法的token 400 PM.10002006 当前租户下名称已被使用 当前租户下名称已被使用 当前租户下名称已被使用 400 PM.10002010 描述不超过500个字符 描述不超过500个字符 描述不超过500个字符 400 PM.10002011 名称不规范 名称不规范 名称不规范 400 PM.10003002 当前用户权限不足 当前用户权限不足 当前用户权限不足 400 PM.10003003 邀请已过期 邀请已过期 邀请已过期 400 PM.10003004 审核信息不存在 审核信息不存在 审核信息不存在 400 PM.10003005 标签在使用中 标签在使用中 标签在使用中 400 PM.10003006 添加成员最多不超过100个 添加成员最多不超过100个 添加成员最多不超过100个 400 PM.10003007 最多可以添加100个项目 最多可以添加100个项目 最多可以添加100个项目 400 PM.10003008 角色不被允许 角色不被允许 角色不被允许 400 PM.10003009 创建者移交项目空间后可以退出项目 创建者移交项目空间后可以退出项目 创建者移交项目空间后可以退出项目 400 PM.10003010 成员已不存在 成员已不存在 成员已不存在 400 PM.10003011 租户下项目空间总数不能超过100个 租户下项目空间总数不能超过100个 租户下项目空间总数不能超过100个 400 PM.10003014 邀请不存在 邀请不存在 邀请不存在 400 PM.10003015 只能添加同租户下用户 只能添加同租户下用户 只能添加同租户下用户 400 PM.10003016 添加成员失败 添加成员失败 添加成员失败 401 PM.02150401 用户操作权限不足 用户操作权限不足 用户操作权限不足 403 PM.10003012 用户是项目空间成员，不需要申请 用户是项目空间成员，不需要申请 用户是项目空间成员，不需要申请 404 PM.02175005 CN: 当前请求资源不存在; EN: Requested resource not exist 查询的资源不存在 确认请求的资源是否存在（可能输入了错误的id，或资源已被删除） 405 PM.10003013 已存在加入项目空间的申请，等待管理员审批 已存在加入项目空间的申请，等待管理员审批 已存在加入项目空间的申请，等待管理员审批

规格约束 事务 使用DATABASE LINK的时候本地和远程事务的关系如下： 本地事务会同步控制远程事务的提交/回滚状态。 隔离级别的对应关系为： 本地隔离级别 远程隔离级别 Read Uncommitted Repeatable Read Read Committed Repeatable Read Repeatable Read Repeatable Read Serializable Serializable 本地事务提交过程中会向远端发送事务提交请求，如果远端事务提交成功后出现异常情况导致本地的事务提交失败，如连接异常，本地集群实例异常等情况，远端的事务提交无法被撤回，可能出现本地事务与远端事务不一致的情况。 本地用户对DATABASE LINK的使用权限 如果使用了public关键词，就是公有的DATABASE LINK，可以被所有用户/模式使用。 如果没有使用public关键词，就是私有的的DATABASE LINK，仅能被当前用户/模式使用（包括sys用户也无法跨SCHEMA使用DATABASE LINK）。 通过DATABASE LINK访问远程数据库对象的权限 对远程数据库对象的访问权限与DATABASE LINK绑定的远程连接用户的权限保持一致。 支持SQL范围 DATABASE LINK相关语句支持情况见表1。 DATABASE LINK相关表类型支持情况见表2。 DATABASE LINK函数调用 DATABASE LINK调用远程函数不支持自定义类型、OUT/INOUT参数、PACKAGE内函数、聚集函数、窗口函数、以及返回set函数。 PLSQL_BODY内通过DATABASE LINK调用远程数据库的存储过程或函数不支持自定义类型、OUT/INOUT参数、PACKAGE内函数、重载函数、聚集函数、窗口函数、以及返回set函数。 PLSQL_BODY内调用远程数据库的存储过程或函数时，应使用[CALL | SELECT] [ schema. ] { func_name@dblink | procedure_name@dblink } ( param_expr )语法格式调用。 PLSQL_BODY内调用远程数据库的无参存储过程或函数时，应使用[CALL | SELECT] [ schema. ] { func_name@dblink | procedure_name@dblink } ( )语法格式调用。 同义词 不支持将DATABASE LINK名创建为一个同义词的使用方法。 不支持通过DATABASE LINK调用远端数据库中指向一个DATABASE LINK对象的同义词。例如如下场景： 步骤一：在DB1上创建表TABLE1。 步骤二：在DB2上创建连接DB1的DBLINK1，并创建同义词"CREATE SYNONYM T1 FOR TABLE1@DBLINK1"。 步骤三：在DB3上创建连接DB2的DBLINK2，通过DBLINK2调用DB2上的同义词T1，"SELECT * FROM T1@DBLINK2"。 表类型约束 HASHBUCKET：不支持通过DATABASE LINK对远端Hash bucket表进行查询或DML操作。 SLICE：不支持通过DATABASE LINK对远端slice表进行查询或DML操作。 复制表：不支持通过DATABASE LINK对远端复制表进行查询或DML操作。 TEMPORARY：不支持通过DATABASE LINK对远端临时表进行查询或DML操作。 视图 目前支持对DATABASE LINK的远端表创建视图，但是当远端表本身的结构发生变化时，该视图使用时可能会发生异常。例如： 步骤一：在DB1上创建表TABLE1。 步骤二：在DB2上创建连接DB1的DBLINK，并创建视图"CREATE VIEW V1 AS SELECT * FROM TABLE1@DBLINK。 步骤三：在DB1上删除TABLE1的一列，在DB2上查询该视图会产生报错。 其他场景： DATABASE LINK表不支持TRIGGER，包括TRIGGER调用函数内使用DATABASE LINK场景、TRIGGER调用函数为DATABASE LINK函数、在DATABASE LINK上定义TRIGGER情况。 暂不支持UPSERT、MERGE语法。 不支持current cursor语法。 不支持查询表的隐藏字段。 dump与备份 不支持DATABASE LINK相关数据库对象的dump，备机不支持DATABASE LINK调用，也不支持被DATABASE LINK连接。 不支持DATABASE LINK相关数据库对象的集群备份后恢复使用。因为不同集群的密钥文件不同，在使用DATABASE LINK时需要使用集群密钥文件进行解密。 谓词下推约束 仅支持WHERE子句使用的数据类型、操作符和函数是内置的，并且使用的函数是IMMUTABLE类型。 聚集函数下推约束 仅支持单表且没有GROUP、ORDER BY、HAVING、LIMIT子句的SELECT语句，并且不支持窗口函数。 hint下推 支持针对DATABASE LINK表对象的hint条件下推，仅限scan方式的hint下推，语法格式如下： [no] tablescan|indexscan|indexonlyscan(table [index]) 并要求在一个 queryblock 中的表名或表别名不能重复。 表1 支持SQL范围 SQL类型 操作对象 支持选项说明 执行上下文 创建DATABASE LINK DATABASE LINK NA 普通事务块 修改DATABASE LINK DATABASE LINK 仅支持用户名、密码的修改 普通事务块 删除DATABASE LINK DATABASE LINK NA 普通事务块 SELECT语句 普通表、普通视图、全量物化视图 WHERE子句 DATABASE LINK表和内部表JOIN DATABASE LINK表和DATABASE LINK表JOIN 聚集函数 LIMIT子句 ORDER BY子句 GROUP BY子句、HAVING子句 UNION子句 WITH子句 START WITH子句和CONNECT BY子句 FOR UPDATE子句 Rownum使用 普通事务块、存储过程、函数、高级包、逻辑视图 INSERT语句 普通表 多VALUE插入 普通事务块、存储过程、函数、高级包 UPDATE语句 普通表 LIMIT子句 ORDER BY子句 WHERE子句 普通事务块、存储过程、函数、高级包 DELETE语句 普通表 LIMIT子句 ORDER BY子句 WHERE子句 普通事务块、存储过程、函数、高级包 LOCK TABLE语句 普通表 LOCKMODE子句 NOWAIT子句 普通事务块 表2 表类型支持情况 维度 GaussDB 表类型 DATABASE LINK支持情况 TEMP选项 临时表 不支持 全局临时表 支持 UN LOG GED选项 非日志表 支持 存储特性 行存 Astore 支持 Ustore 支持 分区表 支持 二级分区表 支持 视图 DATABASE LINK访问远程视图 支持dql，不支持dml 本地视图通过 DATABASE LINK 关联远程表 支持dql，不支持dml

功能描述 在本地数据库利用DATABASE LINK与远程数据库建立连接，并通过DATABASE LINK对远程数据库进行访问。 DATABASE LINK可以分为public或private，private DATABASE LINK仅能被创建者访问，而当DATABASE LINK为public时则所有用户都能访问。 所有已创建的DATABASE LINK信息都存在本地数据库的系统视图gs_db_links中。

注意事项 DATABASE LINK特性只在A兼容版本下可以使用。 DATABASE LINK连接的远端数据库仅支持503.1.0及之后版本。 用户需要保证本地和远端数据库的兼容性参数DBCOMPATIBILITY和GUC参数behavior_compat_options、a_format_dev_version、a_format_version取值一致。 DATABASE LINK连接开启session时会设置如下guc参数： set search_path=pg_catalog, '$user', 'public'; set datestyle=ISO; set intervalstyle=postgres; set extra_float_digits=3; 其余参数为远端设置的参数，远端参数与本地参数不同时，可能会出现数据显示格式不一致等情况，使用时应尽量保证远端与本地参数相同。 使用前置准备：使用gs_guc在gs_hba.conf文件中添加白名单允许客户端连接。 示例：gs_guc reload -I all -N all -Z datanode -h "host all all 192.168.11.11/32 sha256" 详细配置参数信息参考gs_guc客户端认证策略设置。 创建DATABASE LINK权限需要使用GRANT语法赋予，新建用户默认无权限，系统管理员拥有权限。详见GRANT相关说明。 使用DATABASE LINK对远端表操作时，会在本地创建与远端对应的SCHEMA，若本地不存在该表的元数据信息，会将元数据信息写入本地系统表中，此时会使用7级锁保证写入的一致性，持续到事务结束放锁，删除DATABASE LINK时会将相应的元数据信息删除。 使用DATABASE LINK时在本地创建的表仅用于存储远端表的元数据信息，无法通过\d或pg_get_tabledef函数查询到表结构。 如果业务中有长事务首次使用DATABASE LINK操作远端对象，会持续持锁直到事务结束，其他首次使用DATABASE LINK的事务会被阻塞。可通过一条快速执行的语句先对要使用的远端对象做查询操作使其元数据落盘来规避这种情况，如 "select * from t1@dblink where 1=2;"。另外，远端表结构发生变化时本地要更新存储的元数据信息，也会有类似情况。 如果本地与远端字符集不同，可能会出现无法转换的报错，报错信息为远端返回报错。当本地数据库字符编码为GB18030_2022时，发送到远端会被转换为GB18030。因此，若本地数据库的字符集为GB18030_2022时，远程数据库字符集只能是GB18030或GB18030_2022。 如果在创建DATABASE LINK对象后重新生成密钥文件，使用DATABASE LINK时将会报错。因为创建DATABASE LINK时使用的密钥文件与后续解密时使用的密钥文件不一致。 在本地创建与远端对应的SCHEMA时会使用“USERNAME（私有DATABASE LINK才有）#远端SCHEMA@DBLINK名”作为SCHEMA名，名称长度上限为63。 当赋予用户创建DATABASE LINK权限时，相当于许可用户使用服务端DATABASE的IP对远端进行访问。若不希望有此效果，应不要使用GRANT对用户赋权。

注意事项 DATABASE LINK特性只在ORA兼容版本下可以使用。 DATABASE LINK连接的远端数据库仅支持503.1.0及之后版本。 用户需要保证本地和远端数据库的兼容性参数DBCOMPATIBILITY和guc参数behavior_compat_options、a_format_dev_version、a_format_version取值一致。 DATABASE LINK连接开启session时会设置如下guc参数： set search_path=pg_catalog, '$user', 'public'; set datestyle=ISO; set intervalstyle=postgres; set extra_float_digits=3; 其余参数为远端设置的参数，远端参数与本地参数不同时，可能会出现数据显示格式不一致等情况，使用时应尽量保证远端与本地参数相同。 使用前置准备：使用gs_guc在gs_hba.conf文件中添加白名单允许客户端连接。 示例：gs_guc reload -I all -N all -Z coordinator -Z datanode -h "host all all 192.168.11.11/32 sha256" 详细配置参数信息参考gs_guc客户端认证策略设置。 某些情况集群白名单中也需要添加DN的IP。 创建DATABASE LINK权限需要使用GRANT语法赋予，新建用户默认无权限，系统管理员拥有权限。详见GRANT相关说明。 使用DATABASE LINK对远端表操作时，会在本地创建与远端对应的SCHEMA，若本地不存在该表的元数据信息，会将元数据信息写入本地系统表中，此时会使用7级锁保证写入的一致性，持续到事务结束放锁，删除DATABASE LINK时会将相应的元数据信息删除。 使用DATABASE LINK时在本地创建的表仅用于存储远端表的元数据信息，无法通过\d或pg_get_tabledef函数查询到表结构。 如果业务中有长事务首次使用DATABASE LINK操作远端对象，会持续持锁直到事务结束，其他首次使用DATABASE LINK的事务会被阻塞。可通过一条快速执行的语句先对要使用的远端对象做查询操作使其元数据落盘来规避这种情况，如 "select * from t1@dblink where 1=2;"。另外，远端表结构发生变化时本地要更新存储的元数据信息，也会有类似情况。 在本地创建与远端对应的SCHEMA时会使用“USERNAME（私有DATABASE LINK才有）#远端SCHEMA@DBLINK名”作为SCHEMA名，名称长度上限为63。 如果本地与远端字符集不同，可能会出现无法转换的报错，报错信息为远端返回报错。当本地数据库字符编码为GB18030_2022时，发送到远端会被转换为GB18030。因此，若本地数据库的字符集为GB18030_2022时，远程数据库字符集只能是GB18030或GB18030_2022。 如果在创建DATABASE LINK对象后重新生成密钥文件，使用DATABASE LINK时将会报错。因为创建DATABASE LINK时使用的密钥文件与后续解密时使用的密钥文件不一致。 使用DATABASE LINK对远端表操作时，会创建一个单节点的NODE GROUP随机绑定一个DN。 当赋予用户创建DATABASE LINK权限时，相当于许可用户使用服务端DATABASE的IP对远端进行访问。若不希望有此效果，应不要使用GRANT对用户赋权。

功能描述 在本地数据库利用DATABASE LINK与远程数据库建立连接，并通过DATABASE LINK对远程数据库进行访问。 DATABASE LINK可以分为public或private，private DATABASE LINK仅能被创建者访问，而当DATABASE LINK为public时则所有用户都能访问。 所有已创建的DATABASE LINK信息都存在本地数据库的系统视图gs_db_links中。

规格约束 事务 使用DATABASE LINK的时候本地和远程事务的关系如下： 本地事务会同步控制远程事务的提交/回滚状态。 隔离级别的对应关系为： 本地隔离级别 远程隔离级别 Read Uncommitted Repeatable Read Read Committed Repeatable Read Repeatable Read Repeatable Read Serializable Serializable 本地事务提交过程中会向远端发送事务提交请求，如果远端事务提交成功后出现异常情况导致本地的事务提交失败，如连接异常，本地集群实例异常等情况，远端的事务提交无法被撤回，可能出现本地事务与远端事务不一致的情况。 本地用户对DATABASE LINK的使用权限 如果使用了public关键词，就是公有的DATABASE LINK，可以被所有用户/模式使用。 如果没有使用public关键词，就是私有的DATABASE LINK，仅能被当前用户/模式使用（包括SYSADMIN用户也无法跨SCHEMA使用DATABASE LINK）。 通过DATABASE LINK访问远程数据库对象的权限 对远程数据库对象的访问权限与DATABASE LINK绑定的远程连接用户的权限保持一致。 支持SQL范围 DATABASE LINK相关语句支持情况请参见表1。 DATABASE LINK相关表类型支持情况请参见表2。 DATABASE LINK函数调用 DATABASE LINK调用远程函数不支持自定义类型、OUT/INOUT参数、PACKAGE内函数、聚集函数、窗口函数、以及返回set函数。 PLSQL_BODY内通过DATABASE LINK调用远程数据库的存储过程或函数不支持自定义类型、OUT/INOUT参数、PACKAGE内函数、重载函数、聚集函数、窗口函数、以及返回set函数。 PLSQL_BODY内调用远程数据库的存储过程或函数时，应使用[CALL | SELECT] [ schema. ] { func_name@dblink | procedure_name@dblink } ( param_expr )语法格式调用。 PLSQL_BODY内调用远程数据库的无参存储过程或函数时，应使用[CALL | SELECT] [ schema. ] { func_name@dblink | procedure_name@dblink } ( )语法格式调用。 同义词 不支持将DATABASE LINK名创建为一个同义词的使用方法。 不支持通过DATABASE LINK调用远端数据库中指向一个DATABASE LINK对象的同义词。例如如下场景： 步骤一：在DB1上创建表TABLE1。 步骤二：在DB2上创建连接DB1的DBLINK1，并创建同义词"CREATE SYNONYM T1 FOR TABLE1@DBLINK1"。 步骤三：在DB3上创建连接DB2的DBLINK2，通过DBLINK2调用DB2上的同义词T1，"SELECT * FROM T1@DBLINK2"。 表类型约束 HASHBUCKET：不支持通过DATABASE LINK对远端Hash bucket表进行查询或DML操作。 SLICE：不支持通过DATABASE LINK对远端slice表进行查询或DML操作。 复制表：不支持通过DATABASE LINK对远端复制表进行查询或DML操作。 TEMPORARY：不支持通过DATABASE LINK对远端临时表进行查询或DML操作。 视图 目前支持对DATABASE LINK的远端表创建视图，但是当远端表本身的结构发生变化时，该视图使用时可能会发生异常。例如： 步骤一：在DB1上创建表TABLE1。 步骤二：在DB2上创建连接DB1的DBLINK，并创建视图"CREATE VIEW V1 AS SELECT * FROM TABLE1@DBLINK。 步骤三：在DB1上删除TABLE1的一列，在DB2上查询该视图会产生报错。 其他场景： DATABASE LINK表不支持TRIGGER，包括TRIGGER调用函数内使用DATABASE LINK场景、TRIGGER调用函数为DATABASE LINK函数、在DATABASE LINK上定义TRIGGER情况。 暂不支持UPSERT、MERGE语法。 不支持current cursor语法。 不支持查询表的隐藏字段。 dump与备份 不支持DATABASE LINK相关数据库对象的dump，备机不支持DATABASE LINK调用，也不支持被DATABASE LINK连接。 不支持DATABASE LINK相关数据库对象的集群备份后恢复使用。因为不同集群的密钥文件不同，在使用 DATABASE LINK 时需要使用集群密钥文件进行解密。 谓词下推约束 仅支持WHERE子句使用的数据类型、操作符和函数是内置的，并且使用的函数是IMMUTABLE类型。 聚集函数下推约束 仅支持单表且没有GROUP、ORDER BY、HAVING、LIMIT子句的SELECT语句，并且不支持窗口函数。 hint下推 支持针对DATABASE LINK表对象的hint条件下推，仅限scan方式的hint下推，语法格式如下： [no] tablescan|indexscan|indexonlyscan(table [index]) 并要求在一个 queryblock 中的表名或表别名不能重复。 表1 支持SQL范围 SQL类型 操作对象 支持选项说明 执行上下文 创建DATABASE LINK DATABASE LINK NA 普通事务块 修改DATABASE LINK DATABASE LINK 仅支持用户名、密码的修改 普通事务块 删除DATABASE LINK DATABASE LINK NA 普通事务块 SELECT语句 普通表、普通视图、全量物化视图 WHERE子句 DATABASE LINK表和内部表JOIN DATABASE LINK表和DATABASE LINK表JOIN 聚集函数 LIMIT子句 ORDER BY子句 GROUP BY子句、HAVING子句 UNION子句 WITH子句 START WITH子句和CONNECT BY子句 FOR UPDATE子句 Rownum使用 普通事务块、存储过程、函数、高级包、逻辑视图 INSERT语句 普通表 多VALUE插入 普通事务块、存储过程、函数、高级包 UPDATE语句 普通表 LIMIT子句 ORDER BY子句 WHERE子句 普通事务块、存储过程、函数、高级包 DELETE语句 普通表 LIMIT子句 ORDER BY子句 WHERE子句 普通事务块、存储过程、函数、高级包 LOCK TABLE语句 普通表 LOCKMODE子句 NOWAIT子句 普通事务块 表2 表类型支持情况 维度 GaussDB表类型 DATABASE LINK支持情况 TEMP选项 临时表 不支持 全局临时表 不支持 UNLOGGED选项 非日志表 支持 存储特性 行存 Astore 支持 Ustore 不支持 分区表 不支持 二级分区表 不支持 视图 DATABASE LINK访问远程视图 支持dql，不支持dml 本地视图通过 DATABASE LINK 关联远程表 支持dql，不支持dml

事件监控支持的事件说明 表1 云数据库 GeminiDB事件监控支持的事件说明 事件来源 事件名称 事件ID 事件级别 事件说明 处理建议 事件影响 NoSQL 创建实例业务失败 NoSQLCreateInstanceFailed 重要 一般是由于实例配额不足或底层资源不足等原因导致。 先释放不再使用的实例再尝试重新发放，或者提交工单调整配额上限。 无法创建数据库实例。 变更规格失败 NoSQLResizeInstanceFailed 重要 一般是由于底层资源不足等原因导致。 提交工单让运维在后台协调资源再重试规格变更操作。 业务中断。 添加节点失败 NoSQLAddNodesFailed 重要 一般是由于底层资源不足等原因导致。 提交工单让运维在后台协调资源，删除添加失败的节点，重新尝试添加新节点。 无 删除节点失败 NoSQLDeleteNodesFailed 重要 一般是由于底层释放资源失败导致。 重新尝试删除节点。 无 扩卷失败 NoSQLScaleUpStorageFailed 重要 一般是由于底层资源不足等原因导致。 提交工单让运维在后台协调资源再重试扩卷操作。 如果磁盘满，会导致业务中断。 重置密码失败 NoSQLResetPasswordFailed 重要 一般是由于重置密码命令超时导致。 重新尝试重置密码操作。 无 修改参数模板失败 NoSQLUpdateInstanceParamGroupFailed 重要 一般是由于修改参数模板命令超时导致。 重新尝试修改参数模板操作。 无 设置备份策略失败 NoSQLSetBackupPolicyFailed 重要 一般是由于数据库连接异常导致。 重新重试设置备份策略操作。 无 创建手动备份失败 NoSQLCreateManualBackupFailed 重要 一般是备份文件导出失败或上传失败等原因导致。 提交工单让运维处理。 无法备份数据。 创建自动备份失败 NoSQLCreateAutomatedBackupFailed 重要 一般是备份文件导出失败或上传失败等原因导致。 提交工单让运维处理。 无法备份数据。 实例运行状态异常 NoSQLFaultyDBInstance 重要 由于灾难或者物理机故障导致实例故障时，会上报该事件，属于关键告警事件。 提交工单。 可能导致数据库服务不可用。 实例运行状态异常已恢复 NoSQLDBInstanceRecovered 重要 针对灾难性的故障，NoSQL有高可用工具会自动进行恢复或者手动恢复，执行完成后会上报该事件。 不需要处理。 无 节点运行状态异常 NoSQLFaultyDBNode 重要 由于灾难或者物理机故障导致数据库节点故障时，会上报该事件，属于关键告警事件。 检查数据库服务是否可以正常使用，并提交工单。 可能导致数据库服务不可用。 节点运行状态异常已恢复 NoSQLDBNodeRecovered 重要 针对灾难性的故障，NoSQL有高可用工具会自动进行恢复或者手动恢复，执行完成后会上报该事件。 不需要处理。 无 实例主备切换 NoSQLPrimaryStandbySwitched 重要 在手动触发的主备倒换或节点故障自动触发的故障倒换场景下，会上报该事件。 不需要处理。 无 出现热点分区键 HotKeyOccurs 重要 客观上是因为主键设置不合理，使得热点数据集中分布在一个分区。客户端不合理的应用程序设计，造成对某一key的频繁读写。 1. 选择合理的分区键。 2. 业务增加缓存，业务应用先从缓存中读取热点数据。 影响业务请求成功率，存在影响集群性能及稳定性的风险。 出现超大分区键 BigKeyOccurs 重要 主键设计不合理，单个分区的记录数或数据量过大，引起了节点负载不均。 1. 选择合理的分区键 2. 基于现有分区键，增加分区键散列。 随着数据量增长，集群稳定性会下降。 数据盘空间不足 NoSQLRiskyDataDiskUsage 重要 数据盘空间不足，产生此告警。 请参见对应服务用户指南中“扩容磁盘”的内容，进行磁盘扩容。 实例被设为只读模式，数据无法写入。 数据盘空间已扩容并恢复可写 NoSQLDataDiskUsageRecovered 重要 数据盘空间已扩容并恢复可写，产生此事件。 无需处理。 无 创建索引失败 NoSQLCreateIndexFailed 重要 业务负载超过实例规格瓶颈，此时再创建索引会耗费更多实例资源，导致响应变慢甚至卡顿，最终超时，引起索引创建失败。 1、根据业务负载，选择匹配的实例规格 2、在业务低峰期创建索引 3、使用后台方式创建索引 4、索引字段，结合业务进行合理选择。 索引创建失败或不完整，导致索引无效，需要删掉索引重新创建。 发生写入降速 NoSQLStallingOccurs 重要 写入速度快，接近集群规模和实例规格范围允许最大写能力，从而触发数据库自身的限流机制，会发生请求失败情况 1. 根据业务的最大写请求速率，调整集群规模或者节点规格 2. 衡量业务的最大写请求速率，分散业务写峰值速率 影响业务的请求的成功率 发生写入停止 NoSQLStoppingOccurs 重要 写入速度过快，达到集群规模和实例规格范围允许最大写能力，从而触发数据库自身的限流机制，会发生请求失败情况 1. 根据业务的最大写请求速率，调整集群规模或者节点规格 2. 衡量业务的最大写请求速率，分散业务写峰值速率 影响业务的请求的成功率 重启数据库失败 NoSQLRestartDBFailed 重要 一般是由于实例状态异常等原因导致。 提交工单让运维处理。 数据库实例状态可能存在异常。 恢复到新实例失败 NoSQLRestoreToNewInstanceFailed 重要 一般是由于底层资源不足等原因导致。 提交工单让运维在后台协调资源，重新尝试添加新节点。 无法恢复到新的数据库实例。 恢复到已有实例失败 NoSQLRestoreToExistInstanceFailed 重要 一般是由于备份文件下载或恢复失败等原因导致。 提交工单让运维处理。 当前数据库实例可能处于不可用状态。 删除备份文件失败 NoSQLDeleteBackupFailed 重要 一般是由于备份文件从obs删除失败导致。 重新尝试删除备份文件。 无 切换慢日志明文开关失败 NoSQLSwitchSlowlogPlainTextFailed 重要 一般是由于接口不支持切换等原因导致。 请查阅NoSQL用户指南，确认接口支持打开慢日志明文开关。提交工单让运维处理。 无 绑定EIP失败 NoSQLBindEipFailed 重要 一般是由于节点状态不正常，节点已经绑定EIP或EIP非法等原因导致。 检查节点是否正常，EIP是否合法。 无法通过公网访问数据库实例。 解绑EIP失败 NoSQLUnbindEipFailed 重要 一般是由于节点状态不正常，节点已经未绑定EIP等原因导致。 检查节点和EIP状态是否正常。 无 修改参数失败 NoSQLModifyParameterFailed 重要 一般是由于参数取值非法等原因导致。 排查参数值是否符合在合法范围内，提交工单让运维处理。 无 参数模板应用失败 NoSQLApplyParameterGroupFailed 重要 一般是由于实例状态异常导致参数模板无法应用等原因导致。 提交工单让运维处理。 无 开启或关闭SSL失败 NoSQLSwitchSSLFailed 重要 一般是由于修改SSL命令超时导致。 重新提交一次或者提交工单处理，并先保持切换之前使用SSL的连接方式。 是否使用SSL连接。 单行数据量太大 LargeRowOccurs 重要 用户单行数据量过大，可能会导致查询超时，进而节点OOM异常等各种故障发生。 1. 对每列和每行的写入长度做限制，遵从规范，使得单行的的key和value长度和不超过阈值。 2. 排查业务是否出现异常写入和异常编码，导致写入大row。 过大的单行记录，随着数据量增长，集群稳定性会下降。 父主题： 附录