Dela via


Microsoft.Devices provisioningServices

Bicep-resursdefinition

Resurstypen provisioningServices kan distribueras med åtgärder som mål:

En lista över ändrade egenskaper i varje API-version finns i ändringsloggen.

Resursformat

Om du vill skapa en Microsoft.Devices/provisioningServices-resurs lägger du till följande Bicep i mallen.

resource symbolicname 'Microsoft.Devices/provisioningServices@2025-02-01-preview' = {
  etag: 'string'
  identity: {
    type: 'string'
    userAssignedIdentities: {
      {customized property}: {}
    }
  }
  location: 'string'
  name: 'string'
  properties: {
    allocationPolicy: 'string'
    authorizationPolicies: [
      {
        keyName: 'string'
        primaryKey: 'string'
        rights: 'string'
        secondaryKey: 'string'
      }
    ]
    enableDataResidency: bool
    iotHubs: [
      {
        allocationWeight: int
        applyAllocationPolicy: bool
        authenticationType: 'string'
        connectionString: 'string'
        location: 'string'
        selectedUserAssignedIdentityResourceId: 'string'
      }
    ]
    ipFilterRules: [
      {
        action: 'string'
        filterName: 'string'
        ipMask: 'string'
        target: 'string'
      }
    ]
    portalOperationsHostName: 'string'
    privateEndpointConnections: [
      {
        properties: {
          privateEndpoint: {}
          privateLinkServiceConnectionState: {
            actionsRequired: 'string'
            description: 'string'
            status: 'string'
          }
        }
      }
    ]
    provisioningState: 'string'
    publicNetworkAccess: 'string'
    state: 'string'
  }
  resourcegroup: 'string'
  sku: {
    capacity: int
    name: 'string'
  }
  subscriptionid: 'string'
  tags: {
    {customized property}: 'string'
  }
}

Egenskapsvärden

IotDpsPropertiesDescription

Namn Beskrivning Värde
allocationPolicy Allokeringsprincip som ska användas av den här etableringstjänsten. "GeoLatency"
"Hashed"
"Statisk"
authorizationPolicies Lista över auktoriseringsnycklar för en etableringstjänst. SharedAccessSignatureAuthorizationRuleAccessRightsDescription[]
enableDataResidency Valfri.
Anger om DPS-instansen har Data Residency aktiverat, vilket tar bort haveriberedskapen mellan geo-par.
Bool
iotHubs Lista över IoT-hubbar som är associerade med den här etableringstjänsten. IotHubDefinitionDescription[]
ipFilterRules IP-filterreglerna. IpFilterRule[]
portalOperationsHostName Portalslutpunkt för att aktivera CORS för den här etableringstjänsten. sträng
privateEndpointConnections Privata slutpunktsanslutningar som skapats på denna IotHub PrivateEndpointConnection[]
provisioningState ARM-etableringstillståndet för etableringstjänsten. sträng
publicNetworkAccess Om begäranden från offentliga nätverk tillåts "Inaktiverad"
"Aktiverad"
stat Etableringstjänstens aktuella tillstånd. "Aktivera"
"ActivationFailed"
"Aktiv"
"Borttaget"
"Ta bort"
"DeletionFailed"
"Redundans"
"FailoverFailed"
"Återuppta"
"Pausad"
"Pausa"
"Övergång"

IotDpsSkuInfo

Namn Beskrivning Värde
kapacitet Antalet enheter som ska etableras Int
Namn Sku-namn. "S1"

IotHubDefinitionDescription

Namn Beskrivning Värde
allocationWeight vikt för att ansöka om en given iot h. Int
applyAllocationPolicy flagga för att tillämpa allocationPolicy eller inte för en viss iot-hubb. Bool
authenticationType IotHub MI-autentiseringstyp: KeyBased, UserAssigned, SystemAssigned. "KeyBased"
"SystemAssigned"
"UserAssigned"
connectionString Anslutningssträng för IoT-hubben. sträng
plats ARM-regionen för IoT-hubben. sträng (krävs)
selectedUserAssignedIdentityResourceId Det valda användartilldelade identitetsresurs-ID:t som är associerat med IoT Hub. Detta krävs när authenticationType är UserAssigned. sträng

IpFilterRule

Namn Beskrivning Värde
handling Önskad åtgärd för begäranden som samlas in av den här regeln. "Acceptera"
"Avvisa" (krävs)
filterName Namnet på IP-filterregeln. sträng (krävs)
ipMask En sträng som innehåller IP-adressintervallet i CIDR-notationen för regeln. sträng (krävs)
mål Mål för begäranden som samlas in av den här regeln. "alla"
"deviceApi"
"serviceApi"

ManagedServiceIdentity

Namn Beskrivning Värde
typ Typ av hanterad tjänstidentitet (där både SystemAssigned- och UserAssigned-typer tillåts). "Ingen"
"SystemAssigned"
"SystemAssigned,UserAssigned"
"UserAssigned" (krävs)
userAssignedIdentities Uppsättningen användartilldelade identiteter som är associerade med resursen. Ordlistenycklarna userAssignedIdentities är ARM-resurs-ID:er i formuläret: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Ordlistevärdena kan vara tomma objekt ({}) i begäranden. UserAssignedIdentiteter

Microsoft.Devices/provisioningServices

Namn Beskrivning Värde
etag Fältet Etag är inte krävs. Om den anges i svarstexten måste den också anges som en rubrik enligt den normala ETag-konventionen. sträng
identitet Hanterade identiteter för en etableringstjänst. ManagedServiceIdentity
plats Resursplatsen. sträng (krävs)
Namn Resursnamnet sträng (krävs)
Egenskaper Tjänstspecifika egenskaper för en etableringstjänst IotDpsPropertiesDescription (krävs)
resourcegroup Resursgruppen. sträng
Sku SKU-information för en etableringstjänst. IotDpsSkuInfo (krävs)
subscriptionid Resursens prenumerations-ID. sträng
Taggar Resurstaggar Ordlista med taggnamn och värden. Se taggar i mallar

PrivateEndpoint

Namn Beskrivning Värde

PrivateEndpointConnection

Namn Beskrivning Värde
Egenskaper Egenskaperna för en privat slutpunktsanslutning PrivateEndpointConnectionProperties (krävs)

PrivateEndpointConnectionProperties

Namn Beskrivning Värde
privateEndpoint Egenskapen privat slutpunkt för en privat slutpunktsanslutning PrivateEndpoint
privateLinkServiceConnectionState Det aktuella tillståndet för en privat slutpunktsanslutning PrivateLinkServiceConnectionState (krävs)

PrivateLinkServiceConnectionState

Namn Beskrivning Värde
actionsRequired Åtgärder som krävs för en privat slutpunktsanslutning sträng
beskrivning Beskrivningen av det aktuella tillståndet för en privat slutpunktsanslutning sträng (krävs)
status Status för en privat slutpunktsanslutning "Godkänd"
"Frånkopplad"
"Väntar"
"Avvisad" (krävs)

ResourceTags

Namn Beskrivning Värde

SharedAccessSignatureAuthorizationRuleAccessRightsDescription

Namn Beskrivning Värde
keyName Namnet på nyckeln. sträng (krävs)
primaryKey Primärt SAS-nyckelvärde. sträng
rättigheter Rättigheter som den här nyckeln har. "DeviceConnect"
"EnrollmentRead"
"EnrollmentWrite"
"RegistrationStatusRead"
"RegistrationStatusWrite"
"ServiceConfig" (krävs)
secondaryKey Sekundärt SAS-nyckelvärde. sträng

UserAssignedIdentiteter

Namn Beskrivning Värde

UserAssignedIdentity

Namn Beskrivning Värde

Snabbstartsexempel

Följande snabbstartsexempel distribuerar den här resurstypen.

Bicep-fil Beskrivning
Skapa en IoT Hub Device Provisioning-tjänst Med den här mallen kan du skapa en IoT-hubb och en IoT Hub Device Provisioning-tjänst och länka ihop de två tjänsterna.

Resursdefinition för ARM-mall

Resurstypen provisioningServices kan distribueras med åtgärder som mål:

En lista över ändrade egenskaper i varje API-version finns i ändringsloggen.

Resursformat

Om du vill skapa en Microsoft.Devices/provisioningServices-resurs lägger du till följande JSON i mallen.

{
  "type": "Microsoft.Devices/provisioningServices",
  "apiVersion": "2025-02-01-preview",
  "name": "string",
  "etag": "string",
  "identity": {
    "type": "string",
    "userAssignedIdentities": {
      "{customized property}": {
      }
    }
  },
  "location": "string",
  "properties": {
    "allocationPolicy": "string",
    "authorizationPolicies": [
      {
        "keyName": "string",
        "primaryKey": "string",
        "rights": "string",
        "secondaryKey": "string"
      }
    ],
    "enableDataResidency": "bool",
    "iotHubs": [
      {
        "allocationWeight": "int",
        "applyAllocationPolicy": "bool",
        "authenticationType": "string",
        "connectionString": "string",
        "location": "string",
        "selectedUserAssignedIdentityResourceId": "string"
      }
    ],
    "ipFilterRules": [
      {
        "action": "string",
        "filterName": "string",
        "ipMask": "string",
        "target": "string"
      }
    ],
    "portalOperationsHostName": "string",
    "privateEndpointConnections": [
      {
        "properties": {
          "privateEndpoint": {
          },
          "privateLinkServiceConnectionState": {
            "actionsRequired": "string",
            "description": "string",
            "status": "string"
          }
        }
      }
    ],
    "provisioningState": "string",
    "publicNetworkAccess": "string",
    "state": "string"
  },
  "resourcegroup": "string",
  "sku": {
    "capacity": "int",
    "name": "string"
  },
  "subscriptionid": "string",
  "tags": {
    "{customized property}": "string"
  }
}

Egenskapsvärden

IotDpsPropertiesDescription

Namn Beskrivning Värde
allocationPolicy Allokeringsprincip som ska användas av den här etableringstjänsten. "GeoLatency"
"Hashed"
"Statisk"
authorizationPolicies Lista över auktoriseringsnycklar för en etableringstjänst. SharedAccessSignatureAuthorizationRuleAccessRightsDescription[]
enableDataResidency Valfri.
Anger om DPS-instansen har Data Residency aktiverat, vilket tar bort haveriberedskapen mellan geo-par.
Bool
iotHubs Lista över IoT-hubbar som är associerade med den här etableringstjänsten. IotHubDefinitionDescription[]
ipFilterRules IP-filterreglerna. IpFilterRule[]
portalOperationsHostName Portalslutpunkt för att aktivera CORS för den här etableringstjänsten. sträng
privateEndpointConnections Privata slutpunktsanslutningar som skapats på denna IotHub PrivateEndpointConnection[]
provisioningState ARM-etableringstillståndet för etableringstjänsten. sträng
publicNetworkAccess Om begäranden från offentliga nätverk tillåts "Inaktiverad"
"Aktiverad"
stat Etableringstjänstens aktuella tillstånd. "Aktivera"
"ActivationFailed"
"Aktiv"
"Borttaget"
"Ta bort"
"DeletionFailed"
"Redundans"
"FailoverFailed"
"Återuppta"
"Pausad"
"Pausa"
"Övergång"

IotDpsSkuInfo

Namn Beskrivning Värde
kapacitet Antalet enheter som ska etableras Int
Namn Sku-namn. "S1"

IotHubDefinitionDescription

Namn Beskrivning Värde
allocationWeight vikt för att ansöka om en given iot h. Int
applyAllocationPolicy flagga för att tillämpa allocationPolicy eller inte för en viss iot-hubb. Bool
authenticationType IotHub MI-autentiseringstyp: KeyBased, UserAssigned, SystemAssigned. "KeyBased"
"SystemAssigned"
"UserAssigned"
connectionString Anslutningssträng för IoT-hubben. sträng
plats ARM-regionen för IoT-hubben. sträng (krävs)
selectedUserAssignedIdentityResourceId Det valda användartilldelade identitetsresurs-ID:t som är associerat med IoT Hub. Detta krävs när authenticationType är UserAssigned. sträng

IpFilterRule

Namn Beskrivning Värde
handling Önskad åtgärd för begäranden som samlas in av den här regeln. "Acceptera"
"Avvisa" (krävs)
filterName Namnet på IP-filterregeln. sträng (krävs)
ipMask En sträng som innehåller IP-adressintervallet i CIDR-notationen för regeln. sträng (krävs)
mål Mål för begäranden som samlas in av den här regeln. "alla"
"deviceApi"
"serviceApi"

ManagedServiceIdentity

Namn Beskrivning Värde
typ Typ av hanterad tjänstidentitet (där både SystemAssigned- och UserAssigned-typer tillåts). "Ingen"
"SystemAssigned"
"SystemAssigned,UserAssigned"
"UserAssigned" (krävs)
userAssignedIdentities Uppsättningen användartilldelade identiteter som är associerade med resursen. Ordlistenycklarna userAssignedIdentities är ARM-resurs-ID:er i formuläret: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Ordlistevärdena kan vara tomma objekt ({}) i begäranden. UserAssignedIdentiteter

Microsoft.Devices/provisioningServices

Namn Beskrivning Värde
apiVersion API-versionen "2025-02-01-preview"
etag Fältet Etag är inte krävs. Om den anges i svarstexten måste den också anges som en rubrik enligt den normala ETag-konventionen. sträng
identitet Hanterade identiteter för en etableringstjänst. ManagedServiceIdentity
plats Resursplatsen. sträng (krävs)
Namn Resursnamnet sträng (krävs)
Egenskaper Tjänstspecifika egenskaper för en etableringstjänst IotDpsPropertiesDescription (krävs)
resourcegroup Resursgruppen. sträng
Sku SKU-information för en etableringstjänst. IotDpsSkuInfo (krävs)
subscriptionid Resursens prenumerations-ID. sträng
Taggar Resurstaggar Ordlista med taggnamn och värden. Se taggar i mallar
typ Resurstypen "Microsoft.Devices/provisioningServices"

PrivateEndpoint

Namn Beskrivning Värde

PrivateEndpointConnection

Namn Beskrivning Värde
Egenskaper Egenskaperna för en privat slutpunktsanslutning PrivateEndpointConnectionProperties (krävs)

PrivateEndpointConnectionProperties

Namn Beskrivning Värde
privateEndpoint Egenskapen privat slutpunkt för en privat slutpunktsanslutning PrivateEndpoint
privateLinkServiceConnectionState Det aktuella tillståndet för en privat slutpunktsanslutning PrivateLinkServiceConnectionState (krävs)

PrivateLinkServiceConnectionState

Namn Beskrivning Värde
actionsRequired Åtgärder som krävs för en privat slutpunktsanslutning sträng
beskrivning Beskrivningen av det aktuella tillståndet för en privat slutpunktsanslutning sträng (krävs)
status Status för en privat slutpunktsanslutning "Godkänd"
"Frånkopplad"
"Väntar"
"Avvisad" (krävs)

ResourceTags

Namn Beskrivning Värde

SharedAccessSignatureAuthorizationRuleAccessRightsDescription

Namn Beskrivning Värde
keyName Namnet på nyckeln. sträng (krävs)
primaryKey Primärt SAS-nyckelvärde. sträng
rättigheter Rättigheter som den här nyckeln har. "DeviceConnect"
"EnrollmentRead"
"EnrollmentWrite"
"RegistrationStatusRead"
"RegistrationStatusWrite"
"ServiceConfig" (krävs)
secondaryKey Sekundärt SAS-nyckelvärde. sträng

UserAssignedIdentiteter

Namn Beskrivning Värde

UserAssignedIdentity

Namn Beskrivning Värde

Snabbstartsmallar

Följande snabbstartsmallar distribuerar den här resurstypen.

Mall Beskrivning
Skapa en IOT Hub- och Ubuntu-kantsimulator

Distribuera till Azure
Den här mallen skapar en IOT Hub- och Virtual Machine Ubuntu edge-simulator.
Skapa en IoT Hub Device Provisioning-tjänst

Distribuera till Azure
Med den här mallen kan du skapa en IoT-hubb och en IoT Hub Device Provisioning-tjänst och länka ihop de två tjänsterna.

Resursdefinition för Terraform (AzAPI-provider)

Resurstypen provisioningServices kan distribueras med åtgärder som mål:

  • Resursgrupper

En lista över ändrade egenskaper i varje API-version finns i ändringsloggen.

Resursformat

Om du vill skapa en Microsoft.Devices/provisioningServices-resurs lägger du till följande Terraform i mallen.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Devices/provisioningServices@2025-02-01-preview"
  name = "string"
  etag = "string"
  identity = {
    type = "string"
    userAssignedIdentities = {
      {customized property} = {
      }
    }
  }
  location = "string"
  resourcegroup = "string"
  sku = {
    capacity = int
    name = "string"
  }
  subscriptionid = "string"
  tags = {
    {customized property} = "string"
  }
  body = jsonencode({
    properties = {
      allocationPolicy = "string"
      authorizationPolicies = [
        {
          keyName = "string"
          primaryKey = "string"
          rights = "string"
          secondaryKey = "string"
        }
      ]
      enableDataResidency = bool
      iotHubs = [
        {
          allocationWeight = int
          applyAllocationPolicy = bool
          authenticationType = "string"
          connectionString = "string"
          location = "string"
          selectedUserAssignedIdentityResourceId = "string"
        }
      ]
      ipFilterRules = [
        {
          action = "string"
          filterName = "string"
          ipMask = "string"
          target = "string"
        }
      ]
      portalOperationsHostName = "string"
      privateEndpointConnections = [
        {
          properties = {
            privateEndpoint = {
            }
            privateLinkServiceConnectionState = {
              actionsRequired = "string"
              description = "string"
              status = "string"
            }
          }
        }
      ]
      provisioningState = "string"
      publicNetworkAccess = "string"
      state = "string"
    }
  })
}

Egenskapsvärden

IotDpsPropertiesDescription

Namn Beskrivning Värde
allocationPolicy Allokeringsprincip som ska användas av den här etableringstjänsten. "GeoLatency"
"Hashed"
"Statisk"
authorizationPolicies Lista över auktoriseringsnycklar för en etableringstjänst. SharedAccessSignatureAuthorizationRuleAccessRightsDescription[]
enableDataResidency Valfri.
Anger om DPS-instansen har Data Residency aktiverat, vilket tar bort haveriberedskapen mellan geo-par.
Bool
iotHubs Lista över IoT-hubbar som är associerade med den här etableringstjänsten. IotHubDefinitionDescription[]
ipFilterRules IP-filterreglerna. IpFilterRule[]
portalOperationsHostName Portalslutpunkt för att aktivera CORS för den här etableringstjänsten. sträng
privateEndpointConnections Privata slutpunktsanslutningar som skapats på denna IotHub PrivateEndpointConnection[]
provisioningState ARM-etableringstillståndet för etableringstjänsten. sträng
publicNetworkAccess Om begäranden från offentliga nätverk tillåts "Inaktiverad"
"Aktiverad"
stat Etableringstjänstens aktuella tillstånd. "Aktivera"
"ActivationFailed"
"Aktiv"
"Borttaget"
"Ta bort"
"DeletionFailed"
"Redundans"
"FailoverFailed"
"Återuppta"
"Pausad"
"Pausa"
"Övergång"

IotDpsSkuInfo

Namn Beskrivning Värde
kapacitet Antalet enheter som ska etableras Int
Namn Sku-namn. "S1"

IotHubDefinitionDescription

Namn Beskrivning Värde
allocationWeight vikt för att ansöka om en given iot h. Int
applyAllocationPolicy flagga för att tillämpa allocationPolicy eller inte för en viss iot-hubb. Bool
authenticationType IotHub MI-autentiseringstyp: KeyBased, UserAssigned, SystemAssigned. "KeyBased"
"SystemAssigned"
"UserAssigned"
connectionString Anslutningssträng för IoT-hubben. sträng
plats ARM-regionen för IoT-hubben. sträng (krävs)
selectedUserAssignedIdentityResourceId Det valda användartilldelade identitetsresurs-ID:t som är associerat med IoT Hub. Detta krävs när authenticationType är UserAssigned. sträng

IpFilterRule

Namn Beskrivning Värde
handling Önskad åtgärd för begäranden som samlas in av den här regeln. "Acceptera"
"Avvisa" (krävs)
filterName Namnet på IP-filterregeln. sträng (krävs)
ipMask En sträng som innehåller IP-adressintervallet i CIDR-notationen för regeln. sträng (krävs)
mål Mål för begäranden som samlas in av den här regeln. "alla"
"deviceApi"
"serviceApi"

ManagedServiceIdentity

Namn Beskrivning Värde
typ Typ av hanterad tjänstidentitet (där både SystemAssigned- och UserAssigned-typer tillåts). "Ingen"
"SystemAssigned"
"SystemAssigned,UserAssigned"
"UserAssigned" (krävs)
userAssignedIdentities Uppsättningen användartilldelade identiteter som är associerade med resursen. Ordlistenycklarna userAssignedIdentities är ARM-resurs-ID:er i formuläret: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Ordlistevärdena kan vara tomma objekt ({}) i begäranden. UserAssignedIdentiteter

Microsoft.Devices/provisioningServices

Namn Beskrivning Värde
etag Fältet Etag är inte krävs. Om den anges i svarstexten måste den också anges som en rubrik enligt den normala ETag-konventionen. sträng
identitet Hanterade identiteter för en etableringstjänst. ManagedServiceIdentity
plats Resursplatsen. sträng (krävs)
Namn Resursnamnet sträng (krävs)
Egenskaper Tjänstspecifika egenskaper för en etableringstjänst IotDpsPropertiesDescription (krävs)
resourcegroup Resursgruppen. sträng
Sku SKU-information för en etableringstjänst. IotDpsSkuInfo (krävs)
subscriptionid Resursens prenumerations-ID. sträng
Taggar Resurstaggar Ordlista med taggnamn och värden.
typ Resurstypen "Microsoft.Devices/provisioningServices@2025-02-01-preview"

PrivateEndpoint

Namn Beskrivning Värde

PrivateEndpointConnection

Namn Beskrivning Värde
Egenskaper Egenskaperna för en privat slutpunktsanslutning PrivateEndpointConnectionProperties (krävs)

PrivateEndpointConnectionProperties

Namn Beskrivning Värde
privateEndpoint Egenskapen privat slutpunkt för en privat slutpunktsanslutning PrivateEndpoint
privateLinkServiceConnectionState Det aktuella tillståndet för en privat slutpunktsanslutning PrivateLinkServiceConnectionState (krävs)

PrivateLinkServiceConnectionState

Namn Beskrivning Värde
actionsRequired Åtgärder som krävs för en privat slutpunktsanslutning sträng
beskrivning Beskrivningen av det aktuella tillståndet för en privat slutpunktsanslutning sträng (krävs)
status Status för en privat slutpunktsanslutning "Godkänd"
"Frånkopplad"
"Väntar"
"Avvisad" (krävs)

ResourceTags

Namn Beskrivning Värde

SharedAccessSignatureAuthorizationRuleAccessRightsDescription

Namn Beskrivning Värde
keyName Namnet på nyckeln. sträng (krävs)
primaryKey Primärt SAS-nyckelvärde. sträng
rättigheter Rättigheter som den här nyckeln har. "DeviceConnect"
"EnrollmentRead"
"EnrollmentWrite"
"RegistrationStatusRead"
"RegistrationStatusWrite"
"ServiceConfig" (krävs)
secondaryKey Sekundärt SAS-nyckelvärde. sträng

UserAssignedIdentiteter

Namn Beskrivning Värde

UserAssignedIdentity

Namn Beskrivning Värde