Create a cloud gateway device (GB/T 32960)

Prerequisites

You have added a cloud gateway and created a cloud gateway product that uses one-party authentication. For more information, see Create a cloud gateway product (GB/T 32960).

Limitations

You cannot create single devices for some products. Instead, you must add them in batches by importing device authentication information.

• All products that belong to an MQTT-based Enterprise Edition instance. For instructions, see Add devices in batches.

• Products that are associated with a cloud gateway in a Premium Enterprise Edition instance. For instructions, see Add devices in batches (MQTT), Add devices in batches (GB/T 32960), Add devices in batches (JT/T 808), and Create cloud gateway devices (SL 651).

Background information

• If you create a cloud gateway that uses Third-party authentication, IoT Platform automatically creates and authenticates a device when the device establishes a connection for the first time. IoT Platform uses the value of the vin request parameter from the FC authentication function as the device name.

• If you create a cloud gateway that uses one-party authentication, you must import device authentication information into IoT Platform to create a cloud gateway device. For more information, see the procedure below.

Batch add devices

1. Log on to the IoT Platform console.

2. On the Instance Overview page, click the target Enterprise instance of the Exclusive Edition.

3. In the left-side navigation pane, choose Device Management > Products. Find the gateway product that you created and click Manage Devices in the Actions column.

4. On the Devices page, click Batch Add.

5. In the Batch Add Devices dialog box, click Download .csv Template to download the template file.

6. In the template, enter the VIN and save the file.

   Important

   The VIN can contain letters and digits. It must be 4 to 17 characters in length.

7. Return to the Batch Add Devices dialog box. Click Upload File to upload the file. Then, click OK.

   

   If the batch of devices that you upload contains invalid information, an error message is displayed. Click Download Invalid List to view the invalid information. Correct the information and upload the file again.

   

Results

After you import the device identities, IoT Platform uses each uploaded VIN to create a device with that name. The new devices appear in the device list.

What to do next

After you create the cloud gateway device, update the access domain name for the device:

• If a device has a configured endpoint, create a CNAME record that maps its hostname to the cloud gateway URL. For more information, see Alibaba Cloud DNS.

• If a device has no configured endpoint, set the cloud gateway URL as its endpoint.

To obtain the cloud gateway URL, see View a cloud gateway.

For more information about how cloud gateway devices communicate after they connect to IoT Platform, see Message communication.