Compartir a través de


Cuentas de Microsoft.DeviceUpdate

Definición de recursos de Bicep

El tipo de recurso accounts se puede implementar con operaciones destinadas a:

Para obtener una lista de las propiedades modificadas en cada versión de API, consulte registro de cambios.

Formato de recurso

Para crear un recurso Microsoft.DeviceUpdate/accounts, agregue el siguiente bicep a la plantilla.

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 propiedad

Microsoft.DeviceUpdate/accounts

Nombre Descripción Valor
identidad Tipo de identidad que se usa para el recurso. managedServiceIdentity
ubicación Ubicación geográfica donde reside el recurso string (obligatorio)
nombre El nombre del recurso cuerda

Restricciones:
Longitud mínima = 3
Longitud máxima = 24
Patrón = ^[A-Za-z0-9]+(-[A-Za-z0-9]+)*$ (obligatorio)
Propiedades Propiedades de la cuenta de Device Update. AccountProperties (Propiedades de la cuenta)
scope Use al crear un recurso en un ámbito diferente del ámbito de implementación. Establezca esta propiedad en el nombre simbólico de un recurso para aplicar el recurso de extensión .
Etiquetas Etiquetas de recursos Diccionario de nombres y valores de etiqueta. Consulte etiquetas de en plantillas

AccountProperties (Propiedades de la cuenta)

Nombre Descripción Valor
encriptación Propiedades de cifrado de CMK en reposo de cifrado
privateEndpointConnections Lista de conexiones de punto de conexión privado asociadas a la cuenta. privateEndpointConnection[]
publicNetworkAccess Indica si se permite o no el acceso a la red pública para la cuenta. 'Deshabilitado'
'Habilitado'
Sku SKU de actualización del dispositivo "Gratis"
'Estándar'

Encriptación

Nombre Descripción Valor
keyVaultKeyUri Identificador URI del almacén de claves cuerda
userAssignedIdentity ResourceId completo de la identidad asignada por el usuario que se usará para el acceso al almacén de claves. La identidad también debe asignarse a la cuenta. cuerda

ManagedServiceIdentity

Nombre Descripción Valor
tipo Tipo de identidad de servicio administrada (donde se permiten los tipos SystemAssigned y UserAssigned). 'Ninguno'
'SystemAssigned'
'SystemAssigned,UserAssigned'
'UserAssigned' (obligatorio)
identidades asignadas por el usuario Conjunto de identidades asignadas por el usuario asociadas al recurso. Las claves de diccionario userAssignedIdentities serán identificadores de recursos de ARM con el formato: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Los valores del diccionario pueden ser objetos vacíos ({}) en las solicitudes. UserAssignedIdentities

Punto de conexión privado

Nombre Descripción Valor

PrivateEndpointConnection

Nombre Descripción Valor
Propiedades Propiedades de recursos. privateEndpointConnectionProperties (obligatorio)

PrivateEndpointConnectionProperties

Nombre Descripción Valor
identificadores de grupo Matriz de identificadores de grupo. cadena[]
privateEndpoint Recurso del punto de conexión privado. PrivateEndpoint
privateLinkServiceConnectionState Colección de información sobre el estado de la conexión entre el consumidor del servicio y el proveedor. privateLinkServiceConnectionState (obligatorio)

PrivateLinkServiceConnectionState

Nombre Descripción Valor
actionsRequired Mensaje que indica si los cambios en el proveedor de servicios requieren actualizaciones en el consumidor. cuerda
descripción Motivo de aprobación o rechazo de la conexión. cuerda
estado Indica si el propietario del servicio ha aprobado o rechazado o eliminado la conexión. 'Aprobado'
'Pendiente'
'Rechazado'

TrackedResourceTags

Nombre Descripción Valor

UserAssignedIdentities

Nombre Descripción Valor

IdentidadAsignadaPorElUsuario

Nombre Descripción Valor

Ejemplos de uso

Ejemplos de inicio rápido de Azure

Los siguientes plantillas de inicio rápido de Azure contienen ejemplos de Bicep para implementar este tipo de recurso.

Archivo de Bicep Descripción
creación de una cuenta de Device Update para IoT Hub Esta plantilla crea una cuenta que proporciona un registro DNS público y permite realizar llamadas api REST al plano de datos. A continuación, el usuario debe crear una instancia en la cuenta y vincularla con una instancia de IoT Hub para empezar a usar el servicio.
crear una cuenta de Device Update para IoT Hub, una instancia de IoT Hub Esta plantilla crea una cuenta y una instancia y un centro con el que vincular la instancia. Configura el centro con las directivas de acceso, las rutas y el grupo de consumidores necesarios.

Definición de recursos de plantilla de ARM

El tipo de recurso accounts se puede implementar con operaciones destinadas a:

Para obtener una lista de las propiedades modificadas en cada versión de API, consulte registro de cambios.

Formato de recurso

Para crear un recurso Microsoft.DeviceUpdate/accounts, agregue el siguiente JSON a la plantilla.

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

Microsoft.DeviceUpdate/accounts

Nombre Descripción Valor
apiVersion La versión de api '2023-07-01'
identidad Tipo de identidad que se usa para el recurso. managedServiceIdentity
ubicación Ubicación geográfica donde reside el recurso string (obligatorio)
nombre El nombre del recurso cuerda

Restricciones:
Longitud mínima = 3
Longitud máxima = 24
Patrón = ^[A-Za-z0-9]+(-[A-Za-z0-9]+)*$ (obligatorio)
Propiedades Propiedades de la cuenta de Device Update. AccountProperties (Propiedades de la cuenta)
Etiquetas Etiquetas de recursos Diccionario de nombres y valores de etiqueta. Consulte etiquetas de en plantillas
tipo El tipo de recurso "Microsoft.DeviceUpdate/accounts"

AccountProperties (Propiedades de la cuenta)

Nombre Descripción Valor
encriptación Propiedades de cifrado de CMK en reposo de cifrado
privateEndpointConnections Lista de conexiones de punto de conexión privado asociadas a la cuenta. privateEndpointConnection[]
publicNetworkAccess Indica si se permite o no el acceso a la red pública para la cuenta. 'Deshabilitado'
'Habilitado'
Sku SKU de actualización del dispositivo "Gratis"
'Estándar'

Encriptación

Nombre Descripción Valor
keyVaultKeyUri Identificador URI del almacén de claves cuerda
userAssignedIdentity ResourceId completo de la identidad asignada por el usuario que se usará para el acceso al almacén de claves. La identidad también debe asignarse a la cuenta. cuerda

ManagedServiceIdentity

Nombre Descripción Valor
tipo Tipo de identidad de servicio administrada (donde se permiten los tipos SystemAssigned y UserAssigned). 'Ninguno'
'SystemAssigned'
'SystemAssigned,UserAssigned'
'UserAssigned' (obligatorio)
identidades asignadas por el usuario Conjunto de identidades asignadas por el usuario asociadas al recurso. Las claves de diccionario userAssignedIdentities serán identificadores de recursos de ARM con el formato: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Los valores del diccionario pueden ser objetos vacíos ({}) en las solicitudes. UserAssignedIdentities

Punto de conexión privado

Nombre Descripción Valor

PrivateEndpointConnection

Nombre Descripción Valor
Propiedades Propiedades de recursos. privateEndpointConnectionProperties (obligatorio)

PrivateEndpointConnectionProperties

Nombre Descripción Valor
identificadores de grupo Matriz de identificadores de grupo. cadena[]
privateEndpoint Recurso del punto de conexión privado. PrivateEndpoint
privateLinkServiceConnectionState Colección de información sobre el estado de la conexión entre el consumidor del servicio y el proveedor. privateLinkServiceConnectionState (obligatorio)

PrivateLinkServiceConnectionState

Nombre Descripción Valor
actionsRequired Mensaje que indica si los cambios en el proveedor de servicios requieren actualizaciones en el consumidor. cuerda
descripción Motivo de aprobación o rechazo de la conexión. cuerda
estado Indica si el propietario del servicio ha aprobado o rechazado o eliminado la conexión. 'Aprobado'
'Pendiente'
'Rechazado'

TrackedResourceTags

Nombre Descripción Valor

UserAssignedIdentities

Nombre Descripción Valor

IdentidadAsignadaPorElUsuario

Nombre Descripción Valor

Ejemplos de uso

Plantillas de inicio rápido de Azure

Los siguientes plantillas de inicio rápido de Azure implementar este tipo de recurso.

Plantilla Descripción
creación de una cuenta de Device Update para IoT Hub

Implementación en Azure
Esta plantilla crea una cuenta que proporciona un registro DNS público y permite realizar llamadas api REST al plano de datos. A continuación, el usuario debe crear una instancia en la cuenta y vincularla con una instancia de IoT Hub para empezar a usar el servicio.
crear una cuenta de Device Update para IoT Hub, una instancia de IoT Hub

Implementación en Azure
Esta plantilla crea una cuenta y una instancia y un centro con el que vincular la instancia. Configura el centro con las directivas de acceso, las rutas y el grupo de consumidores necesarios.

Definición de recursos de Terraform (proveedor AzAPI)

El tipo de recurso accounts se puede implementar con operaciones destinadas a:

Para obtener una lista de las propiedades modificadas en cada versión de API, consulte registro de cambios.

Formato de recurso

Para crear un recurso Microsoft.DeviceUpdate/accounts, agregue el siguiente Terraform a la plantilla.

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 propiedad

Microsoft.DeviceUpdate/accounts

Nombre Descripción Valor
identidad Tipo de identidad que se usa para el recurso. managedServiceIdentity
ubicación Ubicación geográfica donde reside el recurso string (obligatorio)
nombre El nombre del recurso cuerda

Restricciones:
Longitud mínima = 3
Longitud máxima = 24
Patrón = ^[A-Za-z0-9]+(-[A-Za-z0-9]+)*$ (obligatorio)
parent_id Identificador del recurso al que se va a aplicar este recurso de extensión. string (obligatorio)
Propiedades Propiedades de la cuenta de Device Update. AccountProperties (Propiedades de la cuenta)
Etiquetas Etiquetas de recursos Diccionario de nombres y valores de etiqueta.
tipo El tipo de recurso "Microsoft.DeviceUpdate/accounts@2023-07-01"

AccountProperties (Propiedades de la cuenta)

Nombre Descripción Valor
encriptación Propiedades de cifrado de CMK en reposo de cifrado
privateEndpointConnections Lista de conexiones de punto de conexión privado asociadas a la cuenta. privateEndpointConnection[]
publicNetworkAccess Indica si se permite o no el acceso a la red pública para la cuenta. 'Deshabilitado'
'Habilitado'
Sku SKU de actualización del dispositivo "Gratis"
'Estándar'

Encriptación

Nombre Descripción Valor
keyVaultKeyUri Identificador URI del almacén de claves cuerda
userAssignedIdentity ResourceId completo de la identidad asignada por el usuario que se usará para el acceso al almacén de claves. La identidad también debe asignarse a la cuenta. cuerda

ManagedServiceIdentity

Nombre Descripción Valor
tipo Tipo de identidad de servicio administrada (donde se permiten los tipos SystemAssigned y UserAssigned). 'Ninguno'
'SystemAssigned'
'SystemAssigned,UserAssigned'
'UserAssigned' (obligatorio)
identidades asignadas por el usuario Conjunto de identidades asignadas por el usuario asociadas al recurso. Las claves de diccionario userAssignedIdentities serán identificadores de recursos de ARM con el formato: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Los valores del diccionario pueden ser objetos vacíos ({}) en las solicitudes. UserAssignedIdentities

Punto de conexión privado

Nombre Descripción Valor

PrivateEndpointConnection

Nombre Descripción Valor
Propiedades Propiedades de recursos. privateEndpointConnectionProperties (obligatorio)

PrivateEndpointConnectionProperties

Nombre Descripción Valor
identificadores de grupo Matriz de identificadores de grupo. cadena[]
privateEndpoint Recurso del punto de conexión privado. PrivateEndpoint
privateLinkServiceConnectionState Colección de información sobre el estado de la conexión entre el consumidor del servicio y el proveedor. privateLinkServiceConnectionState (obligatorio)

PrivateLinkServiceConnectionState

Nombre Descripción Valor
actionsRequired Mensaje que indica si los cambios en el proveedor de servicios requieren actualizaciones en el consumidor. cuerda
descripción Motivo de aprobación o rechazo de la conexión. cuerda
estado Indica si el propietario del servicio ha aprobado o rechazado o eliminado la conexión. 'Aprobado'
'Pendiente'
'Rechazado'

TrackedResourceTags

Nombre Descripción Valor

UserAssignedIdentities

Nombre Descripción Valor

IdentidadAsignadaPorElUsuario

Nombre Descripción Valor

Ejemplos de uso

Ejemplos de Terraform

Un ejemplo básico de implementación de la cuenta de actualización de dispositivos de IoT Hub.

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    = ["*"]
}