Virtual Machine Extensions - Get

Uzantıyı alma işlemi.

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 Parametreleri

Name İçinde Gerekli Tür Description
resourceGroupName
path True

string

minLength: 1
maxLength: 90

Kaynak grubunun adı. İsim büyük/küçük harfe duyarsızdır.

subscriptionId
path True

string

minLength: 1

Hedef aboneliğin kimliği.

vmExtensionName
path True

string

Sanal makine uzantısının adı.

vmName
path True

string

Sanal makinenin adı.

api-version
query True

string

minLength: 1

Bu işlem için kullanılacak API sürümü.

$expand
query

string

İşleme uygulanacak genişletme ifadesi.

Yanıtlar

Name Tür Description
200 OK

VirtualMachineExtension

Azure işlemi başarıyla tamamlandı.

Other Status Codes

CloudError

Beklenmeyen bir hata yanıtı.

Güvenlik

azure_auth

Azure Active Directory OAuth2 Flow.

Tür: oauth2
Akış: implicit
Yetkilendirme URL’si: https://login.microsoftonline.com/common/oauth2/authorize

Kapsamlar

Name Description
user_impersonation kullanıcı hesabınızın kimliğine bürünme

Örnekler

VirtualMachineExtension_Get_MaximumSet_Gen
VirtualMachineExtension_Get_MinimumSet_Gen

VirtualMachineExtension_Get_MaximumSet_Gen

Örnek isteği

GET https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/rgcompute/providers/Microsoft.Compute/virtualMachines/aaaaaaaaaaaaaaaaaaaaaaaaaaaaa/extensions/aaaaaaa?api-version=2025-11-01&$expand=aaaaaa

Örnek yanıt

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

Örnek isteği

GET https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/rgcompute/providers/Microsoft.Compute/virtualMachines/myVM/extensions/myVMExtension?api-version=2025-11-01

Örnek yanıt

{
  "location": "westus",
  "id": "/subscriptions/{subscription-id}/resourceGroups/rgcompute/providers/Microsoft.Compute/virtualMachines/myVM/extensions/myVMExtension"
}

Tanımlar

Name Description
ApiError

API hatası.

ApiErrorBase

Api hata tabanı.

CloudError

İşlem hizmetinden bir hata yanıtı.

createdByType

Kaynağı oluşturan kimliğin türü.

InnerError

İç hata ayrıntıları.

InstanceViewStatus

Örnek görünümü durumu.

KeyVaultSecretReference

Key Vault Secret'a bir göndermeyi tanımlar

StatusLevelTypes

Düzey kodu.

SubResource
systemData

Kaynağın oluşturulması ve son değiştirilmesiyle ilgili meta veriler.

VirtualMachineExtension

Bir sanal makine uzantısını açıklar.

VirtualMachineExtensionInstanceView

Sanal makine uzantısının örnek görünümü.

ApiError

API hatası.

Name Tür Description
code

string

Hata kodu.

details

ApiErrorBase[]

Api hata ayrıntıları

innererror

InnerError

Api iç hatası

message

string

Hata iletisi.

target

string

Belirli bir hatanın hedefi.

ApiErrorBase

Api hata tabanı.

Name Tür Description
code

string

Hata kodu.

message

string

Hata iletisi.

target

string

Belirli bir hatanın hedefi.

CloudError

İşlem hizmetinden bir hata yanıtı.

Name Tür Description
error

ApiError

API hatası.

createdByType

Kaynağı oluşturan kimliğin türü.

Değer Description
User
Application
ManagedIdentity
Key

InnerError

İç hata ayrıntıları.

Name Tür Description
errordetail

string

İç hata iletisi veya özel durum dökümü.

exceptiontype

string

Özel durum türü.

InstanceViewStatus

Örnek görünümü durumu.

Name Tür Description
code

string

Durum kodu.

displayStatus

string

Durum için kısa yerelleştirilebilir etiket.

level

StatusLevelTypes

Düzey kodu.

message

string

Uyarılar ve hata iletileri dahil olmak üzere ayrıntılı durum iletisi.

time

string (date-time)

Durum zamanı.

KeyVaultSecretReference

Key Vault Secret'a bir göndermeyi tanımlar

Name Tür Description
secretUrl

string

URL, Key Vault'taki bir sırra atıfta bulunuyor.

sourceVault

SubResource

Sırrı içeren Key Vault'un göreli URL'si.

StatusLevelTypes

Düzey kodu.

Değer Description
Info
Warning
Error

SubResource

Name Tür Description
id

string

Kaynak Kimliği

systemData

Kaynağın oluşturulması ve son değiştirilmesiyle ilgili meta veriler.

Name Tür Description
createdAt

string (date-time)

Kaynak oluşturma (UTC) zaman damgası.

createdBy

string

Kaynağı oluşturan kimlik.

createdByType

createdByType

Kaynağı oluşturan kimliğin türü.

lastModifiedAt

string (date-time)

Kaynağın son değişikliğinin zaman damgası (UTC)

lastModifiedBy

string

Kaynağı en son değiştiren kimlik.

lastModifiedByType

createdByType

Kaynağı en son değiştiren kimlik türü.

VirtualMachineExtension

Bir sanal makine uzantısını açıklar.

Name Tür Description
id

string

Kaynağın tam kaynak kimliği. Örn - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

location

string

Kaynağın bulunduğu coğrafi konum

name

string

Kaynağın adı

properties.autoUpgradeMinorVersion

boolean

Dağıtım zamanında kullanılabilir durumdaysa uzantının daha yeni bir ikincil sürüm kullanıp kullanmayacağını gösterir. Ancak dağıtıldıktan sonra, bu özellik true olarak ayarlanmış olsa bile uzantı yeniden dağıtılmadığı sürece ikincil sürümleri yükseltmez.

properties.enableAutomaticUpgrade

boolean

Kullanılabilir uzantının daha yeni bir sürümü varsa, uzantının platform tarafından otomatik olarak yükseltilip yükseltilmeyeceğini gösterir.

properties.forceUpdateTag

string

Uzantı yapılandırması değişmemiş olsa bile uzantı işleyicisinin nasıl güncelleştirilmeye zorlanması gerektiği.

properties.instanceView

VirtualMachineExtensionInstanceView

Sanal makine uzantısı örneği görünümü.

properties.protectedSettings

Uzantı protectedSettings veya protectedSettingsFromKeyVault içerebilir veya hiç korumalı ayar içeremez.

properties.protectedSettingsFromKeyVault

KeyVaultSecretReference

Uzantılar, başvuruyla geçirilen ve anahtar kasasından tüketilen korumalı ayarlar

properties.provisionAfterExtensions

string[]

Bu uzantının sağlanması gereken uzantı adlarının koleksiyonu.

properties.provisioningState

string

Yalnızca yanıtta görünen sağlama durumu.

properties.publisher

string

Uzantı işleyici yayımcısının adı.

properties.settings

Uzantı için Json tarafından biçimlendirilmiş genel ayarlar.

properties.suppressFailures

boolean

Uzantıdan kaynaklanan hataların gizlenip gizlenmeyeceğini gösterir (VM'ye bağlanmama gibi işlemsel hatalar bu değerden bağımsız olarak gizlenmeyecektir). Varsayılan değer false'tur.

properties.type

string

Uzantının türünü belirtir; "CustomScriptExtension" örnektir.

properties.typeHandlerVersion

string

Betik işleyicisinin sürümünü belirtir.

systemData

systemData

createdBy ve modifiedBy bilgilerini içeren Azure Resource Manager meta verileri.

tags

object

Kaynak etiketleri.

type

string

Kaynağın türü. Örneğin "Microsoft. Compute/virtualMachines" veya "Microsoft. Depo/Depolama Hesapları"

VirtualMachineExtensionInstanceView

Sanal makine uzantısının örnek görünümü.

Name Tür Description
name

string

Sanal makine uzantısı adı.

statuses

InstanceViewStatus[]

Kaynak durumu bilgileri.

substatuses

InstanceViewStatus[]

Kaynak durumu bilgileri.

type

string

Uzantının türünü belirtir; "CustomScriptExtension" örnektir.

typeHandlerVersion

string

Betik işleyicisinin sürümünü belirtir.