华为云用户手册

  • URI DELETE /v1.0/{project_id}/instances?allFailure={allFailure} 参数说明见表1。 表1 参数说明 参数 类型 必选 说明 project_id String 是 项目ID。 allFailure String 否 是否批量删除创建失败的缓存实例。 取值如下: true,表示删除租户所有创建失败的缓存实例,此时请求参数instances可为空; false或者其他值,表示删除instances参数数组中指定的缓存实例。
  • 请求消息 请求参数 参数说明见表2。 表2 参数说明 参数 类型 必选 说明 new_capacity Integer 是 新的缓存实例规格,新的规格必须大于扩容前的规格,单位:GB。 取值必须是当前产品支持的实例规格,具体取值,请查看《产品介绍》手册的实例规格章节,查找到对应的“内存规格(GB)”列。 spec_code String 是 扩容后的缓存实例产品规格编码。 如果是Redis3.0实例,该字段为可选。 如果是Redis4.0和Redis5.0实例,该字段为必选。 具体取值,请查看《产品介绍》手册的实例规格章节,查找到对应的“产品规格名称”列。 请求示例 POST https://{dcs_endpoint}/v1.0/{project_id}/instances/{instance_id}/extend
  • 请求消息 请求参数 参数说明见表2。 表2 参数说明 参数 类型 必选 说明 instances Array 否 实例的ID列表。 仅当URI中参数allFailure值为“false”或者其他值时,才需要配置该参数。 一次最多可删除50个实例。 请求URL: DELETE https://{dcs_endpoint}/v1.0/{project_id}/instances?allFailure={allFailure} 当allFailure为false时,请求示例如下: { "instances": [ "54602a9d-5e22-4239-9123-77e350df4a34", "7166cdea-dbad-4d79-9610-7163e6f8b640" ]}
  • 响应消息 响应参数 参数说明见表2。 表2 参数说明 参数 类型 说明 instances Array 实例的详情数组。 instance_num Integer 实例个数。 表3 instance参数说明 参数 类型 说明 name String 实例名称。 engine String 缓存引擎。 capacity Integer 缓存容量(G Byte)。 ip String 连接缓存实例的IP地址。如果是集群实例,返回多个IP地址,使用逗号分隔。如:192.168.0.1,192.168.0.2。 domainName String 实例的域名。 port Integer 缓存的端口。 status String 缓存实例的状态。详细状态说明见缓存实例状态说明。 max_memory Integer 总内存,单位:MB。 used_memory Integer 已使用的内存,单位:MB。 instance_id String 实例ID。 resource_spec_code String 资源规格标识。 dcs.single_node:表示实例类型为单机 dcs.master_standby:表示实例类型为主备 dcs.cluster:表示实例类型为集群 engine_version String 缓存版本。 internal_version String D CS 内部版本号。 charging_mode Integer 付费模式,0表示按需计费,1表示包年/包月计费。 capacity_minor String 小规格缓存容量(G Byte)。 vpc_id String VPC ID。 vpc_name String VPC的名称。 created_at String 创建时间。格式为:2017-03-31T12:24:46.297Z error_code String 实例创建失败或状态异常时的错误码,错误码的说明见表3。 user_id String 用户id。 user_name String 用户名。 maintain_begin String 维护时间窗开始时间,格式为HH:mm:ss。 maintain_end String 维护时间窗结束时间,格式为HH:mm:ss。 no_password_access String 是否允许免密码访问缓存实例。 true:该实例无需密码即可访问。 false:该实例必须通过密码认证才能访问。 access_user String 通过密码认证访问缓存实例的认证用户名。 enable_publicip Boolean Redis缓存实例是否开启公网访问功能。 true:开启 false:不开启 publicip_address String Redis缓存实例绑定的弹性IP地址。 如果未开启公网访问功能,该字段值为null。 publicip_id String Redis缓存实例绑定的弹性IP地址的id。 如果未开启公网访问功能,该字段值为null。 enable_ssl Boolean Redis缓存实例开启公网访问功能时,是否选择支持ssl。 true:开启 false:不开启 service_upgrade Boolean 实例是否存在升级任务。 true:存在 false:不存在 service_task_id String 升级任务的ID。 当service_upgrade为true时,该参数为升级任务的ID。 当service_upgrade为false时,该参数为空。 enterprise_project_id String 企业项目ID。 security_group_id String 租户安全组名称。 tags Array of objects 实例标签键值。 响应示例 { "instances": [ { "name": "dcs-lxy", "engine": "Redis", "capacity": 4, "ip": "192.168.7.146", "domainName": null, "port": 6379, "status": "CREATING", "max_memory": 3277, "used_memory": 0, "instance_id": "a4d31cb6-3d72-4fdc-8ec9-6e3a41e47f71", "resource_spec_code": "dcs.master_standby", "engine_version": "3.0", "internal_version": null, "charging_mode": 0, "capacity_minor": null, "vpc_id": "c71d9731-9b0c-43e9-ab2a-716af9d9fd55", "vpc_name": "CCE-AutoCreate-VPC-7qvs1", "created_at": "2019-09-23T02:40:06.123Z", "error_code": null, "user_id": "50a4156d334a4a82b8745dc730dc1e00", "user_name": "hwstaff_f00443635", "maintain_begin": "02:00:00", "maintain_end": "06:00:00", "no_password_access": "true", "access_user": null, "enable_publicip": false, "publicip_id": null, "publicip_address": null, "enable_ssl": false, "service_upgrade": false, "service_task_id": "", "enterprise_project_id": "0", "tags": [ { "key": "dcs001", "value": "001" }, { "key": "dcs002", "value": "002" } ], "security_group_id": "0cc8fdb7-872a-49da-a062-88ccc39463b5" }], "instance_num": 1}
  • URI GET /v1.0/{project_id}/instances?start={start}&limit={limit}&name={name}&status={status}&id={id}&include_failure={include_failure}&isExactMatchName={isExactMatchName}&ip={ip}&tags={key}={value} 参数说明见表1。 表1 参数说明 参数 类型 必选 说明 project_id String 是 项目ID。 start Integer 否 数据的起始序号,默认起始序号为1。 limit Integer 否 每页显示条数,最小值为1,最大值为1000,若不设置该参数,则为最大显示条数1000。 name String 否 实例名称。 id String 否 实例ID。 status String 否 实例状态。详细状态说明见缓存实例状态说明。 ip String 否 连接缓存实例的IP地址。 include_failure String 否 是否返回创建失败的实例数。 当参数值为“true”时,返回创建失败的实例数。参数值为“false”或者其他值,不返回创建失败的实例数。 isExactMatchName String 否 是否按照实例名称进行精确匹配查询。 默认为“false”,表示模糊匹配实例名称查询。若参数值为“true”表示按照实例名称进行精确匹配查询。 tags Array of objects 否 根据实例标签键值对进行查询。{key}表示标签键,{value}表示标签值。 如果同时使用多个标签键值对进行查询,中间使用逗号分隔开,表示查询同时包含指定标签键值对的实例。 示例 GET https://{dcs_endpoint}/v1.0/bd6b78e2ff9e4e47bc260803ddcc7a21/instances?start=1&limit=10&name=&status=&id=&include_failure=true&isExactMatchName=false 或: GET https://{dcs_endpoint}/v1.0/bd6b78e2ff9e4e47bc260803ddcc7a21/instances?tags=dcs001=001,dcs002=002
  • 响应消息 响应参数 参数说明见表2。 表2 参数说明 参数 类型 说明 name String 实例名称。 engine String 缓存实例的引擎类型。 capacity Integer 缓存实例的容量(G Byte)。 ip String 连接缓存实例的IP地址。如果是集群实例,返回多个IP地址,使用逗号分隔。如:192.168.0.1,192.168.0.2。 domainName String 实例的域名。 port Integer 缓存的端口。 status String 缓存实例的状态。详细状态说明见缓存实例状态说明。 libos Boolean true:该实例是libos实例。 false:该实例不是libos实例。 description String 实例描述。 max_memory Integer 总内存,单位:MB。 used_memory Integer 已使用的内存,单位:MB。 instance_id String 实例ID。 resource_spec_code String 资源规格标识。 dcs.single_node:表示实例类型为单机 dcs.master_standby:表示实例类型为主备 dcs.cluster:表示实例类型为集群 engine_version String 缓存版本。 internal_version String DCS内部版本号。 charging_mode Integer 付费模式,0表示按需计费,1表示包年/包月计费。 capacity_minor String 单机小规格的缓存容量。 vpc_id String VPC ID。 vpc_name String VPC的名称。 created_at String 完成创建时间。格式为:2017-03-31T12:24:46.297Z error_code String 实例创建失败或状态异常时的错误码,错误码说明见表3。 user_id String 用户id。 user_name String 用户名。 maintain_begin String 维护时间窗开始时间,格式为HH:mm:ss。 maintain_end String 维护时间窗结束时间,格式为HH:mm:ss。 no_password_access String 是否允许免密码访问缓存实例。 true:该实例无需密码即可访问。 false:该实例必须通过密码认证才能访问。 access_user String 通过密码认证访问缓存实例的认证用户名。 enable_publicip Boolean Redis缓存实例是否开启公网访问功能。 true:开启 false:不开启 publicip_id String Redis缓存实例绑定的弹性IP地址的id。 如果未开启公网访问功能,该字段值为null。 publicip_address String Redis缓存实例绑定的弹性IP地址。 如果未开启公网访问功能,该字段值为null。 enable_ssl Boolean Redis缓存实例开启公网访问功能时,是否选择支持ssl。 true:开启 false:不开启 service_upgrade Boolean 实例是否存在升级任务。 true:存在 false:不存在 service_task_id String 升级任务的ID。 当service_upgrade为true时,该参数为升级任务的ID。 当service_upgrade为false时,该参数为空。 enterprise_project_id String 企业项目ID。 available_zones Array 实例节点所在的可用区。返回“可用区ID”。 subnet_id String 子网ID。 security_group_id String 安全组ID。 backend_addrs String 集群实例的后端服务地址。 product_id String 产品标识。 security_group_name String 租户安全组名称。 subnet_name String 子网名称。 subnet_cidr String 子网网段。 order_id String 订单ID。 instance_backup_policy JSON 备份策略,实例类型为主备和集群时支持。详情参考表4和表5。 tags Array of objects 实例标签键值。 表3 错误码说明 错误码 说明 dcs.00.0007 系统异常。 dcs.01.0001 内部服务错误。 dcs.01.0002 内部服务错误。 dcs.01.0003 内部服务错误。 dcs.02.0001 VPC创建失败。 dcs.02.0002 VPC创建失败。 dcs.02.0003 安全组创建失败。 dcs.02.0004 子网创建失败。 dcs.02.0005 子网状态异常。 dcs.03.0001 创建ECS失败。 dcs.03.0002 创建ECS失败。 dcs.03.0003 创建ECS失败。 dcs.03.0004 创建ECS失败。 dcs.03.0005 ECS绑定网卡失败。 dcs.03.0007 ECS启动失败。 dcs.03.0008 ECS启动失败。 dcs.03.0009 ECS停止失败。 dcs.03.0017 实例部分节点故障。 dcs.04.0002 实例部署异常。 dcs.04.0003 无法连接实例。 dcs.04.0004 存在两个主节点,主备节点间网络连接可能有问题。 响应示例 {"name": "dcs-125d","engine": "Redis","capacity": 64,"ip": "192.168.1.48","domainName": "XXXXXX","port": 6379,"status": "RUNNING","libos": false,"description": null,"task": null,"max_memory": 65536,"used_memory": 33,"instance_id": "979e9a6b-e2f5-4b5d-8e98-fea495ea27a1","resource_spec_code": "dcs.cluster","engine_version": "3.0","internal_version": null,"charging_mode": 0,"capacity_minor": null,"vpc_id": "d1e8008d-8182-4c86-a142-1ae9349bdc64","vpc_name": "vpc-807d","task_status": null,"created_at": "2018-12-11T07:24:18.149Z","error_code": null,"user_id": "9bfac09d9bcd4eb7bb1465a7bcff815b","user_name": "r00209145","maintain_begin": "02:00:00","maintain_end": "06:00:00","no_password_access": "true","access_user": null,"enable_publicip": false,"publicip_id": null,"publicip_address": null,"enable_ssl": false,"service_upgrade": false,"service_task_id": null,"is_free": null,"enterprise_project_id": "0","available_zones": ["f84448fd537f46078dd8bd776747f573"],"subnet_id": "9b32218f-6389-485a-912e-076fe9df6fa7","security_group_id": "ecefdad9-c8be-42aa-9d5d-9ab46a221240","backend_addrs": ["192.168.1.136:6379","192.168.1.224:6379"],"product_id": "00301-17063-0--0","security_group_name": "sg--test-hanwang","subnet_name": "subnet-7e46","order_id": null,"subnet_cidr": "192.168.1.0/24","instance_backup_policy": null, "tags": [ { "key": "dcs001", "value": "001" }, { "key": "dcs002", "value": "002" } ],"enterprise_project_name": null}
  • 响应消息 状态码为 200 时,响应参数和响应示例如下: 响应参数 参数 参数类型 描述 bucket_name String OBS桶名。 file_path String OBS桶内文件路径。 links Array 备份文件下载链接集合,链接数最大为64个。 参数 参数类型 描述 file_name String 备份文件名称。 link String 备份文件下载链接地址。 响应示例 { "bucket_name": "bucket6d1b61f3d7434f60b7e465f4037d73f3", "file_path": "3dc6ba15-ba97-4624-bcbd-3cc08d6336b0/20190924204307_redis.rdb", "links": [ { "file_name": "20190924204307_redis.rdb", "link": "https://bucket6d1b61f3d7434f60b7e465f4037d73f3.obs.cn-north-4.myhuaweicloud.com:443/3dc6ba15-ba97-4624-bcbd-3cc08d6336b0/20190924204307_redis.rdb?AWSAccessKeyId=IMRORRY3GETV9CEH3GE0&Expires=1569329601&Signature=NGhdEGwHImXNyYyryx3AYqfAvoA%3D" } ]}
  • 响应消息 响应参数 表1 响应参数 参数 参数类型 描述 group_count String 实例分片总数。 group_list Array of objects 分片列表。具体参数请参见表2。 表2 group_list参数说明 参数 参数类型 描述 group_id String 分片id group_name String 分片名称 replication_list Array of objects 每个分片包含的副本列表。具体参数请参见表3。 表3 replication_list参数说明 参数 参数类型 描述 replication_ip String 副本IP。 replication_role String 副本角色,取值有: master:表示主节点。 slave:表示从节点。 node_id String 节点ID。 replication_id String 副本ID。 is_replication Boolean 是否是新加副本。 status String 副本状态。 响应示例 状态码为 200 时: { "group_list": [ { "group_id": "a11d3ba3-7898-4371-bfbe-783ab9280cc7", "group_name": "group-2", "replication_list": [ { "replication_ip": "192.168.0.156", "replication_role": "master", "node_id": "8aa6999f6de47c69016df0e7de1c23de", "replication_id": "1a5f2b63-eedc-4bb1-a25f-262b5d604a1f", "is_replication": false, "status": "Active" }, { "replication_ip": "192.168.0.45", "replication_role": "slave", "node_id": "8aa6999f6de47c69016df0e7de2e23df", "replication_id": "2b892b07-dfe8-4b86-98cc-736b4e8e420f", "is_replication": false, "status": "Active" } ] }, { "group_id": "2ba84ddc-558c-4465-bfe9-dbfaac024565", "group_name": "group-1", "replication_list": [ { "replication_ip": "192.168.0.95", "replication_role": "master", "node_id": "8aa6999f6de47c69016df0e7ddf623dc", "replication_id": "b46cbcca-05a7-47b0-bd01-df768a1faf73", "is_replication": false, "status": "Active" }, { "replication_ip": "192.168.0.204", "replication_role": "slave", "node_id": "8aa6999f6de47c69016df0e7de0923dd", "replication_id": "56ddd52e-0c95-40f2-a596-b578456c1431", "is_replication": false, "status": "Active" } ] }, { "group_id": "995e1f3b-f9c0-4acf-ad9d-89123d1fd12a", "group_name": "group-0", "replication_list": [ { "replication_ip": "192.168.0.233", "replication_role": "master", "node_id": "8aa6999f6de47c69016df0e7ddd223da", "replication_id": "71749f79-e9ea-4173-8bfa-b97357153af8", "is_replication": false, "status": "Active" }, { "replication_ip": "192.168.0.27", "replication_role": "slave", "node_id": "8aa6999f6de47c69016df0e7dde423db", "replication_id": "707b7318-9766-47a8-91ad-7d0feab64229", "is_replication": false, "status": "Active" } ] } ], "group_count": 3}
  • URI POST /v1.0/{project_id}/instance/{instance_id}/groups/{group_id}/replications 参数 是否必选 参数类型 描述 project_id 是 String 项目ID。 instance_id 是 String 实例ID。 group_id 是 String 分片ID。即查询分片信息响应消息中的group_id参数的值。 URI示例: POST https://{dcs_endpoint}/v1.0/{project_id}/instance/{instance_id}/groups/{group_id}/replications
  • URI DELETE /v2/{project_id}/instances/{instance_id}/groups/{group_id}/replications/{node_id} 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID instance_id 是 String 实例ID。 group_id 是 String 分片ID。 node_id 是 String 节点ID。
  • 错误码 当您调用API时,如果遇到“APIGW”开头的错误码,请参见API网关错误码进行处理。 更多服务错误码请参见API错误中心。 状态码 错误码 错误信息 描述 处理措施 400 111400002 Invalid project ID format. Project ID的格式无效。 请检查请求参数是否合法。 400 111400004 Empty request body. 请求消息体为空。 请检查请求参数是否合法。 400 111400005 The message body contains invalid characters or is not in JSON format. 请求消息体不是JSON格式或字段非法 。 请检查请求参数是否合法。 400 111400007 The selected cache engine type is not supported. 不支持的缓存类型。 请检查请求参数是否合法。 400 111400008 The selected cache engine version is not supported. 不支持的缓存版本。 请检查请求参数是否合法。 400 111400009 Invalid product ID in the request. 请求参数product_id非法。 请检查请求参数是否合法。 400 111400010 Invalid DCS instance name. The name must be 4 to 64 characters in length. Only letters (case-insensitive), digits, underscores (_) ,and hyphens (-) are allowed. 实例名称不合法,只能包含字母、数字、下划线或者中划线,长度为4-64。 请检查请求参数是否合法。 400 111400011 DCS instance description cannot exceed 1024 characters. 实例描述长度必须为0-1024。 请检查请求参数是否合法。 400 111400012 Invalid capacity parameter in the request. 请求参数capacity非法。 请检查请求参数是否合法。 400 111400013 Invalid vpc_id in the request. 请求参数vpc_id为空。 请检查请求参数是否合法。 400 111400014 Invalid security_group_id in the request. 请求参数security_group_id为空。 请检查请求参数是否合法。 400 111400016 Invalid subnet_id in the request. 请求参数subnet_id为空。 请检查请求参数是否合法。 400 111400017 This DCS instance job task is still running. 实例任务还在运行中。 请稍后重试。 400 111400018 This subnet must exist in the VPC. 子网必须在VPC中存在。 请检查请求参数是否合法。 400 111400019 The password does not meet complexity requirements. 密码复杂度不符合要求。 请检查请求参数是否合法。 400 111400020 DHCP must be enabled for this subnet. 子网的DHCP必须开启。 请检查是否开启DHCP。 400 111400021 The isAutoRenew parameter in the request must be either 0 or 1. 请求参数isAutoRenew非法,只能为0或者1。 请检查请求参数是否合法。 400 111400022 Engine does not match the product id. 缓存引擎与产品ID不匹配。 请检查请求参数是否合法。 400 111400026 This operation is not allowed when the DCS instance is in the current state. 实例的当前状态不支持此操作。 请稍后重试或联系技术支持。 400 111400027 This operation is not supported on this node. 当前节点不支持该操作。 请稍后重试或联系技术支持。 400 111400035 DCS instance quota of the tenant is insufficient. 租户实例配额不足。 请联系技术支持。 400 111400036 Memory quota of the tenant is insufficient. 租户内存配额不足。 请联系技术支持。 400 111400037 The instanceParams parameter in the request contains invalid characters or is not in JSON format. 请求参数instanceParams非法,不是JSON格式或字段非法。 请检查请求参数是否合法。 400 111400038 The periodNum parameter in the request must be an integer. 请求参数periodNum非法,必须为整数。 请检查请求参数是否合法。 400 111400039 The quota limit has been reached. 请求调整配额超出限制范围。 请检查请求参数是否合法。 400 111400042 This AZ does not exist. 可用区不存在。 请检查请求参数是否合法。 400 111400045 This DCS instance is already unfrozen. 实例没有被冻结,不能进行解除冻结操作。 请检查请求参数是否合法。 400 111400046 This security group does not exist. 安全组不存在。 请检查请求参数是否合法。 400 111400047 The periodType parameter in the request must be either 2 or 3. 请求参数periodType非法,必须为2或者3。 请检查请求参数是否合法。 400 111400048 The security group must have both outbound and inbound rules with protocols set to ANY. 安全组规则不符合要求,请确保安全组规则中同时包含协议为“ANY”的出方向和入方向规则。 请检查请求参数是否合法。 400 111400053 the upgrade instance version equals to current version. 请求参数targetVersion非法,不能与当前版本相同。 请检查请求参数是否合法。 400 111400054 the selected available zone quota not enough. 当前选择的可用区DCS服务已售罄。 请前往其他可用区购买或联系技术支持。 400 111400060 This DCS instance name already exists. 实例名称已经存在。 请检查请求参数是否合法。 400 111400061 Invalid instance ID format. 实例ID的格式无效。 请检查请求参数是否合法。 400 111400062 Invalid {0} parameter in the request. 查询参数{0}非法。 请检查请求参数是否合法。 400 111400063 Invalid {0} parameter in the request. 请求参数{0}非法。 请检查请求参数是否合法。 400 111400064 The action parameter in the request must be start, stop, or restart. 请求参数action非法,只能为start、stop或restart。 请检查请求参数是否合法。 400 111400065 The instances parameter in the request cannot be a null value or left unspecified. 请求参数instances为空。 请检查请求参数是否合法。 400 111400066 Invalid value of the configure parameter {0}. 配置参数{0}非法。 请检查请求参数是否合法。 400 111400067 The available_zones parameter in the request must an array that contains only one AZ ID. 请求参数available_zones非法,必须为只包含一个可用区ID的数组。 请检查请求参数是否合法。 400 111400068 This VPC does not exist. VPC不存在。 请检查请求参数是否合法。 400 111400070 Invalid task ID format. 任务ID的格式无效。 请检查请求参数是否合法。 400 111400072 Invalid saveDays instance backup policy parameter in the request. 请求的实例备份策略参数saveDays非法,范围在1-7天。 请检查请求参数是否合法。 400 111400073 Invalid backupType instance backup policy parameter in the request. 请求的实例备份策略参数backupType非法,只支持auto、manual。 请检查请求参数是否合法。 400 111400074 Invalid periodType instance backup policy parameter in the request. 请求的实例备份策略参数periodType非法,只支持weekly。 请检查请求参数是否合法。 400 111400075 Invalid backupAt instance backup policy parameter in the request. 请求的实例备份策略参数backupAt非法,不能为空。 请检查请求参数是否合法。 400 111400076 Invalid beginAt instance backup policy parameter in the request. 请求的实例备份策略参数beginAt非法,只能是00:00-00:00格式。 请检查请求参数是否合法。 400 111400080 Instance password verify failed. 实例密码校验错误。 请检查请求参数是否合法。 400 111400086 only master standby instance is support this action 只有主备类型的实例才支持这个操作。 不支持此操作。 400 111400087 the backup record status is err when restore this instance 恢复实例时,备份记录的状态错误,succeed状态的才能进行恢复。 请稍后重试或联系技术支持。 400 111400094 the system is not support dcs job. 系统不支持后台任务功能。 不支持此操作。 400 111400095 the system is not support backup and restore. 系统不支持备份恢复功能。 不支持此操作。 400 111400096 the instance is backuping. 实例正在备份中,请稍后重试。 请稍后重试。 400 111400097 the instance is restoring. 实例正在恢复中,请稍后重试。 请稍后重试。 400 111400098 The value of the remark parameter must be 0 to 128 characters in length. 请求的实例备份策略参数remark非法,长度0-128。 请检查请求参数是否合法。 400 111400099 DCS instances in the Creating, Starting, Stopping, or Restarting state cannot be deleted. 实例状态为创建中、重启中、删除中时不允许执行删除操作。 请稍后重试。 400 111400100 The number of instance IDs in an instances array cannot exceed 50. instances数组最多只能包含50个实例ID。 请检查请求参数是否合法。 400 111400102 The system is not support resize. 系统不支持扩容。 不支持此操作。 400 111400103 The system is not support resize. 扩容容量必须比原容量大。 请检查请求参数是否合法。 400 111400104 The DCS instance is recovering from an internal fault. Please try again later or contact customer service. 实例内部异常正在恢复,请稍后重试或联系客服。 请稍后重试或联系技术支持。 400 111400105 The value of reserved-memory cannot be greater than the free memory size of this DCS instance. 配置参数reserved-memory的值不能大于实例的空闲内存。 请检查请求参数是否合法。 400 111400106 The value of maintain time illegal. 维护时间窗参数非法。 请检查请求参数是否合法。 400 111400107 The instance exists for unpaid sacle up orders. Please process non payment orders first. 实例已存在未支付的扩容订单,请先处理未支付订单。 请先处理未支付订单。 400 111400108 The Instance exists for processing sacle up order. Please try again later. 实例存在正在处理的扩容订单,请稍后重试。 请稍后重试或联系技术支持。 400 111400111 the instance is restarting. 实例正在重启中,请稍后重试。 请稍后重试或联系技术支持。 400 111400113 the instance is extending. 实例正在扩容中,请稍后重试。 请稍后重试或联系技术支持。 400 111400114 the instance is configuring. 正在修改实例配置,请稍后重试。 请稍后重试或联系技术支持。 400 111400115 the instance is changing the password. 正在修改实例密码,请稍后重试。 请稍后重试或联系技术支持。 400 111400116 the instance is upgrading. 实例正在升级中,请稍后重试。 请稍后重试或联系技术支持。 400 111400117 the instance is rollbacking the version. 实例正在回滚中,请稍后重试。 请稍后重试或联系技术支持。 400 111400118 the instance is creating. 实例正在创建中,请稍后重试。 请稍后重试或联系技术支持。 400 111400119 Query Bill Sample failed 实例不存在。 请检查请求参数是否合法。 400 111400120 the instance is Freezing. 实例正在冻结中,请稍后重试。 请稍后重试或联系技术支持。 400 111400800 Invalid {0} in the request. 请求参数{0}非法。 请检查请求参数是否合法。 400 111400843 The no_password_access parameter is missing or its value is invalid. 缺少参数no_password_access或取值不合法。 请检查请求参数是否合法。 400 111400844 The access_user parameter is missing or its value is invalid. 缺少参数access_user或取值不合法。 请检查请求参数是否合法。 400 111400845 The password parameter is missing or its value is invalid. 缺少参数password或取值不合法。 请检查请求参数是否合法。 400 111400849 The request parameter new_password should not exist. 请求参数new_password不应存在。 请检查请求参数是否合法。 400 111400850 This operation is not supported when Password-Free Access is enabled for the instance. 实例当前的免密访问设置不支持该操作。 请使用重置密码。 400 111400857 DCS instances cannot be deleted if they are billed on a yearly/monthly basis. 包年/包月实例不支持删除。 请使用退订功能删除包年/包月实例 400 DCS. 4855 Master standby swap is not supported. 不支持主备切换。 不支持此操作。 400 DCS.4002 Invalid project ID format. Project ID的格式无效。 请检查请求参数是否合法。 400 DCS.4004 Empty request body. 请求消息体为空 请检查请求参数是否合法。 400 DCS.4005 The message body contains invalid characters or is not in JSON format. 请求消息体不是JSON格式或字段非法 。 请检查请求参数是否合法。 400 DCS.4006 The selected cache engine type is not supported. 不支持的缓存引擎 请检查请求参数是否合法。 400 DCS.4007 Instance type is not supported. 不支持的缓存类型。 请检查请求参数是否合法。 400 DCS.4008 The selected cache engine version is not supported. 不支持的缓存版本。 请检查请求参数是否合法。 400 DCS.4009 Invalid product ID in the request. 请求参数product_id非法。 请检查请求参数是否合法。 400 DCS.4010 Invalid DCS instance name. The name must be 4 to 64 characters in length. Only letters (case-insensitive), digits, underscores (_) ,and hyphens (-) are allowed. 实例名称不合法,只能包含字母、数字、下划线或者中划线,长度为4-64。 请检查请求参数是否合法。 400 DCS.4011 DCS instance description cannot exceed 1024 characters. 实例描述长度必须为0-1024。 请检查请求参数是否合法。 400 DCS.4012 Invalid capacity parameter in the request. 请求参数capacity非法。 请检查请求参数是否合法。 400 DCS.4013 Invalid vpc_id in the request. 请求参数vpc_id为空。 请检查请求参数是否合法。 400 DCS.4014 Invalid security_group_id in the request. 请求参数security_group_id为空。 请检查请求参数是否合法。 400 DCS.4016 Invalid subnet_id in the request. 请求参数subnet_id为空。 请检查请求参数是否合法。 400 DCS.4017 This DCS instance job task is still running. 实例任务还在运行中。 请稍后重试。 400 DCS.4018 This subnet must exist in the VPC. 子网必须在VPC中存在。 请检查请求参数是否合法。 400 DCS.4019 The password does not meet complexity requirements. 密码复杂度不符合要求。 请检查请求参数是否合法。 400 DCS.4020 DHCP must be enabled for this subnet. 子网的DHCP必须开启。 请检查DHCP是否开启。 400 DCS.4021 The isAutoRenew parameter in the request must be either 0 or 1. 请求参数isAutoRenew非法,只能为0或者1。 请检查请求参数是否合法。 400 DCS.4022 Engine does not match the product id. 缓存引擎与产品ID不匹配。 请检查请求参数是否合法。 400 DCS.4025 结束时间不能早于开始时间。 结束时间不能早于开始时间。 请检查请求参数是否合法。 400 DCS.4026 This operation is not allowed when the DCS instance is in the current state. 实例的当前状态不支持此操作。 请稍后重试或联系技术支持。 400 DCS.4027 This operation is not supported on this node. 当前节点不支持该操作。 请稍后重试或联系技术支持。 400 DCS.4028 诊断时间范围应在10分钟内。 诊断时间范围应在10分钟内。 请检查请求参数是否合法。 400 DCS.4030 开始时间不能早于7天前。 开始时间不能早于7天前。 请检查请求参数是否合法。 400 DCS.4031 开始时间不能晚于服务器当前时间。 开始时间不能晚于服务器当前时间。 请检查请求参数是否合法。 400 DCS.4033 开始时间不能早于实例启动时间。 开始时间不能早于实例启动时间。 请检查请求参数是否合法。 400 DCS.4035 DCS instance quota of the tenant is insufficient. 租户实例配额不足。 请联系技术支持。 400 DCS.4036 Memory quota of the tenant is insufficient. 租户内存配额不足。 请联系技术支持。 400 DCS.4037 The instanceParams parameter in the request contains invalid characters or is not in JSON format. 请求参数instanceParams非法,不是JSON格式或字段非法。 请检查请求参数是否合法。 400 DCS.4038 The periodNum parameter in the request must be an integer. 请求参数periodNum非法,必须为整数。 请检查请求参数是否合法。 400 DCS.4039 The quota limit has been reached. 请求调整配额超出限制范围。 请检查请求参数是否合法。 400 DCS.4042 This AZ does not exist. 可用区不存在。 请检查请求参数是否合法。 400 DCS.4045 This DCS instance is already unfrozen. 实例没有被冻结,不能进行解除冻结操作。 请稍后重试或联系技术支持。 400 DCS.4046 This security group does not exist. 安全组不存在。 请检查请求参数是否合法。 400 DCS.4047 The periodType parameter in the request must be either 2 or 3. 请求参数periodType非法,必须为2或者3。 请检查请求参数是否合法。 400 DCS.4048 The security group must have both outbound and inbound rules with protocols set to ANY. 安全组规则不符合要求,请确保安全组规则中同时包含协议为“ANY”的出方向和入方向规则。 请检查请求参数是否合法。 400 DCS.4049 The instance status is not running. 实例状态不是运行中。 请联系技术支持。 400 DCS.4053 the upgrade instance version equals to current version. 请求参数targetVersion非法,不能与当前版本相同。 请检查请求参数是否合法。 400 DCS.4054 the selected available zone quota not enough. 当前选择的可用区DCS服务已售罄。 请前往其他可用区购买或联系技术支持。 400 DCS.4060 This DCS instance name already exists. 实例名称已经存在。 请检查请求参数是否合法。 400 DCS.4061 Invalid instance ID format. 实例ID格式非法 请检查请求参数是否合法。 400 DCS.4062 Invalid {0} parameter in the request. 查询参数{0}非法。 请检查请求参数是否合法。 400 DCS.4063 Invalid {0} parameter in the request. 请求参数{0}非法。 请检查请求参数是否合法。 400 DCS.4064 The action parameter in the request must be start, stop, or restart. 请求参数action非法,只能为start、stop或restart。 请检查请求参数是否合法。 400 DCS.4065 The instances parameter in the request cannot be a null value or left unspecified. 请求参数instances为空。 请检查请求参数是否合法。 400 DCS.4066 Invalid value of the configure parameter {0}. 配置参数{0}非法。 请检查请求参数是否合法。 400 DCS.4067 The available_zones parameter in the request must an array that contains only one AZ ID. 请求参数available_zones非法,必须为只包含一个可用区ID的数组。 请检查请求参数是否合法。 400 DCS.4068 This VPC does not exist. VPC不存在。 请检查请求参数是否合法。 400 DCS.4070 Invalid task ID format. 任务ID的格式无效。 请检查请求参数是否合法。 400 DCS.4072 Invalid saveDays instance backup policy parameter in the request. 请求的实例备份策略参数saveDays非法,范围在1-7天。 请检查请求参数是否合法。 400 DCS.4073 Invalid backupType instance backup policy parameter in the request. 请求的实例备份策略参数backupType非法,只支持auto、manual。 请检查请求参数是否合法。 400 DCS.4074 Invalid periodType instance backup policy parameter in the request. 请求的实例备份策略参数periodType非法,只支持weekly。 请检查请求参数是否合法。 400 DCS.4075 Invalid backupAt instance backup policy parameter in the request. 请求的实例备份策略参数backupAt非法,不能为空。 请检查请求参数是否合法。 400 DCS.4076 Invalid beginAt instance backup policy parameter in the request. 请求的实例备份策略参数beginAt非法,只能是00:00-00:00格式。 请检查请求参数是否合法。 400 DCS.4080 Instance password verify failed. 实例密码校验错误。 请检查请求参数是否合法。 400 DCS.4086 only master standby instance is support this action 只有主备类型的实例才支持这个操作。 不支持此操作。 400 DCS.4087 the backup record status is err when restore this instance 恢复实例时,备份记录的状态错误,succeed状态的才能进行恢复。 请稍后重试或联系技术支持。 400 DCS.4094 the system is not support dcs job. 系统不支持后台任务功能。 不支持此操作。 400 DCS.4095 the system is not support backup and restore. 系统不支持备份恢复功能。 不支持此操作。 400 DCS.4096 the instance is backuping. 实例正在备份中,请稍后重试。 请稍后重试或联系技术支持。 400 DCS.4097 the instance is restoring. 实例正在恢复中,请稍后重试。 请稍后重试或联系技术支持。 400 DCS.4098 The value of the remark parameter must be 0 to 128 characters in length. 请求的实例备份策略参数remark非法,长度0-128。 请检查请求参数是否合法。 400 DCS.4099 DCS instances in the Creating, Starting, Stopping, or Restarting state cannot be deleted. 实例状态为创建中、重启中、删除中时不允许执行删除操作。 请稍后重试。 400 DCS.4100 The number of instance IDs in an instances array cannot exceed 50. instances数组最多只能包含50个实例ID。 请检查请求参数是否合法。 400 DCS.4102 The system is not support resize. 系统不支持扩容。 不支持此操作。 400 DCS.4103 The system is not support resize. 扩容容量必须比原容量大。 请检查请求参数是否合法。 400 DCS.4104 The DCS instance is recovering from an internal fault. Please try again later or contact customer service. 实例内部异常正在恢复,请稍后重试或联系客服。 请稍后重试或联系技术支持。 400 DCS.4105 The value of reserved-memory cannot be greater than the free memory size of this DCS instance. 配置参数reserved-memory的值不能大于实例的空闲内存。 请检查请求参数是否合法。 400 DCS.4106 The value of maintain time illegal. 维护时间窗参数非法。 请检查请求参数是否合法。 400 DCS.4107 The instance exists for unpaid sacle up orders. Please process non payment orders first. 实例已存在未支付的扩容订单,请先处理未支付订单。 请先处理未支付订单。 400 DCS.4108 The Instance exists for processing sacle up order. Please try again later. 实例存在正在处理的扩容订单,请稍后重试。 请稍后重试或联系技术支持。 400 DCS.4111 the instance is restarting. 实例正在重启中,请稍后重试。 请稍后重试或联系技术支持。 400 DCS.4113 the instance is extending. 实例正在扩容中,请稍后重试。 请稍后重试或联系技术支持。 400 DCS.4114 the instance is configuring. 正在修改实例配置,请稍后重试。 请稍后重试或联系技术支持。 400 DCS.4115 the instance is changing the password. 正在修改实例密码,请稍后重试。 请稍后重试或联系技术支持。 400 DCS.4116 the instance is upgrading. 实例正在升级中,请稍后重试。 请稍后重试或联系技术支持。 400 DCS.4117 the instance is rollbacking the version. 实例正在回滚中,请稍后重试。 请稍后重试或联系技术支持。 400 DCS.4118 the instance is creating. 实例正在创建中,请稍后重试。 请稍后重试或联系技术支持。 400 DCS.4119 Query Bill Sample failed 实例不存在。 请检查请求参数是否合法。 400 DCS.4120 the instance is Freezing. 实例正在冻结中,请稍后重试。 请稍后重试或联系技术支持。 400 DCS.4253 All replicas have a priority of 0. 实例从节点主备切换优先级都为0,禁止主备切换 请检查请求参数是否合法。 400 DCS.4300 Client IP transparent transmission is being processed, please do not submit it repeatedly. 客户端ip正在处理,请勿重复提交。 客户端ip透传正在开启或关闭中。 400 DCS.4800 Invalid {0} in the request. 请求参数{0}非法。 请检查请求参数是否合法。 400 DCS.4819 The first_scan_at parameter is invalid. Its must be ISO format utc date-time. The time must be later than the current time. 参数first_scan_at取值不合法,不符合ISO格式的UTC时间,first_scan_at必须晚于当前时间。 请检查请求参数是否合法。 ISO UTC格式示例"2021-08-18T07:33:00.000Z" 400 DCS.4820 The interval parameter is invalid. must Greater than or equal to 0. 参数interval 取值不合法。必须大于等于0秒。 请检查请求参数是否合法。 400 DCS.4821 The timeout parameter is invalid. Its must Greater than or equal to interval * 2, if interval is 0, timeout must Greater than 1 second. 参数timeout 取值不合法,必须大于0,且至少是扫描间隔时间的两倍。 请检查请求参数是否合法。 400 DCS.4822 The scan_keys_count parameter is invalid. Its must Greater than or equal to 10, and Less than or equal to 1000. 参数scan_keys_count取值不合法,取值范围在10~1000 请检查参数请求是否合法。 400 DCS.4838 Do not support feature client ip transparent transmission. 不支持客户端ip透传特性。 客户端ip透传特性开关未开。 400 DCS.4839 Do not support feature public dns. 不支持公网域名解析特性。 公网域名解析特性开关未开。 400 DCS.4840 Do not support feature dns. 不支持域名解析特性。 域名解析特性开关未开。 400 DCS.4841 Instance do not support client ip transparent transmission. 实例不支持客户端ip透传。 实例版本较低不支持客户端ip透传。 400 DCS.4843 The no_password_access parameter is missing or its value is invalid. 缺少参数no_password_access或取值不合法。 请检查请求参数是否合法。 400 DCS.4844 The access_user parameter is missing or its value is invalid. 缺少参数access_user或取值不合法。 请检查请求参数是否合法。 400 DCS.4845 The password parameter is missing or its value is invalid. 缺少参数password或取值不合法。 请检查请求参数是否合法。 400 DCS.4846 Client ip transparent transmission is already closed,please do not repeat the operation. 客户端ip透传已关闭,请勿重复操作。 客户端ip透传当前已关闭 400 DCS.4847 Client ip transparent transmission is already opened,please do not repeat the operation. 客户端ip透传已开启,请勿重复操作 客户端ip透传当前已开启。 400 DCS.4848 Client Management is not supported. 不支持会话管理功能。 不支持此操作。 400 DCS.4849 The request parameter new_password should not exist. 请求参数new_password不应存在。 请检查请求参数是否合法。 400 DCS.4850 This operation is not supported when Password-Free Access is enabled for the instance. 实例当前的免密访问设置不支持该操作。 请检查请求参数是否合法。 400 DCS.4857 DCS instances cannot be deleted if they are billed on a yearly/monthly basis. 包年/包月实例不支持删除。 请检查请求参数是否合法。 400 DCS.4875 Create replication number exceed max number limit. 创建副本数超过最大数量限制 请检查请求参数是否合法。 400 DCS.4879 r/w instance have only one repl can not remove ip from dns 读写分离实例只有一个副本不支持摘除副本ip 请检查请求参数是否合法。 400 DCS.4911 The network ip insufficient. 子网ip数量不足。 请检查子网ip数量是否充足,建议释放不再使用的ip或者更换ip数量充足的子网 400 DCS.4918 Instance bigkey analyze is running. 实例大key分析正在执行。 请稍后重试。 400 DCS.4919 Does not support bigkey analyze. 不支持大key分析。 不支持此操作。 400 DCS.4930 The request param node_list is invalid 请求参数node_list非法 请检查请求参数是否合法。 400 DCS.4931 Node is not replica, can't delete. 节点非只读副本,无法删除. 请检查请求参数是否合法。 400 DCS.4935 Only one slave replication has dns ip, can not delete 只有一个备节点有dns ip,不允许删除该副本 请检查请求参数是否合法。 400 DCS.4936 The master node cannot be deleted 主节点不允许被删除 请检查请求参数是否合法。 400 DCS.4937 Only has one slave node,can not delete 唯一的备节点不允许被删除 请检查请求参数是否合法。 400 DCS.4939 The param slave_priority_weight is invalid. 请求参数slave_priority_weight 非法 请检查请求参数是否合法。 400 DCS.4941 The hotkey id does not exist. 热key分析ID不存在。 请检查请求参数是否合法 400 DCS.4942 The bigkey id does not exist. 大key分析ID不存在。 请检查请求参数是否合法。 400 DCS.4957 This operation is not allowed when the task is in the current state. 缓存分析任务的当前状态不支持此操作。 只有成功状态的缓存分析任务支持此操作。 400 DCS.4998 Domain names are up to date. 域名已是最新。 域名已最新,不需要重建 400 DCS.4999 Do not support feature update domain name. 不支持域名优化特性。 域名优化特性开关未开 401 111401001 Invalid token. Token无效。 请检查请求参数是否合法。 401 111401002 Token expired. Token过期。 请检查请求参数是否合法。 401 111401003 No token in the request. Token缺失。 请检查请求参数是否合法。 401 111401004 Project ID does not match the token. Project-ID和Token不匹配。 请检查请求参数是否合法。 401 DCS.1001 Invalid token. Token无效。 请检查请求参数是否合法。 401 DCS.1002 Token expired. Token过期。 请检查请求参数是否合法。 401 DCS.1003 No token in the request. Token缺失。 请检查请求参数是否合法。 401 DCS.1004 Project ID does not match the token. Project-ID和Token不匹配。 请检查请求参数是否合法。 403 111403002 This tenant has read permission only and cannot perform this operation. 租户只有只读权限,无法操作DCS。 请检查请求参数是否合法。 403 111403003 This role does not have the permission to perform this operation. 角色没有操作权限,无法执行此操作。 请检查请求参数是否合法。 403 DCS.2003 This role does not have the permission to perform this operation. 角色没有操作权限,无法执行此操作。 请检查请求参数是否合法。 403 DCS.2007 Policy does not allow {} to be performed. 操作权限不足。 请检查账户是否有对应的操作权限。 403 DCS.3002 This tenant has read permission only and cannot perform this operation. 租户只有只读权限,无法操作DCS。 请检查请求参数是否合法。 403 DCS.3003 This role does not have the permission to perform this operation. 角色没有操作权限,无法执行此操作。 请检查请求参数是否合法。 404 111404001 The requested URL does not exist. 请求的URL不存在。 请检查请求参数是否合法。 404 111404022 This DCS instance does not exist. 实例不存在。 请检查请求参数是否合法。 404 111404023 This DCS order does not exist. 订单不存在。 请检查请求参数是否合法。 404 DCS.3022 This DCS instance does not exist. 实例不存在。 请检查请求参数是否合法。 404 DCS.4001 The requested URL does not exist. 请求的URL不存在。 请检查请求参数是否合法。 404 DCS.4023 This DCS order does not exist. 订单不存在。 请检查请求参数是否合法。 404 DCS.5101 Create agency failed. 创建委托授权失败。 请稍后重试或联系技术支持。 405 111405001 This request method is not allowed. 请求中指定的方法不被允许。 请检查请求参数是否合法。 405 DCS.5001 This request method is not allowed. 请求中指定的方法不被允许。 请检查请求参数是否合法。 500 111400069 Another user is modifying configuration parameters of the DCS instance. Please try again later. 其他用户正在修改实例的配置参数,请稍后再试。 请稍后重试。 500 111400101 Delete instance backup file failed. 删除实例备份文件失败。 请联系技术支持 500 111400842 job execution status failed. Job任务执行失败。 请联系技术支持 500 111500000 Internal service error. 内部服务错误。 请联系技术支持 500 111500006 Internal service error. 内部服务错误。 请联系技术支持 500 111500017 Internal service error. 内部服务错误。 请联系技术支持 500 111500020 vm add port fail 虚拟机添加端口异常。 请联系技术支持 500 111500024 Internal service error. 内部服务错误。 请联系技术支持 500 111500031 create instance fail 创建DCS实例失败。 请联系技术支持 500 111500032 Internal service error. 内部服务错误。 请联系技术支持 500 111500037 query order info fail 查询订单详情失败。 请稍后重试或联系技术支持。 500 111500041 No resource tenant available. 无可用资源租户。 请稍后重试或联系技术支持。 500 111500044 update resource status fail 更新云服务实例资源状态失败。 请稍后重试或联系技术支持。 500 111500053 Internal service error. 内部服务错误。 请联系技术支持 500 111500054 Internal service error. 内部服务错误。 请联系技术支持 500 111500070 Internal service error. 内部服务错误。 请联系技术支持 500 111500071 Internal service error. 内部服务错误。 请联系技术支持 500 111500077 Internal service error. 内部服务错误。 请联系技术支持 500 111500078 Internal service error. 内部服务错误。 请联系技术支持 500 111500079 Internal service error. 内部服务错误。 请联系技术支持 500 111500082 Internal service error. 内部服务错误。 请联系技术支持 500 111500083 Internal service error. 内部服务错误。 请联系技术支持 500 111500085 Internal service error. 内部服务错误。 请联系技术支持 500 111500090 Internal service error. 内部服务错误。 请联系技术支持 500 111500091 Internal service error. 内部服务错误。 请联系技术支持 500 111500092 Internal service error. 内部服务错误。 请联系技术支持 500 111500095 Internal service error. 内部服务错误。 请联系技术支持 500 111500104 Internal service error. 内部服务错误。 请联系技术支持 500 DCS. 5094 Master standby swap failed. 主备切换失败。 请联系技术支持 500 DCS.4069 Another user is modifying configuration parameters of the DCS instance. Please try again later. 其他用户正在修改实例的配置参数,请稍后再试。 请稍后重试。 500 DCS.4101 Delete instance backup file failed. 删除实例备份文件失败。 请联系技术支持 500 DCS.4842 job execution status failed. Job任务执行失败。 请联系技术支持 500 DCS.5000 Internal service error. 内部服务错误。 请联系技术支持 500 DCS.5006 Submit job failed. 提交任务失败 请联系技术支持 500 DCS.5017 Failed to save instance information. 保存实例信息失败 请联系技术支持 500 DCS.5020 vm add port fail 虚拟机添加端口异常。 请联系技术支持 500 DCS.5024 Query instance failed. 查询实例失败。 请联系技术支持 500 DCS.5031 create instance fail 创建DCS实例失败。 请联系技术支持 500 DCS.5032 Failed to create order. 创建订单号失败 请联系技术支持 500 DCS.5037 query order info fail 查询订单详情失败。 请联系技术支持 500 DCS.5039 Obtain IAM service failed. 获取IAM服务失败。 请联系技术支持。 500 DCS.5040 Call IAM API for querying agency failed. 调用IAM查询委托接口失败。 请联系技术支持 500 DCS.5041 No resource tenant available. 无可用资源租户。 请联系技术支持 500 DCS.5042 Call IAM API for creating agency failed. 调用IAM创建委托接口失败。 请联系技术支持 500 DCS.5043 Call IAM API for querying permission failed. 调用IAM查询权限接口失败。 请联系技术支持 500 DCS.5044 update resource status fail 更新云服务实例资源状态失败。 请联系技术支持 500 DCS.5045 Call IAM API for adding project-level agency permissions failed. 调用IAM增加项目级别的委托权限失败。 请联系技术支持 500 DCS.5053 Instance node not found. 未找到实例节点 请联系技术支持 500 DCS.5054 Failed to generate password. 生成密码失败。 请联系技术支持 500 DCS.5070 Internal service error. 内部服务错误。 请联系技术支持 500 DCS.5071 Failed to create instance backup strategy. 创建实例备份策略失败。 请联系技术支持 500 DCS.5077 Query instance failed. 查询实例备份策略失败。 请联系技术支持 500 DCS.5078 Query backup record failed. 查询备份记录失败。 请联系技术支持 500 DCS.5079 Query restore record failed. 查询恢复记录失败。 请联系技术支持 500 DCS.5081 The resource tenant does not exist. 资源租户不存在。 请联系技术支持 500 DCS.5082 Failed to register resource tenant backup user. 注册资源租户备份用户失败。 请联系技术支持 500 DCS.5083 Failed to save backup user. 保存备份用户失败。 请联系技术支持 500 DCS.5085 Failed to update backup strategy. 更新备份策略失败。 请联系技术支持 500 DCS.5090 Failed to save backup information. 保存备份信息失败。 请联系技术支持 500 DCS.5091 Script execution failed. 执行脚本失败。 请联系技术支持 500 DCS.5092 Failed to save and restore data. 保存恢复数据失败。 请联系技术支持 500 DCS.5095 The script execution failed and needs to be retried. 执行脚本失败,需要重试。 请联系技术支持 500 DCS.5104 Failed to modify order. 修改订单失败。 请联系技术支持 父主题: 附录
  • 概述 欢迎使用 语音交互 服务(Speech Interaction Service ,简称SIS)。 语音交互服务(Speech Interaction Service,简称SIS)是一种人机交互方式,用户通过实时访问和调用API获取语音交互结果。支持用户通过 语音识别 功能,将口述音频、普通话或者带有一定方言的语音文件识别成可编辑的文本,同时也支持通过 语音合成 功能将文本转换成逼真的语音等提升用户体验。适用场景如语音客服质检、会议记录、语音短消息、有声读物、电话回访等。 语音交互( 实时语音识别 一句话识别 、录音文件识别、语音合成)服务所提供的API为自研API。 表1 实时语音识别接口说明 接口类型 说明 实时语音识别接口 华为云提供的Websocket接口,主要用于实时语音识别。音频分片传输,服务器端可以返回中间临时转写结果,在最后返回最终转写结果。 表2 一句话识别接口说明 接口类型 说明 一句话识别 一句话识别接口,用于短语音的同步识别。一次性上传整个音频,响应中即返回识别结果。 表3 录音文件识别接口说明 接口类型 说明 录音文件识别 录音文件识别接口,用于转写不超过5小时的音频。由于录音文件转写需要较长的时间,因此转写是异步的。 表4 语音合成接口说明 接口类型 说明 语音合成/实时语音合成 语音合成,依托先进的语音技术,使用深度学习算法,将文本转换为自然流畅的语音。用户通过实时访问和调用API获取语音合成结果,将用户输入的文字合成为音频。通过音色选择、自定义音量、语速、音高等,可自定义音频格式,为企业和个人提供个性化的发音服务。 父主题: 使用前必读
  • wss-URI wss-URI格式 wss /v1/{project_id}/rtts 参数说明 表1 参数说明 名称 是否必选 说明 project_id 是 项目编号。获取方法,请参见获取项目ID。 请求示例(伪码) wss://{endpoint}/v1/{project_id}/rttsRequest Header:X-Auth-Token: MIINRwYJKoZIhvcNAQcCoIINODCCDTQCAQExDTALBglghkgBZQMEAgEwgguVBgkqhkiG... Python3语言请求代码示例 # -*- coding: utf-8 -*-# 此demo仅供测试使用,强烈建议使用sdk。需提前安装websocket-client, 执行pip install websocket-clientimport websocketimport threadingimport timeimport jsondef rtts_demo(): url = 'wss://{{endpoint}}/v1/{{project_id}}/rtts' # endpoint和project_id需替换 text = '待合成文本' token = '用户对应region的token' header = { 'X-Auth-Token': token } body = { 'command': 'START', 'text': text, 'config': { 'audio_format': 'pcm', 'property': 'chinese_xiaoyu_common', 'sample_rate': '8000' } } def _on_message(ws, message): if isinstance(message, bytes): print('receive data length %d' % len(message)) else: print(message) def _on_error(ws, error): print(error) ws = websocket.WebSocketApp(url, header, on_message=_on_message, on_error=_on_error) _thread = threading.Thread(target=ws.run_forever, args=(None, None, 30, 20)) _thread.start() time.sleep(1) ws.send(json.dumps(body), opcode=websocket.ABNF.OPCODE_TEXT) time.sleep(10) ws.close()if __name__ == '__main__': rtts_demo() Java语言请求代码示例 import okhttp3.OkHttpClient;import okhttp3.Request;import okhttp3.Response;import okhttp3.WebSocket;import okhttp3.WebSocketListener;import okio.ByteString;/** * 此demo仅供测试使用, 强烈建议使用sdk * 使用前需已配置okhttp、okio jar包。jar包可通过下载SDK获取。 */public class RttsDemo { public void rttsDemo() { try { // endpoint和projectId需要替换成实际信息。 String url = "wss://{{endpoint}}/v1/{{project_id}}/rtts"; String token = "对应region的token"; String text = "待合成文本"; OkHttpClient okHttpClient = new OkHttpClient(); Request request = new Request.Builder().url(url).header("X-Auth-Token", token).build(); WebSocket webSocket = okHttpClient.newWebSocket(request, new MyListener()); webSocket.send("{\"command\": \"START\", \"text\":\"" + text + "\", \"config\": {\"audio_format\": \"pcm\", \"property\": \"chinese_xiaoyu_common\"}}"); Thread.sleep(10000); webSocket.close(1000, null); } catch (Exception e) { e.printStackTrace(); } } class MyListener extends WebSocketListener { @Override public void onOpen(WebSocket webSocket, Response response) { System.out.println("conneected"); } @Override public void onClosed(WebSocket webSocket, int code, String reason) { System.out.println("closed"); } @Override public void onFailure(WebSocket webSocket, Throwable t, Response response) { t.printStackTrace(); } @Override public void onMessage(WebSocket webSocket, String text) { System.out.println(text); } public void onMessage(WebSocket webSocket, ByteString bytes) { byte[] data = bytes.toByteArray(); System.out.println("receive data length is " + data.length); } } public static void main(String[] args) { RttsDemo rttsDemo = new RttsDemo(); rttsDemo.rttsDemo(); }}
  • 示例音频 测试音频如表 示例音频所示,音频文件标题表示采样率和位宽。如8k16bit.pcm表示音频采样率为8k,位宽为16bit。 表1 示例音频 音频格式 下载链接 mp3 https://sis-sample-audio.obs.cn-north-1.myhuaweicloud.com/16k16bit.mp3 wav https://sis-sample-audio.obs.cn-north-1.myhuaweicloud.com/16k16bit.wav pcm https://sis-sample-audio.obs.cn-north-1.myhuaweicloud.com/16k16bit.pcm pcm https://sis-sample-audio.obs.cn-north-1.myhuaweicloud.com/8k16bit.pcm 父主题: 附录
  • API概览 SIS服务提供了两种接口,包含REST(Representational State Transfer)API,支持您通过HTTPS请求调用,请参见表1。也包含WebSocket接口,支持Websocket协议,请参见表2。 表1 REST API功能 接口 功能 API URI 一句话识别接口 一句话识别 POST /v1/{project_id}/asr/short-audio 录音文件识别接 录音文件识别接口 识别接口:POST /v1/{project_id}/asr/transcriber/jobs 状态查询:GET /v1/{project_id}/asr/transcriber/jobs/{job_id} 语音合成接口 语音合成接口 POST /v1/{project_id}/tts 表2 WebSocket API功能 接口 功能 API URI 实时语音识别接口(请求) 开始识别 支持三种模式的请求消息: 流式一句话 WSS /v1/{project_id}/rasr/short-stream 实时语音识别连续模式 WSS /v1/{project_id}/rasr/continue-stream 实时语音识别单句模式 WSS /v1/{project_id}/rasr/sentence-stream 发送音频数据 结束识别
  • 请求示例 “endpoint”即调用API的请求地址,不同服务不同区域的“endpoint”不同,具体请参见终端节点。 查询热词表信息 GET https://{endpoint}/v1/{project_id}/asr/vocabularies/{vocabulary_id}Request Header:Content-Type: application/jsonX-Auth-Token: MIINRwYJKoZIhvcNAQcCoIINODCCDTQCAQExDTALBglghkgBZQMEAgEwgguVBgkqhkiG...
  • 响应参数 状态码: 200 表3 响应Body参数 参数 是否必选 参数类型 描述 vocabulary_id 是 String 调用成功返回热词表ID,调用失败时无此字段。 name 是 String 调用成功返回热词表名,调用失败时无此字段。 language 是 String 调用成功返回热词表语言类型,调用失败时无此字段。 description 是 String 调用成功返回热词表描述,调用失败时无此字段。 contents 是 Array of strings 调用成功返回热词列表,调用失败时无此字段。 状态码: 400 表4 响应Body参数 参数 参数类型 描述 error_code String 调用失败时的错误码。 调用成功时无此字段。 error_msg String 调用失败时的错误信息。 调用成功时无此字段。
  • 响应示例 状态码: 200 成功响应示例 { "vocabulary_id": "CFD08A32-6176-4ad7-92F9-11ED015C8109", "name": "telepower", "description": "telepower 具体描述", "language": "chinese_mandarin", "contents": ["示例"]} 状态码:400 失败响应示例 { "error_code":"SIS.0201", "error_msg":"***" }
  • 请求示例 “endpoint”即调用API的请求地址,不同服务不同区域的“endpoint”不同,具体请参见终端节点。 删除热词表 DELETE https://{endpoint}/v1/{project_id}/asr/vocabularies/{vocabulary_id}Request Header:Content-Type: application/jsonX-Auth-Token: MIINRwYJKoZIhvcNAQcCoIINODCCDTQCAQExDTALBglghkgBZQMEAgEwgguVBgkqhkiG...
  • 响应消息体 响应消息体通常以结构化格式返回,与响应消息头中Content-type对应,传递除响应消息头之外的内容。 对于一句话识别接口,返回如下消息体。格式请具体参考一句话识别响应消息部分。 { "trace_id": "567e8537-a89c-13c3-a882-826321939651", "result":{ "text": "欢迎使用语音云服务。", "score": 0.9 }} 当接口调用出错时,会返回错误码及错误信息说明,错误响应的Body体格式如下所示。 { "error_msg": "***", "error_code": "SIS.0001"} 其中,error_code表示错误码,error_msg表示错误描述信息。
  • 修订记录 发布日期 修改说明 2023-01 新增: 语音合成支持SSML标记语言。 2022-11 新增: 语音合成上线朝气男生、知性女生、利落纯英文等音色。 2022-10 新增: 录音文件识别支持四川话识别。 2022-07 新增: 获取录音文件识别结果API支持返回提交音频的时长。 2022-06 新增: 实时语音合成支持温柔女声、朝气男声精品发音人。 2022-05 新增: 语音合成新增朝气男声发音人。 2022-02 新增: 录音文件识别约束,增加音频转写时长参考,输入参数兼容公网访问的url。 2022-01 ios sdk更新至1.1.0版本。 2021-08 新增: websocket接口 2021-10 新增: 录音文件极速识别 2021-04 录音文件识别转写请求property取值范围新增“chinese_8k_insurance”,"chinese_8k_bank" 实时语音识别请求property取值范围新增“chinese_16k_court”,"chinese_16k_it" 提交录音文件识别任务 开始识别 2021-03 一句话识别、实时语音识别请求property取值范围新增“shanghai_16k_common”,"english_16k_common" 6.1-一句话识别 实时语音识别请求 2021-03 一句话识别、实时语音识别请求property取值范围新增“sichuan_16k_common”,"cantonese_16k_common" 一句话识别 实时语音识别请求 2020-08 新增语音合成精品发音库: 语音合成 新增一句话识别property取值范围“chinese_16k_general”: 一句话识别 2020-07 新增“digit_norm”字段,涉及以下章节: 一句话识别 提交录音文件识别任务 开始识别 2019-08 新增 语音合成 2019-07 新增: 一句话识别 提交录音文件识别任务 2019-03 第一次正式发布。
  • 状态码 表1 状态码 状态码 说明 100 Continue 101 Switching Protocols 200 OK 201 Created 202 Accepted 203 Non-Authoritative Information 204 NO Content 205 Reset Content 206 Partial Content 300 Multiple Choices 301 Moved Permanently 302 Found 303 See Other 304 Not Modified 305 Use Proxy 306 Unused 400 Bad Request 401 Unauthorized 402 Payment Required 403 Forbidden 404 Not Found 405 Method Not Allowed 406 Not Acceptable 407 Proxy Authentication Required 408 Request Timeout 409 Conflict 410 Gone 411 Length Required 412 Precondition Failed 413 Request Entity Too Large 414 Request URI Too Long 415 Unsupported Media Type 416 Requested Range Not Satisfiable 417 Expectation Failed 422 Unprocessable Entity 429 Too Many Requests 500 Internal Server Error 501 Not Implemented 502 Bad Gateway 503 Service Unavailable 504 Gateway Timeout 505 HTTP Version Not Supported 父主题: 附录
  • 功能介绍 流式一句话模式的语音长度限制为一分钟,适合于对话聊天等识别场景。 该接口支持用户将一整段语音分段,以流式输入,最后得到识别结果。实时语音识别引擎在获得分段的输入语音的同时,就可以同步地对这段数据进行特征提取和解码工作,而不用等到所有数据都获得后再开始工作。因此这样就可以在最后一段语音结束后,仅延迟很短的时间(也即等待处理最后一段语音数据以及获取最终结果的时间)即可返回最终识别结果。这种流式输入方式能缩短整体上获得最终结果的时间,极大地提升用户体验。
  • 接口说明 实时语音识别接口基于Websocket协议实现。分别提供了“流式一句话”、“实时语音识别连续模式”、“实时语音识别单句模式”三种模式。 三种模式的握手请求wss-URI不同,基于Websocket承载的实时语音识别请求和响应的消息格式相同。 开发者可以使用java、python、c++等开发语言支持Websocket的对应软件包或库接口,与实时语音识别引擎握手连接,并发送语音数据和接收转写结果,最后关闭Websocket连接。 获取Websocket握手请求wss-URI请参见Websocket握手请求。 获取实时语音识别请求消息格式信息请参见实时语音识别请求。 获取实时语音识别响应消息格式请参见实时语音识别响应。 客户端通过Websocket协议访问实时流转写接口时,连接时长不能超过5小时。超过5小时的Websocket连接,服务端会自动断链。 父主题: 实时语音识别接口
  • 响应消息 表1 响应参数 参数名 参数类型 说明 resp_type String 响应类型。参数值为RESULT,表示识别结果响应。 trace_id String 服务内部的令牌,可用于在日志中追溯具体流程。 segments Array of objects 多句结果。 请参考表 segment 数据结构。 表2 segment 数据结构 参数名 参数类型 说明 start_time Integer 相对时间戳,表示一句的起始,单位为ms。 end_time Integer 相对时间戳,表示一句的结束,单位为ms。 is_final Boolen 输出是否为最终结果。 true表示是最终结果, false表示为中间临时结果。 result Object 调用成功表示识别结果,调用失败时无此字段。 请参考表 result数据结构。 表3 result数据结构 参数名 参数类型 说明 text String 识别结果。 score Float 识别结果的置信度,取值范围:0~1。此值仅会在最终结果时被赋值,在中间结果时统一置为“0.0”。 说明: 目前置信度作用不是太大,请勿过多依赖此值。 word_info Array of Object 分词输出列表。 表4 word_info 数据结构 参数名 是否必选 参数类型 说明 start_time 否 Integer 起始时间 end_time 否 Integer 结束时间 word 否 String 分词
  • 示例 { "resp_type": "RESULT", "trace_id": "567e8537-a89c-13c3-a882-826321939651", "segments": [ { "start_time": 100, "end_time": 1500, "is_final": false, "result": { "text": "第一句中间结果", "word_info": [ { "start_time": 100, "end_time": 800, "word": "第一" }, { "start_time": 800, "end_time": 1000, "word": "句" }, { "start_time": 1000, "end_time": 1500, "word": "结果" } ],"score": 0.0 }, }, ]}
  • 公共请求参数 公共请求参数如表 公共请求参数所示。 表1 公共请求参数 参数 是否必选 说明 示例 Content-type 是 发送的实体的MIME类型。 application/json Content-Length POST/PUT请求必填。 GET不能包含。 请求body长度,单位为Byte。 3495 Upgrade 发送WebSocket握手请求时,包含该头域。 upgrade是HTTP1.1中用于定义转换协议的header域。 Websocket Connection 发送WebSocket握手请求时,包含该头域。 带有Upgrade头的HTTP1.1消息须含有Connection。 Upgrade Sec-WebSocket-Key 发送WebSocket握手请求时,包含该头域。 采用Base64编码的随机16字节长的字符序列。用来发送给服务器使用,服务器会使用此字段组装成另一个key值放在握手返回信息里发送客户端。 x3JJHMbDL1EzLkh9GBhXDw== Sec-WebSocket-Version 发送WebSocket握手请求时,包含该头域。 标识了客户端支持WebSocket协议的版本。 13 X-Auth-Token 是 用户Token。 MIINRwYJKoZIhvcNAQcCoIINODCCDTQCAQExDTALBglghkgBZQMEAgEwgguVBgkqhkiG... X-Language 请求语言类型。 否,默认为zh-cn。 en-us 其它header属性,请遵照https协议。 调用业务接口时,在请求消息头中需增加Content-Type的消息体。 父主题: 附录
  • 公共响应参数 公共响应参数如表 公共响应参数所示。 表1 公共响应参数 参数名 说明 Content-Length 响应消息体的字节长度,单位为Byte。 Date 系统响应的时间。 Content-type 发送的实体的MIME类型。 Upgrade 发送WebSocket握手请求时,相应消息包含该头域,内容为Websocket。 Connection 发送WebSocket握手请求时,相应消息包含该头域,内容为Upgrade。 Sec-WebSocket-Accept 结合Sec-WebSocket-Key提供基本的防护,比如恶意的连接,或者无意的连接。 父主题: 附录
  • 响应消息 表1 响应参数 参数名 参数类型 说明 resp_type String 响应类型。参数值为END,表示结束识别响应。 trace_id String 服务内部的令牌,可用于在日志中追溯具体流程。 reason String 结束原因,详情请参见表 结束原因表。 表2 结束原因表 参数名 说明 NORMAL 正常结束。 CANCEL 用户取消,也即客户端发送“结束识别”指令时cancel参数为true。 ERROR 识别过程中发生错误。
  • 响应示例 状态码:200 成功响应示例 { "result": [ { "vocabulary_id": "5F85A74C-BED9-4a15-B66E-039251D877D6", "language": "chinese_mandarin", "name": "weather", "description": "no desc" }, { "vocabulary_id": "50875954-7328-42ab-B236-B3EC6E22207A", "language": "chinese_mandarin", "name": "war", "description": "no desc" } ]} 状态码:400 失败响应示例 { "error_code":"SIS.0201", "error_msg":"***" }
共100000条