Thing

获取thing列表

相对URI HTTP 方式
/v1/endpoint/{endpointName}/thing GET

请求参数

名称 类型 是否必选 默认值 说明
endpointName String Y - endpoint的名称
order ENUM['desc', 'asc'] N desc 排序的方式,不区分大小写
orderBy String N createTime 另外一个支持排序的字段是name。
pageNo Int N 1 页码
pageSize Int N 50 每页item个数,最大值200
q String N - 模糊查询的内容。目前支持name字段模糊查询

返回参数

名称 类型 含义
username String 用于mqtt认证
thingName String thing的名称
endpointName String 所属的Endpoint
createTime String 创建时间

请求示例

GET /v1/endpoint/endpoint-1/thing HTTP/1.1
host: iot.gz.baidubce.com
authorization: {authorization}
content-type: text/plain;charset=UTF-8

返回示例

HTTP/1.1 200 Created
x-bce-request-id: c6903ab2-bf5e-4afb-8bbf-2e537edd3c49
Content-Type: application/json;charset=UTF-8
{
    "totalCount": 1,
    "result": [
        {
            "username": "endpoint-1/thing-1",
            "thingName": "thing-1",
            "endpointName": "endpoint-1",
            "createTime": "2016-08-31T05:12:39Z"
        }
    ],
    "order": "desc",
    "orderBy": "createtime",
    "pageSize": 50,
    "pageNo": 1
}

获取指定的thing信息

相对URI HTTP 方式
/v1/endpoint/{endpointName}/thing/{thingName} GET

请求参数

名称 类型 是否必选 含义
endpointName String Y endpoint的名称
thingName String Y thing的名称

返回参数

名称 类型 含义
username String 用于mqtt认证
thingName String thing的名称
endpointName String 所属的Endpoint
createTime String 创建时间

请求示例

GET /v1/endpoint/endpoint-1/thing/thing-1 HTTP/1.1
host: iot.gz.baidubce.com
authorization: {authorization}
content-type: text/plain;charset=UTF-8

返回示例

HTTP/1.1 200 Created
x-bce-request-id: 360e61be-36fd-4607-b226-199fd6bc11bd
Content-Type: application/json;charset=UTF-8
{
    "username": "endpoint-1/thing-1",
    "thingName": "thing-1",
    "endpointName": "endpoint-1",
    "createTime": "2016-08-31T05:12:39Z"
}

创建thing

相对URI HTTP 方式
/v1/endpoint/{endpointName}/thing POST

请求参数

名称 类型 是否必选 含义
endpointName String Y endpoint的名称
thingName String Y thing的名称

返回参数

名称 类型 含义
username String 用于mqtt认证
thingName String thing的名称
endpointName String 所属的Endpoint
createTime String 创建时间

请求示例

POST /v1/endpoint/endpoint-1/thing HTTP/1.1
host: iot.gz.baidubce.com
authorization: {authorization}
content-type: text/plain;charset=UTF-8
{
    "thingName":"thing-1"
}

返回示例

HTTP/1.1 201 Created
x-bce-request-id: 22b69f0d-11ad-4547-a1dd-20ac37282f63
Content-Type: application/json;charset=UTF-8
{
    "username": "endpoint-1/thing-1",
    "thingName": "thing-1",
    "endpointName": "endpoint-1",
    "createTime": "2016-08-31T05:12:39Z"
}

删除thing

相对URI HTTP 方式
/v1/endpoint/{endpointName}/thing/{thingName} DELETE

请求参数

名称 类型 是否必选 含义
endpointName String Y endpoint的名称
thingName String Y thing的名称

返回参数

无特殊返回参数。

请求示例

DELETE /v1/endpoint/endpoint-1/thing/thing-1 HTTP/1.1
host: iot.gz.baidubce.com
authorization: {authorization}
content-type: text/plain;charset=UTF-8

返回示例

HTTP/1.1 204 No Content
x-bce-request-id: 367d9dd5-4513-412d-a4f8-eacfe37dbaf3
Content-Type: application/json;charset=UTF-8