Compartir a través de


Microsoft.IoTCentral iotApps

Definición de recursos de Bicep

El tipo de recurso iotApps se puede implementar con operaciones destinadas a:

Para obtener una lista de las propiedades modificadas en cada versión de API, consulte registro de cambios.

Formato de recurso

Para crear un recurso Microsoft.IoTCentral/iotApps, agregue el siguiente bicep a la plantilla.

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

Valores de propiedad

Microsoft.IoTCentral/iotApps

Nombre Descripción Valor
identidad Identidades administradas para la aplicación de IoT Central. SystemAssignedServiceIdentity
ubicación Ubicación geográfica donde reside el recurso string (obligatorio)
nombre El nombre del recurso string (obligatorio)
Propiedades Las propiedades comunes de una aplicación de IoT Central. AppProperties
scope Use al crear un recurso en un ámbito diferente del ámbito de implementación. Establezca esta propiedad en el nombre simbólico de un recurso para aplicar el recurso de extensión .
Sku Una SKU de instancia válida. appSkuInfo (obligatorio)
Etiquetas Etiquetas de recursos Diccionario de nombres y valores de etiqueta. Consulte etiquetas de en plantillas

AppProperties

Nombre Descripción Valor
Nombre para mostrar Nombre para mostrar de la aplicación. cuerda
networkRuleSets Propiedades del conjunto de reglas de red de esta aplicación de IoT Central. NetworkRuleSets
publicNetworkAccess Indica si se permiten solicitudes de la red pública. 'Deshabilitado'
'Habilitado'
subdominio Subdominio de la aplicación. cuerda
plantilla Identificador de la plantilla de aplicación, que es un plano técnico que define las características y comportamientos de una aplicación. Opcional; si no se especifica, el valor predeterminado es un plano técnico en blanco y permite definir la aplicación desde cero. cuerda

AppSkuInfo

Nombre Descripción Valor
nombre Nombre de la SKU. 'ST0'
'ST1'
'ST2' (obligatorio)

NetworkRuleSetIpRule

Nombre Descripción Valor
filterName Nombre legible de la regla de IP. cuerda
ipMask (Máscara de ip) Bloque CIDR que define el intervalo IP. cuerda

NetworkRuleSets

Nombre Descripción Valor
applyToDevices Si estas reglas se aplican a la conectividad de dispositivos a IoT Hub y al servicio Device Provisioning asociado a esta aplicación. Bool
applyToIoTCentral Si estas reglas se aplican para la conectividad a través del portal web y las API de IoT Central. Bool
defaultAction Acción de red predeterminada que se va a aplicar. 'Permitir'
'Denegar'
ipRules (Reglas de ip) Lista de reglas de IP. NetworkRuleSetIpRule[]

SystemAssignedServiceIdentity

Nombre Descripción Valor
tipo Tipo de identidad de servicio administrada (asignada por el sistema o ninguna). 'Ninguno'
'SystemAssigned' (obligatorio)

TrackedResourceTags

Nombre Descripción Valor

Definición de recursos de plantilla de ARM

El tipo de recurso iotApps se puede implementar con operaciones destinadas a:

Para obtener una lista de las propiedades modificadas en cada versión de API, consulte registro de cambios.

Formato de recurso

Para crear un recurso Microsoft.IoTCentral/iotApps, agregue el siguiente JSON a la plantilla.

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

Valores de propiedad

Microsoft.IoTCentral/iotApps

Nombre Descripción Valor
apiVersion La versión de api '2021-11-01-preestreno'
identidad Identidades administradas para la aplicación de IoT Central. SystemAssignedServiceIdentity
ubicación Ubicación geográfica donde reside el recurso string (obligatorio)
nombre El nombre del recurso string (obligatorio)
Propiedades Las propiedades comunes de una aplicación de IoT Central. AppProperties
Sku Una SKU de instancia válida. appSkuInfo (obligatorio)
Etiquetas Etiquetas de recursos Diccionario de nombres y valores de etiqueta. Consulte etiquetas de en plantillas
tipo El tipo de recurso "Microsoft.IoTCentral/iotApps"

AppProperties

Nombre Descripción Valor
Nombre para mostrar Nombre para mostrar de la aplicación. cuerda
networkRuleSets Propiedades del conjunto de reglas de red de esta aplicación de IoT Central. NetworkRuleSets
publicNetworkAccess Indica si se permiten solicitudes de la red pública. 'Deshabilitado'
'Habilitado'
subdominio Subdominio de la aplicación. cuerda
plantilla Identificador de la plantilla de aplicación, que es un plano técnico que define las características y comportamientos de una aplicación. Opcional; si no se especifica, el valor predeterminado es un plano técnico en blanco y permite definir la aplicación desde cero. cuerda

AppSkuInfo

Nombre Descripción Valor
nombre Nombre de la SKU. 'ST0'
'ST1'
'ST2' (obligatorio)

NetworkRuleSetIpRule

Nombre Descripción Valor
filterName Nombre legible de la regla de IP. cuerda
ipMask (Máscara de ip) Bloque CIDR que define el intervalo IP. cuerda

NetworkRuleSets

Nombre Descripción Valor
applyToDevices Si estas reglas se aplican a la conectividad de dispositivos a IoT Hub y al servicio Device Provisioning asociado a esta aplicación. Bool
applyToIoTCentral Si estas reglas se aplican para la conectividad a través del portal web y las API de IoT Central. Bool
defaultAction Acción de red predeterminada que se va a aplicar. 'Permitir'
'Denegar'
ipRules (Reglas de ip) Lista de reglas de IP. NetworkRuleSetIpRule[]

SystemAssignedServiceIdentity

Nombre Descripción Valor
tipo Tipo de identidad de servicio administrada (asignada por el sistema o ninguna). 'Ninguno'
'SystemAssigned' (obligatorio)

TrackedResourceTags

Nombre Descripción Valor

Ejemplos de uso

Definición de recursos de Terraform (proveedor AzAPI)

El tipo de recurso iotApps se puede implementar con operaciones destinadas a:

Para obtener una lista de las propiedades modificadas en cada versión de API, consulte registro de cambios.

Formato de recurso

Para crear un recurso Microsoft.IoTCentral/iotApps, agregue el siguiente terraform a la plantilla.

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

Valores de propiedad

Microsoft.IoTCentral/iotApps

Nombre Descripción Valor
identidad Identidades administradas para la aplicación de IoT Central. SystemAssignedServiceIdentity
ubicación Ubicación geográfica donde reside el recurso string (obligatorio)
nombre El nombre del recurso string (obligatorio)
parent_id Identificador del recurso al que se va a aplicar este recurso de extensión. string (obligatorio)
Propiedades Las propiedades comunes de una aplicación de IoT Central. AppProperties
Sku Una SKU de instancia válida. appSkuInfo (obligatorio)
Etiquetas Etiquetas de recursos Diccionario de nombres y valores de etiqueta.
tipo El tipo de recurso "Microsoft.IoTCentral/iotApps@2021-11-01-preview"

AppProperties

Nombre Descripción Valor
Nombre para mostrar Nombre para mostrar de la aplicación. cuerda
networkRuleSets Propiedades del conjunto de reglas de red de esta aplicación de IoT Central. NetworkRuleSets
publicNetworkAccess Indica si se permiten solicitudes de la red pública. 'Deshabilitado'
'Habilitado'
subdominio Subdominio de la aplicación. cuerda
plantilla Identificador de la plantilla de aplicación, que es un plano técnico que define las características y comportamientos de una aplicación. Opcional; si no se especifica, el valor predeterminado es un plano técnico en blanco y permite definir la aplicación desde cero. cuerda

AppSkuInfo

Nombre Descripción Valor
nombre Nombre de la SKU. 'ST0'
'ST1'
'ST2' (obligatorio)

NetworkRuleSetIpRule

Nombre Descripción Valor
filterName Nombre legible de la regla de IP. cuerda
ipMask (Máscara de ip) Bloque CIDR que define el intervalo IP. cuerda

NetworkRuleSets

Nombre Descripción Valor
applyToDevices Si estas reglas se aplican a la conectividad de dispositivos a IoT Hub y al servicio Device Provisioning asociado a esta aplicación. Bool
applyToIoTCentral Si estas reglas se aplican para la conectividad a través del portal web y las API de IoT Central. Bool
defaultAction Acción de red predeterminada que se va a aplicar. 'Permitir'
'Denegar'
ipRules (Reglas de ip) Lista de reglas de IP. NetworkRuleSetIpRule[]

SystemAssignedServiceIdentity

Nombre Descripción Valor
tipo Tipo de identidad de servicio administrada (asignada por el sistema o ninguna). 'Ninguno'
'SystemAssigned' (obligatorio)

TrackedResourceTags

Nombre Descripción Valor

Ejemplos de uso

Ejemplos de Terraform

Un ejemplo básico de implementación de la aplicación de 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    = ["*"]
}