File - Get From Task

  • Başvuru
Service:
Batch Service
API Version:
2023-11-01.18.0

Belirtilen Görev dosyasının içeriğini döndürür.

GET {batchUrl}/jobs/{jobId}/tasks/{taskId}/files/{filePath}?api-version=2023-11-01.18.0
With optional parameters: 
GET {batchUrl}/jobs/{jobId}/tasks/{taskId}/files/{filePath}?timeout={timeout}&api-version=2023-11-01.18.0

URI Parametreleri

Name İçinde Gerekli Tür Description
batchUrl
 path True

string

Tüm Azure Batch hizmet isteklerinin temel URL'si.
filePath
 path True

string

İçeriğini almak istediğiniz Görev dosyasının yolu.
jobId
 path True

string

Görevi içeren İşin kimliği.
taskId
 path True

string

Dosyasını almak istediğiniz Görevin Kimliği.
api-version
 query True

string

İstemci API Sürümü.
timeout
 query

integer

int32

Sunucunun isteği işlemek için harcayabileceği en uzun süre (saniye olarak). Varsayılan değer 30 saniyedir.

İstek Başlığı

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

Name Gerekli Tür Description
client-request-id

string

uuid

Çağıranın oluşturduğu istek kimliği, küme ayraçları gibi süsleme içermeyen bir GUID biçimindedir; ö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-rfc1123

İsteğin verildiği saat. İstemci kitaplıkları bunu genellikle geçerli sistem saat saati olarak ayarlar; REST API'yi doğrudan çağırıyorsanız açıkça ayarlayın.
ocp-range

string

Alınacak bayt aralığı. Varsayılan ayar dosyanın tamamını almaktır. Biçim bytes=startRange-endRange şeklindedir.
If-Modified-Since

string

date-time-rfc1123

İstemci tarafından bilinen kaynağın son değiştirme zamanını gösteren zaman damgası. İşlem yalnızca hizmet üzerindeki kaynak belirtilen süreden sonra değiştirildiğinde gerçekleştirilir.
If-Unmodified-Since

string

date-time-rfc1123

İstemci tarafından bilinen kaynağın son değiştirme zamanını gösteren zaman damgası. İşlem yalnızca hizmet üzerindeki kaynak belirtilen süreden bu yana değiştirilmediyse gerçekleştirilir.

Yanıtlar

Name Tür Description
200 OK

object

Dosya içeriğini içeren bir yanıt.

Media Types: "application/json", "application/octet-stream"

Headers

  • client-request-id: string
  • request-id: string
  • ETag: string
  • Last-Modified: string
  • ocp-creation-time: string
  • ocp-batch-file-isdirectory: boolean
  • ocp-batch-file-url: string
  • ocp-batch-file-mode: string
  • Content-Type: string
  • Content-Length: integer
Other Status Codes

BatchError

Batch hizmetinden gelen hata.

Media Types: "application/json", "application/octet-stream"

Güvenlik

azure_auth

OAuth 2.0 kimlik doğrulama kodu akışını Microsoft Entra

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Name Description
user_impersonation Kullanıcı hesabınızın kimliğine bürünme

Authorization

Type: apiKey
In: header

Örnekler

Get File From Task

Sample Request

GET account.region.batch.azure.com/jobs/jobId/tasks/task1/files/wd\testFile.txt?api-version=2023-11-01.18.0

Sample Response

Status code:
200 
"This is actually a byte stream. This request/response is being presented as a string for readability in the example"

Tanımlar

Name Description
BatchError

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

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

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

BatchError

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

ErrorMessage

Hatayı açıklayan ve kullanıcı arabiriminde görüntülenmeye uygun olması amaçlanan bir ileti.
values

BatchErrorDetail[]

Hatayla ilgili ek ayrıntıları içeren anahtar-değer çiftleri koleksiyonu.

BatchErrorDetail

Azure Batch hata yanıtına eklenen 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.

ErrorMessage

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

Name Tür Description
lang

string

Hata iletisinin dil kodu
value

string

İletinin metni.