物接入IoT Hub

    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
    上一篇
    Endpoint
    下一篇
    Principal