Condividi tramite


Account Microsoft.DeviceUpdate

Definizione di risorsa Bicep

Il tipo di risorsa account può essere distribuito con operazioni destinate a:

  • gruppi di risorse - Vedere i comandi di distribuzione del gruppo di risorse

Per un elenco delle proprietà modificate in ogni versione dell'API, vedere log delle modifiche.

Formato risorsa

Per creare una risorsa Microsoft.DeviceUpdate/accounts, aggiungere il bicep seguente al modello.

resource symbolicname 'Microsoft.DeviceUpdate/accounts@2023-07-01' = {
  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'
  }
}

Valori delle proprietà

AccountProperties

Nome Descrizione Valore
codifica Crittografia della chiave gestita dal cliente inattivi encryption
privateEndpointConnections Elenco delle connessioni dell'endpoint privato associate all'account. PrivateEndpointConnection[]
publicNetworkAccess Indica se l'accesso alla rete pubblica è consentito per l'account. 'Disabilitato'
'Enabled'
Sku Sku aggiornamento dispositivi 'Free'
'Standard'

Codifica

Nome Descrizione Valore
keyVaultKeyUri URI dell'insieme di credenziali delle chiavi corda
userAssignedIdentity ResourceId completo dell'identità assegnata dall'utente da usare per l'accesso all'insieme di credenziali delle chiavi. L'identità deve essere assegnata anche all'account corda

ManagedServiceIdentity

Nome Descrizione Valore
digitare Tipo di identità del servizio gestito (in cui sono consentiti sia i tipi SystemAssigned che UserAssigned). 'Nessuno'
'SystemAssigned'
'SystemAssigned,UserAssigned'
'UserAssigned' (obbligatorio)
userAssignedIdentities Set di identità assegnate dall'utente associate alla risorsa. Le chiavi del dizionario userAssignedIdentities saranno ID risorsa ARM nel formato : '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. I valori del dizionario possono essere oggetti vuoti ({}) nelle richieste. UserAssignedIdentities

Microsoft.DeviceUpdate/accounts

Nome Descrizione Valore
identità Tipo di identità usata per la risorsa. ManagedServiceIdentity
ubicazione Posizione geografica in cui risiede la risorsa stringa (obbligatorio)
nome Nome della risorsa corda

Vincoli:
Lunghezza minima = 3
Lunghezza massima = 24
Pattern = ^[A-Za-z0-9]+(-[A-Za-z0-9]+)*$ (obbligatorio)
proprietà Proprietà dell'account di Aggiornamento dispositivi. AccountProperties
Tag Tag delle risorse Dizionario di nomi e valori di tag. Vedere tag nei modelli

PrivateEndpoint

Nome Descrizione Valore

PrivateEndpointConnection

Nome Descrizione Valore
proprietà Proprietà delle risorse. PrivateEndpointConnectionProperties (obbligatorio)

PrivateEndpointConnectionProperties

Nome Descrizione Valore
groupIds Matrice di ID gruppo. string[]
privateEndpoint Risorsa dell'endpoint privato. PrivateEndpoint
privateLinkServiceConnectionState Raccolta di informazioni sullo stato della connessione tra consumer di servizi e provider. PrivateLinkServiceConnectionState (obbligatorio)

PrivateLinkServiceConnectionState

Nome Descrizione Valore
actionsRequired Messaggio che indica se le modifiche apportate al provider di servizi richiedono aggiornamenti sul consumer. corda
descrizione Motivo dell'approvazione/rifiuto della connessione. corda
stato Indica se la connessione è stata approvata/rifiutata/rimossa dal proprietario del servizio. 'Approvato'
'In sospeso'
'Rejected'

TrackedResourceTags

Nome Descrizione Valore

UserAssignedIdentities

Nome Descrizione Valore

UserAssignedIdentity

Nome Descrizione Valore

Esempi di utilizzo

Esempi di avvio rapido di Azure

I modelli di avvio rapido di Azure seguenti contengono esempi Bicep per la distribuzione di questo tipo di risorsa.

Bicep File Descrizione
Creare l'aggiornamento del dispositivo per l'account dell'hub IoT Questo modello crea un account che fornisce un record DNS pubblico e consente di effettuare chiamate API REST al piano dati. L'utente deve quindi creare un'istanza con l'account e collegarla a un hub IoT per iniziare a usare il servizio.
Creare l'aggiornamento dei dispositivi per l'account dell'hub IoT, l'istanza, l'hub IoT Questo modello crea un account e un'istanza e un hub con cui collegare l'istanza. Configura l'hub con i criteri di accesso, le route e il gruppo di consumer necessari.

Definizione di risorsa del modello di Resource Manager

Il tipo di risorsa account può essere distribuito con operazioni destinate a:

  • gruppi di risorse - Vedere i comandi di distribuzione del gruppo di risorse

Per un elenco delle proprietà modificate in ogni versione dell'API, vedere log delle modifiche.

Formato risorsa

Per creare una risorsa Microsoft.DeviceUpdate/accounts, aggiungere il codice JSON seguente al modello.

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

Valori delle proprietà

AccountProperties

Nome Descrizione Valore
codifica Crittografia della chiave gestita dal cliente inattivi encryption
privateEndpointConnections Elenco delle connessioni dell'endpoint privato associate all'account. PrivateEndpointConnection[]
publicNetworkAccess Indica se l'accesso alla rete pubblica è consentito per l'account. 'Disabilitato'
'Enabled'
Sku Sku aggiornamento dispositivi 'Free'
'Standard'

Codifica

Nome Descrizione Valore
keyVaultKeyUri URI dell'insieme di credenziali delle chiavi corda
userAssignedIdentity ResourceId completo dell'identità assegnata dall'utente da usare per l'accesso all'insieme di credenziali delle chiavi. L'identità deve essere assegnata anche all'account corda

ManagedServiceIdentity

Nome Descrizione Valore
digitare Tipo di identità del servizio gestito (in cui sono consentiti sia i tipi SystemAssigned che UserAssigned). 'Nessuno'
'SystemAssigned'
'SystemAssigned,UserAssigned'
'UserAssigned' (obbligatorio)
userAssignedIdentities Set di identità assegnate dall'utente associate alla risorsa. Le chiavi del dizionario userAssignedIdentities saranno ID risorsa ARM nel formato : '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. I valori del dizionario possono essere oggetti vuoti ({}) nelle richieste. UserAssignedIdentities

Microsoft.DeviceUpdate/accounts

Nome Descrizione Valore
apiVersion Versione dell'API '2023-07-01'
identità Tipo di identità usata per la risorsa. ManagedServiceIdentity
ubicazione Posizione geografica in cui risiede la risorsa stringa (obbligatorio)
nome Nome della risorsa corda

Vincoli:
Lunghezza minima = 3
Lunghezza massima = 24
Pattern = ^[A-Za-z0-9]+(-[A-Za-z0-9]+)*$ (obbligatorio)
proprietà Proprietà dell'account di Aggiornamento dispositivi. AccountProperties
Tag Tag delle risorse Dizionario di nomi e valori di tag. Vedere tag nei modelli
digitare Tipo di risorsa 'Microsoft.DeviceUpdate/accounts'

PrivateEndpoint

Nome Descrizione Valore

PrivateEndpointConnection

Nome Descrizione Valore
proprietà Proprietà delle risorse. PrivateEndpointConnectionProperties (obbligatorio)

PrivateEndpointConnectionProperties

Nome Descrizione Valore
groupIds Matrice di ID gruppo. string[]
privateEndpoint Risorsa dell'endpoint privato. PrivateEndpoint
privateLinkServiceConnectionState Raccolta di informazioni sullo stato della connessione tra consumer di servizi e provider. PrivateLinkServiceConnectionState (obbligatorio)

PrivateLinkServiceConnectionState

Nome Descrizione Valore
actionsRequired Messaggio che indica se le modifiche apportate al provider di servizi richiedono aggiornamenti sul consumer. corda
descrizione Motivo dell'approvazione/rifiuto della connessione. corda
stato Indica se la connessione è stata approvata/rifiutata/rimossa dal proprietario del servizio. 'Approvato'
'In sospeso'
'Rejected'

TrackedResourceTags

Nome Descrizione Valore

UserAssignedIdentities

Nome Descrizione Valore

UserAssignedIdentity

Nome Descrizione Valore

Esempi di utilizzo

Modelli di avvio rapido di Azure

I modelli di avvio rapido di Azure seguenti distribuire questo tipo di risorsa.

Sagoma Descrizione
Creare l'aggiornamento del dispositivo per l'account dell'hub IoT

Distribuire in Azure
Questo modello crea un account che fornisce un record DNS pubblico e consente di effettuare chiamate API REST al piano dati. L'utente deve quindi creare un'istanza con l'account e collegarla a un hub IoT per iniziare a usare il servizio.
Creare l'aggiornamento dei dispositivi per l'account dell'hub IoT, l'istanza, l'hub IoT

Distribuire in Azure
Questo modello crea un account e un'istanza e un hub con cui collegare l'istanza. Configura l'hub con i criteri di accesso, le route e il gruppo di consumer necessari.

Definizione di risorsa Terraform (provider AzAPI)

Il tipo di risorsa account può essere distribuito con operazioni destinate a:

  • gruppi di risorse

Per un elenco delle proprietà modificate in ogni versione dell'API, vedere log delle modifiche.

Formato risorsa

Per creare una risorsa Microsoft.DeviceUpdate/accounts, aggiungere il comando Terraform seguente al modello.

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

Valori delle proprietà

AccountProperties

Nome Descrizione Valore
codifica Crittografia della chiave gestita dal cliente inattivi encryption
privateEndpointConnections Elenco delle connessioni dell'endpoint privato associate all'account. PrivateEndpointConnection[]
publicNetworkAccess Indica se l'accesso alla rete pubblica è consentito per l'account. 'Disabilitato'
'Enabled'
Sku Sku aggiornamento dispositivi 'Free'
'Standard'

Codifica

Nome Descrizione Valore
keyVaultKeyUri URI dell'insieme di credenziali delle chiavi corda
userAssignedIdentity ResourceId completo dell'identità assegnata dall'utente da usare per l'accesso all'insieme di credenziali delle chiavi. L'identità deve essere assegnata anche all'account corda

ManagedServiceIdentity

Nome Descrizione Valore
digitare Tipo di identità del servizio gestito (in cui sono consentiti sia i tipi SystemAssigned che UserAssigned). 'Nessuno'
'SystemAssigned'
'SystemAssigned,UserAssigned'
'UserAssigned' (obbligatorio)
userAssignedIdentities Set di identità assegnate dall'utente associate alla risorsa. Le chiavi del dizionario userAssignedIdentities saranno ID risorsa ARM nel formato : '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. I valori del dizionario possono essere oggetti vuoti ({}) nelle richieste. UserAssignedIdentities

Microsoft.DeviceUpdate/accounts

Nome Descrizione Valore
identità Tipo di identità usata per la risorsa. ManagedServiceIdentity
ubicazione Posizione geografica in cui risiede la risorsa stringa (obbligatorio)
nome Nome della risorsa corda

Vincoli:
Lunghezza minima = 3
Lunghezza massima = 24
Pattern = ^[A-Za-z0-9]+(-[A-Za-z0-9]+)*$ (obbligatorio)
proprietà Proprietà dell'account di Aggiornamento dispositivi. AccountProperties
Tag Tag delle risorse Dizionario di nomi e valori di tag.
digitare Tipo di risorsa "Microsoft.DeviceUpdate/accounts@2023-07-01"

PrivateEndpoint

Nome Descrizione Valore

PrivateEndpointConnection

Nome Descrizione Valore
proprietà Proprietà delle risorse. PrivateEndpointConnectionProperties (obbligatorio)

PrivateEndpointConnectionProperties

Nome Descrizione Valore
groupIds Matrice di ID gruppo. string[]
privateEndpoint Risorsa dell'endpoint privato. PrivateEndpoint
privateLinkServiceConnectionState Raccolta di informazioni sullo stato della connessione tra consumer di servizi e provider. PrivateLinkServiceConnectionState (obbligatorio)

PrivateLinkServiceConnectionState

Nome Descrizione Valore
actionsRequired Messaggio che indica se le modifiche apportate al provider di servizi richiedono aggiornamenti sul consumer. corda
descrizione Motivo dell'approvazione/rifiuto della connessione. corda
stato Indica se la connessione è stata approvata/rifiutata/rimossa dal proprietario del servizio. 'Approvato'
'In sospeso'
'Rejected'

TrackedResourceTags

Nome Descrizione Valore

UserAssignedIdentities

Nome Descrizione Valore

UserAssignedIdentity

Nome Descrizione Valore