# 设备属性上报
#### 接口说明
用于设备按产品模型中定义的格式将属性数据上报给平台。
#### URI
|   请求方法   |                     POST                      |
|---|---|
| **URI**  | /v5/devices/{device_id}/sys/properties/report |
| **传输协议** | HTTPS                                         |
   
#### 请求参数
| 名称           | 必选 | 类型                                                                                                         | 位置     | 说明                                                                                                                                                                                                                                                                                                                                                                                    |
|:---|:---|:---|:---|:---|
| access_token | 是  | String                                                                                                     | Header | **参数解释：** 调用设备鉴权信息返回的access_token。 **取值范围：** 长度1-256。                                                                                                   |
| device_id    | 是  | String                                                                                                     | Path   | **参数解释：** 设备ID，用于唯一标识一个设备。在注册设备时直接指定，或者由物联网平台分配获得。由物联网平台分配时，生成规则为"product_id" + "_" + "node_id"拼接而成。 **取值范围** **：** 长度不超过128，只允许字母、数字、下划线（_）、连接符（-）的组合。 |
| services     | 是  | List\<[ServiceProperty]\> | Body   | **参数解释：** 设备服务数据列表。                                                                                                                                                                                                                                                                                         |
   
 表1ServiceProperty 
| 名称         | 必选 | 类型     | 说明                                                                                                                                                                                                                                                                                                                   |
|:---|:---|:---|:---|
| service_id | 是  | String | **参数解释：** 设备服务id。                                                                                                                                                                                                                          |
| properties | 是  | Object | **参数解释：** 设备服务的属性列表，具体字段在设备关联的产品模型中定义。                                                                                                                                                                                                     |
| event_time | 否  | String | **参数解释：** 设备采集数据UTC时间（格式：yyyy-MM-dd'T'HH:mm:ss.SSS'Z'，如2021-08-13T10:10:10.555Z）。 设备上报数据不带该参数或参数格式错误时，则数据上报时间以平台时间为准（格式：yyyyMMdd'T'HHmmss'Z'，如20230523T014506Z）。 |
   
#### 请求示例
```
POST https://{endpoint}/v5/devices/{device_id}/sys/properties/report
Content-Type: application/json
access_token: ******
{
  "services" : [ {
    "service_id" : "serviceId",
    "properties" : {
      "Height" : 124,
      "Speed" : 23.24
    },
    "event_time" : "2021-08-13T10:10:10.555Z"
  } ]
}
```
#### 响应示例
Status Code: 200 上报正常
#### 错误码
| HTTP状态码 | HTTP状态码描述   | 错误码          | 错误码描述                                                                       | 错误码中文描述              |
|:---|:---|:---|:---|:---|
| 400     | Bad Request | IOTDA.000006 | Invalid input data.                                                         | 请求参数不合法              |
| 400     | Bad Request | IOTDA.021104 | Subdevices in the request does not exist or does not belong to the gateway. | 请求中有部分子设备不存在或不属于该网关. |
| 403     | Forbidden   | IOTDA.000004 | Invalid access token.                                                       | 非法token              |
| 403     | Forbidden   | IOTDA.021101 | Request reached the maximum rate limit.                                     | 请求已经达到限制速率           |
| 403     | Forbidden   | IOTDA.021102 | The request rate has reached the upper limit of the tenant, limit %s.       | 请求已经达到租户的限制速率        |
| 403     | Forbidden   | IOTDA.021105 | The content reported in a single request cannot exceed 1 MB.                | 单次请求上报的内容不能超过1MB     |