删除产品
接口说明
应用服务器可调用此接口删除已导入物联网平台的指定产品模型。
调试
您可以在API Explorer中直接运行调试该接口。
注意事项
此接口仅删除了产品,未删除关联的插件,在产品下存在设备时,该产品不允许删除。
URI
| 请求方法 | DELETE |
|---|---|
| URI | /v5/iot/{project_id}/products/{product_id} |
| 传输协议 | HTTPS |
请求参数
| 名称 | 必选/可选 | 类型 | 位置 | 说明 |
|---|---|---|---|---|
| X-Auth-Token | 必选 | String | Header | 参数说明:用户Token。通过调用IAM服务 获取IAM用户Token接口获取,接口返回的响应消息头中“X-Subject-Token”就是需要获取的用户Token。简要的获取方法样例请参见 Token认证。 |
| Instance-Id | 可选 | String | Header | 参数说明:实例ID。物理多租下各实例的唯一标识,一般华为云租户无需携带该参数,仅在物理多租场景下从管理面访问API时需要携带该参数。 |
| project_id | 必选 | String | Path | 参数说明:项目ID。获取方法请参见 获取项目ID。 |
| product_id | 必选 | String | Path | 参数说明:产品ID,用于唯一标识一个产品,在物联网平台创建产品后由平台分配获得。 取值范围:长度不超过36,只允许字母、数字、下划线(_)、连接符(-)的组合。 |
| app_id | 可选 | String | Query | 参数说明:资源空间ID。此参数为非必选参数,存在多资源空间的用户需要使用该接口时,必须携带该参数指定要删除的产品属于哪个资源空间,否则接口会提示错误。如果用户存在多资源空间,同时又不想携带该参数,可以联系华为技术支持对用户数据做资源空间合并。 取值范围:长度不超过36,只允许字母、数字、下划线(_)、连接符(-)的组合。 |
请求示例
DELETE https://{Endpoint}/v5/iot/{project_id}/products/{product_id}?app_id={app_id}
Content-Type: application/json
X-Auth-Token: ********
Instance-Id: ********
响应示例
Status Code: 204 No Content
错误码
| HTTP状态码 | 错误码 | 错误码英文描述 | 错误码中文描述 | 处理建议 |
|---|---|---|---|---|
| 403 | IOTDA.000022 | Operation not allowed. The user does not have the permission | 该用户没有权限 | 请排查该用户是否有权限访问。 |
| IOTDA.001006 | Operation not allowed. Application not found by authorized user or the authorized user has no application. | 用户下没有应用或应用与用户不匹配 | 请排查用户下是否有应用或是否有指定的应用。 | |
| IOTDA.001007 | Operation not allowed. The application does not belong to the authorized user. | 应用与用户信息不匹配 | 请排查该用户下是否有指定的应用。 | |
| IOTDA.013007 | Operation not allowed. The product has been used, forbid to delete. | 产品已被使用,禁止删除 | 请删除产品下的资源后再删除该产品。 | |
| 404 | IOTDA.013000 | The product does not exist. | 产品不存在 | 请排查请求参数是否正确或产品是否已经在平台注册。 |
Did this article solve your problem?
Thank you for your score!Your feedback would help us improve the website.