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). |
|
job
|
path | True |
string |
Görevi içeren İşin ID'si. |
|
task
|
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. |
|
|
time
|
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 |
İstek başarılı oldu. Üst Bilgiler
|
|
| Other Status Codes |
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 |
|---|---|
|
Authentication |
Görevin Batch hizmeti işlemlerini gerçekleştirmek için kullanabileceği kimlik doğrulama belirtecinin ayarları. |
|
Auto |
AutoUserScope enumları |
|
Auto |
Azure Batch Görevi çalıştıran otomatik kullanıcının seçeneklerini belirtir. |
|
Batch |
BatchAccessScope enums |
|
Batch |
Batch hizmeti tarafından görev başlatılacak bir İşlem Düğümü seçmek için kullanılabilecek bir yerellik ipucu. |
|
Batch |
İşlem Düğümlerine dağıtılacak paket başvurusu. |
|
Batch |
Azure Batch hizmetinden alınan bir hata yanıtı. |
|
Batch |
Azure Batch hata yanıtına dahil edilen ek bilgilerden oluşan bir öğe. |
|
Batch |
Azure Batch hata yanıtında bir hata iletisi alındı. |
|
Batch |
BatchErrorSourceCategory enums |
|
Batch |
BatchJobAction enumları |
|
Batch |
İşlem düğümlerinin kullanacağı Batch havuzuyla ilişkili kullanıcı tarafından atanan kimliğe başvuru. |
|
Batch |
Görevin üzerinde çalıştırıldığı İşlem Düğümü hakkında bilgi. |
|
Batch |
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. |
|
Batch |
Göreve uygulanacak yürütme kısıtlamaları. |
|
Batch |
Bir Görevin yürüttüğü kapsayıcı hakkında bilgi içerir. |
|
Batch |
Görev için kapsayıcı ayarları. |
|
Batch |
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. |
|
Batch |
Görevin yürütülmesiyle ilgili bilgiler. |
|
Batch |
BatchTaskExecutionResult enums |
|
Batch |
Görev hatası hakkında bilgi. |
|
Batch |
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. |
|
Batch |
BatchTaskState enums |
|
Batch |
Görev için kaynak kullanım istatistikleri. |
|
Container |
Görev kapsayıcısına bağlamak istediğiniz yol ve bağlama modunun girişi. |
|
Container |
Kapsayıcı görevinin kapsayıcısına bağlanacak yollar. |
|
Container |
Özel bir kapsayıcı kayıt defteri. |
|
Container |
ContainerWorkingDirectory enums |
|
Dependency |
DependencyAction enums |
|
Elevation |
ElevationLevel enums |
|
Environment |
Görev işleminde ayarlanacak ortam değişkeni. |
|
Exit |
Görevden belirli bir çıkış koduyla çıkılması durumunda Batch hizmetinin nasıl yanıt vermesi gerektiği. |
|
Exit |
Çıkış kodları aralığı ve Batch hizmetinin bu aralıktaki çıkış kodlarına nasıl yanıt vermesi gerektiği. |
|
Exit |
Görev tamamlandığında Batch hizmetinin nasıl yanıt vereceğini belirtir. |
|
Exit |
Batch hizmetinin belirli bir çıkış koşuluna nasıl yanıt vereceğini belirtir. |
|
Multi |
Ç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 |
Ad-değer çiftini temsil eder. |
|
Output |
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. |
|
Output |
Azure blob depolama kapsayıcısı içinde bir dosya karşıya yükleme hedefi belirtir. |
|
Output |
Dosyanın karşıya yüklenmesi gereken hedef. |
|
Output |
OutputFileUploadCondition enums |
|
Output |
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. |
|
Output |
HTTP üst bilgisi ad-değer çifti |
|
Resource |
İşlem Düğümüne indirilecek tek bir dosya veya birden çok dosya. |
|
User |
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 |
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 |
Otomatik kullanıcının yükseltme düzeyi. Varsayılan değer nonAdmin'dir. |
|
| scope |
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 |
Hatayı açıklayan ve kullanıcı arabiriminde görüntülenmeye uygun olması amaçlanan bir ileti. |
|
| values |
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 |
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 |
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 |
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 |
Bu Göreve uygulanan yürütme kısıtlamaları. |
|
| containerSettings |
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 |
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 |
Görev için ortam değişken ayarlarının bir listesi. |
|
| executionInfo |
Görevin yürütülmesiyle ilgili bilgiler. |
|
| 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 |
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 |
Görevin çalıştığı Hesaplama Düğümü hakkında bilgi. |
|
| outputFiles |
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 |
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 |
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 |
Görevin mevcut durumu. |
|
| stateTransitionTime |
string (date-time) |
Görevin mevcut haline girdiği zaman. |
| stats |
Görev için kaynak kullanım istatistikleri. |
|
| url |
string (uri) |
Görevin URL'si. |
| 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 |
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 |
Özel kayıt cihazı, konteyner Image'i içerir. Bu ayar Havuz oluşturma sırasında zaten sağlanmışsa çıkarılabilir. |
|
| workingDirectory |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
Görev çıkış kodu aralıklarının listesi ve Batch servisinin bunlara nasıl yanıt vermesi gerektiği. |
|
| exitCodes |
Bireysel Görev çıkış kodlarının listesi ve Batch servisinin bunlara nasıl yanıt vermesi gerektiği. |
|
| fileUploadError |
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 |
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 |
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 |
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 |
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 |
Çı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 |
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 |
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 |
Çı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 |
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 |
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 |
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 |
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. |