Task - List Subtasks

Belirtilen çok örnekli Görevle ilişkili tüm alt görevleri listeler.
Görev çok örnekli bir Görev değilse, bu boş bir koleksiyon döndürür.

GET {batchUrl}/jobs/{jobId}/tasks/{taskId}/subtasksinfo?api-version=2020-03-01.11.0
GET {batchUrl}/jobs/{jobId}/tasks/{taskId}/subtasksinfo?$select={$select}&timeout={timeout}&api-version=2020-03-01.11.0

URI Parametreleri

Name In Required Type Description
batchUrl
path True
  • string

Tüm Azure Toplu Hizmet isteklerinin temel URL'si.

jobId
path True
  • string

İşin kimliği.

taskId
path True
  • string

Görevin kimliği.

api-version
query True
  • string

İstemci API sürümü.

$select
query
  • string

OData $select maddesi.

timeout
query
  • integer
int32

Sunucunun isteği saniyeler içinde işlemek için harcayabileceği maksimum süre. Varsayılan değer 30 saniyedir.

İstek Başlığı

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

Name Required Type Description
client-request-id
  • string
uuid

9C4D50EE-2D56-4CD3-8152-34347DC9F2B0 gibi kıvırcık parantez gibi dekorasyonu olmayan bir GUID şeklinde arayanı oluşturan istek kimliği.

return-client-request-id
  • boolean

Sunucunun yanıtta istemci-istek-id'yi döndürüp döndürmemesi.

ocp-date
  • string
date-time-rfc1123

İsteğin yayımedildiği saat. İstemci kitaplıkları genellikle geçerli sistem saat saati için bu ayarlar; doğrudan REST API'yi arıyorsanız açıkça ayarlayın.

Yanıtlar

Name Type Description
200 OK

Alt görevlerin listesini içeren bir yanıt.

Headers

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

Toplu İşlem hizmetinden gelen hata.

Güvenlik

azure_auth

Azure Active Directory OAuth2 Akış

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

Task list subtasks

Sample Request

GET account.region.batch.azure.com/jobs/jobId/tasks/taskId/subtasksinfo?api-version=2020-03-01.11.0
client-request-id: 00000000-0000-0000-0000-000000000000
ocp-date: Fri, 17 Feb 2017 00:00:00 GMT

Sample Response

{
  "value": [
    {
      "id": 1,
      "startTime": "2016-09-06T06:59:16.3139271Z",
      "endTime": "2016-09-06T06:59:20.0242024Z",
      "state": "completed",
      "stateTransitionTime": "2016-09-06T06:59:20.0242024Z",
      "previousState": "running",
      "previousStateTransitionTime": "2016-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": "2016-09-06T06:59:16.9702844Z",
      "state": "running",
      "stateTransitionTime": "2016-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

BatchError

Azure Toplu İş hizmetinden alınan bir hata yanıtı.

BatchErrorDetail

Azure Toplu İşlem hata yanıtına dahil edilen ek bilgi öğesi.

CloudTaskListSubtasksResult

Görevin alt görevlerini listeleme sonucu.

ComputeNodeInformation

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

ErrorCategory

Hata kategorisi.

ErrorMessage

Azure Toplu İşlem hata yanıtında alınan bir hata iletisi.

NameValuePair

Ad değeri çiftini temsil eder.

SubtaskInformation

Azure Toplu İşlem alt görevi hakkında bilgi.

SubtaskState

Alt görevin durumu.

TaskContainerExecutionInformation

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

TaskExecutionResult

Görev yürütme sinin sonucu.

TaskFailureInformation

Görev hatası hakkında bilgi.

BatchError

Azure Toplu İş hizmetinden alınan bir hata yanıtı.

Name Type Description
code
  • string

Hata için bir tanımlayıcı. Kodlar değişmez ve programlı olarak tüketilmesi amaçlanmıştır.

message

Kullanıcı arabiriminde görüntülenmek üzere uygun olması amaçlanan hatayı açıklayan ileti.

values

Hata yla ilgili ek ayrıntılar içeren anahtar değer çiftleri topluluğu.

BatchErrorDetail

Azure Toplu İşlem hata yanıtına dahil edilen ek bilgi öğesi.

Name Type Description
key
  • string

Değer özelliğinin anlamını belirten bir tanımlayıcı.

value
  • string

Hata yanıtıile birlikte ek bilgiler.

CloudTaskListSubtasksResult

Görevin alt görevlerini listeleme sonucu.

Name Type Description
value

Alt görevlerin listesi.

ComputeNodeInformation

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

Name Type Description
affinityId
  • string

Görevin çalıştırıldığı Düğüm için bir tanımlayıcı, Görev'in bu İşlem Düğümünde zamanlanmasını istemek için bir Görev eklerken geçirilebilir.

nodeId
  • string

Görevin çalıştırıldığı İşlem Düğümü'nün kimliği.

nodeUrl
  • string

Görevin çalıştırıldığı İşlem Düğümü'nün URL'si.

poolId
  • string

Görevin çalıştırıldığı Havuzun kimliği.

taskRootDirectory
  • string

İşlem Düğümündeki Görevin kök dizini.

taskRootDirectoryUrl
  • string

İşlem Düğümündeki Görevin kök dizininin URL'si.

ErrorCategory

Hata kategorisi.

Name Type Description
servererror
  • string

Hata, bir iç sunucu sorunu nedeniyle.

usererror
  • string

Hata, yanlış yapılandırma gibi bir kullanıcı sorunu nedeniyle.

ErrorMessage

Azure Toplu İşlem hata yanıtında alınan bir hata iletisi.

Name Type Description
lang
  • string

Hata iletisinin dil kodu

value
  • string

İletinin metni.

NameValuePair

Ad değeri çiftini temsil eder.

Name Type Description
name
  • string

Ad değeri çiftindeki ad.

value
  • string

Ad değeri çiftindeki değer.

SubtaskInformation

Azure Toplu İşlem alt görevi hakkında bilgi.

Name Type Description
containerInfo

Görevin yürütüldettiği kapsayıcı hakkında bilgi.
Bu özellik yalnızca Görev kapsayıcı bağlamında çalışırsa ayarlanır.

endTime
  • string

Alt görevin tamamlandığı saat.
Bu özellik yalnızca alt görev Tamamlanan durumdaysa ayarlanır.

exitCode
  • integer

Alt görev komut satırında belirtilen programın çıkış kodu.
Bu özellik yalnızca alt görev tamamlanmış durumdaysa ayarlanır. Genel olarak, bir işlemin çıkış kodu, uygulama geliştiricisi tarafından bu işlem için uygulanan belirli bir kuralı yansıtır. Kodunuzda karar vermek için çıkış kodu değerini kullanıyorsanız, uygulama işlemi tarafından kullanılan çıkış kodu kuralını bildiğinizden emin olun. Ancak, Toplu İşlem hizmeti alt görevi sonlandırırsa (zaman ayarı veya API üzerinden kullanıcı sonlandırması nedeniyle) işletim sistemi tanımlı bir çıkış kodu görebilirsiniz.

failureInfo

Varsa Görev hatasını açıklayan bilgiler.
Bu özellik yalnızca Görev tamamlanmış durumdaysa ve bir hatayla karşılaşılırsa ayarlanır.

id
  • integer

Alt görevin kimliği.

nodeInfo

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

previousState

Alt görevin önceki durumu.
Alt görev ilk çalışan durumundaysa, bu özellik ayarlanmaz.

previousStateTransitionTime
  • string

Alt görevin önceki durumuna girdiği saat.
Alt görev ilk çalışan durumundaysa, bu özellik ayarlanmaz.

result

Görev yürütmesinin sonucu.
Değer 'başarısız' ise, hatanın ayrıntıları failureInfo özelliğinde bulunabilir.

startTime
  • string

Alt görevin çalışmaya başladığı saat. Alt görev yeniden başlatılmış veya yeniden denenmişse, bu, alt görevin çalışmaya başladığı en son zamandır.

state

Alt görevin geçerli durumu.

stateTransitionTime
  • string

Alt görevin geçerli durumuna girdiği saat.

SubtaskState

Alt görevin durumu.

Name Type Description
completed
  • string

Görev, genellikle görev başarılı bir şekilde tamamlandığı veya Görev başarısız bir şekilde tamamlandığı ve yeniden deneme sınırını tükettiklediği için, görev artık çalıştırılamaya uygun değildir. Görev başlatıldığında veya Görev sonlandırıldığında bir hata oluştuysa görev tamamlanmış olarak da işaretlenir.

preparing
  • string

Görev Bir İşlem Düğümüne atandı, ancak İşlem Düğümü'nde tamamlanması gereken bir İş Hazırlama Görevi'ni bekliyor. İş Hazırlama Görevi başarılı olursa, Görev çalıştırmaya geçer. İş Hazırlama Görevi başarısız olursa, Görev etkine döner ve farklı bir İşlem Düğümüne atanmaya uygun olur.

running
  • string

Görev Bir İşlem Düğümü üzerinde çalışıyor. Bu, kaynak dosyalarını indirme veya Görevde belirtilen Paketleri dağıtma gibi görev düzeyi hazırlıklarını içerir - bu, Görev komut satırının yürütmeye başladığı anlamına gelmez.

TaskContainerExecutionInformation

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

Name Type Description
containerId
  • string

Konteynerin kimliği.

error
  • string

Kapsayıcı hakkında ayrıntılı hata bilgileri.
Bu, varsa Docker hizmetinin ayrıntılı hata dizesidir. "Docker inspect" tarafından döndürülen hata alanına eşdeğerdir.

state
  • string

Konteynerin durumu.
Docker servisine göre konteynerin durumu bu. "Docker inspect" tarafından döndürülen durum alanına eşdeğerdir.

TaskExecutionResult

Görev yürütme sinin sonucu.

Name Type Description
failure
  • string

Görev'in işlenmesi sırasında bir hata oluştu. Hata, Görev işlemi başlatılmadan önce, Görev işlemi yürütülerken veya Görev işlemi çıktıktan sonra oluşmuş olabilir.

success
  • string

Görev başarıyla çalıştırDı.

TaskFailureInformation

Görev hatası hakkında bilgi.

Name Type Description
category

Görev hatası kategorisi.

code
  • string

Görev hatası için bir tanımlayıcı. Kodlar değişmez ve programlı olarak tüketilmesi amaçlanmıştır.

details

Hatayla ilgili ek ayrıntıların listesi.

message
  • string

Görev hatasını açıklayan, kullanıcı arabiriminde görüntülenmek üzere uygun olması amaçlanan ileti.