Configuring a Device Model

Before You Begin

This tutorial shows you how to create a device model in Oracle Internet of Things (IoT) Cloud Service and associate the device model with the Oracle IoT Asset Monitoring Cloud Service application. This tutorial takes approximately 10 minutes to complete.

Background

In Oracle IoT Cloud Service, you can create a device model by using one of the following methods:

• The cURL tool
• An instance of Oracle IoT Cloud Service
• In a browser, a Representational State Transfer (REST) client plug-in

In this tutorial, you create a device model with the cURL tool.

What Do You Need?

• A desktop or laptop computer running Microsoft Windows 8, Apple macOS 10.9 or later, or Linux with a web browser and Java Development Kit (JDK) 1.8 or later
• Access to an instance of Oracle IoT Cloud Service
• Downloaded and installed cURL tool
• The transport_container.json file

Create a Device Model

1. Open a command-line interface and create the device model. Replace the iot_user_name, iot_password, transport_container_file_path, and myinstance-myidentitydomain with your corresponding values.

   curl -X POST 
   -H 'Content-Type: application/json'
   -u iot_user_name:iot_password
   -d @transport_container_file_path
   https://myinstance-myidentitydomain.iot.us.oraclecloud.com/iot/api/v2/deviceModels

2. In a web browser, enter the URL for your instance of Oracle IoT Cloud Service, enter your user name and password, and click Sign In.
3. On the Oracle IoT Cloud Service home page, click Action , select Devices and then Model, and verify that your device model is listed in the table.

   

Associate a Device Model with an Application

1. Click Action and then Applications. From the Applications menu, select Browse Applications.
2. On the Applications page, click Oracle IoT Asset Monitoring Cloud Service.

   

3. Click Action and select Device Model.
4. Click Choose Device Model.

   

5. In the Device Models dialog box, select the Transport Container device model and click Done.

Want to Learn More?

• Creating a New Device Model and Associate a Device Model with an Application in Using Oracle Internet of Things Cloud Service
• Registering Device Models in the Oracle IoT Cloud Service in Connecting, Monitoring, and Controlling Devices Using the JavaScript Client Software Library