Share via


Task - List

Belirtilen İşle ilişkili tüm Görevleri listeler.
Çok örnekli Görevler için affinityId, executionInfo ve nodeInfo gibi bilgiler birincil Göreve başvurur. Alt görevler hakkındaki bilgileri almak için liste alt görevleri API'sini kullanın.

GET {batchUrl}/jobs/{jobId}/tasks?api-version=2023-11-01.18.0
GET {batchUrl}/jobs/{jobId}/tasks?$filter={$filter}&$select={$select}&$expand={$expand}&maxresults={maxresults}&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.

jobId
path True

string

İşin Kimliği.

api-version
query True

string

İstemci API Sürümü.

$expand
query

string

OData $expand yan tümcesi.

$filter
query

string

OData $filter yan tümcesi. Bu filtreyi oluşturma hakkında daha fazla bilgi için bkz https://docs.microsoft.com/en-us/rest/api/batchservice/odata-filters-in-batch#list-tasks. .

$select
query

string

OData $select yan tümcesi.

maxresults
query

integer

int32

Yanıtta döndürülecek en fazla öğe sayısı. En fazla 1000 Görev döndürülebilir.

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 tarafından oluşturulan istek kimliği, küme ayraçları gibi dekorasyonu olmayan 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 saatine ayarlar; REST API'yi doğrudan çağırıyorsanız açıkça ayarlayın.

Yanıtlar

Name Tür Description
200 OK

CloudTaskListResult

Görevler listesini içeren bir yanıt.

Headers

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

BatchError

Batch hizmetinden gelen hata.

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

Task list

Sample Request

GET account.region.batch.azure.com/jobs/jobId/tasks?api-version=2023-11-01.18.0


Sample Response

{
  "value": [
    {
      "id": "task1",
      "url": "https://account.region.batch.azure.com/jobs/jobId/tasks/task1",
      "eTag": "0x8D4125FD1A825A4",
      "creationTime": "2016-11-21T22:43:31.4733476Z",
      "lastModified": "2016-11-21T22:43:31.4733476Z",
      "state": "active",
      "stateTransitionTime": "2016-11-21T22:43:31.4733476Z",
      "commandLine": "cmd /c echo task1",
      "userIdentity": {
        "autoUser": {
          "scope": "task",
          "elevationLevel": "nonadmin"
        }
      },
      "constraints": {
        "maxWallClockTime": "P10675199DT2H48M5.4775807S",
        "retentionTime": "P10675199DT2H48M5.4775807S",
        "maxTaskRetryCount": 0
      },
      "requiredSlots": 2,
      "executionInfo": {
        "retryCount": 0,
        "requeueCount": 0
      }
    },
    {
      "id": "task2",
      "url": "https://account.region.batch.azure.com/jobs/jobId/tasks/task2",
      "eTag": "0x8D4125FD2153345",
      "creationTime": "2016-11-21T22:43:31.6736345Z",
      "lastModified": "2016-11-21T22:43:32.1880389Z",
      "state": "active",
      "stateTransitionTime": "2016-11-21T22:43:31.6736345Z",
      "commandLine": "cmd /c echo task2",
      "userIdentity": {
        "autoUser": {
          "scope": "task",
          "elevationLevel": "nonadmin"
        }
      },
      "constraints": {
        "maxWallClockTime": "P10675199DT2H48M5.4775807S",
        "retentionTime": "P10675199DT2H48M5.4775807S",
        "maxTaskRetryCount": 3
      },
      "requiredSlots": 2,
      "executionInfo": {
        "retryCount": 0,
        "requeueCount": 0
      }
    }
  ]
}

Tanımlar

Name Description
AccessScope

Belirtecin erişim iznini aldığı Batch kaynakları.

AffinityInformation

Batch hizmeti tarafından görev başlatılacak bir İşlem Düğümü seçmek için kullanılabilecek bir yerellik ipucu.

ApplicationPackageReference

İşlem Düğümlerine dağıtılacak bir Pakete başvuru.

AuthenticationTokenSettings

Görevin Batch hizmeti işlemlerini gerçekleştirmek için kullanabileceği kimlik doğrulama belirtecinin ayarları.

AutoUserScope

Otomatik kullanıcının kapsamı

AutoUserSpecification

Batch hizmetinde görev çalıştıran otomatik kullanıcının parametrelerini belirtir.

BatchError

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

BatchErrorDetail

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

CloudTask

bir Azure Batch Görevi.

CloudTaskListResult

bir İşteki Görevleri listelemenin sonucu.

ComputeNodeIdentityReference

İşlem düğümlerinin kullanacağı Batch havuzuyla ilişkili kullanıcı tarafından atanan kimliğe başvuru.

ComputeNodeInformation

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

ContainerRegistry

Özel kapsayıcı kayıt defteri.

ContainerWorkingDirectory

Kapsayıcı Görev çalışma dizininin konumu.

DependencyAction

Batch hizmetinin bu Göreve bağlı Görevler üzerinde gerçekleştirdiği bir eylem.

ElevationLevel

Kullanıcının yükseltme düzeyi.

EnvironmentSetting

Görev işleminde ayarlanacak ortam değişkeni.

ErrorCategory

Hatanın kategorisi.

ErrorMessage

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

ExitCodeMapping

Görevden belirli bir çıkış koduyla çıkılması durumunda Batch hizmetinin nasıl yanıt vermesi gerektiği.

ExitCodeRangeMapping

Çıkış kodları aralığı ve Batch hizmetinin bu aralık içindeki çıkış kodlarına nasıl yanıt vermesi gerektiği.

ExitConditions

Görev tamamlandığında Batch hizmetinin nasıl yanıt vereceğini belirtir.

ExitOptions

Batch hizmetinin belirli bir çıkış koşuluna nasıl yanıt vereceğini belirtir.

HttpHeader

HTTP üst bilgisi ad-değer çifti

JobAction

Görev verilen çıkış koşuluyla tamamlanırsa ve İşin onTaskFailed özelliği 'performExitOptionsJobAction' ise, Görevi içeren İş üzerinde gerçekleştirilecek bir eylem.

MultiInstanceSettings

Çok örnekli bir Görevin nasıl çalıştırılacağını belirten ayarlar.

NameValuePair

Ad-değer çiftini temsil eder.

OutputFile

Batch hizmeti Görev işlemini yürütmeyi tamamladıktan sonra bir Azure Batch İşlem Düğümünden başka bir konuma dosya yüklemeye yönelik belirtim.

OutputFileBlobContainerDestination

Azure blob depolama kapsayıcısı içinde karşıya dosya yükleme hedefini belirtir.

OutputFileDestination

Dosyanın karşıya yüklenmesi gereken hedef.

OutputFileUploadCondition

Görev çıkış dosyasının veya dosya kümesinin karşıya yüklenmesi gereken koşullar.

OutputFileUploadOptions

Karşıya yükleme işleminin gerçekleştirilecek koşullar da dahil olmak üzere bir çıkış dosyası karşıya yükleme işlemi hakkındaki ayrıntılar.

ResourceFile

İşlem Düğümüne indirilecek tek bir dosya veya birden çok dosya.

TaskConstraints

Göreve uygulanacak yürütme kısıtlamaları.

TaskContainerExecutionInformation

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

TaskContainerSettings

Görevin kapsayıcı ayarları.

TaskDependencies

Görevin bağımlılıklarını belirtir. Bağımlı Görevin zamanlanması için açıkça belirtilen veya bağımlılık aralığındaki tüm Görevlerin tamamlanması gerekir.

TaskExecutionInformation

Görevin yürütülmesi hakkında bilgi.

TaskExecutionResult

Görev yürütmenin sonucu.

TaskFailureInformation

Görev hatası hakkında bilgi.

TaskIdRange

Bir Görevin bağımlı olabileceği görev kimlikleri aralığı. Bağımlı Görevin zamanlanması için önce aralıkta kimlikleri olan tüm Görevlerin başarıyla tamamlanması gerekir.

TaskState

Görevin durumu.

TaskStatistics

Görevin kaynak kullanım istatistikleri.

UserIdentity

Görevin altında çalıştırıldığı kullanıcı kimliğinin tanımı.

AccessScope

Belirtecin erişim iznini aldığı Batch kaynakları.

Name Tür Description
job

string

Görevi içeren İş üzerindeki tüm işlemleri gerçekleştirmek için erişim verir.

AffinityInformation

Batch hizmeti tarafından görev başlatılacak bir İşlem Düğümü seçmek için kullanılabilecek bir yerellik ipucu.

Name Tür Description
affinityId

string

İşlem Düğümünün veya daha önce çalıştırılmış bir Görevin konumunu temsil eden opak bir dize.
Bu Görevin söz konusu İşlem Düğümünde çalıştırılması gerektiğini belirtmek için bir Düğümün benzisti kimliğini geçirebilirsiniz. Bunun yalnızca yumuşak bir benzite olduğunu unutmayın. Görev zamanlandığı sırada hedef İşlem Düğümü meşgul veya kullanılamıyorsa, Görev başka bir yerde zamanlanır.

ApplicationPackageReference

İşlem Düğümlerine dağıtılacak bir Pakete başvuru.

Name Tür Description
applicationId

string

Dağıtılacak uygulamanın kimliği.
Havuz oluştururken paketin uygulama kimliği tam olmalıdır (/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Batch/batchAccounts/{accountName}/applications/{applicationName}).

version

string

Dağıtılacak uygulamanın sürümü. Atlanırsa, varsayılan sürüm dağıtılır.
Bu bir Havuzda atlanırsa ve bu uygulama için varsayılan sürüm belirtilmezse, istek InvalidApplicationPackageReferences hata kodu ve HTTP durum kodu 409 ile başarısız olur. Bu bir Görevde atlanırsa ve bu uygulama için varsayılan sürüm belirtilmezse, Görev ön işleme hatasıyla başarısız olur.

AuthenticationTokenSettings

Görevin Batch hizmeti işlemlerini gerçekleştirmek için kullanabileceği kimlik doğrulama belirtecinin ayarları.

Name Tür Description
access

AccessScope[]

Belirtecin erişim iznini aldığı Batch kaynakları.
Kimlik doğrulama belirteci sınırlı bir Batch hizmet işlemleri kümesine erişim verir. Şu anda erişim özelliği için desteklenen tek değer, Görevi içeren İş ile ilgili tüm işlemlere erişim izni veren 'job' değeridir.

AutoUserScope

Otomatik kullanıcının kapsamı

Name Tür Description
pool

string

Görevin, havuzdaki her İşlem Düğümünde oluşturulan ortak otomatik kullanıcı hesabı olarak çalıştırıldığını belirtir.

task

string

Hizmetin Görev için yeni bir kullanıcı oluşturması gerektiğini belirtir.

AutoUserSpecification

Batch hizmetinde görev çalıştıran otomatik kullanıcının parametrelerini belirtir.

Name Tür Description
elevationLevel

ElevationLevel

Otomatik kullanıcının yükseltme düzeyi.
Varsayılan değer nonAdmin'dir.

scope

AutoUserScope

Otomatik kullanıcının kapsamı
Varsayılan değer havuzdur. Havuz Windows çalıştırıyorsa, görevler arasında daha sıkı yalıtım gerekiyorsa Görev değeri belirtilmelidir. Örneğin, görev kayıt defterini diğer görevleri etkileyebilecek bir şekilde sessize alırsa veya havuzda normal görevler tarafından erişilemeyen ancak StartTasks tarafından erişilebilir olması gereken sertifikalar belirtilmişse.

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.

CloudTask

bir Azure Batch Görevi.

Name Tür Description
affinityInfo

AffinityInformation

Batch hizmeti tarafından yeni Görevin başlatıldığı bir İşlem Düğümü seçmek için kullanılabilecek bir yerellik ipucu.

applicationPackageReferences

ApplicationPackageReference[]

Batch hizmetinin komut satırını çalıştırmadan önce İşlem Düğümüne dağıtacağı Paketlerin listesi.
Uygulama paketleri indirilir ve Görev çalışma dizinine değil paylaşılan bir dizine dağıtılır. Bu nedenle, başvuruda bulunılan bir paket zaten Node'daysa ve güncelse, yeniden indirılmaz; İşlem Düğümündeki mevcut kopya kullanılır. Başvurulan bir Paket, örneğin paket silindiği veya indirme başarısız olduğu için yüklenemediğinde Görev başarısız olur.

authenticationTokenSettings

AuthenticationTokenSettings

Görevin Batch hizmeti işlemlerini gerçekleştirmek için kullanabileceği kimlik doğrulama belirtecinin ayarları.
Bu özellik ayarlanırsa Batch hizmeti, Görev'e Hesap erişim anahtarı gerektirmeden Batch hizmeti işlemlerinin kimliğini doğrulamak için kullanılabilecek bir kimlik doğrulama belirteci sağlar. Belirteç, AZ_BATCH_AUTHENTICATION_TOKEN ortam değişkeni aracılığıyla sağlanır. Görevin belirteci kullanarak gerçekleştirebileceği işlemler ayarlara bağlıdır. Örneğin, bir Görev, işe başka Görevler eklemek için İş izinleri isteyebilir veya İşin durumunu ya da İş altındaki diğer Görevlerin durumunu denetleyebilir.

commandLine

string

Görevin komut satırı.
Çok örnekli Görevler için, birincil Görev ve tüm alt görevler koordinasyon komut satırını yürütmeyi bitirdikten sonra komut satırı birincil Görev olarak yürütülür. Komut satırı bir kabuk altında çalışmaz ve bu nedenle ortam değişkeni genişletmesi gibi kabuk özelliklerinden yararlanamaz. Bu tür özelliklerden yararlanmak istiyorsanız, kabuğu komut satırında çağırmanız gerekir; örneğin, Windows'ta "cmd /c MyCommand" veya Linux'ta "/bin/sh -c MyCommand" kullanın. Komut satırı dosya yollarına başvuruyorsa, göreli bir yol (Görev çalışma dizinine göre) veya Batch tarafından sağlanan ortam değişkenini (https://docs.microsoft.com/en-us/azure/batch/batch-compute-node-environment-variables kullanmalıdır).

constraints

TaskConstraints

Bu Göreve uygulanan yürütme kısıtlamaları.

containerSettings

TaskContainerSettings

Görevin altında çalıştığı kapsayıcının ayarları.
Bu Görevi çalıştıracak Havuz containerConfiguration kümesine sahipse, bunun da ayarlanması gerekir. Bu Görevi çalıştıracak Havuzda containerConfiguration ayarlanmamışsa, ayarlanmamalıdır. Bu belirtildiğinde, AZ_BATCH_NODE_ROOT_DIR (düğümdeki Azure Batch dizinlerinin kökü) altında özyinelemeli olarak tüm dizinler kapsayıcıyla eşlenir, tüm Görev ortamı değişkenleri kapsayıcıya eşlenir ve Görev komut satırı kapsayıcıda yürütülür. AZ_BATCH_NODE_ROOT_DIR dışında kapsayıcıda üretilen dosyalar ana bilgisayar diskine yansıtılmayabilir; bu da Batch dosya API'lerinin bu dosyalara erişemeyeceği anlamına gelir.

creationTime

string

Görevin oluşturulma zamanı.

dependsOn

TaskDependencies

Bu Görevin bağımlı olduğu Görevler.
Bağlı olduğu tüm Görevler başarıyla tamamlanana kadar bu Görev zamanlanmaz. Bu Görevlerden herhangi biri başarısız olursa ve yeniden deneme sayılarını tüketirse, bu Görev hiçbir zaman zamanlanamaz.

displayName

string

Görev için görünen ad.
Görünen adın benzersiz olması gerekmez ve en fazla 1024 uzunluğunda unicode karakter içerebilir.

eTag

string

Görevin ETag'i.
Bu, opak bir dizedir. Görevin istekler arasında değişip değişmediğini algılamak için bunu kullanabilirsiniz. Özellikle, bir Görevi güncelleştirirken ETag'i geçirerek, değişikliklerinizin etkili olması için bu sırada başka kimsenin Görevi değiştirmemiş olması gerekir.

environmentSettings

EnvironmentSetting[]

Görev için ortam değişkeni ayarlarının listesi.

executionInfo

TaskExecutionInformation

Görevin yürütülmesi hakkında bilgi.

exitConditions

ExitConditions

Görev tamamlandığında Batch hizmetinin nasıl yanıt vereceğini belirtir.
Görev tamamlandığında Batch hizmetinin nasıl yanıt vermesi gerektiği.

id

string

İş içindeki Görevi benzersiz olarak tanımlayan bir dize.
Kimlik, kısa çizgi ve alt çizgi gibi alfasayısal karakterlerin herhangi bir bileşimini içerebilir ve 64 karakterden fazlasını içeremez.

lastModified

string

Görevin son değiştirilme zamanı.

multiInstanceSettings

MultiInstanceSettings

Görevin çok örnekli bir Görev olduğunu belirten ve çok örnekli Görevin nasıl çalıştırıldığını gösteren bir nesne.
Çok Örnekli Görevler genellikle MPI Görevlerini desteklemek için kullanılır. MPI durumunda, alt görevlerden herhangi biri başarısız olursa (örneğin sıfır olmayan bir çıkış koduyla çıkılması nedeniyle) çok örnekli Görevin tamamı başarısız olur. Çok örnekli Görev daha sonra sonlandırılır ve yeniden denenerek yeniden deneme sınırına kadar devam eder.

nodeInfo

ComputeNodeInformation

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

outputFiles

OutputFile[]

Komut satırını çalıştırdıktan sonra Batch hizmetinin İşlem Düğümü'nden karşıya yükleyeceği dosyaların listesi.
Çok örnekli Görevler için dosyalar yalnızca birincil Görevin yürütüleceği İşlem Düğümünden karşıya yüklenir.

previousState

TaskState

Görevin önceki durumu.
Görev ilk Etkin durumundaysa bu özellik ayarlanmaz.

previousStateTransitionTime

string

Görevin önceki durumuna girdiği saat.
Görev ilk Etkin durumundaysa bu özellik ayarlanmaz.

requiredSlots

integer

Görevin çalışması için gereken zamanlama yuvası sayısı.
Varsayılan değer 1'dir. Bir Görev yalnızca düğümde yeterli boş zamanlama yuvası varsa bir işlem düğümünde çalışacak şekilde zamanlanabilir. Çok örnekli Görevler için bu 1 olmalıdır.

resourceFiles

ResourceFile[]

Komut satırını çalıştırmadan önce Batch hizmetinin İşlem Düğümü'ne indireceği dosyaların listesi.
Çok örnekli Görevler için kaynak dosyaları yalnızca birincil Görevin yürütüleceği İşlem Düğümüne indirilir. Kaynak dosyaları listesi için en büyük boyut vardır. Maksimum boyut aşıldığında istek başarısız olur ve yanıt hata kodu RequestEntityTooLarge olur. Bu durumda ResourceFiles koleksiyonunun boyutu küçültülmelidir. Bu, .zip dosyaları, Uygulama Paketleri veya Docker Kapsayıcıları kullanılarak elde edilebilir.

state

TaskState

Görevin geçerli durumu.

stateTransitionTime

string

Görevin geçerli durumuna girdiği saat.

stats

TaskStatistics

Görev için kaynak kullanım istatistikleri.

url

string

Görevin URL'si.

userIdentity

UserIdentity

Görevin altında çalıştığı kullanıcı kimliği.
Atlanırsa, Görev, Göreve özgü yönetici olmayan bir kullanıcı olarak çalışır.

CloudTaskListResult

bir İşteki Görevleri listelemenin sonucu.

Name Tür Description
odata.nextLink

string

Sonraki sonuç kümesini almak için URL.

value

CloudTask[]

Görevler listesi.

ComputeNodeIdentityReference

İşlem düğümlerinin kullanacağı Batch havuzuyla ilişkili kullanıcı tarafından atanan kimliğe başvuru.

Name Tür Description
resourceId

string

Kullanıcı tarafından atanan kimliğin ARM kaynak kimliği.

ComputeNodeInformation

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

Name Tür Description
affinityId

string

Görevin üzerinde çalıştırıldığı Düğüm için bir tanımlayıcı. Bu tanımlayıcı, Görevin bu İşlem Düğümünde zamanlanması isteğinde bulunmak üzere bir Görev eklenirken geçirilebilir.

nodeId

string

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

nodeUrl

string

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

poolId

string

Görevin üzerinde ç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.

ContainerRegistry

Özel kapsayıcı kayıt defteri.

Name Tür Description
identityReference

ComputeNodeIdentityReference

Kullanıcı adı ve parola yerine bir Azure Container Registry erişmek için kullanılacak kullanıcı tarafından atanan kimliğe başvuru.
İşlem düğümlerinin kullanacağı Batch havuzuyla ilişkili kullanıcı tarafından atanan kimliğe başvuru.

password

string

Kayıt defteri sunucusunda oturum açma parolası.

registryServer

string

Kayıt defteri URL'si.
Atlanırsa, varsayılan değer "docker.io" olur.

username

string

Kayıt defteri sunucusunda oturum açmak için kullanıcı adı.

ContainerWorkingDirectory

Kapsayıcı Görev çalışma dizininin konumu.

Name Tür Description
containerImageDefault

string

Kapsayıcı görüntüsünde tanımlanan çalışma dizinini kullanın. Bu dizinin Batch tarafından indirilen Kaynak Dosyalarını içermeyeceğini dikkate alın.

taskWorkingDirectory

string

Batch tarafından doldurulan Görev Kaynak Dosyalarını içeren standart Batch hizmeti Görev çalışma dizinini kullanın.

DependencyAction

Batch hizmetinin bu Göreve bağlı Görevler üzerinde gerçekleştirdiği bir eylem.

Name Tür Description
block

string

Bu görevde bekleyen görevleri engelleyerek bunların zamanlanmasını engeller.

satisfy

string

Bu görevde bekleyen görevleri yerine getirin; Tüm bağımlılıklar karşılandıktan sonra görev çalıştırılacak şekilde zamanlanır.

ElevationLevel

Kullanıcının yükseltme düzeyi.

Name Tür Description
admin

string

Kullanıcı, yükseltilmiş erişimi olan bir kullanıcıdır ve tam Yönetici izinleriyle çalışır.

nonadmin

string

Kullanıcı, yükseltilmiş erişimi olmayan standart bir kullanıcıdır.

EnvironmentSetting

Görev işleminde ayarlanacak ortam değişkeni.

Name Tür Description
name

string

Ortam değişkeninin adı.

value

string

Ortam değişkeninin değeri.

ErrorCategory

Hatanın kategorisi.

Name Tür Description
servererror

string

Hata, bir iç sunucu sorunundan kaynaklanır.

usererror

string

Hata, yanlış yapılandırma gibi bir kullanıcı sorunundan kaynaklanır.

ErrorMessage

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

Name Tür Description
lang

string

Hata iletisinin dil kodu

value

string

İletinin metni.

ExitCodeMapping

Görevden belirli bir çıkış koduyla çıkılması durumunda Batch hizmetinin nasıl yanıt vermesi gerektiği.

Name Tür Description
code

integer

İşlem çıkış kodu.

exitOptions

ExitOptions

Görevden bu çıkış koduyla çıkılması durumunda Batch hizmetinin nasıl yanıt vermesi gerektiği.

ExitCodeRangeMapping

Çıkış kodları aralığı ve Batch hizmetinin bu aralık içindeki çıkış kodlarına nasıl yanıt vermesi gerektiği.

Name Tür Description
end

integer

Aralıktaki son çıkış kodu.

exitOptions

ExitOptions

Görevden çıkış kodu aralık başından sonuna kadar (dahil) bir çıkış koduyla çıkarsa Batch hizmetinin nasıl yanıt vermesi gerekir?

start

integer

Aralıktaki ilk çıkış kodu.

ExitConditions

Görev tamamlandığında Batch hizmetinin nasıl yanıt vereceğini belirtir.

Name Tür Description
default

ExitOptions

Görev diğer özelliklerden herhangi biri tarafından kapsanmayan bir çıkış koşuluyla başarısız olursa Batch hizmetinin nasıl yanıt vermesi gerektiği.
Bu değer, görevden exitCodes veya exitCodeRanges koleksiyonunda listelenmeyen sıfır olmayan çıkış koduyla çıkılırsa, preProcessingError özelliği yoksa ön işleme hatasıyla veya fileUploadError özelliği yoksa dosya karşıya yükleme hatasıyla birlikte kullanılır. Çıkış kodu 0'da varsayılan olmayan bir davranış istiyorsanız, exitCodes veya exitCodeRanges koleksiyonunu kullanarak bunu açıkça listelemeniz gerekir.

exitCodeRanges

ExitCodeRangeMapping[]

Görev çıkış kodu aralıklarının listesi ve Batch hizmetinin bunlara nasıl yanıt vermesi gerektiği.

exitCodes

ExitCodeMapping[]

Tek tek Görev çıkış kodlarının listesi ve Batch hizmetinin bunlara nasıl yanıt vermesi gerektiği.

fileUploadError

ExitOptions

Dosya karşıya yükleme hatası oluşursa Batch hizmetinin nasıl yanıt vermesi gerektiği.
Görevden exitCodes veya exitCodeRanges aracılığıyla belirtilen bir çıkış koduyla çıktıysa ve sonra bir dosya karşıya yükleme hatasıyla karşılaştıysa, çıkış kodu tarafından belirtilen eylem önceliklidir.

preProcessingError

ExitOptions

Görev bir hata nedeniyle başlatılamazsa Batch hizmetinin nasıl yanıt vermesi gerektiği.

ExitOptions

Batch hizmetinin belirli bir çıkış koşuluna nasıl yanıt vereceğini belirtir.

Name Tür Description
dependencyAction

DependencyAction

Batch hizmetinin bu Göreve bağlı Görevler üzerinde gerçekleştirdiği bir eylem.
Olası değerler 'tatmin' (bağımlı görevlerin ilerlemesine izin verme) ve 'engelle' (bağımlı görevler beklemeye devam eder). Batch henüz bağımlı görevlerin iptalini desteklemez.

jobAction

JobAction

Görev verilen çıkış koşuluyla tamamlanırsa ve İşin onTaskFailed özelliği 'performExitOptionsJobAction' ise, Görevi içeren İş üzerinde gerçekleştirilecek bir eylem.
Varsayılan değer 0 çıkış kodu için yoktur ve diğer tüm çıkış koşulları için sonlandırılır. İşin onTaskFailed özelliği noaction ise, bu özelliğin belirtilmesi bir hata döndürür ve Görev isteği ekleme işlemi geçersiz bir özellik değeri hatasıyla başarısız olur; REST API'yi doğrudan çağırıyorsanız HTTP durum kodu 400'dür (Hatalı İstek).

HttpHeader

HTTP üst bilgisi ad-değer çifti

Name Tür Description
name

string

Çıkış dosyaları karşıya yüklenirken kullanılacak üst bilginin büyük/küçük harfe duyarlı olmayan adı

value

string

Çıkış dosyaları karşıya yüklenirken kullanılacak üst bilginin değeri

JobAction

Görev verilen çıkış koşuluyla tamamlanırsa ve İşin onTaskFailed özelliği 'performExitOptionsJobAction' ise, Görevi içeren İş üzerinde gerçekleştirilecek bir eylem.

Name Tür Description
disable

string

İşi devre dışı bırakın. Bu, disableTasks değeri requeue olan disable Job API'sini çağırmaya eşdeğerdir.

none

string

Hiçbir işlem yapılmaz.

terminate

string

İşi sonlandırın. İşin executionInfo içindeki terminateReason "TaskFailed" olarak ayarlanır.

MultiInstanceSettings

Çok örnekli bir Görevin nasıl çalıştırılacağını belirten ayarlar.

Name Tür Description
commonResourceFiles

ResourceFile[]

Batch hizmetinin koordinasyon komut satırını çalıştırmadan önce indireceği dosyaların listesi.
Ortak kaynak dosyaları ile Görev kaynak dosyaları arasındaki fark, ortak kaynak dosyalarının birincil dahil olmak üzere tüm alt görevler için indirilmiş olması, Görev kaynak dosyalarının ise yalnızca birincil için indirilmiş olmasıdır. Ayrıca, bu kaynak dosyalarının Görev çalışma dizinine indirilmediğini, bunun yerine Görev kök dizinine (çalışma dizininin üstündeki bir dizin) indirildiğini unutmayın. Kaynak dosyaları listesi için en büyük boyut vardır. Maksimum boyut aşıldığında istek başarısız olur ve yanıt hata kodu RequestEntityTooLarge olur. Bu durumda ResourceFiles koleksiyonunun boyutu küçültülmelidir. Bu, .zip dosyaları, Uygulama Paketleri veya Docker Kapsayıcıları kullanılarak elde edilebilir.

coordinationCommandLine

string

Birincil görev ana Görev komutunu çalıştırdığında eşgüdüm sağlamak için tüm İşlem Düğümlerinde çalıştırılacak komut satırı.
Tipik bir koordinasyon komut satırı bir arka plan hizmeti başlatır ve hizmetin düğümler arası iletileri işlemeye hazır olduğunu doğrular.

numberOfInstances

integer

Görev için gereken İşlem Düğümlerinin sayısı.
Atlanırsa, varsayılan değer 1'dir.

NameValuePair

Ad-değer çiftini temsil eder.

Name Tür Description
name

string

Ad-değer çiftindeki ad.

value

string

Ad-değer çiftindeki değer.

OutputFile

Batch hizmeti Görev işlemini yürütmeyi tamamladıktan sonra bir Azure Batch İşlem Düğümünden başka bir konuma dosya yüklemeye yönelik belirtim.

Name Tür Description
destination

OutputFileDestination

Çıkış dosyaları için hedef.

filePattern

string

Hangi dosyaları karşıya yükleyeceklerini gösteren desen.
Hem göreli hem de mutlak yollar desteklenir. Göreli yollar Görev çalışma dizinine göredir. Aşağıdaki joker karakterler desteklenir: * 0 veya daha fazla karakterle eşleşir (örneğin abc deseni* abc veya abcdef ile eşleşir), ** herhangi bir dizinle eşleşir, ? tek bir karakterle eşleşir, [abc] köşeli ayraç içindeki bir karakterle ve [a-c] aralıktaki bir karakterle eşleşir. Köşeli ayraçlar, belirtilmeyen herhangi bir karakterle (örneğin[!abc] a, b veya c dışında herhangi bir karakterle eşleşir) eşleşmesi için bir olumsuzlama içerebilir. Dosya adı "." ile başlıyorsa, varsayılan olarak yoksayılır, ancak açıkça belirtilerek eşleştirilebilir (örneğin .gif .a.gif eşleşmez, ancak ..gif eşleşir). Basit bir örnek: **.txt , '.' içinde başlamayan ve Görev çalışma dizininde veya herhangi bir alt dizinde .txt ile biten tüm dosyalarla eşleşir. Dosya adında joker karakter varsa köşeli ayraçlar kullanılarak çıkış yapılabilir (örneğin, abc[] abc adlı bir dosyayla eşleşebilir). Hem \ hem de / değerlerinin Windows'ta dizin ayırıcısı olarak ele alındıklarına, ancak Linux'ta yalnızca / olduğuna dikkat edin. Ortam değişkenleri (%Windows'ta var% veya Linux'ta $var) desen uygulanmadan önce genişletilir.

uploadOptions

OutputFileUploadOptions

Karşıya yükleme işleminin hangi koşullar altında gerçekleştirildiği de dahil olmak üzere, karşıya yükleme işlemi için ek seçenekler.

OutputFileBlobContainerDestination

Azure blob depolama kapsayıcısı içinde karşıya dosya yükleme hedefini belirtir.

Name Tür Description
containerUrl

string

Azure Blob Depolama içindeki dosyaları karşıya yükleyecek kapsayıcının URL'si.
Yönetilen kimlik kullanılmıyorsa, URL'nin kapsayıcıya yazma izinleri veren bir Paylaşılan Erişim İmzası (SAS) içermesi gerekir.

identityReference

ComputeNodeIdentityReference

containerUrl tarafından belirtilen Azure Blob Depolama erişmek için kullanılacak kullanıcı tarafından atanan kimliğe başvuru
Kimliğin Azure Blob Depolama kapsayıcısına yazma erişimi olmalıdır

path

string

Azure Depolama kapsayıcısı içindeki hedef blob veya sanal dizin.
filePattern belirli bir dosyaya başvuruyorsa (joker karakter içermiyorsa), yol bu dosyanın karşıya yüklendiği blobun adıdır. filePattern bir veya daha fazla joker karakter içeriyorsa (ve bu nedenle birden çok dosyayla eşleşebilirse), yol, dosyaların karşıya yüklendiği blob sanal dizininin adıdır (her blob adına eklenir). Belirtilmezse, dosyalar kapsayıcının köküne, dosya adıyla eşleşen bir blob adıyla yüklenir.

uploadHeaders

HttpHeader[]

Çıkış dosyalarını karşıya yüklerken kullanılacak üst bilgiler için ad-değer çiftlerinin listesi
Bu üst bilgiler, Azure Depolama'ya dosya yüklenirken belirtilir. Blobları karşıya yüklerken izin verilen üst bilgilerle ilgili resmi belge: https://docs.microsoft.com/en-us/rest/api/storageservices/put-blob#request-headers-all-blob-types

OutputFileDestination

Dosyanın karşıya yüklenmesi gereken hedef.

Name Tür Description
container

OutputFileBlobContainerDestination

Azure blob depolamada dosyaların karşıya yüklendiği konum.

OutputFileUploadCondition

Görev çıkış dosyasının veya dosya kümesinin karşıya yüklenmesi gereken koşullar.

Name Tür Description
taskcompletion

string

Çıkış kodu ne olursa olsun, Görev işlemi çıktıktan sonra dosyaları karşıya yükleyin.

taskfailure

string

Dosyaları yalnızca Görev işlemi sıfır olmayan bir çıkış koduyla çıktıktan sonra karşıya yükleyin.

tasksuccess

string

Dosyaları yalnızca Görev işlemi 0 çıkış koduyla çıktıktan sonra karşıya yükleyin.

OutputFileUploadOptions

Karşıya yükleme işleminin gerçekleştirilecek koşullar da dahil olmak üzere bir çıkış dosyası karşıya yükleme işlemi hakkındaki ayrıntılar.

Name Tür Description
uploadCondition

OutputFileUploadCondition

Görev çıkış dosyasının veya dosya kümesinin karşıya yüklenmesi gereken koşullar.
Varsayılan değer görev tamamlamadır.

ResourceFile

İşlem Düğümüne indirilecek tek bir dosya veya birden çok dosya.

Name Tür Description
autoStorageContainerName

string

Otomatik depolama hesabındaki depolama kapsayıcısı adı.
autoStorageContainerName, storageContainerUrl ve httpUrl özellikleri birbirini dışlar ve bunlardan biri belirtilmelidir.

blobPrefix

string

Azure Depolama kapsayıcısından blob indirirken kullanılacak blob ön eki. Yalnızca adları belirtilen ön ek ile başlayan bloblar indirilir.
özelliği yalnızca autoStorageContainerName veya storageContainerUrl kullanıldığında geçerlidir. Bu ön ek kısmi bir dosya adı veya alt dizin olabilir. Ön ek belirtilmezse, kapsayıcıdaki tüm dosyalar indirilir.

fileMode

string

Sekizli biçimde dosya izin modu özniteliği.
Bu özellik yalnızca Linux İşlem Düğümlerine indirilen dosyalar için geçerlidir. Windows İşlem Düğümü'ne indirilecek bir resourceFile için belirtilirse yoksayılır. Bu özellik bir Linux İşlem Düğümü için belirtilmezse, dosyaya varsayılan 0770 değeri uygulanır.

filePath

string

İşlem Düğümünde, Görevin çalışma dizinine göre dosyaları indirebileceğiniz konum.
httpUrl özelliği belirtilirse filePath gereklidir ve dosya adı da dahil olmak üzere dosyanın indirileceği yolu açıklar. Aksi takdirde, autoStorageContainerName veya storageContainerUrl özelliği belirtilirse filePath isteğe bağlıdır ve dosyaların indirilme dizinidir. filePath'in dizin olarak kullanıldığı durumlarda, giriş verileriyle ilişkili tüm dizin yapısı tam olarak korunur ve belirtilen filePath dizinine eklenir. Belirtilen göreli yol, Görevin çalışma dizininden ayrılamaz (örneğin, '..' kullanılarak).

httpUrl

string

İndirilmesi gereken dosyanın URL'si.
autoStorageContainerName, storageContainerUrl ve httpUrl özellikleri birbirini dışlar ve bunlardan biri belirtilmelidir. URL Azure Blob Depolama işaret ederse, işlem düğümlerinden okunabilir olmalıdır. Azure depolamadaki bir blob için böyle bir URL almanın üç yolu vardır: Blob üzerinde okuma izinleri veren Paylaşılan Erişim İmzası (SAS) ekleyin, okuma iznine sahip yönetilen bir kimlik kullanın veya blob veya kapsayıcısının ACL'sini genel erişime izin verecek şekilde ayarlayın.

identityReference

ComputeNodeIdentityReference

storageContainerUrl veya httpUrl tarafından belirtilen Azure Blob Depolama erişmek için kullanılacak kullanıcı tarafından atanan kimliğe başvuru
İşlem düğümlerinin kullanacağı Batch havuzuyla ilişkili kullanıcı tarafından atanan kimliğe başvuru.

storageContainerUrl

string

Azure Blob Depolama içindeki blob kapsayıcısının URL'si.
autoStorageContainerName, storageContainerUrl ve httpUrl özellikleri birbirini dışlar ve bunlardan biri belirtilmelidir. Bu URL, işlem düğümlerinden okunabilir ve listelenebilir olmalıdır. Azure depolamadaki bir kapsayıcı için böyle bir URL almanın üç yolu vardır: Kapsayıcıda okuma ve liste izinleri veren Paylaşılan Erişim İmzası (SAS) ekleyin, okuma ve liste izinlerine sahip yönetilen bir kimlik kullanın veya kapsayıcının ACL'sini genel erişime izin verecek şekilde ayarlayın.

TaskConstraints

Göreve uygulanacak yürütme kısıtlamaları.

Name Tür Description
maxTaskRetryCount

integer

Görevin yeniden denenebileceği en fazla sayı. Batch hizmeti, çıkış kodu sıfır olmayan bir Görevi yeniden denenir.
Bu değerin, sıfır olmayan bir çıkış kodu nedeniyle Görev yürütülebilir dosyası için yeniden deneme sayısını özellikle denetlediğini unutmayın. Batch hizmeti Görevi bir kez dener ve bu sınıra kadar yeniden deneyebilir. Örneğin, en fazla yeniden deneme sayısı 3 ise, Batch Görevi en fazla 4 kez dener (ilk bir deneme ve 3 yeniden deneme). Yeniden deneme sayısı üst sınırı 0 ise, Batch hizmeti ilk denemeden sonra Görevi yeniden denemez. Yeniden deneme sayısı üst sınırı -1 ise, Batch hizmeti Görevi sınırsız olarak yeniden dener, ancak bu bir başlangıç görevi veya herhangi bir görev için önerilmez. Varsayılan değer 0'dır (yeniden deneme yoktur).

maxWallClockTime

string

Görevin çalışma süresi üst sınırıdır ve Görevin başladığı zamandan itibaren ölçülür. Görev süre sınırı içinde tamamlanmazsa, Batch hizmeti görevi sonlandırır.
Bu belirtilmezse, Görevin ne kadar süreyle çalışabileceğine ilişkin bir zaman sınırı yoktur.

retentionTime

string

Yürütmeyi tamamladığı zamandan itibaren Görev dizinini çalıştığı İşlem Düğümünde tutma süresi. Bu süreden sonra Batch hizmeti Görev dizinini ve tüm içeriğini silebilir.
Varsayılan değer 7 gündür; örneğin İşlem Düğümü kaldırılmadığı veya İş silinmediği sürece Görev dizini 7 gün boyunca saklanır.

TaskContainerExecutionInformation

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

Name Tür Description
containerId

string

Kapsayıcının kimliği.

error

string

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

state

string

Kapsayıcının durumu.
Bu, Docker hizmetine göre kapsayıcının durumudur. "docker inspect" tarafından döndürülen durum alanına eşdeğerdir.

TaskContainerSettings

Görevin kapsayıcı ayarları.

Name Tür Description
containerRunOptions

string

Kapsayıcı oluşturma komutuna ek seçenekler.
Bu ek seçenekler, Batch Hizmeti tarafından denetlenenlere ek olarak "docker create" komutunun bağımsız değişkenleri olarak sağlanır.

imageName

string

Görevin çalıştırılacağı kapsayıcıyı oluşturmak için kullanılacak Görüntü.
Bu, "docker pull" için belirtildiği gibi tam Görüntü başvurusudur. Görüntü adının bir parçası olarak hiçbir etiket sağlanmazsa, varsayılan olarak ":latest" etiketi kullanılır.

registry

ContainerRegistry

Kapsayıcı görüntüsünü içeren özel kayıt defteri.
Havuz oluşturma sırasında zaten sağlanmışsa bu ayar atlanabilir.

workingDirectory

ContainerWorkingDirectory

Kapsayıcı Görev çalışma dizininin konumu.
Varsayılan değer 'taskWorkingDirectory'dir.

TaskDependencies

Görevin bağımlılıklarını belirtir. Bağımlı Görevin zamanlanması için açıkça belirtilen veya bağımlılık aralığındaki tüm Görevlerin tamamlanması gerekir.

Name Tür Description
taskIdRanges

TaskIdRange[]

Bu Görevin bağlı olduğu Görev Kimliği aralıklarının listesi. Bağımlı Görevin zamanlanması için tüm aralıklardaki tüm Görevlerin başarıyla tamamlanması gerekir.

taskIds

string[]

Bu Görevin bağlı olduğu Görev Kimliklerinin listesi. Bağımlı Görevin zamanlanması için önce bu listedeki tüm Görevlerin başarıyla tamamlanması gerekir.
TaskIds koleksiyonu toplam 64000 karakterle sınırlıdır (tüm Görev Kimliklerinin birleşik uzunluğu). taskIds koleksiyonu uzunluk üst sınırını aşarsa, Görev Ekle isteği TaskDependencyListTooLong hata koduyla başarısız olur. Bu durumda bunun yerine Görev Kimliği aralıklarını kullanmayı göz önünde bulundurun.

TaskExecutionInformation

Görevin yürütülmesi hakkında bilgi.

Name Tür Description
containerInfo

TaskContainerExecutionInformation

Görevin yürütülmekte olduğu kapsayıcı hakkında bilgi.
Bu özellik yalnızca Görev bir kapsayıcı bağlamında çalışıyorsa ayarlanır.

endTime

string

Görevin tamamlanma zamanı.
Bu özellik yalnızca Görev Tamamlandı durumundaysa ayarlanır.

exitCode

integer

Görev komut satırında belirtilen programın çıkış kodu.
Bu özellik yalnızca Görev tamamlanmış durumdaysa ayarlanır. Genel olarak, bir işlemin çıkış kodu, uygulama geliştiricisi tarafından bu işlem için uygulanan özel kuralı yansıtır. Kodunuzda karar vermek için çıkış kodu değerini kullanırsanız, uygulama işlemi tarafından kullanılan çıkış kodu kuralını bildiğinizden emin olun. Ancak Batch hizmeti Görevi sonlandırırsa (zaman aşımı veya API aracılığıyla kullanıcı sonlandırma nedeniyle) işletim sistemi tanımlı bir çıkış kodu görebilirsiniz.

failureInfo

TaskFailureInformation

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

lastRequeueTime

string

Bir kullanıcı isteğinin sonucu olarak Batch hizmeti tarafından Görevin yeniden kuyruhlandığı en son zaman.
Bu özellik yalnızca requeueCount sıfır olmayansa ayarlanır.

lastRetryTime

string

Görevin yeniden denendiği en son zaman.
Bu öğe yalnızca Görev yeniden denendiyse (retryCount sıfır olmayan) bulunur. Varsa, bu genellikle startTime ile aynıdır, ancak Görev yeniden deneme dışında nedenlerle yeniden başlatıldıysa farklı olabilir; Örneğin, İşlem Düğümü yeniden deneme sırasında yeniden başlatıldıysa startTime güncelleştirilir ancak lastRetryTime güncelleştirilmez.

requeueCount

integer

Bir kullanıcı isteğinin sonucu olarak Batch hizmeti tarafından Görevin yeniden kuyruruda bulunma sayısı.
Kullanıcı bir Havuzdan İşlem Düğümlerini kaldırdığında (havuzu yeniden boyutlandırarak/küçülterek) veya İş devre dışı bırakıldığında, kullanıcı İşlem Düğümlerinde çalışan Görevlerin yürütme için yeniden sorgulanmasını belirtebilir. Bu sayı, bu nedenlerle Görevin kaç kez yeniden sıraya alındığını izler.

result

TaskExecutionResult

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

retryCount

integer

Görevin Batch hizmeti tarafından yeniden denenme sayısı.
Görev uygulaması hataları (sıfır olmayan çıkış kodu) yeniden deneniyor, ön işleme hataları (Görev çalıştırılamadı) ve dosya yükleme hataları yeniden denenmiyor. Batch hizmeti, Görevi kısıtlamalar tarafından belirtilen sınıra kadar yeniden dener.

startTime

string

Görevin çalışmaya başladığı saat.
'Çalışıyor' çalışma durumuna karşılık gelir, bu nedenle Görev kaynak dosyalarını veya Paketleri belirtiyorsa, başlangıç saati Görevin bunları indirmeye veya dağıtmaya başladığı zamanı yansıtır. Görev yeniden başlatıldıysa veya yeniden denendiyse, görevin çalışmaya başladığı en son zamandır. Bu özellik yalnızca çalışan veya tamamlanmış durumda olan Görevler için mevcuttur.

TaskExecutionResult

Görev yürütmenin sonucu.

Name Tür Description
failure

string

Görev işlenirken bir hata oluştu. Hata Görev işlemi başlatılmadan önce, Görev işlemi yürütülürken veya Görev işleminden çıkıldıktan sonra oluşmuş olabilir.

success

string

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

TaskFailureInformation

Görev hatası hakkında bilgi.

Name Tür Description
category

ErrorCategory

Görev hatasının kategorisi.

code

string

Görev hatasının tanımlayıcısı. Kodlar sabittir ve program aracılığıyla kullanılması amaçlanmıştır.

details

NameValuePair[]

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

message

string

Kullanıcı arabiriminde görüntülenmeye uygun olması amaçlanan Görev hatasını açıklayan bir ileti.

TaskIdRange

Bir Görevin bağımlı olabileceği görev kimlikleri aralığı. Bağımlı Görevin zamanlanması için önce aralıkta kimlikleri olan tüm Görevlerin başarıyla tamamlanması gerekir.

Name Tür Description
end

integer

Aralıktaki son Görev Kimliği.

start

integer

Aralıktaki ilk Görev Kimliği.

TaskState

Görevin durumu.

Name Tür Description
active

string

Görev kuyruğa alınmış ve çalıştırılabilir, ancak şu anda bir İşlem Düğümüne atanmamış. Görev oluşturulduğunda, devre dışı bırakıldıktan sonra etkinleştirildiğinde veya başarısız bir çalıştırmadan sonra yeniden denemeyi beklediğinde bu duruma girer.

completed

string

Görev artık çalıştırılamaz, çünkü genellikle Görev başarıyla tamamlanmıştır veya Görev başarısız bir şekilde tamamlanmıştır ve yeniden deneme sınırını tüketmiştir. Görev başlatılırken bir hata oluştuysa veya Görev sonlandırıldığında da Görev tamamlandı olarak işaretlenir.

preparing

string

Görev bir İşlem Düğümüne atandı, ancak İşlem Düğümünde gerekli bir İş Hazırlama Görevinin tamamlanmasını bekliyor. İş Hazırlama Görevi başarılı olursa, Görev çalışmaya 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ünde çalışıyor. Buna kaynak dosyalarını indirme veya Görev'de belirtilen Paketleri dağıtma gibi görev düzeyinde hazırlık dahildir. Bu, Görev komut satırının yürütülmeye başladığı anlamına gelmez.

TaskStatistics

Görevin kaynak kullanım istatistikleri.

Name Tür Description
kernelCPUTime

string

Görev tarafından kullanılan toplam çekirdek modu CPU süresi (tüm çekirdekler ve tüm İşlem Düğümleri arasında toplanır).

lastUpdateTime

string

İstatistiklerin en son güncelleştirildiği saat. Tüm istatistikler startTime ile lastUpdateTime arasındaki aralıkla sınırlıdır.

readIOGiB

number

Görev tarafından diskten okunan toplam gibibayt sayısı.

readIOps

integer

Görev tarafından yapılan disk okuma işlemlerinin toplam sayısı.

startTime

string

İstatistiklerin kapsadığı zaman aralığının başlangıç saati.

url

string

İstatistiklerin URL'si.

userCPUTime

string

Görev tarafından kullanılan toplam kullanıcı modu CPU süresi (tüm çekirdekler ve tüm İşlem Düğümleri arasında toplanır).

waitTime

string

Görevin toplam bekleme süresi. Görevin bekleme süresi, Görevin oluşturulmasıyla Görev yürütmenin başlatılması arasındaki geçen süre olarak tanımlanır. (Görev hatalar nedeniyle yeniden denenirse, bekleme süresi en son Görev yürütme zamanıdır.)

wallClockTime

string

Görevin toplam duvar saati saati.
Duvar saati saati, Görevin bir İşlem Düğümünde çalışmaya başlamasından bittiğindeye kadar geçen süredir (veya görev o zamana kadar tamamlanmadıysa istatistiklerin en son güncelleştirildiği zamana kadar). Görev yeniden denendiyse, tüm Görev yeniden denemelerinin duvar saati saati de buna dahildir.

writeIOGiB

number

Görev tarafından diske yazılan toplam gibibaytlar.

writeIOps

integer

Görev tarafından yapılan disk yazma işlemlerinin toplam sayısı.

UserIdentity

Görevin altında çalıştırıldığı kullanıcı kimliğinin tanımı.

Name Tür Description
autoUser

AutoUserSpecification

Görevin altında çalıştırıldığı otomatik kullanıcı.
userName ve autoUser özellikleri birbirini dışlar; birini belirtmeniz gerekir, ancak ikisini birden belirtmemelisiniz.

username

string

Görevin altında çalıştırıldığı kullanıcı kimliğinin adı.
userName ve autoUser özellikleri birbirini dışlar; birini belirtmeniz gerekir, ancak ikisini birden belirtmemelisiniz.