Nodes - List Node Extensions

Layanan:: Batch Service

Versi API:: 2025-06-01

Mencantumkan Ekstensi Node Komputasi di Kumpulan yang ditentukan.

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

Dengan parameter opsional:

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

Parameter URI

Nama	Dalam	Diperlukan	Jenis	Deskripsi
endpoint	path	True	string (uri)	Titik akhir akun batch (misalnya: https://batchaccount.eastus2.batch.azure.com).
nodeId	path	True	string	ID Simpul Komputasi yang ingin Anda cantumkan ekstensi.
poolId	path	True	string	ID Kumpulan yang berisi Compute Node.
api-version	query	True	string minLength: 1	Versi API yang digunakan untuk operasi ini.
$select	query		string[]	Klausa $select OData.
maxresults	query		integer (int32) minimum: 1 maximum: 1000	Jumlah maksimum item yang akan dikembalikan dalam respons. Maksimal 1000 aplikasi dapat dikembalikan.
timeOut	query		integer (int32)	Waktu maksimum yang dapat dihabiskan server untuk memproses permintaan, dalam hitung detik. Defaultnya adalah 30 detik. Jika nilainya lebih besar dari 30, defaultnya akan digunakan sebagai gantinya.".

Header Permintaan

Nama	Jenis	Deskripsi
client-request-id	string	Identitas permintaan yang dihasilkan penelepon, dalam bentuk GUID tanpa dekorasi seperti kurung kurawal, misalnya 9C4D50EE-2D56-4CD3-8152-34347DC9F2B0.
return-client-request-id	boolean	Apakah server harus mengembalikan client-request-id dalam respons.
ocp-date	string (date-time-rfc7231)	Waktu permintaan dikeluarkan. Pustaka klien biasanya mengatur ini ke waktu jam sistem saat ini; atur secara eksplisit jika Anda memanggil REST API secara langsung.

Respons

Nama	Jenis	Deskripsi
200 OK	BatchNodeVMExtensionListResult	Permintaan telah berhasil. Header ETag: string Last-Modified: string client-request-id: string request-id: string
Other Status Codes	BatchError	Respons kesalahan tak terduga.

Nama

Jenis

Deskripsi

200 OK

BatchNodeVMExtensionListResult

Permintaan telah berhasil.

Header

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

Other Status Codes

BatchError

Respons kesalahan tak terduga.

Keamanan

OAuth2Auth

Jenis: oauth2
Alur: implicit
URL Otorisasi: https://login.microsoftonline.com/common/oauth2/v2.0/authorize

Cakupan

Nama	Deskripsi
https://batch.core.windows.net//.default

Contoh

List compute node extensions

Permintaan sampel

HTTP

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

Respon sampel

Kode status:: 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
      }
    }
  ]
}

Definisi

Nama	Deskripsi
BatchError	Respons kesalahan diterima dari layanan Azure Batch.
BatchErrorDetail	Item informasi tambahan yang disertakan dalam respons kesalahan Azure Batch.
BatchErrorMessage	Pesan kesalahan diterima dalam respons kesalahan Azure Batch.
BatchNodeVMExtension	Konfigurasi untuk tampilan instans ekstensi komputer virtual.
BatchNodeVMExtensionListResult	Hasil daftar ekstensi Simpul Komputasi dalam Simpul.
InstanceViewStatus	Status tampilan instans.
StatusLevelTypes	Kode level.
VMExtension	Konfigurasi untuk ekstensi komputer virtual.
VMExtensionInstanceView	Tampilan instans ekstensi vm.

BatchError

Objek

Respons kesalahan diterima dari layanan Azure Batch.

Nama	Jenis	Deskripsi
code	string	Pengidentifikasi untuk kesalahan. Kode invarian dan dimaksudkan untuk dikonsumsi secara terprogram.
message	BatchErrorMessage	Pesan yang menjelaskan kesalahan, dimaksudkan agar cocok untuk ditampilkan di antarmuka pengguna.
values	BatchErrorDetail[]	Kumpulan pasangan kunci-nilai yang berisi detail tambahan tentang kesalahan.

BatchErrorDetail

Objek

Item informasi tambahan yang disertakan dalam respons kesalahan Azure Batch.

Nama	Jenis	Deskripsi
key	string	Pengidentifikasi yang menentukan arti properti Nilai.
value	string	Informasi tambahan yang disertakan dengan respons kesalahan.

BatchErrorMessage

Objek

Pesan kesalahan diterima dalam respons kesalahan Azure Batch.

Nama	Jenis	Deskripsi
lang	string	Kode bahasa pesan kesalahan.
value	string	Teks pesan.

BatchNodeVMExtension

Objek

Konfigurasi untuk tampilan instans ekstensi komputer virtual.

Nama	Jenis	Deskripsi
instanceView	VMExtensionInstanceView	Tampilan instans ekstensi vm.
provisioningState	string	Status provisi ekstensi komputer virtual.
vmExtension	VMExtension	Ekstensi komputer virtual.

BatchNodeVMExtensionListResult

Objek

Hasil daftar ekstensi Simpul Komputasi dalam Simpul.

Nama	Jenis	Deskripsi
odata.nextLink	string (uri)	URL untuk mendapatkan kumpulan hasil berikutnya.
value	BatchNodeVMExtension[]	Daftar ekstensi Compute Node.

InstanceViewStatus

Objek

Status tampilan instans.

Nama	Jenis	Deskripsi
code	string	Kode status.
displayStatus	string	Label yang dilokalkan untuk status.
level	StatusLevelTypes	Kode level.
message	string	Pesan status terperinci.
time	string (date-time)	Waktu status.

StatusLevelTypes

Enumerasi

Kode level.

Nilai	Deskripsi
Error	Kesalahan
Info	Info
Warning	Peringatan

VMExtension

Objek

Konfigurasi untuk ekstensi komputer virtual.

Nama	Jenis	Deskripsi
autoUpgradeMinorVersion	boolean	Menunjukkan apakah ekstensi harus menggunakan versi minor yang lebih baru jika tersedia pada waktu penyebaran. Namun, setelah disebarkan, ekstensi tidak akan meningkatkan versi minor kecuali disebarkan ulang, bahkan dengan properti ini diatur ke true.
enableAutomaticUpgrade	boolean	Menunjukkan apakah ekstensi harus ditingkatkan secara otomatis oleh platform jika ada versi ekstensi yang lebih baru yang tersedia.
name	string	Nama ekstensi komputer virtual.
protectedSettings	object	Ekstensi dapat berisi protectedSettings atau protectedSettingsFromKeyVault atau tidak ada pengaturan yang dilindungi sama sekali.
provisionAfterExtensions	string[]	Kumpulan nama ekstensi. Kumpulan nama ekstensi setelah ekstensi ini perlu disediakan.
publisher	string	Nama penerbit handler ekstensi.
settings	object	Pengaturan publik berformat JSON untuk ekstensi.
type	string	Jenis ekstensi.
typeHandlerVersion	string	Versi handler skrip.

VMExtensionInstanceView

Objek

Tampilan instans ekstensi vm.

Nama	Jenis	Deskripsi
name	string	Nama tampilan instans ekstensi vm.
statuses	InstanceViewStatus[]	Informasi status sumber daya.
subStatuses	InstanceViewStatus[]	Informasi status sumber daya.