Pool - Add

Dodaje pulę do określonego konta.
Podczas nazewnictwa pul należy unikać dołączania poufnych informacji, takich jak nazwy użytkowników lub nazwy tajnych projektów. Te informacje mogą być wyświetlane w dziennikach telemetrii dostępnych dla inżynierów pomoc techniczna firmy Microsoft.

POST {batchUrl}/pools?api-version=2023-11-01.18.0
POST {batchUrl}/pools?timeout={timeout}&api-version=2023-11-01.18.0

Parametry identyfikatora URI

Nazwa W Wymagane Typ Opis
batchUrl
path True

string

Podstawowy adres URL dla wszystkich żądań obsługi Azure Batch.

api-version
query True

string

Wersja interfejsu API klienta.

timeout
query

integer

int32

Maksymalny czas przetwarzania żądania przez serwer w sekundach. Wartość domyślna to 30 sekund.

Nagłówek żądania

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

Nazwa Wymagane Typ Opis
client-request-id

string

uuid

Tożsamość żądania wygenerowanego przez obiekt wywołujący w postaci identyfikatora GUID bez dekoracji, takich jak nawiasy klamrowe, np. 9C4D50EE-2D56-4CD3-8152-34347DC9F2B0.

return-client-request-id

boolean

Określa, czy serwer powinien zwrócić wartość client-request-id w odpowiedzi.

ocp-date

string

date-time-rfc1123

Czas wystawienia żądania. Biblioteki klienckie zazwyczaj ustawiają tę wartość na bieżący czas zegara systemowego; ustaw go jawnie, jeśli bezpośrednio wywołujesz interfejs API REST.

Treść żądania

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

Nazwa Wymagane Typ Opis
id True

string

Ciąg, który jednoznacznie identyfikuje pulę w ramach konta.
Identyfikator może zawierać dowolną kombinację znaków alfanumerycznych, w tym łączników i podkreśleń, i nie może zawierać więcej niż 64 znaków. Identyfikator jest zachowywany przy użyciu wielkości liter i bez uwzględniania wielkości liter (oznacza to, że w ramach konta nie ma dwóch identyfikatorów puli, które różnią się tylko wielkością liter).

vmSize True

string

Rozmiar maszyn wirtualnych w puli. Wszystkie maszyny wirtualne w puli mają ten sam rozmiar.
Aby uzyskać informacje o dostępnych rozmiarach maszyn wirtualnych dla pul Cloud Services (pul utworzonych za pomocą funkcji cloudServiceConfiguration), zobacz Rozmiary dla Cloud Services (https://azure.microsoft.com/documentation/articles/cloud-services-sizes-specs/). Usługa Batch obsługuje wszystkie rozmiary maszyn wirtualnych Cloud Services z wyjątkiem ExtraSmall, A1V2 i A2V2. Aby uzyskać informacje o dostępnych rozmiarach maszyn wirtualnych dla pul przy użyciu obrazów z witryny Virtual Machines Marketplace (pule utworzone za pomocą polecenia virtualMachineConfiguration), zobacz Rozmiary dla Virtual Machines (Linux) () lubhttps://azure.microsoft.com/documentation/articles/virtual-machines-linux-sizes/ Rozmiary dla Virtual Machines (Windows) (https://azure.microsoft.com/documentation/articles/virtual-machines-windows-sizes/). Usługa Batch obsługuje wszystkie rozmiary maszyn wirtualnych platformy Azure z wyjątkiem STANDARD_A0 i tych z magazynem w warstwie Premium (STANDARD_GS, STANDARD_DS i serii STANDARD_DSV2).

applicationLicenses

string[]

Lista licencji aplikacji udostępnianych przez usługę Batch w każdym węźle obliczeniowym w puli.
Lista licencji aplikacji musi być podzbiorem dostępnych licencji aplikacji usługi Batch. Jeśli zażądano licencji, która nie jest obsługiwana, tworzenie puli zakończy się niepowodzeniem.

applicationPackageReferences

ApplicationPackageReference[]

Lista pakietów do zainstalowania w każdym węźle obliczeniowym w puli.
Podczas tworzenia puli identyfikator aplikacji pakietu musi być w pełni kwalifikowany (/subscriptions/{subscriptionId}/resourceGroups/{resourceGroups}/providers/Microsoft.Batch/batchAccounts/{accountName}/applications/{applicationName}). Zmiany odwołań do pakietu mają wpływ na wszystkie nowe węzły łączące pulę, ale nie mają wpływu na węzły obliczeniowe, które znajdują się już w puli, dopóki nie zostaną ponownie uruchomione lub ponownie z obrazu. W dowolnej puli istnieje maksymalnie 10 odwołań do pakietu.

autoScaleEvaluationInterval

string

Interwał czasu, w którym ma być automatycznie dostosowywany rozmiar puli zgodnie z formułą autoskalowania.
Wartość domyślna to 15 minut. Minimalna i maksymalna wartość to odpowiednio 5 minut i 168 godzin. Jeśli określisz wartość mniejszą niż 5 minut lub większą niż 168 godzin, usługa Batch zwróci błąd; Jeśli bezpośrednio wywołujesz interfejs API REST, kod stanu HTTP to 400 (Nieprawidłowe żądanie).

autoScaleFormula

string

Formuła dla żądanej liczby węzłów obliczeniowych w puli.
Nie można określić tej właściwości, jeśli właściwość enableAutoScale jest ustawiona na wartość false. Jest to wymagane, jeśli parametr enableAutoScale jest ustawiony na wartość true. Formuła jest sprawdzana pod kątem ważności przed utworzeniem puli. Jeśli formuła jest nieprawidłowa, usługa Batch odrzuca żądanie ze szczegółowymi informacjami o błędzie. Aby uzyskać więcej informacji na temat określania tej formuły, zobacz "Automatyczne skalowanie węzłów obliczeniowych w puli Azure Batch" (https://azure.microsoft.com/documentation/articles/batch-automatic-scaling/).

certificateReferences

CertificateReference[]

Lista certyfikatów do zainstalowania w każdym węźle obliczeniowym w puli.
W przypadku węzłów systemu Windows usługa Batch instaluje certyfikaty w określonym magazynie certyfikatów i lokalizacji. W przypadku węzłów obliczeniowych systemu Linux certyfikaty są przechowywane w katalogu roboczym Zadania, a zmienna środowiskowa AZ_BATCH_CERTIFICATES_DIR jest dostarczana do zadania w celu wykonania zapytania o tę lokalizację. W przypadku certyfikatów z widocznością "remoteUser" katalog "certs" jest tworzony w katalogu głównym użytkownika (np. /home/{user-name}/certs) i Certyfikaty są umieszczane w tym katalogu.

Ostrzeżenie: Ta właściwość jest przestarzała i zostanie usunięta po lutym 2024 r. Zamiast tego użyj rozszerzenia Azure KeyVault .

cloudServiceConfiguration

CloudServiceConfiguration

Konfiguracja usługi w chmurze dla puli.
Ta właściwość i element virtualMachineConfiguration wykluczają się wzajemnie i należy określić jedną z właściwości. Nie można określić tej właściwości, jeśli konto usługi Batch zostało utworzone z właściwością poolAllocationMode ustawioną na wartość "UserSubscription".

displayName

string

Nazwa wyświetlana puli.
Nazwa wyświetlana nie musi być unikatowa i może zawierać znaki Unicode o maksymalnej długości 1024.

enableAutoScale

boolean

Określa, czy rozmiar puli powinien być automatycznie dostosowywany w miarę upływu czasu.
Jeśli wartość false, należy określić co najmniej jeden z elementów targetDedicatedNodes i targetLowPriorityNodes. Jeśli wartość true, właściwość autoScaleFormula jest wymagana, a rozmiar puli jest automatycznie zmieniany zgodnie z formułą. Wartość domyślna to false.

enableInterNodeCommunication

boolean

Określa, czy pula zezwala na bezpośrednią komunikację między węzłami obliczeniowymi.
Włączenie komunikacji między węzłami ogranicza maksymalny rozmiar puli z powodu ograniczeń wdrażania w węzłach obliczeniowych puli. Może to spowodować, że pula nie osiągnie żądanego rozmiaru. Wartość domyślna to false.

metadata

MetadataItem[]

Lista par nazwa-wartość skojarzona z pulą jako metadanymi.
Usługa Batch nie przypisuje żadnego znaczenia do metadanych; jest on przeznaczony wyłącznie do korzystania z kodu użytkownika.

mountConfiguration

MountConfiguration[]

Zainstaluj magazyn przy użyciu określonego systemu plików przez cały okres istnienia puli.
Zainstaluj magazyn przy użyciu udziału plików platformy Azure, systemu plików NFS, CIFS lub Blobfuse opartego na systemie plików.

networkConfiguration

NetworkConfiguration

Konfiguracja sieci dla puli.
Konfiguracja sieci dla puli.

resizeTimeout

string

Limit czasu alokacji węzłów obliczeniowych do puli.
Ten limit czasu dotyczy tylko skalowania ręcznego; nie ma żadnego efektu, gdy właściwość enableAutoScale jest ustawiona na wartość true. Wartość domyślna to 15 minut. Wartość minimalna to 5 minut. Jeśli określisz wartość mniejszą niż 5 minut, usługa Batch zwróci błąd; Jeśli bezpośrednio wywołujesz interfejs API REST, kod stanu HTTP to 400 (Nieprawidłowe żądanie).

resourceTags

object

Tagi określone przez użytkownika skojarzone z pulą.
Tagi zdefiniowane przez użytkownika do skojarzenia z pulą Azure Batch. Po określeniu te tagi są propagowane do zasobów platformy Azure skojarzonych z pulą. Tę właściwość można określić tylko wtedy, gdy konto usługi Batch zostało utworzone za pomocą właściwości poolAllocationMode ustawionej na wartość "UserSubscription".

startTask

StartTask

Zadanie określone do uruchomienia w każdym węźle obliczeniowym podczas dołączania do puli.
Zadanie jest uruchamiane po dodaniu węzła obliczeniowego do puli lub ponownym uruchomieniu węzła obliczeniowego.

targetDedicatedNodes

integer

Żądana liczba dedykowanych węzłów obliczeniowych w puli.
Nie można określić tej właściwości, jeśli właściwość enableAutoScale jest ustawiona na wartość true. Jeśli parametr enableAutoScale ma wartość false, musisz ustawić wartość targetDedicatedNodes, targetLowPriorityNodes lub oba te węzły.

targetLowPriorityNodes

integer

Żądana liczba węzłów obliczeniowych typu spot/low-priority w puli.
Nie można określić tej właściwości, jeśli właściwość enableAutoScale jest ustawiona na wartość true. Jeśli parametr enableAutoScale ma wartość false, musisz ustawić wartość targetDedicatedNodes, targetLowPriorityNodes lub oba te węzły.

targetNodeCommunicationMode

NodeCommunicationMode

Żądany tryb komunikacji węzła dla puli.
Jeśli pominięto, wartością domyślną jest Wartość domyślna.

taskSchedulingPolicy

TaskSchedulingPolicy

Jak zadania są dystrybuowane między węzłami obliczeniowymi w puli.
Jeśli nie zostanie określony, wartość domyślna zostanie rozłożona.

taskSlotsPerNode

integer

Liczba miejsc zadań, których można użyć do uruchamiania współbieżnych zadań w jednym węźle obliczeniowym w puli.
Wartość domyślna to 1. Wartość maksymalna jest mniejsza niż 4 razy mniejsza niż liczba rdzeni vmSize puli lub 256.

userAccounts

UserAccount[]

Lista kont użytkowników do utworzenia w każdym węźle obliczeniowym w puli.

virtualMachineConfiguration

VirtualMachineConfiguration

Konfiguracja maszyny wirtualnej dla puli.
Ta właściwość i właściwość cloudServiceConfiguration wzajemnie się wykluczają i należy określić jedną z właściwości.

Odpowiedzi

Nazwa Typ Opis
201 Created

Żądanie do usługi Batch zakończyło się pomyślnie.

Headers

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

BatchError

Błąd usługi Batch.

Zabezpieczenia

azure_auth

przepływ kodu uwierzytelniania OAuth 2.0 Microsoft Entra

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Nazwa Opis
user_impersonation Personifikuj konto użytkownika

Authorization

Type: apiKey
In: header

Przykłady

Add a CloudServiceConfiguration pool
Add a pool with accelerated networking
Add a pool with mount drive specified
Add a pool with SecurityProfile
Add a simple pool with resourceTags
Add a VirtualMachineConfiguration pool
Add a VirtualMachineConfiguration pool with containers
Add a VirtualMachineConfiguration pool with extensions
Add a VirtualMachineConfiguration pool with OS disk
Add a VirtualMachineConfiguration pool with ServiceArtifactReference

Add a CloudServiceConfiguration pool

Sample Request

POST account.region.batch.azure.com/pools?api-version=2023-11-01.18.0



{
  "id": "poolId",
  "vmSize": "small",
  "cloudServiceConfiguration": {
    "osFamily": "4"
  },
  "resizeTimeout": "PT15M",
  "targetDedicatedNodes": 5,
  "targetLowPriorityNodes": 0,
  "taskSlotsPerNode": 3,
  "taskSchedulingPolicy": {
    "nodeFillType": "spread"
  },
  "enableAutoScale": false,
  "enableInterNodeCommunication": true,
  "metadata": [
    {
      "name": "myproperty",
      "value": "myvalue"
    }
  ]
}

Sample Response

Add a pool with accelerated networking

Sample Request

POST account.region.batch.azure.com/pools?api-version=2023-11-01.18.0



{
  "id": "mypool01",
  "vmSize": "Standard_D1_v2",
  "virtualMachineConfiguration": {
    "imageReference": {
      "publisher": "MicrosoftWindowsServer",
      "offer": "WindowsServer",
      "sku": "2016-datacenter-smalldisk",
      "version": "latest"
    },
    "nodeAgentSKUId": "batch.node.windows amd64"
  },
  "targetDedicatedNodes": 2,
  "networkConfiguration": {
    "enableAcceleratedNetworking": true
  }
}

Sample Response

Add a pool with mount drive specified

Sample Request

POST account.region.batch.azure.com/pools?api-version=2023-11-01.18.0


{
  "id": "pool2",
  "vmSize": "standard_a1",
  "virtualMachineConfiguration": {
    "imageReference": {
      "publisher": "Canonical",
      "offer": "UbuntuServer",
      "sku": "20_04-lts"
    },
    "nodeAgentSKUId": "batch.node.ubuntu 20.04"
  },
  "mountConfiguration": [
    {
      "azureBlobFileSystemConfiguration": {
        "accountName": "accountName",
        "containerName": "blobContainerName",
        "accountKey": "accountKey",
        "relativeMountPath": "bfusepath"
      }
    },
    {
      "azureFileShareConfiguration": {
        "accountName": "accountName",
        "azureFileUrl": "https://myaccount.file.core.windows.net/fileshare",
        "accountKey": "accountKey",
        "relativeMountPath": "filesharepath",
        "mountOptions": "mount options ver=1.0"
      }
    },
    {
      "nfsMountConfiguration": {
        "source": "somesource nfs url",
        "relativeMountPath": "mountpath",
        "mountOptions": "mount options ver=1.0"
      }
    },
    {
      "cifsMountConfiguration": {
        "username": "accountName",
        "password": "password",
        "source": "//myaccount.file.core.windows.net/file",
        "relativeMountPath": "mountpath",
        "mountOptions": "mount options ver=1.0"
      }
    }
  ],
  "resizeTimeout": "PT15M",
  "targetDedicatedNodes": 5,
  "targetLowPriorityNodes": 0,
  "taskSlotsPerNode": 3,
  "taskSchedulingPolicy": {
    "nodeFillType": "spread"
  },
  "enableAutoScale": false
}

Sample Response

Add a pool with SecurityProfile

Sample Request

POST account.region.batch.azure.com/pools?api-version=2023-11-01.18.0



{
  "id": "mypool001",
  "vmSize": "STANDARD_DC2s_V2",
  "virtualMachineConfiguration": {
    "imageReference": {
      "publisher": "Canonical",
      "offer": "UbuntuServer",
      "sku": "18_04-lts-gen2",
      "version": "latest"
    },
    "nodeAgentSKUId": "batch.node.ubuntu 18.04",
    "securityProfile": {
      "securityType": "trustedLaunch",
      "encryptionAtHost": true,
      "uefiSettings": {
        "secureBootEnabled": false
      }
    }
  },
  "targetDedicatedNodes": 1
}

Sample Response

Add a simple pool with resourceTags

Sample Request

POST account.region.batch.azure.com/pools?api-version=2023-11-01.18.0



{
  "id": "mypool001",
  "vmSize": "STANDARD_DC2s_V2",
  "virtualMachineConfiguration": {
    "imageReference": {
      "publisher": "Canonical",
      "offer": "UbuntuServer",
      "sku": "18_04-lts-gen2",
      "version": "latest"
    },
    "nodeAgentSKUId": "batch.node.ubuntu 18.04"
  },
  "targetDedicatedNodes": 1,
  "resourceTags": {
    "TagName1": "TagValue1",
    "TagName2": "TagValue2"
  }
}

Sample Response

Add a VirtualMachineConfiguration pool

Sample Request

POST account.region.batch.azure.com/pools?api-version=2023-11-01.18.0



{
  "id": "pool2",
  "vmSize": "standard_a1",
  "virtualMachineConfiguration": {
    "imageReference": {
      "publisher": "Canonical",
      "offer": "0001-com-ubuntu-server-focal",
      "sku": "20_04-lts"
    },
    "nodeAgentSKUId": "batch.node.ubuntu 20.04"
  },
  "resizeTimeout": "PT15M",
  "targetDedicatedNodes": 5,
  "targetLowPriorityNodes": 0,
  "taskSlotsPerNode": 3,
  "taskSchedulingPolicy": {
    "nodeFillType": "spread"
  },
  "enableAutoScale": false,
  "enableInterNodeCommunication": true,
  "metadata": [
    {
      "name": "myproperty",
      "value": "myvalue"
    }
  ]
}

Sample Response

Add a VirtualMachineConfiguration pool with containers

Sample Request

POST account.region.batch.azure.com/pools?api-version=2023-11-01.18.0



{
  "id": "pool2",
  "vmSize": "standard_a1",
  "virtualMachineConfiguration": {
    "imageReference": {
      "publisher": "Canonical",
      "offer": "0001-com-ubuntu-server-focal",
      "sku": "120_04-lts"
    },
    "nodeAgentSKUId": "batch.node.ubuntu 20.04",
    "containerConfiguration": {
      "type": "dockerCompatible",
      "containerImageNames": [
        "busybox"
      ]
    }
  },
  "resizeTimeout": "PT15M",
  "targetDedicatedNodes": 5,
  "targetLowPriorityNodes": 0,
  "taskSlotsPerNode": 3,
  "taskSchedulingPolicy": {
    "nodeFillType": "spread"
  },
  "enableAutoScale": false
}

Sample Response

Add a VirtualMachineConfiguration pool with extensions

Sample Request

POST account.region.batch.azure.com/pools?api-version=2023-11-01.18.0



{
  "id": "pool2",
  "vmSize": "standard_a1",
  "virtualMachineConfiguration": {
    "imageReference": {
      "publisher": "Canonical",
      "offer": "0001-com-ubuntu-server-focal",
      "sku": "20_04-lts"
    },
    "nodeAgentSKUId": "batch.node.ubuntu 20.04",
    "extensions": [
      {
        "name": "batchextension1",
        "type": "KeyVaultForLinux",
        "publisher": "Microsoft.Azure.KeyVault",
        "typeHandlerVersion": "2.0",
        "autoUpgradeMinorVersion": true,
        "enableAutomaticUpgrade": true,
        "settings": "{\"secretsManagementSettingsKey\":\"secretsManagementSettingsValue\",\"authenticationSettingsKey\":\"authenticationSettingsValue\"}"
      }
    ]
  },
  "resizeTimeout": "PT15M",
  "targetDedicatedNodes": 5,
  "targetLowPriorityNodes": 0,
  "taskSlotsPerNode": 3,
  "taskSchedulingPolicy": {
    "nodeFillType": "spread"
  },
  "enableAutoScale": false,
  "enableInterNodeCommunication": true,
  "metadata": [
    {
      "name": "myproperty",
      "value": "myvalue"
    }
  ],
  "targetNodeCommunicationMode": "simplified"
}

Sample Response

Add a VirtualMachineConfiguration pool with OS disk

Sample Request

POST account.region.batch.azure.com/pools?api-version=2023-11-01.18.0



{
  "id": "mypool001",
  "vmSize": "standard_d2s_v3",
  "virtualMachineConfiguration": {
    "imageReference": {
      "publisher": "Canonical",
      "offer": "0001-com-ubuntu-server-focal",
      "sku": "20_04-lts"
    },
    "osDisk": {
      "diskSizeGB": 100,
      "managedDisk": {
        "storageAccountType": "standardssd_lrs"
      },
      "caching": "readwrite",
      "ephemeralOSDiskSettings": {
        "placement": "CacheDisk"
      }
    },
    "nodeAgentSKUId": "batch.node.ubuntu 20.04"
  },
  "resizeTimeout": "PT15M",
  "targetDedicatedNodes": 1,
  "targetLowPriorityNodes": 0,
  "taskSlotsPerNode": 1,
  "enableAutoScale": false
}

Sample Response

Add a VirtualMachineConfiguration pool with ServiceArtifactReference

Sample Request

POST account.region.batch.azure.com/pools?api-version=2023-11-01.18.0



{
  "id": "mypool002",
  "vmSize": "Standard_A1_v2",
  "virtualMachineConfiguration": {
    "imageReference": {
      "publisher": "MicrosoftWindowsServer",
      "offer": "WindowsServer",
      "sku": "2016-datacenter-smalldisk",
      "version": "latest"
    },
    "windowsConfiguration": {
      "enableAutomaticUpdates": false
    },
    "serviceArtifactReference": {
      "id": "/subscriptions/subid/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Compute/galleries/myGallery/serviceArtifacts/myServiceArtifact/vmArtifactsProfiles/vmArtifactsProfile"
    },
    "nodeAgentSKUId": "batch.node.windows amd64"
  },
  "targetDedicatedNodes": 2
}

Sample Response

Definicje

Nazwa Opis
ApplicationPackageReference

Odwołanie do pakietu do wdrożenia w węzłach obliczeniowych.

AutoUserScope

Zakres użytkownika automatycznego

AutoUserSpecification

Określa parametry dla użytkownika automatycznego, który uruchamia zadanie w usłudze Batch.

AzureBlobFileSystemConfiguration

Informacje używane do nawiązywania połączenia z kontenerem usługi Azure Storage przy użyciu systemu Blobfuse.

AzureFileShareConfiguration

Informacje używane do nawiązywania połączenia z udziałem plików platformy Azure.

BatchError

Odpowiedź o błędzie odebrana z usługi Azure Batch.

BatchErrorDetail

Element dodatkowych informacji zawartych w odpowiedzi na błąd Azure Batch.

CachingType

Typ buforowania, który ma być włączony dla dysku.

CertificateReference

Odwołanie do certyfikatu do zainstalowania w węzłach obliczeniowych w puli.

CertificateStoreLocation

Lokalizacja magazynu certyfikatów w węźle obliczeniowym, w którym ma zostać zainstalowany certyfikat.

CertificateVisibility

Które konta użytkowników w węźle obliczeniowym powinny mieć dostęp do prywatnych danych certyfikatu.

CIFSMountConfiguration

Informacje używane do nawiązywania połączenia z systemem plików CIFS.

CloudServiceConfiguration

Konfiguracja węzłów obliczeniowych w puli na podstawie platformy Azure Cloud Services.

ComputeNodeFillType

Sposób dystrybucji zadań między węzłami obliczeniowymi w puli.

ComputeNodeIdentityReference

Odwołanie do tożsamości przypisanej przez użytkownika skojarzonej z pulą usługi Batch, która będzie używana przez węzeł obliczeniowy.

ContainerConfiguration

Konfiguracja pul z obsługą kontenerów.

ContainerRegistry

Prywatny rejestr kontenerów.

ContainerType

Używana technologia kontenerów.

ContainerWorkingDirectory

Lokalizacja katalogu roboczego zadania kontenera.

DataDisk

Ustawienia, które będą używane przez dyski danych skojarzone z węzłami obliczeniowymi w puli. W przypadku korzystania z dołączonych dysków danych należy zainstalować i sformatować dyski z poziomu maszyny wirtualnej, aby ich używać.

DiffDiskPlacement

Określa umieszczanie dysku efemerycznego dla dysku systemu operacyjnego dla wszystkich węzłów obliczeniowych (maszyn wirtualnych) w puli.

DiffDiskSettings

Określa ustawienia dysku efemerycznego dla dysku systemu operacyjnego używanego przez węzeł obliczeniowy (VM).

DiskEncryptionConfiguration

Konfiguracja szyfrowania dysków zastosowana w węzłach obliczeniowych w puli. Konfiguracja szyfrowania dysków nie jest obsługiwana w puli systemu Linux utworzonej za pomocą obrazu galerii obliczeń platformy Azure.

DiskEncryptionTarget

Lista dysków przeznaczonych dla usługi Batch zostanie zaszyfrowana w węźle obliczeniowym.

DynamicVNetAssignmentScope

Zakres dynamicznego przypisania sieci wirtualnej.

ElevationLevel

Poziom podniesienia uprawnień użytkownika.

EnvironmentSetting

Zmienna środowiskowa, która ma zostać ustawiona w procesie zadania.

ErrorMessage

Komunikat o błędzie odebrany w odpowiedzi Azure Batch błędu.

ImageReference

Odwołanie do obrazu witryny Azure Virtual Machines Marketplace lub obrazu galerii obliczeniowej platformy Azure. Aby uzyskać listę wszystkich odwołań do obrazu Azure Marketplace zweryfikowanych przez Azure Batch, zobacz operację "Wyświetl obsługiwane obrazy".

InboundEndpointProtocol

Protokół punktu końcowego.

InboundNATPool

Pula nat dla ruchu przychodzącego, która może służyć do adresowania określonych portów w węzłach obliczeniowych w puli usługi Batch zewnętrznie.

IPAddressProvisioningType

Typ aprowizacji dla publicznych adresów IP dla puli.

LinuxUserConfiguration

Właściwości używane do tworzenia konta użytkownika w węźle obliczeniowym systemu Linux.

LoginMode

Tryb logowania użytkownika

ManagedDisk
MetadataItem

Para nazwa-wartość skojarzona z zasobem usługi Batch.

MountConfiguration

System plików do zainstalowania w każdym węźle.

NetworkConfiguration

Konfiguracja sieci dla puli.

NetworkSecurityGroupRule

Reguła sieciowej grupy zabezpieczeń, która ma być stosowana do przychodzącego punktu końcowego.

NetworkSecurityGroupRuleAccess

Akcja, która powinna zostać podjęta dla określonego adresu IP, zakresu podsieci lub tagu.

NFSMountConfiguration

Informacje używane do nawiązywania połączenia z systemem plików NFS.

NodeCommunicationMode

Określa, w jaki sposób pula komunikuje się z usługą Batch.

NodePlacementConfiguration

Konfiguracja umieszczania węzłów dla puli.

NodePlacementPolicyType

Zasady umieszczania dla przydzielania węzłów w puli.

OSDisk

Ustawienia dysku systemu operacyjnego węzła obliczeniowego (VM).

PoolAddParameter

Pula w usłudze Azure Batch do dodania.

PoolEndpointConfiguration

Konfiguracja punktu końcowego dla puli.

PublicIPAddressConfiguration

Konfiguracja publicznego adresu IP konfiguracji sieci puli.

ResourceFile

Jeden plik lub wiele plików do pobrania do węzła obliczeniowego.

SecurityProfile

Określa ustawienia profilu zabezpieczeń dla maszyny wirtualnej lub zestawu skalowania maszyn wirtualnych.

SecurityTypes

Określa typ zabezpieczeń maszyny wirtualnej. Należy ustawić ją na dowolną określoną wartość, aby włączyć funkcję UefiSettings.

ServiceArtifactReference

Określa identyfikator odwołania artefaktu usługi używany do ustawiania tej samej wersji obrazu dla wszystkich maszyn wirtualnych w zestawie skalowania podczas korzystania z wersji obrazu "latest".

StartTask

Zadanie uruchamiane po dołączeniu węzła do puli w usłudze Azure Batch lub po ponownym uruchomieniu lub ponownym uruchomieniu węzła obliczeniowego lub ponownym obrazie.

StorageAccountType

Typ konta magazynu do użycia podczas tworzenia dysków danych lub dysku systemu operacyjnego.

TaskContainerSettings

Ustawienia kontenera dla zadania.

TaskSchedulingPolicy

Określa sposób dystrybucji zadań między węzłami obliczeniowymi.

UefiSettings

Określa ustawienia zabezpieczeń, takie jak bezpieczny rozruch i vTPM używane podczas tworzenia maszyny wirtualnej.

UserAccount

Właściwości używane do tworzenia użytkownika używanego do wykonywania zadań w węźle obliczeniowym Azure Batch.

UserIdentity

Definicja tożsamości użytkownika, w ramach której jest uruchamiane zadanie.

VirtualMachineConfiguration

Konfiguracja węzłów obliczeniowych w puli na podstawie infrastruktury usługi Azure Virtual Machines.

VMExtension

Konfiguracja rozszerzeń maszyn wirtualnych.

WindowsConfiguration

Ustawienia systemu operacyjnego Windows, które mają być stosowane do maszyny wirtualnej.

WindowsUserConfiguration

Właściwości używane do tworzenia konta użytkownika w węźle obliczeniowym systemu Windows.

ApplicationPackageReference

Odwołanie do pakietu do wdrożenia w węzłach obliczeniowych.

Nazwa Typ Opis
applicationId

string

Identyfikator aplikacji do wdrożenia.
Podczas tworzenia puli identyfikator aplikacji pakietu musi być w pełni kwalifikowany (/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Batch/batchAccounts/{accountName}/applications/{applicationName}).

version

string

Wersja aplikacji do wdrożenia. Jeśli pominięto, zostanie wdrożona domyślna wersja.
Jeśli pominięto tę wersję w puli i nie określono domyślnej wersji dla tej aplikacji, żądanie kończy się niepowodzeniem z kodem błędu InvalidApplicationPackageReferences i kodem stanu HTTP 409. Jeśli pominięto to zadanie i nie określono domyślnej wersji dla tej aplikacji, zadanie kończy się niepowodzeniem z powodu błędu przetwarzania wstępnego.

AutoUserScope

Zakres użytkownika automatycznego

Nazwa Typ Opis
pool

string

Określa, że zadanie jest uruchamiane jako wspólne konto użytkownika automatycznego, które jest tworzone w każdym węźle obliczeniowym w puli.

task

string

Określa, że usługa powinna utworzyć nowego użytkownika dla zadania.

AutoUserSpecification

Określa parametry dla użytkownika automatycznego, który uruchamia zadanie w usłudze Batch.

Nazwa Typ Opis
elevationLevel

ElevationLevel

Poziom podniesienia uprawnień użytkownika automatycznego.
Wartość domyślna to nonAdmin.

scope

AutoUserScope

Zakres użytkownika automatycznego
Wartość domyślna to pula. Jeśli pula jest uruchomiona w systemie Windows, należy określić wartość Zadanie, jeśli wymagana jest ściślejsza izolacja między zadaniami. Jeśli na przykład zadanie wycisza rejestr w sposób, który może mieć wpływ na inne zadania, lub jeśli certyfikaty zostały określone w puli, które nie powinny być dostępne dla zwykłych zadań, ale powinny być dostępne przez startzadania.

AzureBlobFileSystemConfiguration

Informacje używane do nawiązywania połączenia z kontenerem usługi Azure Storage przy użyciu systemu Blobfuse.

Nazwa Typ Opis
accountKey

string

Klucz konta usługi Azure Storage.
Ta właściwość wyklucza się wzajemnie zarówno z kluczem sasKey, jak i tożsamością; należy określić dokładnie jedną z nich.

accountName

string

Nazwa konta usługi Azure Storage.

blobfuseOptions

string

Dodatkowe opcje wiersza polecenia umożliwiające przekazanie polecenia instalacji.
Są to opcje "net use" w systemie Windows i opcje instalacji w systemie Linux.

containerName

string

Nazwa kontenera Azure Blob Storage.

identityReference

ComputeNodeIdentityReference

Odwołanie do tożsamości przypisanej przez użytkownika do użycia w celu uzyskania dostępu do nazwy kontenera
Ta właściwość wyklucza się wzajemnie zarówno z właściwością accountKey, jak i sasKey; należy określić dokładnie jedną z nich.

relativeMountPath

string

Ścieżka względna w węźle obliczeniowym, w którym zostanie zainstalowany system plików
Wszystkie systemy plików są instalowane względem katalogu instalacji usługi Batch, dostępnego za pośrednictwem zmiennej środowiskowej AZ_BATCH_NODE_MOUNTS_DIR.

sasKey

string

Token SAS usługi Azure Storage.
Ta właściwość wyklucza się wzajemnie zarówno z kluczem konta, jak i tożsamością; należy określić dokładnie jedną z nich.

AzureFileShareConfiguration

Informacje używane do nawiązywania połączenia z udziałem plików platformy Azure.

Nazwa Typ Opis
accountKey

string

Klucz konta usługi Azure Storage.

accountName

string

Nazwa konta usługi Azure Storage.

azureFileUrl

string

Adres URL Azure Files.
Jest to formularz "https://{account}.file.core.windows.net/".

mountOptions

string

Dodatkowe opcje wiersza polecenia umożliwiające przekazanie polecenia instalacji.
Są to opcje "net use" w systemie Windows i opcje instalacji w systemie Linux.

relativeMountPath

string

Ścieżka względna w węźle obliczeniowym, w którym zostanie zainstalowany system plików
Wszystkie systemy plików są instalowane względem katalogu instalacji usługi Batch, dostępnego za pośrednictwem zmiennej środowiskowej AZ_BATCH_NODE_MOUNTS_DIR.

BatchError

Odpowiedź o błędzie odebrana z usługi Azure Batch.

Nazwa Typ Opis
code

string

Identyfikator błędu. Kody są niezmienne i mają być używane programowo.

message

ErrorMessage

Komunikat opisujący błąd, który ma być odpowiedni do wyświetlania w interfejsie użytkownika.

values

BatchErrorDetail[]

Kolekcja par klucz-wartość zawierająca dodatkowe szczegóły dotyczące błędu.

BatchErrorDetail

Element dodatkowych informacji zawartych w odpowiedzi na błąd Azure Batch.

Nazwa Typ Opis
key

string

Identyfikator określający znaczenie właściwości Value.

value

string

Dodatkowe informacje zawarte w odpowiedzi na błąd.

CachingType

Typ buforowania, który ma być włączony dla dysku.

Nazwa Typ Opis
none

string

Tryb buforowania dysku nie jest włączony.

readonly

string

Tryb buforowania dla dysku jest tylko do odczytu.

readwrite

string

Tryb buforowania dysku jest odczytywany i zapisywany.

CertificateReference

Odwołanie do certyfikatu do zainstalowania w węzłach obliczeniowych w puli.

Nazwa Typ Opis
storeLocation

CertificateStoreLocation

Lokalizacja magazynu certyfikatów w węźle obliczeniowym, w którym ma zostać zainstalowany certyfikat.
Wartość domyślna to currentuser. Ta właściwość ma zastosowanie tylko w przypadku pul skonfigurowanych z węzłami obliczeniowymi systemu Windows (czyli tworzonych za pomocą polecenia cloudServiceConfiguration lub virtualMachineConfiguration przy użyciu odwołania do obrazu systemu Windows). W przypadku węzłów obliczeniowych systemu Linux certyfikaty są przechowywane w katalogu roboczym Zadania, a zmienna środowiskowa AZ_BATCH_CERTIFICATES_DIR jest dostarczana do zadania, aby wykonać zapytanie o tę lokalizację. W przypadku certyfikatów z widocznością "remoteUser" katalog "certs" jest tworzony w katalogu głównym użytkownika (np. /home/{user-name}/certs) i Certyfikaty są umieszczane w tym katalogu.

storeName

string

Nazwa magazynu certyfikatów w węźle obliczeniowym, w którym ma zostać zainstalowany certyfikat.
Ta właściwość ma zastosowanie tylko w przypadku pul skonfigurowanych z węzłami obliczeniowymi systemu Windows (czyli tworzonych za pomocą polecenia cloudServiceConfiguration lub virtualMachineConfiguration przy użyciu odwołania do obrazu systemu Windows). Typowe nazwy sklepów to: My, Root, CA, Trust, Disallowed, TrustedPeople, TrustedPublisher, AuthRoot, AddressBook, ale można również użyć dowolnej niestandardowej nazwy sklepu. Wartość domyślna to Moja.

thumbprint

string

Odcisk palca certyfikatu.

thumbprintAlgorithm

string

Algorytm, z którym jest skojarzony odcisk palca. Musi to być sha1.

visibility

CertificateVisibility[]

Które konta użytkowników w węźle obliczeniowym powinny mieć dostęp do prywatnych danych certyfikatu.
W tej kolekcji można określić więcej niż jedną widoczność. Wartość domyślna to wszystkie konta.

CertificateStoreLocation

Lokalizacja magazynu certyfikatów w węźle obliczeniowym, w którym ma zostać zainstalowany certyfikat.

Nazwa Typ Opis
currentuser

string

Certyfikaty należy zainstalować w magazynie certyfikatów CurrentUser.

localmachine

string

Certyfikaty należy zainstalować w magazynie certyfikatów LocalMachine.

CertificateVisibility

Które konta użytkowników w węźle obliczeniowym powinny mieć dostęp do prywatnych danych certyfikatu.

Nazwa Typ Opis
remoteuser

string

Certyfikat powinien być widoczny dla kont użytkowników, w ramach których użytkownicy zdalnie uzyskują dostęp do węzła obliczeniowego.

starttask

string

Certyfikat powinien być widoczny dla konta użytkownika, w ramach którego jest uruchamiana usługa StartTask. Należy pamiętać, że jeśli zakres autoużytkownika jest pulą dla zadania StartTask i Zadania, ten certyfikat będzie również widoczny dla zadania.

task

string

Certyfikat powinien być widoczny dla kont użytkowników, w ramach których są uruchamiane zadania.

CIFSMountConfiguration

Informacje używane do nawiązywania połączenia z systemem plików CIFS.

Nazwa Typ Opis
mountOptions

string

Dodatkowe opcje wiersza polecenia umożliwiające przekazanie polecenia instalacji.
Są to opcje "net use" w systemie Windows i opcje instalacji w systemie Linux.

password

string

Hasło używane do uwierzytelniania w systemie plików CIFS.

relativeMountPath

string

Ścieżka względna w węźle obliczeniowym, w którym zostanie zainstalowany system plików
Wszystkie systemy plików są instalowane względem katalogu instalacji usługi Batch, dostępnego za pośrednictwem zmiennej środowiskowej AZ_BATCH_NODE_MOUNTS_DIR.

source

string

Identyfikator URI systemu plików do zainstalowania.

username

string

Użytkownik, który ma być używany do uwierzytelniania w systemie plików CIFS.

CloudServiceConfiguration

Konfiguracja węzłów obliczeniowych w puli na podstawie platformy Azure Cloud Services.

Nazwa Typ Opis
osFamily

string

Rodzina systemu operacyjnego gościa platformy Azure, która ma zostać zainstalowana na maszynach wirtualnych w puli.
Możliwe wartości to: 2 — Rodzina systemu operacyjnego 2, co odpowiada systemowi Windows Server 2008 R2 z dodatkiem SP1. 3 — Rodzina systemu operacyjnego 3, równoważna Windows Server 2012. 4 — Rodzina systemów operacyjnych 4, równoważna Windows Server 2012 R2. 5 — Rodzina systemu operacyjnego 5, równoważna Windows Server 2016. 6 — Rodzina systemu operacyjnego 6, co odpowiada systemowi Windows Server 2019. Aby uzyskać więcej informacji, zobacz Wersje systemu operacyjnego gościa platformy Azure (https://azure.microsoft.com/documentation/articles/cloud-services-guestos-update-matrix/#releases).

osVersion

string

Wersja systemu operacyjnego gościa platformy Azure, która ma zostać zainstalowana na maszynach wirtualnych w puli.
Wartość domyślna to * określająca najnowszą wersję systemu operacyjnego dla określonej rodziny systemu operacyjnego.

ComputeNodeFillType

Sposób dystrybucji zadań między węzłami obliczeniowymi w puli.

Nazwa Typ Opis
pack

string

Jak najwięcej zadań (taskSlotsPerNode) należy przypisać do każdego węzła obliczeniowego w puli, zanim wszystkie zadania zostaną przypisane do następnego węzła obliczeniowego w puli.

spread

string

Zadania powinny być przypisywane równomiernie we wszystkich węzłach obliczeniowych w puli.

ComputeNodeIdentityReference

Odwołanie do tożsamości przypisanej przez użytkownika skojarzonej z pulą usługi Batch, która będzie używana przez węzeł obliczeniowy.

Nazwa Typ Opis
resourceId

string

Identyfikator zasobu usługi ARM tożsamości przypisanej przez użytkownika.

ContainerConfiguration

Konfiguracja pul z obsługą kontenerów.

Nazwa Typ Opis
containerImageNames

string[]

Kolekcja nazw obrazów kontenera.
Jest to pełne odwołanie do obrazu, które zostanie określone jako "ściąganie platformy Docker". Obraz będzie pozyskiwany z domyślnego rejestru platformy Docker, chyba że obraz jest w pełni kwalifikowany z alternatywnym rejestrem.

containerRegistries

ContainerRegistry[]

Dodatkowe rejestry prywatne, z których można ściągać kontenery.
Jeśli jakiekolwiek obrazy muszą zostać pobrane z rejestru prywatnego, który wymaga poświadczeń, należy podać te poświadczenia tutaj.

type

ContainerType

Używana technologia kontenerów.

ContainerRegistry

Prywatny rejestr kontenerów.

Nazwa Typ Opis
identityReference

ComputeNodeIdentityReference

Odwołanie do tożsamości przypisanej przez użytkownika w celu uzyskania dostępu do Azure Container Registry zamiast nazwy użytkownika i hasła.
Odwołanie do tożsamości przypisanej przez użytkownika skojarzonej z pulą usługi Batch, która będzie używana przez węzeł obliczeniowy.

password

string

Hasło do logowania się na serwerze rejestru.

registryServer

string

Adres URL rejestru.
W przypadku pominięcia wartość domyślna to "docker.io".

username

string

Nazwa użytkownika do logowania się na serwerze rejestru.

ContainerType

Używana technologia kontenerów.

Nazwa Typ Opis
criCompatible

string

Technologia oparta na cri będzie używana do uruchamiania kontenerów.

dockerCompatible

string

Technologia kontenera zgodna z platformą Docker będzie używana do uruchamiania kontenerów.

ContainerWorkingDirectory

Lokalizacja katalogu roboczego zadania kontenera.

Nazwa Typ Opis
containerImageDefault

string

Użyj katalogu roboczego zdefiniowanego w obrazie kontenera. Należy pamiętać, że ten katalog nie będzie zawierać plików zasobów pobranych przez usługę Batch.

taskWorkingDirectory

string

Użyj standardowego katalogu roboczego zadania usługi Batch, który będzie zawierać pliki zasobów zadań wypełniane przez usługę Batch.

DataDisk

Ustawienia, które będą używane przez dyski danych skojarzone z węzłami obliczeniowymi w puli. W przypadku korzystania z dołączonych dysków danych należy zainstalować i sformatować dyski z poziomu maszyny wirtualnej, aby ich używać.

Nazwa Typ Opis
caching

CachingType

Typ buforowania, który ma być włączony dla dysków danych.
Wartość domyślna buforowania to readwrite. Aby uzyskać informacje o opcjach buforowania, zobacz: https://blogs.msdn.microsoft.com/windowsazurestorage/2012/06/27/exploring-windows-azure-drives-disks-and-images/.

diskSizeGB

integer

Początkowy rozmiar dysku w gigabajtach.

lun

integer

Numer jednostki logicznej.
Jednostka lun służy do unikatowego identyfikowania każdego dysku danych. W przypadku dołączania wielu dysków każdy powinien mieć odrębną jednostkę lun. Wartość musi należeć do przedziału od 0 do 63 włącznie.

storageAccountType

StorageAccountType

Typ konta magazynu, który ma być używany dla dysku danych.
W przypadku pominięcia wartość domyślna to "standard_lrs".

DiffDiskPlacement

Określa umieszczanie dysku efemerycznego dla dysku systemu operacyjnego dla wszystkich węzłów obliczeniowych (maszyn wirtualnych) w puli.

Nazwa Typ Opis
CacheDisk

string

Efemeryczny dysk systemu operacyjnego jest przechowywany w pamięci podręcznej maszyny wirtualnej.

DiffDiskSettings

Określa ustawienia dysku efemerycznego dla dysku systemu operacyjnego używanego przez węzeł obliczeniowy (VM).

Nazwa Typ Opis
placement

DiffDiskPlacement

Określa efemeryczne umieszczanie dysku systemu operacyjnego dla wszystkich maszyn wirtualnych w puli.
Ta właściwość może być używana przez użytkownika w żądaniu, aby wybrać lokalizację, np. miejsce na dysku pamięci podręcznej na potrzeby aprowizowania efemerycznego dysku systemu operacyjnego. Aby uzyskać więcej informacji na temat wymagań dotyczących efemerycznego rozmiaru dysku systemu operacyjnego, zobacz Wymagania dotyczące efemerycznego rozmiaru dysku systemu operacyjnego dla maszyn wirtualnych z systemem Windows na https://docs.microsoft.com/en-us/azure/virtual-machines/windows/ephemeral-os-disks#size-requirements stronie i maszyn wirtualnych z systemem Linux pod adresem https://docs.microsoft.com/en-us/azure/virtual-machines/linux/ephemeral-os-disks#size-requirements.

DiskEncryptionConfiguration

Konfiguracja szyfrowania dysków zastosowana w węzłach obliczeniowych w puli. Konfiguracja szyfrowania dysków nie jest obsługiwana w puli systemu Linux utworzonej za pomocą obrazu galerii obliczeń platformy Azure.

Nazwa Typ Opis
targets

DiskEncryptionTarget[]

Lista dysków przeznaczonych dla usługi Batch zostanie zaszyfrowana w węźle obliczeniowym.
W przypadku pominięcia żadne dyski w węzłach obliczeniowych w puli nie będą szyfrowane. W puli systemu Linux obsługiwana jest tylko opcja "TemporaryDisk"; w puli systemu Windows należy określić wartości "OsDisk" i "TemporaryDisk".

DiskEncryptionTarget

Lista dysków przeznaczonych dla usługi Batch zostanie zaszyfrowana w węźle obliczeniowym.

Nazwa Typ Opis
osdisk

string

Dysk systemu operacyjnego w węźle obliczeniowym jest szyfrowany.

temporarydisk

string

Dysk tymczasowy w węźle obliczeniowym jest szyfrowany. W systemie Linux to szyfrowanie ma zastosowanie do innych partycji (takich jak te na zainstalowanych dyskach danych), gdy szyfrowanie odbywa się w czasie rozruchu.

DynamicVNetAssignmentScope

Zakres dynamicznego przypisania sieci wirtualnej.

Nazwa Typ Opis
job

string

Dynamiczne przypisanie sieci wirtualnej jest wykonywane dla poszczególnych zadań.

none

string

Nie włączono dynamicznego przypisania sieci wirtualnej.

ElevationLevel

Poziom podniesienia uprawnień użytkownika.

Nazwa Typ Opis
admin

string

Użytkownik jest użytkownikiem z podwyższonym poziomem dostępu i działa z pełnymi uprawnieniami administratora.

nonadmin

string

Użytkownik jest użytkownikiem standardowym bez podwyższonego poziomu dostępu.

EnvironmentSetting

Zmienna środowiskowa, która ma zostać ustawiona w procesie zadania.

Nazwa Typ Opis
name

string

Nazwa zmiennej środowiskowej.

value

string

Wartość zmiennej środowiskowej.

ErrorMessage

Komunikat o błędzie odebrany w odpowiedzi Azure Batch błędu.

Nazwa Typ Opis
lang

string

Kod języka komunikatu o błędzie

value

string

Tekst wiadomości.

ImageReference

Odwołanie do obrazu witryny Azure Virtual Machines Marketplace lub obrazu galerii obliczeniowej platformy Azure. Aby uzyskać listę wszystkich odwołań do obrazu Azure Marketplace zweryfikowanych przez Azure Batch, zobacz operację "Wyświetl obsługiwane obrazy".

Nazwa Typ Opis
exactVersion

string

Określona wersja obrazu platformy lub obrazu z witryny Marketplace używana do utworzenia węzła. To pole tylko do odczytu różni się od "version" tylko wtedy, gdy wartość określona dla "version" podczas tworzenia puli była "latest".

offer

string

Typ oferty obrazu witryny Azure Virtual Machines Marketplace.
Na przykład UbuntuServer lub WindowsServer.

publisher

string

Wydawca obrazu witryny Azure Virtual Machines Marketplace.
Na przykład Canonical lub MicrosoftWindowsServer.

sku

string

Jednostka SKU obrazu witryny Azure Virtual Machines Marketplace.
Na przykład 18.04-LTS lub 2019-Datacenter.

version

string

Wersja obrazu witryny Azure Virtual Machines Marketplace.
Można określić wartość "latest", aby wybrać najnowszą wersję obrazu. W przypadku pominięcia wartość domyślna to "latest".

virtualMachineImageId

string

Identyfikator zasobu usługi ARM obrazu galerii obliczeniowej platformy Azure. Węzły obliczeniowe w puli zostaną utworzone przy użyciu tego identyfikatora obrazu. Jest to formularz /subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Compute/galleries/{galleryName}/images/{imageDefinitionName}/versions/{VersionId} lub /subscriptions/{subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Compute/gallerys/{galleryName}/images/{imageDefinitionName} dla zawsze domyślnej wersji obrazu.
Ta właściwość wzajemnie się wyklucza z innymi właściwościami ImageReference. Obraz usługi Azure Compute Gallery musi mieć repliki w tym samym regionie i musi znajdować się w tej samej subskrypcji co konto Azure Batch. Jeśli wersja obrazu nie zostanie określona w identyfikatorze imageId, zostanie użyta najnowsza wersja. Aby uzyskać informacje o ustawieniach zapory dla agenta węzła obliczeniowego usługi Batch do komunikowania się z usługą Batch, zobacz https://docs.microsoft.com/en-us/azure/batch/batch-api-basics#virtual-network-vnet-and-firewall-configuration.

InboundEndpointProtocol

Protokół punktu końcowego.

Nazwa Typ Opis
tcp

string

Użyj protokołu TCP dla punktu końcowego.

udp

string

Użyj protokołu UDP dla punktu końcowego.

InboundNATPool

Pula nat dla ruchu przychodzącego, która może służyć do adresowania określonych portów w węzłach obliczeniowych w puli usługi Batch zewnętrznie.

Nazwa Typ Opis
backendPort

integer

Numer portu w węźle obliczeniowym.
Musi to być unikatowe w puli usługi Batch. Dopuszczalne wartości to od 1 do 65535 z wyjątkiem 22, 3389, 29876 i 29877, ponieważ są one zarezerwowane. Jeśli jakiekolwiek wartości zarezerwowane zostaną dostarczone, żądanie zakończy się niepowodzeniem z kodem stanu HTTP 400.

frontendPortRangeEnd

integer

Ostatni numer portu w zakresie portów zewnętrznych, które będą używane do zapewnienia dostępu przychodzącego do zapleczaPort w poszczególnych węzłach obliczeniowych.
Dopuszczalny zakres wartości z zakresu od 1 do 65534 z wyjątkiem portów od 50000 do 55000, które są zarezerwowane przez usługę Batch. Wszystkie zakresy w puli muszą być odrębne i nie mogą się nakładać. Każdy zakres musi zawierać co najmniej 40 portów. Jeśli jakiekolwiek zastrzeżone lub nakładające się wartości są dostarczane żądanie kończy się niepowodzeniem z kodem stanu HTTP 400.

frontendPortRangeStart

integer

Pierwszy numer portu w zakresie portów zewnętrznych, które będą używane do zapewnienia dostępu przychodzącego do zapleczaPort w poszczególnych węzłach obliczeniowych.
Dopuszczalny zakres wartości z zakresu od 1 do 65534 z wyjątkiem portów od 50000 do 55000, które są zarezerwowane. Wszystkie zakresy w puli muszą być odrębne i nie mogą się nakładać. Każdy zakres musi zawierać co najmniej 40 portów. Jeśli jakiekolwiek zastrzeżone lub nakładające się wartości są dostarczane żądanie kończy się niepowodzeniem z kodem stanu HTTP 400.

name

string

Nazwa punktu końcowego.
Nazwa musi być unikatowa w puli usługi Batch, może zawierać litery, cyfry, podkreślenia, kropki i łączniki. Nazwy muszą zaczynać się literą lub cyfrą, muszą kończyć się literą, cyfrą lub podkreśleniami i nie mogą przekraczać 77 znaków. Jeśli podano jakiekolwiek nieprawidłowe wartości, żądanie zakończy się niepowodzeniem z kodem stanu HTTP 400.

networkSecurityGroupRules

NetworkSecurityGroupRule[]

Lista reguł sieciowej grupy zabezpieczeń, które zostaną zastosowane do punktu końcowego.
Maksymalna liczba reguł, które można określić we wszystkich punktach końcowych w puli usługi Batch, wynosi 25. Jeśli nie określono żadnych reguł sieciowej grupy zabezpieczeń, zostanie utworzona domyślna reguła zezwalania na dostęp przychodzący do określonego zapleczaPort. Jeśli maksymalna liczba reguł sieciowej grupy zabezpieczeń zostanie przekroczona, żądanie zakończy się niepowodzeniem z kodem stanu HTTP 400.

protocol

InboundEndpointProtocol

Protokół punktu końcowego.

IPAddressProvisioningType

Typ aprowizacji dla publicznych adresów IP dla puli.

Nazwa Typ Opis
batchmanaged

string

Publiczny adres IP zostanie utworzony i zarządzany przez usługę Batch. W zależności od rozmiaru puli może istnieć wiele publicznych adresów IP.

nopublicipaddresses

string

Nie zostanie utworzony publiczny adres IP.

usermanaged

string

Publiczne adresy IP są udostępniane przez użytkownika i będą używane do aprowizacji węzłów obliczeniowych.

LinuxUserConfiguration

Właściwości używane do tworzenia konta użytkownika w węźle obliczeniowym systemu Linux.

Nazwa Typ Opis
gid

integer

Identyfikator grupy dla konta użytkownika.
Właściwości uid i gid muszą być określone razem lub w ogóle nie. Jeśli nie określono bazowego systemu operacyjnego, wybiera gid.

sshPrivateKey

string

Klucz prywatny SSH dla konta użytkownika.
Klucz prywatny nie może być chroniony hasłem. Klucz prywatny służy do automatycznego konfigurowania uwierzytelniania opartego na kluczu asymetrycznym dla protokołu SSH między węzłami obliczeniowymi w puli systemu Linux, gdy właściwość EnableInterNodeCommunication puli ma wartość true (jest ignorowana, jeśli właściwość enableInterNodeCommunication ma wartość false). W tym celu należy umieścić parę kluczy w katalogu ssh użytkownika. Jeśli nie zostanie określony, protokół SSH bez hasła nie jest skonfigurowany między węzłami obliczeniowymi (nie jest wykonywana żadna modyfikacja katalogu ssh użytkownika).

uid

integer

Identyfikator użytkownika konta użytkownika.
Właściwości uid i gid muszą być określone razem lub nie w ogóle. Jeśli nie określono bazowego systemu operacyjnego, wybierze identyfikator uid.

LoginMode

Tryb logowania użytkownika

Nazwa Typ Opis
batch

string

Tryb logowania LOGON32_LOGON_BATCH Win32. Tryb logowania wsadowego jest zalecany w przypadku długotrwałych procesów równoległych.

interactive

string

Tryb logowania LOGON32_LOGON_INTERACTIVE Win32. Kontrola konta użytkownika jest włączona w pulach Windows VirtualMachineConfiguration. Jeśli ta opcja jest używana z podwyższonym poziomem uprawnień tożsamości użytkownika w puli Windows VirtualMachineConfiguration, sesja użytkownika nie zostanie podwyższona, chyba że aplikacja wykonywana przez wiersz polecenia zadania jest skonfigurowana tak, aby zawsze wymagała uprawnień administracyjnych lub zawsze wymagać maksymalnego uprawnienia.

ManagedDisk

Nazwa Typ Opis
storageAccountType

StorageAccountType

Typ konta magazynu dla dysku zarządzanego.

MetadataItem

Para nazwa-wartość skojarzona z zasobem usługi Batch.

Nazwa Typ Opis
name

string

Nazwa elementu metadanych.

value

string

Wartość elementu metadanych.

MountConfiguration

System plików do zainstalowania w każdym węźle.

Nazwa Typ Opis
azureBlobFileSystemConfiguration

AzureBlobFileSystemConfiguration

Kontener usługi Azure Storage do zainstalowania przy użyciu programu BLob FUSE w każdym węźle.
Ta właściwość wyklucza się wzajemnie ze wszystkimi innymi właściwościami.

azureFileShareConfiguration

AzureFileShareConfiguration

Udział plików platformy Azure do zainstalowania w każdym węźle.
Ta właściwość wyklucza się wzajemnie ze wszystkimi innymi właściwościami.

cifsMountConfiguration

CIFSMountConfiguration

System plików CIFS/SMB do zainstalowania w każdym węźle.
Ta właściwość wyklucza się wzajemnie ze wszystkimi innymi właściwościami.

nfsMountConfiguration

NFSMountConfiguration

System plików NFS do zainstalowania w każdym węźle.
Ta właściwość wyklucza się wzajemnie ze wszystkimi innymi właściwościami.

NetworkConfiguration

Konfiguracja sieci dla puli.

Nazwa Typ Opis
dynamicVNetAssignmentScope

DynamicVNetAssignmentScope

Zakres dynamicznego przypisania sieci wirtualnej.

enableAcceleratedNetworking

boolean

Określa, czy ta pula powinna włączyć przyspieszoną sieć.
Przyspieszona sieć umożliwia wirtualizację we/wy pojedynczego katalogu głównego (SR-IOV) do maszyny wirtualnej, co może prowadzić do zwiększenia wydajności sieci. Aby uzyskać więcej informacji, zobacz: https://learn.microsoft.com/azure/virtual-network/accelerated-networking-overview.

endpointConfiguration

PoolEndpointConfiguration

Konfiguracja punktów końcowych w węzłach obliczeniowych w puli usługi Batch.
Konfiguracja punktu końcowego puli jest obsługiwana tylko w pulach z właściwością virtualMachineConfiguration.

publicIPAddressConfiguration

PublicIPAddressConfiguration

Konfiguracja publicznego adresu IP Dla węzłów obliczeniowych w puli usługi Batch.
Właściwość konfiguracji publicznego adresu IP jest obsługiwana tylko w pulach z właściwością virtualMachineConfiguration.

subnetId

string

Identyfikator zasobu usługi ARM podsieci sieci wirtualnej, do której zostaną przyłączone węzły obliczeniowe puli. Jest to formularz /subscriptions/{subscription}/resourceGroups/{group}/providers/{provider}/virtualNetworks/{network}/subnets/{subnet}.
Sieć wirtualna musi znajdować się w tym samym regionie i subskrypcji co konto Azure Batch. Określona podsieć powinna mieć wystarczającą liczbę wolnych adresów IP, aby pomieścić liczbę węzłów obliczeniowych w puli. Jeśli podsieć nie ma wystarczającej liczby wolnych adresów IP, pula częściowo przydzieli węzły i wystąpi błąd zmiany rozmiaru. Jednostka usługi "MicrosoftAzureBatch" musi mieć rolę "Współautor klasycznej maszyny wirtualnej" Role-Based Access Control (RBAC) dla określonej sieci wirtualnej. Określona podsieć musi zezwalać na komunikację z usługi Azure Batch, aby móc planować zadania w węzłach. Można to zweryfikować, sprawdzając, czy określona sieć wirtualna ma skojarzone sieciowe grupy zabezpieczeń. Jeśli komunikacja z węzłami w określonej podsieci zostanie odrzucona przez sieciową grupę zabezpieczeń, usługa Batch ustawi stan węzłów obliczeniowych na bezużyteczny. W przypadku pul utworzonych za pomocą polecenia virtualMachineConfiguration obsługiwane są tylko sieci wirtualne USŁUGI ARM (Microsoft.Network/virtualNetworks), ale w przypadku pul utworzonych za pomocą klasy cloudServiceConfiguration obsługiwane są zarówno sieci wirtualne ARM, jak i klasyczne. Jeśli określona sieć wirtualna ma skojarzone sieciowe grupy zabezpieczeń, należy włączyć kilka zarezerwowanych portów systemu na potrzeby komunikacji przychodzącej. W przypadku pul utworzonych przy użyciu konfiguracji maszyny wirtualnej włącz porty 29876 i 29877, a także port 22 dla systemu Linux i port 3389 dla systemu Windows. W przypadku pul utworzonych przy użyciu konfiguracji usługi w chmurze włącz porty 10100, 20100 i 30100. Włącz również połączenia wychodzące z usługą Azure Storage na porcie 443. Aby uzyskać więcej informacji, zobacz: https://docs.microsoft.com/en-us/azure/batch/batch-api-basics#virtual-network-vnet-and-firewall-configuration

NetworkSecurityGroupRule

Reguła sieciowej grupy zabezpieczeń, która ma być stosowana do przychodzącego punktu końcowego.

Nazwa Typ Opis
access

NetworkSecurityGroupRuleAccess

Akcja, która powinna zostać podjęta dla określonego adresu IP, zakresu podsieci lub tagu.

priority

integer

Priorytet tej reguły.
Priorytety w puli muszą być unikatowe i oceniane według priorytetu. Im niższy numer, tym wyższy priorytet. Na przykład można określić reguły z liczbami zamówień 150, 250 i 350. Reguła o kolejności 150 ma pierwszeństwo przed regułą, która ma kolejność 250. Dozwolone priorytety to od 150 do 4096. Jeśli jakiekolwiek zastrzeżone lub zduplikowane wartości zostaną dostarczone, żądanie zakończy się niepowodzeniem z kodem stanu HTTP 400.

sourceAddressPrefix

string

Prefiks lub tag adresu źródłowego, który ma być zgodny z regułą.
Prawidłowe wartości to pojedynczy adres IP (tj. 10.10.10.10.10), podsieć IP (tj. 192.168.1.0/24), tag domyślny lub * (dla wszystkich adresów). Jeśli podano inne wartości, żądanie zakończy się niepowodzeniem z kodem stanu HTTP 400.

sourcePortRanges

string[]

Zakresy portów źródłowych zgodne z regułą.
Prawidłowe wartości to "" (dla wszystkich portów 0–65535), określony port (tj. 22) lub zakres portów (tj. 100–200). Porty muszą należeć do zakresu od 0 do 65535. Każdy wpis w tej kolekcji nie może nakładać się na żaden inny wpis (zakres lub pojedynczy port). Jeśli podano inne wartości, żądanie zakończy się niepowodzeniem z kodem stanu HTTP 400. Wartość domyślna to "".

NetworkSecurityGroupRuleAccess

Akcja, która powinna zostać podjęta dla określonego adresu IP, zakresu podsieci lub tagu.

Nazwa Typ Opis
allow

string

Zezwalaj na dostęp.

deny

string

Odmowa dostępu.

NFSMountConfiguration

Informacje używane do nawiązywania połączenia z systemem plików NFS.

Nazwa Typ Opis
mountOptions

string

Dodatkowe opcje wiersza polecenia umożliwiające przekazanie polecenia instalacji.
Są to opcje "net use" w systemie Windows i opcje instalacji w systemie Linux.

relativeMountPath

string

Ścieżka względna w węźle obliczeniowym, w którym zostanie zainstalowany system plików
Wszystkie systemy plików są instalowane względem katalogu instalacji usługi Batch, dostępnego za pośrednictwem zmiennej środowiskowej AZ_BATCH_NODE_MOUNTS_DIR.

source

string

Identyfikator URI systemu plików do zainstalowania.

NodeCommunicationMode

Określa, w jaki sposób pula komunikuje się z usługą Batch.

Nazwa Typ Opis
classic

string

Węzły korzystające z trybu komunikacji klasycznej wymagają przychodzącej komunikacji TCP na portach 29876 i 29877 z "BatchNodeManagement. {region}" tag usługi i wychodząca komunikacja TCP na porcie 443 do "Storage.region" i "BatchNodeManagement". Tagi usługi {region}.

default

string

Tryb komunikacji węzła jest automatycznie ustawiany przez usługę Batch.

simplified

string

Węzły korzystające z uproszczonego trybu komunikacji wymagają komunikacji wychodzącej TCP na porcie 443 do "BatchNodeManagement. Tag usługi {region}. Nie są wymagane otwarte porty wejściowe.

NodePlacementConfiguration

Konfiguracja umieszczania węzłów dla puli.

Nazwa Typ Opis
policy

NodePlacementPolicyType

Typ zasad umieszczania węzłów w pulach usługi Batch.
Zasady alokacji używane przez usługę Batch do aprowizowania węzłów. Jeśli nie zostanie określony, usługa Batch użyje zasad regionalnych.

NodePlacementPolicyType

Zasady umieszczania dla przydzielania węzłów w puli.

Nazwa Typ Opis
regional

string

Wszystkie węzły w puli zostaną przydzielone w tym samym regionie.

zonal

string

Węzły w puli będą rozmieszczone w różnych strefach dostępności z najlepszym rozwiązaniem.

OSDisk

Ustawienia dysku systemu operacyjnego węzła obliczeniowego (VM).

Nazwa Typ Opis
caching

CachingType

Określa wymagania dotyczące buforowania. Możliwe wartości to: Brak, ReadOnly, ReadWrite. Wartości domyślne to: Brak dla magazynu w warstwie Standardowa. ReadOnly dla usługi Premium Storage.
Wartość domyślna buforowania to brak. Aby uzyskać informacje o opcjach buforowania, zobacz: https://blogs.msdn.microsoft.com/windowsazurestorage/2012/06/27/exploring-windows-azure-drives-disks-and-images/.

diskSizeGB

integer

Początkowy rozmiar dysku w GB podczas tworzenia nowego dysku systemu operacyjnego.

ephemeralOSDiskSettings

DiffDiskSettings

Określa efemeryczne ustawienia dysku systemu operacyjnego używanego przez węzeł obliczeniowy (VM).

managedDisk

ManagedDisk

Parametry dysku zarządzanego.

writeAcceleratorEnabled

boolean

Określa, czy na dysku należy włączyć lub wyłączyć funkcję writeAccelerator.

PoolAddParameter

Pula w usłudze Azure Batch do dodania.

Nazwa Typ Opis
applicationLicenses

string[]

Lista licencji aplikacji udostępnianych przez usługę Batch w każdym węźle obliczeniowym w puli.
Lista licencji aplikacji musi być podzbiorem dostępnych licencji aplikacji usługi Batch. Jeśli zażądano licencji, która nie jest obsługiwana, tworzenie puli zakończy się niepowodzeniem.

applicationPackageReferences

ApplicationPackageReference[]

Lista pakietów do zainstalowania w każdym węźle obliczeniowym w puli.
Podczas tworzenia puli identyfikator aplikacji pakietu musi być w pełni kwalifikowany (/subscriptions/{subscriptionId}/resourceGroups/{resourceGroups}/providers/Microsoft.Batch/batchAccounts/{accountName}/applications/{applicationName}). Zmiany odwołań do pakietu mają wpływ na wszystkie nowe węzły łączące pulę, ale nie mają wpływu na węzły obliczeniowe, które znajdują się już w puli, dopóki nie zostaną ponownie uruchomione lub ponownie z obrazu. W dowolnej puli istnieje maksymalnie 10 odwołań do pakietu.

autoScaleEvaluationInterval

string

Interwał czasu, w którym ma automatycznie dostosować rozmiar puli zgodnie z formułą autoskalowania.
Wartość domyślna to 15 minut. Minimalna i maksymalna wartość to odpowiednio 5 minut i 168 godzin. Jeśli określisz wartość mniejszą niż 5 minut lub większą niż 168 godzin, usługa Batch zwróci błąd; Jeśli bezpośrednio wywołujesz interfejs API REST, kod stanu HTTP to 400 (Nieprawidłowe żądanie).

autoScaleFormula

string

Formuła dla żądanej liczby węzłów obliczeniowych w puli.
Nie można określić tej właściwości, jeśli wartość enableAutoScale jest ustawiona na wartość false. Jest to wymagane, jeśli wartość enableAutoScale jest ustawiona na wartość true. Formuła jest sprawdzana pod kątem ważności przed utworzeniem puli. Jeśli formuła jest nieprawidłowa, usługa Batch odrzuca żądanie ze szczegółowymi informacjami o błędzie. Aby uzyskać więcej informacji na temat określania tej formuły, zobacz "Automatyczne skalowanie węzłów obliczeniowych w puli Azure Batch" (https://azure.microsoft.com/documentation/articles/batch-automatic-scaling/).

certificateReferences

CertificateReference[]

Lista certyfikatów do zainstalowania w każdym węźle obliczeniowym w puli.
W przypadku węzłów systemu Windows usługa Batch instaluje certyfikaty w określonym magazynie certyfikatów i lokalizacji. W przypadku węzłów obliczeniowych systemu Linux certyfikaty są przechowywane w katalogu roboczym Zadania, a zmienna środowiskowa AZ_BATCH_CERTIFICATES_DIR jest dostarczana do zadania w celu wykonania zapytania o tę lokalizację. W przypadku certyfikatów z widocznością "remoteUser" katalog "certs" jest tworzony w katalogu głównym użytkownika (np. /home/{user-name}/certs) i Certyfikaty są umieszczane w tym katalogu.

Ostrzeżenie: Ta właściwość jest przestarzała i zostanie usunięta po lutym 2024 r. Zamiast tego użyj rozszerzenia Azure KeyVault .

cloudServiceConfiguration

CloudServiceConfiguration

Konfiguracja usługi w chmurze dla puli.
Ta właściwość i element virtualMachineConfiguration wzajemnie się wykluczają i należy określić jedną z właściwości. Nie można określić tej właściwości, jeśli konto usługi Batch zostało utworzone z jej właściwością poolAllocationMode ustawioną na wartość "UserSubscription".

displayName

string

Nazwa wyświetlana puli.
Nazwa wyświetlana nie musi być unikatowa i może zawierać znaki Unicode o maksymalnej długości 1024.

enableAutoScale

boolean

Określa, czy rozmiar puli powinien być automatycznie dostosowywany w czasie.
Jeśli wartość false, należy określić co najmniej jeden element targetDedicatedNodes i targetLowPriorityNodes. Jeśli wartość true, właściwość autoScaleFormula jest wymagana, a pula automatycznie zmienia rozmiar zgodnie z formułą. Wartość domyślna to false.

enableInterNodeCommunication

boolean

Określa, czy pula zezwala na bezpośrednią komunikację między węzłami obliczeniowymi.
Włączenie komunikacji między węzłami ogranicza maksymalny rozmiar puli z powodu ograniczeń wdrażania w węzłach obliczeniowych puli. Może to spowodować, że pula nie osiągnie żądanego rozmiaru. Wartość domyślna to false.

id

string

Ciąg, który jednoznacznie identyfikuje pulę w ramach konta.
Identyfikator może zawierać dowolną kombinację znaków alfanumerycznych, w tym łączników i podkreśleń, i nie może zawierać więcej niż 64 znaków. Identyfikator jest zachowywany wielkości liter i niewrażliwy na wielkość liter (czyli nie masz dwóch identyfikatorów puli w ramach konta, które różnią się tylko wielkością liter).

metadata

MetadataItem[]

Lista par nazwa-wartość skojarzona z pulą jako metadanymi.
Usługa Batch nie przypisuje żadnego znaczenia do metadanych; jest on przeznaczony wyłącznie do korzystania z kodu użytkownika.

mountConfiguration

MountConfiguration[]

Zainstaluj magazyn przy użyciu określonego systemu plików przez cały okres istnienia puli.
Zainstaluj magazyn przy użyciu udziału plików platformy Azure, systemu plików NFS, CIFS lub Blobfuse opartego na systemie plików.

networkConfiguration

NetworkConfiguration

Konfiguracja sieci dla puli.
Konfiguracja sieci dla puli.

resizeTimeout

string

Limit czasu alokacji węzłów obliczeniowych do puli.
Ten limit czasu dotyczy tylko skalowania ręcznego; nie ma żadnego wpływu, gdy wartość enableAutoScale jest ustawiona na wartość true. Wartość domyślna to 15 minut. Minimalna wartość to 5 minut. Jeśli określisz wartość mniejszą niż 5 minut, usługa Batch zwróci błąd; jeśli bezpośrednio wywołujesz interfejs API REST, kod stanu HTTP to 400 (nieprawidłowe żądanie).

resourceTags

object

Tagi określone przez użytkownika skojarzone z pulą.
Tagi zdefiniowane przez użytkownika do skojarzenia z pulą Azure Batch. Po określeniu te tagi są propagowane do zasobów platformy Azure skojarzonych z pulą. Tę właściwość można określić tylko wtedy, gdy konto usługi Batch zostało utworzone za pomocą właściwości poolAllocationMode ustawionej na wartość "UserSubscription".

startTask

StartTask

Zadanie określone do uruchomienia w każdym węźle obliczeniowym podczas dołączania do puli.
Zadanie jest uruchamiane po dodaniu węzła obliczeniowego do puli lub ponownym uruchomieniu węzła obliczeniowego.

targetDedicatedNodes

integer

Żądana liczba dedykowanych węzłów obliczeniowych w puli.
Nie można określić tej właściwości, jeśli dla właściwości enableAutoScale ustawiono wartość true. Jeśli wartość enableAutoScale jest ustawiona na wartość false, musisz ustawić wartość targetDedicatedNodes, targetLowPriorityNodes lub oba te węzły.

targetLowPriorityNodes

integer

Żądana liczba węzłów obliczeniowych typu spot/low-priority w puli.
Nie można określić tej właściwości, jeśli dla właściwości enableAutoScale ustawiono wartość true. Jeśli wartość enableAutoScale jest ustawiona na wartość false, musisz ustawić wartość targetDedicatedNodes, targetLowPriorityNodes lub oba te węzły.

targetNodeCommunicationMode

NodeCommunicationMode

Żądany tryb komunikacji węzła dla puli.
Jeśli pominięto, wartością domyślną jest Wartość domyślna.

taskSchedulingPolicy

TaskSchedulingPolicy

Jak zadania są dystrybuowane między węzłami obliczeniowymi w puli.
Jeśli nie zostanie określony, wartość domyślna zostanie rozłożona.

taskSlotsPerNode

integer

Liczba miejsc zadań, których można użyć do uruchamiania współbieżnych zadań w jednym węźle obliczeniowym w puli.
Wartość domyślna to 1. Wartość maksymalna jest mniejsza niż 4 razy mniejsza niż liczba rdzeni vmSize puli lub 256.

userAccounts

UserAccount[]

Lista kont użytkowników do utworzenia w każdym węźle obliczeniowym w puli.

virtualMachineConfiguration

VirtualMachineConfiguration

Konfiguracja maszyny wirtualnej dla puli.
Ta właściwość i właściwość cloudServiceConfiguration wzajemnie się wykluczają i należy określić jedną z właściwości.

vmSize

string

Rozmiar maszyn wirtualnych w puli. Wszystkie maszyny wirtualne w puli mają taki sam rozmiar.
Aby uzyskać informacje o dostępnych rozmiarach maszyn wirtualnych dla pul Cloud Services (pule utworzone za pomocą usługi cloudServiceConfiguration), zobacz Rozmiary dla Cloud Services (https://azure.microsoft.com/documentation/articles/cloud-services-sizes-specs/). Usługa Batch obsługuje wszystkie rozmiary maszyn wirtualnych Cloud Services z wyjątkiem ExtraSmall, A1V2 i A2V2. Aby uzyskać informacje o dostępnych rozmiarach maszyn wirtualnych dla pul przy użyciu obrazów z witryny Virtual Machines Marketplace (pule utworzone za pomocą funkcji virtualMachineConfiguration) zobacz Rozmiary dla Virtual Machines (Linux) (https://azure.microsoft.com/documentation/articles/virtual-machines-linux-sizes/) lub Rozmiary dla Virtual Machines (Windows) (https://azure.microsoft.com/documentation/articles/virtual-machines-windows-sizes/). Usługa Batch obsługuje wszystkie rozmiary maszyn wirtualnych platformy Azure z wyjątkiem STANDARD_A0 i z magazynem w warstwie Premium (STANDARD_GS, STANDARD_DS i serii STANDARD_DSV2).

PoolEndpointConfiguration

Konfiguracja punktu końcowego dla puli.

Nazwa Typ Opis
inboundNATPools

InboundNATPool[]

Lista pul nat dla ruchu przychodzącego, których można użyć do adresowania określonych portów w pojedynczym węźle obliczeniowym zewnętrznie.
Maksymalna liczba pul nat dla ruchu przychodzącego na pulę usługi Batch wynosi 5. Jeśli maksymalna liczba pul nat dla ruchu przychodzącego zostanie przekroczona, żądanie zakończy się niepowodzeniem z kodem stanu HTTP 400. Nie można tego określić, jeśli parametr IPAddressProvisioningType ma wartość NoPublicIPAddresses.

PublicIPAddressConfiguration

Konfiguracja publicznego adresu IP konfiguracji sieci puli.

Nazwa Typ Opis
ipAddressIds

string[]

Lista publicznych adresów IP, których usługa Batch będzie używać podczas aprowizacji węzłów obliczeniowych.
Liczba adresów IP określonych w tym miejscu ogranicza maksymalny rozmiar puli — 100 dedykowanych węzłów lub 100 węzłów typu spot/low-priority można przydzielić dla każdego publicznego adresu IP. Na przykład pula, która potrzebuje 250 dedykowanych maszyn wirtualnych, będzie potrzebować co najmniej 3 publicznych adresów IP określonych. Każdy element tej kolekcji ma postać: /subscriptions/{subscription}/resourceGroups/{group}/providers/Microsoft.Network/publicIPAddresses/{ip}.

provision

IPAddressProvisioningType

Typ aprowizacji dla publicznych adresów IP dla puli.
Wartość domyślna to BatchManaged.

ResourceFile

Jeden plik lub wiele plików do pobrania do węzła obliczeniowego.

Nazwa Typ Opis
autoStorageContainerName

string

Nazwa kontenera magazynu na koncie magazynu automatycznego.
Właściwości autoStorageContainerName, storageContainerUrl i httpUrl wzajemnie się wykluczają i należy określić jedną z nich.

blobPrefix

string

Prefiks obiektu blob używany podczas pobierania obiektów blob z kontenera usługi Azure Storage. Zostaną pobrane tylko obiekty blob, których nazwy zaczynają się od określonego prefiksu.
Właściwość jest prawidłowa tylko wtedy, gdy jest używana właściwość autoStorageContainerName lub storageContainerUrl. Ten prefiks może być częściową nazwą pliku lub podkatalogem. Jeśli prefiks nie zostanie określony, wszystkie pliki w kontenerze zostaną pobrane.

fileMode

string

Atrybut trybu uprawnień pliku w formacie ósemkowym.
Ta właściwość ma zastosowanie tylko do plików pobieranych do węzłów obliczeniowych systemu Linux. Zostanie on zignorowany, jeśli zostanie określony dla pliku resourceFile, który zostanie pobrany do węzła obliczeniowego systemu Windows. Jeśli ta właściwość nie zostanie określona dla węzła obliczeniowego systemu Linux, do pliku zostanie zastosowana wartość domyślna 0770.

filePath

string

Lokalizacja węzła obliczeniowego, do którego mają być pobierane pliki względem katalogu roboczego zadania.
Jeśli właściwość httpUrl jest określona, parametr filePath jest wymagany i opisuje ścieżkę, do której zostanie pobrany plik, w tym nazwę pliku. W przeciwnym razie, jeśli określono właściwość autoStorageContainerName lub storageContainerUrl, parametr filePath jest opcjonalny i jest katalogem do pobrania plików. W przypadku, gdy plikPath jest używany jako katalog, każda struktura katalogów już skojarzona z danymi wejściowymi zostanie zachowana w całości i dołączona do określonego katalogu filePath. Określona ścieżka względna nie może wyprzeć katalogu roboczego zadania (na przykład przy użyciu polecenia ".".

httpUrl

string

Adres URL pliku do pobrania.
Właściwości autoStorageContainerName, storageContainerUrl i httpUrl wzajemnie się wykluczają i należy określić jedną z nich. Jeśli adres URL wskazuje Azure Blob Storage, musi być czytelny z węzłów obliczeniowych. Istnieją trzy sposoby uzyskania takiego adresu URL dla obiektu blob w usłudze Azure Storage: obejmują sygnaturę dostępu współdzielonego udzielając uprawnień do odczytu w obiekcie blob, użyć tożsamości zarządzanej z uprawnieniem do odczytu lub ustawić listę ACL dla obiektu blob lub kontenera, aby zezwolić na dostęp publiczny.

identityReference

ComputeNodeIdentityReference

Odwołanie do tożsamości przypisanej przez użytkownika do użycia w celu uzyskania dostępu do Azure Blob Storage określonego przez storageContainerUrl lub httpUrl
Odwołanie do tożsamości przypisanej przez użytkownika skojarzonej z pulą usługi Batch, której będzie używać węzeł obliczeniowy.

storageContainerUrl

string

Adres URL kontenera obiektów blob w Azure Blob Storage.
Właściwości autoStorageContainerName, storageContainerUrl i httpUrl wzajemnie się wykluczają i należy określić jedną z nich. Ten adres URL musi być czytelny i możliwy do wyświetlenia z węzłów obliczeniowych. Istnieją trzy sposoby uzyskiwania takiego adresu URL dla kontenera w usłudze Azure Storage: obejmują sygnaturę dostępu współdzielonego udzielając uprawnień do odczytu i listy w kontenerze, używanie tożsamości zarządzanej z uprawnieniami do odczytu i listy lub ustawienie listy ACL dla kontenera, aby zezwolić na dostęp publiczny.

SecurityProfile

Określa ustawienia profilu zabezpieczeń dla maszyny wirtualnej lub zestawu skalowania maszyn wirtualnych.

Nazwa Typ Opis
encryptionAtHost

boolean

Ta właściwość może być używana przez użytkownika w żądaniu włączenia lub wyłączenia szyfrowania hosta dla maszyny wirtualnej lub zestawu skalowania maszyn wirtualnych. Spowoduje to włączenie szyfrowania dla wszystkich dysków, w tym dysku zasobu/tempa na samym hoście.

securityType

SecurityTypes

Określa typ zabezpieczeń maszyny wirtualnej. Musi być ustawiona na dowolną określoną wartość, aby włączyć funkcję UefiSettings.

uefiSettings

UefiSettings

Określa ustawienia zabezpieczeń, takie jak bezpieczny rozruch i vTPM używane podczas tworzenia maszyny wirtualnej.
Określa ustawienia zabezpieczeń, takie jak bezpieczny rozruch i vTPM używane podczas tworzenia maszyny wirtualnej.

SecurityTypes

Określa typ zabezpieczeń maszyny wirtualnej. Należy ustawić ją na dowolną określoną wartość, aby włączyć funkcję UefiSettings.

Nazwa Typ Opis
trustedLaunch

string

Zaufane uruchamianie chroni przed zaawansowanymi i trwałymi technikami ataków.

ServiceArtifactReference

Określa identyfikator odwołania artefaktu usługi używany do ustawiania tej samej wersji obrazu dla wszystkich maszyn wirtualnych w zestawie skalowania podczas korzystania z wersji obrazu "latest".

Nazwa Typ Opis
id

string

Identyfikator odwołania do artefaktu usługi serviceArtifactReference
Identyfikator odwołania artefaktu usługi w postaci /subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Compute/gallerys/{galleryName}/serviceArtifacts/{serviceArtifactName}/vmArtifactsProfiles/{vmArtifactsProfilesName}

StartTask

Zadanie uruchamiane po dołączeniu węzła do puli w usłudze Azure Batch lub po ponownym uruchomieniu lub ponownym uruchomieniu węzła obliczeniowego lub ponownym obrazie.

Nazwa Typ Opis
commandLine

string

Wiersz polecenia starttask.
Wiersz polecenia nie jest uruchamiany w powłoce i dlatego nie może korzystać z funkcji powłoki, takich jak rozszerzanie zmiennych środowiskowych. Jeśli chcesz korzystać z takich funkcji, należy wywołać powłokę w wierszu polecenia, na przykład za pomocą polecenia "cmd /c MyCommand" w systemie Windows lub "/bin/sh -c MyCommand" w systemie Linux. Jeśli wiersz polecenia odwołuje się do ścieżek plików, powinien użyć ścieżki względnej (względnej względem katalogu roboczego zadania) lub użyć zmiennej środowiskowej udostępnionej w usłudze Batch (https://docs.microsoft.com/en-us/azure/batch/batch-compute-node-environment-variables).

containerSettings

TaskContainerSettings

Ustawienia kontenera, w którym jest uruchamiana funkcja StartTask.
Po określeniu tego ustawienia wszystkie katalogi cyklicznie poniżej AZ_BATCH_NODE_ROOT_DIR (katalog główny katalogów Azure Batch w węźle) są mapowane do kontenera, wszystkie zmienne środowiskowe zadania są mapowane do kontenera, a wiersz polecenia zadania jest wykonywany w kontenerze. Pliki utworzone w kontenerze poza AZ_BATCH_NODE_ROOT_DIR mogą nie zostać odzwierciedlone na dysku hosta, co oznacza, że interfejsy API plików usługi Batch nie będą mogły uzyskać dostępu do tych plików.

environmentSettings

EnvironmentSetting[]

Lista ustawień zmiennych środowiskowych dla elementu StartTask.

maxTaskRetryCount

integer

Maksymalna liczba ponownych prób wykonania zadania.
Usługa Batch ponawia próbę zadania, jeśli jego kod zakończenia jest niezerowy. Należy pamiętać, że ta wartość określa w szczególności liczbę ponownych prób. Usługa Batch spróbuje raz wykonać zadanie, a następnie może ponowić próbę do tego limitu. Jeśli na przykład maksymalna liczba ponownych prób wynosi 3, usługa Batch próbuje wykonać zadanie maksymalnie 4 razy (jedna początkowa próba i 3 ponownych prób). Jeśli maksymalna liczba ponownych prób wynosi 0, usługa Batch nie ponowi próby wykonania zadania. Jeśli maksymalna liczba ponownych prób wynosi -1, usługa Batch ponawia próbę zadania bez limitu, jednak nie jest to zalecane w przypadku zadania podrzędnego uruchamiania ani żadnego zadania podrzędnego. Wartość domyślna to 0 (brak ponownych prób).

resourceFiles

ResourceFile[]

Lista plików, które usługa Batch pobierze do węzła obliczeniowego przed uruchomieniem wiersza polecenia. Istnieje maksymalny rozmiar listy plików zasobów. Po przekroczeniu maksymalnego rozmiaru żądanie zakończy się niepowodzeniem, a kod błędu odpowiedzi to RequestEntityTooLarge. W takim przypadku należy zmniejszyć rozmiar kolekcji ResourceFiles. Można to osiągnąć przy użyciu plików .zip, pakietów aplikacji lub kontenerów platformy Docker.
Pliki wymienione w tym elemecie znajdują się w katalogu roboczym zadania.

userIdentity

UserIdentity

Tożsamość użytkownika, w ramach której jest uruchamiana funkcja StartTask.
W przypadku pominięcia zadanie jest uruchamiane jako użytkownik niebędący administratorem unikatowym dla zadania.

waitForSuccess

boolean

Określa, czy usługa Batch powinna czekać na pomyślne zakończenie zadania StartTask (czyli zakończenie pracy z kodem zakończenia 0) przed zaplanowaniem jakichkolwiek zadań w węźle obliczeniowym.
Jeśli wartość true i zadanie StartTask zakończy się niepowodzeniem w węźle, usługa Batch ponawia próbę uruchomienia do maksymalnej liczby ponownych prób (maxTaskRetryCount). Jeśli zadanie nadal nie zostało ukończone pomyślnie po wszystkich ponownych próbach, usługa Batch oznacza węzeł bezużyteczny i nie będzie planować zadań do niego. Ten warunek można wykryć za pośrednictwem szczegółów stanu węzła obliczeniowego i informacji o błędzie. Jeśli wartość false, usługa Batch nie będzie czekać na ukończenie polecenia StartTask. W takim przypadku inne zadania mogą rozpocząć wykonywanie w węźle obliczeniowym, gdy zadanie StartTask jest nadal uruchomione; a nawet jeśli zadanie StartTask zakończy się niepowodzeniem, nowe zadania będą nadal zaplanowane w węźle obliczeniowym. Wartość domyślna to true.

StorageAccountType

Typ konta magazynu do użycia podczas tworzenia dysków danych lub dysku systemu operacyjnego.

Nazwa Typ Opis
premium_lrs

string

Dysk danych/dysk systemu operacyjnego powinien używać magazynu lokalnie nadmiarowego w warstwie Premium.

standard_lrs

string

Dysk danych/dysk systemu operacyjnego powinien używać standardowego magazynu lokalnie nadmiarowego.

standardssd_lrs

string

Dysk danych/dysk systemu operacyjnego powinien używać magazynu lokalnie nadmiarowego SSD w warstwie Standardowa.

TaskContainerSettings

Ustawienia kontenera dla zadania.

Nazwa Typ Opis
containerRunOptions

string

Dodatkowe opcje polecenia tworzenia kontenera.
Te dodatkowe opcje są dostarczane jako argumenty polecenia "docker create" oprócz tych kontrolowanych przez usługę Batch.

imageName

string

Obraz używany do utworzenia kontenera, w którym zostanie uruchomione zadanie.
Jest to pełne odwołanie do obrazu, które zostanie określone jako "ściąganie platformy Docker". Jeśli żaden tag nie zostanie podany jako część nazwy obrazu, tag ":latest" jest używany jako domyślny.

registry

ContainerRegistry

Rejestr prywatny zawierający obraz kontenera.
To ustawienie można pominąć, jeśli zostało już udostępnione podczas tworzenia puli.

workingDirectory

ContainerWorkingDirectory

Lokalizacja katalogu roboczego zadania kontenera.
Wartość domyślna to "taskWorkingDirectory".

TaskSchedulingPolicy

Określa sposób dystrybucji zadań między węzłami obliczeniowymi.

Nazwa Typ Opis
nodeFillType

ComputeNodeFillType

Sposób dystrybucji zadań między węzłami obliczeniowymi w puli.
Jeśli nie zostanie określony, wartość domyślna zostanie rozłożona.

UefiSettings

Określa ustawienia zabezpieczeń, takie jak bezpieczny rozruch i vTPM używane podczas tworzenia maszyny wirtualnej.

Nazwa Typ Opis
secureBootEnabled

boolean

Określa, czy bezpieczny rozruch powinien być włączony na maszynie wirtualnej.

vTpmEnabled

boolean

Określa, czy na maszynie wirtualnej ma być włączona maszyna wirtualna vTPM.

UserAccount

Właściwości używane do tworzenia użytkownika używanego do wykonywania zadań w węźle obliczeniowym Azure Batch.

Nazwa Typ Opis
elevationLevel

ElevationLevel

Poziom podniesienia uprawnień konta użytkownika.
Wartość domyślna to nonAdmin.

linuxUserConfiguration

LinuxUserConfiguration

Konfiguracja użytkownika specyficzna dla systemu Linux dla konta użytkownika.
Ta właściwość jest ignorowana, jeśli została określona w puli systemu Windows. Jeśli nie zostanie określony, użytkownik zostanie utworzony z opcjami domyślnymi.

name

string

Nazwa konta użytkownika. Nazwy mogą zawierać dowolne znaki Unicode do maksymalnej długości 20.

password

string

Hasło dla konta użytkownika.

windowsUserConfiguration

WindowsUserConfiguration

Konfiguracja użytkownika specyficzna dla systemu Windows dla konta użytkownika.
Tę właściwość można określić tylko wtedy, gdy użytkownik znajduje się w puli systemu Windows. Jeśli nie określono wartości i w puli systemu Windows, użytkownik zostanie utworzony z opcjami domyślnymi.

UserIdentity

Definicja tożsamości użytkownika, w ramach której jest uruchamiane zadanie.

Nazwa Typ Opis
autoUser

AutoUserSpecification

Użytkownik automatyczny, w ramach którego jest uruchamiane zadanie.
Właściwości userName i autoUser wzajemnie się wykluczają; Musisz określić jeden, ale nie oba.

username

string

Nazwa tożsamości użytkownika, w ramach której jest uruchamiane zadanie.
Właściwości userName i autoUser wzajemnie się wykluczają; Musisz określić jeden, ale nie oba.

VirtualMachineConfiguration

Konfiguracja węzłów obliczeniowych w puli na podstawie infrastruktury usługi Azure Virtual Machines.

Nazwa Typ Opis
containerConfiguration

ContainerConfiguration

Konfiguracja kontenera dla puli.
Jeśli zostanie określony, konfiguracja jest wykonywana na każdym węźle obliczeniowym w puli, aby umożliwić uruchamianie zadań w kontenerach. Wszystkie zwykłe zadania i zadania podrzędne menedżera zadań są uruchamiane w tej puli, muszą określać właściwość containerSettings, a wszystkie inne zadania mogą je określać.

dataDisks

DataDisk[]

Konfiguracja dysków danych dołączonych do węzłów obliczeniowych w puli.
Tę właściwość należy określić, jeśli węzły obliczeniowe w puli muszą mieć dołączone do nich puste dyski danych. Nie można tego zaktualizować. Każdy węzeł obliczeniowy pobiera własny dysk (dysk nie jest udziałem plików). Nie można dołączyć istniejących dysków. Każdy dołączony dysk jest pusty. Po usunięciu węzła obliczeniowego z puli dysk i wszystkie skojarzone z nim dane również zostaną usunięte. Dysk nie jest sformatowany po dołączeniu, należy go sformatować przed użyciem — aby uzyskać więcej informacji, zobacz https://docs.microsoft.com/en-us/azure/virtual-machines/linux/classic/attach-disk#initialize-a-new-data-disk-in-linux i https://docs.microsoft.com/en-us/azure/virtual-machines/windows/attach-disk-ps#add-an-empty-data-disk-to-a-virtual-machine.

diskEncryptionConfiguration

DiskEncryptionConfiguration

Konfiguracja szyfrowania dysków dla puli.
W przypadku określenia szyfrowanie jest wykonywane na każdym węźle w puli podczas aprowizacji węzła.

extensions

VMExtension[]

Rozszerzenie maszyny wirtualnej dla puli.
Jeśli zostanie określony, rozszerzenia wymienione w tej konfiguracji zostaną zainstalowane na każdym węźle.

imageReference

ImageReference

Odwołanie do obrazu witryny Azure Virtual Machines Marketplace lub niestandardowego obrazu maszyny wirtualnej do użycia.

licenseType

string

Typ licencji lokalnej, która ma być używana podczas wdrażania systemu operacyjnego.
Dotyczy to tylko obrazów, które zawierają system operacyjny Windows i powinny być używane tylko w przypadku przechowywania prawidłowych licencji lokalnych dla węzłów obliczeniowych, które zostaną wdrożone. W przypadku pominięcia nie zastosowano rabatu na licencjonowanie lokalne. Wartości to:

Windows_Server — licencja lokalna dotyczy systemu Windows Server. Windows_Client — licencja lokalna jest dla klienta systemu Windows.

nodeAgentSKUId

string

Jednostka SKU agenta węzła obliczeniowego usługi Batch, która ma być aprowizowana w węzłach obliczeniowych w puli.
Agent węzła obliczeniowego usługi Batch to program, który działa w każdym węźle obliczeniowym w puli i udostępnia interfejs sterowania między węzłem obliczeniowym a usługą Batch. Istnieją różne implementacje agenta węzła obliczeniowego, nazywanego jednostkami SKU, dla różnych systemów operacyjnych. Należy określić jednostkę SKU agenta węzła obliczeniowego zgodną z wybranym odwołaniem do obrazu. Aby uzyskać listę obsługiwanych jednostek SKU agenta węzła obliczeniowego wraz z listą zweryfikowanych odwołań do obrazów, zobacz operację "Lista obsługiwanych jednostek SKU agenta węzła obliczeniowego".

nodePlacementConfiguration

NodePlacementConfiguration

Konfiguracja umieszczania węzłów dla puli.
Ta konfiguracja określi reguły dotyczące fizycznego przydzielania węzłów w puli.

osDisk

OSDisk

Ustawienia dysku systemu operacyjnego maszyny wirtualnej.

securityProfile

SecurityProfile

Określa ustawienia profilu zabezpieczeń dla maszyny wirtualnej lub zestawu skalowania maszyn wirtualnych.
Określa ustawienia profilu zabezpieczeń dla maszyny wirtualnej lub zestawu skalowania maszyn wirtualnych.

serviceArtifactReference

ServiceArtifactReference

Określa identyfikator odwołania do artefaktu usługi używany do ustawiania tej samej wersji obrazu dla wszystkich maszyn wirtualnych w zestawie skalowania w przypadku używania "najnowszej" wersji obrazu.
Identyfikator odwołania do artefaktu usługi w postaci /subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Compute/galleries/{galleryName}/serviceArtifacts/{serviceArtifactName}/vmArtifactsProfiles/{vmArtifactsProfilesName}

windowsConfiguration

WindowsConfiguration

Ustawienia systemu operacyjnego Windows na maszynie wirtualnej.
Nie można określić tej właściwości, jeśli właściwość imageReference określa obraz systemu operacyjnego Linux.

VMExtension

Konfiguracja rozszerzeń maszyn wirtualnych.

Nazwa Typ Opis
autoUpgradeMinorVersion

boolean

Wskazuje, czy rozszerzenie powinno używać nowszej wersji pomocniczej, jeśli jest ona dostępna w czasie wdrażania. Po wdrożeniu rozszerzenie nie uaktualni wersji pomocniczych, chyba że zostanie ponownie wdrożone, nawet jeśli ta właściwość ma wartość true.

enableAutomaticUpgrade

boolean

Wskazuje, czy rozszerzenie powinno zostać automatycznie uaktualnione przez platformę, jeśli jest dostępna nowsza wersja rozszerzenia.

name

string

Nazwa rozszerzenia maszyny wirtualnej.

protectedSettings

object

Rozszerzenie może zawierać ustawienia protectedSettings lub protectedSettingsFromKeyVault lub w ogóle nie są chronione.

provisionAfterExtensions

string[]

Kolekcja nazw rozszerzeń.
Kolekcja nazw rozszerzeń, po których należy aprowizować to rozszerzenie.

publisher

string

Nazwa wydawcy programu obsługi rozszerzeń.

settings

object

Ustawienia publiczne w formacie JSON dla rozszerzenia.

type

string

Typ rozszerzenia.

typeHandlerVersion

string

Wersja programu obsługi skryptów.

WindowsConfiguration

Ustawienia systemu operacyjnego Windows, które mają być stosowane do maszyny wirtualnej.

Nazwa Typ Opis
enableAutomaticUpdates

boolean

Określa, czy aktualizacje automatyczne są włączone na maszynie wirtualnej.
W przypadku pominięcia wartość domyślna to true.

WindowsUserConfiguration

Właściwości używane do tworzenia konta użytkownika w węźle obliczeniowym systemu Windows.

Nazwa Typ Opis
loginMode

LoginMode

Tryb logowania użytkownika
Wartość domyślna dla pul VirtualMachineConfiguration to "batch", a w przypadku pul CloudServiceConfiguration to "interactive".