华为云用户手册

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获取语音合成结果，将用户输入的文字合成为音频。通过音色选择、自定义音量、语速、音高等，可自定义音频格式，为企业和个人提供个性化的发音服务。 父主题： 使用前必读

示例音频 测试音频如表 示例音频所示，音频文件标题表示采样率和位宽。如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连接，服务端会自动断链。 父主题： 实时语音识别接口

示例 { "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 响应参数 参数名 参数类型 说明 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 分词

公共响应参数 公共响应参数如表 公共响应参数所示。 表1 公共响应参数 参数名 说明 Content-Length 响应消息体的字节长度，单位为Byte。 Date 系统响应的时间。 Content-type 发送的实体的MIME类型。 Upgrade 发送WebSocket握手请求时，相应消息包含该头域，内容为Websocket。 Connection 发送WebSocket握手请求时，相应消息包含该头域，内容为Upgrade。 Sec-WebSocket-Accept 结合Sec-WebSocket-Key提供基本的防护，比如恶意的连接，或者无意的连接。 父主题： 附录

公共请求参数 公共请求参数如表 公共请求参数所示。 表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 响应参数 参数名 参数类型 说明 resp_type String 响应类型。参数值为END，表示结束识别响应。 trace_id String 服务内部的令牌，可用于在日志中追溯具体流程。 reason String 结束原因，详情请参见表 结束原因表。 表2 结束原因表 参数名 说明 NORMAL 正常结束。 CANCEL 用户取消，也即客户端发送“结束识别”指令时cancel参数为true。 ERROR 识别过程中发生错误。

请求示例 “endpoint”即调用API的请求地址，不同服务不同区域的“endpoint”不同，具体请参见终端节点。 获取热词表列表信息 GET https://{endpoint}/v1/{project_id}/asr/vocabulariesRequest Header:Content-Type: application/jsonX-Auth-Token: MIINRwYJKoZIhvcNAQcCoIINODCCDTQCAQExDTALBglghkgBZQMEAgEwgguVBgkqhkiG...

响应示例 状态码：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":"***" }

响应参数 状态码： 200 表5 响应Body参数 参数 是否必选 参数类型 描述 count 是 Integer 热词表数。 result 是 Array of VocabInfo objects 调用成功返回热词表列表，调用失败时无此字段。 表6 VocabInfo 参数 是否必选 参数类型 描述 vocabulary_id 是 String 热词ID。 name 是 String 热词表名。 language 是 String 热词表语言类型。 description 是 String 热词表描述。 状态码： 400 表7 响应Body参数 参数 参数类型 描述 error_code String 调用失败时的错误码。 调用成功时无此字段。 error_msg String 调用失败时的错误信息。 调用成功时无此字段。

URI GET /v1/{project_id}/asr/vocabularies 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目编号。获取方法，请参见获取项目ID。 表2 Query参数 参数 是否必选 参数类型 描述 limit 否 Integer 每页查询显示的条目数量。 缺省值：10 offset 否 Integer 页码偏移量，表示从此页码偏移量开始查询，offset大于等于0。 缺省值：0

调用说明 SIS服务提供了两种接口，包含REST（Representational State Transfer）API，支持您通过HTTPS请求调用，调用方法请参见如何调用REST API。也包含WebSocket接口，支持Websocket协议，调用方法请参见如何调用WebSocket API。 调用所需示例音频参见示例音频。 调用接口的时候，无需开通服务，可直接调用。此时请按照实际需要选择计费方式，计费是按照调用接口的次数或者时长来计算费用，具体计费价格参见语音交互价格计算器。 支持两种计费方式： 按需计费，默认计费方式为“按需计费”。 折扣套餐包方式，是用户可以购买套餐包，扣费时调用次数会先在套餐包内进行抵扣，抵扣完后的剩余调用量默认转回按需计费方式。 父主题： 使用前必读

响应消息 表1 响应参数 参数名 参数类型 说明 resp_type String 响应类型。参数值为EVENT，表示开始识别响应。 trace_id String 服务内部的令牌，可用于在日志中追溯具体流程。 event String 具体的事件，详细参数可参见event取值范围及其说明。 timestamp Integer 保留字段。将来会用于此事件发生的具体时间，以会话开始作为0点，单位为ms。

event取值范围及其说明 表2 event取值范围 事件 说明 VOICE_START 检测到句子开始。 VOICE_END 检测到句子结束。 EXCEEDED_SILENCE 静音超长，也即没有检测到声音。 在流式一句话模式下： 不会返回VOICE_START、VOICE_END、EXCEEDED_SILCENCE事件。 在实时语音识别单句模式下： 返回VOICE_START事件，表示检测到语音，此时IVR可以做打断。 返回VOICE_END事件后，表示一句话结束，后续的音频将被忽略，不会再进行识别。 只会返回最多一组VOICE_START和VOICE_END事件。 如果返回EXCEEDED_SILENCE事件，表示超过vad_head没有检测到声音，通常表示用户一直没有说话。此时后续的音频将被忽略，不会再进行识别。 在实时语音识别连续模式下： 不会返回VOICE_START、VOICE_END、EXCEED_SLIENCE事件。

发送音频数据 在收到“开始识别”的响应之后，可以开始发送音频数据。为节省流量，音频以二进制数据帧形式（binary message）的方式发送。 音频数据将分片发送，也即在获得一定量音频数据的同时就可以发送一个binary message，每个分片建议在50ms~1000ms之间，建议在需要实时反馈的情况下100ms，不需要实时反馈的情况下500ms。实时语音识别代码示例请参考SDK文档。 父主题： 实时语音识别请求

概述 LwM2M（Lightweight M2M，轻量级M2M），由开发移动联盟（OMA）提出，是一种轻量级的、标准通用的物联网设备管理协议，可用于快速部署客户端/服务器模式的物联网业务。LwM2M为物联网设备的管理和应用建立了一套标准，它提供了轻便小巧的安全通信接口及高效的数据模型，以实现M2M设备管理和服务支持。物联网平台支持加密与非加密两种接入设备接入方式，其中加密业务数据交互端口为5684端口，采用DTLS+CoAP协议通道接入，非加密端口为5683，接入协议为CoAP。物联网平台从安全角度考虑，强烈建议采用安全接入方式。 LwM2M的语法和接口细节，请以此标准规范为准。 物联网平台支持协议规定的plain text, opaque, Core Link ,TLV , JSON编码格式。在多字段操作时（比如写多个资源），默认用TLV格式。

使用说明 图1 设备消息上报操作流程 创建产品与设备：创建产品流程、创建设备流程。 设备鉴权：平台验证设备是否具有接入权限。 设备消息上报：设备通过MQTT/HTTP等协议发送消息数据。 按照不同的设备协议，调用的接口不一样，下面分别介绍MQTT、HTTPS协议消息上报的样例： MQTT：通过消息上报接口MQTT协议消息上报、使用MQTT.fx调测上报数据到物联网平台。MQTT消息上报样例如下： Topic：$oc/devices/{device_id}/sys/messages/up 数据格式样例： { "content": {"hello":"123"} } HTTPS：通过消息上报接口HTTP协议消息上报上报数据到物联网平台，其中access_token获取参考：HTTPS设备鉴权。HTTPS消息上报样例如下： POST https://{endpoint}/v5/devices/{device_id}/sys/messages/up Content-Type: application/jsonaccess_token: d144a524-1997-4b99-94bf-f27128da8a34{ "name": "name", "id": "id", "content": "messageUp"} 协议详情请参考：MQTT协议消息上报、HTTP协议消息上报。 数据转发：可以通过数据流转功能转发到应用侧或华为云其他云服务上进行存储和处理。

使用说明 图1 属性下发流程图 应用调用修改设备属性接口，下发请求到物联网平台，属性下发消息样例如下： PUT https://{endpoint}/v5/iot/{project_id}/devices/{device_id}/properties { "services" : [ { "service_id" : "Temperature", "properties" : { "value" : 57 } }, { "service_id" : "Battery", "properties" : { "level" : 80 } } ] } 物联网平台根据协议规范下发属性给设备。通过MQTT协议中平台设置设备属性接口下发属性为样例： Topic: $oc/devices/{device_id}/sys/properties/set/request_id={request_id} 数据格式： { "object_device_id": "{object_device_id} ", "services": [ { "service_id": "Temperature", "properties": { "value": 57, "value2": 60 } }, { "service_id": "Battery", "properties": { "level": 80, "level2": 90 } } ]} 设备执行属性下发命令后返回命令执行结果，消息样例如下： Topic：$oc/devices/{device_id}/sys/properties/set/response/request_id={request_id} 数据格式：{ "result_code": 0, "result_desc": "success"} 应用侧收到发送HTTP下发命令的同步响应结果。消息样例如下： Status Code: 200 OKContent-Type: application/json{ "response" : { "result_code" : 0, "result_desc" : "success" } }

下发消息状态 MQTT设备消息执行状态以及状态变化机制如下所示。 图4 设备消息状态 表1 消息执行状态 消息执行状态 说明 等待（PENDING） MQTT协议设备不在线，物联网平台会将消息进行缓存，此时任务状态为“等待”状态。 超时（TIMEOUT） 物联网平台缓存的PENDING状态的消息，如果1天之内还没有下发下去，物联网平台会将消息状态设置为“超时”。 已送达（DELIVERED） 物联网平台将消息发送给设备后，状态变为“已送达”。 失败（FAILED） 物联网平台发送消息给设备不成功，消息状态变为“失败”。