Freigeben über


Microsoft.IoTCentral iotApps

Bicep-Ressourcendefinition

Der Ressourcentyp "iotApps" kann mit Vorgängen bereitgestellt werden, die auf Folgendes abzielen:

Eine Liste der geänderten Eigenschaften in jeder API-Version finden Sie unter Änderungsprotokoll.

Ressourcenformat

Um eine Microsoft.IoTCentral/iotApps-Ressource zu erstellen, fügen Sie Ihrer Vorlage die folgende Bicep hinzu.

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'
  }
}

Eigenschaftswerte

Microsoft.IoTCentral/iotApps

Name Beschreibung Wert
Identität Die verwalteten Identitäten für die IoT Central-Anwendung. SystemAssignedServiceIdentity-
Ort Der geografische Standort, an dem sich die Ressource befindet Zeichenfolge (erforderlich)
Name Der Ressourcenname Zeichenfolge (erforderlich)
Eigenschaften Die allgemeinen Eigenschaften einer IoT Central-Anwendung. AppProperties-
scope Verwenden Sie diese Verwendung beim Erstellen einer Ressource in einem Bereich, der sich von dem Bereitstellungsbereich unterscheidet. Legen Sie diese Eigenschaft auf den symbolischen Namen einer Ressource fest, um die Erweiterungsressourceanzuwenden.
Sku Eine gültige Instanz-SKU. AppSkuInfo- (erforderlich)
Schilder Ressourcentags Wörterbuch der Tagnamen und -werte. Siehe Tags in Vorlagen

App-Eigenschaften

Name Beschreibung Wert
Anzeigename Der Anzeigename der Anwendung. Schnur
networkRuleSets Netzwerkregelsatzeigenschaften dieser IoT Central-Anwendung. NetworkRuleSets-
Öffentlicher Netzwerkzugang Gibt an, ob Anforderungen aus dem öffentlichen Netzwerk zulässig sind. "Deaktiviert"
"Aktiviert"
Subdomäne Die Unterdomäne der Anwendung. Schnur
Schablone Die ID der Anwendungsvorlage, bei der es sich um einen Blueprint handelt, der die Merkmale und Verhaltensweisen einer Anwendung definiert. Wahlfrei; wenn nicht angegeben, wird standardmäßig ein leerer Blueprint verwendet, und die Anwendung kann von Grund auf neu definiert werden. Schnur

AppSkuInfo

Name Beschreibung Wert
Name Der Name der SKU. 'ST0'
'ST1'
"ST2" (erforderlich)

NetworkRuleSetIpRule

Name Beschreibung Wert
FilterName Der lesbare Name der IP-Regel. Schnur
ipMaske Der CIDR-Block, der den IP-Bereich definiert. Schnur

Netzwerk-Regelsätze

Name Beschreibung Wert
applyToDevices Gibt an, ob diese Regeln für die Gerätekonnektivität mit dem IoT Hub- und Gerätebereitstellungsdienst gelten, der dieser Anwendung zugeordnet ist. Bool
applyToIoTCentral Gibt an, ob diese Regeln für die Konnektivität über das IoT Central-Webportal und APIs gelten. Bool
defaultAktion Die anzuwendende Standardnetzwerkaktion. "Zulassen"
"Ablehnen"
ipRegeln Liste der IP-Regeln. NetworkRuleSetIpRule[]

SystemAssignedServiceIdentity

Name Beschreibung Wert
Art Typ der verwalteten Dienstidentität (entweder vom System zugewiesen oder ohne). "Keine"
'SystemAssigned' (erforderlich)

Verfolgte ResourceTags

Name Beschreibung Wert

ARM-Vorlagenressourcendefinition

Der Ressourcentyp "iotApps" kann mit Vorgängen bereitgestellt werden, die auf Folgendes abzielen:

Eine Liste der geänderten Eigenschaften in jeder API-Version finden Sie unter Änderungsprotokoll.

Ressourcenformat

Um eine Microsoft.IoTCentral/iotApps-Ressource zu erstellen, fügen Sie der Vorlage den folgenden JSON-Code hinzu.

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

Eigenschaftswerte

Microsoft.IoTCentral/iotApps

Name Beschreibung Wert
apiVersion (Englisch) Die API-Version "2021-11-01-preview"
Identität Die verwalteten Identitäten für die IoT Central-Anwendung. SystemAssignedServiceIdentity-
Ort Der geografische Standort, an dem sich die Ressource befindet Zeichenfolge (erforderlich)
Name Der Ressourcenname Zeichenfolge (erforderlich)
Eigenschaften Die allgemeinen Eigenschaften einer IoT Central-Anwendung. AppProperties-
Sku Eine gültige Instanz-SKU. AppSkuInfo- (erforderlich)
Schilder Ressourcentags Wörterbuch der Tagnamen und -werte. Siehe Tags in Vorlagen
Art Der Ressourcentyp "Microsoft.IoTCentral/iotApps"

App-Eigenschaften

Name Beschreibung Wert
Anzeigename Der Anzeigename der Anwendung. Schnur
networkRuleSets Netzwerkregelsatzeigenschaften dieser IoT Central-Anwendung. NetworkRuleSets-
Öffentlicher Netzwerkzugang Gibt an, ob Anforderungen aus dem öffentlichen Netzwerk zulässig sind. "Deaktiviert"
"Aktiviert"
Subdomäne Die Unterdomäne der Anwendung. Schnur
Schablone Die ID der Anwendungsvorlage, bei der es sich um einen Blueprint handelt, der die Merkmale und Verhaltensweisen einer Anwendung definiert. Wahlfrei; wenn nicht angegeben, wird standardmäßig ein leerer Blueprint verwendet, und die Anwendung kann von Grund auf neu definiert werden. Schnur

AppSkuInfo

Name Beschreibung Wert
Name Der Name der SKU. 'ST0'
'ST1'
"ST2" (erforderlich)

NetworkRuleSetIpRule

Name Beschreibung Wert
FilterName Der lesbare Name der IP-Regel. Schnur
ipMaske Der CIDR-Block, der den IP-Bereich definiert. Schnur

Netzwerk-Regelsätze

Name Beschreibung Wert
applyToDevices Gibt an, ob diese Regeln für die Gerätekonnektivität mit dem IoT Hub- und Gerätebereitstellungsdienst gelten, der dieser Anwendung zugeordnet ist. Bool
applyToIoTCentral Gibt an, ob diese Regeln für die Konnektivität über das IoT Central-Webportal und APIs gelten. Bool
defaultAktion Die anzuwendende Standardnetzwerkaktion. "Zulassen"
"Ablehnen"
ipRegeln Liste der IP-Regeln. NetworkRuleSetIpRule[]

SystemAssignedServiceIdentity

Name Beschreibung Wert
Art Typ der verwalteten Dienstidentität (entweder vom System zugewiesen oder ohne). "Keine"
'SystemAssigned' (erforderlich)

Verfolgte ResourceTags

Name Beschreibung Wert

Verwendungsbeispiele

Terraform -Ressourcendefinition (AzAPI-Anbieter)

Der Ressourcentyp "iotApps" kann mit Vorgängen bereitgestellt werden, die auf Folgendes abzielen:

Eine Liste der geänderten Eigenschaften in jeder API-Version finden Sie unter Änderungsprotokoll.

Ressourcenformat

Um eine Microsoft.IoTCentral/iotApps-Ressource zu erstellen, fügen Sie Ihrer Vorlage die folgende Terraform hinzu.

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

Eigenschaftswerte

Microsoft.IoTCentral/iotApps

Name Beschreibung Wert
Identität Die verwalteten Identitäten für die IoT Central-Anwendung. SystemAssignedServiceIdentity-
Ort Der geografische Standort, an dem sich die Ressource befindet Zeichenfolge (erforderlich)
Name Der Ressourcenname Zeichenfolge (erforderlich)
parent_id Die ID der Ressource, auf die diese Erweiterungsressource angewendet werden soll. Zeichenfolge (erforderlich)
Eigenschaften Die allgemeinen Eigenschaften einer IoT Central-Anwendung. AppProperties-
Sku Eine gültige Instanz-SKU. AppSkuInfo- (erforderlich)
Schilder Ressourcentags Wörterbuch der Tagnamen und -werte.
Art Der Ressourcentyp "Microsoft.IoTCentral/iotApps@2021-11-01-preview"

App-Eigenschaften

Name Beschreibung Wert
Anzeigename Der Anzeigename der Anwendung. Schnur
networkRuleSets Netzwerkregelsatzeigenschaften dieser IoT Central-Anwendung. NetworkRuleSets-
Öffentlicher Netzwerkzugang Gibt an, ob Anforderungen aus dem öffentlichen Netzwerk zulässig sind. "Deaktiviert"
"Aktiviert"
Subdomäne Die Unterdomäne der Anwendung. Schnur
Schablone Die ID der Anwendungsvorlage, bei der es sich um einen Blueprint handelt, der die Merkmale und Verhaltensweisen einer Anwendung definiert. Wahlfrei; wenn nicht angegeben, wird standardmäßig ein leerer Blueprint verwendet, und die Anwendung kann von Grund auf neu definiert werden. Schnur

AppSkuInfo

Name Beschreibung Wert
Name Der Name der SKU. 'ST0'
'ST1'
"ST2" (erforderlich)

NetworkRuleSetIpRule

Name Beschreibung Wert
FilterName Der lesbare Name der IP-Regel. Schnur
ipMaske Der CIDR-Block, der den IP-Bereich definiert. Schnur

Netzwerk-Regelsätze

Name Beschreibung Wert
applyToDevices Gibt an, ob diese Regeln für die Gerätekonnektivität mit dem IoT Hub- und Gerätebereitstellungsdienst gelten, der dieser Anwendung zugeordnet ist. Bool
applyToIoTCentral Gibt an, ob diese Regeln für die Konnektivität über das IoT Central-Webportal und APIs gelten. Bool
defaultAktion Die anzuwendende Standardnetzwerkaktion. "Zulassen"
"Ablehnen"
ipRegeln Liste der IP-Regeln. NetworkRuleSetIpRule[]

SystemAssignedServiceIdentity

Name Beschreibung Wert
Art Typ der verwalteten Dienstidentität (entweder vom System zugewiesen oder ohne). "Keine"
'SystemAssigned' (erforderlich)

Verfolgte ResourceTags

Name Beschreibung Wert

Verwendungsbeispiele

Terraform-Beispiele

Ein grundlegendes Beispiel für die Bereitstellung der IotCentral-Anwendung.

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    = ["*"]
}