Condividi tramite

Microsoft.Compute virtualMachineScaleSets/virtualMachines/extensions 2023-09-01

  • Articolo

Definizione di risorsa Bicep

Il tipo di risorsa virtualMachineScaleSets/virtualMachines/extensions 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.Compute/virtualMachineScaleSets/virtualMachines/extensions, aggiungere il bicep seguente al modello.

resource symbolicname 'Microsoft.Compute/virtualMachineScaleSets/virtualMachines/extensions@2023-09-01' = {
  parent: resourceSymbolicName
  location: 'string'
  name: 'string'
  properties: {
    autoUpgradeMinorVersion: bool
    enableAutomaticUpgrade: bool
    forceUpdateTag: 'string'
    instanceView: {
      name: 'string'
      statuses: [
        {
          code: 'string'
          displayStatus: 'string'
          level: 'string'
          message: 'string'
          time: 'string'
        }
      ]
      substatuses: [
        {
          code: 'string'
          displayStatus: 'string'
          level: 'string'
          message: 'string'
          time: 'string'
        }
      ]
      type: 'string'
      typeHandlerVersion: 'string'
    }
    protectedSettings: any(Azure.Bicep.Types.Concrete.AnyType)
    protectedSettingsFromKeyVault: {
      secretUrl: 'string'
      sourceVault: {
        id: 'string'
      }
    }
    provisionAfterExtensions: [
      'string'
    ]
    publisher: 'string'
    settings: any(Azure.Bicep.Types.Concrete.AnyType)
    suppressFailures: bool
    type: 'string'
    typeHandlerVersion: 'string'
  }
}

Valori delle proprietà

InstanceViewStatus

Nome Descrizione Valore
codice Codice di stato. corda
displayStatus Etichetta localizzabile breve per lo stato. corda
livello Codice a livello. 'Error'
'Info'
'Avviso'
Messaggio Messaggio di stato dettagliato, inclusi gli avvisi e i messaggi di errore. corda
Ore Ora dello stato. corda

KeyVaultSecretReference

Nome Descrizione Valore
secretUrl URL che fa riferimento a un segreto in un insieme di credenziali delle chiavi. stringa (obbligatorio)
sourceVault URL relativo dell'insieme di credenziali delle chiavi contenente il segreto. SubResource (obbligatorio)

Microsoft.Compute/virtualMachineScaleSets/virtualMachines/extensions

Nome Descrizione Valore
ubicazione Posizione dell'estensione. corda
nome Nome della risorsa stringa (obbligatorio)
genitore In Bicep è possibile specificare la risorsa padre per una risorsa figlio. È necessario aggiungere questa proprietà solo quando la risorsa figlio viene dichiarata all'esterno della risorsa padre.

Per altre informazioni, vedere risorsa figlio all'esterno della risorsa padre.		 Nome simbolico per la risorsa di tipo: virtualMachineScaleSets/virtualMachines
proprietà Descrive le proprietà di un'estensione macchina virtuale. VirtualMachineExtensionProperties

Sottorisorsa

Nome Descrizione Valore
Id ID risorsa corda

VirtualMachineExtensionInstanceView

Nome Descrizione Valore
nome Nome dell'estensione della macchina virtuale. corda
Stati Informazioni sullo stato della risorsa. InstanceViewStatus[]
substatuses Informazioni sullo stato della risorsa. InstanceViewStatus[]
digitare Specifica il tipo di estensione; un esempio è "CustomScriptExtension". corda
typeHandlerVersion Specifica la versione del gestore di script. corda

VirtualMachineExtensionProperties

Nome Descrizione Valore
autoUpgradeMinorVersion Indica se l'estensione deve usare una versione secondaria più recente, se disponibile in fase di distribuzione. Dopo la distribuzione, tuttavia, l'estensione non aggiornerà le versioni secondarie a meno che non venga ridistribuibile, anche con questa proprietà impostata su true. Bool
enableAutomaticUpgrade Indica se l'estensione deve essere aggiornata automaticamente dalla piattaforma se è disponibile una versione più recente dell'estensione. Bool
forceUpdateTag Come deve essere forzato l'aggiornamento del gestore di estensioni anche se la configurazione dell'estensione non è stata modificata. corda
instanceView Visualizzazione dell'istanza dell'estensione della macchina virtuale. VirtualMachineExtensionInstanceView
protectedSettings L'estensione può contenere protectedSettings o protectedSettingsFromKeyVault o nessuna impostazione protetta. qualunque
protectedSettingsFromKeyVault Impostazioni protette delle estensioni passate per riferimento e utilizzate dall'insieme di credenziali delle chiavi KeyVaultSecretReference
provisionAfterExtensions Raccolta di nomi di estensione dopo i quali è necessario effettuare il provisioning di questa estensione. string[]
editore Nome del server di pubblicazione del gestore dell'estensione. corda
Impostazioni Impostazioni pubbliche in formato JSON per l'estensione. qualunque
suppressFailures Indica se gli errori derivanti dall'estensione verranno eliminati (gli errori operativi, ad esempio la mancata connessione alla macchina virtuale, non verranno eliminati indipendentemente da questo valore). Il valore predefinito è false. Bool
digitare Specifica il tipo di estensione; un esempio è "CustomScriptExtension". corda
typeHandlerVersion Specifica la versione del gestore di script. corda

Definizione di risorsa del modello di Resource Manager

Il tipo di risorsa virtualMachineScaleSets/virtualMachines/extensions 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.Compute/virtualMachineScaleSets/virtualMachines/extensions, aggiungere il codice JSON seguente al modello.

{
  "type": "Microsoft.Compute/virtualMachineScaleSets/virtualMachines/extensions",
  "apiVersion": "2023-09-01",
  "name": "string",
  "location": "string",
  "properties": {
    "autoUpgradeMinorVersion": "bool",
    "enableAutomaticUpgrade": "bool",
    "forceUpdateTag": "string",
    "instanceView": {
      "name": "string",
      "statuses": [
        {
          "code": "string",
          "displayStatus": "string",
          "level": "string",
          "message": "string",
          "time": "string"
        }
      ],
      "substatuses": [
        {
          "code": "string",
          "displayStatus": "string",
          "level": "string",
          "message": "string",
          "time": "string"
        }
      ],
      "type": "string",
      "typeHandlerVersion": "string"
    },
    "protectedSettings": {},
    "protectedSettingsFromKeyVault": {
      "secretUrl": "string",
      "sourceVault": {
        "id": "string"
      }
    },
    "provisionAfterExtensions": [ "string" ],
    "publisher": "string",
    "settings": {},
    "suppressFailures": "bool",
    "type": "string",
    "typeHandlerVersion": "string"
  }
}

Valori delle proprietà

InstanceViewStatus

Nome Descrizione Valore
codice Codice di stato. corda
displayStatus Etichetta localizzabile breve per lo stato. corda
livello Codice a livello. 'Error'
'Info'
'Avviso'
Messaggio Messaggio di stato dettagliato, inclusi gli avvisi e i messaggi di errore. corda
Ore Ora dello stato. corda

KeyVaultSecretReference

Nome Descrizione Valore
secretUrl URL che fa riferimento a un segreto in un insieme di credenziali delle chiavi. stringa (obbligatorio)
sourceVault URL relativo dell'insieme di credenziali delle chiavi contenente il segreto. SubResource (obbligatorio)

Microsoft.Compute/virtualMachineScaleSets/virtualMachines/extensions

Nome Descrizione Valore
apiVersion Versione dell'API '2023-09-01'
ubicazione Posizione dell'estensione. corda
nome Nome della risorsa stringa (obbligatorio)
proprietà Descrive le proprietà di un'estensione macchina virtuale. VirtualMachineExtensionProperties
digitare Tipo di risorsa 'Microsoft.Compute/virtualMachineScaleSets/virtualMachines/extensions'

Sottorisorsa

Nome Descrizione Valore
Id ID risorsa corda

VirtualMachineExtensionInstanceView

Nome Descrizione Valore
nome Nome dell'estensione della macchina virtuale. corda
Stati Informazioni sullo stato della risorsa. InstanceViewStatus[]
substatuses Informazioni sullo stato della risorsa. InstanceViewStatus[]
digitare Specifica il tipo di estensione; un esempio è "CustomScriptExtension". corda
typeHandlerVersion Specifica la versione del gestore di script. corda

VirtualMachineExtensionProperties

Nome Descrizione Valore
autoUpgradeMinorVersion Indica se l'estensione deve usare una versione secondaria più recente, se disponibile in fase di distribuzione. Dopo la distribuzione, tuttavia, l'estensione non aggiornerà le versioni secondarie a meno che non venga ridistribuibile, anche con questa proprietà impostata su true. Bool
enableAutomaticUpgrade Indica se l'estensione deve essere aggiornata automaticamente dalla piattaforma se è disponibile una versione più recente dell'estensione. Bool
forceUpdateTag Come deve essere forzato l'aggiornamento del gestore di estensioni anche se la configurazione dell'estensione non è stata modificata. corda
instanceView Visualizzazione dell'istanza dell'estensione della macchina virtuale. VirtualMachineExtensionInstanceView
protectedSettings L'estensione può contenere protectedSettings o protectedSettingsFromKeyVault o nessuna impostazione protetta. qualunque
protectedSettingsFromKeyVault Impostazioni protette delle estensioni passate per riferimento e utilizzate dall'insieme di credenziali delle chiavi KeyVaultSecretReference
provisionAfterExtensions Raccolta di nomi di estensione dopo i quali è necessario effettuare il provisioning di questa estensione. string[]
editore Nome del server di pubblicazione del gestore dell'estensione. corda
Impostazioni Impostazioni pubbliche in formato JSON per l'estensione. qualunque
suppressFailures Indica se gli errori derivanti dall'estensione verranno eliminati (gli errori operativi, ad esempio la mancata connessione alla macchina virtuale, non verranno eliminati indipendentemente da questo valore). Il valore predefinito è false. Bool
digitare Specifica il tipo di estensione; un esempio è "CustomScriptExtension". corda
typeHandlerVersion Specifica la versione del gestore di script. corda

Definizione di risorsa Terraform (provider AzAPI)

Il tipo di risorsa virtualMachineScaleSets/virtualMachines/extensions 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.Compute/virtualMachineScaleSets/virtualMachines/extensions, aggiungere il codice Terraform seguente al modello.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Compute/virtualMachineScaleSets/virtualMachines/extensions@2023-09-01"
  name = "string"
  location = "string"
  body = jsonencode({
    properties = {
      autoUpgradeMinorVersion = bool
      enableAutomaticUpgrade = bool
      forceUpdateTag = "string"
      instanceView = {
        name = "string"
        statuses = [
          {
            code = "string"
            displayStatus = "string"
            level = "string"
            message = "string"
            time = "string"
          }
        ]
        substatuses = [
          {
            code = "string"
            displayStatus = "string"
            level = "string"
            message = "string"
            time = "string"
          }
        ]
        type = "string"
        typeHandlerVersion = "string"
      }
      protectedSettings = ?
      protectedSettingsFromKeyVault = {
        secretUrl = "string"
        sourceVault = {
          id = "string"
        }
      }
      provisionAfterExtensions = [
        "string"
      ]
      publisher = "string"
      settings = ?
      suppressFailures = bool
      type = "string"
      typeHandlerVersion = "string"
    }
  })
}

Valori delle proprietà

InstanceViewStatus

Nome Descrizione Valore
codice Codice di stato. corda
displayStatus Etichetta localizzabile breve per lo stato. corda
livello Codice a livello. 'Error'
'Info'
'Avviso'
Messaggio Messaggio di stato dettagliato, inclusi gli avvisi e i messaggi di errore. corda
Ore Ora dello stato. corda

KeyVaultSecretReference

Nome Descrizione Valore
secretUrl URL che fa riferimento a un segreto in un insieme di credenziali delle chiavi. stringa (obbligatorio)
sourceVault URL relativo dell'insieme di credenziali delle chiavi contenente il segreto. SubResource (obbligatorio)

Microsoft.Compute/virtualMachineScaleSets/virtualMachines/extensions

Nome Descrizione Valore
ubicazione Posizione dell'estensione. corda
nome Nome della risorsa stringa (obbligatorio)
parent_id ID della risorsa padre per questa risorsa. ID per la risorsa di tipo: virtualMachineScaleSets/virtualMachines
proprietà Descrive le proprietà di un'estensione macchina virtuale. VirtualMachineExtensionProperties
digitare Tipo di risorsa "Microsoft.Compute/virtualMachineScaleSets/virtualMachines/extensions@2023-09-01"

Sottorisorsa

Nome Descrizione Valore
Id ID risorsa corda

VirtualMachineExtensionInstanceView

Nome Descrizione Valore
nome Nome dell'estensione della macchina virtuale. corda
Stati Informazioni sullo stato della risorsa. InstanceViewStatus[]
substatuses Informazioni sullo stato della risorsa. InstanceViewStatus[]
digitare Specifica il tipo di estensione; un esempio è "CustomScriptExtension". corda
typeHandlerVersion Specifica la versione del gestore di script. corda

VirtualMachineExtensionProperties

Nome Descrizione Valore
autoUpgradeMinorVersion Indica se l'estensione deve usare una versione secondaria più recente, se disponibile in fase di distribuzione. Dopo la distribuzione, tuttavia, l'estensione non aggiornerà le versioni secondarie a meno che non venga ridistribuibile, anche con questa proprietà impostata su true. Bool
enableAutomaticUpgrade Indica se l'estensione deve essere aggiornata automaticamente dalla piattaforma se è disponibile una versione più recente dell'estensione. Bool
forceUpdateTag Come deve essere forzato l'aggiornamento del gestore di estensioni anche se la configurazione dell'estensione non è stata modificata. corda
instanceView Visualizzazione dell'istanza dell'estensione della macchina virtuale. VirtualMachineExtensionInstanceView
protectedSettings L'estensione può contenere protectedSettings o protectedSettingsFromKeyVault o nessuna impostazione protetta. qualunque
protectedSettingsFromKeyVault Impostazioni protette delle estensioni passate per riferimento e utilizzate dall'insieme di credenziali delle chiavi KeyVaultSecretReference
provisionAfterExtensions Raccolta di nomi di estensione dopo i quali è necessario effettuare il provisioning di questa estensione. string[]
editore Nome del server di pubblicazione del gestore dell'estensione. corda
Impostazioni Impostazioni pubbliche in formato JSON per l'estensione. qualunque
suppressFailures Indica se gli errori derivanti dall'estensione verranno eliminati (gli errori operativi, ad esempio la mancata connessione alla macchina virtuale, non verranno eliminati indipendentemente da questo valore). Il valore predefinito è false. Bool
digitare Specifica il tipo di estensione; un esempio è "CustomScriptExtension". corda
typeHandlerVersion Specifica la versione del gestore di script. corda