Freigeben über


Microsoft.Devices provisioningServices 2020-01-01

Bicep-Ressourcendefinition

Der ressourcentyp provisioningServices 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.Devices/provisioningServices-Ressource zu erstellen, fügen Sie ihrer Vorlage den folgenden Bicep hinzu.

resource symbolicname 'Microsoft.Devices/provisioningServices@2020-01-01' = {
  etag: 'string'
  location: 'string'
  name: 'string'
  properties: {
    allocationPolicy: 'string'
    authorizationPolicies: [
      {
        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: 'string'
  }
  tags: {
    {customized property}: 'string'
  }
}

Eigenschaftswerte

IotDpsPropertiesDescription

Name Beschreibung Wert
allocationPolicy Zuordnungsrichtlinie, die von diesem Bereitstellungsdienst verwendet werden soll. "GeoLatency"
"Hashed"
"Statisch"
authorizationPolicies Liste der Autorisierungsschlüssel für einen Bereitstellungsdienst. SharedAccessSignatureAuthorizationRuleAccessRightsDescription[]
iotHubs Liste der IoT-Hubs, die diesem Bereitstellungsdienst zugeordnet sind. IotHubDefinitionDescription[]
ipFilterRules Die IP-Filterregeln. IpFilterRule-[]
provisioningState Der ARM-Bereitstellungsstatus des Bereitstellungsdiensts. Schnur
Zustand Aktueller Status des Bereitstellungsdiensts. "Aktivieren"
"ActivationFailed"
"Aktiv"
"Gelöscht"
"Löschen"
"DeleteFailed"
'FailOver'
'FailoverFailed'
"Fortsetzen"
"Angehalten"
"Anhalten"
"Transitioning"

IotDpsSkuInfo

Name Beschreibung Wert
Fassungsvermögen Die Anzahl der bereitzustellenden Einheiten Int
Name Sku-Name. 'S1'

IotHubDefinitionDescription

Name Beschreibung Wert
allocationWeight Gewichtung, um für einen bestimmten Iot h anzuwenden. Int
applyAllocationPolicy flag for applying allocationPolicy or not for a given iot hub. Bool
connectionString Verbindungszeichenfolge og ioT hub. Zeichenfolge (erforderlich)
Ort ARM-Region des IoT-Hubs. Zeichenfolge (erforderlich)

IpFilterRule

Name Beschreibung Wert
Aktion Die gewünschte Aktion für Anforderungen, die von dieser Regel erfasst werden. "Annehmen"
"Ablehnen" (erforderlich)
filterName Der Name der IP-Filterregel. Zeichenfolge (erforderlich)
ipMask Eine Zeichenfolge, die den IP-Adressbereich in der CIDR-Notation für die Regel enthält. Zeichenfolge (erforderlich)
Ziel Ziel für Anforderungen, die von dieser Regel erfasst werden. "alle"
"deviceApi"
'serviceApi'

Microsoft.Devices/provisioningServices

Name Beschreibung Wert
etag Das Feld "Etag" ist nicht erforderlich. Wenn sie im Antworttext bereitgestellt wird, muss sie auch als Kopfzeile gemäß der normalen ETag-Konvention bereitgestellt werden. Schnur
Ort Der Ressourcenspeicherort. Zeichenfolge (erforderlich)
Name Der Ressourcenname Zeichenfolge (erforderlich)
Eigenschaften Dienstspezifische Eigenschaften für einen Bereitstellungsdienst IotDpsPropertiesDescription (erforderlich)
Sku Sku-Informationen für einen Bereitstellungsdienst. IotDpsSkuInfo- (erforderlich)
Schilder Ressourcentags Wörterbuch der Tagnamen und -werte. Siehe Tags in Vorlagen

ResourceTags

Name Beschreibung Wert

SharedAccessSignatureAuthorizationRuleAccessRightsDescription

Name Beschreibung Wert
keyName Der Name des Schlüssels. Zeichenfolge (erforderlich)
primaryKey Primärer SAS-Schlüsselwert. Schnur
Rechte Rechte, die dieser Schlüssel hat. "DeviceConnect"
"EnrollmentRead"
'EnrollmentWrite'
'RegistrationStatusRead'
'RegistrationStatusWrite'
'ServiceConfig' (erforderlich)
secondaryKey Sekundärer SAS-Schlüsselwert. Schnur

Schnellstartbeispiele

Die folgenden Schnellstartbeispiele stellen diesen Ressourcentyp bereit.

Bicep-Datei Beschreibung
Erstellen eines IoT Hub-Gerätebereitstellungsdiensts Mit dieser Vorlage können Sie einen IoT-Hub und einen IoT Hub-Gerätebereitstellungsdienst erstellen und die beiden Dienste miteinander verknüpfen.

ARM-Vorlagenressourcendefinition

Der ressourcentyp provisioningServices 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.Devices/provisioningServices-Ressource zu erstellen, fügen Sie Ihrer Vorlage den folgenden JSON-Code hinzu.

{
  "type": "Microsoft.Devices/provisioningServices",
  "apiVersion": "2020-01-01",
  "name": "string",
  "etag": "string",
  "location": "string",
  "properties": {
    "allocationPolicy": "string",
    "authorizationPolicies": [
      {
        "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": "string"
  },
  "tags": {
    "{customized property}": "string"
  }
}

Eigenschaftswerte

IotDpsPropertiesDescription

Name Beschreibung Wert
allocationPolicy Zuordnungsrichtlinie, die von diesem Bereitstellungsdienst verwendet werden soll. "GeoLatency"
"Hashed"
"Statisch"
authorizationPolicies Liste der Autorisierungsschlüssel für einen Bereitstellungsdienst. SharedAccessSignatureAuthorizationRuleAccessRightsDescription[]
iotHubs Liste der IoT-Hubs, die diesem Bereitstellungsdienst zugeordnet sind. IotHubDefinitionDescription[]
ipFilterRules Die IP-Filterregeln. IpFilterRule-[]
provisioningState Der ARM-Bereitstellungsstatus des Bereitstellungsdiensts. Schnur
Zustand Aktueller Status des Bereitstellungsdiensts. "Aktivieren"
"ActivationFailed"
"Aktiv"
"Gelöscht"
"Löschen"
"DeleteFailed"
'FailOver'
'FailoverFailed'
"Fortsetzen"
"Angehalten"
"Anhalten"
"Transitioning"

IotDpsSkuInfo

Name Beschreibung Wert
Fassungsvermögen Die Anzahl der bereitzustellenden Einheiten Int
Name Sku-Name. 'S1'

IotHubDefinitionDescription

Name Beschreibung Wert
allocationWeight Gewichtung, um für einen bestimmten Iot h anzuwenden. Int
applyAllocationPolicy flag for applying allocationPolicy or not for a given iot hub. Bool
connectionString Verbindungszeichenfolge og ioT hub. Zeichenfolge (erforderlich)
Ort ARM-Region des IoT-Hubs. Zeichenfolge (erforderlich)

IpFilterRule

Name Beschreibung Wert
Aktion Die gewünschte Aktion für Anforderungen, die von dieser Regel erfasst werden. "Annehmen"
"Ablehnen" (erforderlich)
filterName Der Name der IP-Filterregel. Zeichenfolge (erforderlich)
ipMask Eine Zeichenfolge, die den IP-Adressbereich in der CIDR-Notation für die Regel enthält. Zeichenfolge (erforderlich)
Ziel Ziel für Anforderungen, die von dieser Regel erfasst werden. "alle"
"deviceApi"
'serviceApi'

Microsoft.Devices/provisioningServices

Name Beschreibung Wert
apiVersion Die API-Version '2020-01-01'
etag Das Feld "Etag" ist nicht erforderlich. Wenn sie im Antworttext bereitgestellt wird, muss sie auch als Kopfzeile gemäß der normalen ETag-Konvention bereitgestellt werden. Schnur
Ort Der Ressourcenspeicherort. Zeichenfolge (erforderlich)
Name Der Ressourcenname Zeichenfolge (erforderlich)
Eigenschaften Dienstspezifische Eigenschaften für einen Bereitstellungsdienst IotDpsPropertiesDescription (erforderlich)
Sku Sku-Informationen für einen Bereitstellungsdienst. IotDpsSkuInfo- (erforderlich)
Schilder Ressourcentags Wörterbuch der Tagnamen und -werte. Siehe Tags in Vorlagen
Art Der Ressourcentyp "Microsoft.Devices/provisioningServices"

ResourceTags

Name Beschreibung Wert

SharedAccessSignatureAuthorizationRuleAccessRightsDescription

Name Beschreibung Wert
keyName Der Name des Schlüssels. Zeichenfolge (erforderlich)
primaryKey Primärer SAS-Schlüsselwert. Schnur
Rechte Rechte, die dieser Schlüssel hat. "DeviceConnect"
"EnrollmentRead"
'EnrollmentWrite'
'RegistrationStatusRead'
'RegistrationStatusWrite'
'ServiceConfig' (erforderlich)
secondaryKey Sekundärer SAS-Schlüsselwert. Schnur

Schnellstartvorlagen

Die folgenden Schnellstartvorlagen stellen diesen Ressourcentyp bereit.

Schablone Beschreibung
Erstellen eines IOT Hub- und Ubuntu-Edgesimulators

Bereitstellen in Azure
Diese Vorlage erstellt einen IOT Hub und einen Virtuellen Computer Ubuntu Edge Simulator.
Erstellen eines IoT Hub-Gerätebereitstellungsdiensts

Bereitstellen in Azure
Mit dieser Vorlage können Sie einen IoT-Hub und einen IoT Hub-Gerätebereitstellungsdienst erstellen und die beiden Dienste miteinander verknüpfen.

Terraform -Ressourcendefinition (AzAPI-Anbieter)

Der ressourcentyp provisioningServices kann mit Vorgängen bereitgestellt werden, die auf Folgendes abzielen:

  • Ressourcengruppen

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

Ressourcenformat

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

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Devices/provisioningServices@2020-01-01"
  name = "string"
  etag = "string"
  location = "string"
  body = jsonencode({
    properties = {
      allocationPolicy = "string"
      authorizationPolicies = [
        {
          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 = "string"
  }
  tags = {
    {customized property} = "string"
  }
}

Eigenschaftswerte

IotDpsPropertiesDescription

Name Beschreibung Wert
allocationPolicy Zuordnungsrichtlinie, die von diesem Bereitstellungsdienst verwendet werden soll. "GeoLatency"
"Hashed"
"Statisch"
authorizationPolicies Liste der Autorisierungsschlüssel für einen Bereitstellungsdienst. SharedAccessSignatureAuthorizationRuleAccessRightsDescription[]
iotHubs Liste der IoT-Hubs, die diesem Bereitstellungsdienst zugeordnet sind. IotHubDefinitionDescription[]
ipFilterRules Die IP-Filterregeln. IpFilterRule-[]
provisioningState Der ARM-Bereitstellungsstatus des Bereitstellungsdiensts. Schnur
Zustand Aktueller Status des Bereitstellungsdiensts. "Aktivieren"
"ActivationFailed"
"Aktiv"
"Gelöscht"
"Löschen"
"DeleteFailed"
'FailOver'
'FailoverFailed'
"Fortsetzen"
"Angehalten"
"Anhalten"
"Transitioning"

IotDpsSkuInfo

Name Beschreibung Wert
Fassungsvermögen Die Anzahl der bereitzustellenden Einheiten Int
Name Sku-Name. 'S1'

IotHubDefinitionDescription

Name Beschreibung Wert
allocationWeight Gewichtung, um für einen bestimmten Iot h anzuwenden. Int
applyAllocationPolicy flag for applying allocationPolicy or not for a given iot hub. Bool
connectionString Verbindungszeichenfolge og ioT hub. Zeichenfolge (erforderlich)
Ort ARM-Region des IoT-Hubs. Zeichenfolge (erforderlich)

IpFilterRule

Name Beschreibung Wert
Aktion Die gewünschte Aktion für Anforderungen, die von dieser Regel erfasst werden. "Annehmen"
"Ablehnen" (erforderlich)
filterName Der Name der IP-Filterregel. Zeichenfolge (erforderlich)
ipMask Eine Zeichenfolge, die den IP-Adressbereich in der CIDR-Notation für die Regel enthält. Zeichenfolge (erforderlich)
Ziel Ziel für Anforderungen, die von dieser Regel erfasst werden. "alle"
"deviceApi"
'serviceApi'

Microsoft.Devices/provisioningServices

Name Beschreibung Wert
etag Das Feld "Etag" ist nicht erforderlich. Wenn sie im Antworttext bereitgestellt wird, muss sie auch als Kopfzeile gemäß der normalen ETag-Konvention bereitgestellt werden. Schnur
Ort Der Ressourcenspeicherort. Zeichenfolge (erforderlich)
Name Der Ressourcenname Zeichenfolge (erforderlich)
Eigenschaften Dienstspezifische Eigenschaften für einen Bereitstellungsdienst IotDpsPropertiesDescription (erforderlich)
Sku Sku-Informationen für einen Bereitstellungsdienst. IotDpsSkuInfo- (erforderlich)
Schilder Ressourcentags Wörterbuch der Tagnamen und -werte.
Art Der Ressourcentyp "Microsoft.Devices/provisioningServices@2020-01-01"

ResourceTags

Name Beschreibung Wert

SharedAccessSignatureAuthorizationRuleAccessRightsDescription

Name Beschreibung Wert
keyName Der Name des Schlüssels. Zeichenfolge (erforderlich)
primaryKey Primärer SAS-Schlüsselwert. Schnur
Rechte Rechte, die dieser Schlüssel hat. "DeviceConnect"
"EnrollmentRead"
'EnrollmentWrite'
'RegistrationStatusRead'
'RegistrationStatusWrite'
'ServiceConfig' (erforderlich)
secondaryKey Sekundärer SAS-Schlüsselwert. Schnur