Microsoft.Devices provisioningServices 2020-01-01

Articolo
04/03/2024

Definizione di risorsa Bicep

Il tipo di risorsa provisioningServices può essere distribuito con operazioni destinate:

Gruppi di risorse - Vedere i comandi di distribuzione del gruppo di risorse

Per un elenco delle proprietà modificate in ogni versione dell'API, vedere log delle modifiche.

Formato di risorsa

Per creare una risorsa Microsoft.Devices/provisioningServices, aggiungere il modello Bicep seguente.

resource symbolicname 'Microsoft.Devices/provisioningServices@2020-01-01' = {
  name: 'string'
  location: 'string'
  tags: {
    tagName1: 'tagValue1'
    tagName2: 'tagValue2'
  }
  sku: {
    capacity: int
    name: 'S1'
  }
  etag: 'string'
  properties: {
    allocationPolicy: 'string'
    authorizationPolicies: [
      {
        keyName: 'string'
        primaryKey: 'string'
        rights: 'string'
        secondaryKey: 'string'
        keyName: 'string'
        primaryKey: 'string'
        rights: 'string'
        secondaryKey: 'string'
      }
    ]
    iotHubs: [
      {
        allocationWeight: int
        applyAllocationPolicy: bool
        connectionString: 'string'
        location: 'string'
      }
    ]
    ipFilterRules: [
      {
        action: 'string'
        filterName: 'string'
        ipMask: 'string'
        target: 'string'
      }
    ]
    provisioningState: 'string'
    state: 'string'
  }
}

Valori delle proprietà

provisioningServices

Nome	Descrizione	valore
name	Nome della risorsa	stringa (obbligatoria) Limite di caratteri: 3-64 Caratteri validi: Caratteri alfanumerici e trattini. Deve terminare con un carattere alfanumerico.
posizione	Percorso della risorsa.	stringa (obbligatoria)
tags	Tag di risorsa.	Dizionario dei nomi e dei valori dei tag. Vedere Tag nei modelli
sku	Informazioni sullo sku per un servizio di provisioning.	IotDpsSkuInfo (obbligatorio)
etag	Il campo Etag non è obbligatorio. Se viene fornito nel corpo della risposta, deve essere fornito anche come intestazione per la normale convenzione ETag.	string
properties	Proprietà specifiche del servizio per un servizio di provisioning	IotDpsPropertiesDescription (obbligatorio)

IotDpsPropertiesDescription

Nome	Descrizione	Valore
allocationPolicy	Criteri di allocazione da usare da questo servizio di provisioning.	'GeoLatency' 'Hashed' 'Statico'
authorizationPolicies	Elenco delle chiavi di autorizzazione per un servizio di provisioning.	SharedAccessSignatureAuthorizationRuleAccessRightsDe...[]
iotHubs	Elenco degli hub IoT associati a questo servizio di provisioning.	IotHubDefinitionDescription[]
ipFilterRules	Regole di filtro IP.	IpFilterRule[]
provisioningState	Stato di provisioning arm del servizio di provisioning.	string
state	Stato corrente del servizio di provisioning.	'Attivazione' 'ActivationFailed' 'Attivo' 'Eliminato' 'Eliminazione' 'EliminazioneFailed' 'FailOver' 'FailoverFailed' 'Ripresa' 'Sospeso' 'Sospensione' 'Transizione'

SharedAccessSignatureAuthorizationRuleAccessRightsDe...

Nome	Descrizione	Valore
keyName	Nome della chiave.	stringa (obbligatoria)
primaryKey	Valore della chiave di firma di accesso condiviso primario.	string
diritti	Diritti che questa chiave ha.	'DeviceConnect' 'EnrollmentRead' 'EnrollmentWrite' 'RegistrationStatusRead' 'RegistrationStatusWrite' 'ServiceConfig' (obbligatorio)
secondaryKey	Valore della chiave di firma di accesso condiviso secondario.	string
keyName	Nome della chiave.	stringa (obbligatoria)
primaryKey	Valore della chiave di firma di accesso condiviso primario.	string
diritti	Diritti che questa chiave ha.	'DeviceConnect' 'EnrollmentRead' 'EnrollmentWrite' 'RegistrationStatusRead' 'RegistrationStatusWrite' 'ServiceConfig' (obbligatorio)
secondaryKey	Valore della chiave di firma di accesso condiviso secondario.	string

IotHubDefinitionDescription

Nome	Descrizione	Valore
allocationWeight	peso da applicare per un determinato iot h.	INT
applyAllocationPolicy	flag per l'applicazione di allocazionePolicy o meno per un determinato hub iot.	bool
connectionString	Stringa di connessione og l'hub IoT.	stringa (obbligatoria)
posizione	Area arm dell'hub IoT.	stringa (obbligatoria)

IpFilterRule

Nome	Descrizione	Valore
azione	Azione desiderata per le richieste acquisite da questa regola.	'Accetta' 'Rifiuta' (obbligatorio)
filterName	Nome della regola di filtro IP.	stringa (obbligatoria)
ipMask	Stringa contenente l'intervallo di indirizzi IP nella notazione CIDR per la regola.	stringa (obbligatoria)
target	Destinazione per le richieste acquisite da questa regola.	'all' 'deviceApi' 'serviceApi'

IotDpsSkuInfo

Nome	Descrizione	Valore
capacità	Numero di unità da effettuare per il provisioning	INT
name	Nome sku.	'S1'

Modelli di avvio rapido

I modelli di avvio rapido seguenti distribuiscono questo tipo di risorsa.

Modello	Descrizione
Creare un simulatore di hub IOT e Ubuntu edge	Questo modello crea un simulatore perimetrale ubuntu di hub IOT e macchina virtuale.
Creare un servizio di provisioning dispositivi hub IoT	Questo modello consente di creare un hub IoT e un servizio di provisioning dispositivi di hub IoT e collegare i due servizi insieme.

Definizione della risorsa modello di Resource Manager

Il tipo di risorsa provisioningServices può essere distribuito con operazioni destinate:

Gruppi di risorse - Vedere i comandi di distribuzione del gruppo di risorse

Per un elenco delle proprietà modificate in ogni versione dell'API, vedere log delle modifiche.

Formato di risorsa

Per creare una risorsa Microsoft.Devices/provisioningServices, aggiungere il codice JSON seguente al modello.

{
  "type": "Microsoft.Devices/provisioningServices",
  "apiVersion": "2020-01-01",
  "name": "string",
  "location": "string",
  "tags": {
    "tagName1": "tagValue1",
    "tagName2": "tagValue2"
  },
  "sku": {
    "capacity": "int",
    "name": "S1"
  },
  "etag": "string",
  "properties": {
    "allocationPolicy": "string",
    "authorizationPolicies": [
      {
        "keyName": "string",
        "primaryKey": "string",
        "rights": "string",
        "secondaryKey": "string",
        "keyName": "string",
        "primaryKey": "string",
        "rights": "string",
        "secondaryKey": "string"
      }
    ],
    "iotHubs": [
      {
        "allocationWeight": "int",
        "applyAllocationPolicy": "bool",
        "connectionString": "string",
        "location": "string"
      }
    ],
    "ipFilterRules": [
      {
        "action": "string",
        "filterName": "string",
        "ipMask": "string",
        "target": "string"
      }
    ],
    "provisioningState": "string",
    "state": "string"
  }
}

Valori delle proprietà

provisioningServices

Nome	Descrizione	Valore
tipo	Tipo di risorsa	'Microsoft.Devices/provisioningServices'
apiVersion	Versione dell'API risorsa	'2020-01-01'
name	Nome della risorsa	stringa (obbligatoria) Limite di caratteri: 3-64 Caratteri validi: Caratteri alfanumerici e trattini. Deve terminare con un carattere alfanumerico.
posizione	Percorso della risorsa.	stringa (obbligatorio)
tags	Tag di risorsa.	Dizionario di nomi e valori di tag. Vedere Tag nei modelli
sku	Informazioni sullo SKU per un servizio di provisioning.	IotDpsSkuInfo (obbligatorio)
etag	Il campo Etag non è obbligatorio. Se viene specificato nel corpo della risposta, deve anche essere fornito come intestazione in base alla normale convenzione ETag.	string
properties	Proprietà specifiche del servizio per un servizio di provisioning	IotDpsPropertiesDescription (obbligatorio)

IotDpsPropertiesDescription

Nome	Descrizione	Valore
allocationPolicy	Criteri di allocazione da usare da questo servizio di provisioning.	'GeoLatency' 'Hashed' 'Static'
authorizationPolicies	Elenco delle chiavi di autorizzazione per un servizio di provisioning.	SharedAccessSignatureAuthorizationRuleAccessRightsDe...[]
iotHubs	Elenco di hub IoT associati a questo servizio di provisioning.	IotHubDefinitionDescription[]
ipFilterRules	Regole di filtro IP.	IpFilterRule[]
provisioningState	Stato del provisioning arm del servizio di provisioning.	string
state	Stato corrente del servizio di provisioning.	'Attivazione' 'ActivationFailed' 'Attivo' 'Eliminato' 'Eliminazione' 'DeletionFailed' 'FailOver' 'FailoverFailed' 'Ripresa' 'Sospeso' 'Suspending' "Transizione"

SharedAccessSignatureAuthorizationRuleAccessRightsDe...

Nome	Descrizione	Valore
keyName	Nome della chiave.	stringa (obbligatorio)
primaryKey	Valore della chiave di firma di accesso condiviso primario.	string
diritti	Diritti di cui dispone questa chiave.	'DeviceConnect' 'EnrollmentRead' 'EnrollmentWrite' 'RegistrationStatusRead' 'RegistrationStatusWrite' 'ServiceConfig' (obbligatorio)
secondaryKey	Valore della chiave di firma di accesso condiviso secondario.	string
keyName	Nome della chiave.	stringa (obbligatorio)
primaryKey	Valore della chiave di firma di accesso condiviso primario.	string
diritti	Diritti di cui dispone questa chiave.	'DeviceConnect' 'EnrollmentRead' 'EnrollmentWrite' 'RegistrationStatusRead' 'RegistrationStatusWrite' 'ServiceConfig' (obbligatorio)
secondaryKey	Valore della chiave di firma di accesso condiviso secondario.	string

IotHubDefinitionDescription

Nome	Descrizione	Valore
allocationWeight	peso da applicare per un determinato iot h.	INT
applyAllocationPolicy	flag per l'applicazione di allocazionePolicy o meno per un determinato hub iot.	bool
connectionString	Stringa di connessione og l'hub IoT.	stringa (obbligatoria)
posizione	Area arm dell'hub IoT.	stringa (obbligatoria)

IpFilterRule

Nome	Descrizione	Valore
azione	Azione desiderata per le richieste acquisite da questa regola.	'Accetta' 'Rifiuta' (obbligatorio)
filterName	Nome della regola di filtro IP.	stringa (obbligatoria)
ipMask	Stringa contenente l'intervallo di indirizzi IP nella notazione CIDR per la regola.	stringa (obbligatoria)
target	Destinazione per le richieste acquisite da questa regola.	'all' 'deviceApi' 'serviceApi'

IotDpsSkuInfo

Nome	Descrizione	Valore
capacità	Numero di unità da effettuare per il provisioning	INT
name	Nome sku.	'S1'

Modelli di avvio rapido

I modelli di avvio rapido seguenti distribuiscono questo tipo di risorsa.

Modello	Descrizione
Creare un simulatore di hub IOT e Ubuntu edge	Questo modello crea un simulatore perimetrale ubuntu di hub IOT e macchina virtuale.
Creare un servizio di provisioning dispositivi hub IoT	Questo modello consente di creare un hub IoT e un servizio di provisioning dispositivi di hub IoT e collegare i due servizi insieme.

Definizione della risorsa Terraform (provider AzAPI)

Il tipo di risorsa provisioningServices può essere distribuito con operazioni destinate:

Gruppi di risorse

Per un elenco delle proprietà modificate in ogni versione dell'API, vedere log delle modifiche.

Formato di risorsa

Per creare una risorsa Microsoft.Devices/provisioningServices, aggiungere il codice Terraform seguente al modello.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Devices/provisioningServices@2020-01-01"
  name = "string"
  location = "string"
  parent_id = "string"
  tags = {
    tagName1 = "tagValue1"
    tagName2 = "tagValue2"
  }
  body = jsonencode({
    properties = {
      allocationPolicy = "string"
      authorizationPolicies = [
        {
          keyName = "string"
          primaryKey = "string"
          rights = "string"
          secondaryKey = "string"
          keyName = "string"
          primaryKey = "string"
          rights = "string"
          secondaryKey = "string"
        }
      ]
      iotHubs = [
        {
          allocationWeight = int
          applyAllocationPolicy = bool
          connectionString = "string"
          location = "string"
        }
      ]
      ipFilterRules = [
        {
          action = "string"
          filterName = "string"
          ipMask = "string"
          target = "string"
        }
      ]
      provisioningState = "string"
      state = "string"
    }
    sku = {
      capacity = int
      name = "S1"
    }
    etag = "string"
  })
}

Valori delle proprietà

provisioningServices

Nome	Descrizione	Valore
tipo	Tipo di risorsa	"Microsoft.Devices/provisioningServices@2020-01-01"
name	Nome della risorsa	stringa (obbligatoria) Limite di caratteri: 3-64 Caratteri validi: Caratteri alfanumerici e trattini. Deve terminare con un carattere alfanumerico.
posizione	Percorso della risorsa.	stringa (obbligatoria)
parent_id	Per distribuire in un gruppo di risorse, usare l'ID del gruppo di risorse.	stringa (obbligatoria)
tags	Tag di risorsa.	Dizionario dei nomi e dei valori dei tag.
sku	Informazioni sullo sku per un servizio di provisioning.	IotDpsSkuInfo (obbligatorio)
etag	Il campo Etag non è obbligatorio. Se viene fornito nel corpo della risposta, deve essere fornito anche come intestazione per la normale convenzione ETag.	string
properties	Proprietà specifiche del servizio per un servizio di provisioning	IotDpsPropertiesDescription (obbligatorio)

IotDpsPropertiesDescription

Nome	Descrizione	Valore
allocationPolicy	Criteri di allocazione da usare da questo servizio di provisioning.	"GeoLatency" "Hashed" "Statico"
authorizationPolicies	Elenco delle chiavi di autorizzazione per un servizio di provisioning.	SharedAccessSignatureAuthorizationRuleAccessRightsDe...[]
iotHubs	Elenco di hub IoT associati a questo servizio di provisioning.	IotHubDefinitionDescription[]
ipFilterRules	Regole di filtro IP.	IpFilterRule[]
provisioningState	Stato del provisioning arm del servizio di provisioning.	string
state	Stato corrente del servizio di provisioning.	"Attivazione" "ActivationFailed" "Attivo" "Eliminato" "Eliminazione" "DeletionFailed" "FailOver" "FailoverFailed" "Ripresa" "Sospeso" "Sospensione" "Transizione"

SharedAccessSignatureAuthorizationRuleAccessRightsDe...

Nome	Descrizione	Valore
keyName	Nome della chiave.	stringa (obbligatorio)
primaryKey	Valore della chiave di firma di accesso condiviso primario.	string
diritti	Diritti di cui dispone questa chiave.	"DeviceConnect" "EnrollmentRead" "EnrollmentWrite" "RegistrationStatusRead" "RegistrationStatusWrite" "ServiceConfig" (obbligatorio)
secondaryKey	Valore della chiave di firma di accesso condiviso secondario.	string
keyName	Nome della chiave.	stringa (obbligatorio)
primaryKey	Valore della chiave di firma di accesso condiviso primario.	string
diritti	Diritti di cui dispone questa chiave.	"DeviceConnect" "EnrollmentRead" "EnrollmentWrite" "RegistrationStatusRead" "RegistrationStatusWrite" "ServiceConfig" (obbligatorio)
secondaryKey	Valore della chiave di firma di accesso condiviso secondario.	string

IotHubDefinitionDescription

Nome	Descrizione	Valore
allocationWeight	peso da applicare per un determinato iot h.	INT
applyAllocationPolicy	flag per l'applicazione di allocationPolicy o meno per un determinato hub iot.	bool
connectionString	Stringa di connessione og l'hub IoT.	stringa (obbligatorio)
posizione	Area arm dell'hub IoT.	stringa (obbligatorio)

IpFilterRule

Nome	Descrizione	Valore
azione	Azione desiderata per le richieste acquisite da questa regola.	"Accept" "Rifiuta" (obbligatorio)
filterName	Nome della regola di filtro IP.	stringa (obbligatorio)
ipMask	Stringa contenente l'intervallo di indirizzi IP nella notazione CIDR per la regola.	stringa (obbligatorio)
target	Destinazione per le richieste acquisite da questa regola.	"all" "deviceApi" "serviceApi"

IotDpsSkuInfo

Nome	Descrizione	Valore
capacità	Numero di unità da effettuare per il provisioning	INT
name	Nome sku.	"S1"

Condividi tramite

Microsoft.Devices provisioningServices 2020-01-01

Definizione di risorsa Bicep

Formato di risorsa

Valori delle proprietà

provisioningServices

IotDpsPropertiesDescription

SharedAccessSignatureAuthorizationRuleAccessRightsDe...

IotHubDefinitionDescription

IpFilterRule

IotDpsSkuInfo

Modelli di avvio rapido

Definizione della risorsa modello di Resource Manager

Formato di risorsa

Valori delle proprietà

provisioningServices

IotDpsPropertiesDescription

SharedAccessSignatureAuthorizationRuleAccessRightsDe...

IotHubDefinitionDescription

IpFilterRule

IotDpsSkuInfo

Modelli di avvio rapido

Definizione della risorsa Terraform (provider AzAPI)

Formato di risorsa

Valori delle proprietà

provisioningServices

IotDpsPropertiesDescription

SharedAccessSignatureAuthorizationRuleAccessRightsDe...

IotHubDefinitionDescription

IpFilterRule

IotDpsSkuInfo

Commenti e suggerimenti

Risorse aggiuntive