Aracılığıyla paylaş

Task - Get

  • Başvuru
Hizmet:
Batch Service
API Sürümü:
2024-07-01.20.0

Belirtilen Görev hakkında bilgi alır.
Çok örnekli Görevler için affinityId, executionInfo ve nodeInfo gibi bilgiler birincil Göreve başvurur. Alt görevler hakkında bilgi almak için liste alt görevleri API'sini kullanın.

GET {batchUrl}/jobs/{jobId}/tasks/{taskId}?api-version=2024-07-01.20.0
İsteğe bağlı parametrelerle: 
GET {batchUrl}/jobs/{jobId}/tasks/{taskId}?$select={$select}&$expand={$expand}&timeout={timeout}&api-version=2024-07-01.20.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

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

string

Hakkında bilgi almak için Görevin kimliği.
api-version
 query True

string

İstemci API Sürümü.
$expand
 query

string

OData $expand yan tümcesi.
$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, bunun yerine varsayılan değer kullanılır.

İstek Başlığı

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

Name Gerekli Tür Description
client-request-id

string

uuid

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-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.
If-Match

string

İstemci tarafından bilinen kaynağın sürümüyle ilişkili bir ETag değeri. İşlem yalnızca kaynağın hizmetteki geçerli ETag'i istemci tarafından belirtilen değerle tam olarak eşleşiyorsa gerçekleştirilir.
If-None-Match

string

İstemci tarafından bilinen kaynağın sürümüyle ilişkili bir ETag değeri. İşlem yalnızca kaynağın hizmetteki geçerli ETag'i istemci tarafından belirtilen değerle eşleşmiyorsa gerçekleştirilir.
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 bu yana değiştirilmişse 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ştirilmemişse gerçekleştirilir.

Yanıtlar

Name Tür Description
200 OK

CloudTask

Görevi içeren bir yanıt.

Üst Bilgiler

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

BatchError

Batch hizmetinden gelen hata.

Güvenlik

azure_auth

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

Tür: oauth2
Akış: implicit
Yetkilendirme URL’si: https://login.microsoftonline.com/common/oauth2/authorize

Kapsamlar

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

Authorization

Tür: apiKey
İçinde: header

Örnekler

Task get

Örnek isteği

GET account.region.batch.azure.com/jobs/jobId/tasks/taskId?api-version=2024-07-01.20.0

Örnek yanıt

Durum kodu:
200 
{
  "id": "testTask",
  "url": "https://account.region.batch.azure.com/jobs/jobId/tasks/taskId",
  "eTag": "0x8D3D62350711C55",
  "creationTime": "2016-09-06T06:59:15.1161429Z",
  "lastModified": "2016-09-06T06:59:15.1161429Z",
  "state": "active",
  "stateTransitionTime": "2016-09-06T06:59:15.1161429Z",
  "commandLine": "cmd /c hostname",
  "userIdentity": {
    "autoUser": {
      "scope": "task",
      "elevationLevel": "nonadmin"
    }
  },
  "multiInstanceSettings": {
    "numberOfInstances": 3,
    "coordinationCommandLine": "cmd /c echo coordinating"
  },
  "constraints": {
    "maxWallClockTime": "P10675199DT2H48M5.4775807S",
    "retentionTime": "P10675199DT2H48M5.4775807S",
    "maxTaskRetryCount": 0
  },
  "requiredSlots": 2,
  "executionInfo": {
    "retryCount": 0,
    "requeueCount": 0
  }
}

Tanımlar

Name Description
AccessScope

Belirtecin erişim izni veren 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 paket başvurusu.
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 dahil edilen ek bilgilerden oluşan bir öğe.
CloudTask

Azure Batch Görevi.
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.
ContainerHostBatchBindMountEntry

Görev kapsayıcısına bağlamak istediğiniz yol ve bağlama modunun girişi.
ContainerHostDataPath

Kapsayıcı görevinin kapsayıcısına bağlanacak yollar.
ContainerRegistry

Özel bir 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ıktaki çı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 belirtilen çı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 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 bir dosya karşıya yükleme hedefi belirtir.
OutputFileDestination

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

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

Karşıya yüklemenin hangi koşullar altında gerçekleştirildiği de dahil olmak üzere bir çıktı dosyası karşıya yükleme işlemiyle ilgili 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örev için kapsayıcı ayarları.
TaskDependencies

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

Görevin yürütülmesiyle ilgili bilgiler.
TaskExecutionResult

Görev yürütmenin sonucu.
TaskFailureInformation

Görev hatası hakkında bilgi.
TaskIdRange

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

Görevin durumu.
TaskStatistics

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

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

AccessScope

Belirtecin erişim izni veren Batch kaynakları.

Name Tür Description
job

string

Görevi içeren İş'te 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 affinityId değerini geçirebilirsiniz. Bunun yalnızca geçici 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 paket başvurusu.

Name Tür Description
applicationId

string

Dağıtılacak uygulamanın kimliği.
Havuz oluştururken paketin uygulama kimliği tam (/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Batch/batchAccounts/{accountName}/applications/{applicationName}) olmalıdır.
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 ve HTTP durum kodu 409 hata koduyla başarısız olur. Bir Görevde bu belirtilmezse 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 izni veren Batch kaynakları.
Kimlik doğrulama belirteci sınırlı bir Batch hizmeti 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 sağlayan 'job' değeridir.

AutoUserScope

Otomatik kullanıcının kapsamı

Name Tür Description
pool

string

Görevin bir 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[]

Hata hakkında ek ayrıntılar içeren anahtar-değer çiftleri koleksiyonu.

BatchErrorDetail

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.

CloudTask

Azure Batch Görevi.

Name Tür Description
affinityInfo

AffinityInformation

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

ApplicationPackageReference[]

Komut satırını çalıştırmadan önce Batch hizmetinin İş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 indirilemediği için yüklenemediyse, 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, Bir Hesap erişim anahtarı gerektirmeden Batch hizmeti işlemlerinin kimliğini doğrulamak için kullanılabilecek bir kimlik doğrulama belirteci ile Görev 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, İş'e başka Görevler eklemek için İş izinleri isteyebilir veya İşin veya İş 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şletme 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://learn.microsoft.com/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, bu ayar yapılmamalıdır. Bu belirtildiğinde, AZ_BATCH_NODE_ROOT_DIR altındaki tüm dizinler (düğümdeki Azure Batch dizinlerinin kökü) kapsayıcıya 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 konak diske yansıtılmayabilir; bu da Batch dosya API'lerinin bu dosyalara erişemeyeceği anlamına gelir.
creationTime

string

Görevin oluşturma zamanı.
dependsOn

TaskDependencies

Bu Görevin bağlı olduğu Görevler.
Bağımlı 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ğa kadar unicode karakter içerebilir.
eTag

string

Görevin ETag'i.
Bu, opak bir dizedir. Görev'in 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 yalnızca bu sırada başka kimsenin Görevi değiştirmemiş olması durumunda geçerli olacağını belirtebilirsiniz.
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 fazla karakter içeremez.
lastModified

string

Görevin son değiştirme 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 örneğinde, 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 yuvalarının sayısı.
Varsayılan değer 1'dir. Görev yalnızca düğümde yeterli boş zamanlama yuvası varsa 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. En büyük boyut aşıldığında istek başarısız olur ve yanıt hata kodu RequestEntityTooLarge olur. Bu durumda ResourceFiles koleksiyonunun boyutu azaltılmalıdır. 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 çalıştığı kullanıcı kimliği.
Atlanırsa, Görev, Göreve özgü yönetici olmayan bir kullanıcı olarak çalışır.

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ıdır. Bu tanımlayıcı, Görevin bu İşlem Düğümünde zamanlanması istenecek 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.

ContainerHostBatchBindMountEntry

Görev kapsayıcısına bağlamak istediğiniz yol ve bağlama modunun girişi.

Name Tür Description
isReadOnly

boolean

Bu kaynak yolu salt okunur mod olarak bağlayın veya bağlamayın. Varsayılan değer false (okuma/yazma modu).
Linux için bu yolu okuma/yazma modu olarak bağlarsanız bu, kapsayıcıdaki tüm kullanıcıların yol için okuma/yazma erişimine sahip olduğu anlamına gelmez; konak VM'deki erişime bağlıdır. Bu yol salt okunur olarak bağlanırsa, kapsayıcıdaki tüm kullanıcılar yolu değiştiremez.
source

ContainerHostDataPath

Kapsayıcı müşterisine bağlanacak yol seçilebilir.

ContainerHostDataPath

Kapsayıcı görevinin kapsayıcısına bağlanacak yollar.

Name Tür Description
Applications

string

Uygulama yolu.
JobPrep

string

İş hazırlama görev yolu.
Shared

string

Çok örnekli görevin dosyalarını paylaşma yolu.
Startup

string

Başlangıç görevinin yolu.
Task

string

Görev yolu.
VfsMounts

string

Yol, bu düğüme bağlı olan tüm sanal dosya sistemlerini içerir.

ContainerRegistry

Özel bir kapsayıcı kayıt defteri.

Name Tür Description
identityReference

ComputeNodeIdentityReference

Kullanıcı adı ve parola yerine Azure Container Registry'ye 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"dir.
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 karşılar; 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ıktaki çı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 (dahil) çı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 gerekir?
Bu değer, Görev 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 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 gerekir?
Görevden exitCodes veya exitCodeRanges aracılığıyla belirtilen bir çıkış koduyla çıktıysa ve sonra bir dosya yükleme hatasıyla karşılaştıysa, çıkış kodu tarafından belirtilen eylem önceliklidir.
preProcessingError

ExitOptions

Görev bir hata nedeniyle başlatılamıyorsa 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 belirtilen çı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 ekleme isteği geçersiz ö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 belirtilen çı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'sunda 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. En büyük boyut aşıldığında istek başarısız olur ve yanıt hata kodu RequestEntityTooLarge olur. Bu durumda ResourceFiles koleksiyonunun boyutu azaltılmalıdır. 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ümlü olmalarını 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 Azure Batch İşlem Düğümü'nden başka bir konuma dosya yüklemeye yönelik belirtim.

Name Tür Description
destination

OutputFileDestination

Çıkış dosyalarının hedefi.
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, [abc] köşeli ayraçtaki 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.gifeşleşmez, ancak.gif eşleşir). Basit bir örnek: ***.txt , '.' ile başlamayan ve Görev çalışma dizininde veya herhangi bir alt dizinde .txt ile biten dosyalarla eşleşir. Dosya adı joker karakter içeriyorsa köşeli ayraçlar kullanılarak (ö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 yalnızca / 'nin Linux'ta 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 bir dosya karşıya yükleme hedefi belirtir.

Name Tür Description
containerUrl

string

Azure Blob Depolama'da dosyaları karşıya yüklenecek 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'ya 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 (yani 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[]

Çıktı dosyalarını karşıya yüklerken kullanılacak üst bilgilerin ad-değer çiftlerinin listesi
Bu üst bilgiler, Dosyaları Azure Depolama'ya yüklerken belirtilir. Blobları karşıya yüklerken izin verilen üst bilgilerle ilgili resmi belge: https://learn.microsoft.com/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 çıktı 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üklemenin hangi koşullar altında gerçekleştirildiği de dahil olmak üzere bir çıktı dosyası karşıya yükleme işlemiyle ilgili ayrıntılar.

Name Tür Description
uploadCondition

OutputFileUploadCondition

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

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 indirilmesi gereken dizindir. filePath'in dizin olarak kullanıldığı durumlarda, giriş verileriyle zaten ilişkili tüm dizin yapıları 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'yı işaret ederse işlem düğümlerinden okunabilir olmalıdır. Azure depolama alanındaki bir blob için böyle bir URL almanın üç yolu vardır: Blob üzerinde okuma izinleri veren Paylaşılan Erişim İmzası (SAS) dahil, okuma izni olan bir yönetilen 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'ya 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) dahil, okuma ve liste izinleri olan 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, yeniden deneme sayısı üst sınırı 3 ise Batch Görevi en fazla 4 kez dener (ilk 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 yok).
maxWallClockTime

string

Görevin çalıştırabileceği, Görevin başladığı zamandan ölçülen en uzun süre. Görev zaman 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 tutmak için gereken en düşük süre. Bu süreden sonra Batch hizmeti Görev dizinini ve tüm içeriğini silebilir.
Varsayılan değer 7 gündür; yani İş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örev için kapsayıcı ayarları.

Name Tür Description
containerHostBatchBindMounts

ContainerHostBatchBindMountEntry[]

Kapsayıcı görevine bağlanmak istediğiniz yollar.
Bu dizi null ise veya yoksa, kapsayıcı görevi windows'ta (veya Linux'ta AZ_BATCH_NODE_ROOT_DIR) geçici disk sürücüsünün tamamını bağlar. Bu dizi boş olarak ayarlanırsa kapsayıcıya veri yolu bağlamaz.
containerRunOptions

string

Kapsayıcı oluşturma komutuna ek seçenekler.
Bu ek seçenekler, Batch Hizmeti tarafından denetlenenlere ek olarak "docker create" komutuna bağımsız değişken 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ından önce 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 zamanlayabilmesi 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 zamanlayabilmesi için 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ülmesiyle ilgili bilgiler.

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, bu işlem için uygulama geliştiricisi tarafından uygulanan özel kuralı yansıtır. Kodunuzda karar almak 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 sorgulandığı 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ışındaki 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 sorgulandığı sayıdır.
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 sorgulandığı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

Batch hizmeti tarafından Görevin 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örev'i 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ğlı olabileceği görev kimlikleri aralığı. Bağımlı Görevin zamanlanması için önce aralıktaki 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ılabiliyor 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 deneme beklerken 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 olarak tamamlanmıştır ve yeniden deneme sınırını tüketmiştir. Görev başlatılırken bir hata oluştuğunda 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. Bu, kaynak dosyalarını indirme veya Görev'de belirtilen Paketleri dağıtma gibi görev düzeyinde hazırlıkları içerir. Bu, Görev komut satırının yürütülmeye başladığı anlamına gelmez.

TaskStatistics

Görev için 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ı ile Görev yürütmenin başlaması 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 ne zaman bittiğine kadar geçen süredir (veya görev o zamana kadar tamamlanmadıysa istatistiklerin 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 gibibayt.
writeIOps

integer

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

UserIdentity

Görevin ç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 çalıştırıldığı kullanıcı kimliğinin adı.
userName ve autoUser özellikleri birbirini dışlar; birini belirtmeniz gerekir, ancak ikisini birden belirtmemelisiniz.