Compartilhar via

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

  • Artigo

Definição de recurso do Bicep

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

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

Formato de recurso

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

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

Valores de propriedade

InstanceViewStatus

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

KeyVaultSecretReference

Nome Descrição Valor
secretUrl A URL que faz referência a um segredo em um Key Vault. cadeia de caracteres (obrigatório)
sourceVault A URL relativa do Key Vault que contém o segredo. SubResource (obrigatório)

Microsoft.Compute/virtualMachineScaleSets/virtualMachines/extensions

Nome Descrição Valor
localização O local da extensão. corda
nome O nome do recurso cadeia de caracteres (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 recurso do tipo: virtualMachineScaleSets/virtualMachines
Propriedades Descreve as propriedades de uma extensão de máquina virtual. VirtualMachineExtensionProperties

SubResource

Nome Descrição Valor
id ID do recurso corda

VirtualMachineExtensionInstanceView

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

VirtualMachineExtensionProperties

Nome 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 de extensão não tenha sido alterada. corda
instanceView O modo de exibição da instância de extensão da máquina virtual. VirtualMachineExtensionInstanceView
protectedSettings A extensão pode conter protectedSettings ou protectedSettingsFromKeyVault ou nenhuma configuração protegida. qualquer
protectedSettingsFromKeyVault As configurações protegidas de extensõ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 o qual essa extensão precisa ser provisionada. string[]
editor O nome do editor do manipulador de extensão. corda
Configurações Configurações públicas formatadas em Json para a extensão. qualquer
suppressFailures 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". corda
typeHandlerVersion Especifica a versão do manipulador de script. corda

Definição de recurso de modelo do ARM

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

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

Formato de recurso

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

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

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

KeyVaultSecretReference

Nome Descrição Valor
secretUrl A URL que faz referência a um segredo em um Key Vault. cadeia de caracteres (obrigatório)
sourceVault A URL relativa do Key Vault que contém o segredo. SubResource (obrigatório)

Microsoft.Compute/virtualMachineScaleSets/virtualMachines/extensions

Nome Descrição Valor
apiVersion A versão da API '2023-07-01'
localização O local da extensão. corda
nome O nome do recurso cadeia de caracteres (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'

SubResource

Nome Descrição Valor
id ID do recurso corda

VirtualMachineExtensionInstanceView

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

VirtualMachineExtensionProperties

Nome 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 de extensão não tenha sido alterada. corda
instanceView O modo de exibição da instância de extensão da máquina virtual. VirtualMachineExtensionInstanceView
protectedSettings A extensão pode conter protectedSettings ou protectedSettingsFromKeyVault ou nenhuma configuração protegida. qualquer
protectedSettingsFromKeyVault As configurações protegidas de extensõ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 o qual essa extensão precisa ser provisionada. string[]
editor O nome do editor do manipulador de extensão. corda
Configurações Configurações públicas formatadas em Json para a extensão. qualquer
suppressFailures 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". corda
typeHandlerVersion Especifica a versão do manipulador de script. corda

Exemplos de uso

Definição de recurso do Terraform (provedor de AzAPI)

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

  • grupos de recursos

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

Formato de recurso

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

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

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

KeyVaultSecretReference

Nome Descrição Valor
secretUrl A URL que faz referência a um segredo em um Key Vault. cadeia de caracteres (obrigatório)
sourceVault A URL relativa do Key Vault que contém o segredo. SubResource (obrigatório)

Microsoft.Compute/virtualMachineScaleSets/virtualMachines/extensions

Nome Descrição Valor
localização O local da extensão. corda
nome O nome do recurso cadeia de caracteres (obrigatório)
parent_id A ID do recurso que é o pai desse 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@2023-07-01"

SubResource

Nome Descrição Valor
id ID do recurso corda

VirtualMachineExtensionInstanceView

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

VirtualMachineExtensionProperties

Nome 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 de extensão não tenha sido alterada. corda
instanceView O modo de exibição da instância de extensão da máquina virtual. VirtualMachineExtensionInstanceView
protectedSettings A extensão pode conter protectedSettings ou protectedSettingsFromKeyVault ou nenhuma configuração protegida. qualquer
protectedSettingsFromKeyVault As configurações protegidas de extensõ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 o qual essa extensão precisa ser provisionada. string[]
editor O nome do editor do manipulador de extensão. corda
Configurações Configurações públicas formatadas em Json para a extensão. qualquer
suppressFailures 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". corda
typeHandlerVersion Especifica a versão do manipulador de script. corda