Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
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
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
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 |
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 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
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 = ["*"]
}