Aracılığıyla paylaş


Nodes - List Nodes

Belirlenen Havuzda Hesaplama Düğümlerini listeler.

GET {endpoint}/pools/{poolId}/nodes?api-version=2025-06-01
GET {endpoint}/pools/{poolId}/nodes?api-version=2025-06-01&timeOut={timeOut}&maxresults={maxresults}&$filter={$filter}&$select={$select}

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

poolId
path True

string

Hesaplama düğümlerini listelemek istediğiniz havuzun kimliği.

api-version
query True

string

minLength: 1

Bu işlem için kullanılacak API sürümü.

$filter
query

string

OData $filter yan tümcesi. Bu filtrenin oluşturulması hakkında daha fazla bilgi için bkz.https://learn.microsoft.com/rest/api/batchservice/odata-filters-in-batch#list-nodes-in-a-pool

$select
query

string[]

OData $select yan tümcesi.

maxresults
query

integer (int32)

minimum: 1
maximum: 1000

Yanıtta döndürülecek en fazla öğe sayısı. En fazla 1000 başvuru iade edilebilir.

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.

Yanıtlar

Name Tür Description
200 OK

BatchNodeListResult

İstek başarılı oldu.

Üst Bilgiler

  • 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

Node list

Örnek isteği

GET {endpoint}/pools/poolId/nodes?api-version=2025-06-01


Örnek yanıt

{
  "value": [
    {
      "id": "tvm-1695681911_1-20161122t193202z",
      "url": "https://account.region.batch.azure.com/pools/poolId/nodes/tvm-1695681911_1-20161122t193202z",
      "state": "idle",
      "schedulingState": "enabled",
      "stateTransitionTime": "2025-11-22T22:22:27.2236818Z",
      "lastBootTime": "2025-11-22T22:22:24.4634125Z",
      "allocationTime": "2025-11-22T19:32:02.8155319Z",
      "ipAddress": "1.1.1.1",
      "ipv6Address": "1.1.1.1",
      "affinityId": "TVM:tvm-1695681911_1-20161122t193202z",
      "vmSize": "Standard_D2_v5",
      "totalTasksRun": 0,
      "totalTasksSucceeded": 0,
      "runningTasksCount": 0,
      "runningTaskSlotsCount": 0,
      "isDedicated": true,
      "startTask": {
        "commandLine": "cmd /c echo hello",
        "userIdentity": {
          "autoUser": {
            "scope": "task",
            "elevationLevel": "nonadmin"
          }
        },
        "maxTaskRetryCount": 0,
        "waitForSuccess": false
      },
      "virtualMachineInfo": {
        "imageReference": {
          "publisher": "Canonical",
          "offer": "ubuntu-24_04-lts",
          "sku": "server",
          "version": "latest",
          "exactVersion": "latest"
        }
      },
      "startTaskInfo": {
        "state": "completed",
        "startTime": "2025-11-22T22:22:27.2236818Z",
        "endTime": "2025-11-22T22:22:27.567189Z",
        "exitCode": 0,
        "retryCount": 0
      },
      "nodeAgentInfo": {
        "version": "1.2.0.0",
        "lastUpdateTime": "2025-11-22T22:22:24.4634125Z"
      }
    },
    {
      "id": "tvm-1695681911_2-20161122t193202z",
      "url": "https://account.region.batch.azure.com/pools/poolId/nodes/tvm-1695681911_2-20161122t193202z",
      "state": "idle",
      "schedulingState": "enabled",
      "stateTransitionTime": "2025-11-22T19:37:31.4285526Z",
      "lastBootTime": "2025-11-22T19:37:28.623369Z",
      "allocationTime": "2025-11-22T19:32:02.8155319Z",
      "ipAddress": "1.1.1.1",
      "ipv6Address": "1.1.1.1",
      "affinityId": "TVM:tvm-1695681911_2-20161122t193202z",
      "vmSize": "Standard_D2_v5",
      "totalTasksRun": 0,
      "totalTasksSucceeded": 0,
      "runningTasksCount": 0,
      "runningTaskSlotsCount": 0,
      "isDedicated": true,
      "startTask": {
        "commandLine": "cmd /c echo hello",
        "userIdentity": {
          "autoUser": {
            "scope": "task",
            "elevationLevel": "nonadmin"
          }
        },
        "maxTaskRetryCount": 0,
        "waitForSuccess": false
      },
      "virtualMachineInfo": {
        "imageReference": {
          "publisher": "Canonical",
          "offer": "ubuntu-24_04-lts",
          "sku": "server",
          "version": "latest",
          "exactVersion": "latest"
        }
      },
      "startTaskInfo": {
        "state": "completed",
        "startTime": "2025-11-22T19:37:31.4285526Z",
        "endTime": "2025-11-22T19:37:31.838028Z",
        "exitCode": 0,
        "retryCount": 0
      },
      "nodeAgentInfo": {
        "version": "1.2.0.0",
        "lastUpdateTime": "2025-11-22T22:22:24.4634125Z"
      }
    },
    {
      "id": "tvm-1695681911_3-20161122t193202z",
      "url": "https://account.region.batch.azure.com/pools/poolId/nodes/tvm-1695681911_3-20161122t193202z",
      "state": "idle",
      "schedulingState": "enabled",
      "stateTransitionTime": "2025-11-22T19:36:51.0013378Z",
      "lastBootTime": "2025-11-22T19:36:48.21721Z",
      "allocationTime": "2025-11-22T19:32:02.8155319Z",
      "ipAddress": "1.1.1.1",
      "ipv6Address": "1.1.1.1",
      "affinityId": "TVM:tvm-1695681911_3-20161122t193202z",
      "vmSize": "Standard_D2_v5",
      "totalTasksRun": 0,
      "totalTasksSucceeded": 0,
      "runningTasksCount": 0,
      "runningTaskSlotsCount": 0,
      "isDedicated": true,
      "startTask": {
        "commandLine": "cmd /c echo hello",
        "userIdentity": {
          "autoUser": {
            "scope": "task",
            "elevationLevel": "nonadmin"
          }
        },
        "maxTaskRetryCount": 0,
        "waitForSuccess": false
      },
      "virtualMachineInfo": {
        "imageReference": {
          "publisher": "Canonical",
          "offer": "ubuntu-24_04-lts",
          "sku": "server",
          "version": "latest",
          "exactVersion": "latest"
        }
      },
      "startTaskInfo": {
        "state": "completed",
        "startTime": "2025-11-22T19:36:51.0013378Z",
        "endTime": "2025-11-22T19:36:51.2363447Z",
        "exitCode": 0,
        "retryCount": 0
      },
      "nodeAgentInfo": {
        "version": "1.2.0.0",
        "lastUpdateTime": "2025-11-22T22:22:24.4634125Z"
      }
    }
  ]
}

Tanımlar

Name Description
AutoUserScope

AutoUserScope enumları

AutoUserSpecification

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

BatchErrorMessage

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

BatchErrorSourceCategory

BatchErrorSourceCategory enums

BatchNode

Batch hizmetinde bir İşlem Düğümü.

BatchNodeAgentInfo

Batch İşlem Düğümü aracısı, Havuzdaki her İşlem Düğümünde çalışan ve İşlem Düğümünde Batch özelliği sağlayan bir programdır.

BatchNodeEndpointConfiguration

İşlem Düğümü için uç nokta yapılandırması.

BatchNodeError

İşlem Düğümü tarafından karşılaşılan bir hata.

BatchNodeIdentityReference

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

BatchNodeListResult

Bir Havuzdaki İşlem Düğümlerini listelemenin sonucu.

BatchNodeState

BatchNodeState enums

BatchStartTask

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. Bazı durumlarda İşlem Düğümü yeniden başlatılmamış olsa bile StartTask yeniden çalıştırılabilir. Batch'in StartTask'ı yeniden çalıştırabilmesini engellediği için, ayrık işlem oluşturan veya StartTask çalışma dizininden hizmet yükleyen/başlatan StartTask'lerden kaçınmak için özel özen gösterilmelidir.

BatchStartTaskInfo

İşlem Düğümünde çalışan bir StartTask hakkında bilgi.

BatchStartTaskState

BatchStartTaskState enums

BatchTaskContainerExecutionInfo

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

BatchTaskContainerSettings

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

BatchTaskExecutionInfo

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

BatchTaskExecutionResult

BatchTaskExecutionResult enums

BatchTaskFailureInfo

Görev hatası hakkında bilgi.

BatchTaskInfo

İşlem Düğümünde çalışan bir Görev hakkında bilgi.

BatchTaskState

BatchTaskState enums

BatchVmImageReference

Azure Sanal Makineler Market Görüntüsüne veya Azure İşlem Galerisi Görüntüsüne başvuru. Azure Batch tarafından doğrulanan tüm Azure Market Görüntüsü başvurularının listesini almak için ' Desteklenen Görüntüleri Listele' işlemine bakın.

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

ElevationLevel

ElevationLevel enums

EnvironmentSetting

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

InboundEndpoint

İşlem Düğümündeki gelen uç nokta.

InboundEndpointProtocol

InboundEndpointProtocol enums

NameValuePair

Ad-değer çiftini temsil eder.

ResourceFile

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

SchedulingState

SchedulingState enums

UserIdentity

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

VirtualMachineInfo

Sanal makinenin geçerli durumu hakkında bilgi.

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.

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.

BatchNode

Batch hizmetinde bir İşlem Düğümü.

Name Tür Description
affinityId

string

Görevin bu İşlem Düğümünde zamanlanmış olmasını istemek için görev eklenirken geçirilebilen bir tanımlayıcı. 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.

allocationTime

string (date-time)

Bu İşlem Düğümünü Havuza ayırma zamanı. bu, İşlem Düğümü'nin başlangıçta ayrıldığı ve bir kez ayarlandığında değişmediği zamandır. İşlem Düğümü hizmet iyileştirilmiş veya önceden yüklenmiş olduğunda güncelleştirilmez.

endpointConfiguration

BatchNodeEndpointConfiguration

İşlem Düğümü için uç nokta yapılandırması.

errors

BatchNodeError[]

İşlem Düğümü tarafından şu anda karşılaşılan hataların listesi.

id

string

İşlem Düğümünün Kimliği. Havuza eklenen her İşlem Düğümüne benzersiz bir kimlik atanır. Bir İşlem Düğümü havuzdan her kaldırıldığında, tüm yerel dosyaları silinir ve kimlik geri alınır ve yeni İşlem Düğümleri için yeniden kullanılabilir.

ipAddress

string

Diğer Düğümlerin bu İşlem Düğümü ile iletişim kurmak için kullanabileceği IP adresi. Havuza eklenen her İşlem Düğümüne benzersiz bir IP adresi atanır. Bir İşlem Düğümü havuzdan her kaldırıldığında, tüm yerel dosyaları silinir ve IP adresi geri alınır ve yeni İşlem Düğümleri için yeniden kullanılabilir.

ipv6Address

string

Diğer Düğümlerin bu Hesaplama Düğümü ile iletişim kurmak için kullanabileceği IPv6 adresi. Havuza eklenen her İşlem Düğümüne benzersiz bir IP adresi atanır. Bir İşlem Düğümü havuzdan her kaldırıldığında, tüm yerel dosyaları silinir ve IP adresi geri alınır ve yeni İşlem Düğümleri için yeniden kullanılabilir. Havuz IPv6 için yapılandırılmamışsa bu özellik mevcut olmayacaktır.

isDedicated

boolean

Bu İşlem Düğümünü ayrılmış bir İşlem Düğümü olup olmadığı. False ise, İşlem Düğümü spot/düşük öncelikli bir İşlem Düğümüdür.

lastBootTime

string (date-time)

İşlem Düğümü'nin en son başlatıldığı zaman. İşlem Düğümü durumu kullanılamıyorsa bu özellik mevcut olmayabilir.

nodeAgentInfo

BatchNodeAgentInfo

İşlem Düğümü aracı sürümü ve İşlem Düğümünü yeni bir sürüme yükseltme zamanı hakkında bilgi.

recentTasks

BatchTaskInfo[]

Durumu yakın zamanda değiştirilen Görevlerin listesi. Bu özellik yalnızca havuza atandığından bu İşlem Düğümünde en az bir Görev çalıştırıldığında bulunur.

runningTaskSlotsCount

integer (int32)

İşlem Düğümünde çalışmakta olan İş Görevleri tarafından kullanılan zamanlama yuvalarının toplam sayısı. Buna İş Yöneticisi Görevleri ve normal Görevler dahildir, ancak İş Hazırlama, İş Sürümü veya Başlangıç Görevleri dahil değildir.

runningTasksCount

integer (int32)

İşlem Düğümünde çalışmakta olan İş Görevlerinin toplam sayısı. Buna İş Yöneticisi Görevleri ve normal Görevler dahildir, ancak İş Hazırlama, İş Sürümü veya Başlangıç Görevleri dahil değildir.

schedulingState

SchedulingState

İşlem Düğümünü Görev zamanlaması için kullanılabilir olup olmadığı.

startTask

BatchStartTask

İşlem Düğümünde havuza katıldığında çalıştırılacak görev belirtildi.

startTaskInfo

BatchStartTaskInfo

İşlem Düğümünde StartTask'ın yürütülmesiyle ilgili çalışma zamanı bilgileri.

state

BatchNodeState

İşlem Düğümünün geçerli durumu.

stateTransitionTime

string (date-time)

İşlem Düğümünü geçerli durumuna girme zamanı.

totalTasksRun

integer (int32)

İşlem Düğümünde tamamlanan toplam İş Görevleri sayısı. Buna İş Yöneticisi Görevleri ve normal Görevler dahildir, ancak İş Hazırlama, İş Sürümü veya Başlangıç Görevleri dahil değildir.

totalTasksSucceeded

integer (int32)

İşlem Düğümünde başarıyla tamamlanan (exitCode 0 ile) toplam İş Görevleri sayısı. Buna İş Yöneticisi Görevleri ve normal Görevler dahildir, ancak İş Hazırlama, İş Sürümü veya Başlangıç Görevleri dahil değildir.

url

string (uri)

İşlem Düğümünün URL'si.

virtualMachineInfo

VirtualMachineInfo

Sanal makinenin geçerli durumu hakkında bilgi.

vmSize

string

İşlem Düğümünü barındıran sanal makinenin boyutu. Havuzlardaki sanal makinelerin kullanılabilir boyutları hakkında bilgi için bkzhttps://learn.microsoft.com/azure/batch/batch-pool-vm-sizes.

BatchNodeAgentInfo

Batch İşlem Düğümü aracısı, Havuzdaki her İşlem Düğümünde çalışan ve İşlem Düğümünde Batch özelliği sağlayan bir programdır.

Name Tür Description
lastUpdateTime

string (date-time)

Compute Node ajanının Compute Node'da güncellendiği zaman. Compute Node ajanının en son yeni sürüme güncellendiği zamandır.

version

string

Compute Node üzerinde çalışan Batch Compute Node ajanının versiyonu. Bu sürüm numarası, Compute Node ajanı sürüm notlarıyla kontrol edilebilir https://github.com/Azure/Batch/blob/master/changelogs/nodeagent/CHANGELOG.md.

BatchNodeEndpointConfiguration

İşlem Düğümü için uç nokta yapılandırması.

Name Tür Description
inboundEndpoints

InboundEndpoint[]

Compute Node'da erişilebilen gelen uç noktaların listesi.

BatchNodeError

İşlem Düğümü tarafından karşılaşılan bir hata.

Name Tür Description
code

string

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

errorDetails

NameValuePair[]

Compute Node hatasıyla ilgili ek hata detaylarının listesi.

message

string

Hesaplama düğümü hatasını tanımlayan bir mesaj, kullanıcı arayüzünde görüntülenmeye uygun olması amaçlanmış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.

BatchNodeListResult

Bir Havuzdaki İşlem Düğümlerini listelemenin sonucu.

Name Tür Description
odata.nextLink

string (uri)

Bir sonraki sonuç kümesini almak için URL.

value

BatchNode[]

Hesaplama düğümleri listesi.

BatchNodeState

BatchNodeState enums

Değer Description
idle

Compute Node şu anda bir Görev çalıştırmıyor.

rebooting

Compute Node yeniden başlatılıyor.

reimaging

Compute Node yeniden imgeliyor.

running

Compute Node, bir veya daha fazla Görev çalıştırıyor (StartTask hariç).

unusable

Hesaplama düğümü, hatalar nedeniyle görev yürütme için kullanılamaz.

creating

Batch servisi, Azure Compute'dan altta yatan sanal makineyi elde etti, ancak henüz Havuz'a katılmaya başlamadı.

starting

Batch servisi, altta yatan sanal makinede başlıyor.

waitingforstarttask

StartTask Compute Node'da çalışmaya başladı, ancak waitForSuccess ayarlandı ve StartTask henüz tamamlanmadı.

starttaskfailed

StartTask Compute Node'da başarısız oldu (ve tüm denemeleri tüketti), waitForSuccess ayarlandı. Compute Node, Görevleri çalıştırmak için kullanılamaz.

unknown

Batch servisi, Compute Node ile iletişimi kaybetti ve gerçek durumunu bilmiyor.

leavingpool

Compute Node, ya kullanıcının Havuzu açıkça kaldırdığı için ya da Havuzun boyut değiştirdiği veya otomatik ölçeklendirildiği için Havuz'dan ayrılıyor.

offline

Compute Node şu anda bir Görev çalıştırmıyor ve yeni Görevlerin Hesaplama Düğümü'ne planlanması devre dışı bırakılmıştır.

preempted

Spot/Düşük öncelikli İşlem Düğümü ön plana alındı. İşlem Düğümü önceden başlatıldığında çalışan görevler, başka bir İşlem Düğümü kullanılabilir olduğunda yeniden zamanlanır.

upgradingos

Compute Node, bir işletim sistemi yükseltme operasyonundan geçmektedir.

deallocated

Compute Node serbest ayrılmıştır.

deallocating

Compute Node açılıyor.

BatchStartTask

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. Bazı durumlarda İşlem Düğümü yeniden başlatılmamış olsa bile StartTask yeniden çalıştırılabilir. Batch'in StartTask'ı yeniden çalıştırabilmesini engellediği için, ayrık işlem oluşturan veya StartTask çalışma dizininden hizmet yükleyen/başlatan StartTask'lerden kaçınmak için özel özen gösterilmelidir.

Name Tür Description
commandLine

string

StartTask komut satı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.

containerSettings

BatchTaskContainerSettings

StartTask'ın çalıştığı konteyner ayarları. 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.

environmentSettings

EnvironmentSetting[]

StartTask için ortam değişkeni ayarlarının listesi.

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

resourceFiles

ResourceFile[]

Komut satırını çalıştırmadan önce Batch hizmetinin İşlem Düğümüne indireceği dosyaların listesi. 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. Bu öğe altında listelenen dosyalar Görevin çalışma dizininde bulunur.

userIdentity

UserIdentity

StartTask'ın ç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.

waitForSuccess

boolean

Batch hizmetinin İşlem Düğümünde herhangi bir Görevi zamanlamadan önce StartTask'ın başarıyla tamamlanmasını (yani çıkış kodu 0 ile çıkmak için) beklemesi gerekip gerekmediği. True ise ve StartTask bir Node'da başarısız olursa, Batch hizmeti StartTask'ı en yüksek yeniden deneme sayısına (maxTaskRetryCount) kadar yeniden dener. Tüm yeniden denemelerden sonra Görev yine de başarıyla tamamlanmamışsa, Batch hizmeti Düğümü kullanılamaz olarak işaretler ve görev zamanlaması yapılmaz. Bu koşul İşlem Düğümü durumu ve hata bilgileri ayrıntıları aracılığıyla algılanabilir. False ise, Batch hizmeti StartTask'ın tamamlanmasını beklemez. Bu durumda, StartTask çalışmaya devam ederken diğer Görevler İşlem Düğümü'nde yürütülmeye başlayabilir; ve StartTask başarısız olsa bile, yeni Görevler İşlem Düğümünde zamanlamaya devam eder. Varsayılan değer true'dur.

BatchStartTaskInfo

İşlem Düğümünde çalışan bir StartTask hakkında bilgi.

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)

StartTask'ın çalışmayı durdurduğu zaman. Bu, StartTask'ın en son çalışmasının bitiş zamanıdır, eğer o çalışma tamamlandıysa (o koşu başarısız olsa ve tekrar deneme bekleyecek olsa bile). StartTask şu anda çalışıyorsa bu eleman yoktur.

exitCode

integer (int32)

StartTask komut satırında belirtilen programın çıkış kodu. Bu özellik yalnızca StartTask 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 StartTask'ı 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.

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.

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)

StartTask'ın çalışmaya başladığı zaman. Bu değer, Görev yeniden başlatıldığında veya tekrar denendiğinde (yani StartTask'ın en son çalışmaya başladığı zamandır) her sıfırlanır.

state

BatchStartTaskState

Compute Node'daki StartTask'ın durumu.

BatchStartTaskState

BatchStartTaskState enums

Değer Description
running

StartTask şu anda çalışıyor.

completed

StartTask çıkış kodu 0 ile çıktı, ya da StartTask başarısız oldu ve tekrar deneme sınırı ulaştı, ya da StartTask süreci Görev hazırlama hataları (örneğin kaynak dosyası indirme hataları) nedeniyle çalışmadı.

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.

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.

BatchTaskInfo

İşlem Düğümünde çalışan bir Görev hakkında bilgi.

Name Tür Description
executionInfo

BatchTaskExecutionInfo

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

jobId

string

Görevin ait olduğu İşin kimliği.

subtaskId

integer (int32)

Görev çok örnekli bir Görev ise, alt görevin ID'si.

taskId

string

Görevin kimliği.

taskState

BatchTaskState

Görevin mevcut durumu.

taskUrl

string (uri)

Görevin URL'si.

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.

BatchVmImageReference

Azure Sanal Makineler Market Görüntüsüne veya Azure İşlem Galerisi Görüntüsüne başvuru. Azure Batch tarafından doğrulanan tüm Azure Market Görüntüsü başvurularının listesini almak için ' Desteklenen Görüntüleri Listele' işlemine bakın.

Name Tür Description
communityGalleryImageId

string

Topluluk galerisi görseli benzersiz tanımlayıcı. Bu özellik diğer özelliklerle birbirini dışlar ve topluluk galerisi görüntüsü GET çağrısından getirilebilir.

exactVersion

string

Düğümü oluşturmak için kullanılan platform görselinin veya pazar yeri görgesinin özel versiyonu. Bu yalnızca okunabilir alan, havuz oluşturulduğunda 'sürüm' için belirtilen değer 'verim' ise 'sürüm'den farklıdır.

offer

string

Azure Virtual Machines Marketplace Image'in teklif türü. Örneğin, UbuntuServer veya WindowsServer.

publisher

string

Azure Virtual Machines Marketplace Image'in yayıncısı. Örneğin, Canonical veya MicrosoftWindowsServer.

sharedGalleryImageId

string

Paylaşılan galeri görseli benzersiz tanımlayıcı. Bu özellik diğer özelliklerle birbirini dışlar ve paylaşılan galeri görüntüsü GET çağrısından getirilebilir.

sku

string

Azure Virtual Machines Marketplace Image'in SKU'su. Örneğin, 18.04-LTS veya 2019-Datacenter.

version

string

Azure Virtual Machines Marketplace Image'in versiyonu. Bir Görselin en son sürümünü seçmek için 'en son' değeri belirtilebilir. Atlanırsa, varsayılan değer 'en son' olur.

virtualMachineImageId

string (arm-id)

Azure İşlem Galerisi Görüntüsünün ARM kaynak tanımlayıcısı. Havuzdaki hesaplama düğümleri bu Görsel Kimliği kullanılarak oluşturulacaktır. Bu, /subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Compute/galleries/{galleryName}/images/{imageDefinitionName}/versions/{VersionId} veya /subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Compute/galleries/{galleryName}/images/{imageDefinitionName} biçimindedir ve her zaman en son resim sürümüne geçebilirsiniz. Bu özellik, diğer ImageReference özellikleriyle birbirini dışlar. Azure Compute Gallery Image'in aynı bölgede replikaları olmalı ve Azure Batch hesabıyla aynı abonelikte olması gerekir. Eğer imageId'de görüntü sürümü belirtilmemişse, en son sürüm kullanılır. Batch Compute Node ajanının Batch servisiyle iletişim kurması için güvenlik duvarı ayarları hakkında bilgi için bkz.https://learn.microsoft.com/azure/batch/nodes-and-pools#virtual-network-vnet-and-firewall-configuration

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.

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.

InboundEndpoint

İşlem Düğümündeki gelen uç nokta.

Name Tür Description
backendPort

integer (int32)

Uç noktanın arka uç port numarası.

frontendPort

integer (int32)

Uç noktanın genel port numarası.

name

string

Uç noktanın adı.

protocol

InboundEndpointProtocol

Uç noktanın protokolü.

publicFQDN

string

Compute Node için kamuya açık tam nitelikli alan adı.

publicIPAddress

string

Compute Node'un genel IP adresi.

InboundEndpointProtocol

InboundEndpointProtocol enums

Değer Description
tcp

Uç nokta için TCP kullanın.

udp

Uç nokta için UDP kullanın.

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.

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.

SchedulingState

SchedulingState enums

Değer Description
enabled

Görevler Compute Node üzerinden planlanabilir.

disabled

Compute Node'da yeni Görevler planlanmaz. Compute Node'da zaten çalışan görevler yine de tamamlanana kadar çalışabilir. Tüm Hesaplama Düğümleri zamanlama etkin olarak başlar.

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.

VirtualMachineInfo

Sanal makinenin geçerli durumu hakkında bilgi.

Name Tür Description
imageReference

BatchVmImageReference

Azure Virtual Machine'in Marketplace Image'ine referans.

scaleSetVmResourceId

string

Compute Node'un mevcut Sanal Makine Ölçek Seti VM'nin kaynak kimliği. Sadece Toplu Hesap havuzu AllocationMode özelliği 'UserSubscription' olarak ayarlanmışsa tanımlanmıştır.