Compartilhar via


Contas Microsoft.DeviceUpdate

Definição de recurso do Bicep

O tipo de recurso de contas pode ser implantado com operações direcionadas:

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

Formato de recurso

Para criar um recurso Microsoft.DeviceUpdate/accounts, adicione o Bicep a seguir ao seu modelo.

resource symbolicname 'Microsoft.DeviceUpdate/accounts@2023-07-01' = {
  scope: resourceSymbolicName or scope
  identity: {
    type: 'string'
    userAssignedIdentities: {
      {customized property}: {}
    }
  }
  location: 'string'
  name: 'string'
  properties: {
    encryption: {
      keyVaultKeyUri: 'string'
      userAssignedIdentity: 'string'
    }
    privateEndpointConnections: [
      {
        properties: {
          groupIds: [
            'string'
          ]
          privateEndpoint: {}
          privateLinkServiceConnectionState: {
            actionsRequired: 'string'
            description: 'string'
            status: 'string'
          }
        }
      }
    ]
    publicNetworkAccess: 'string'
    sku: 'string'
  }
  tags: {
    {customized property}: 'string'
  }
}

Valores de propriedade

Microsoft.DeviceUpdate/accounts

Nome Descrição Valor
identidade O tipo de identidade usado para o recurso. ManagedServiceIdentity
local A localização geográfica onde o recurso reside cadeia de caracteres (obrigatório)
nome O nome do recurso corda

Restrições:
Comprimento mínimo = 3
Comprimento máximo = 24
Padrão = ^[A-Za-z0-9]+(-[A-Za-z0-9]+)*$ (obrigatório)
Propriedades Propriedades da conta de Atualização de Dispositivo. Propriedades da conta
escopo Use ao criar um recurso em um escopo diferente do escopo de implantação. Defina essa propriedade como o nome simbólico de um recurso para aplicar o recurso de extensão .
Tags Marcas de recurso Dicionário de nomes e valores de marca. Consulte Marcas em modelos

Propriedades da conta

Nome Descrição Valor
criptografia Criptografia cmk em propriedades rest Encriptação
conexões de ponto de extremidade privado Lista de conexões de ponto de extremidade privado associadas à conta. PrivateEndpointConnection []
públicoAcessoRedeAcesso Se o acesso à rede pública é permitido ou não para a conta. 'Desabilitado'
'Habilitado'
Sku SKU de Atualização de Dispositivo 'Gratuito'
'Padrão'

Encriptação

Nome Descrição Valor
keyVaultKeyUri O URI do cofre de chaves cadeia
identidade atribuída pelo usuário A resourceId completa da identidade atribuída pelo usuário a ser usada para acesso ao cofre de chaves. A identidade também deve ser atribuída à Conta cadeia

ManagedServiceIdentity

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

Ponto de extremidade privado

Nome Descrição Valor

Conexão PrivateEndpointConnection

Nome Descrição Valor
Propriedades Propriedades do recurso. PrivateEndpointConnectionProperties (obrigatório)

Propriedades de conexão de ponto de extremidade privado

Nome Descrição Valor
IDs de grupo Matriz de IDs de grupo. cadeia de caracteres[]
privateEndpoint O recurso do ponto de extremidade privado. PrivateEndpoint
privateLinkServiceConnectionState Uma coleção de informações sobre o estado da conexão entre o consumidor de serviço e o provedor. PrivateLinkServiceConnectionState (obrigatório)

PrivateLinkServiceConnectionState

Nome Descrição Valor
açõesObrigatório Uma mensagem que indica se as alterações no provedor de serviços exigem atualizações no consumidor. cadeia
descrição O motivo da aprovação/rejeição da conexão. cadeia
status Indica se a conexão foi aprovada/rejeitada/removida pelo proprietário do serviço. 'Aprovado'
'Pendente'
'Rejeitado'

TrackedResourceTags

Nome Descrição Valor

UserAssignedIdentities

Nome Descrição Valor

UserAssignedIdentity

Nome Descrição Valor

Exemplos de uso

Exemplos de Início Rápido do Azure

Os modelos de Início Rápido do Azure a seguir contêm exemplos de Bicep para implantar esse tipo de recurso.

Arquivo Bicep Descrição
Criar atualização de dispositivo para de conta do Hub IoT Esse modelo cria uma conta que fornece registro DNS público e permite fazer chamadas à API REST para o Plano de Dados. Em seguida, o usuário precisa criar uma instância na conta e vinculá-la a um Hub IoT para começar a usar o serviço.
Criar Atualização de Dispositivo para a conta do Hub IoT, instância, Hub IoT Esse modelo cria uma conta, uma instância e um hub para vincular a instância. Ele configura o hub com as políticas de acesso, as rotas e o grupo de consumidores necessários.

Definição de recurso de modelo do ARM

O tipo de recurso de contas pode ser implantado com operações direcionadas:

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

Formato de recurso

Para criar um recurso Microsoft.DeviceUpdate/accounts, adicione o JSON a seguir ao modelo.

{
  "type": "Microsoft.DeviceUpdate/accounts",
  "apiVersion": "2023-07-01",
  "name": "string",
  "identity": {
    "type": "string",
    "userAssignedIdentities": {
      "{customized property}": {
      }
    }
  },
  "location": "string",
  "properties": {
    "encryption": {
      "keyVaultKeyUri": "string",
      "userAssignedIdentity": "string"
    },
    "privateEndpointConnections": [
      {
        "properties": {
          "groupIds": [ "string" ],
          "privateEndpoint": {
          },
          "privateLinkServiceConnectionState": {
            "actionsRequired": "string",
            "description": "string",
            "status": "string"
          }
        }
      }
    ],
    "publicNetworkAccess": "string",
    "sku": "string"
  },
  "tags": {
    "{customized property}": "string"
  }
}

Valores de propriedade

Microsoft.DeviceUpdate/accounts

Nome Descrição Valor
apiVersion A versão da API '2023-07-01'
identidade O tipo de identidade usado para o recurso. ManagedServiceIdentity
local A localização geográfica onde o recurso reside cadeia de caracteres (obrigatório)
nome O nome do recurso corda

Restrições:
Comprimento mínimo = 3
Comprimento máximo = 24
Padrão = ^[A-Za-z0-9]+(-[A-Za-z0-9]+)*$ (obrigatório)
Propriedades Propriedades da conta de Atualização de Dispositivo. Propriedades da conta
Tags Marcas de recurso Dicionário de nomes e valores de marca. Consulte Marcas em modelos
tipo O tipo de recurso 'Microsoft.DeviceUpdate/accounts'

Propriedades da conta

Nome Descrição Valor
criptografia Criptografia cmk em propriedades rest Encriptação
conexões de ponto de extremidade privado Lista de conexões de ponto de extremidade privado associadas à conta. PrivateEndpointConnection []
públicoAcessoRedeAcesso Se o acesso à rede pública é permitido ou não para a conta. 'Desabilitado'
'Habilitado'
Sku SKU de Atualização de Dispositivo 'Gratuito'
'Padrão'

Encriptação

Nome Descrição Valor
keyVaultKeyUri O URI do cofre de chaves cadeia
identidade atribuída pelo usuário A resourceId completa da identidade atribuída pelo usuário a ser usada para acesso ao cofre de chaves. A identidade também deve ser atribuída à Conta cadeia

ManagedServiceIdentity

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

Ponto de extremidade privado

Nome Descrição Valor

Conexão PrivateEndpointConnection

Nome Descrição Valor
Propriedades Propriedades do recurso. PrivateEndpointConnectionProperties (obrigatório)

Propriedades de conexão de ponto de extremidade privado

Nome Descrição Valor
IDs de grupo Matriz de IDs de grupo. cadeia de caracteres[]
privateEndpoint O recurso do ponto de extremidade privado. PrivateEndpoint
privateLinkServiceConnectionState Uma coleção de informações sobre o estado da conexão entre o consumidor de serviço e o provedor. PrivateLinkServiceConnectionState (obrigatório)

PrivateLinkServiceConnectionState

Nome Descrição Valor
açõesObrigatório Uma mensagem que indica se as alterações no provedor de serviços exigem atualizações no consumidor. cadeia
descrição O motivo da aprovação/rejeição da conexão. cadeia
status Indica se a conexão foi aprovada/rejeitada/removida pelo proprietário do serviço. 'Aprovado'
'Pendente'
'Rejeitado'

TrackedResourceTags

Nome Descrição Valor

UserAssignedIdentities

Nome Descrição Valor

UserAssignedIdentity

Nome Descrição Valor

Exemplos de uso

Modelos de Início Rápido do Azure

Os modelos de Início Rápido do Azure a seguir implantar esse tipo de recurso.

Modelo Descrição
Criar atualização de dispositivo para de conta do Hub IoT

Implantar no Azure
Esse modelo cria uma conta que fornece registro DNS público e permite fazer chamadas à API REST para o Plano de Dados. Em seguida, o usuário precisa criar uma instância na conta e vinculá-la a um Hub IoT para começar a usar o serviço.
Criar Atualização de Dispositivo para a conta do Hub IoT, instância, Hub IoT

Implantar no Azure
Esse modelo cria uma conta, uma instância e um hub para vincular a instância. Ele configura o hub com as políticas de acesso, as rotas e o grupo de consumidores necessários.

Definição de recurso do Terraform (provedor de AzAPI)

O tipo de recurso de contas pode ser implantado com operações direcionadas:

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

Formato de recurso

Para criar um recurso Microsoft.DeviceUpdate/accounts, adicione o Terraform a seguir ao seu modelo.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.DeviceUpdate/accounts@2023-07-01"
  name = "string"
  parent_id = "string"
  identity {
    type = "string"
    identity_ids = [
      "string"
    ]
  }
  location = "string"
  tags = {
    {customized property} = "string"
  }
  body = {
    properties = {
      encryption = {
        keyVaultKeyUri = "string"
        userAssignedIdentity = "string"
      }
      privateEndpointConnections = [
        {
          properties = {
            groupIds = [
              "string"
            ]
            privateEndpoint = {
            }
            privateLinkServiceConnectionState = {
              actionsRequired = "string"
              description = "string"
              status = "string"
            }
          }
        }
      ]
      publicNetworkAccess = "string"
      sku = "string"
    }
  }
}

Valores de propriedade

Microsoft.DeviceUpdate/accounts

Nome Descrição Valor
identidade O tipo de identidade usado para o recurso. ManagedServiceIdentity
local A localização geográfica onde o recurso reside cadeia de caracteres (obrigatório)
nome O nome do recurso corda

Restrições:
Comprimento mínimo = 3
Comprimento máximo = 24
Padrão = ^[A-Za-z0-9]+(-[A-Za-z0-9]+)*$ (obrigatório)
parent_id A ID do recurso ao qual aplicar esse recurso de extensão. cadeia de caracteres (obrigatório)
Propriedades Propriedades da conta de Atualização de Dispositivo. Propriedades da conta
Tags Marcas de recurso Dicionário de nomes e valores de marca.
tipo O tipo de recurso "Microsoft.DeviceUpdate/accounts@2023-07-01"

Propriedades da conta

Nome Descrição Valor
criptografia Criptografia cmk em propriedades rest Encriptação
conexões de ponto de extremidade privado Lista de conexões de ponto de extremidade privado associadas à conta. PrivateEndpointConnection []
públicoAcessoRedeAcesso Se o acesso à rede pública é permitido ou não para a conta. 'Desabilitado'
'Habilitado'
Sku SKU de Atualização de Dispositivo 'Gratuito'
'Padrão'

Encriptação

Nome Descrição Valor
keyVaultKeyUri O URI do cofre de chaves cadeia
identidade atribuída pelo usuário A resourceId completa da identidade atribuída pelo usuário a ser usada para acesso ao cofre de chaves. A identidade também deve ser atribuída à Conta cadeia

ManagedServiceIdentity

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

Ponto de extremidade privado

Nome Descrição Valor

Conexão PrivateEndpointConnection

Nome Descrição Valor
Propriedades Propriedades do recurso. PrivateEndpointConnectionProperties (obrigatório)

Propriedades de conexão de ponto de extremidade privado

Nome Descrição Valor
IDs de grupo Matriz de IDs de grupo. cadeia de caracteres[]
privateEndpoint O recurso do ponto de extremidade privado. PrivateEndpoint
privateLinkServiceConnectionState Uma coleção de informações sobre o estado da conexão entre o consumidor de serviço e o provedor. PrivateLinkServiceConnectionState (obrigatório)

PrivateLinkServiceConnectionState

Nome Descrição Valor
açõesObrigatório Uma mensagem que indica se as alterações no provedor de serviços exigem atualizações no consumidor. cadeia
descrição O motivo da aprovação/rejeição da conexão. cadeia
status Indica se a conexão foi aprovada/rejeitada/removida pelo proprietário do serviço. 'Aprovado'
'Pendente'
'Rejeitado'

TrackedResourceTags

Nome Descrição Valor

UserAssignedIdentities

Nome Descrição Valor

UserAssignedIdentity

Nome Descrição Valor

Exemplos de uso

Exemplos do Terraform

Um exemplo básico de implantação da Conta de Atualização de Dispositivo do Hub IoT.

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" "account" {
  type      = "Microsoft.DeviceUpdate/accounts@2022-10-01"
  parent_id = azapi_resource.resourceGroup.id
  name      = var.resource_name
  location  = var.location
  body = {
    properties = {
      publicNetworkAccess = "Enabled"
      sku                 = "Standard"
    }

  }
  schema_validation_enabled = false
  response_export_values    = ["*"]
}