Partager via


Microsoft.IoTCentral iotApps

Définition de ressource Bicep

Le type de ressource iotApps peut être déployé avec des opérations qui ciblent :

Pour obtenir la liste des propriétés modifiées dans chaque version de l’API, consultez journal des modifications.

Format de ressource

Pour créer une ressource Microsoft.IoTCentral/iotApps, ajoutez le bicep suivant à votre modèle.

resource symbolicname 'Microsoft.IoTCentral/iotApps@2021-11-01-preview' = {
  scope: resourceSymbolicName or scope
  identity: {
    type: 'string'
  }
  location: 'string'
  name: 'string'
  properties: {
    displayName: 'string'
    networkRuleSets: {
      applyToDevices: bool
      applyToIoTCentral: bool
      defaultAction: 'string'
      ipRules: [
        {
          filterName: 'string'
          ipMask: 'string'
        }
      ]
    }
    publicNetworkAccess: 'string'
    subdomain: 'string'
    template: 'string'
  }
  sku: {
    name: 'string'
  }
  tags: {
    {customized property}: 'string'
  }
}

Valeurs de propriété

Microsoft.IoTCentral/iotApps

Nom Descriptif Valeur
identité Identités managées pour l’application IoT Central. SystemAssignedServiceIdentity
emplacement Emplacement géographique où réside la ressource chaîne (obligatoire)
nom Nom de la ressource chaîne (obligatoire)
Propriétés Propriétés courantes d’une application IoT Central. AppProperties
portée Utilisez-la lors de la création d’une ressource dans une étendue différente de l’étendue de déploiement. Définissez cette propriété sur le nom symbolique d’une ressource pour appliquer la ressource d’extension .
Sku Référence SKU d’instance valide. appSkuInfo (obligatoire)
étiquettes Balises de ressource Dictionnaire de noms et de valeurs d’étiquettes. Consultez les balises dans les modèles

AppProperties

Nom Descriptif Valeur
nom d’affichage Nom complet de l’application. corde
networkRuleSets Propriétés de l’ensemble de règles réseau de cette application IoT Central. NetworkRuleSets
publicNetworkAccess Indique si les demandes du réseau public sont autorisées. 'Désactivé'
'Activé'
sous-domaine Sous-domaine de l’application. corde
modèle ID du modèle d’application, qui est un blueprint qui définit les caractéristiques et les comportements d’une application. Optionnel; s’il n’est pas spécifié, la valeur par défaut est un blueprint vide et permet à l’application d’être définie à partir de zéro. corde

AppSkuInfo

Nom Descriptif Valeur
nom Nom de la référence SKU. 'ST0'
'ST1'
'ST2' (obligatoire)

NetworkRuleSetIpRule

Nom Descriptif Valeur
filterName Nom lisible de la règle IP. corde
Masque d’ipMask Bloc CIDR définissant la plage d’adresses IP. corde

NetworkRuleSets

Nom Descriptif Valeur
applyToDevices Indique si ces règles s’appliquent à la connectivité des appareils au service IoT Hub et Device Provisioning associé à cette application. Bool
applyToIoTCentral Indique si ces règles s’appliquent à la connectivité via le portail web et les API IoT Central. Bool
defaultAction Action réseau par défaut à appliquer. 'Autoriser'
'Refuser'
ipRules Liste des règles IP. NetworkRuleSetIpRule[]

SystemAssignedServiceIdentity

Nom Descriptif Valeur
type Type d’identité de service managé (soit le système affecté, soit aucun). « Aucun »
'SystemAssigned' (obligatoire)

TrackedResourceTags

Nom Descriptif Valeur

Définition de ressource de modèle ARM

Le type de ressource iotApps peut être déployé avec des opérations qui ciblent :

Pour obtenir la liste des propriétés modifiées dans chaque version de l’API, consultez journal des modifications.

Format de ressource

Pour créer une ressource Microsoft.IoTCentral/iotApps, ajoutez le code JSON suivant à votre modèle.

{
  "type": "Microsoft.IoTCentral/iotApps",
  "apiVersion": "2021-11-01-preview",
  "name": "string",
  "identity": {
    "type": "string"
  },
  "location": "string",
  "properties": {
    "displayName": "string",
    "networkRuleSets": {
      "applyToDevices": "bool",
      "applyToIoTCentral": "bool",
      "defaultAction": "string",
      "ipRules": [
        {
          "filterName": "string",
          "ipMask": "string"
        }
      ]
    },
    "publicNetworkAccess": "string",
    "subdomain": "string",
    "template": "string"
  },
  "sku": {
    "name": "string"
  },
  "tags": {
    "{customized property}": "string"
  }
}

Valeurs de propriété

Microsoft.IoTCentral/iotApps

Nom Descriptif Valeur
apiVersion Version de l’API '2021-11-01-Preview'
identité Identités managées pour l’application IoT Central. SystemAssignedServiceIdentity
emplacement Emplacement géographique où réside la ressource chaîne (obligatoire)
nom Nom de la ressource chaîne (obligatoire)
Propriétés Propriétés courantes d’une application IoT Central. AppProperties
Sku Référence SKU d’instance valide. appSkuInfo (obligatoire)
étiquettes Balises de ressource Dictionnaire de noms et de valeurs d’étiquettes. Consultez les balises dans les modèles
type Type de ressource 'Microsoft.IoTCentral/iotApps'

AppProperties

Nom Descriptif Valeur
nom d’affichage Nom complet de l’application. corde
networkRuleSets Propriétés de l’ensemble de règles réseau de cette application IoT Central. NetworkRuleSets
publicNetworkAccess Indique si les demandes du réseau public sont autorisées. 'Désactivé'
'Activé'
sous-domaine Sous-domaine de l’application. corde
modèle ID du modèle d’application, qui est un blueprint qui définit les caractéristiques et les comportements d’une application. Optionnel; s’il n’est pas spécifié, la valeur par défaut est un blueprint vide et permet à l’application d’être définie à partir de zéro. corde

AppSkuInfo

Nom Descriptif Valeur
nom Nom de la référence SKU. 'ST0'
'ST1'
'ST2' (obligatoire)

NetworkRuleSetIpRule

Nom Descriptif Valeur
filterName Nom lisible de la règle IP. corde
Masque d’ipMask Bloc CIDR définissant la plage d’adresses IP. corde

NetworkRuleSets

Nom Descriptif Valeur
applyToDevices Indique si ces règles s’appliquent à la connectivité des appareils au service IoT Hub et Device Provisioning associé à cette application. Bool
applyToIoTCentral Indique si ces règles s’appliquent à la connectivité via le portail web et les API IoT Central. Bool
defaultAction Action réseau par défaut à appliquer. 'Autoriser'
'Refuser'
ipRules Liste des règles IP. NetworkRuleSetIpRule[]

SystemAssignedServiceIdentity

Nom Descriptif Valeur
type Type d’identité de service managé (soit le système affecté, soit aucun). « Aucun »
'SystemAssigned' (obligatoire)

TrackedResourceTags

Nom Descriptif Valeur

Exemples d’utilisation

Définition de ressource Terraform (fournisseur AzAPI)

Le type de ressource iotApps peut être déployé avec des opérations qui ciblent :

Pour obtenir la liste des propriétés modifiées dans chaque version de l’API, consultez journal des modifications.

Format de ressource

Pour créer une ressource Microsoft.IoTCentral/iotApps, ajoutez le terraform suivant à votre modèle.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.IoTCentral/iotApps@2021-11-01-preview"
  name = "string"
  parent_id = "string"
  identity {
    type = "string"
    identity_ids = [
      "string"
    ]
  }
  location = "string"
  tags = {
    {customized property} = "string"
  }
  body = {
    properties = {
      displayName = "string"
      networkRuleSets = {
        applyToDevices = bool
        applyToIoTCentral = bool
        defaultAction = "string"
        ipRules = [
          {
            filterName = "string"
            ipMask = "string"
          }
        ]
      }
      publicNetworkAccess = "string"
      subdomain = "string"
      template = "string"
    }
    sku = {
      name = "string"
    }
  }
}

Valeurs de propriété

Microsoft.IoTCentral/iotApps

Nom Descriptif Valeur
identité Identités managées pour l’application IoT Central. SystemAssignedServiceIdentity
emplacement Emplacement géographique où réside la ressource chaîne (obligatoire)
nom Nom de la ressource chaîne (obligatoire)
parent_id ID de la ressource à laquelle appliquer cette ressource d’extension. chaîne (obligatoire)
Propriétés Propriétés courantes d’une application IoT Central. AppProperties
Sku Référence SKU d’instance valide. appSkuInfo (obligatoire)
étiquettes Balises de ressource Dictionnaire de noms et de valeurs d’étiquettes.
type Type de ressource « Microsoft.IoTCentral/iotApps@2021-11-01-preview »

AppProperties

Nom Descriptif Valeur
nom d’affichage Nom complet de l’application. corde
networkRuleSets Propriétés de l’ensemble de règles réseau de cette application IoT Central. NetworkRuleSets
publicNetworkAccess Indique si les demandes du réseau public sont autorisées. 'Désactivé'
'Activé'
sous-domaine Sous-domaine de l’application. corde
modèle ID du modèle d’application, qui est un blueprint qui définit les caractéristiques et les comportements d’une application. Optionnel; s’il n’est pas spécifié, la valeur par défaut est un blueprint vide et permet à l’application d’être définie à partir de zéro. corde

AppSkuInfo

Nom Descriptif Valeur
nom Nom de la référence SKU. 'ST0'
'ST1'
'ST2' (obligatoire)

NetworkRuleSetIpRule

Nom Descriptif Valeur
filterName Nom lisible de la règle IP. corde
Masque d’ipMask Bloc CIDR définissant la plage d’adresses IP. corde

NetworkRuleSets

Nom Descriptif Valeur
applyToDevices Indique si ces règles s’appliquent à la connectivité des appareils au service IoT Hub et Device Provisioning associé à cette application. Bool
applyToIoTCentral Indique si ces règles s’appliquent à la connectivité via le portail web et les API IoT Central. Bool
defaultAction Action réseau par défaut à appliquer. 'Autoriser'
'Refuser'
ipRules Liste des règles IP. NetworkRuleSetIpRule[]

SystemAssignedServiceIdentity

Nom Descriptif Valeur
type Type d’identité de service managé (soit le système affecté, soit aucun). « Aucun »
'SystemAssigned' (obligatoire)

TrackedResourceTags

Nom Descriptif Valeur

Exemples d’utilisation

Échantillons Terraform

Un exemple de base de déploiement de l’application IotCentral.

terraform {
  required_providers {
    azapi = {
      source = "Azure/azapi"
    }
  }
}

provider "azapi" {
  skip_provider_registration = false
}

variable "resource_name" {
  type    = string
  default = "acctest0001"
}

variable "location" {
  type    = string
  default = "westeurope"
}

resource "azapi_resource" "resourceGroup" {
  type     = "Microsoft.Resources/resourceGroups@2020-06-01"
  name     = var.resource_name
  location = var.location
}

resource "azapi_resource" "iotApp" {
  type      = "Microsoft.IoTCentral/iotApps@2021-11-01-preview"
  parent_id = azapi_resource.resourceGroup.id
  name      = var.resource_name
  location  = var.location
  body = {
    properties = {
      displayName         = var.resource_name
      publicNetworkAccess = "Enabled"
      subdomain           = "subdomain-2306300333537"
      template            = "iotc-pnp-preview@1.0.0"
    }
    sku = {
      name = "ST1"
    }
  }
  schema_validation_enabled = false
  response_export_values    = ["*"]
}