Aracılığıyla paylaş


Tasks - Get Task

Belirtilen Görev hakkında bilgi alır.
Çok örnekli Görevler için, affinityId, executionInfo ve nodeInfo gibi bilgiler birincil Görev'e atıfta bulunur. Alt görevler hakkında bilgi almak için list alt görevler API'sini kullanın.

GET {endpoint}/jobs/{jobId}/tasks/{taskId}?api-version=2025-06-01
GET {endpoint}/jobs/{jobId}/tasks/{taskId}?api-version=2025-06-01&timeOut={timeOut}&$select={$select}&$expand={$expand}

URI Parametreleri

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

string (uri)

Batch hesabı uç noktası (örneğin: https://batchaccount.eastus2.batch.azure.com).

jobId
path True

string

Görevi içeren İşin ID'si.

taskId
path True

string

Bilgi almak için görevin kimliği.

api-version
query True

string

minLength: 1

Bu işlem için kullanılacak 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, varsayılan kullanılacaktır.".

İstek Başlığı

Name Gerekli Tür Description
client-request-id

string

Arayan tarafından oluşturulan istek kimliği, küme ayraçları gibi süslemesi olmayan bir GUID biçiminde, örneğin 9C4D50EE-2D56-4CD3-8152-34347DC9F2B0.

return-client-request-id

boolean

Sunucunun yanıtta client-request-id döndürip döndürmeyeceği.

ocp-date

string (date-time-rfc7231)

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

If-Modified-Since

string (date-time-rfc7231)

İ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-rfc7231)

İ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.

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.

Yanıtlar

Name Tür Description
200 OK

BatchTask

İstek başarılı oldu.

Üst Bilgiler

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

BatchError

Beklenmeyen bir hata yanıtı.

Güvenlik

OAuth2Auth

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

Kapsamlar

Name Description
https://batch.core.windows.net//.default

Örnekler

Task get

Örnek isteği

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


Örnek yanıt

{
  "id": "testTask",
  "url": "https://account.region.batch.azure.com/jobs/jobId/tasks/taskId",
  "eTag": "0x8D3D62350711C55",
  "creationTime": "2025-09-06T06:59:15.1161429Z",
  "lastModified": "2025-09-06T06:59:15.1161429Z",
  "state": "active",
  "stateTransitionTime": "2025-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
AuthenticationTokenSettings

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

AutoUserScope

AutoUserScope enumları

AutoUserSpecification

Azure Batch Görevi çalıştıran otomatik kullanıcının seçeneklerini belirtir.

BatchAccessScope

BatchAccessScope enums

BatchAffinityInfo

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

BatchApplicationPackageReference

İşlem Düğümlerine dağıtılacak paket başvurusu.

BatchError

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

BatchErrorDetail

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

BatchErrorMessage

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

BatchErrorSourceCategory

BatchErrorSourceCategory enums

BatchJobActionKind

BatchJobAction enumları

BatchNodeIdentityReference

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

BatchNodeInfo

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

BatchTask

Batch, Bir Düğümde kurtarma işlemi tetiklendiğinde Görevleri yeniden dener. İyi durumda olmayan bir Düğüm yeniden başlatıldığında veya konak hatası nedeniyle bir İşlem Düğümü kaybolduğunda kurtarma işlemlerine örnek olarak verilebilir (ancak bunlarla sınırlı değildir). Kurtarma işlemleri nedeniyle yapılan yeniden denemeler, maxTaskRetryCount'a göre bağımsızdır ve sayılmaz. maxTaskRetryCount değeri 0 olsa bile, kurtarma işlemi nedeniyle bir iç yeniden deneme gerçekleşebilir. Bu nedenle, tüm Görevler bir kez etkili olmalıdır. Bu, Görevlerin bozulmaya veya yinelenen verilere neden olmadan kesintiye uğramasına ve yeniden başlatılmasına tolerans göstermesi gerektiği anlamına gelir. Uzun süre çalışan Görevler için en iyi yöntem, bir tür denetim noktası kullanmaktır.

BatchTaskConstraints

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

BatchTaskContainerExecutionInfo

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

BatchTaskContainerSettings

Görev için kapsayıcı ayarları.

BatchTaskDependencies

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.

BatchTaskExecutionInfo

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

BatchTaskExecutionResult

BatchTaskExecutionResult enums

BatchTaskFailureInfo

Görev hatası hakkında bilgi.

BatchTaskIdRange

Aralığın başlangıcı ve sonu dahildir. Örneğin, bir aralığın başlangıç 9 ve bitiş 12'leri varsa, '9', '10', '11' ve '12' görevlerini temsil eder.

BatchTaskState

BatchTaskState enums

BatchTaskStatistics

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

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.

ContainerRegistryReference

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

ContainerWorkingDirectory

ContainerWorkingDirectory enums

DependencyAction

DependencyAction enums

ElevationLevel

ElevationLevel enums

EnvironmentSetting

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

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.

MultiInstanceSettings

Ç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.

NameValuePair

Ad-değer çiftini temsil eder.

OutputFile

Her karşıya yüklenen dosyada Batch hizmeti işlem düğümüne 'fileuploadout.txt' ve 'fileuploaderr.txt' olmak üzere iki günlük dosyası yazar. Bu günlük dosyaları belirli bir hata hakkında daha fazla bilgi edinmek için kullanılır.

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

OutputFileUploadCondition enums

OutputFileUploadConfig

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

OutputFileUploadHeader

HTTP üst bilgisi ad-değer çifti

ResourceFile

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

UserIdentity

Görevin çalıştırıldığı kullanıcı kimliğinin tanımı. userName veya autoUser özelliğini belirtin, ancak ikisini birden belirtmeyin.

AuthenticationTokenSettings

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

Name Tür Description
access

BatchAccessScope[]

Token'ın erişim sağladığı Batch kaynakları. Kimlik doğrulama belirtekosu, sınırlı sayıda Batch servis operasyonuna erişim sağlar. Şu anda erişim özelliği için desteklenen tek değer 'job'dur; bu değer, Görevi içeren İşle ilgili tüm işlemlere erişim sağlar.

AutoUserScope

AutoUserScope enumları

Değer Description
task

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

pool

Görevin, bir Havuzdaki her Hesaplama Düğümünde oluşturulan ortak otomatik kullanıcı hesabı olarak çalıştığını belirtir.

AutoUserSpecification

Azure Batch Görevi çalıştıran otomatik kullanıcının seçeneklerini 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 şekilde değiştirirse.

BatchAccessScope

BatchAccessScope enums

Değer Description
job

Görevi içeren tüm işlemleri gerçekleştirme hakkı tanır.

BatchAffinityInfo

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

Daha önce çalıştırılmış bir Hesaplama Düğümü veya Görevin konumunu temsil eden opak bir dizidir. Bir Düğümün affinityId'sini vererek bu Görevin o Compute Düğümünde çalışması gerektiğini belirtebilirsiniz. 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.

BatchApplicationPackageReference

İşlem Düğümlerine dağıtılacak paket başvurusu.

Name Tür Description
applicationId

string

Dağıtım yapı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. Eğer bu bir Havuzda atlanırsa ve bu uygulama için varsayılan sürüm belirtilmemişse, istek InvalidApplicationPackageReferences hata kodu ve HTTP durum kodu 409 ile başarısız olur. Eğer bu bir Görevde atlanırsa ve bu uygulama için varsayılan sürüm belirtilmemişse, Görev ön işlem hatasıyla başarısız olur.

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

BatchErrorMessage

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

values

BatchErrorDetail[]

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

BatchErrorDetail

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

Name Tür Description
key

string

Value özelliğinin anlamını belirten tanımlayıcı.

value

string

Hata yanıtına eklenen ek bilgiler.

BatchErrorMessage

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

Name Tür Description
lang

string

Hata mesajının dil kodu.

value

string

İletinin metni.

BatchErrorSourceCategory

BatchErrorSourceCategory enums

Değer Description
usererror

Hata, kullanıcı sorunundan kaynaklanıyor, örneğin yanlış yapılandırma.

servererror

Hata dahili bir sunucu sorunundan kaynaklanıyor.

BatchJobActionKind

BatchJobAction enumları

Değer Description
none

Hiçbir şey yapma.

disable

İşi devre dışı bırak. Bu, disable Job API'yi çağırmakla eşdeğerdir ve disableTasks değeri requeue olarak belirlenir.

terminate

İşi kapatın. İşin executionInfo içindeki terminationReason "TaskFailed" olarak ayarlanmıştır.

BatchNodeIdentityReference

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

Name Tür Description
resourceId

string (arm-id)

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

BatchNodeInfo

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

Name Tür Description
affinityId

string

Görevin çalıştığı düğüm için bir tanımlayıcı, bu Görev eklenirken bu Hesaplama Düğümünde Görevin planlanmasını talep etmek için iletilebilir.

nodeId

string

Görevin üzerinde çalıştığı Hesaplama Düğümünün kimliği.

nodeUrl

string (uri)

Görevin çalıştığı Compute düğümünün URL'si.

poolId

string

Görevin üzerinde çalıştığı havuzun kimliği.

taskRootDirectory

string

Compute Node'daki Görevin kök dizini.

taskRootDirectoryUrl

string (uri)

Hesaplama düğümündeki Görevin kök dizinine ait URL.

BatchTask

Batch, Bir Düğümde kurtarma işlemi tetiklendiğinde Görevleri yeniden dener. İyi durumda olmayan bir Düğüm yeniden başlatıldığında veya konak hatası nedeniyle bir İşlem Düğümü kaybolduğunda kurtarma işlemlerine örnek olarak verilebilir (ancak bunlarla sınırlı değildir). Kurtarma işlemleri nedeniyle yapılan yeniden denemeler, maxTaskRetryCount'a göre bağımsızdır ve sayılmaz. maxTaskRetryCount değeri 0 olsa bile, kurtarma işlemi nedeniyle bir iç yeniden deneme gerçekleşebilir. Bu nedenle, tüm Görevler bir kez etkili olmalıdır. Bu, Görevlerin bozulmaya veya yinelenen verilere neden olmadan kesintiye uğramasına ve yeniden başlatılmasına tolerans göstermesi gerektiği anlamına gelir. Uzun süre çalışan Görevler için en iyi yöntem, bir tür denetim noktası kullanmaktır.

Name Tür Description
affinityInfo

BatchAffinityInfo

Toplu hizmet tarafından yeni Görevi başlatmak için bir Hesaplama Düğümü seçmek için kullanılabilecek bir yerlilik ipucu.

applicationPackageReferences

BatchApplicationPackageReference[]

Komut satırını çalıştırmadan önce Batch servisinin Compute Node'a dağıtacağı Paketlerin listesi. Uygulama paketleri paylaşılan bir dizine indirilir ve Görev çalışma dizinine değil de dağıtılır. Bu nedenle, referans verilen bir paket zaten Node'da ise ve güncelse, yeniden indirilmez; Compute Node'daki mevcut kopya kullanılır. Örneğin paket silindiği veya indirme başarısız olduğu için referans verilen bir Paket kurulamazsa, 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 servisi Görev'e Hesap erişim anahtarı gerektirmeden Batch servis işlemlerini doğrulamak için kullanılabilecek bir kimlik doğrulama belirteğeri sağlar. Belirteç, AZ_BATCH_AUTHENTICATION_TOKEN ortam değişkeni aracılığıyla sağlanır. Görevin token kullanarak gerçekleştirebileceği işlemler ayarlara bağlıdır. Örneğin, bir Görev, İşe başka Görevler eklemek veya İşin ya da İş altındaki diğer Görevlerin durumunu kontrol etmek için İş izinleri isteyebilir.

commandLine

string

Görevin komut satırı. Çok örnekli Görevler için, komut satırı, birincil Görev ve tüm alt görevler koordinasyon komut satırını çalıştırmayı tamamladıktan sonra birincil Görev olarak çalıştırı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

BatchTaskConstraints

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

containerSettings

BatchTaskContainerSettings

Görevin çalıştığı konteyner ayarları. Bu görevi çalıştıracak Havuzda containerConfiguration ayarı varsa, bu da ayarlanmalıdır. Bu görevi çalıştıracak Havuzda containerConfiguration ayarı yoksa, bu ayarlanmamalıdır. Bu belirtildiğinde, AZ_BATCH_NODE_ROOT_DIR'nin altındaki tüm dizinler (düğümdeki Azure Batch dizinlerinin kökü) konteynere eşlenir, tüm Görev ortamı değişkenleri konteynere eşlenir ve Görev komut satırı konteynerde çalıştırılır. AZ_BATCH_NODE_ROOT_DIR dışında konteynerde üretilen dosyalar ana diske yansıtılmayabilir, bu da Batch dosya API'lerinin bu dosyalara erişemeyeceği anlamına gelir.

creationTime

string (date-time)

Görevin yaratılış zamanı.

dependsOn

BatchTaskDependencies

Bu Görevin dayandığı Görevler. Bu Görev, bağlı olduğu tüm Görevler başarıyla tamamlanana kadar planlanmaz. Bu görevlerden herhangi biri başarısız olursa ve tekrar deneme sayıları tükenirse, bu Görev asla planlanmayacak.

displayName

string

Görev için bir gösterim 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'ı. Bu, opak bir dizedir. Görevin istekler arasında değişip değişmediğini tespit etmek için kullanabilirsiniz. Özellikle, bir Görevi güncellerken ETag'ı vererek değişikliklerinizin ancak bu süre içinde başka kimse Görevi değiştirmediyse geçerli olması gerektiğini belirtebilirsiniz.

environmentSettings

EnvironmentSetting[]

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

executionInfo

BatchTaskExecutionInfo

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

exitConditions

ExitConditions

Görev tamamlandığında Batch servisinin nasıl yanıt vermesi gerektiği.

id

string

İş içindeki Görevi benzersiz şekilde 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 (date-time)

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

multiInstanceSettings

MultiInstanceSettings

Görevin çok örnekli bir Görev olduğunu gösteren ve çoklu örnekli Görevin nasıl çalıştırılacağına dair bilgi içeren bir nesne.

nodeInfo

BatchNodeInfo

Görevin çalıştığı Hesaplama Düğümü hakkında bilgi.

outputFiles

OutputFile[]

Komut satırı çalıştırıldıktan sonra Compute Node'dan Batch servisinin yükleyeceği dosyaların listesi. Çoklu örnek Görevler için, dosyalar yalnızca birincil Görevin yürütüldiği Hesaplama Düğümünden yüklenir.

previousState

BatchTaskState

Görevin önceki durumu. Bu özellik, Görev ilk Aktif durumundaysa, ayarlanmaz.

previousStateTransitionTime

string (date-time)

Görevin önceki haline girdiği zaman. Bu özellik, Görev ilk Aktif durumundaysa, ayarlanmaz.

requiredSlots

integer (int32)

Görevin çalıştırması için gereken zamanlama slotu sayısı. Varsayılan değer 1'dir. Bir Görev, yalnızca düğümde yeterince boş zamanlama slotu varsa hesaplama düğümünde çalışacak şekilde planlanabilir. Ç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üldiği Hesaplama 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

BatchTaskState

Görevin mevcut durumu.

stateTransitionTime

string (date-time)

Görevin mevcut haline girdiği zaman.

stats

BatchTaskStatistics

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

url

string (uri)

Görevin URL'si.

userIdentity

UserIdentity

Görevin çalıştığı kullanıcı kimliği. Eğer atlanırsa, Görev Görev'e özgü yönetici olmayan bir kullanıcı olarak çalışır.

BatchTaskConstraints

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

Name Tür Description
maxTaskRetryCount

integer (int32)

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 çıkış kodu nedeniyle Görev çalıştırılabilir dosyasının tekrar deneme sayısını özellikle kontrol ettiğ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). Maksimum tekrar deneme sayısı 0 ise, Parti servisi ilk denemeden sonra Görevi tekrar 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 (duration)

Görevin başladığı andan itibaren ölçülecek maksimum geçen süre. Görev süre sınırı içinde tamamlanmazsa, Batch servisi onu sonlandırır. Bu belirtilmemişse, Görevin ne kadar süreyle devam edebileceğine dair bir zaman sınırı yoktur.

retentionTime

string (duration)

Görev dizininin çalıştırıldığı Compute Node'da çalıştırılması için minimum süre, çalıştırma tamamlandığı andan itibaren geçerlidir. Bu süreden sonra, Batch servisi Görev dizinini ve tüm içeriğini silebilir. Varsayılan olarak 7 gündür, yani Görev dizini, Hesaplama Düğümü kaldırılmadıkça veya İş silinmedikçe 7 gün boyunca korunur.

BatchTaskContainerExecutionInfo

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

Name Tür Description
containerId

string

Konteynerin kimliği.

error

string

Konteyner hakkında ayrıntılı hata bilgisi. Bu, Docker servisinden alınan ayrıntılı hata dizisi, eğer varsa. Bu, "docker inspect" ile verilen hata alanına eşdeğerdir.

state

string

Konteynerin durumu. Docker servisine göre konteynerin durumu budur. Bu, "docker inspect" ile döndürülen durum alanına eşdeğerdir.

BatchTaskContainerSettings

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ışacağı konteyneri oluşturmak için kullanılacak Görüntü. Bu, "docker pull" olarak belirtildiği gibi tam Image referansıdır. Eğer Görsel adının parçası olarak herhangi bir etiket sağlanmıyorsa, varsayılan olarak ":latest" etiketi kullanılır.

registry

ContainerRegistryReference

Özel kayıt cihazı, konteyner Image'i içerir. Bu ayar Havuz oluşturma sırasında zaten sağlanmışsa çıkarılabilir.

workingDirectory

ContainerWorkingDirectory

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

BatchTaskDependencies

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

BatchTaskIdRange[]

Bu Görevin bağlı olduğu Görev ID aralıklarının listesi. Tüm Görevler, bağımlı Görev planlanabilmek için tüm aralıklardaki görevlerin başarıyla tamamlanması gerekir.

taskIds

string[]

Bu Görevin bağlı olduğu Görev Tanımları listesi. Bu listedeki tüm Görevler, bağımlı Görev planlanabilmeden önce başarıyla tamamlanmalıdır. TaskIds koleksiyonu toplamda 64000 karakterle sınırlıdır (yani tüm Görev Tanımlarının toplam uzunluğu). TaskIds koleksiyonu maksimum uzunluğu aşarsa, Add Task isteği TaskDependencyListTooLong hata kodu ile başarısız olur. Bu durumda Görev Kimliği aralıklarını kullanmayı düşünün.

BatchTaskExecutionInfo

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

Name Tür Description
containerInfo

BatchTaskContainerExecutionInfo

Görevin yürütüldiği konteyner hakkında bilgiler. Bu özellik yalnızca Görev bir konteyner bağlamında çalışıyorsa ayarlanır.

endTime

string (date-time)

Görevin tamamlandığı zaman. Bu özellik yalnızca Görev Tamamlanmış durumdaysa ayarlanır.

exitCode

integer (int32)

Görev komut satırında belirtilen programın çıkış kodu. Bu özellik yalnızca Görev tamamlanmış durumdaysa, ayarlanır. Genel olarak, bir sürecin çıkış kodu, uygulama geliştiricisinin o süreç için uyguladığı özel konvansiyonu yansıtır. Kodunuzda karar vermek için çıkış kodu değerini kullanıyorsanız, uygulama sürecinde kullanılan çıkış kodu konvansiyonunu bildiğinizden emin olun. Ancak, Batch servisi Görevi sonlandırırsa (zaman aşımı veya API üzerinden kullanıcı sonlandırması nedeniyle) işletim sistemi tarafından tanımlanmış bir çıkış kodu görebilirsiniz.

failureInfo

BatchTaskFailureInfo

Görev başarısızlığını tanımlayan bilgiler, varsa. Bu özellik yalnızca Görev tamamlanmış durumdaysa ve bir arıza yaşandığında ayarlanır.

lastRequeueTime

string (date-time)

Görevin Batch servisi tarafından kullanıcı talebi sonucu yeniden sıraya alındığı en son zamandır. Bu özellik yalnızca requeueCount sıfır değilse ayarlanır.

lastRetryTime

string (date-time)

Görevin yeniden denemesinin başladığı en son zaman. Bu eleman yalnızca Görev yeniden denendiyse (yani retryCount sıfır değilse) mevcuttur. Varsa, bu genellikle startTime ile aynıdır, ancak Görev başka nedenlerle yeniden başlatıldıysa farklı olabilir; örneğin, Compute Node yeniden başlatıldıysa yeniden başlatıldıysa, startTime güncellenir ama son RetryTime güncellenmez.

requeueCount

integer (int32)

Bir kullanıcı talebi sonucu Batch servisi tarafından Görevin yeniden sıraya alınma sayısı. Kullanıcı Compute Node'ları bir havuzdan kaldırdığında (havuzu yeniden boyutlandırarak/küçülterek) veya İş devre dışı bırakıldığında, kullanıcı Compute Node'larda çalışan Görevlerin çalıştırılmaya yeniden sıraya alınmasını belirtebilir. Bu sayım, Görevin bu nedenlerle kaç kez yeniden sıraya alındığını takip eder.

result

BatchTaskExecutionResult

Görevin uygulanmasının sonucu. Değer 'başarısız' ise, arızanın detayları failureInfo özelliğinde bulunabilir.

retryCount

integer (int32)

Görevin Batch servisi tarafından kaç kez yeniden denendiği. Görev uygulaması hataları (sıfır olmayan çıkış kodu) tekrar denenir, ön işlem hataları (Görev çalıştırılamamıştır) ve dosya yükleme hataları tekrar denenmez. Batch servisi, kısıtlamalarla belirtilen sınıra kadar Görevi tekrar dener.

startTime

string (date-time)

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

BatchTaskExecutionResult

BatchTaskExecutionResult enums

Değer Description
success

Görev başarılı bir şekilde yürütüldü.

failure

Görev işlenmesi sırasında bir hata yaşandı. Hata, Görev süreci başlatılmadan önce, Görev süreci çalışırken veya Görev süreci çıktıktan sonra meydana gelmiş olabilir.

BatchTaskFailureInfo

Görev hatası hakkında bilgi.

Name Tür Description
category

BatchErrorSourceCategory

Görev hatası kategorisi.

code

string

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

details

NameValuePair[]

Hatayla ilgili ek detayların listesi.

message

string

Görev hatasını tanımlayan bir mesaj, kullanıcı arayüzünde görüntülenmeye uygun olması amaçlanmıştır.

BatchTaskIdRange

Aralığın başlangıcı ve sonu dahildir. Örneğin, bir aralığın başlangıç 9 ve bitiş 12'leri varsa, '9', '10', '11' ve '12' görevlerini temsil eder.

Name Tür Description
end

integer (int32)

Aralıktaki son Görev Kimliği.

start

integer (int32)

Menzildeki ilk Görev Kimliği.

BatchTaskState

BatchTaskState enums

Değer Description
active

Görev sıraya alınmış ve çalışabiliyor, ancak şu anda bir Hesaplama Düğümü'ne atanmamıştır. Bir 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 tekrar deneme beklediğinde bu duruma girer.

preparing

Görev, bir Compute Node'a atanmıştır, ancak Compute Node'da tamamlanması gereken İş Hazırlık Görevini beklemektedir. Eğer İş Hazırlık Görevi başarılı olursa, görev koşuya geçer. Eğer İş Hazırlığı Görevi başarısız olursa, Görev aktif hale gelir ve farklı bir Hesaplama Düğümü'ne atanmaya uygun olur.

running

Görev bir Compute Node'da çalışıyor. Bu, kaynak dosyalarının indirilmesi veya Görevde belirtilen Paketlerin dağıtılması gibi görev düzeyinde hazırlıkları da içerir - bu, Görev komut satırının çalışmaya başladığı anlamına gelmez.

completed

Görev artık çalışmaya uygun değildir, genellikle başarıyla tamamlandığı veya başarısız olup tekrar deneme limitini bitirdiği için. Görev başlatılırsa veya sonlandırıldığında bir hata meydana geldiyse de Görev tamamlanmış olarak işaretlenir.

BatchTaskStatistics

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

Name Tür Description
kernelCPUTime

string (duration)

Görev tarafından tüketilen toplam çekirdek modu CPU süresi (tüm çekirdekler ve tüm Hesaplama Düğümleri arasında toplanmıştır).

lastUpdateTime

string (date-time)

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

readIOGiB

number (float)

Görev tarafından diskten okunan toplam gibibaytlar.

readIOps

string (int64)

Görev tarafından yapılan toplam disk okuma işlemleri.

startTime

string (date-time)

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

url

string (uri)

İstatistiklerin URL'si.

userCPUTime

string (duration)

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

waitTime

string (duration)

Görevin toplam bekleme süresi. Bir Görev için bekleme süresi, Görevin oluşturulması ile Görev yürütülmesinin başlaması arasındaki geçen süre olarak tanımlanır. (Görev başarısızlıklar nedeniyle tekrar denenirse, bekleme süresi en son Görev yürütülmesine kadar olan zamandır.)

wallClockTime

string (duration)

Görevin toplam duvar saati süresi. Duvar saati zamanı, Görevin bir Hesaplama Düğümünde çalışmaya başladığı andan bittiği zamana kadar (veya Görev o zamana kadar bitmemişse, istatistiklerin son güncellendiği zamana kadar) geçen süredir. Görev tekrar denendiyse, bu tüm Görev denemelerinin duvar saati saatini de kapsar.

writeIOGiB

number (float)

Görev tarafından diske yazılmış toplam gibibaytlar.

writeIOps

string (int64)

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

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.

Değer Description
Shared

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

Startup

Başlangıç görevinin yolu.

VfsMounts

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

Task

Görev yolu.

JobPrep

İş hazırlama görev yolu.

Applications

Uygulama yolu.

ContainerRegistryReference

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

Name Tür Description
identityReference

BatchNodeIdentityReference

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.

password

string (password)

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

registryServer

string (uri)

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

ContainerWorkingDirectory enums

Değer Description
taskWorkingDirectory

Toplu hizmet Görev çalışma dizinini kullanın; bu dizin, Batch tarafından doldurulmuş Görev Kaynak Dosyalarını içerir.

containerImageDefault

Konteyner Image'de tanımlanan çalışma dizinini kullanın. Bu dizinin Batch tarafından indirilen Kaynak Dosyalarını içermeyeceğine dikkat edin.

DependencyAction

DependencyAction enums

Değer Description
satisfy

Bu görevi bekleyen görevleri yerine getir; Tüm bağımlılıklar sağlandıktan sonra, görev çalışması planlanacaktır.

block

Bu görevde bekleyen görevleri engeller, böylece planlanmasını engeller.

ElevationLevel

ElevationLevel enums

Değer Description
nonadmin

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

admin

Kullanıcı, yükseltilmiş erişimi olan bir kullanıcıdır ve tam Yönetici izinleriyle çalışı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.

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 (int32)

Bir süreç çıkış kodu.

exitOptions

ExitOptions

Görev bu çıkış koduyla çıkarsa Batch servisinin 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 (int32)

Aralıktaki son çıkış kodu.

exitOptions

ExitOptions

Görev baştan sona bir çıkış koduyla çıkarsa Batch servisinin nasıl yanıt vermesi gerektiği (kapsül).

start

integer (int32)

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 özelliklerin kapsamayan çıkış koşulu ile başarısız olursa Batch servisinin nasıl yanıt vermesi gerektiği. Bu değer, Görev ExitCodes veya exitCodeRanges koleksiyonunda listelenmeyen sıfır olmayan herhangi bir çıkış koduyla çıkarsa, preProcessingError özelliği yoksa ön işleme hatası veya fileUploadError özelliği yoksa dosya yükleme hatası durumunda kullanılır. Çıkış kodu 0'da varsayılan olmayan davranış istiyorsanız, bunu exitCodes veya exitCodeRanges koleksiyonunu kullanarak açıkça listelemelisiniz.

exitCodeRanges

ExitCodeRangeMapping[]

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

exitCodes

ExitCodeMapping[]

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

fileUploadError

ExitOptions

Dosya yükleme hatası olursa Batch servisinin nasıl yanıt vermesi gerektiği. Görev, exitCodes veya exitCodeRanges ile belirtilen bir çıkış koduyla çıktıysa ve ardından dosya yükleme hatasıyla karşılaştıysa, çıkış kodunda belirtilen eylem öncelikli olur.

preProcessingError

ExitOptions

Görev bir hata nedeniyle başlamazsa Batch servisinin 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 servisinin bu Göreve bağlı olan Görevler üzerinde gerçekleştirdiği bir eylem. Olası değerler 'tatisfy' (bağımlı görevlerin ilerlemesine izin vermek) ve 'block' (bağımlı görevler beklemeye devam etmek) olabilir. Batch henüz bağımlı görevlerin iptalini desteklemiyor.

jobAction

BatchJobActionKind

Görevi içeren İşte yapılacak bir işlem, eğer Görev verilen çıkış koşuluyla tamamlanıyorsa ve İşin onTaskFailed özelliği 'performExitOptionsJobAction'dur. Çıkış kodu 0 için varsayılan olarak yok, diğer tüm çıkış koşulları için ise sonlandırmadır. Eğer İşin onTaskFailed özelliği noaction ise, bu özelliği belirtmek hata döndürür ve Add Task isteği 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 (Kötü İstek).

MultiInstanceSettings

Ç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.

Name Tür Description
commonResourceFiles

ResourceFile[]

Koordinasyon komut satırını çalıştırmadan önce Batch servisinin indireceği dosyaların listesi. Ortak kaynak dosyaları ile Görev kaynak dosyaları arasındaki fark, ortak kaynak dosyalarının birincil dosyalar dahil tüm alt görevler için indirilmesi, oysa Görev kaynak dosyaları yalnızca birincil için indirilmiştir. Ayrıca, bu kaynak dosyalarının Görev çalışma dizinine indirilmediğini, bunun yerine çalışma dizininin bir üst kısmındaki Görev kök dizinine 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

Tüm Compute Node'larda çalıştırılması için komut satırı, ana Görev komutunu çalıştırdığında koordinasyon yapabilmelerini sağlar. Tipik bir koordinasyon komut satırı, bir arka plan hizmeti başlatır ve servisin düğümler arası mesajları işlemeye hazır olup olmadığını doğrular.

numberOfInstances

integer (int32)

Görev için gereken Hesaplama Düğüm sayısı. Eğer hariç tutulursa, varsayılan değer 1'dir.

NameValuePair

Ad-değer çiftini temsil eder.

Name Tür Description
name

string

İsim-değer çiftindeki isim.

value

string

İsim-değer çiftindeki değer.

OutputFile

Her karşıya yüklenen dosyada Batch hizmeti işlem düğümüne 'fileuploadout.txt' ve 'fileuploaderr.txt' olmak üzere iki günlük dosyası yazar. Bu günlük dosyaları belirli bir hata hakkında daha fazla bilgi edinmek için kullanılır.

Name Tür Description
destination

OutputFileDestination

Çıkış dosya(lar)ının hedefi.

filePattern

string

Hangi dosya(lar)ın yükleneceğini gösteren bir desen. Hem göreli hem de mutlak yollar desteklenir. Göreceli yollar, Görev çalışma dizinine görecelidir. Aşağıdaki joker kartlar desteklenir: * 0 veya daha fazla karakterle eşleşir (örneğin pattern abc* abc veya abcdef ile eşleşir), ** herhangi bir dizinle eşleşir, ? herhangi bir tek karakteri eşleştirir, [abc] parantez içindeki bir karakteri eşleştirir ve [a-c] aralıktaki bir karakteri eşleştirir. Parantezler, belirtilmeyen herhangi bir karakterle eşleşmek için bir neginleştirme içerebilir (örneğin [!abc] a, b veya c dışında herhangi bir karakterle eşleşir). Bir dosya adı "." ile başlarsa, varsayılan olarak göz ardı edilir ancak açıkça belirtilerek eşleştirilebilir ( örneğin.gif .a.gifile eşleşmeyecek, ancak ..gif eşleşecektir). Basit bir örnek: ***.txt, '.' ile başlamayan ve Görev çalışma dizininde veya herhangi bir alt dizinde .txt ile biten herhangi bir dosyayla eşleşir. Dosya adı joker kart karakteri içeriyorsa, parantez kullanarak kaçış yapılabilir (örneğin abc[] abc adlı bir dosyayla eşleşir). Hem \ hem de / Windows'ta dizin ayırıcı olarak kabul edilir, ancak Linux'ta sadece / geçerlidir. Ortam değişkenleri (Windows'ta%var% veya Linux'ta $var) desen uygulanmadan önce genişletilir.

uploadOptions

OutputFileUploadConfig

Yükleme işlemi için ek seçenekler, yüklemenin hangi koşullarda yapılacağı dahil.

OutputFileBlobContainerDestination

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

Name Tür Description
containerUrl

string (uri)

Azure Blob Storage içindeki dosya(lar)ın yükleneceği konteynerin URL'si. Yönetilen bir kimlik kullanılmıyorsa, URL konteynere yazma izni veren Paylaşılan Erişim İmzası (SAS) içermelidir.

identityReference

BatchNodeIdentityReference

Azure Blob Storage'a erişmek için containerUrl tarafından belirlenen kullanıcı atadığı kimlik referansı. Kimlik Azure Blob Storage konteynerine yazma erişimine sahip olmalıdır.

path

string

Azure Storage konteyneri içindeki hedef blob veya sanal dizin. Eğer filePattern belirli bir dosyaya atıfta bulunursa (yani joker kart içermiyorsa), path o dosyanın yükleneceği blobun adıdır. Eğer filePattern bir veya daha fazla joker kart içeriyorsa (ve bu nedenle birden fazla dosyaya uyabiliyorsa), path dosya(lar)ın yükleneceği blob sanal dizinin adıdır (her blob adının önünde). Eğer atlanırsa, dosya(lar) konteynerin köküne dosya adlarına eşlik eden bir blob adıyla yüklenir.

uploadHeaders

OutputFileUploadHeader[]

Çıktı dosyalarının yüklenmesinde kullanılacak başlıklar için isim-değer çiftlerinin listesi. Bu başlıklar, Azure Storage'a dosya yüklenirken belirtilecektir. Lekeler yüklenirken izin verilen başlıklarla 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 depolamasında dosyaların yüklendiği bir konum.

OutputFileUploadCondition

OutputFileUploadCondition enums

Değer Description
tasksuccess

Dosya(lar)ı ancak Görev süreci 0 çıkış koduyla çıktıktan sonra yükleyin.

taskfailure

Dosya(lar)ı yalnızca Görev süreci sıfır olmayan bir çıkış koduyla çıktıktan sonra yükleyin.

taskcompletion

Görev süreci bittikten sonra dosya(lar)ı yükleyin, çıkış kodu ne olursa olsun.

OutputFileUploadConfig

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

Name Tür Description
uploadCondition

OutputFileUploadCondition

Görev çıktı dosyasının veya dosya kümesinin yüklenmesi gereken koşullar. Varsayılan durum görev tamamlamadır.

OutputFileUploadHeader

HTTP üst bilgisi ad-değer çifti

Name Tür Description
name

string

Çıkış dosyaları yüklenirken kullanılacak başlığın büyük harf duyarsız adı.

value

string

Çıkış dosyaları yüklenirken kullanılacak başlık değeri.

ResourceFile

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

Name Tür Description
autoStorageContainerName

string

Otomatik depolama Hesabındaki depolama konteyneri 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 Hesaplama Düğümlerine indirilen dosyalar için geçerlidir. Windows Compute Node'a indirilecek bir resourceFile için belirtilmişse bu göz ardı edilir. Bu özellik bir Linux Hesaplama Düğümü için belirtilmemişse, dosyaya varsayılan 0770 değeri uygulanır.

filePath

string

Dosya(lar)ın indirileceği Compute Node'daki konum, Task'ın çalışma dizinine göre. 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 çıkamaz (örneğin '..' kullanarak).

httpUrl

string (uri)

İ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

BatchNodeIdentityReference

Azure Blob Storage'a erişmek için kullanılan kullanıcı atanan kimlik referansı, storageContainerUrl veya httpUrl tarafından belirtilmiştir.

storageContainerUrl

string (uri)

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.

UserIdentity

Görevin çalıştırıldığı kullanıcı kimliğinin tanımı. userName veya autoUser özelliğini belirtin, ancak ikisini birden belirtmeyin.

Name Tür Description
autoUser

AutoUserSpecification

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