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 |
|---|---|---|---|---|
|
resource
|
path | True |
string minLength: 1maxLength: 90 |
Kaynak grubunun adı. İsim büyük/küçük harfe duyarsızdır. |
|
subscription
|
path | True |
string minLength: 1 |
Hedef aboneliğin kimliği. |
|
vm
|
path | True |
string |
Sanal makine uzantısının adı. |
|
vm
|
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 |
Azure işlemi başarıyla tamamlandı. |
|
| Other Status Codes |
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
|
Virtual |
|
Virtual |
VirtualMachineExtension_Get_MaximumSet_Gen
Örnek isteği
Ö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
Örnek yanıt
{
"location": "westus",
"id": "/subscriptions/{subscription-id}/resourceGroups/rgcompute/providers/Microsoft.Compute/virtualMachines/myVM/extensions/myVMExtension"
}
Tanımlar
| Name | Description |
|---|---|
|
Api |
API hatası. |
|
Api |
Api hata tabanı. |
|
Cloud |
İşlem hizmetinden bir hata yanıtı. |
|
created |
Kaynağı oluşturan kimliğin türü. |
|
Inner |
İç hata ayrıntıları. |
|
Instance |
Örnek görünümü durumu. |
|
Key |
Key Vault Secret'a bir göndermeyi tanımlar |
|
Status |
Düzey kodu. |
|
Sub |
|
|
system |
Kaynağın oluşturulması ve son değiştirilmesiyle ilgili meta veriler. |
|
Virtual |
Bir sanal makine uzantısını açıklar. |
|
Virtual |
Sanal makine uzantısının örnek görünümü. |
ApiError
API hatası.
| Name | Tür | Description |
|---|---|---|
| code |
string |
Hata kodu. |
| details |
Api hata ayrıntıları |
|
| 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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
Kaynak durumu bilgileri. |
|
| substatuses |
Kaynak durumu bilgileri. |
|
| type |
string |
Uzantının türünü belirtir; "CustomScriptExtension" örnektir. |
| typeHandlerVersion |
string |
Betik işleyicisinin sürümünü belirtir. |