Aracılığıyla paylaş

Nodes - List Node Files

Hizmet:
Batch Service
API Sürümü:
2025-06-01

Belirlenen Hesaplama Düğümündeki Görev dizinlerindeki tüm dosyaları listeler.

GET {endpoint}/pools/{poolId}/nodes/{nodeId}/files?api-version=2025-06-01
İsteğe bağlı parametrelerle: 
GET {endpoint}/pools/{poolId}/nodes/{nodeId}/files?api-version=2025-06-01&timeOut={timeOut}&maxresults={maxresults}&$filter={$filter}&recursive={recursive}

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

Dosyalarını listelemek istediğiniz Compute Node'un kimliği.
poolId
 path True

string

İşlem Düğümünü içeren Havuzun Kimliği.
api-version
 query True

string

minLength: 1

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

string

OData $filter yan tümcesi. Bu filtrenin oluşturulması hakkında daha fazla bilgi için bkz.https://learn.microsoft.com/rest/api/batchservice/odata-filters-in-batch#list-compute-node-files
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.
recursive
 query

boolean

Bir dizinin çocuklarını listeleyip listelememe.
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 Gerekli 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

BatchNodeFileListResult

İ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

File list from node

Örnek isteği

GET {endpoint}/pools/poolId/nodes/tvm-1695681911_1-20161122t193202z/files?api-version=2025-06-01&recursive=False

Örnek yanıt

Durum kodu:
200 
{
  "value": [
    {
      "name": "shared",
      "url": "https://account.region.batch.azure.com/pools/poolId/nodes/tvm-2167304207_2-20140919t215614z/files/shared",
      "isDirectory": true
    },
    {
      "name": "startup\\ProcessEnv.cmd",
      "url": "https://account.region.batch.azure.com/pools/poolId/nodes/tvm-2167304207_2-20140919t215614z/files/startup/ProcessEnv.cmd",
      "isDirectory": false,
      "properties": {
        "creationTime": "2025-09-19T21:56:17.679195Z",
        "lastModified": "2025-09-19T21:56:17.679195Z",
        "contentLength": "1813",
        "contentType": "application/octet-stream"
      }
    },
    {
      "name": "startup\\stderr.txt",
      "url": "https://account.region.batch.azure.com/pools/poolId/nodes/tvm-2167304207_2-20140919t215614z/files/startup/stderr.txt",
      "isDirectory": false,
      "properties": {
        "creationTime": "2025-09-19T21:56:17.5590855Z",
        "lastModified": "2025-09-19T21:56:17.5590855Z",
        "contentLength": "0",
        "contentType": "application/octet-stream"
      }
    }
  ]
}

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ı.
BatchNodeFile

İşlem Düğümündeki bir dosya veya dizin hakkında bilgi.
BatchNodeFileListResult

İşlem Düğümündeki dosyaları veya İşlem Düğümündeki bir Görevle ilişkili dosyaları listelemenin sonucu.
FileProperties

İşlem Düğümündeki bir dosyanın özellikleri.

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.

BatchNodeFile

Nesne

İşlem Düğümündeki bir dosya veya dizin hakkında bilgi.

Name Tür Description
isDirectory

boolean

Nesnenin bir dizini temsil edip etmediği.
name

string

Dosya yolu.
properties

FileProperties

Dosya özellikleri.
url

string (uri)

Dosyanın URL'si.

BatchNodeFileListResult

Nesne

İşlem Düğümündeki dosyaları veya İşlem Düğümündeki bir Görevle ilişkili dosyaları listelemenin sonucu.

Name Tür Description
odata.nextLink

string (uri)

Bir sonraki sonuç kümesini almak için URL.
value

BatchNodeFile[]

Dosyaların listesi.

FileProperties

Nesne

İşlem Düğümündeki bir dosyanın özellikleri.

Name Tür Description
contentLength

string (int64)

Dosyanın uzunluğu.
contentType

string

Dosyanın içerik türü.
creationTime

string (date-time)

Dosya oluşturma zamanı. Linux Compute Düğümlerindeki dosyalar için oluşturulma süresi geri dönmez.
fileMode

string

Sekizlik formatında dosya modu özniteliği. Dosya modu yalnızca Linux Compute Nodes'taki dosyalar için geri döner.
lastModified

string (date-time)

Dosyanın en son değiştirildiği zaman.