Подключиться
Yandex IoT Core

Method getByName

Статья создана

HTTP request

GET https://iot-devices.api.cloud.yandex.net/iot-devices/v1/devices:getByName

Query parameters

Parameter Description
registryId

Required. ID of the registry to get device.

To get a registry ID make a list request.

The maximum string length in characters is 50.
deviceName

Required. Name of the device to return.

To get a device name make a list request.

The maximum string length in characters is 50. Value must match the regular expression [a-zA-Z0-9_-]*.
deviceView

Specifies which parts of the device resource should be returned in the response.

  • BASIC: Server responses without monitoring data. The default value.
  • FULL: Server responses with monitoring data.

Response

HTTP Code: 200 - OK

{
  "id": "string",
  "registryId": "string",
  "createdAt": "string",
  "name": "string",
  "description": "string",
  "topicAliases": "object",
  "status": "string",
  "monitoringData": {
    "lastAuthIp": "string",
    "lastAuthTime": "string",
    "lastPubActivityTime": "string",
    "lastSubActivityTime": "string",
    "lastOnlineTime": "string"
  }
}

A device. For more information, see Device.

Field Description
id string

ID of the device.
registryId string

ID of the registry that the device belongs to.
createdAt string (date-time)

Creation timestamp.

String in RFC3339 text format.
name string

Name of the device. The name is unique within the registry.
description string

Description of the device. 0-256 characters long.
topicAliases object

Alias of a device topic.

Alias is an alternate name of a device topic assigned by the user. Map alias to canonical topic name prefix, e.g. my/custom/alias match to $device/abcdef/events.
status string

Status of the device.

  • CREATING: Device is being created.
  • ACTIVE: Device is ready to use.
  • DELETING: Device is being deleted.
monitoringData object

Device monitoring data, returns if FULL view specified.
monitoringData.
lastAuthIp		 string
monitoringData.
lastAuthTime		 string (date-time)

String in RFC3339 text format.
monitoringData.
lastPubActivityTime		 string (date-time)

String in RFC3339 text format.
monitoringData.
lastSubActivityTime		 string (date-time)

String in RFC3339 text format.
monitoringData.
lastOnlineTime		 string (date-time)

String in RFC3339 text format.
В этой статье: