Microsoft.Compute virtualMachineScaleSets/virtualMachines/extensions 2022-03-01

  • Artículo

Definición de recursos de Bicep

El tipo de recurso virtualMachineScaleSets/virtualMachines/extensions 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 los recursos

Para crear un recurso Microsoft.Compute/virtualMachineScaleSets/virtualMachines/extensions, agregue el siguiente bicep a la plantilla.

resource symbolicname 'Microsoft.Compute/virtualMachineScaleSets/virtualMachines/extensions@2022-03-01' = {
  name: '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'
      }
    }
    publisher: 'string'
    settings: any()
    suppressFailures: bool
    type: 'string'
    typeHandlerVersion: 'string'
  }
}

Valores de propiedad

virtualMachineScaleSets/virtualMachines/extensions

Nombre Descripción Value
name El nombre del recurso

Vea cómo establecer nombres y tipos para recursos secundarios en Bicep.		 string (obligatorio)
primario En Bicep, puede especificar el recurso primario para un recurso secundario. Solo tiene que agregar esta propiedad cuando el recurso secundario se declara fuera del recurso primario.

Para más información, consulte Recurso secundario fuera del recurso primario.		 Nombre simbólico del recurso de tipo: virtualMachines
properties Describe las propiedades de una extensión de máquina virtual. VirtualMachineExtensionProperties

VirtualMachineExtensionProperties

Nombre Descripción Valor
autoUpgradeMinorVersion Indica si la extensión debe usar una versión secundaria más reciente si hay una disponible en el momento de la implementación. Sin embargo, una vez implementada, la extensión no actualizará las versiones secundarias a menos que se vuelva a implementar, incluso con esta propiedad establecida en true. bool
enableAutomaticUpgrade Indica si la plataforma debe actualizar automáticamente la extensión si hay una versión más reciente de la extensión disponible. bool
forceUpdateTag Cómo se debe forzar el controlador de extensión para actualizar incluso si la configuración de la extensión no ha cambiado. string
instanceView Vista de instancia de extensión de máquina virtual. VirtualMachineExtensionInstanceView
protectedSettings La extensión puede contener protectedSettings o protectedSettingsFromKeyVault o ninguna configuración protegida. Para Bicep, puede usar la función any().
protectedSettingsFromKeyVault Configuración protegida de extensiones que se pasan por referencia y que se consumen desde el almacén de claves. KeyVaultSecretReference
publisher Nombre del publicador de controladores de extensión. string
configuración Configuración pública con formato JSON para la extensión. Para Bicep, puede usar la función any().
suppressFailures Indica si los errores derivados de la extensión se suprimirán (los errores operativos, como no conectarse a la máquina virtual, no se suprimirán independientemente de este valor). El valor predeterminado es false. bool
tipo Especifica el tipo de la extensión; Un ejemplo es "CustomScriptExtension". string
typeHandlerVersion Especifica la versión del controlador de script. string

VirtualMachineExtensionInstanceView

Nombre Descripción Value
name Nombre de la extensión de máquina virtual. string
statuses Información de estado del recurso. InstanceViewStatus[]
subestados Información de estado del recurso. InstanceViewStatus[]
tipo Especifica el tipo de la extensión; Un ejemplo es "CustomScriptExtension". string
typeHandlerVersion Especifica la versión del controlador de script. string

InstanceViewStatus

Nombre Descripción Valor
código Código de estado. string
displayStatus Etiqueta localizable corta para el estado. string
Nivel El código de nivel. 'Error'
'Info'
'Advertencia'
message Mensaje de estado detallado, incluidas las alertas y los mensajes de error. string
time Hora del estado. string

KeyVaultSecretReference

Nombre Descripción Valor
secretUrl Dirección URL que hace referencia a un secreto en un Key Vault. string (obligatorio)
sourceVault Dirección URL relativa del Key Vault que contiene el secreto. SubResource (obligatorio)

SubResource

Nombre Descripción Value
id Id. de recurso string

Definición de recursos de plantilla de ARM

El tipo de recurso virtualMachineScaleSets/virtualMachines/extensions 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 los recursos

Para crear un recurso Microsoft.Compute/virtualMachineScaleSets/virtualMachines/extensions, agregue el siguiente json a la plantilla.

{
  "type": "Microsoft.Compute/virtualMachineScaleSets/virtualMachines/extensions",
  "apiVersion": "2022-03-01",
  "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": {},
    "protectedSettingsFromKeyVault": {
      "secretUrl": "string",
      "sourceVault": {
        "id": "string"
      }
    },
    "publisher": "string",
    "settings": {},
    "suppressFailures": "bool",
    "type": "string",
    "typeHandlerVersion": "string"
  }
}

Valores de propiedad

virtualMachineScaleSets/virtualMachines/extensions

Nombre Descripción Value
type Tipo de recurso 'Microsoft.Compute/virtualMachineScaleSets/virtualMachines/extensions'
apiVersion La versión de la API de recursos '2022-03-01'
name El nombre del recurso

Vea cómo establecer nombres y tipos para recursos secundarios en plantillas de ARM JSON.		 string (obligatorio)
properties Describe las propiedades de una extensión de máquina virtual. VirtualMachineExtensionProperties

VirtualMachineExtensionProperties

Nombre Descripción Valor
autoUpgradeMinorVersion Indica si la extensión debe usar una versión secundaria más reciente si hay una disponible en el momento de la implementación. Sin embargo, una vez implementada, la extensión no actualizará las versiones secundarias a menos que se vuelva a implementar, incluso con esta propiedad establecida en true. bool
enableAutomaticUpgrade Indica si la plataforma debe actualizar automáticamente la extensión si hay una versión más reciente de la extensión disponible. bool
forceUpdateTag Cómo se debe forzar el controlador de extensión para actualizar incluso si la configuración de la extensión no ha cambiado. string
instanceView Vista de instancia de extensión de máquina virtual. VirtualMachineExtensionInstanceView
protectedSettings La extensión puede contener protectedSettings o protectedSettingsFromKeyVault o ninguna configuración protegida.
protectedSettingsFromKeyVault Configuración protegida de extensiones que se pasan por referencia y que se consumen desde el almacén de claves. KeyVaultSecretReference
publisher Nombre del publicador de controladores de extensión. string
configuración Configuración pública con formato JSON para la extensión.
suppressFailures Indica si los errores derivados de la extensión se suprimirán (los errores operativos, como no conectarse a la máquina virtual, no se suprimirán independientemente de este valor). El valor predeterminado es false. bool
tipo Especifica el tipo de la extensión; Un ejemplo es "CustomScriptExtension". string
typeHandlerVersion Especifica la versión del controlador de script. string

VirtualMachineExtensionInstanceView

Nombre Descripción Value
name Nombre de la extensión de máquina virtual. string
statuses Información de estado del recurso. InstanceViewStatus[]
subestados Información de estado del recurso. InstanceViewStatus[]
tipo Especifica el tipo de la extensión; Un ejemplo es "CustomScriptExtension". string
typeHandlerVersion Especifica la versión del controlador de script. string

InstanceViewStatus

Nombre Descripción Valor
código Código de estado. string
displayStatus Etiqueta localizable corta para el estado. string
Nivel El código de nivel. 'Error'
'Info'
'Advertencia'
message Mensaje de estado detallado, incluidas las alertas y los mensajes de error. string
time Hora del estado. string

KeyVaultSecretReference

Nombre Descripción Valor
secretUrl Dirección URL que hace referencia a un secreto en un Key Vault. string (obligatorio)
sourceVault Dirección URL relativa del Key Vault que contiene el secreto. SubResource (obligatorio)

SubResource

Nombre Descripción Value
id Id. de recurso string

Definición de recursos de Terraform (proveedor AzAPI)

El tipo de recurso virtualMachineScaleSets/virtualMachines/extensions se puede implementar con operaciones destinadas a:

  • Grupos de recursos

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

Formato de los recursos

Para crear un recurso Microsoft.Compute/virtualMachineScaleSets/virtualMachines/extensions, agregue el siguiente terraform a la plantilla.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Compute/virtualMachineScaleSets/virtualMachines/extensions@2022-03-01"
  name = "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"
        }
      }
      publisher = "string"
      suppressFailures = bool
      type = "string"
      typeHandlerVersion = "string"
    }
  })
}

Valores de propiedad

virtualMachineScaleSets/virtualMachines/extensions

Nombre Descripción Value
type Tipo de recurso "Microsoft.Compute/virtualMachineScaleSets/virtualMachines/extensions@2022-03-01"
name El nombre del recurso string (obligatorio)
parent_id Identificador del recurso que es el elemento primario de este recurso. Identificador del recurso de tipo: virtualMachines
properties Describe las propiedades de una extensión de máquina virtual. VirtualMachineExtensionProperties

VirtualMachineExtensionProperties

Nombre Descripción Valor
autoUpgradeMinorVersion Indica si la extensión debe usar una versión secundaria más reciente si hay una disponible en el momento de la implementación. Sin embargo, una vez implementada, la extensión no actualizará las versiones secundarias a menos que se vuelva a implementar, incluso con esta propiedad establecida en true. bool
enableAutomaticUpgrade Indica si la plataforma debe actualizar automáticamente la extensión si hay una versión más reciente de la extensión disponible. bool
forceUpdateTag Cómo se debe forzar el controlador de extensión para actualizar incluso si la configuración de la extensión no ha cambiado. string
instanceView Vista de instancia de extensión de máquina virtual. VirtualMachineExtensionInstanceView
protectedSettings La extensión puede contener protectedSettings o protectedSettingsFromKeyVault o ninguna configuración protegida.
protectedSettingsFromKeyVault Configuración protegida de extensiones que se pasan por referencia y que se consumen desde el almacén de claves. KeyVaultSecretReference
publisher Nombre del publicador de controladores de extensión. string
configuración Configuración pública con formato JSON para la extensión.
suppressFailures Indica si los errores derivados de la extensión se suprimirán (los errores operativos, como no conectarse a la máquina virtual, no se suprimirán independientemente de este valor). El valor predeterminado es false. bool
tipo Especifica el tipo de la extensión; Un ejemplo es "CustomScriptExtension". string
typeHandlerVersion Especifica la versión del controlador de script. string

VirtualMachineExtensionInstanceView

Nombre Descripción Value
name Nombre de la extensión de máquina virtual. string
statuses Información de estado del recurso. InstanceViewStatus[]
subestados Información de estado del recurso. InstanceViewStatus[]
tipo Especifica el tipo de la extensión; Un ejemplo es "CustomScriptExtension". string
typeHandlerVersion Especifica la versión del controlador de script. string

InstanceViewStatus

Nombre Descripción Valor
código Código de estado. string
displayStatus Etiqueta localizable corta para el estado. string
Nivel El código de nivel. "Error"
"Información"
"Warning"
message Mensaje de estado detallado, incluidas las alertas y los mensajes de error. string
time Hora del estado. string

KeyVaultSecretReference

Nombre Descripción Valor
secretUrl Dirección URL que hace referencia a un secreto en un Key Vault. string (obligatorio)
sourceVault Dirección URL relativa del Key Vault que contiene el secreto. SubResource (obligatorio)

SubResource

Nombre Descripción Value
id Id. de recurso string