Partilhar via

Microsoft.Compute virtualMachineScaleSets/virtualMachines/extensions 2024-07-01

  • Artigo

Definição de recursos do bíceps

O tipo de recurso virtualMachineScaleSets/virtualMachines/extensions pode ser implantado com operações direcionadas:

Para obter uma lista de propriedades alteradas em cada versão da API, consulte log de alterações.

Formato do recurso

Para criar um recurso Microsoft.Compute/virtualMachineScaleSets/virtualMachines/extensions, adicione o seguinte Bicep ao seu modelo.

resource symbolicname 'Microsoft.Compute/virtualMachineScaleSets/virtualMachines/extensions@2024-07-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'
  }
}

Valores de propriedade

InstanceViewStatus

Designação Descrição Valor
código O código de status. string
displayStatus O rótulo curto localizável para o status. string
nível O código de nível. 'Erro'
'Informações'
'Atenção'
Mensagem A mensagem de status detalhada, inclusive para alertas e mensagens de erro. string
Hora A hora do status. string

KeyVaultSecretReference

Designação Descrição Valor
secretUrl O URL que faz referência a um segredo em um Cofre de Chaves. string (obrigatório)
fonteVault O URL relativo do Cofre da Chave que contém o segredo. de Subrecursos (obrigatório)

Microsoft.Compute/virtualMachineScaleSets/virtualMachines/extensões

Designação Descrição Valor
Localização A localização da extensão. string
Designação O nome do recurso string (obrigatório)
pai No Bicep, você pode especificar o recurso pai para um recurso filho. Você só precisa adicionar essa propriedade quando o recurso filho é declarado fora do recurso pai.

Para obter mais informações, consulte recurso filho fora do recurso pai.		 Nome simbólico para o recurso do tipo: virtualMachineScaleSets/virtualMachines
propriedades Descreve as propriedades de uma extensão de máquina virtual. VirtualMachineExtensionProperties

Subrecurso

Designação Descrição Valor
ID ID do recurso string

VirtualMachineExtensionInstanceView

Designação Descrição Valor
Designação O nome da extensão da máquina virtual. string
estados As informações de status do recurso. InstanceViewStatus []
substatus As informações de status do recurso. InstanceViewStatus []
tipo Especifica o tipo da extensão; um exemplo é "CustomScriptExtension". string
typeHandlerVersion Especifica a versão do manipulador de script. string

VirtualMachineExtensionProperties

Designação Descrição Valor
autoUpgradeMinorVersion Indica se a extensão deve usar uma versão secundária mais recente, se uma estiver disponível no momento da implantação. Uma vez implantada, no entanto, a extensão não atualizará versões secundárias, a menos que seja reimplantada, mesmo com essa propriedade definida como true. Bool
enableAutomaticUpgrade Indica se a extensão deve ser atualizada automaticamente pela plataforma se houver uma versão mais recente da extensão disponível. Bool
forceUpdateTag Como o manipulador de extensão deve ser forçado a atualizar mesmo que a configuração da extensão não tenha sido alterada. string
instânciaVer A exibição da instância de extensão de máquina virtual. VirtualMachineExtensionInstanceView
protegido Configurações A extensão pode conter protectedSettings ou protectedSettingsFromKeyVault ou nenhuma configuração protegida. qualquer
protectedSettingsFromKeyVault As extensões protegem as configurações que são passadas por referência e consumidas do cofre de chaves KeyVaultSecretReference
provisionAfterExtensions Coleção de nomes de extensão após a qual essa extensão precisa ser provisionada. string[]
editora O nome do editor do manipulador de extensão. string
Configurações Json formatou configurações públicas para a extensão. qualquer
suprimirFalhas Indica se as falhas decorrentes da extensão serão suprimidas (Falhas operacionais, como não se conectar à VM, não serão suprimidas, independentemente desse valor). O padrão é false. Bool
tipo Especifica o tipo da extensão; um exemplo é "CustomScriptExtension". string
typeHandlerVersion Especifica a versão do manipulador de script. string

Definição de recurso de modelo ARM

O tipo de recurso virtualMachineScaleSets/virtualMachines/extensions pode ser implantado com operações direcionadas:

Para obter uma lista de propriedades alteradas em cada versão da API, consulte log de alterações.

Formato do recurso

Para criar um recurso Microsoft.Compute/virtualMachineScaleSets/virtualMachines/extensions, adicione o seguinte JSON ao seu modelo.

{
  "type": "Microsoft.Compute/virtualMachineScaleSets/virtualMachines/extensions",
  "apiVersion": "2024-07-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"
  }
}

Valores de propriedade

InstanceViewStatus

Designação Descrição Valor
código O código de status. string
displayStatus O rótulo curto localizável para o status. string
nível O código de nível. 'Erro'
'Informações'
'Atenção'
Mensagem A mensagem de status detalhada, inclusive para alertas e mensagens de erro. string
Hora A hora do status. string

KeyVaultSecretReference

Designação Descrição Valor
secretUrl O URL que faz referência a um segredo em um Cofre de Chaves. string (obrigatório)
fonteVault O URL relativo do Cofre da Chave que contém o segredo. de Subrecursos (obrigatório)

Microsoft.Compute/virtualMachineScaleSets/virtualMachines/extensões

Designação Descrição Valor
apiVersion A versão api '2024-07-01'
Localização A localização da extensão. string
Designação O nome do recurso string (obrigatório)
propriedades Descreve as propriedades de uma extensão de máquina virtual. VirtualMachineExtensionProperties
tipo O tipo de recurso 'Microsoft.Compute/virtualMachineScaleSets/virtualMachines/extensions'

Subrecurso

Designação Descrição Valor
ID ID do recurso string

VirtualMachineExtensionInstanceView

Designação Descrição Valor
Designação O nome da extensão da máquina virtual. string
estados As informações de status do recurso. InstanceViewStatus []
substatus As informações de status do recurso. InstanceViewStatus []
tipo Especifica o tipo da extensão; um exemplo é "CustomScriptExtension". string
typeHandlerVersion Especifica a versão do manipulador de script. string

VirtualMachineExtensionProperties

Designação Descrição Valor
autoUpgradeMinorVersion Indica se a extensão deve usar uma versão secundária mais recente, se uma estiver disponível no momento da implantação. Uma vez implantada, no entanto, a extensão não atualizará versões secundárias, a menos que seja reimplantada, mesmo com essa propriedade definida como true. Bool
enableAutomaticUpgrade Indica se a extensão deve ser atualizada automaticamente pela plataforma se houver uma versão mais recente da extensão disponível. Bool
forceUpdateTag Como o manipulador de extensão deve ser forçado a atualizar mesmo que a configuração da extensão não tenha sido alterada. string
instânciaVer A exibição da instância de extensão de máquina virtual. VirtualMachineExtensionInstanceView
protegido Configurações A extensão pode conter protectedSettings ou protectedSettingsFromKeyVault ou nenhuma configuração protegida. qualquer
protectedSettingsFromKeyVault As extensões protegem as configurações que são passadas por referência e consumidas do cofre de chaves KeyVaultSecretReference
provisionAfterExtensions Coleção de nomes de extensão após a qual essa extensão precisa ser provisionada. string[]
editora O nome do editor do manipulador de extensão. string
Configurações Json formatou configurações públicas para a extensão. qualquer
suprimirFalhas Indica se as falhas decorrentes da extensão serão suprimidas (Falhas operacionais, como não se conectar à VM, não serão suprimidas, independentemente desse valor). O padrão é false. Bool
tipo Especifica o tipo da extensão; um exemplo é "CustomScriptExtension". string
typeHandlerVersion Especifica a versão do manipulador de script. string

Definição de recursos Terraform (provedor AzAPI)

O tipo de recurso virtualMachineScaleSets/virtualMachines/extensions pode ser implantado com operações direcionadas:

  • Grupos de recursos

Para obter uma lista de propriedades alteradas em cada versão da API, consulte log de alterações.

Formato do recurso

Para criar um recurso Microsoft.Compute/virtualMachineScaleSets/virtualMachines/extensions, adicione o seguinte Terraform ao seu modelo.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Compute/virtualMachineScaleSets/virtualMachines/extensions@2024-07-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"
    }
  })
}

Valores de propriedade

InstanceViewStatus

Designação Descrição Valor
código O código de status. string
displayStatus O rótulo curto localizável para o status. string
nível O código de nível. 'Erro'
'Informações'
'Atenção'
Mensagem A mensagem de status detalhada, inclusive para alertas e mensagens de erro. string
Hora A hora do status. string

KeyVaultSecretReference

Designação Descrição Valor
secretUrl O URL que faz referência a um segredo em um Cofre de Chaves. string (obrigatório)
fonteVault O URL relativo do Cofre da Chave que contém o segredo. de Subrecursos (obrigatório)

Microsoft.Compute/virtualMachineScaleSets/virtualMachines/extensões

Designação Descrição Valor
Localização A localização da extensão. string
Designação O nome do recurso string (obrigatório)
parent_id A ID do recurso que é o pai para este recurso. ID do recurso do tipo: virtualMachineScaleSets/virtualMachines
propriedades Descreve as propriedades de uma extensão de máquina virtual. VirtualMachineExtensionProperties
tipo O tipo de recurso "Microsoft.Compute/virtualMachineScaleSets/virtualMachines/extensions@2024-07-01"

Subrecurso

Designação Descrição Valor
ID ID do recurso string

VirtualMachineExtensionInstanceView

Designação Descrição Valor
Designação O nome da extensão da máquina virtual. string
estados As informações de status do recurso. InstanceViewStatus []
substatus As informações de status do recurso. InstanceViewStatus []
tipo Especifica o tipo da extensão; um exemplo é "CustomScriptExtension". string
typeHandlerVersion Especifica a versão do manipulador de script. string

VirtualMachineExtensionProperties

Designação Descrição Valor
autoUpgradeMinorVersion Indica se a extensão deve usar uma versão secundária mais recente, se uma estiver disponível no momento da implantação. Uma vez implantada, no entanto, a extensão não atualizará versões secundárias, a menos que seja reimplantada, mesmo com essa propriedade definida como true. Bool
enableAutomaticUpgrade Indica se a extensão deve ser atualizada automaticamente pela plataforma se houver uma versão mais recente da extensão disponível. Bool
forceUpdateTag Como o manipulador de extensão deve ser forçado a atualizar mesmo que a configuração da extensão não tenha sido alterada. string
instânciaVer A exibição da instância de extensão de máquina virtual. VirtualMachineExtensionInstanceView
protegido Configurações A extensão pode conter protectedSettings ou protectedSettingsFromKeyVault ou nenhuma configuração protegida. qualquer
protectedSettingsFromKeyVault As extensões protegem as configurações que são passadas por referência e consumidas do cofre de chaves KeyVaultSecretReference
provisionAfterExtensions Coleção de nomes de extensão após a qual essa extensão precisa ser provisionada. string[]
editora O nome do editor do manipulador de extensão. string
Configurações Json formatou configurações públicas para a extensão. qualquer
suprimirFalhas Indica se as falhas decorrentes da extensão serão suprimidas (Falhas operacionais, como não se conectar à VM, não serão suprimidas, independentemente desse valor). O padrão é false. Bool
tipo Especifica o tipo da extensão; um exemplo é "CustomScriptExtension". string
typeHandlerVersion Especifica a versão do manipulador de script. string