Aracılığıyla paylaş

Task - Add Collection

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

Belirtilen İşe bir Görev koleksiyonu ekler.
Her Görevin benzersiz bir kimliği olması gerektiğini unutmayın. Batch hizmeti, her Görevin sonuçlarını bu istekte Görevlerin gönderildiği sırayla döndürmeyebilir. Sunucu zaman aşımına uğradıysa veya istek sırasında bağlantı kapatılırsa, istek kısmen veya tamamen işlenmiş ya da hiç işlenmemiş olabilir. Böyle durumlarda kullanıcının isteği yeniden vermesi gerekir. bir isteği yeniden oluştururken hataları doğru şekilde işlemenin kullanıcıya bağlı olduğunu unutmayın. Örneğin, önceki işlem başarılı olursa yeniden denemenin beklenmedik şekilde ek Görevler oluşturmaması için yeniden deneme sırasında aynı Görev Kimliklerini kullanmanız gerekir. Yanıt eklenemeyen görevler içeriyorsa, istemci isteği yeniden deneyebilir. Yeniden denemede, yalnızca eklenemeyen Görevleri yeniden göndermek ve ilk denemede başarıyla eklenen Görevleri atlamak en verimli yöntemdir. Görevin tamamlanmasına ek olarak en uzun yaşam süresi 180 gündür. Görev eklendikten sonraki 180 gün içinde tamamlanmazsa, Batch hizmeti tarafından sonlandırılır ve o anda olduğu durumda bırakılır.

POST {batchUrl}/jobs/{jobId}/addtaskcollection?api-version=2024-07-01.20.0
İsteğe bağlı parametrelerle: 
POST {batchUrl}/jobs/{jobId}/addtaskcollection?timeout={timeout}&api-version=2024-07-01.20.0

URI Parametreleri

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

string

Tüm Azure Batch hizmet isteklerinin temel URL'si.
jobId
 path True

string

Görev koleksiyonunun eklendiği İşin kimliği.
api-version
 query True

string

İstemci API Sürümü.
timeout
 query

integer

int32

Sunucunun isteği işlemek için harcayabileceği en uzun süre (saniye cinsinden). Varsayılan değer 2 dakikadır. Değer 120'den büyükse, bunun yerine varsayılan değer kullanılır.

İstek Başlığı

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

Name Gerekli Tür Description
client-request-id

string

uuid

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

boolean

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

string

date-time-rfc1123

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

İstek Gövdesi

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

Name Gerekli Tür Description
value True

TaskAddParameter[]

Eklenecek Görevler koleksiyonu. En fazla Görev sayısı 100'dür.
Bu koleksiyonun toplam serileştirilmiş boyutu 1 MB'tan küçük olmalıdır. 1 MB'tan büyükse (örneğin, her görevin 100 kaynak dosyası veya ortam değişkeni varsa), istek 'RequestBodyTooLarge' koduyla başarısız olur ve daha az Görevle yeniden denenmelidir.

Yanıtlar

Name Tür Description
200 OK

TaskAddCollectionResult

Görev koleksiyonu ekleme işleminin sonuçlarını içeren yanıt.

Üst Bilgiler

  • client-request-id: string
  • request-id: string
Other Status Codes

BatchError

Beklenmeyen hata

Güvenlik

azure_auth

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

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

Kapsamlar

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

Authorization

Tür: apiKey
İçinde: header

Örnekler

Add a basic collection of tasks
Add a complex collection of tasks

Add a basic collection of tasks

Örnek isteği

POST account.region.batch.azure.com/jobs/jobId/addtaskcollection?api-version=2024-07-01.20.0



{
  "value": [
    {
      "id": "simple1",
      "commandLine": "cmd /c dir /s"
    },
    {
      "id": "simple2",
      "commandLine": "cmd /c dir /s"
    }
  ]
}

Örnek yanıt

Durum kodu:
200 
{
  "value": [
    {
      "status": "success",
      "taskId": "simple1",
      "eTag": "0x8D3D623CD661246",
      "lastModified": "2016-09-06T07:02:44.7589958Z",
      "location": "https://account.region.batch.azure.com/jobs/jobId/tasks/simple1"
    },
    {
      "status": "success",
      "taskId": "simple2",
      "eTag": "0x8D3D623CD7072CC",
      "lastModified": "2016-09-06T07:02:44.8270028Z",
      "location": "https://account.region.batch.azure.com/jobs/jobId/tasks/simple2"
    }
  ]
}

Add a complex collection of tasks

Örnek isteği

POST account.region.batch.azure.com/jobs/jobId/addtaskcollection?api-version=2024-07-01.20.0



{
  "value": [
    {
      "id": "complex1",
      "commandLine": "cmd /c dir /s",
      "resourceFiles": [
        {
          "autoStorageContainerName": "containerName",
          "filePath": "data"
        }
      ],
      "environmentSettings": [
        {
          "name": "env1",
          "value": "value1"
        },
        {
          "name": "env2",
          "value": "value2"
        }
      ],
      "affinityInfo": {
        "affinityId": "affinityId"
      },
      "constraints": {
        "maxWallClockTime": "P1D",
        "retentionTime": "P2D",
        "maxTaskRetryCount": 5
      },
      "requiredSlots": 2,
      "multiInstanceSettings": {
        "numberOfInstances": 3,
        "coordinationCommandLine": "cmd /c echo coordinating",
        "commonResourceFiles": [
          {
            "httpUrl": "https://common.blob.core.windows.net/",
            "filePath": "common.exe"
          }
        ]
      }
    },
    {
      "id": "simple3",
      "commandLine": "cmd /c dir /s"
    }
  ]
}

Örnek yanıt

Durum kodu:
200 
{
  "value": [
    {
      "taskId": "simple3",
      "status": "success",
      "eTag": "0x8D3D623CE295629",
      "lastModified": "2016-09-06T07:02:46.0386857Z",
      "location": "https://account.region.batch.azure.com/jobs/jobId/tasks/simple3"
    },
    {
      "taskId": "complex1",
      "status": "success",
      "eTag": "0x8D3D623CE29A412",
      "lastModified": "2016-09-06T07:02:46.0406802Z",
      "location": "https://account.region.batch.azure.com/jobs/jobId/tasks/complex1"
    }
  ]
}

Tanımlar

Name Description
AccessScope

Belirtecin erişim izni veren Batch kaynakları.
AffinityInformation

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

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

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

Otomatik kullanıcının kapsamı
AutoUserSpecification

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

HTTP üst bilgisi ad-değer çifti
JobAction

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

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

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

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

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

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

Karşıya yüklemenin hangi koşullar altında gerçekleştirildiği de dahil olmak üzere bir çıktı dosyası karşıya yükleme işlemiyle ilgili ayrıntılar.
ResourceFile

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

Eklenecek Azure Batch Görevleri koleksiyonu.
TaskAddCollectionResult

İş'e Bir Görev koleksiyonu eklemenin sonucu.
TaskAddParameter

Eklenecek bir Azure Batch Görevi.
TaskAddResult

Görev koleksiyonu ekleme işleminin parçası olarak eklenen tek bir Görevin sonucu.
TaskAddStatus

Görev ekleme isteğinin durumu.
TaskConstraints

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

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

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

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

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

AccessScope

Belirtecin erişim izni veren Batch kaynakları.

Name Tür Description
job

string

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

AffinityInformation

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

Name Tür Description
affinityId

string

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

ApplicationPackageReference

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

Name Tür Description
applicationId

string

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

string

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

AuthenticationTokenSettings

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

Name Tür Description
access

AccessScope[]

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

AutoUserScope

Otomatik kullanıcının kapsamı

Name Tür Description
pool

string

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

string

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

AutoUserSpecification

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

Name Tür Description
elevationLevel

ElevationLevel

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

AutoUserScope

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

BatchError

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

Name Tür Description
code

string

Hatanın tanımlayıcısı. Kodlar sabittir ve program aracılığıyla kullanılması amaçlanmıştır.
message

ErrorMessage

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

BatchErrorDetail[]

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

BatchErrorDetail

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

Name Tür Description
key

string

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

string

Hata yanıtına eklenen ek bilgiler.

ComputeNodeIdentityReference

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

Name Tür Description
resourceId

string

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

ContainerHostBatchBindMountEntry

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

Name Tür Description
isReadOnly

boolean

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

ContainerHostDataPath

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

ContainerHostDataPath

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

Name Tür Description
Applications

string

Uygulama yolu.
JobPrep

string

İş hazırlama görev yolu.
Shared

string

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

string

Başlangıç görevinin yolu.
Task

string

Görev yolu.
VfsMounts

string

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

ContainerRegistry

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

Name Tür Description
identityReference

ComputeNodeIdentityReference

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

string

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

string

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

string

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

ContainerWorkingDirectory

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

Name Tür Description
containerImageDefault

string

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

string

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

DependencyAction

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

Name Tür Description
block

string

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

string

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

ElevationLevel

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

Name Tür Description
admin

string

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

string

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

EnvironmentSetting

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

Name Tür Description
name

string

Ortam değişkeninin adı.
value

string

Ortam değişkeninin değeri.

ErrorMessage

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

Name Tür Description
lang

string

Hata iletisinin dil kodu
value

string

İletinin metni.

ExitCodeMapping

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

Name Tür Description
code

integer

İşlem çıkış kodu.
exitOptions

ExitOptions

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

ExitCodeRangeMapping

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

Name Tür Description
end

integer

Aralıktaki son çıkış kodu.
exitOptions

ExitOptions

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

integer

Aralıktaki ilk çıkış kodu.

ExitConditions

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

Name Tür Description
default

ExitOptions

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

ExitCodeRangeMapping[]

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

ExitCodeMapping[]

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

ExitOptions

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

ExitOptions

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

ExitOptions

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

Name Tür Description
dependencyAction

DependencyAction

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

JobAction

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

HttpHeader

HTTP üst bilgisi ad-değer çifti

Name Tür Description
name

string

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

string

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

JobAction

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

Name Tür Description
disable

string

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

string

Hiçbir işlem yapılmaz.
terminate

string

İşi sonlandırın. İşin executionInfo'sunda terminateReason "TaskFailed" olarak ayarlanır.

MultiInstanceSettings

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

Name Tür Description
commonResourceFiles

ResourceFile[]

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

string

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

integer

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

OutputFile

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

Name Tür Description
destination

OutputFileDestination

Çıkış dosyalarının hedefi.
filePattern

string

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

OutputFileUploadOptions

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

OutputFileBlobContainerDestination

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

Name Tür Description
containerUrl

string

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

ComputeNodeIdentityReference

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

string

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

HttpHeader[]

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

OutputFileDestination

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

Name Tür Description
container

OutputFileBlobContainerDestination

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

OutputFileUploadCondition

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

Name Tür Description
taskcompletion

string

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

string

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

string

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

OutputFileUploadOptions

Karşıya yüklemenin hangi koşullar altında gerçekleştirildiği de dahil olmak üzere bir çıktı dosyası karşıya yükleme işlemiyle ilgili ayrıntılar.

Name Tür Description
uploadCondition

OutputFileUploadCondition

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

ResourceFile

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

Name Tür Description
autoStorageContainerName

string

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

string

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

string

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

string

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

string

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

ComputeNodeIdentityReference

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

string

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

TaskAddCollectionParameter

Eklenecek Azure Batch Görevleri koleksiyonu.

Name Tür Description
value

TaskAddParameter[]

Eklenecek Görevler koleksiyonu. En fazla Görev sayısı 100'dür.
Bu koleksiyonun toplam serileştirilmiş boyutu 1 MB'tan küçük olmalıdır. 1 MB'tan büyükse (örneğin, her görevin 100 kaynak dosyası veya ortam değişkeni varsa), istek 'RequestBodyTooLarge' koduyla başarısız olur ve daha az Görevle yeniden denenmelidir.

TaskAddCollectionResult

İş'e Bir Görev koleksiyonu eklemenin sonucu.

Name Tür Description
value

TaskAddResult[]

Görev koleksiyonu ekleme işleminin sonuçları.

TaskAddParameter

Eklenecek bir Azure Batch Görevi.

Name Tür Description
affinityInfo

AffinityInformation

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

ApplicationPackageReference[]

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

AuthenticationTokenSettings

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

string

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

TaskConstraints

Bu Göreve uygulanan yürütme kısıtlamaları.
Kısıtlamaları belirtmezseniz maxTaskRetryCount, İş için belirtilen maxTaskRetryCount değeridir, maxWallClockTime değeri sonsuzdur ve retentionTime değeri 7 gündür.
containerSettings

TaskContainerSettings

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

TaskDependencies

Bu Görevin bağlı olduğu Görevler.
Bağımlı olduğu tüm Görevler başarıyla tamamlanana kadar bu Görev zamanlanmaz. Bu Görevlerden herhangi biri başarısız olursa ve yeniden deneme sayılarını tüketirse, bu Görev hiçbir zaman zamanlanamaz. İşin usesTaskDependencies değeri true olarak ayarlanmamışsa ve bu öğe mevcutsa istek TaskDependenciesNotSpecifiedOnJob hata koduyla başarısız olur.
displayName

string

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

EnvironmentSetting[]

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

ExitConditions

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

string

İş içindeki Görevi benzersiz olarak tanımlayan bir dize.
Kimlik, kısa çizgi ve alt çizgi gibi alfasayısal karakterlerin herhangi bir bileşimini içerebilir ve 64 karakterden fazla karakter içeremez. Kimlik büyük/küçük harf koruyucu ve büyük/küçük harfe duyarlı değildir (yani, bir İş içinde yalnızca büyük/küçük harfe göre farklılık gösteren iki kimliğiniz olmayabilir).
multiInstanceSettings

MultiInstanceSettings

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

OutputFile[]

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

integer

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

ResourceFile[]

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

UserIdentity

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

TaskAddResult

Görev koleksiyonu ekleme işleminin parçası olarak eklenen tek bir Görevin sonucu.

Name Tür Description
eTag

string

Görevin başarıyla eklenip eklenmediğini, Görevin ETag'i.
Görevin istekler arasında değişip değişmediğini algılamak için bunu kullanabilirsiniz. Özellikle, ETag'i güncelleştirme görevi isteğiyle geçirerek, değişikliklerinizin yalnızca bu sırada başka kimsenin İşi değiştirmemiş olması durumunda geçerli olacağını belirtebilirsiniz.
error

BatchError

Görevi eklemeye çalışırken karşılaşılan hata.
lastModified

string

Görevin son değiştirme zamanı.
location

string

Görev başarıyla eklendiyse Görevin URL'si.
status

TaskAddStatus

Görev ekleme isteğinin durumu.
taskId

string

Bunun sonucu olduğu Görevin Kimliği.

TaskAddStatus

Görev ekleme isteğinin durumu.

Name Tür Description
clienterror

string

Görev bir istemci hatası nedeniyle eklenemedi ve isteği uygun şekilde değiştirmeden yeniden denenmemelidir.
servererror

string

Sunucu hatası nedeniyle görev eklenemedi ve değişiklik yapılmadan yeniden denenebilir.
success

string

Görev başarıyla eklendi.

TaskConstraints

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

Name Tür Description
maxTaskRetryCount

integer

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

string

Görevin çalıştırabileceği, Görevin başladığı zamandan ölçülen en uzun süre. Görev zaman sınırı içinde tamamlanmazsa Batch hizmeti görevi sonlandırır.
Bu belirtilmezse, Görevin ne kadar süreyle çalışabileceğine ilişkin bir zaman sınırı yoktur.
retentionTime

string

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

TaskContainerSettings

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

Name Tür Description
containerHostBatchBindMounts

ContainerHostBatchBindMountEntry[]

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

string

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

string

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

ContainerRegistry

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

ContainerWorkingDirectory

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

TaskDependencies

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

Name Tür Description
taskIdRanges

TaskIdRange[]

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

string[]

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

TaskIdRange

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

Name Tür Description
end

integer

Aralıktaki son Görev Kimliği.
start

integer

Aralıktaki ilk Görev Kimliği.

UserIdentity

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

Name Tür Description
autoUser

AutoUserSpecification

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

string

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