Partilhar via

Microsoft.Devices provisioningServices 2025-02-01-preview

  • Artigo

Definição de recursos do bíceps

O tipo de recurso provisioningServices pode ser implantado com operações que visam:

Para obter uma lista de propriedades alteradas em cada versão da API, consulte log de alterações.

Formato do recurso

Para criar um recurso Microsoft.Devices/provisioningServices, adicione o seguinte Bicep ao seu modelo.

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

Valores de propriedade

IotDpsPropertiesDescrição

Designação Descrição Valor
alocaçãoPolítica Política de alocação a ser usada por este serviço de provisionamento. 'GeoLatência'
'Hashed'
'Estática'
authorizationPolíticas Lista de chaves de autorização para um serviço de provisionamento. SharedAccessSignatureAuthorizationRuleAccessRightsDescrição[]
enableDataResidency Opcional.
Indica se a instância do DPS tem a Residência de Dados habilitada, removendo a recuperação de desastres entre pares geográficos.		 Bool
iotHubs Lista de hubs IoT associados a este serviço de provisionamento. IotHubDefinitionDescription[]
ipFilterRules As regras de filtro IP. IpFilterRule[]
portalOperationsHostName Ponto de extremidade do portal para habilitar o CORS para esse serviço de provisionamento. string
privateEndpointConnections Conexões de ponto de extremidade privadas criadas neste IotHub PrivateEndpointConnection []
provisionamentoEstado O estado de provisionamento ARM do serviço de provisionamento. string
publicNetworkAccess Se as solicitações da Rede Pública são permitidas 'Desativado'
'Habilitado'
Estado Estado atual do serviço de provisionamento. 'Ativação'
'Ativação falhou'
'Ativo'
«Suprimido»
'Eliminação'
'Falha na exclusão'
'FailingOver'
'FailoverFailed'
'Retomada'
'Suspenso'
'Suspensão'
'Transição'

IotDpsSkuInfo

Designação Descrição Valor
capacidade O número de unidades a provisionar Int
Designação Nome Sku. «S1»

IotHubDefiniçãoDescrição

Designação Descrição Valor
alocaçãoPeso peso para aplicar para um determinado iot h. Int
applyAllocationPolicy sinalizador para aplicar allocationPolicy ou não para um determinado hub iot. Bool
authenticationType Tipo de autenticação IotHub MI: KeyBased, UserAssigned, SystemAssigned. 'Baseado em chaves'
'SystemAssigned'
'UserAssigned'
connectionString Cadeia de conexão do hub IoT. string
Localização Região ARM do hub IoT. string (obrigatório)
selectedUserAssignedIdentityResourceId O ID do recurso de identidade atribuído pelo usuário selecionado associado ao Hub IoT. Isso é necessário quando authenticationType é UserAssigned. string

IpFilterRule

Designação Descrição Valor
ação A ação desejada para solicitações capturadas por esta regra. 'Aceitar'
«Rejeitar» (obrigatório)
filterName O nome da regra de filtro IP. string (obrigatório)
ipMask Uma cadeia de caracteres que contém o intervalo de endereços IP na notação CIDR para a regra. string (obrigatório)
público-alvo Destino para solicitações capturadas por esta regra. 'todos'
'deviceApi'
'ServiceApi'

ManagedServiceIdentity

Designação Descrição Valor
tipo Tipo de identidade de serviço gerenciado (onde os tipos SystemAssigned e UserAssigned são permitidos). 'Nenhuma'
'SystemAssigned'
'SystemAssigned,UserAssigned'
'UserAssigned' (obrigatório)
userAssignedIdentities O conjunto de identidades atribuídas pelo usuário associadas ao recurso. As chaves do dicionário userAssignedIdentities serão ids de recurso ARM no formato: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Os valores de dicionário podem ser objetos vazios ({}) em solicitações. UserAssignedIdentities

Microsoft.Devices/provisioningServices

Designação Descrição Valor
etag O campo Etag não é obrigatório. Se for fornecido no corpo da resposta, também deve ser fornecido como um cabeçalho de acordo com a convenção ETag normal. string
identidade As identidades gerenciadas para um serviço de provisionamento. ManagedServiceIdentity
Localização A localização do recurso. string (obrigatório)
Designação O nome do recurso string (obrigatório)
propriedades Propriedades específicas do serviço para um serviço de provisionamento IotDpsPropertiesDescription (obrigatório)
grupo de recursos O grupo de recursos do recurso. string
SKU Informações de sku para um serviço de provisionamento. IotDpsSkuInfo (obrigatório)
ID de subscrição A ID de assinatura do recurso. string
Etiquetas Tags de recursos Dicionário de nomes e valores de tags. Consulte Tags em modelos

PrivateEndpoint

Designação Descrição Valor

PrivateEndpointConnection

Designação Descrição Valor
propriedades As propriedades de uma conexão de ponto de extremidade privada PrivateEndpointConnectionProperties (obrigatório)

PrivateEndpointConnectionProperties

Designação Descrição Valor
privateEndpoint A propriedade de ponto de extremidade privado de uma conexão de ponto de extremidade privada PrivateEndpoint
privateLinkServiceConnectionState O estado atual de uma conexão de ponto de extremidade privado PrivateLinkServiceConnectionState (obrigatório)

PrivateLinkServiceConnectionState

Designação Descrição Valor
açõesObrigatório Ações necessárias para uma conexão de ponto de extremidade privada string
Descrição A descrição do estado atual de uma conexão de ponto de extremidade privada string (obrigatório)
Situação O status de uma conexão de ponto de extremidade privada 'Aprovado'
'Desconectado'
'Pendente'
«Rejeitado» (obrigatório)

Tags de Recursos

Designação Descrição Valor

SharedAccessSignatureAuthorizationRuleAccessRightsDescrição

Designação Descrição Valor
Nome da chave Nome da chave. string (obrigatório)
primárioChave Valor da chave SAS primária. string
Direitos Direitos que esta chave tem. 'DeviceConnect'
'InscriçãoLer'
'EnrollmentWrite'
'RegistrationStatusRead'
'RegistrationStatusWrite'
'ServiceConfig' (obrigatório)
secundário Valor da chave SAS secundária. string

UserAssignedIdentities

Designação Descrição Valor

UserAssignedIdentity

Designação Descrição Valor

Exemplos de início rápido

Os exemplos de início rápido a seguir implantam esse tipo de recurso.

Arquivo Bicep Descrição
Criar um Serviço de Provisionamento de Dispositivo do Hub IoT Este modelo permite criar um hub IoT e um Serviço de Provisionamento de Dispositivo do Hub IoT e vincular os dois serviços.

Definição de recurso de modelo ARM

O tipo de recurso provisioningServices pode ser implantado com operações que visam:

Para obter uma lista de propriedades alteradas em cada versão da API, consulte log de alterações.

Formato do recurso

Para criar um recurso Microsoft.Devices/provisioningServices, adicione o seguinte JSON ao seu modelo.

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

Valores de propriedade

IotDpsPropertiesDescrição

Designação Descrição Valor
alocaçãoPolítica Política de alocação a ser usada por este serviço de provisionamento. 'GeoLatência'
'Hashed'
'Estática'
authorizationPolíticas Lista de chaves de autorização para um serviço de provisionamento. SharedAccessSignatureAuthorizationRuleAccessRightsDescrição[]
enableDataResidency Opcional.
Indica se a instância do DPS tem a Residência de Dados habilitada, removendo a recuperação de desastres entre pares geográficos.		 Bool
iotHubs Lista de hubs IoT associados a este serviço de provisionamento. IotHubDefinitionDescription[]
ipFilterRules As regras de filtro IP. IpFilterRule[]
portalOperationsHostName Ponto de extremidade do portal para habilitar o CORS para esse serviço de provisionamento. string
privateEndpointConnections Conexões de ponto de extremidade privadas criadas neste IotHub PrivateEndpointConnection []
provisionamentoEstado O estado de provisionamento ARM do serviço de provisionamento. string
publicNetworkAccess Se as solicitações da Rede Pública são permitidas 'Desativado'
'Habilitado'
Estado Estado atual do serviço de provisionamento. 'Ativação'
'Ativação falhou'
'Ativo'
«Suprimido»
'Eliminação'
'Falha na exclusão'
'FailingOver'
'FailoverFailed'
'Retomada'
'Suspenso'
'Suspensão'
'Transição'

IotDpsSkuInfo

Designação Descrição Valor
capacidade O número de unidades a provisionar Int
Designação Nome Sku. «S1»

IotHubDefiniçãoDescrição

Designação Descrição Valor
alocaçãoPeso peso para aplicar para um determinado iot h. Int
applyAllocationPolicy sinalizador para aplicar allocationPolicy ou não para um determinado hub iot. Bool
authenticationType Tipo de autenticação IotHub MI: KeyBased, UserAssigned, SystemAssigned. 'Baseado em chaves'
'SystemAssigned'
'UserAssigned'
connectionString Cadeia de conexão do hub IoT. string
Localização Região ARM do hub IoT. string (obrigatório)
selectedUserAssignedIdentityResourceId O ID do recurso de identidade atribuído pelo usuário selecionado associado ao Hub IoT. Isso é necessário quando authenticationType é UserAssigned. string

IpFilterRule

Designação Descrição Valor
ação A ação desejada para solicitações capturadas por esta regra. 'Aceitar'
«Rejeitar» (obrigatório)
filterName O nome da regra de filtro IP. string (obrigatório)
ipMask Uma cadeia de caracteres que contém o intervalo de endereços IP na notação CIDR para a regra. string (obrigatório)
público-alvo Destino para solicitações capturadas por esta regra. 'todos'
'deviceApi'
'ServiceApi'

ManagedServiceIdentity

Designação Descrição Valor
tipo Tipo de identidade de serviço gerenciado (onde os tipos SystemAssigned e UserAssigned são permitidos). 'Nenhuma'
'SystemAssigned'
'SystemAssigned,UserAssigned'
'UserAssigned' (obrigatório)
userAssignedIdentities O conjunto de identidades atribuídas pelo usuário associadas ao recurso. As chaves do dicionário userAssignedIdentities serão ids de recurso ARM no formato: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Os valores de dicionário podem ser objetos vazios ({}) em solicitações. UserAssignedIdentities

Microsoft.Devices/provisioningServices

Designação Descrição Valor
apiVersion A versão api '2025-02-01-pré-visualização'
etag O campo Etag não é obrigatório. Se for fornecido no corpo da resposta, também deve ser fornecido como um cabeçalho de acordo com a convenção ETag normal. string
identidade As identidades gerenciadas para um serviço de provisionamento. ManagedServiceIdentity
Localização A localização do recurso. string (obrigatório)
Designação O nome do recurso string (obrigatório)
propriedades Propriedades específicas do serviço para um serviço de provisionamento IotDpsPropertiesDescription (obrigatório)
grupo de recursos O grupo de recursos do recurso. string
SKU Informações de sku para um serviço de provisionamento. IotDpsSkuInfo (obrigatório)
ID de subscrição A ID de assinatura do recurso. string
Etiquetas Tags de recursos Dicionário de nomes e valores de tags. Consulte Tags em modelos
tipo O tipo de recurso 'Microsoft.Devices/provisioningServices'

PrivateEndpoint

Designação Descrição Valor

PrivateEndpointConnection

Designação Descrição Valor
propriedades As propriedades de uma conexão de ponto de extremidade privada PrivateEndpointConnectionProperties (obrigatório)

PrivateEndpointConnectionProperties

Designação Descrição Valor
privateEndpoint A propriedade de ponto de extremidade privado de uma conexão de ponto de extremidade privada PrivateEndpoint
privateLinkServiceConnectionState O estado atual de uma conexão de ponto de extremidade privado PrivateLinkServiceConnectionState (obrigatório)

PrivateLinkServiceConnectionState

Designação Descrição Valor
açõesObrigatório Ações necessárias para uma conexão de ponto de extremidade privada string
Descrição A descrição do estado atual de uma conexão de ponto de extremidade privada string (obrigatório)
Situação O status de uma conexão de ponto de extremidade privada 'Aprovado'
'Desconectado'
'Pendente'
«Rejeitado» (obrigatório)

Tags de Recursos

Designação Descrição Valor

SharedAccessSignatureAuthorizationRuleAccessRightsDescrição

Designação Descrição Valor
Nome da chave Nome da chave. string (obrigatório)
primárioChave Valor da chave SAS primária. string
Direitos Direitos que esta chave tem. 'DeviceConnect'
'InscriçãoLer'
'EnrollmentWrite'
'RegistrationStatusRead'
'RegistrationStatusWrite'
'ServiceConfig' (obrigatório)
secundário Valor da chave SAS secundária. string

UserAssignedIdentities

Designação Descrição Valor

UserAssignedIdentity

Designação Descrição Valor

Modelos de início rápido

Os modelos de início rápido a seguir implantam esse tipo de recurso.

Modelo Descrição
Crie um Hub IOT e um simulador de borda do Ubuntu

Implantar no Azure 		Este modelo cria um Hub IOT e um simulador de borda Ubuntu de máquina virtual.
Criar um Serviço de Provisionamento de Dispositivo do Hub IoT

Implantar no Azure 		Este modelo permite criar um hub IoT e um Serviço de Provisionamento de Dispositivo do Hub IoT e vincular os dois serviços.

Definição de recursos Terraform (provedor AzAPI)

O tipo de recurso provisioningServices pode ser implantado com operações que visam:

  • Grupos de recursos

Para obter uma lista de propriedades alteradas em cada versão da API, consulte log de alterações.

Formato do recurso

Para criar um recurso Microsoft.Devices/provisioningServices, adicione o seguinte Terraform ao seu modelo.

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

Valores de propriedade

IotDpsPropertiesDescrição

Designação Descrição Valor
alocaçãoPolítica Política de alocação a ser usada por este serviço de provisionamento. 'GeoLatência'
'Hashed'
'Estática'
authorizationPolíticas Lista de chaves de autorização para um serviço de provisionamento. SharedAccessSignatureAuthorizationRuleAccessRightsDescrição[]
enableDataResidency Opcional.
Indica se a instância do DPS tem a Residência de Dados habilitada, removendo a recuperação de desastres entre pares geográficos.		 Bool
iotHubs Lista de hubs IoT associados a este serviço de provisionamento. IotHubDefinitionDescription[]
ipFilterRules As regras de filtro IP. IpFilterRule[]
portalOperationsHostName Ponto de extremidade do portal para habilitar o CORS para esse serviço de provisionamento. string
privateEndpointConnections Conexões de ponto de extremidade privadas criadas neste IotHub PrivateEndpointConnection []
provisionamentoEstado O estado de provisionamento ARM do serviço de provisionamento. string
publicNetworkAccess Se as solicitações da Rede Pública são permitidas 'Desativado'
'Habilitado'
Estado Estado atual do serviço de provisionamento. 'Ativação'
'Ativação falhou'
'Ativo'
«Suprimido»
'Eliminação'
'Falha na exclusão'
'FailingOver'
'FailoverFailed'
'Retomada'
'Suspenso'
'Suspensão'
'Transição'

IotDpsSkuInfo

Designação Descrição Valor
capacidade O número de unidades a provisionar Int
Designação Nome Sku. «S1»

IotHubDefiniçãoDescrição

Designação Descrição Valor
alocaçãoPeso peso para aplicar para um determinado iot h. Int
applyAllocationPolicy sinalizador para aplicar allocationPolicy ou não para um determinado hub iot. Bool
authenticationType Tipo de autenticação IotHub MI: KeyBased, UserAssigned, SystemAssigned. 'Baseado em chaves'
'SystemAssigned'
'UserAssigned'
connectionString Cadeia de conexão do hub IoT. string
Localização Região ARM do hub IoT. string (obrigatório)
selectedUserAssignedIdentityResourceId O ID do recurso de identidade atribuído pelo usuário selecionado associado ao Hub IoT. Isso é necessário quando authenticationType é UserAssigned. string

IpFilterRule

Designação Descrição Valor
ação A ação desejada para solicitações capturadas por esta regra. 'Aceitar'
«Rejeitar» (obrigatório)
filterName O nome da regra de filtro IP. string (obrigatório)
ipMask Uma cadeia de caracteres que contém o intervalo de endereços IP na notação CIDR para a regra. string (obrigatório)
público-alvo Destino para solicitações capturadas por esta regra. 'todos'
'deviceApi'
'ServiceApi'

ManagedServiceIdentity

Designação Descrição Valor
tipo Tipo de identidade de serviço gerenciado (onde os tipos SystemAssigned e UserAssigned são permitidos). 'Nenhuma'
'SystemAssigned'
'SystemAssigned,UserAssigned'
'UserAssigned' (obrigatório)
userAssignedIdentities O conjunto de identidades atribuídas pelo usuário associadas ao recurso. As chaves do dicionário userAssignedIdentities serão ids de recurso ARM no formato: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Os valores de dicionário podem ser objetos vazios ({}) em solicitações. UserAssignedIdentities

Microsoft.Devices/provisioningServices

Designação Descrição Valor
etag O campo Etag não é obrigatório. Se for fornecido no corpo da resposta, também deve ser fornecido como um cabeçalho de acordo com a convenção ETag normal. string
identidade As identidades gerenciadas para um serviço de provisionamento. ManagedServiceIdentity
Localização A localização do recurso. string (obrigatório)
Designação O nome do recurso string (obrigatório)
propriedades Propriedades específicas do serviço para um serviço de provisionamento IotDpsPropertiesDescription (obrigatório)
grupo de recursos O grupo de recursos do recurso. string
SKU Informações de sku para um serviço de provisionamento. IotDpsSkuInfo (obrigatório)
ID de subscrição A ID de assinatura do recurso. string
Etiquetas Tags de recursos Dicionário de nomes e valores de tags.
tipo O tipo de recurso "Microsoft.Devices/provisioningServices@2025-02-01-pré-visualização"

PrivateEndpoint

Designação Descrição Valor

PrivateEndpointConnection

Designação Descrição Valor
propriedades As propriedades de uma conexão de ponto de extremidade privada PrivateEndpointConnectionProperties (obrigatório)

PrivateEndpointConnectionProperties

Designação Descrição Valor
privateEndpoint A propriedade de ponto de extremidade privado de uma conexão de ponto de extremidade privada PrivateEndpoint
privateLinkServiceConnectionState O estado atual de uma conexão de ponto de extremidade privado PrivateLinkServiceConnectionState (obrigatório)

PrivateLinkServiceConnectionState

Designação Descrição Valor
açõesObrigatório Ações necessárias para uma conexão de ponto de extremidade privada string
Descrição A descrição do estado atual de uma conexão de ponto de extremidade privada string (obrigatório)
Situação O status de uma conexão de ponto de extremidade privada 'Aprovado'
'Desconectado'
'Pendente'
«Rejeitado» (obrigatório)

Tags de Recursos

Designação Descrição Valor

SharedAccessSignatureAuthorizationRuleAccessRightsDescrição

Designação Descrição Valor
Nome da chave Nome da chave. string (obrigatório)
primárioChave Valor da chave SAS primária. string
Direitos Direitos que esta chave tem. 'DeviceConnect'
'InscriçãoLer'
'EnrollmentWrite'
'RegistrationStatusRead'
'RegistrationStatusWrite'
'ServiceConfig' (obrigatório)
secundário Valor da chave SAS secundária. string

UserAssignedIdentities

Designação Descrição Valor

UserAssignedIdentity

Designação Descrição Valor