Nodes - List Node Extensions

Hizmet:: Batch Service

API Sürümü:: 2025-06-01

Belirlenen Havuzda Hesaplama Düğümleri Uzantılarını listeler.

GET {endpoint}/pools/{poolId}/nodes/{nodeId}/extensions?api-version=2025-06-01

İsteğe bağlı parametrelerle:

GET {endpoint}/pools/{poolId}/nodes/{nodeId}/extensions?api-version=2025-06-01&timeOut={timeOut}&maxresults={maxresults}&$select={$select}

URI Parametreleri

Name	İçinde	Gerekli	Tür	Description
endpoint	path	True	string (uri)	Batch hesabı uç noktası (örneğin: https://batchaccount.eastus2.batch.azure.com).
nodeId	path	True	string	Uzantıları listelemek istediğiniz Compute Node'un ID'si.
poolId	path	True	string	Compute Node'u içeren Havuzun kimliği.
api-version	query	True	string minLength: 1	Bu işlem için kullanılacak API sürümü.
$select	query		string[]	OData $select yan tümcesi.
maxresults	query		integer (int32) minimum: 1 maximum: 1000	Yanıtta döndürülecek en fazla öğe sayısı. En fazla 1000 başvuru iade edilebilir.
timeOut	query		integer (int32)	Sunucunun isteği işlemek için harcayabileceği en uzun süre (saniye cinsinden). Varsayılan değer 30 saniyedir. Değer 30'dan büyükse, varsayılan kullanılacaktır.".

İstek Başlığı

Name	Tür	Description
client-request-id	string	Arayan tarafından oluşturulan istek kimliği, küme ayraçları gibi süslemesi olmayan bir GUID biçiminde, örneğin 9C4D50EE-2D56-4CD3-8152-34347DC9F2B0.
return-client-request-id	boolean	Sunucunun yanıtta client-request-id döndürip döndürmeyeceği.
ocp-date	string (date-time-rfc7231)	İsteğin verildiği saat. İstemci kitaplıkları bunu genellikle geçerli sistem saat saatine ayarlar; REST API'yi doğrudan çağırıyorsanız açıkça ayarlayın.

Yanıtlar

Name	Tür	Description
200 OK	BatchNodeVMExtensionListResult	İstek başarılı oldu. Üst Bilgiler ETag: string Last-Modified: string client-request-id: string request-id: string
Other Status Codes	BatchError	Beklenmeyen bir hata yanıtı.

Name

Tür

Description

200 OK

BatchNodeVMExtensionListResult

İstek başarılı oldu.

Üst Bilgiler

ETag: string
Last-Modified: string
client-request-id: string
request-id: string

Other Status Codes

BatchError

Beklenmeyen bir hata yanıtı.

Güvenlik

OAuth2Auth

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

Kapsamlar

Name	Description
https://batch.core.windows.net//.default

Örnekler

List compute node extensions

Örnek isteği

HTTP

GET {endpoint}/pools/poolId/nodes/tvm-1695681911_2-20161122t193202z/extensions?api-version=2025-06-01

Örnek yanıt

Durum kodu:: 200

{
  "value": [
    {
      "instanceView": {
        "name": "batchNodeExtension",
        "statuses": [
          {
            "code": "ProvisioningState/succeeded",
            "level": "Info",
            "displayStatus": "Provisioning succeeded",
            "message": "Enable succeeded: Enabling and starting agent and controller"
          }
        ]
      },
      "vmExtension": {
        "name": "batchNodeExtension",
        "publisher": "Microsoft.Azure.Extensions",
        "type": "CustomScript",
        "typeHandlerVersion": "2.0",
        "autoUpgradeMinorVersion": true
      }
    },
    {
      "instanceView": {
        "name": "customExtension",
        "statuses": [
          {
            "code": "ProvisioningState/succeeded",
            "level": "Info",
            "displayStatus": "Provisioning succeeded",
            "message": "ExtensionOperation:enable. Status:Success"
          }
        ]
      },
      "vmExtension": {
        "name": "customExtension",
        "publisher": "Microsoft.Azure.Geneva",
        "type": "GenevaMonitoring",
        "typeHandlerVersion": "2.0",
        "autoUpgradeMinorVersion": true,
        "enableAutomaticUpgrade": true
      }
    }
  ]
}

Tanımlar

Name	Description
BatchError	Azure Batch hizmetinden alınan bir hata yanıtı.
BatchErrorDetail	Azure Batch hata yanıtına dahil edilen ek bilgilerden oluşan bir öğe.
BatchErrorMessage	Azure Batch hata yanıtında bir hata iletisi alındı.
BatchNodeVMExtension	Sanal makine uzantısı örneği görünümü için yapılandırma.
BatchNodeVMExtensionListResult	İşlem Düğümü uzantılarını bir Düğümde listelemenin sonucu.
InstanceViewStatus	Örnek görünümü durumu.
StatusLevelTypes	Seviye kodu.
VMExtension	Sanal makine uzantılarının yapılandırması.
VMExtensionInstanceView	Vm uzantısı örneği görünümü.

BatchError

Nesne

Azure Batch hizmetinden alınan bir hata yanıtı.

Name	Tür	Description
code	string	Hatanın tanımlayıcısı. Kodlar sabittir ve program aracılığıyla kullanılması amaçlanmıştır.
message	BatchErrorMessage	Hatayı açıklayan ve kullanıcı arabiriminde görüntülenmeye uygun olması amaçlanan bir ileti.
values	BatchErrorDetail[]	Hata hakkında ek ayrıntılar içeren anahtar-değer çiftleri koleksiyonu.

BatchErrorDetail

Nesne

Azure Batch hata yanıtına dahil edilen ek bilgilerden oluşan bir öğe.

Name	Tür	Description
key	string	Value özelliğinin anlamını belirten tanımlayıcı.
value	string	Hata yanıtına eklenen ek bilgiler.

BatchErrorMessage

Nesne

Azure Batch hata yanıtında bir hata iletisi alındı.

Name	Tür	Description
lang	string	Hata mesajının dil kodu.
value	string	İletinin metni.

BatchNodeVMExtension

Nesne

Sanal makine uzantısı örneği görünümü için yapılandırma.

Name	Tür	Description
instanceView	VMExtensionInstanceView	Vm uzantısı örneği görünümü.
provisioningState	string	Sanal makine uzantısı için provisioning durumu.
vmExtension	VMExtension	Sanal makine uzantısı.

BatchNodeVMExtensionListResult

Nesne

İşlem Düğümü uzantılarını bir Düğümde listelemenin sonucu.

Name	Tür	Description
odata.nextLink	string (uri)	Bir sonraki sonuç kümesini almak için URL.
value	BatchNodeVMExtension[]	Compute Node uzantılarının listesi.

InstanceViewStatus

Nesne

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

Name	Tür	Description
code	string	Durum kodu.
displayStatus	string	Durum için yerel etiket.
level	StatusLevelTypes	Seviye kodu.
message	string	Detaylı durum mesajı.
time	string (date-time)	Durum zamanı.

StatusLevelTypes

Numaralandırma

Seviye kodu.

Değer	Description
Error	Hata
Info	Bilgi
Warning	Uyarı

VMExtension

Nesne

Sanal makine uzantılarının yapılandırması.

Name	Tür	Description
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.
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.
name	string	Sanal makine uzantısının adı.
protectedSettings	object	Uzantı protectedSettings veya protectedSettingsFromKeyVault içerebilir veya hiç korumalı ayar içeremez.
provisionAfterExtensions	string[]	Uzantı adları koleksiyonu. Bu uzantının sağlanması gereken uzantı adlarının koleksiyonu.
publisher	string	Uzantı işleyici yayımcısının adı.
settings	object	Uzantı için JSON biçimli genel ayarlar.
type	string	Uzantının türü.
typeHandlerVersion	string	Betik işleyicisinin sürümü.

VMExtensionInstanceView

Nesne

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

Name	Tür	Description
name	string	VM uzantısı örnek görünümünün adı.
statuses	InstanceViewStatus[]	Kaynak durumu bilgileri.
subStatuses	InstanceViewStatus[]	Kaynak durumu bilgileri.

Aracılığıyla paylaş

Nodes - List Node Extensions

URI Parametreleri

İstek Başlığı

Yanıtlar

Güvenlik

OAuth2Auth

Kapsamlar

Örnekler

List compute node extensions

Örnek isteği

Örnek yanıt

Tanımlar

BatchError

BatchErrorDetail

BatchErrorMessage

BatchNodeVMExtension

BatchNodeVMExtensionListResult

InstanceViewStatus

StatusLevelTypes

VMExtension

VMExtensionInstanceView