Tasks - List Sub Tasks

Hizmet:: Batch Service

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

Belirtilen çok örnekli Görev ile ilişkilendirilen tüm alt görevleri listeler.
Görev çoklu örnek bir Görev değilse, bu boş bir koleksiyon döner.

GET {endpoint}/jobs/{jobId}/tasks/{taskId}/subtasksinfo?api-version=2025-06-01

İsteğe bağlı parametrelerle:

GET {endpoint}/jobs/{jobId}/tasks/{taskId}/subtasksinfo?api-version=2025-06-01&timeOut={timeOut}&$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).
jobId	path	True	string	İşin kimliği.
taskId	path	True	string	Görevin 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.
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	BatchTaskListSubtasksResult	İ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

BatchTaskListSubtasksResult

İ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

Task list subtasks

Örnek isteği

HTTP

GET {endpoint}/jobs/jobId/tasks/taskId/subtasksinfo?api-version=2025-06-01

Örnek yanıt

Durum kodu:: 200

{
  "value": [
    {
      "id": 1,
      "startTime": "2025-09-06T06:59:16.3139271Z",
      "endTime": "2025-09-06T06:59:20.0242024Z",
      "state": "completed",
      "stateTransitionTime": "2025-09-06T06:59:20.0242024Z",
      "previousState": "running",
      "previousStateTransitionTime": "2025-09-06T06:59:16.3139271Z",
      "exitCode": 0,
      "nodeInfo": {
        "affinityId": "TVM:tvm-2544493925_3-20160905t051718z",
        "nodeUrl": "https://account.region.batch.azure.com/pools/poolId/nodes/tvm-2544493925_3-20160905t051718z",
        "poolId": "mpiPool",
        "nodeId": "tvm-2544493925_3-20160905t051718z",
        "taskRootDirectory": "\\workitems\\jobId\\job-1\\taskId\\1",
        "taskRootDirectoryUrl": "https://account.region.batch.azure.com/pools/poolId/nodes/tvm-2544493925_3-20160905t051718z/files//workitems/jobId/job-1/taskId/1"
      }
    },
    {
      "id": 2,
      "startTime": "2025-09-06T06:59:16.9702844Z",
      "state": "running",
      "stateTransitionTime": "2025-09-06T06:59:16.9702844Z",
      "nodeInfo": {
        "affinityId": "TVM:tvm-2544493925_2-20160905t051718z",
        "nodeUrl": "https://account.region.batch.azure.com/pools/poolId/nodes/tvm-2544493925_2-20160905t051718z",
        "poolId": "mpiPool",
        "nodeId": "tvm-2544493925_2-20160905t051718z",
        "taskRootDirectory": "\\workitems\\jobId\\job-1\\taskId\\2",
        "taskRootDirectoryUrl": "https://account.region.batch.azure.com/pools/poolId/nodes/tvm-2544493925_2-20160905t051718z/files//workitems/jobId/job-1/taskId/2"
      }
    }
  ]
}

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ı.
BatchErrorSourceCategory	BatchErrorSourceCategory enums
BatchNodeInfo	Görevin üzerinde çalıştırıldığı İşlem Düğümü hakkında bilgi.
BatchSubtask	Azure Batch alt görevi hakkında bilgi.
BatchSubtaskState	BatchSubtaskState enums
BatchTaskContainerExecutionInfo	Bir Görevin yürüttüğü kapsayıcı hakkında bilgi içerir.
BatchTaskExecutionResult	BatchTaskExecutionResult enums
BatchTaskFailureInfo	Görev hatası hakkında bilgi.
BatchTaskListSubtasksResult	Görevin alt görevlerini listelemenin sonucu.
NameValuePair	Ad-değer çiftini temsil eder.

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.

BatchErrorSourceCategory

Numaralandırma

BatchErrorSourceCategory enums

Değer	Description
usererror	Hata, kullanıcı sorunundan kaynaklanıyor, örneğin yanlış yapılandırma.
servererror	Hata dahili bir sunucu sorunundan kaynaklanıyor.

BatchNodeInfo

Nesne

Görevin üzerinde çalıştırıldığı İşlem Düğümü hakkında bilgi.

Name	Tür	Description
affinityId	string	Görevin çalıştığı düğüm için bir tanımlayıcı, bu Görev eklenirken bu Hesaplama Düğümünde Görevin planlanmasını talep etmek için iletilebilir.
nodeId	string	Görevin üzerinde çalıştığı Hesaplama Düğümünün kimliği.
nodeUrl	string (uri)	Görevin çalıştığı Compute düğümünün URL'si.
poolId	string	Görevin üzerinde çalıştığı havuzun kimliği.
taskRootDirectory	string	Compute Node'daki Görevin kök dizini.
taskRootDirectoryUrl	string (uri)	Hesaplama düğümündeki Görevin kök dizinine ait URL.

BatchSubtask

Nesne

Azure Batch alt görevi hakkında bilgi.

Name	Tür	Description
containerInfo	BatchTaskContainerExecutionInfo	Görevin yürütüldiği konteyner hakkında bilgiler. Bu özellik yalnızca Görev bir konteyner bağlamında çalışıyorsa ayarlanır.
endTime	string (date-time)	Alt görevin tamamlandığı zaman. Bu özellik yalnızca alt görev Tamamlanmış durumundaysa ayarlanır.
exitCode	integer (int32)	Programın alt görev komut satırında belirtilen çıkış kodu. Bu özellik yalnızca alt görev tamamlanmış durumdaysa, ayarlanır. Genel olarak, bir sürecin çıkış kodu, uygulama geliştiricisinin o süreç için uyguladığı özel konvansiyonu yansıtır. Kodunuzda karar vermek için çıkış kodu değerini kullanıyorsanız, uygulama sürecinde kullanılan çıkış kodu konvansiyonunu bildiğinizden emin olun. Ancak, Batch servisi alt görevi sonlandırırsa (zaman aşımına veya API üzerinden kullanıcı sonlandırması nedeniyle) işletim sistemi tanımlı bir çıkış kodu görebilirsiniz.
failureInfo	BatchTaskFailureInfo	Görev başarısızlığını tanımlayan bilgiler, varsa. Bu özellik yalnızca Görev tamamlanmış durumdaysa ve bir arıza yaşandığında ayarlanır.
id	integer (int32)	Alt görevin kimliği.
nodeInfo	BatchNodeInfo	Alt görevin çalıştığı Compute Node hakkında bilgi.
previousState	BatchSubtaskState	Alt görevin önceki durumu. Bu özellik, alt görev ilk çalışma durumundaysa, ayarlanmaz.
previousStateTransitionTime	string (date-time)	Alt görevin önceki haline girdiği zaman. Bu özellik, alt görev ilk çalışma durumundaysa, ayarlanmaz.
result	BatchTaskExecutionResult	Görevin uygulanmasının sonucu. Değer 'başarısız' ise, arızanın detayları failureInfo özelliğinde bulunabilir.
startTime	string (date-time)	Alt görevin çalışmaya başladığı zaman. Alt görev yeniden başlatıldıysa veya tekrar denendiyse, bu alt görevin en son çalışmaya başladığı zamandır.
state	BatchSubtaskState	Alt görevin mevcut durumu.
stateTransitionTime	string (date-time)	Alt görevin mevcut haline girdiği zaman.

BatchSubtaskState

Numaralandırma

BatchSubtaskState enums

Değer	Description
preparing	Görev, bir Compute Node'a atanmıştır, ancak Compute Node'da tamamlanması gereken İş Hazırlık Görevini beklemektedir. Eğer İş Hazırlık Görevi başarılı olursa, görev koşuya geçer. Eğer İş Hazırlığı Görevi başarısız olursa, Görev aktif hale gelir ve farklı bir Hesaplama Düğümü'ne atanmaya uygun olur.
running	Görev bir Compute Node'da çalışıyor. Bu, kaynak dosyalarının indirilmesi veya Görevde belirtilen Paketlerin dağıtılması gibi görev düzeyinde hazırlıkları da içerir - bu, Görev komut satırının çalışmaya başladığı anlamına gelmez.
completed	Görev artık çalışmaya uygun değildir, genellikle başarıyla tamamlandığı veya başarısız olup tekrar deneme limitini bitirdiği için. Görev başlatılırsa veya sonlandırıldığında bir hata meydana geldiyse de Görev tamamlanmış olarak işaretlenir.

BatchTaskContainerExecutionInfo

Nesne

Bir Görevin yürüttüğü kapsayıcı hakkında bilgi içerir.

Name	Tür	Description
containerId	string	Konteynerin kimliği.
error	string	Konteyner hakkında ayrıntılı hata bilgisi. Bu, Docker servisinden alınan ayrıntılı hata dizisi, eğer varsa. Bu, "docker inspect" ile verilen hata alanına eşdeğerdir.
state	string	Konteynerin durumu. Docker servisine göre konteynerin durumu budur. Bu, "docker inspect" ile döndürülen durum alanına eşdeğerdir.

BatchTaskExecutionResult

Numaralandırma

BatchTaskExecutionResult enums

Değer	Description
success	Görev başarılı bir şekilde yürütüldü.
failure	Görev işlenmesi sırasında bir hata yaşandı. Hata, Görev süreci başlatılmadan önce, Görev süreci çalışırken veya Görev süreci çıktıktan sonra meydana gelmiş olabilir.

BatchTaskFailureInfo

Nesne

Görev hatası hakkında bilgi.

Name	Tür	Description
category	BatchErrorSourceCategory	Görev hatası kategorisi.
code	string	Görev hatası için bir tanımlayıcı. Kodlar sabittir ve program aracılığıyla kullanılması amaçlanmıştır.
details	NameValuePair[]	Hatayla ilgili ek detayların listesi.
message	string	Görev hatasını tanımlayan bir mesaj, kullanıcı arayüzünde görüntülenmeye uygun olması amaçlanmıştır.

BatchTaskListSubtasksResult

Nesne

Görevin alt görevlerini listelemenin sonucu.

Name	Tür	Description
odata.nextLink	string (uri)	Bir sonraki sonuç kümesini almak için URL.
value	BatchSubtask[]	Alt görevler listesi.

NameValuePair

Nesne

Ad-değer çiftini temsil eder.

Name	Tür	Description
name	string	İsim-değer çiftindeki isim.
value	string	İsim-değer çiftindeki değer.

Aracılığıyla paylaş

Tasks - List Sub Tasks

URI Parametreleri

İstek Başlığı

Yanıtlar

Güvenlik

OAuth2Auth

Kapsamlar

Örnekler

Task list subtasks

Örnek isteği

Örnek yanıt

Tanımlar

BatchError

BatchErrorDetail

BatchErrorMessage

BatchErrorSourceCategory

BatchNodeInfo

BatchSubtask

BatchSubtaskState

BatchTaskContainerExecutionInfo

BatchTaskExecutionResult

BatchTaskFailureInfo

BatchTaskListSubtasksResult

NameValuePair