Device Templates - Create

Publicar um novo modelo de dispositivo. As exibições padrão serão geradas automaticamente para novos modelos de dispositivo criados dessa maneira.

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

Parâmetros de URI

Name In Required Type Description
baseDomain
path True
  • string

O domínio base para todas as solicitações do serviço de IoT Central do Azure.

deviceTemplateId
path True
  • string

ID exclusiva do modelo de dispositivo.

subdomain
path True
  • string

O subdomínio do aplicativo.

api-version
query True
  • string

A versão da API que está sendo chamada.

Corpo da solicitação

Name Required Type Description
capabilityModel True
  • object

O modelo de funcionalidade utilizado por este modelo de dispositivo.

types True
  • string[]

Os tipos de dispositivo aos quais este modelo se aplica.

description
  • string

Descrição detalhada do modelo de dispositivo.

displayName
  • string

Nome de exibição do modelo de dispositivo.

etag
  • string

ETag usado para evitar conflitos em atualizações de modelo de dispositivo.

solutionModel
  • object

O modelo de solução utilizado por este modelo de dispositivo.

Respostas

Name Type Description
200 OK

Êxito

Exemplos

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"
    ]
  }
}

Definições

DeviceTemplate

Name Type Description
capabilityModel
  • object

O modelo de funcionalidade utilizado por este modelo de dispositivo.

description
  • string

Descrição detalhada do modelo de dispositivo.

displayName
  • string

Nome de exibição do modelo de dispositivo.

etag
  • string

ETag usado para evitar conflitos em atualizações de modelo de dispositivo.

id
  • string

ID exclusiva do modelo de dispositivo.

solutionModel
  • object

O modelo de solução utilizado por este modelo de dispositivo.

types
  • string[]

Os tipos de dispositivo aos quais este modelo se aplica.