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

Article
08/17/2024

Définition de ressource Bicep

Le type de ressource virtualMachineScaleSets/virtualMachines/extensions peut être déployé avec des opérations qui ciblent :

groupes de ressources - Consultez commandes de déploiement de groupes de ressources

Pour obtenir la liste des propriétés modifiées dans chaque version de l’API, consultez journal des modifications.

Format de ressource

Pour créer une ressource Microsoft.Compute/virtualMachineScaleSets/virtualMachines/extensions, ajoutez le bicep suivant à votre modèle.

resource symbolicname 'Microsoft.Compute/virtualMachineScaleSets/virtualMachines/extensions@2023-09-01' = {
  name: 'string'
  location: 'string'
  parent: resourceSymbolicName
  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()
    protectedSettingsFromKeyVault: {
      secretUrl: 'string'
      sourceVault: {
        id: 'string'
      }
    }
    provisionAfterExtensions: [
      'string'
    ]
    publisher: 'string'
    settings: any()
    suppressFailures: bool
    type: 'string'
    typeHandlerVersion: 'string'
  }
}

Valeurs de propriété

virtualMachineScaleSets/virtualMachines/extensions

Nom	Description	Valeur
nom	Nom de la ressource Découvrez comment définir des noms et des types pour les ressources enfants dans Bicep.	chaîne (obligatoire)
emplacement	Emplacement de l’extension.	corde
parent	Dans Bicep, vous pouvez spécifier la ressource parente d’une ressource enfant. Vous devez uniquement ajouter cette propriété lorsque la ressource enfant est déclarée en dehors de la ressource parente. Pour plus d’informations, consultez ressource enfant en dehors de la ressource parente.	Nom symbolique de la ressource de type : virtualMachines
Propriétés	Décrit les propriétés d’une extension de machine virtuelle.	VirtualMachineExtensionProperties

VirtualMachineExtensionProperties

Nom	Description	Valeur
autoUpgradeMinorVersion	Indique si l’extension doit utiliser une version mineure plus récente si elle est disponible au moment du déploiement. Une fois déployée, toutefois, l’extension ne met pas à niveau les versions mineures, sauf si elle est redéployée, même avec cette propriété définie sur true.	Bool
enableAutomaticUpgrade	Indique si l’extension doit être automatiquement mise à niveau par la plateforme s’il existe une version plus récente de l’extension disponible.	Bool
forceUpdateTag	Comment le gestionnaire d’extensions doit être forcé de mettre à jour même si la configuration de l’extension n’a pas changé.	corde
instanceView	Vue d’instance d’extension de machine virtuelle.	VirtualMachineExtensionInstanceView
protectedSettings	L’extension peut contenir protectedSettings ou protectedSettingsFromKeyVault ou aucun paramètre protégé du tout.	Pour Bicep, vous pouvez utiliser la fonction any().
protectedSettingsFromKeyVault	Paramètres protégés par extensions passés par référence et consommés à partir du coffre de clés	KeyVaultSecretReference
provisionAfterExtensions	Collection de noms d’extensions après lesquels cette extension doit être provisionnée.	string[]
éditeur	Nom du serveur de publication du gestionnaire d’extensions.	corde
Paramètres	Paramètres publics au format Json pour l’extension.	Pour Bicep, vous pouvez utiliser la fonction any().
suppressFailures	Indique si les échecs résultant de l’extension seront supprimés (les échecs opérationnels tels que la connexion à la machine virtuelle ne seront pas supprimés indépendamment de cette valeur). La valeur par défaut est false.	Bool
type	Spécifie le type de l’extension ; un exemple est « CustomScriptExtension ».	corde
typeHandlerVersion	Spécifie la version du gestionnaire de scripts.	corde

VirtualMachineExtensionInstanceView

Nom	Description	Valeur
nom	Nom de l’extension de machine virtuelle.	corde
Statuts	Informations d’état de la ressource.	InstanceViewStatus []
sous-état	Informations d’état de la ressource.	InstanceViewStatus []
type	Spécifie le type de l’extension ; un exemple est « CustomScriptExtension ».	corde
typeHandlerVersion	Spécifie la version du gestionnaire de scripts.	corde

InstanceViewStatus

Nom	Description	Valeur
code	Code d’état.	corde
displayStatus	Étiquette localisable courte pour l’état.	corde
niveau	Code de niveau.	'Erreur' 'Info' 'Avertissement'
Message	Message d’état détaillé, y compris pour les alertes et les messages d’erreur.	corde
Heure	Heure de l’état.	corde

KeyVaultSecretReference

Nom	Description	Valeur
secretUrl	URL référençant un secret dans un coffre de clés.	chaîne (obligatoire)
sourceVault	URL relative du coffre de clés contenant le secret.	subResource (obligatoire)

Sous-ressource

Nom	Description	Valeur
id	ID de ressource	corde

Définition de ressource de modèle ARM

Le type de ressource virtualMachineScaleSets/virtualMachines/extensions peut être déployé avec des opérations qui ciblent :

groupes de ressources - Consultez commandes de déploiement de groupes de ressources

Pour obtenir la liste des propriétés modifiées dans chaque version de l’API, consultez journal des modifications.

Format de ressource

Pour créer une ressource Microsoft.Compute/virtualMachineScaleSets/virtualMachines/extensions, ajoutez le code JSON suivant à votre modèle.

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

Valeurs de propriété

virtualMachineScaleSets/virtualMachines/extensions

Nom	Description	Valeur
type	Type de ressource	'Microsoft.Compute/virtualMachineScaleSets/virtualMachines/extensions'
apiVersion	Version de l’API de ressource	'2023-09-01'
nom	Nom de la ressource Découvrez comment définir des noms et des types pour les ressources enfants dans modèles ARM JSON.	chaîne (obligatoire)
emplacement	Emplacement de l’extension.	corde
Propriétés	Décrit les propriétés d’une extension de machine virtuelle.	VirtualMachineExtensionProperties

VirtualMachineExtensionProperties

Nom	Description	Valeur
autoUpgradeMinorVersion	Indique si l’extension doit utiliser une version mineure plus récente si elle est disponible au moment du déploiement. Une fois déployée, toutefois, l’extension ne met pas à niveau les versions mineures, sauf si elle est redéployée, même avec cette propriété définie sur true.	Bool
enableAutomaticUpgrade	Indique si l’extension doit être automatiquement mise à niveau par la plateforme s’il existe une version plus récente de l’extension disponible.	Bool
forceUpdateTag	Comment le gestionnaire d’extensions doit être forcé de mettre à jour même si la configuration de l’extension n’a pas changé.	corde
instanceView	Vue d’instance d’extension de machine virtuelle.	VirtualMachineExtensionInstanceView
protectedSettings	L’extension peut contenir protectedSettings ou protectedSettingsFromKeyVault ou aucun paramètre protégé du tout.
protectedSettingsFromKeyVault	Paramètres protégés par extensions passés par référence et consommés à partir du coffre de clés	KeyVaultSecretReference
provisionAfterExtensions	Collection de noms d’extensions après lesquels cette extension doit être provisionnée.	string[]
éditeur	Nom du serveur de publication du gestionnaire d’extensions.	corde
Paramètres	Paramètres publics au format Json pour l’extension.
suppressFailures	Indique si les échecs résultant de l’extension seront supprimés (les échecs opérationnels tels que la connexion à la machine virtuelle ne seront pas supprimés indépendamment de cette valeur). La valeur par défaut est false.	Bool
type	Spécifie le type de l’extension ; un exemple est « CustomScriptExtension ».	corde
typeHandlerVersion	Spécifie la version du gestionnaire de scripts.	corde

VirtualMachineExtensionInstanceView

Nom	Description	Valeur
nom	Nom de l’extension de machine virtuelle.	corde
Statuts	Informations d’état de la ressource.	InstanceViewStatus []
sous-état	Informations d’état de la ressource.	InstanceViewStatus []
type	Spécifie le type de l’extension ; un exemple est « CustomScriptExtension ».	corde
typeHandlerVersion	Spécifie la version du gestionnaire de scripts.	corde

InstanceViewStatus

Nom	Description	Valeur
code	Code d’état.	corde
displayStatus	Étiquette localisable courte pour l’état.	corde
niveau	Code de niveau.	'Erreur' 'Info' 'Avertissement'
Message	Message d’état détaillé, y compris pour les alertes et les messages d’erreur.	corde
Heure	Heure de l’état.	corde

KeyVaultSecretReference

Nom	Description	Valeur
secretUrl	URL référençant un secret dans un coffre de clés.	chaîne (obligatoire)
sourceVault	URL relative du coffre de clés contenant le secret.	subResource (obligatoire)

Sous-ressource

Nom	Description	Valeur
id	ID de ressource	corde

Définition de ressource Terraform (fournisseur AzAPI)

Le type de ressource virtualMachineScaleSets/virtualMachines/extensions peut être déployé avec des opérations qui ciblent :

groupes de ressources

Pour obtenir la liste des propriétés modifiées dans chaque version de l’API, consultez journal des modifications.

Format de ressource

Pour créer une ressource Microsoft.Compute/virtualMachineScaleSets/virtualMachines/extensions, ajoutez le terraform suivant à votre modèle.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Compute/virtualMachineScaleSets/virtualMachines/extensions@2023-09-01"
  name = "string"
  location = "string"
  parent_id = "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"
      }
      protectedSettingsFromKeyVault = {
        secretUrl = "string"
        sourceVault = {
          id = "string"
        }
      }
      provisionAfterExtensions = [
        "string"
      ]
      publisher = "string"
      suppressFailures = bool
      type = "string"
      typeHandlerVersion = "string"
    }
  })
}

Valeurs de propriété

virtualMachineScaleSets/virtualMachines/extensions

Nom	Description	Valeur
type	Type de ressource	« Microsoft.Compute/virtualMachineScaleSets/virtualMachines/extensions@2023-09-01 »
nom	Nom de la ressource	chaîne (obligatoire)
emplacement	Emplacement de l’extension.	corde
parent_id	ID de la ressource qui est le parent de cette ressource.	ID de ressource de type : virtualMachines
Propriétés	Décrit les propriétés d’une extension de machine virtuelle.	VirtualMachineExtensionProperties

VirtualMachineExtensionProperties

Nom	Description	Valeur
autoUpgradeMinorVersion	Indique si l’extension doit utiliser une version mineure plus récente si elle est disponible au moment du déploiement. Une fois déployée, toutefois, l’extension ne met pas à niveau les versions mineures, sauf si elle est redéployée, même avec cette propriété définie sur true.	Bool
enableAutomaticUpgrade	Indique si l’extension doit être automatiquement mise à niveau par la plateforme s’il existe une version plus récente de l’extension disponible.	Bool
forceUpdateTag	Comment le gestionnaire d’extensions doit être forcé de mettre à jour même si la configuration de l’extension n’a pas changé.	corde
instanceView	Vue d’instance d’extension de machine virtuelle.	VirtualMachineExtensionInstanceView
protectedSettings	L’extension peut contenir protectedSettings ou protectedSettingsFromKeyVault ou aucun paramètre protégé du tout.
protectedSettingsFromKeyVault	Paramètres protégés par extensions passés par référence et consommés à partir du coffre de clés	KeyVaultSecretReference
provisionAfterExtensions	Collection de noms d’extensions après lesquels cette extension doit être provisionnée.	string[]
éditeur	Nom du serveur de publication du gestionnaire d’extensions.	corde
Paramètres	Paramètres publics au format Json pour l’extension.
suppressFailures	Indique si les échecs résultant de l’extension seront supprimés (les échecs opérationnels tels que la connexion à la machine virtuelle ne seront pas supprimés indépendamment de cette valeur). La valeur par défaut est false.	Bool
type	Spécifie le type de l’extension ; un exemple est « CustomScriptExtension ».	corde
typeHandlerVersion	Spécifie la version du gestionnaire de scripts.	corde

VirtualMachineExtensionInstanceView

Nom	Description	Valeur
nom	Nom de l’extension de machine virtuelle.	corde
Statuts	Informations d’état de la ressource.	InstanceViewStatus []
sous-état	Informations d’état de la ressource.	InstanceViewStatus []
type	Spécifie le type de l’extension ; un exemple est « CustomScriptExtension ».	corde
typeHandlerVersion	Spécifie la version du gestionnaire de scripts.	corde

InstanceViewStatus

Nom	Description	Valeur
code	Code d’état.	corde
displayStatus	Étiquette localisable courte pour l’état.	corde
niveau	Code de niveau.	« Erreur » « Info » « Avertissement »
Message	Message d’état détaillé, y compris pour les alertes et les messages d’erreur.	corde
Heure	Heure de l’état.	corde

KeyVaultSecretReference

Nom	Description	Valeur
secretUrl	URL référençant un secret dans un coffre de clés.	chaîne (obligatoire)
sourceVault	URL relative du coffre de clés contenant le secret.	subResource (obligatoire)

Sous-ressource

Nom	Description	Valeur
id	ID de ressource	corde

Partager via

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

Définition de ressource Bicep

Format de ressource

Valeurs de propriété

virtualMachineScaleSets/virtualMachines/extensions

VirtualMachineExtensionProperties

VirtualMachineExtensionInstanceView

InstanceViewStatus

KeyVaultSecretReference

Sous-ressource

Définition de ressource de modèle ARM

Format de ressource

Valeurs de propriété

virtualMachineScaleSets/virtualMachines/extensions

VirtualMachineExtensionProperties

VirtualMachineExtensionInstanceView

InstanceViewStatus

KeyVaultSecretReference

Sous-ressource

Définition de ressource Terraform (fournisseur AzAPI)

Format de ressource

Valeurs de propriété

virtualMachineScaleSets/virtualMachines/extensions

VirtualMachineExtensionProperties

VirtualMachineExtensionInstanceView

InstanceViewStatus

KeyVaultSecretReference

Sous-ressource

Commentaires

Ressources supplémentaires