Udostępnij przez


Virtual Machine Scale Set VM Extensions - Get

Operacja pobierania rozszerzenia maszyny wirtualnej usługi VMSS.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/virtualMachineScaleSets/{vmScaleSetName}/virtualMachines/{instanceId}/extensions/{vmExtensionName}?api-version=2025-04-01
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/virtualMachineScaleSets/{vmScaleSetName}/virtualMachines/{instanceId}/extensions/{vmExtensionName}?api-version=2025-04-01&$expand={$expand}

Parametry URI

Nazwa W Wymagane Typ Opis
instanceId
path True

string

Identyfikator wystąpienia maszyny wirtualnej.

resourceGroupName
path True

string

minLength: 1
maxLength: 90

Nazwa grupy zasobów. Nazwa jest niewrażliwa na wielkość liter.

subscriptionId
path True

string

minLength: 1

Identyfikator subskrypcji docelowej.

vmExtensionName
path True

string

Nazwa rozszerzenia maszyny wirtualnej.

vmScaleSetName
path True

string

Nazwa zestawu skalowania maszyn wirtualnych.

api-version
query True

string

minLength: 1

Wersja interfejsu API do użycia dla tej operacji.

$expand
query

string

Wyrażenie expand, które ma być stosowane w operacji.

Odpowiedzi

Nazwa Typ Opis
200 OK

VirtualMachineScaleSetVMExtension

Operacja platformy Azure została zakończona pomyślnie.

Other Status Codes

CloudError

Nieoczekiwana odpowiedź na błąd.

Zabezpieczenia

azure_auth

Przepływ protokołu OAuth2 usługi Azure Active Directory.

Typ: oauth2
Flow: implicit
URL autoryzacji: https://login.microsoftonline.com/common/oauth2/authorize

Zakresów

Nazwa Opis
user_impersonation personifikacja konta użytkownika

Przykłady

Get VirtualMachineScaleSet VM extension.

Przykładowa prośba

GET https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/myvmScaleSet/virtualMachines/0/extensions/myVMExtension?api-version=2025-04-01

Przykładowa odpowiedź

{
  "properties": {
    "autoUpgradeMinorVersion": true,
    "provisioningState": "Creating",
    "publisher": "extPublisher",
    "type": "extType",
    "typeHandlerVersion": "1.2",
    "settings": {
      "UserName": "xyz@microsoft.com"
    }
  },
  "name": "myVMExtension",
  "type": "Microsoft.Compute/virtualMachineScaleSets/virtualMachines/extensions",
  "id": "/subscriptions/{subscriptionId}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/myvmScaleSet/virtualMachines/0/extensions/myVMExtension"
}

Definicje

Nazwa Opis
ApiError

Błąd API.

ApiErrorBase

Baza błędów API.

CloudError

Odpowiedź na błąd z usługi obliczeniowej.

InnerError

Szczegóły błędu wewnętrznego.

InstanceViewStatus

Stan widoku wystąpienia.

KeyVaultSecretReference

Opisuje odwołanie do wpisu tajnego usługi Key Vault

StatusLevelTypes

Kod poziomu.

SubResource
VirtualMachineExtensionInstanceView

Widok wystąpienia rozszerzenia maszyny wirtualnej.

VirtualMachineScaleSetVMExtension

Opisuje rozszerzenie maszyny wirtualnej usługi VMSS.

ApiError

Błąd API.

Nazwa Typ Opis
code

string

Kod błędu.

details

ApiErrorBase[]

Szczegóły błędu interfejsu API

innererror

InnerError

Wewnętrzny błąd interfejsu API

message

string

Komunikat o błędzie.

target

string

Element docelowy określonego błędu.

ApiErrorBase

Baza błędów API.

Nazwa Typ Opis
code

string

Kod błędu.

message

string

Komunikat o błędzie.

target

string

Element docelowy określonego błędu.

CloudError

Odpowiedź na błąd z usługi obliczeniowej.

Nazwa Typ Opis
error

ApiError

Błąd API.

InnerError

Szczegóły błędu wewnętrznego.

Nazwa Typ Opis
errordetail

string

Wewnętrzny komunikat o błędzie lub zrzut wyjątku.

exceptiontype

string

Typ wyjątku.

InstanceViewStatus

Stan widoku wystąpienia.

Nazwa Typ Opis
code

string

Kod stanu.

displayStatus

string

Krótka etykieta lokalizowalna dla stanu.

level

StatusLevelTypes

Kod poziomu.

message

string

Szczegółowy komunikat o stanie, w tym alerty i komunikaty o błędach.

time

string (date-time)

Czas stanu.

KeyVaultSecretReference

Opisuje odwołanie do wpisu tajnego usługi Key Vault

Nazwa Typ Opis
secretUrl

string

Adres URL odwołujący się do wpisu tajnego w usłudze Key Vault.

sourceVault

SubResource

Względny adres URL usługi Key Vault zawierający wpis tajny.

StatusLevelTypes

Kod poziomu.

Wartość Opis
Info
Warning
Error

SubResource

Nazwa Typ Opis
id

string

Identyfikator zasobu

VirtualMachineExtensionInstanceView

Widok wystąpienia rozszerzenia maszyny wirtualnej.

Nazwa Typ Opis
name

string

Nazwa rozszerzenia maszyny wirtualnej.

statuses

InstanceViewStatus[]

Informacje o stanie zasobu.

substatuses

InstanceViewStatus[]

Informacje o stanie zasobu.

type

string

Określa typ rozszerzenia; przykładem jest "CustomScriptExtension".

typeHandlerVersion

string

Określa wersję programu obsługi skryptów.

VirtualMachineScaleSetVMExtension

Opisuje rozszerzenie maszyny wirtualnej usługi VMSS.

Nazwa Typ Opis
id

string

Identyfikator zasobu

location

string

Lokalizacja rozszerzenia.

name

string

Nazwa zasobu

properties.autoUpgradeMinorVersion

boolean

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.

properties.enableAutomaticUpgrade

boolean

Wskazuje, czy rozszerzenie powinno zostać automatycznie uaktualnione przez platformę, jeśli jest dostępna nowsza wersja rozszerzenia.

properties.forceUpdateTag

string

Sposób, w jaki program obsługi rozszerzeń powinien zostać zmuszony do aktualizacji, nawet jeśli konfiguracja rozszerzenia nie uległa zmianie.

properties.instanceView

VirtualMachineExtensionInstanceView

Widok wystąpienia rozszerzenia maszyny wirtualnej.

properties.protectedSettings

Rozszerzenie może zawierać ustawienia protectedSettings lub protectedSettingsFromKeyVault lub w ogóle nie są chronione.

properties.protectedSettingsFromKeyVault

KeyVaultSecretReference

Rozszerzenia chronione ustawienia, które są przekazywane przez odwołanie i używane z magazynu kluczy

properties.provisionAfterExtensions

string[]

Kolekcja nazw rozszerzeń, po których należy aprowizować to rozszerzenie.

properties.provisioningState

string

Stan aprowizacji, który pojawia się tylko w odpowiedzi.

properties.publisher

string

Nazwa wydawcy programu obsługi rozszerzeń.

properties.settings

Ustawienia publiczne w formacie Json dla rozszerzenia.

properties.suppressFailures

boolean

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.

properties.type

string

Określa typ rozszerzenia; przykładem jest "CustomScriptExtension".

properties.typeHandlerVersion

string

Określa wersję programu obsługi skryptów.

type

string

Typ zasobu