Virtual Machine Extensions - Get
Der Vorgang zum Abrufen der Erweiterung.
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/virtualMachines/{vmName}/extensions/{vmExtensionName}?api-version=2025-11-01
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/virtualMachines/{vmName}/extensions/{vmExtensionName}?api-version=2025-11-01&$expand={$expand}
URI-Parameter
| Name | In | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
resource
|
path | True |
string minLength: 1maxLength: 90 |
Der Name der Ressourcengruppe. Bei dem Namen wird die Groß-/Kleinschreibung nicht beachtet. |
|
subscription
|
path | True |
string minLength: 1 |
Die ID des Zielabonnements. |
|
vm
|
path | True |
string |
Der Name der Erweiterung des virtuellen Computers. |
|
vm
|
path | True |
string |
Der Name des virtuellen Computers. |
|
api-version
|
query | True |
string minLength: 1 |
Die API-Version, die für diesen Vorgang verwendet werden soll. |
|
$expand
|
query |
string |
Der erweiterungsausdruck, der für den Vorgang angewendet werden soll. |
Antworten
| Name | Typ | Beschreibung |
|---|---|---|
| 200 OK |
Azure-Operation erfolgreich abgeschlossen. |
|
| Other Status Codes |
Unerwartete Fehlerantwort. |
Sicherheit
azure_auth
Azure Active Directory OAuth2 Flow.
Typ:
oauth2
Ablauf:
implicit
Autorisierungs-URL:
https://login.microsoftonline.com/common/oauth2/authorize
Bereiche
| Name | Beschreibung |
|---|---|
| user_impersonation | Identitätswechsel ihres Benutzerkontos |
Beispiele
|
Virtual |
|
Virtual |
VirtualMachineExtension_Get_MaximumSet_Gen
Beispielanforderung
Beispiel für eine Antwort
{
"name": "myVMExtension",
"type": "Microsoft.Compute/virtualMachines/extensions",
"id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachines/myVM/extensions/myVMExtension",
"location": "westus",
"properties": {
"autoUpgradeMinorVersion": true,
"provisioningState": "Creating",
"publisher": "extPublisher",
"type": "extType",
"typeHandlerVersion": "1.2",
"suppressFailures": true,
"settings": {},
"forceUpdateTag": "a",
"enableAutomaticUpgrade": true,
"protectedSettings": {},
"instanceView": {
"name": "aaaaaaaaaaaaaaaaa",
"type": "aaaaaaaaa",
"typeHandlerVersion": "aaaaaaaaaaaaaaaaaaaaaaaaaa",
"substatuses": [
{
"code": "aaaaaaaaaaaaaaaaaaaaaaa",
"level": "Info",
"displayStatus": "aaaaaa",
"message": "a",
"time": "2021-11-30T12:58:26.522Z"
}
],
"statuses": [
{
"code": "aaaaaaaaaaaaaaaaaaaaaaa",
"level": "Info",
"displayStatus": "aaaaaa",
"message": "a",
"time": "2021-11-30T12:58:26.522Z"
}
]
}
},
"tags": {
"key9183": "aa"
}
}
VirtualMachineExtension_Get_MinimumSet_Gen
Beispielanforderung
Beispiel für eine Antwort
{
"location": "westus",
"id": "/subscriptions/{subscription-id}/resourceGroups/rgcompute/providers/Microsoft.Compute/virtualMachines/myVM/extensions/myVMExtension"
}
Definitionen
| Name | Beschreibung |
|---|---|
|
Api |
API-Fehler. |
|
Api |
API-Fehlerbasis. |
|
Cloud |
Eine Fehlerantwort vom Compute-Dienst. |
|
created |
Der Identitätstyp, der die Ressource erstellt hat. |
|
Inner |
Innere Fehlerdetails. |
|
Instance |
Instanzansichtsstatus. |
|
Key |
Beschreibt einen Verweis auf Key Vault Secret |
|
Status |
Der Ebenencode. |
|
Sub |
|
|
system |
Metadaten zur Erstellung und letzten Änderung der Ressource. |
|
Virtual |
Beschreibt eine Erweiterung des virtuellen Computers. |
|
Virtual |
Die Instanzansicht einer Erweiterung eines virtuellen Computers. |
ApiError
API-Fehler.
| Name | Typ | Beschreibung |
|---|---|---|
| code |
string |
Der Fehlercode. |
| details |
Die Details zum API-Fehler |
|
| innererror |
Der innere API-Fehler |
|
| message |
string |
Die Fehlermeldung. |
| target |
string |
Das Ziel des bestimmten Fehlers. |
ApiErrorBase
API-Fehlerbasis.
| Name | Typ | Beschreibung |
|---|---|---|
| code |
string |
Der Fehlercode. |
| message |
string |
Die Fehlermeldung. |
| target |
string |
Das Ziel des bestimmten Fehlers. |
CloudError
Eine Fehlerantwort vom Compute-Dienst.
| Name | Typ | Beschreibung |
|---|---|---|
| error |
API-Fehler. |
createdByType
Der Identitätstyp, der die Ressource erstellt hat.
| Wert | Beschreibung |
|---|---|
| User | |
| Application | |
| ManagedIdentity | |
| Key |
InnerError
Innere Fehlerdetails.
| Name | Typ | Beschreibung |
|---|---|---|
| errordetail |
string |
Die interne Fehlermeldung oder der Ausnahmedump. |
| exceptiontype |
string |
Der Ausnahmetyp. |
InstanceViewStatus
Instanzansichtsstatus.
| Name | Typ | Beschreibung |
|---|---|---|
| code |
string |
Der Statuscode. |
| displayStatus |
string |
Die kurze lokalisierbare Bezeichnung für den Status. |
| level |
Der Ebenencode. |
|
| message |
string |
Die detaillierte Statusmeldung, einschließlich warnungen und Fehlermeldungen. |
| time |
string (date-time) |
Die Uhrzeit des Status. |
KeyVaultSecretReference
Beschreibt einen Verweis auf Key Vault Secret
| Name | Typ | Beschreibung |
|---|---|---|
| secretUrl |
string |
Die URL bezieht sich auf ein Geheimnis in einem Key Vault. |
| sourceVault |
Die relative URL des Key Vault, der das Geheimnis enthält. |
StatusLevelTypes
Der Ebenencode.
| Wert | Beschreibung |
|---|---|
| Info | |
| Warning | |
| Error |
SubResource
| Name | Typ | Beschreibung |
|---|---|---|
| id |
string |
Ressourcen-ID |
systemData
Metadaten zur Erstellung und letzten Änderung der Ressource.
| Name | Typ | Beschreibung |
|---|---|---|
| createdAt |
string (date-time) |
Der Zeitstempel der Ressourcenerstellung (UTC). |
| createdBy |
string |
Die Identität, die die Ressource erstellt hat. |
| createdByType |
Der Identitätstyp, der die Ressource erstellt hat. |
|
| lastModifiedAt |
string (date-time) |
Der Zeitstempel der letzten Änderung der Ressource (UTC) |
| lastModifiedBy |
string |
Die Identität, die die Ressource zuletzt geändert hat. |
| lastModifiedByType |
Der Identitätstyp, der die Ressource zuletzt geändert hat. |
VirtualMachineExtension
Beschreibt eine Erweiterung des virtuellen Computers.
| Name | Typ | Beschreibung |
|---|---|---|
| id |
string |
Vollqualifizierte Ressourcen-ID für die Ressource. Zum Beispiel - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} |
| location |
string |
Der geografische Standort, an dem sich die Ressource befindet |
| name |
string |
Der Name der Ressource |
| properties.autoUpgradeMinorVersion |
boolean |
Gibt an, ob die Erweiterung eine neuere Nebenversion verwenden soll, wenn sie zur Bereitstellungszeit verfügbar ist. Nach der Bereitstellung aktualisiert die Erweiterung jedoch keine Nebenversionen, es sei denn, sie werden erneut bereitgestellt, auch wenn diese Eigenschaft auf "true" festgelegt ist. |
| properties.enableAutomaticUpgrade |
boolean |
Gibt an, ob die Erweiterung automatisch von der Plattform aktualisiert werden soll, wenn eine neuere Version der Erweiterung verfügbar ist. |
| properties.forceUpdateTag |
string |
Wie der Erweiterungshandler aktualisiert werden soll, auch wenn sich die Erweiterungskonfiguration nicht geändert hat. |
| properties.instanceView |
Die Erweiterungsinstanzansicht des virtuellen Computers. |
|
| properties.protectedSettings |
Die Erweiterung kann entweder protectedSettings oder protectedSettingsFromKeyVault oder gar keine geschützten Einstellungen enthalten. |
|
| properties.protectedSettingsFromKeyVault |
Die durch Verweis übergebenen Erweiterungen geschützten Einstellungen und vom Key Vault genutzt werden |
|
| properties.provisionAfterExtensions |
string[] |
Sammlung von Erweiterungsnamen, nach denen diese Erweiterung bereitgestellt werden muss. |
| properties.provisioningState |
string |
Der Bereitstellungsstatus, der nur in der Antwort angezeigt wird. |
| properties.publisher |
string |
Der Name des Herausgebers des Erweiterungshandlers. |
| properties.settings |
Json formatierte öffentliche Einstellungen für die Erweiterung. |
|
| properties.suppressFailures |
boolean |
Gibt an, ob Fehler, die aus der Erweiterung stammen, unterdrückt werden (Betriebsfehler, z. B. keine Verbindung mit dem virtuellen Computer, werden unabhängig von diesem Wert nicht unterdrückt). Die Standardeinstellung ist „false“. |
| properties.type |
string |
Gibt den Typ der Erweiterung an; Ein Beispiel ist "CustomScriptExtension". |
| properties.typeHandlerVersion |
string |
Gibt die Version des Skripthandlers an. |
| systemData |
Azure Resource Manager-Metadaten, die createdBy und modifiedBy-Informationen enthalten. |
|
| tags |
object |
Ressourcentags. |
| type |
string |
Der Typ der Ressource. Zum Beispiel "Microsoft. Compute/virtualMachines" oder "Microsoft. Speicher/Speicherkonten" |
VirtualMachineExtensionInstanceView
Die Instanzansicht einer Erweiterung eines virtuellen Computers.
| Name | Typ | Beschreibung |
|---|---|---|
| name |
string |
Der Erweiterungsname des virtuellen Computers. |
| statuses |
Die Ressourcenstatusinformationen. |
|
| substatuses |
Die Ressourcenstatusinformationen. |
|
| type |
string |
Gibt den Typ der Erweiterung an; Ein Beispiel ist "CustomScriptExtension". |
| typeHandlerVersion |
string |
Gibt die Version des Skripthandlers an. |