A product indicates a set of devices that have the same features. After you create a product, you must create devices for the product and obtain the device certificates. You can create one or more devices at a time. This article describes how to create a device.
Procedure
- Log on to the IoT Platform console.
- On the Overview page, select an environment, find the instance that you want to manage, and click the instance ID or instance name. Important This step is required only if Enterprise Edition instances are available. If the Enterprise Edition instances are unavailable in the region that you selected, skip this step. For information about supported regions and instances, see Overview.
- In the left-side navigation pane, choose .
- On the Devices page, click Add Device.
- In the Add Device dialog box, set the parameters as required and click OK.
Parameter Description Products Select a product. The device to be created derives the features and properties of the specified product. Important If a product is associated with other platforms, make sure that your account has a sufficient quota of activated devices.DeviceName The DeviceName of the device. The DeviceName must be unique within the product. Each DeviceName must be 4 to 32 characters in length and can contain letters, digits, hyphens (-), underscores (_), at signs (@), periods (.),and colons (:). Note You can leave the DeviceName parameter unspecified. If you do not specify this parameter, IoT Platform generates a globally unique identifier (GUID) as the DeviceName.Alias The alias of the device. The name must be 4 to 64 characters in length, and can contain letters, digits, and underscores (_).
Results
After the device is created, the The devices have been added. dialog box appears. In this dialog box, you can view and copy the device certificate information. A device certificate consists of a ProductKey, a DeviceName, and a DeviceSecret. A device certificate is the credential that a device uses to communicate with IoT Platform. We recommend that you keep your device certificates confidential.
| Parameter | Description |
|---|---|
| ProductKey | The ProductKey of the product to which the device belongs. The ProductKey is the GUID that is issued by IoT Platform to the product. |
| DeviceName | The DeviceName of the device, which is the unique identifier of the device within the product. A combination of the DeviceName and ProductKey is used as the device identifier. IoT Platform authenticates the device and communicates with the device based on the device identifier. |
| DeviceSecret | The DeviceSecret of the device, which is issued by IoT Platform for device authentication and encryption. The DeviceSecret must be used in combination with the DeviceName. |
What to do next
You can view the device information. For more information, see Manage devices.
For information about how to connect a device to IoT Platform, see the following articles:
Related operations
RegisterDevice: Registers a device under a specified product.