Bagikan melalui

File - List From Compute Node

  • Referensi
Layanan:
Batch Service
Versi API:
2024-07-01.20.0

Mencantumkan semua file dalam direktori Tugas pada Simpul Komputasi yang ditentukan.

GET {batchUrl}/pools/{poolId}/nodes/{nodeId}/files?api-version=2024-07-01.20.0
Dengan parameter opsional: 
GET {batchUrl}/pools/{poolId}/nodes/{nodeId}/files?$filter={$filter}&recursive={recursive}&maxresults={maxresults}&timeout={timeout}&api-version=2024-07-01.20.0

Parameter URI

Nama Dalam Diperlukan Jenis Deskripsi
batchUrl
 path True

string

URL dasar untuk semua permintaan layanan Azure Batch.
nodeId
 path True

string

ID Simpul Komputasi yang filenya ingin Anda cantumkan.
poolId
 path True

string

ID Kumpulan yang berisi Simpul Komputasi.
api-version
 query True

string

Versi API Klien.
$filter
 query

string

Klausa $filter OData. Untuk informasi selengkapnya tentang membuat filter ini, lihat https://learn.microsoft.com/rest/api/batchservice/odata-filters-in-batch#list-compute-node-files.
maxresults
 query

integer (int32)

minimum: 1
maximum: 1000

Jumlah maksimum item yang akan dikembalikan dalam respons. Maksimal 1000 file dapat dikembalikan.
recursive
 query

boolean

Apakah akan mencantumkan turunan direktori.
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, default akan digunakan sebagai gantinya.

Header Permintaan

Media Types: "application/json; odata=minimalmetadata"

Nama Diperlukan Jenis Deskripsi
client-request-id

string (uuid)

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-rfc1123)

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

NodeFileListResult

Respons yang berisi daftar file.

Header

  • client-request-id: string
  • request-id: string
  • ETag: string
  • Last-Modified: string
Other Status Codes

BatchError

Kesalahan dari layanan Batch.

Keamanan

azure_auth

Alur kode autentikasi Microsoft Entra OAuth 2.0

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

Cakupan

Nama Deskripsi
user_impersonation Meniru akun pengguna Anda

Authorization

Jenis: apiKey
Dalam: header

Contoh

File list from node

Permintaan sampel

GET account.region.batch.azure.com/pools/poolId/nodes/tvm-1695681911_1-20161122t193202z/files?recursive=False&api-version=2024-07-01.20.0

Respon sampel

Kode status:
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": "2014-09-19T21:56:17.679195Z",
        "lastModified": "2014-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": "2014-09-19T21:56:17.5590855Z",
        "lastModified": "2014-09-19T21:56:17.5590855Z",
        "contentLength": 0,
        "contentType": "application/octet-stream"
      }
    }
  ]
}

Definisi

Nama Deskripsi
BatchError

Respons kesalahan diterima dari layanan Azure Batch.
BatchErrorDetail

Item informasi tambahan yang disertakan dalam respons kesalahan Azure Batch.
ErrorMessage

Pesan kesalahan diterima dalam respons kesalahan Azure Batch.
FileProperties

Properti file pada Simpul Komputasi.
NodeFile

Informasi tentang file atau direktori pada Simpul Komputasi.
NodeFileListResult

Hasil dari mencantumkan file pada Simpul Komputasi, atau file yang terkait dengan Tugas pada Simpul Komputasi.

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

ErrorMessage

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.

ErrorMessage

Objek

Pesan kesalahan diterima dalam respons kesalahan Azure Batch.

Nama Jenis Deskripsi
lang

string

Kode bahasa pesan kesalahan
value

string

Teks pesan.

FileProperties

Objek

Properti file pada Simpul Komputasi.

Nama Jenis Deskripsi
contentLength

integer (int64)

Panjang file.
contentType

string

Tipe isi file.
creationTime

string (date-time)

Waktu pembuatan file.
Waktu pembuatan tidak dikembalikan untuk file pada Simpul Komputasi Linux.
fileMode

string

Atribut mode file dalam format oktal.
Mode file dikembalikan hanya untuk file pada Simpul Komputasi Linux.
lastModified

string (date-time)

Waktu di mana file terakhir diubah.

NodeFile

Objek

Informasi tentang file atau direktori pada Simpul Komputasi.

Nama Jenis Deskripsi
isDirectory

boolean

Apakah objek mewakili direktori.
name

string

Jalur file.
properties

FileProperties

Properti file.
url

string

URL file.

NodeFileListResult

Objek

Hasil dari mencantumkan file pada Simpul Komputasi, atau file yang terkait dengan Tugas pada Simpul Komputasi.

Nama Jenis Deskripsi
odata.nextLink

string

URL untuk mendapatkan serangkaian hasil berikutnya.
value

NodeFile[]

Daftar file.