Device Templates - Create

Pubblicare un nuovo modello di dispositivo. Le visualizzazioni predefinite verranno generate automaticamente per i nuovi modelli di dispositivo creati in questo modo.

PUT https://{subdomain}.{baseDomain}/api/deviceTemplates/{deviceTemplateId}?api-version=preview

Parametri dell'URI

Name In Required Type Description
baseDomain
path True
  • string

Dominio di base per tutte le Azure IoT Central di servizio.

deviceTemplateId
path True
  • string

ID univoco del modello di dispositivo.

subdomain
path True
  • string

Sottodominio dell'applicazione.

api-version
query True
  • string

Versione dell'API chiamata.

Corpo della richiesta

Name Required Type Description
capabilityModel True
  • object

Modello di funzionalità utilizzato da questo modello di dispositivo.

types True
  • string[]

Tipi di dispositivo a cui si applica questo modello.

description
  • string

Descrizione dettagliata del modello di dispositivo.

displayName
  • string

Nome visualizzato del modello di dispositivo.

etag
  • string

ETag usato per evitare conflitti negli aggiornamenti del modello di dispositivo.

solutionModel
  • object

Modello di soluzione utilizzato da questo modello di dispositivo.

Risposte

Name Type Description
200 OK

Operazione riuscita

Esempio

Create a device template

Sample Request

PUT https://appsubdomain.azureiotcentral.com/api/deviceTemplates/environmentstemplateid?api-version=preview
{
  "types": [
    "DeviceModel"
  ],
  "displayName": "Environment sensor 1",
  "capabilityModel": {
    "@id": "urn:storeAnalyticsCheckoutPnp:capabilityModel:1",
    "@type": [
      "CapabilityModel"
    ],
    "implements": [
      {
        "@id": "urn:storeAnalyticsCheckoutPnp:capabilityModel:fyy5xn_y:1",
        "@type": [
          "InterfaceInstance"
        ],
        "displayName": "Interface",
        "name": "Interface",
        "schema": {
          "@id": "urn:storeAnalyticsCheckoutPnp:Interface:1",
          "@type": [
            "Interface"
          ],
          "displayName": "Interface",
          "contents": [
            {
              "@id": "urn:storeAnalyticsCheckoutPnp:Interface:Temperature:1",
              "@type": [
                "Telemetry",
                "SemanticType/Temperature"
              ],
              "displayName": "Temperature",
              "name": "Temperature",
              "schema": "double",
              "unit": "celsius"
            },
            {
              "@id": "urn:storeAnalyticsCheckoutPnp:Interface:Humidity:1",
              "@type": [
                "Telemetry",
                "SemanticType/Humidity"
              ],
              "displayName": "Humidity",
              "name": "Humidity",
              "schema": "double",
              "unit": "percent"
            },
            {
              "@id": "urn:storeAnalyticsCheckoutPnp:Interface:Occupancy:1",
              "@type": [
                "Telemetry"
              ],
              "displayName": "Occupancy",
              "name": "Occupancy",
              "schema": "double"
            }
          ]
        }
      }
    ],
    "displayName": "Motion detector",
    "contents": [],
    "@context": [
      "http://azureiot.com/v1/contexts/IoTModel.json"
    ]
  }
}

Sample Response

{
  "id": "environmentstemplateid",
  "types": [
    "DeviceModel"
  ],
  "displayName": "Environment sensor 1",
  "capabilityModel": {
    "@id": "urn:storeAnalyticsCheckoutPnp:capabilityModel:1",
    "@type": [
      "CapabilityModel"
    ],
    "implements": [
      {
        "@id": "urn:storeAnalyticsCheckoutPnp:capabilityModel:fyy5xn_y:1",
        "@type": [
          "InterfaceInstance"
        ],
        "displayName": "Interface",
        "name": "Interface",
        "schema": {
          "@id": "urn:storeAnalyticsCheckoutPnp:Interface:1",
          "@type": [
            "Interface"
          ],
          "displayName": "Interface",
          "contents": [
            {
              "@id": "urn:storeAnalyticsCheckoutPnp:Interface:Temperature:1",
              "@type": [
                "Telemetry",
                "SemanticType/Temperature"
              ],
              "displayName": "Temperature",
              "name": "Temperature",
              "schema": "double",
              "unit": "celsius"
            },
            {
              "@id": "urn:storeAnalyticsCheckoutPnp:Interface:Humidity:1",
              "@type": [
                "Telemetry",
                "SemanticType/Humidity"
              ],
              "displayName": "Humidity",
              "name": "Humidity",
              "schema": "double",
              "unit": "percent"
            },
            {
              "@id": "urn:storeAnalyticsCheckoutPnp:Interface:Occupancy:1",
              "@type": [
                "Telemetry"
              ],
              "displayName": "Occupancy",
              "name": "Occupancy",
              "schema": "double"
            }
          ]
        }
      }
    ],
    "displayName": "Motion detector",
    "contents": [],
    "@context": [
      "http://azureiot.com/v1/contexts/IoTModel.json"
    ]
  }
}

Definizioni

DeviceTemplate

Name Type Description
capabilityModel
  • object

Modello di funzionalità utilizzato da questo modello di dispositivo.

description
  • string

Descrizione dettagliata del modello di dispositivo.

displayName
  • string

Nome visualizzato del modello di dispositivo.

etag
  • string

ETag usato per evitare conflitti negli aggiornamenti del modello di dispositivo.

id
  • string

ID univoco del modello di dispositivo.

solutionModel
  • object

Modello di soluzione utilizzato da questo modello di dispositivo.

types
  • string[]

Tipi di dispositivo a cui si applica questo modello.