Virtual Machine Scale Set Extensions - Update
Operacja aktualizowania rozszerzenia.
PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/virtualMachineScaleSets/{vmScaleSetName}/extensions/{vmssExtensionName}?api-version=2025-04-01
Parametry URI
| Nazwa | W | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
resource
|
path | True |
string minLength: 1maxLength: 90 |
Nazwa grupy zasobów. Nazwa jest niewrażliwa na wielkość liter. |
|
subscription
|
path | True |
string minLength: 1 |
Identyfikator subskrypcji docelowej. |
|
vm
|
path | True |
string |
Nazwa zestawu skalowania maszyn wirtualnych. |
|
vmss
|
path | True |
string |
Nazwa rozszerzenia zestawu skalowania maszyn wirtualnych. |
|
api-version
|
query | True |
string minLength: 1 |
Wersja interfejsu API do użycia dla tej operacji. |
Ciało żądania
| Nazwa | Typ | Opis |
|---|---|---|
| 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 |
Jeśli podano wartość i różni się od poprzedniej wartości, program obsługi rozszerzeń zostanie zmuszony do aktualizacji, nawet jeśli konfiguracja rozszerzenia nie uległa zmianie. |
| properties.protectedSettings |
Rozszerzenie może zawierać ustawienia protectedSettings lub protectedSettingsFromKeyVault lub w ogóle nie są chronione. |
|
| properties.protectedSettingsFromKeyVault |
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.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. |
Odpowiedzi
| Nazwa | Typ | Opis |
|---|---|---|
| 200 OK |
Operacja platformy Azure została zakończona pomyślnie. |
|
| 201 Created |
Operacja tworzenia zasobu "VirtualMachineScaleSetExtension" powiodła się Nagłówki
|
|
| Other Status Codes |
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
|
Virtual |
|
Virtual |
VirtualMachineScaleSetExtension_Update_MaximumSet_Gen
Przykładowa prośba
PATCH https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/rgcompute/providers/Microsoft.Compute/virtualMachineScaleSets/aaaaaaaaaaaaaaaaaaaaaaaaaaaaa/extensions/aaaa?api-version=2025-04-01
{
"properties": {
"autoUpgradeMinorVersion": true,
"publisher": "{extension-Publisher}",
"type": "{extension-Type}",
"typeHandlerVersion": "{handler-version}",
"settings": {},
"forceUpdateTag": "aaaaaaaaa",
"enableAutomaticUpgrade": true,
"protectedSettings": {},
"provisionAfterExtensions": [
"aa"
],
"suppressFailures": true
}
}
Przykładowa odpowiedź
{
"name": "{extension-name}",
"properties": {
"autoUpgradeMinorVersion": true,
"publisher": "{extension-Publisher}",
"type": "{extension-Type}",
"typeHandlerVersion": "{handler-version}",
"settings": {},
"forceUpdateTag": "aaaaaaaaa",
"enableAutomaticUpgrade": true,
"protectedSettings": {},
"provisioningState": "aaa",
"provisionAfterExtensions": [
"aa"
],
"suppressFailures": true
},
"type": "aaaaaaaaaaaaaaaaaaaaaaaa",
"id": "aaaaaaaa"
}
location: https://foo.com/operationstatus
{
"name": "{extension-name}",
"properties": {
"autoUpgradeMinorVersion": true,
"publisher": "{extension-Publisher}",
"type": "{extension-Type}",
"typeHandlerVersion": "{handler-version}",
"settings": {},
"forceUpdateTag": "aaaaaaaaa",
"enableAutomaticUpgrade": true,
"protectedSettings": {},
"provisioningState": "aaa",
"provisionAfterExtensions": [
"aa"
],
"suppressFailures": true
},
"type": "aaaaaaaaaaaaaaaaaaaaaaaa",
"id": "aaaaaaaa"
}
VirtualMachineScaleSetExtension_Update_MinimumSet_Gen
Przykładowa prośba
Przykładowa odpowiedź
{}
location: https://foo.com/operationstatus
{}
Definicje
| Nazwa | Opis |
|---|---|
|
Api |
Błąd API. |
|
Api |
Baza błędów API. |
|
Cloud |
Odpowiedź na błąd z usługi obliczeniowej. |
|
Inner |
Szczegóły błędu wewnętrznego. |
|
Key |
Opisuje odwołanie do wpisu tajnego usługi Key Vault |
|
Sub |
|
|
Virtual |
Opisuje rozszerzenie zestawu skalowania maszyn wirtualnych. |
|
Virtual |
Opisuje rozszerzenie zestawu skalowania maszyn wirtualnych. |
ApiError
Błąd API.
| Nazwa | Typ | Opis |
|---|---|---|
| code |
string |
Kod błędu. |
| details |
Szczegóły błędu interfejsu API |
|
| 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 |
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. |
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 |
Względny adres URL usługi Key Vault zawierający wpis tajny. |
SubResource
| Nazwa | Typ | Opis |
|---|---|---|
| id |
string |
Identyfikator zasobu |
VirtualMachineScaleSetExtension
Opisuje rozszerzenie zestawu skalowania maszyn wirtualnych.
| Nazwa | Typ | Opis |
|---|---|---|
| id |
string |
Identyfikator zasobu |
| 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 |
Jeśli podano wartość i różni się od poprzedniej wartości, program obsługi rozszerzeń zostanie zmuszony do aktualizacji, nawet jeśli konfiguracja rozszerzenia nie uległa zmianie. |
| properties.protectedSettings |
Rozszerzenie może zawierać ustawienia protectedSettings lub protectedSettingsFromKeyVault lub w ogóle nie są chronione. |
|
| properties.protectedSettingsFromKeyVault |
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 |
VirtualMachineScaleSetExtensionUpdate
Opisuje rozszerzenie zestawu skalowania maszyn wirtualnych.
| Nazwa | Typ | Opis |
|---|---|---|
| id |
string |
Identyfikator zasobu |
| name |
string |
Nazwa rozszerzenia. |
| 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 |
Jeśli podano wartość i różni się od poprzedniej wartości, program obsługi rozszerzeń zostanie zmuszony do aktualizacji, nawet jeśli konfiguracja rozszerzenia nie uległa zmianie. |
| properties.protectedSettings |
Rozszerzenie może zawierać ustawienia protectedSettings lub protectedSettingsFromKeyVault lub w ogóle nie są chronione. |
|
| properties.protectedSettingsFromKeyVault |
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 |