Przeczytaj w języku angielskim

Udostępnij za pośrednictwem

Microsoft.Compute virtualMachineScaleSets/virtualMachines/extensions

  • Artykuł
Wybieranie języka wdrażania

Definicja zasobu Bicep

Typ zasobu virtualMachineScaleSets/virtualMachines/extensions można wdrożyć z operacjami docelowymi:

Aby uzyskać listę zmienionych właściwości w każdej wersji interfejsu API, zobacz dziennika zmian.

Format zasobu

Aby utworzyć zasób Microsoft.Compute/virtualMachineScaleSets/virtualMachines/extensions, dodaj następujący kod Bicep do szablonu.

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(...)
    protectedSettingsFromKeyVault: {
      secretUrl: 'string'
      sourceVault: {
        id: 'string'
      }
    }
    provisionAfterExtensions: [
      'string'
    ]
    publisher: 'string'
    settings: any(...)
    suppressFailures: bool
    type: 'string'
    typeHandlerVersion: 'string'
  }
}

Wartości właściwości

InstanceViewStatus

Nazwa Opis Wartość
kod Kod stanu. struna
displayStatus Krótka etykieta lokalizowalna dla stanu. struna
poziom Kod poziomu. "Błąd"
"Informacje"
"Ostrzeżenie"
Komunikat Szczegółowy komunikat o stanie, w tym alerty i komunikaty o błędach. struna
Godzina Czas stanu. struna

KeyVaultSecretReference

Nazwa Opis Wartość
secretUrl Adres URL odwołujący się do wpisu tajnego w usłudze Key Vault. ciąg (wymagany)
sourceVault Względny adres URL usługi Key Vault zawierający wpis tajny. SubResource (wymagane)

Microsoft.Compute/virtualMachineScaleSets/virtualMachines/extensions

Nazwa Opis Wartość
lokalizacja Lokalizacja rozszerzenia. struna
nazwa Nazwa zasobu ciąg (wymagany)
rodzic W Bicep można określić zasób nadrzędny dla zasobu podrzędnego. Tę właściwość należy dodać tylko wtedy, gdy zasób podrzędny jest zadeklarowany poza zasobem nadrzędnym.

Aby uzyskać więcej informacji, zobacz Zasób podrzędny poza zasobem nadrzędnym.		 Nazwa symboliczna zasobu typu: virtualMachineScaleSets/virtualMachines
Właściwości Opisuje właściwości rozszerzenia maszyny wirtualnej. VirtualMachineExtensionProperties

Podźródło

Nazwa Opis Wartość
id Identyfikator zasobu struna

VirtualMachineExtensionInstanceView

Nazwa Opis Wartość
nazwa Nazwa rozszerzenia maszyny wirtualnej. struna
Statusy Informacje o stanie zasobu. InstanceViewStatus[]
podstatuses Informacje o stanie zasobu. InstanceViewStatus[]
typ Określa typ rozszerzenia; przykładem jest "CustomScriptExtension". struna
typeHandlerVersion Określa wersję programu obsługi skryptów. struna

VirtualMachineExtensionProperties

Nazwa Opis Wartość
autoUpgradeMinorVersion Wskazuje, czy rozszerzenie powinno używać nowszej wersji pomocniczej, jeśli jest ona dostępna w czasie wdrażania. Po wdrożeniu rozszerzenie nie uaktualni wersji pomocniczych, chyba że zostanie ponownie wdrożone, nawet jeśli ta właściwość ma wartość true. Bool
enableAutomaticUpgrade Wskazuje, czy rozszerzenie powinno zostać automatycznie uaktualnione przez platformę, jeśli jest dostępna nowsza wersja rozszerzenia. Bool
forceUpdateTag Sposób, w jaki program obsługi rozszerzeń powinien zostać zmuszony do aktualizacji, nawet jeśli konfiguracja rozszerzenia nie uległa zmianie. struna
instanceView Widok wystąpienia rozszerzenia maszyny wirtualnej. VirtualMachineExtensionInstanceView
protectedSettings Rozszerzenie może zawierać ustawienia protectedSettings lub protectedSettingsFromKeyVault lub w ogóle nie są chronione. jakikolwiek
protectedSettingsFromKeyVault Rozszerzenia chronione ustawienia, które są przekazywane przez odwołanie i używane z magazynu kluczy KeyVaultSecretReference
provisionAfterExtensions Kolekcja nazw rozszerzeń, po których należy aprowizować to rozszerzenie. string[]
wydawca Nazwa wydawcy programu obsługi rozszerzeń. struna
Ustawienia Ustawienia publiczne w formacie Json dla rozszerzenia. jakikolwiek
suppressFailures Wskazuje, czy awarie wynikające z rozszerzenia zostaną pominięte (błędy operacyjne, takie jak brak nawiązywania połączenia z maszyną wirtualną, nie zostaną pominięte niezależnie od tej wartości). Wartość domyślna to false. Bool
typ Określa typ rozszerzenia; przykładem jest "CustomScriptExtension". struna
typeHandlerVersion Określa wersję programu obsługi skryptów. struna

Definicja zasobu szablonu usługi ARM

Typ zasobu virtualMachineScaleSets/virtualMachines/extensions można wdrożyć z operacjami docelowymi:

Aby uzyskać listę zmienionych właściwości w każdej wersji interfejsu API, zobacz dziennika zmian.

Format zasobu

Aby utworzyć zasób Microsoft.Compute/virtualMachineScaleSets/virtualMachines/extensions, dodaj następujący kod JSON do szablonu.

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

Wartości właściwości

InstanceViewStatus

Nazwa Opis Wartość
kod Kod stanu. struna
displayStatus Krótka etykieta lokalizowalna dla stanu. struna
poziom Kod poziomu. "Błąd"
"Informacje"
"Ostrzeżenie"
Komunikat Szczegółowy komunikat o stanie, w tym alerty i komunikaty o błędach. struna
Godzina Czas stanu. struna

KeyVaultSecretReference

Nazwa Opis Wartość
secretUrl Adres URL odwołujący się do wpisu tajnego w usłudze Key Vault. ciąg (wymagany)
sourceVault Względny adres URL usługi Key Vault zawierający wpis tajny. SubResource (wymagane)

Microsoft.Compute/virtualMachineScaleSets/virtualMachines/extensions

Nazwa Opis Wartość
apiVersion Wersja interfejsu API '2024-07-01'
lokalizacja Lokalizacja rozszerzenia. struna
nazwa Nazwa zasobu ciąg (wymagany)
Właściwości Opisuje właściwości rozszerzenia maszyny wirtualnej. VirtualMachineExtensionProperties
typ Typ zasobu "Microsoft.Compute/virtualMachineScaleSets/virtualMachines/extensions"

Podźródło

Nazwa Opis Wartość
id Identyfikator zasobu struna

VirtualMachineExtensionInstanceView

Nazwa Opis Wartość
nazwa Nazwa rozszerzenia maszyny wirtualnej. struna
Statusy Informacje o stanie zasobu. InstanceViewStatus[]
podstatuses Informacje o stanie zasobu. InstanceViewStatus[]
typ Określa typ rozszerzenia; przykładem jest "CustomScriptExtension". struna
typeHandlerVersion Określa wersję programu obsługi skryptów. struna

VirtualMachineExtensionProperties

Nazwa Opis Wartość
autoUpgradeMinorVersion Wskazuje, czy rozszerzenie powinno używać nowszej wersji pomocniczej, jeśli jest ona dostępna w czasie wdrażania. Po wdrożeniu rozszerzenie nie uaktualni wersji pomocniczych, chyba że zostanie ponownie wdrożone, nawet jeśli ta właściwość ma wartość true. Bool
enableAutomaticUpgrade Wskazuje, czy rozszerzenie powinno zostać automatycznie uaktualnione przez platformę, jeśli jest dostępna nowsza wersja rozszerzenia. Bool
forceUpdateTag Sposób, w jaki program obsługi rozszerzeń powinien zostać zmuszony do aktualizacji, nawet jeśli konfiguracja rozszerzenia nie uległa zmianie. struna
instanceView Widok wystąpienia rozszerzenia maszyny wirtualnej. VirtualMachineExtensionInstanceView
protectedSettings Rozszerzenie może zawierać ustawienia protectedSettings lub protectedSettingsFromKeyVault lub w ogóle nie są chronione. jakikolwiek
protectedSettingsFromKeyVault Rozszerzenia chronione ustawienia, które są przekazywane przez odwołanie i używane z magazynu kluczy KeyVaultSecretReference
provisionAfterExtensions Kolekcja nazw rozszerzeń, po których należy aprowizować to rozszerzenie. string[]
wydawca Nazwa wydawcy programu obsługi rozszerzeń. struna
Ustawienia Ustawienia publiczne w formacie Json dla rozszerzenia. jakikolwiek
suppressFailures Wskazuje, czy awarie wynikające z rozszerzenia zostaną pominięte (błędy operacyjne, takie jak brak nawiązywania połączenia z maszyną wirtualną, nie zostaną pominięte niezależnie od tej wartości). Wartość domyślna to false. Bool
typ Określa typ rozszerzenia; przykładem jest "CustomScriptExtension". struna
typeHandlerVersion Określa wersję programu obsługi skryptów. struna

Przykłady użycia

Definicja zasobu narzędzia Terraform (dostawcy AzAPI)

Typ zasobu virtualMachineScaleSets/virtualMachines/extensions można wdrożyć z operacjami docelowymi:

  • grupy zasobów

Aby uzyskać listę zmienionych właściwości w każdej wersji interfejsu API, zobacz dziennika zmian.

Format zasobu

Aby utworzyć zasób Microsoft.Compute/virtualMachineScaleSets/virtualMachines/extensions, dodaj następujący program Terraform do szablonu.

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

Wartości właściwości

InstanceViewStatus

Nazwa Opis Wartość
kod Kod stanu. struna
displayStatus Krótka etykieta lokalizowalna dla stanu. struna
poziom Kod poziomu. "Błąd"
"Informacje"
"Ostrzeżenie"
Komunikat Szczegółowy komunikat o stanie, w tym alerty i komunikaty o błędach. struna
Godzina Czas stanu. struna

KeyVaultSecretReference

Nazwa Opis Wartość
secretUrl Adres URL odwołujący się do wpisu tajnego w usłudze Key Vault. ciąg (wymagany)
sourceVault Względny adres URL usługi Key Vault zawierający wpis tajny. SubResource (wymagane)

Microsoft.Compute/virtualMachineScaleSets/virtualMachines/extensions

Nazwa Opis Wartość
lokalizacja Lokalizacja rozszerzenia. struna
nazwa Nazwa zasobu ciąg (wymagany)
parent_id Identyfikator zasobu, który jest elementem nadrzędnym dla tego zasobu. Identyfikator zasobu typu: virtualMachineScaleSets/virtualMachines
Właściwości Opisuje właściwości rozszerzenia maszyny wirtualnej. VirtualMachineExtensionProperties
typ Typ zasobu "Microsoft.Compute/virtualMachineScaleSets/virtualMachines/extensions@2024-07-01"

Podźródło

Nazwa Opis Wartość
id Identyfikator zasobu struna

VirtualMachineExtensionInstanceView

Nazwa Opis Wartość
nazwa Nazwa rozszerzenia maszyny wirtualnej. struna
Statusy Informacje o stanie zasobu. InstanceViewStatus[]
podstatuses Informacje o stanie zasobu. InstanceViewStatus[]
typ Określa typ rozszerzenia; przykładem jest "CustomScriptExtension". struna
typeHandlerVersion Określa wersję programu obsługi skryptów. struna

VirtualMachineExtensionProperties

Nazwa Opis Wartość
autoUpgradeMinorVersion Wskazuje, czy rozszerzenie powinno używać nowszej wersji pomocniczej, jeśli jest ona dostępna w czasie wdrażania. Po wdrożeniu rozszerzenie nie uaktualni wersji pomocniczych, chyba że zostanie ponownie wdrożone, nawet jeśli ta właściwość ma wartość true. Bool
enableAutomaticUpgrade Wskazuje, czy rozszerzenie powinno zostać automatycznie uaktualnione przez platformę, jeśli jest dostępna nowsza wersja rozszerzenia. Bool
forceUpdateTag Sposób, w jaki program obsługi rozszerzeń powinien zostać zmuszony do aktualizacji, nawet jeśli konfiguracja rozszerzenia nie uległa zmianie. struna
instanceView Widok wystąpienia rozszerzenia maszyny wirtualnej. VirtualMachineExtensionInstanceView
protectedSettings Rozszerzenie może zawierać ustawienia protectedSettings lub protectedSettingsFromKeyVault lub w ogóle nie są chronione. jakikolwiek
protectedSettingsFromKeyVault Rozszerzenia chronione ustawienia, które są przekazywane przez odwołanie i używane z magazynu kluczy KeyVaultSecretReference
provisionAfterExtensions Kolekcja nazw rozszerzeń, po których należy aprowizować to rozszerzenie. string[]
wydawca Nazwa wydawcy programu obsługi rozszerzeń. struna
Ustawienia Ustawienia publiczne w formacie Json dla rozszerzenia. jakikolwiek
suppressFailures Wskazuje, czy awarie wynikające z rozszerzenia zostaną pominięte (błędy operacyjne, takie jak brak nawiązywania połączenia z maszyną wirtualną, nie zostaną pominięte niezależnie od tej wartości). Wartość domyślna to false. Bool
typ Określa typ rozszerzenia; przykładem jest "CustomScriptExtension". struna
typeHandlerVersion Określa wersję programu obsługi skryptów. struna