Call the /cloud/thing/info/get operation to retrieve basic information about a thing.-阿里云帮助中心

Call this operation to retrieve basic information about a thing.

Path	/cloud/thing/info/get
Version	1.0.2
Protocol	HTTPS
Request Method	POST
User Authentication Required	No
Timeout	5000

Request parameters

Parameter	Type	Required	Description
iotId	String	No	The unique device ID issued by the IoT Platform. This parameter is required if productKey and deviceName are not specified.
productKey	String	No	The globally unique identifier that the IoT Platform assigns when a product is created. It is one of the device credentials. Required if iotId is not specified.
deviceName	String	No	The device name, one of the device credentials. The name is either custom or system-generated during device registration and must be unique within the product. Required if iotId is not specified.

Response data

Parameter	Type	Description
gmtModified	Long	The time the data was last modified.
activeTime	Long	The time the device was activated.
gmtCreate	Long	The time the device was created.
productKey	String	The globally unique identifier that the IoT Platform assigns when a product is created. It is one of the device credentials.
statusLast	Int	The previous status of the device.
mac	String	The MAC address.
deviceSecret	String	The secret for the device, assigned by the IoT Platform during registration. This secret is part of the device credentials and is used with the device name for authentication and encryption.
iotId	String	The unique device ID issued by the IoT Platform.
name	String	The name of the device.
sdkVersion	String	The version of the SDK.
sn	String	The serial number (SN) of the device.
thingType	String	The type of the thing.
region	String	The region to which the device belongs.
firmwareVersion	String	The version of the firmware.
rbacTenantId	String	The tenant ID.
status	Int	The device status. Valid values: 0 (inactive), 1 (online), 3 (offline), and 8 (disabled).

Examples

Example request

{
	"id": "1509086454180",
	"version": "1.0",
	"request":{
		"apiVer": "1.0.2"
	},
	"params":{
		"iotId": "value0",
		"productKey": "value1",
		"deviceName": "value2"
	}
}

Example successful response

JSON format

{
    "code": 200,
    "data": {
        "gmtModified": 1517918765000,
        "activeTime": null,
        "deviceKey": "Kq7rgxxxxexwJh",
        "gmtCreate": 1500017648000,
        "productKey": "kQxxxxqA",
        "statusLast": null,
        "mac": null,
        "netAddress": null,
        "deviceSecret": "xxxxxxxxxxxxxxxxxxxxx",
        "iotId": "03iGXYVlxxxx9ccwgzHG",
        "name": "Kq7rgvxxxxexwJh",
        "tenantId": 7,
        "nickname": null,
        "sdkVersion": null,
        "sn": null,
        "thingType": "DEVICE",
        "region": "daily",
        "firmwareVersion": "1.0.0",
        "rbacTenantId": "ADSBCUYxxxxxx27917",
        "ownerDomain": "kQxxxxqA",
        "status": 1
    },
    "message": "success",
    "localizedMsg": null
}

Example error response

JSON format

{}