Pool - Create

Usługa:

Batch Management

Wersja API:

2024-07-01

Tworzy nową pulę wewnątrz określonego konta.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Batch/batchAccounts/{accountName}/pools/{poolName}?api-version=2024-07-01

Parametry URI

Nazwa	W	Wymagane	Typ	Opis
accountName	path	True	string minLength: 3 maxLength: 24 pattern: ^[a-zA-Z0-9]+$	Nazwa konta wsadowego, która musi być unikalna w danym regionie. Nazwy kont wsadowych muszą mieć długość od 3 do 24 znaków i zawierać jedynie cyfry oraz małe litery. Ta nazwa jest używana jako część nazwy DNS, która służy do dostępu do usługi Batch w regionie, w którym konto zostało utworzone. Na przykład: http://accountname.region.batch.azure.com/.
poolName	path	True	string minLength: 1 maxLength: 64 pattern: ^[a-zA-Z0-9_-]+$	Nazwa puli. Musi to być unikatowe w ramach konta.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Nazwa grupy zasobów. Nazwa jest niewrażliwa na wielkość liter.
subscriptionId	path	True	string (uuid)	Identyfikator subskrypcji docelowej. Wartość musi być identyfikatorem UUID.
api-version	query	True	string minLength: 1	Wersja interfejsu API do użycia dla tej operacji.

Nagłówek żądania

Nazwa	Wymagane	Typ	Opis
If-Match		string	Wersja stanu jednostki (ETag) puli do zaktualizowania. Wartość "*" może służyć do zastosowania operacji tylko wtedy, gdy pula już istnieje. W przypadku pominięcia ta operacja będzie zawsze stosowana.
If-None-Match		string	Ustaw wartość "*", aby zezwolić na utworzenie nowej puli, ale aby zapobiec aktualizowaniu istniejącej puli. Inne wartości zostaną zignorowane.

Ciało żądania

Nazwa	Typ	Opis
identity	BatchPoolIdentity	Typ tożsamości używany dla puli usługi Batch.
properties.applicationLicenses	string[]	Lista licencji aplikacji, które usługa Batch udostępni 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.
properties.applicationPackages	ApplicationPackageReference[]	Lista pakietów aplikacji do zainstalowania w każdym węźle obliczeniowym w puli. Zmiany odwołań do pakietu aplikacji mają wpływ na wszystkie nowe węzły obliczeniowe łą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 z obrazu. W dowolnej puli istnieje maksymalnie 10 odwołań do pakietu aplikacji.
properties.certificates	CertificateReference[]	Lista certyfikatów do zainstalowania w każdym węźle obliczeniowym w puli. W przypadku węzłów obliczeniowych 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.
properties.deploymentConfiguration	DeploymentConfiguration	Ta właściwość opisuje maszyny wirtualne, na których będą wdrażane węzły puli. Właściwości konfiguracji wdrożenia.
properties.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.
properties.interNodeCommunication	InterNodeCommunicationState	Określa, czy pula zezwala na bezpośrednią komunikację między węzłami. Nakłada to ograniczenia dotyczące węzłów, które można przypisać do puli. Włączenie tej wartości może zmniejszyć prawdopodobieństwo przydzielenia żądanej liczby węzłów w puli. Jeśli nie zostanie określona, ta wartość jest domyślnie ustawiona na wartość "Wyłączone".
properties.metadata	MetadataItem[]	Lista par name-value skojarzonych z pulą jako metadanych. Usługa Batch nie przypisuje żadnego znaczenia metadanym; służy wyłącznie do używania kodu użytkownika.
properties.mountConfiguration	MountConfiguration[]	Lista systemów plików do zainstalowania w każdym węźle w puli. Obsługuje to usługi Azure Files, NFS, CIFS/SMB i Blobfuse.
properties.networkConfiguration	NetworkConfiguration	Konfiguracja sieci dla puli. Konfiguracja sieci dla puli.
properties.resourceTags	object	Tagi określone przez użytkownika skojarzone z pulą. Tagi zdefiniowane przez użytkownika, które mają być skojarzone z pulą usługi 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".
properties.scaleSettings	ScaleSettings	Ustawienia, które konfigurują liczbę węzłów w puli. Definiuje żądany rozmiar puli. Może to być wartość "fixedScale", w której określono żądany element targetDedicatedNodes lub "autoScale", który definiuje formułę, która jest okresowo ponownie obliczana. Jeśli ta właściwość nie zostanie określona, pula będzie mieć stałą skalę z 0 targetDedicatedNodes.
properties.startTask	StartTask	Zadanie określone do uruchomienia w każdym węźle obliczeniowym podczas dołączania do puli. W operacji PATCH (update) tę właściwość można ustawić na pusty obiekt, aby usunąć zadanie uruchamiania z puli.
properties.targetNodeCommunicationMode	NodeCommunicationMode	Określa, jak pula komunikuje się z usługą Batch. W przypadku pominięcia wartość domyślna to Wartość domyślna.
properties.taskSchedulingPolicy	TaskSchedulingPolicy	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.
properties.taskSlotsPerNode	integer (int32)	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 od 4 razy liczbie rdzeni rozmiaru maszyny wirtualnej puli lub 256.
properties.upgradePolicy	UpgradePolicy	Zasady uaktualniania puli. Opisuje zasady uaktualniania — automatyczne, ręczne lub stopniowe.
properties.userAccounts	UserAccount[]	Lista kont użytkowników do utworzenia w każdym węźle w puli.
properties.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, zobacz Rozmiary maszyn wirtualnych na platformie Azure (https://learn.microsoft.com/azure/virtual-machines/sizes/overview). 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).
tags	object	Tagi zasobu.

Odpowiedzi

Nazwa	Typ	Opis
200 OK	Pool	Żądanie zakończyło się pomyślnie. Nagłówki ETag: string
Other Status Codes	CloudError	Nieoczekiwana odpowiedź na błąd.

Zabezpieczenia

azure_auth

Przepływ OAuth2 w usłudze Azure Active Directory.

Typ: oauth2
Flow: implicit
URL autoryzacji: https://login.microsoftonline.com/common/oauth2/authorize

Zakresów

Nazwa	Opis
user_impersonation	personifikacja konta użytkownika

Przykłady

CreatePool - accelerated networking

CreatePool - Custom Image

CreatePool - Full VirtualMachineConfiguration

CreatePool - Minimal VirtualMachineConfiguration

CreatePool - No public IP

CreatePool - Public IPs

CreatePool - ResourceTags

CreatePool - SecurityProfile

CreatePool - Tags

CreatePool - UpgradePolicy

CreatePool - UserAssignedIdentities

CreatePool - VirtualMachineConfiguration Extensions

CreatePool - VirtualMachineConfiguration OSDisk

CreatePool - VirtualMachineConfiguration ServiceArtifactReference

CreatePool - accelerated networking

Przykładowa prośba

HTTP

PUT https://management.azure.com/subscriptions/12345678-1234-1234-1234-123456789012/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Batch/batchAccounts/sampleacct/pools/testpool?api-version=2024-07-01

{
  "properties": {
    "deploymentConfiguration": {
      "virtualMachineConfiguration": {
        "imageReference": {
          "offer": "WindowsServer",
          "publisher": "MicrosoftWindowsServer",
          "sku": "2016-datacenter-smalldisk",
          "version": "latest"
        },
        "nodeAgentSkuId": "batch.node.windows amd64"
      }
    },
    "networkConfiguration": {
      "enableAcceleratedNetworking": true,
      "subnetId": "/subscriptions/12345678-1234-1234-1234-123456789012/resourceGroups/rg1234/providers/Microsoft.Network/virtualNetworks/network1234/subnets/subnet123"
    },
    "scaleSettings": {
      "fixedScale": {
        "targetDedicatedNodes": 1,
        "targetLowPriorityNodes": 0
      }
    },
    "vmSize": "STANDARD_D1_V2"
  }
}

Przykładowa odpowiedź

Kod statusu:

200

ETag: W/"0x8DB46CB72A227E2"

{
  "name": "testpool",
  "type": "Microsoft.Batch/batchAccounts/pools",
  "id": "/subscriptions/12345678-1234-1234-1234-123456789012/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Batch/batchAccounts/sampleacct/pools/testpool",
  "properties": {
    "allocationState": "Steady",
    "allocationStateTransitionTime": "2023-04-27T03:00:34.0646502Z",
    "creationTime": "2023-04-27T02:59:41.8592226Z",
    "currentDedicatedNodes": 1,
    "currentLowPriorityNodes": 0,
    "currentNodeCommunicationMode": "Classic",
    "deploymentConfiguration": {
      "virtualMachineConfiguration": {
        "imageReference": {
          "offer": "WindowsServer",
          "publisher": "MicrosoftWindowsServer",
          "sku": "2016-datacenter-smalldisk",
          "version": "latest"
        },
        "nodeAgentSkuId": "batch.node.windows amd64"
      }
    },
    "interNodeCommunication": "Disabled",
    "lastModified": "2023-04-27T02:59:41.8592226Z",
    "networkConfiguration": {
      "dynamicVnetAssignmentScope": "none",
      "enableAcceleratedNetworking": true,
      "subnetId": "/subscriptions/12345678-1234-1234-1234-123456789012/resourceGroups/rg1234/providers/Microsoft.Network/virtualNetworks/network1234/subnets/subnet123"
    },
    "provisioningState": "Succeeded",
    "provisioningStateTransitionTime": "2023-04-27T02:59:41.8592226Z",
    "resizeOperationStatus": {
      "nodeDeallocationOption": "Requeue",
      "resizeTimeout": "PT15M",
      "startTime": "2023-04-27T02:59:41.8592226Z",
      "targetDedicatedNodes": 1
    },
    "scaleSettings": {
      "fixedScale": {
        "resizeTimeout": "PT15M",
        "targetDedicatedNodes": 1,
        "targetLowPriorityNodes": 0
      }
    },
    "taskSchedulingPolicy": {
      "nodeFillType": "Spread"
    },
    "taskSlotsPerNode": 1,
    "vmSize": "STANDARD_D1_V2"
  }
}

CreatePool - Custom Image

Przykładowa prośba

HTTP

PUT https://management.azure.com/subscriptions/12345678-1234-1234-1234-123456789012/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Batch/batchAccounts/sampleacct/pools/testpool?api-version=2024-07-01

{
  "properties": {
    "deploymentConfiguration": {
      "virtualMachineConfiguration": {
        "imageReference": {
          "id": "/subscriptions/12345678-1234-1234-1234-123456789012/resourceGroups/networking-group/providers/Microsoft.Compute/galleries/testgallery/images/testimagedef/versions/0.0.1"
        },
        "nodeAgentSkuId": "batch.node.ubuntu 18.04"
      }
    },
    "vmSize": "STANDARD_D4"
  }
}

Przykładowa odpowiedź

Kod statusu:

200

ETag: W/"0x8D4EDFEBFADF4AB"

{
  "name": "testpool",
  "type": "Microsoft.Batch/batchAccounts/pools",
  "id": "/subscriptions/12345678-1234-1234-1234-123456789012/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Batch/batchAccounts/sampleacct/pools/testpool",
  "properties": {
    "allocationState": "Steady",
    "allocationStateTransitionTime": "2017-08-28T10:22:55.9407275Z",
    "creationTime": "2017-08-28T10:22:55.9407275Z",
    "currentDedicatedNodes": 0,
    "currentLowPriorityNodes": 0,
    "deploymentConfiguration": {
      "virtualMachineConfiguration": {
        "imageReference": {
          "id": "/subscriptions/12345678-1234-1234-1234-123456789012/resourceGroups/networking-group/providers/Microsoft.Compute/galleries/testgallery/images/testimagedef/versions/0.0.1"
        },
        "nodeAgentSkuId": "batch.node.ubuntu 18.04"
      }
    },
    "interNodeCommunication": "Disabled",
    "lastModified": "2017-08-28T10:22:55.9407275Z",
    "provisioningState": "Succeeded",
    "provisioningStateTransitionTime": "2017-08-28T10:22:55.9407275Z",
    "scaleSettings": {
      "fixedScale": {
        "targetDedicatedNodes": 0,
        "targetLowPriorityNodes": 0
      }
    },
    "taskSchedulingPolicy": {
      "nodeFillType": "Spread"
    },
    "taskSlotsPerNode": 1,
    "vmSize": "STANDARD_D4"
  }
}

CreatePool - Full VirtualMachineConfiguration

Przykładowa prośba

HTTP

PUT https://management.azure.com/subscriptions/12345678-1234-1234-1234-123456789012/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Batch/batchAccounts/sampleacct/pools/testpool?api-version=2024-07-01

{
  "properties": {
    "deploymentConfiguration": {
      "virtualMachineConfiguration": {
        "dataDisks": [
          {
            "caching": "ReadWrite",
            "diskSizeGB": 30,
            "lun": 0,
            "storageAccountType": "Premium_LRS"
          },
          {
            "caching": "None",
            "diskSizeGB": 200,
            "lun": 1,
            "storageAccountType": "Standard_LRS"
          }
        ],
        "diskEncryptionConfiguration": {
          "targets": [
            "OsDisk",
            "TemporaryDisk"
          ]
        },
        "imageReference": {
          "offer": "WindowsServer",
          "publisher": "MicrosoftWindowsServer",
          "sku": "2016-Datacenter-SmallDisk",
          "version": "latest"
        },
        "licenseType": "Windows_Server",
        "nodeAgentSkuId": "batch.node.windows amd64",
        "nodePlacementConfiguration": {
          "policy": "Zonal"
        },
        "osDisk": {
          "ephemeralOSDiskSettings": {
            "placement": "CacheDisk"
          }
        },
        "windowsConfiguration": {
          "enableAutomaticUpdates": false
        }
      }
    },
    "networkConfiguration": {
      "endpointConfiguration": {
        "inboundNatPools": [
          {
            "name": "testnat",
            "backendPort": 12001,
            "frontendPortRangeEnd": 15100,
            "frontendPortRangeStart": 15000,
            "networkSecurityGroupRules": [
              {
                "access": "Allow",
                "priority": 150,
                "sourceAddressPrefix": "192.100.12.45",
                "sourcePortRanges": [
                  "1",
                  "2"
                ]
              },
              {
                "access": "Deny",
                "priority": 3500,
                "sourceAddressPrefix": "*",
                "sourcePortRanges": [
                  "*"
                ]
              }
            ],
            "protocol": "TCP"
          }
        ]
      }
    },
    "scaleSettings": {
      "autoScale": {
        "evaluationInterval": "PT5M",
        "formula": "$TargetDedicatedNodes=1"
      }
    },
    "vmSize": "STANDARD_D4"
  }
}

Przykładowa odpowiedź

Kod statusu:

200

ETag: W/"0x8D4EDFEBFADF4AB"

{
  "name": "testpool",
  "type": "Microsoft.Batch/batchAccounts/pools",
  "id": "/subscriptions/12345678-1234-1234-1234-123456789012/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Batch/batchAccounts/sampleacct/pools/testpool",
  "properties": {
    "allocationState": "Resizing",
    "allocationStateTransitionTime": "2017-08-28T10:22:55.9407275Z",
    "creationTime": "2017-08-28T10:22:55.9407275Z",
    "currentDedicatedNodes": 0,
    "currentLowPriorityNodes": 0,
    "deploymentConfiguration": {
      "virtualMachineConfiguration": {
        "dataDisks": [
          {
            "caching": "ReadWrite",
            "diskSizeGB": 30,
            "lun": 0,
            "storageAccountType": "Premium_LRS"
          },
          {
            "caching": "None",
            "diskSizeGB": 200,
            "lun": 1,
            "storageAccountType": "Standard_LRS"
          }
        ],
        "diskEncryptionConfiguration": {
          "targets": [
            "OsDisk",
            "TemporaryDisk"
          ]
        },
        "imageReference": {
          "offer": "WindowsServer",
          "publisher": "MicrosoftWindowsServer",
          "sku": "2016-Datacenter-SmallDisk",
          "version": "latest"
        },
        "licenseType": "Windows_Server",
        "nodeAgentSkuId": "batch.node.windows amd64",
        "nodePlacementConfiguration": {
          "policy": "Zonal"
        },
        "windowsConfiguration": {
          "enableAutomaticUpdates": false
        }
      }
    },
    "interNodeCommunication": "Disabled",
    "lastModified": "2017-08-28T10:22:55.9407275Z",
    "networkConfiguration": {
      "endpointConfiguration": {
        "inboundNatPools": [
          {
            "name": "testnat",
            "backendPort": 12001,
            "frontendPortRangeEnd": 15100,
            "frontendPortRangeStart": 15000,
            "networkSecurityGroupRules": [
              {
                "access": "Allow",
                "priority": 150,
                "sourceAddressPrefix": "192.100.12.45",
                "sourcePortRanges": [
                  "1",
                  "2"
                ]
              },
              {
                "access": "Deny",
                "priority": 3500,
                "sourceAddressPrefix": "*",
                "sourcePortRanges": [
                  "*"
                ]
              }
            ],
            "protocol": "TCP"
          }
        ]
      }
    },
    "provisioningState": "Succeeded",
    "provisioningStateTransitionTime": "2017-08-28T10:22:55.9407275Z",
    "scaleSettings": {
      "autoScale": {
        "evaluationInterval": "PT5M",
        "formula": "$TargetDedicatedNodes=1"
      }
    },
    "taskSchedulingPolicy": {
      "nodeFillType": "Spread"
    },
    "taskSlotsPerNode": 1,
    "vmSize": "STANDARD_D4"
  }
}

CreatePool - Minimal VirtualMachineConfiguration

Przykładowa prośba

HTTP

PUT https://management.azure.com/subscriptions/12345678-1234-1234-1234-123456789012/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Batch/batchAccounts/sampleacct/pools/testpool?api-version=2024-07-01

{
  "properties": {
    "deploymentConfiguration": {
      "virtualMachineConfiguration": {
        "imageReference": {
          "offer": "UbuntuServer",
          "publisher": "Canonical",
          "sku": "18.04-LTS",
          "version": "latest"
        },
        "nodeAgentSkuId": "batch.node.ubuntu 18.04"
      }
    },
    "scaleSettings": {
      "autoScale": {
        "evaluationInterval": "PT5M",
        "formula": "$TargetDedicatedNodes=1"
      }
    },
    "vmSize": "STANDARD_D4"
  }
}

Przykładowa odpowiedź

Kod statusu:

200

ETag: W/"0x8D4EDFEBFADF4AB"

{
  "name": "testpool",
  "type": "Microsoft.Batch/batchAccounts/pools",
  "id": "/subscriptions/12345678-1234-1234-1234-123456789012/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Batch/batchAccounts/sampleacct/pools/testpool",
  "properties": {
    "allocationState": "Resizing",
    "allocationStateTransitionTime": "2017-08-28T10:22:55.9407275Z",
    "creationTime": "2017-08-28T10:22:55.9407275Z",
    "currentDedicatedNodes": 0,
    "currentLowPriorityNodes": 0,
    "deploymentConfiguration": {
      "virtualMachineConfiguration": {
        "imageReference": {
          "offer": "UbuntuServer",
          "publisher": "Canonical",
          "sku": "18.04-LTS",
          "version": "latest"
        },
        "nodeAgentSkuId": "batch.node.ubuntu 18.04"
      }
    },
    "interNodeCommunication": "Disabled",
    "lastModified": "2017-08-28T10:22:55.9407275Z",
    "provisioningState": "Succeeded",
    "provisioningStateTransitionTime": "2017-08-28T10:22:55.9407275Z",
    "scaleSettings": {
      "autoScale": {
        "evaluationInterval": "PT5M",
        "formula": "$TargetDedicatedNodes=1"
      }
    },
    "taskSchedulingPolicy": {
      "nodeFillType": "Spread"
    },
    "taskSlotsPerNode": 1,
    "vmSize": "STANDARD_D4"
  }
}

CreatePool - No public IP

Przykładowa prośba

HTTP

PUT https://management.azure.com/subscriptions/12345678-1234-1234-1234-123456789012/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Batch/batchAccounts/sampleacct/pools/testpool?api-version=2024-07-01

{
  "properties": {
    "deploymentConfiguration": {
      "virtualMachineConfiguration": {
        "imageReference": {
          "id": "/subscriptions/12345678-1234-1234-1234-123456789012/resourceGroups/networking-group/providers/Microsoft.Compute/galleries/testgallery/images/testimagedef/versions/0.0.1"
        },
        "nodeAgentSkuId": "batch.node.ubuntu 18.04"
      }
    },
    "networkConfiguration": {
      "publicIPAddressConfiguration": {
        "provision": "NoPublicIPAddresses"
      },
      "subnetId": "/subscriptions/12345678-1234-1234-1234-123456789012/resourceGroups/rg1234/providers/Microsoft.Network/virtualNetworks/network1234/subnets/subnet123"
    },
    "vmSize": "STANDARD_D4"
  }
}

Przykładowa odpowiedź

Kod statusu:

200

ETag: W/"0x8D4EDFEBFADF4AB"

{
  "name": "testpool",
  "type": "Microsoft.Batch/batchAccounts/pools",
  "id": "/subscriptions/12345678-1234-1234-1234-123456789012/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Batch/batchAccounts/sampleacct/pools/testpool",
  "properties": {
    "allocationState": "Steady",
    "allocationStateTransitionTime": "2017-08-28T10:22:55.9407275Z",
    "creationTime": "2017-08-28T10:22:55.9407275Z",
    "currentDedicatedNodes": 0,
    "currentLowPriorityNodes": 0,
    "deploymentConfiguration": {
      "virtualMachineConfiguration": {
        "imageReference": {
          "id": "/subscriptions/12345678-1234-1234-1234-123456789012/resourceGroups/networking-group/providers/Microsoft.Compute/galleries/testgallery/images/testimagedef/versions/0.0.1"
        },
        "nodeAgentSkuId": "batch.node.ubuntu 18.04"
      }
    },
    "interNodeCommunication": "Disabled",
    "lastModified": "2017-08-28T10:22:55.9407275Z",
    "networkConfiguration": {
      "publicIPAddressConfiguration": {
        "provision": "NoPublicIPAddresses"
      },
      "subnetId": "/subscriptions/12345678-1234-1234-1234-123456789012/resourceGroups/rg1234/providers/Microsoft.Network/virtualNetworks/network1234/subnets/subnet123"
    },
    "provisioningState": "Succeeded",
    "provisioningStateTransitionTime": "2017-08-28T10:22:55.9407275Z",
    "scaleSettings": {
      "fixedScale": {
        "targetDedicatedNodes": 0,
        "targetLowPriorityNodes": 0
      }
    },
    "taskSchedulingPolicy": {
      "nodeFillType": "Spread"
    },
    "taskSlotsPerNode": 1,
    "vmSize": "STANDARD_D4"
  }
}

CreatePool - Public IPs

Przykładowa prośba

HTTP

PUT https://management.azure.com/subscriptions/12345678-1234-1234-1234-123456789012/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Batch/batchAccounts/sampleacct/pools/testpool?api-version=2024-07-01

{
  "properties": {
    "deploymentConfiguration": {
      "virtualMachineConfiguration": {
        "imageReference": {
          "id": "/subscriptions/12345678-1234-1234-1234-123456789012/resourceGroups/networking-group/providers/Microsoft.Compute/galleries/testgallery/images/testimagedef/versions/0.0.1"
        },
        "nodeAgentSkuId": "batch.node.ubuntu 18.04"
      }
    },
    "networkConfiguration": {
      "publicIPAddressConfiguration": {
        "ipAddressIds": [
          "/subscriptions/12345678-1234-1234-1234-1234567890121/resourceGroups/rg13/providers/Microsoft.Network/publicIPAddresses/ip135"
        ],
        "provision": "UserManaged"
      },
      "subnetId": "/subscriptions/12345678-1234-1234-1234-123456789012/resourceGroups/rg1234/providers/Microsoft.Network/virtualNetworks/network1234/subnets/subnet123"
    },
    "vmSize": "STANDARD_D4"
  }
}

Przykładowa odpowiedź

Kod statusu:

200

ETag: W/"0x8D4EDFEBFADF4AB"

{
  "name": "testpool",
  "type": "Microsoft.Batch/batchAccounts/pools",
  "id": "/subscriptions/12345678-1234-1234-1234-123456789012/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Batch/batchAccounts/sampleacct/pools/testpool",
  "properties": {
    "allocationState": "Steady",
    "allocationStateTransitionTime": "2017-08-28T10:22:55.9407275Z",
    "creationTime": "2017-08-28T10:22:55.9407275Z",
    "currentDedicatedNodes": 0,
    "currentLowPriorityNodes": 0,
    "deploymentConfiguration": {
      "virtualMachineConfiguration": {
        "imageReference": {
          "id": "/subscriptions/12345678-1234-1234-1234-123456789012/resourceGroups/networking-group/providers/Microsoft.Compute/galleries/testgallery/images/testimagedef/versions/0.0.1"
        },
        "nodeAgentSkuId": "batch.node.ubuntu 18.04"
      }
    },
    "interNodeCommunication": "Disabled",
    "lastModified": "2017-08-28T10:22:55.9407275Z",
    "networkConfiguration": {
      "publicIPAddressConfiguration": {
        "ipAddressIds": [
          "/subscriptions/12345678-1234-1234-1234-1234567890121/resourceGroups/rg13/providers/Microsoft.Network/publicIPAddresses/ip135"
        ],
        "provision": "UserManaged"
      },
      "subnetId": "/subscriptions/12345678-1234-1234-1234-123456789012/resourceGroups/rg1234/providers/Microsoft.Network/virtualNetworks/network1234/subnets/subnet123"
    },
    "provisioningState": "Succeeded",
    "provisioningStateTransitionTime": "2017-08-28T10:22:55.9407275Z",
    "scaleSettings": {
      "fixedScale": {
        "targetDedicatedNodes": 0,
        "targetLowPriorityNodes": 0
      }
    },
    "taskSchedulingPolicy": {
      "nodeFillType": "Spread"
    },
    "taskSlotsPerNode": 1,
    "vmSize": "STANDARD_D4"
  }
}

CreatePool - ResourceTags

Przykładowa prośba

HTTP

PUT https://management.azure.com/subscriptions/12345678-1234-1234-1234-123456789012/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Batch/batchAccounts/sampleacct/pools/testpool?api-version=2024-07-01

{
  "properties": {
    "deploymentConfiguration": {
      "virtualMachineConfiguration": {
        "imageReference": {
          "offer": "UbuntuServer",
          "publisher": "Canonical",
          "sku": "18_04-lts-gen2",
          "version": "latest"
        },
        "nodeAgentSkuId": "batch.node.ubuntu 18.04"
      }
    },
    "resourceTags": {
      "TagName1": "TagValue1",
      "TagName2": "TagValue2"
    },
    "scaleSettings": {
      "fixedScale": {
        "targetDedicatedNodes": 1,
        "targetLowPriorityNodes": 0
      }
    },
    "vmSize": "Standard_d4s_v3"
  }
}

Przykładowa odpowiedź

Kod statusu:

200

ETag: W/"0x8DB554F8E08BCF4"

{
  "name": "testpool",
  "type": "Microsoft.Batch/batchAccounts/pools",
  "id": "/subscriptions/12345678-1234-1234-1234-123456789012/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Batch/batchAccounts/sampleacct/pools/testpool",
  "properties": {
    "allocationState": "Resizing",
    "allocationStateTransitionTime": "2023-06-14T07:03:58.3231917Z",
    "creationTime": "2023-06-14T07:03:58.3231917Z",
    "currentDedicatedNodes": 0,
    "currentLowPriorityNodes": 0,
    "deploymentConfiguration": {
      "virtualMachineConfiguration": {
        "imageReference": {
          "offer": "UbuntuServer",
          "publisher": "Canonical",
          "sku": "18_04-lts-gen2",
          "version": "latest"
        },
        "nodeAgentSkuId": "batch.node.ubuntu 18.04"
      }
    },
    "interNodeCommunication": "Disabled",
    "lastModified": "2023-06-14T07:03:58.3231917Z",
    "provisioningState": "Succeeded",
    "provisioningStateTransitionTime": "2023-06-14T07:03:58.3231917Z",
    "resizeOperationStatus": {
      "nodeDeallocationOption": "Requeue",
      "resizeTimeout": "PT15M",
      "startTime": "2023-09-27T07:33:13.0625789Z",
      "targetDedicatedNodes": 1
    },
    "resourceTags": {
      "TagName1": "TagValue1",
      "TagName2": "TagValue2"
    },
    "scaleSettings": {
      "fixedScale": {
        "resizeTimeout": "PT15M",
        "targetDedicatedNodes": 1,
        "targetLowPriorityNodes": 0
      }
    },
    "taskSchedulingPolicy": {
      "nodeFillType": "Spread"
    },
    "taskSlotsPerNode": 1,
    "vmSize": "STANDARD_D4S_V3"
  }
}

CreatePool - SecurityProfile

Przykładowa prośba

HTTP

PUT https://management.azure.com/subscriptions/12345678-1234-1234-1234-123456789012/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Batch/batchAccounts/sampleacct/pools/testpool?api-version=2024-07-01

{
  "properties": {
    "deploymentConfiguration": {
      "virtualMachineConfiguration": {
        "imageReference": {
          "offer": "UbuntuServer",
          "publisher": "Canonical",
          "sku": "18_04-lts-gen2",
          "version": "latest"
        },
        "nodeAgentSkuId": "batch.node.ubuntu 18.04",
        "securityProfile": {
          "encryptionAtHost": true,
          "securityType": "trustedLaunch",
          "uefiSettings": {
            "secureBootEnabled": null,
            "vTpmEnabled": false
          }
        }
      }
    },
    "scaleSettings": {
      "fixedScale": {
        "targetDedicatedNodes": 1,
        "targetLowPriorityNodes": 0
      }
    },
    "vmSize": "Standard_d4s_v3"
  }
}

Przykładowa odpowiedź

Kod statusu:

200

ETag: W/"0x8DB554F8E08BCF4"

{
  "name": "testpool",
  "type": "Microsoft.Batch/batchAccounts/pools",
  "id": "/subscriptions/12345678-1234-1234-1234-123456789012/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Batch/batchAccounts/sampleacct/pools/testpool",
  "properties": {
    "allocationState": "Resizing",
    "allocationStateTransitionTime": "2023-06-14T07:03:58.3231917Z",
    "creationTime": "2023-06-14T07:03:58.3231917Z",
    "currentDedicatedNodes": 0,
    "currentLowPriorityNodes": 0,
    "deploymentConfiguration": {
      "virtualMachineConfiguration": {
        "imageReference": {
          "offer": "UbuntuServer",
          "publisher": "Canonical",
          "sku": "18_04-lts-gen2",
          "version": "latest"
        },
        "nodeAgentSkuId": "batch.node.ubuntu 18.04",
        "securityProfile": {
          "encryptionAtHost": true,
          "securityType": "trustedLaunch",
          "uefiSettings": {
            "vTpmEnabled": false
          }
        }
      }
    },
    "interNodeCommunication": "Disabled",
    "lastModified": "2023-06-14T07:03:58.3231917Z",
    "provisioningState": "Succeeded",
    "provisioningStateTransitionTime": "2023-06-14T07:03:58.3231917Z",
    "resizeOperationStatus": {
      "nodeDeallocationOption": "Requeue",
      "resizeTimeout": "PT15M",
      "startTime": "2023-06-14T07:03:58.3231917Z",
      "targetDedicatedNodes": 1
    },
    "scaleSettings": {
      "fixedScale": {
        "resizeTimeout": "PT15M",
        "targetDedicatedNodes": 1,
        "targetLowPriorityNodes": 0
      }
    },
    "taskSchedulingPolicy": {
      "nodeFillType": "Spread"
    },
    "taskSlotsPerNode": 1,
    "vmSize": "STANDARD_D4S_V3"
  }
}

CreatePool - Tags

Przykładowa prośba

HTTP

PUT https://management.azure.com/subscriptions/12345678-1234-1234-1234-123456789012/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Batch/batchAccounts/sampleacct/pools/testpool?api-version=2024-07-01

{
  "properties": {
    "deploymentConfiguration": {
      "virtualMachineConfiguration": {
        "imageReference": {
          "offer": "0001-com-ubuntu-server-jammy",
          "publisher": "Canonical",
          "sku": "22_04-lts",
          "version": "latest"
        },
        "nodeAgentSkuId": "batch.node.ubuntu 22.04"
      }
    },
    "scaleSettings": {
      "fixedScale": {
        "targetDedicatedNodes": 1,
        "targetLowPriorityNodes": 0
      }
    },
    "vmSize": "Standard_d4s_v3"
  }
}

Przykładowa odpowiedź

Kod statusu:

200

ETag: W/"0x8DB554F8E08BCF4"

{
  "name": "testpool",
  "type": "Microsoft.Batch/batchAccounts/pools",
  "id": "/subscriptions/12345678-1234-1234-1234-123456789012/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Batch/batchAccounts/sampleacct/pools/testpool",
  "properties": {
    "allocationState": "Resizing",
    "allocationStateTransitionTime": "2023-06-14T07:03:58.3231917Z",
    "creationTime": "2023-06-14T07:03:58.3231917Z",
    "currentDedicatedNodes": 0,
    "currentLowPriorityNodes": 0,
    "deploymentConfiguration": {
      "virtualMachineConfiguration": {
        "imageReference": {
          "offer": "0001-com-ubuntu-server-jammy",
          "publisher": "Canonical",
          "sku": "22_04-lts",
          "version": "latest"
        },
        "nodeAgentSkuId": "batch.node.ubuntu 22.04"
      }
    },
    "interNodeCommunication": "Disabled",
    "lastModified": "2023-06-14T07:03:58.3231917Z",
    "provisioningState": "Succeeded",
    "provisioningStateTransitionTime": "2023-06-14T07:03:58.3231917Z",
    "resizeOperationStatus": {
      "nodeDeallocationOption": "Requeue",
      "resizeTimeout": "PT15M",
      "startTime": "2023-09-27T07:33:13.0625789Z",
      "targetDedicatedNodes": 1
    },
    "scaleSettings": {
      "fixedScale": {
        "resizeTimeout": "PT15M",
        "targetDedicatedNodes": 1,
        "targetLowPriorityNodes": 0
      }
    },
    "taskSchedulingPolicy": {
      "nodeFillType": "Spread"
    },
    "taskSlotsPerNode": 1,
    "vmSize": "STANDARD_D4S_V3"
  }
}

CreatePool - UpgradePolicy

Przykładowa prośba

HTTP

PUT https://management.azure.com/subscriptions/12345678-1234-1234-1234-123456789012/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Batch/batchAccounts/sampleacct/pools/testpool?api-version=2024-07-01

{
  "properties": {
    "deploymentConfiguration": {
      "virtualMachineConfiguration": {
        "imageReference": {
          "offer": "WindowsServer",
          "publisher": "MicrosoftWindowsServer",
          "sku": "2019-datacenter-smalldisk",
          "version": "latest"
        },
        "nodeAgentSkuId": "batch.node.windows amd64",
        "nodePlacementConfiguration": {
          "policy": "Zonal"
        },
        "windowsConfiguration": {
          "enableAutomaticUpdates": false
        }
      }
    },
    "scaleSettings": {
      "fixedScale": {
        "targetDedicatedNodes": 2,
        "targetLowPriorityNodes": 0
      }
    },
    "upgradePolicy": {
      "automaticOSUpgradePolicy": {
        "disableAutomaticRollback": true,
        "enableAutomaticOSUpgrade": true,
        "osRollingUpgradeDeferral": true,
        "useRollingUpgradePolicy": true
      },
      "mode": "automatic",
      "rollingUpgradePolicy": {
        "enableCrossZoneUpgrade": true,
        "maxBatchInstancePercent": 20,
        "maxUnhealthyInstancePercent": 20,
        "maxUnhealthyUpgradedInstancePercent": 20,
        "pauseTimeBetweenBatches": "PT0S",
        "prioritizeUnhealthyInstances": false,
        "rollbackFailedInstancesOnPolicyBreach": false
      }
    },
    "vmSize": "Standard_d4s_v3"
  }
}

Przykładowa odpowiedź

Kod statusu:

200

ETag: W/"0x8DB51E64D3C3B69"

{
  "name": "testpool",
  "type": "Microsoft.Batch/batchAccounts/pools",
  "id": "/subscriptions/12345678-1234-1234-1234-123456789012/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Batch/batchAccounts/sampleacct/pools/testpool",
  "properties": {
    "allocationState": "Resizing",
    "allocationStateTransitionTime": "2023-05-11T06:16:44.2372184Z",
    "creationTime": "2023-05-11T06:16:44.2372184Z",
    "currentDedicatedNodes": 0,
    "currentLowPriorityNodes": 0,
    "deploymentConfiguration": {
      "virtualMachineConfiguration": {
        "imageReference": {
          "offer": "WindowsServer",
          "publisher": "MicrosoftWindowsServer",
          "sku": "2019-datacenter-smalldisk",
          "version": "latest"
        },
        "nodeAgentSkuId": "batch.node.windows amd64",
        "nodePlacementConfiguration": {
          "policy": "Zonal"
        },
        "windowsConfiguration": {
          "enableAutomaticUpdates": false
        }
      }
    },
    "interNodeCommunication": "Disabled",
    "lastModified": "2023-05-11T06:16:44.2372184Z",
    "provisioningState": "Succeeded",
    "provisioningStateTransitionTime": "2023-05-11T06:16:44.2372184Z",
    "resizeOperationStatus": {
      "nodeDeallocationOption": "Requeue",
      "resizeTimeout": "PT15M",
      "startTime": "2023-05-11T06:16:44.2372184Z",
      "targetDedicatedNodes": 2
    },
    "scaleSettings": {
      "fixedScale": {
        "resizeTimeout": "PT15M",
        "targetDedicatedNodes": 2,
        "targetLowPriorityNodes": 0
      }
    },
    "taskSchedulingPolicy": {
      "nodeFillType": "Spread"
    },
    "taskSlotsPerNode": 1,
    "upgradePolicy": {
      "automaticOSUpgradePolicy": {
        "disableAutomaticRollback": true,
        "enableAutomaticOSUpgrade": true,
        "osRollingUpgradeDeferral": true,
        "useRollingUpgradePolicy": true
      },
      "mode": "automatic",
      "rollingUpgradePolicy": {
        "enableCrossZoneUpgrade": true,
        "maxBatchInstancePercent": 20,
        "maxUnhealthyInstancePercent": 20,
        "maxUnhealthyUpgradedInstancePercent": 20,
        "pauseTimeBetweenBatches": "PT0S",
        "prioritizeUnhealthyInstances": false,
        "rollbackFailedInstancesOnPolicyBreach": false
      }
    },
    "vmSize": "STANDARD_D4S_V3"
  }
}

CreatePool - UserAssignedIdentities

Przykładowa prośba

HTTP

PUT https://management.azure.com/subscriptions/12345678-1234-1234-1234-123456789012/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Batch/batchAccounts/sampleacct/pools/testpool?api-version=2024-07-01

{
  "identity": {
    "type": "UserAssigned",
    "userAssignedIdentities": {
      "/subscriptions/12345678-1234-1234-1234-123456789012/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.ManagedIdentity/userAssignedIdentities/id1": {},
      "/subscriptions/12345678-1234-1234-1234-123456789012/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.ManagedIdentity/userAssignedIdentities/id2": {}
    }
  },
  "properties": {
    "deploymentConfiguration": {
      "virtualMachineConfiguration": {
        "imageReference": {
          "offer": "UbuntuServer",
          "publisher": "Canonical",
          "sku": "18.04-LTS",
          "version": "latest"
        },
        "nodeAgentSkuId": "batch.node.ubuntu 18.04"
      }
    },
    "scaleSettings": {
      "autoScale": {
        "evaluationInterval": "PT5M",
        "formula": "$TargetDedicatedNodes=1"
      }
    },
    "vmSize": "STANDARD_D4"
  }
}

Przykładowa odpowiedź

Kod statusu:

200

ETag: W/"0x8D4EDFEBFADF4AB"

{
  "name": "testpool",
  "type": "Microsoft.Batch/batchAccounts/pools",
  "id": "/subscriptions/12345678-1234-1234-1234-123456789012/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Batch/batchAccounts/sampleacct/pools/testpool",
  "identity": {
    "type": "UserAssigned",
    "userAssignedIdentities": {
      "/subscriptions/12345678-1234-1234-1234-123456789012/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.ManagedIdentity/userAssignedIdentities/id1": {
        "clientId": "clientId1",
        "principalId": "principalId1"
      },
      "/subscriptions/12345678-1234-1234-1234-123456789012/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.ManagedIdentity/userAssignedIdentities/id2": {
        "clientId": "clientId2",
        "principalId": "principalId2"
      }
    }
  },
  "properties": {
    "allocationState": "Resizing",
    "allocationStateTransitionTime": "2020-10-01T10:22:55.9407275Z",
    "creationTime": "2020-10-01T10:22:55.9407275Z",
    "currentDedicatedNodes": 0,
    "currentLowPriorityNodes": 0,
    "deploymentConfiguration": {
      "virtualMachineConfiguration": {
        "imageReference": {
          "offer": "UbuntuServer",
          "publisher": "Canonical",
          "sku": "18.04-LTS",
          "version": "latest"
        },
        "nodeAgentSkuId": "batch.node.ubuntu 18.04"
      }
    },
    "interNodeCommunication": "Disabled",
    "lastModified": "2020-10-01T10:22:55.9407275Z",
    "provisioningState": "Succeeded",
    "provisioningStateTransitionTime": "2020-10-01T10:22:55.9407275Z",
    "scaleSettings": {
      "autoScale": {
        "evaluationInterval": "PT5M",
        "formula": "$TargetDedicatedNodes=1"
      }
    },
    "taskSchedulingPolicy": {
      "nodeFillType": "Spread"
    },
    "taskSlotsPerNode": 1,
    "vmSize": "STANDARD_D4"
  }
}

CreatePool - VirtualMachineConfiguration Extensions

Przykładowa prośba

HTTP

PUT https://management.azure.com/subscriptions/12345678-1234-1234-1234-123456789012/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Batch/batchAccounts/sampleacct/pools/testpool?api-version=2024-07-01

{
  "properties": {
    "deploymentConfiguration": {
      "virtualMachineConfiguration": {
        "imageReference": {
          "offer": "0001-com-ubuntu-server-focal",
          "publisher": "Canonical",
          "sku": "20_04-lts"
        },
        "nodeAgentSkuId": "batch.node.ubuntu 20.04",
        "extensions": [
          {
            "name": "batchextension1",
            "type": "KeyVaultForLinux",
            "autoUpgradeMinorVersion": true,
            "enableAutomaticUpgrade": true,
            "publisher": "Microsoft.Azure.KeyVault",
            "settings": {
              "authenticationSettingsKey": "authenticationSettingsValue",
              "secretsManagementSettingsKey": "secretsManagementSettingsValue"
            },
            "typeHandlerVersion": "2.0"
          }
        ]
      }
    },
    "scaleSettings": {
      "autoScale": {
        "evaluationInterval": "PT5M",
        "formula": "$TargetDedicatedNodes=1"
      }
    },
    "targetNodeCommunicationMode": "Default",
    "vmSize": "STANDARD_D4"
  }
}

Przykładowa odpowiedź

Kod statusu:

200

ETag: W/"0x8D4EDFEBFADF4AB"

{
  "name": "testpool",
  "type": "Microsoft.Batch/batchAccounts/pools",
  "id": "/subscriptions/12345678-1234-1234-1234-123456789012/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Batch/batchAccounts/sampleacct/pools/testpool",
  "properties": {
    "allocationState": "Resizing",
    "allocationStateTransitionTime": "2017-08-28T10:22:55.9407275Z",
    "creationTime": "2017-08-28T10:22:55.9407275Z",
    "currentDedicatedNodes": 0,
    "currentLowPriorityNodes": 0,
    "deploymentConfiguration": {
      "virtualMachineConfiguration": {
        "imageReference": {
          "offer": "0001-com-ubuntu-server-focal",
          "publisher": "Canonical",
          "sku": "20_04-lts"
        },
        "nodeAgentSkuId": "batch.node.ubuntu 20.04",
        "extensions": [
          {
            "name": "batchextension1",
            "type": "KeyVaultForLinux",
            "autoUpgradeMinorVersion": true,
            "enableAutomaticUpgrade": true,
            "publisher": "Microsoft.Azure.KeyVault",
            "settings": {
              "authenticationSettingsKey": "authenticationSettingsValue",
              "secretsManagementSettingsKey": "secretsManagementSettingsValue"
            },
            "typeHandlerVersion": "2.0"
          }
        ]
      }
    },
    "interNodeCommunication": "Disabled",
    "lastModified": "2017-08-28T10:22:55.9407275Z",
    "provisioningState": "Succeeded",
    "provisioningStateTransitionTime": "2017-08-28T10:22:55.9407275Z",
    "scaleSettings": {
      "autoScale": {
        "evaluationInterval": "PT5M",
        "formula": "$TargetDedicatedNodes=1"
      }
    },
    "targetNodeCommunicationMode": "Default",
    "taskSchedulingPolicy": {
      "nodeFillType": "Spread"
    },
    "taskSlotsPerNode": 1,
    "vmSize": "STANDARD_D4"
  }
}

CreatePool - VirtualMachineConfiguration OSDisk

Przykładowa prośba

HTTP

PUT https://management.azure.com/subscriptions/12345678-1234-1234-1234-123456789012/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Batch/batchAccounts/sampleacct/pools/testpool?api-version=2024-07-01

{
  "properties": {
    "deploymentConfiguration": {
      "virtualMachineConfiguration": {
        "imageReference": {
          "offer": "windowsserver",
          "publisher": "microsoftwindowsserver",
          "sku": "2022-datacenter-smalldisk"
        },
        "nodeAgentSkuId": "batch.node.windows amd64",
        "osDisk": {
          "caching": "ReadWrite",
          "diskSizeGB": 100,
          "managedDisk": {
            "storageAccountType": "StandardSSD_LRS"
          },
          "writeAcceleratorEnabled": false
        }
      }
    },
    "scaleSettings": {
      "fixedScale": {
        "targetDedicatedNodes": 1,
        "targetLowPriorityNodes": 0
      }
    },
    "vmSize": "Standard_d2s_v3"
  }
}

Przykładowa odpowiedź

Kod statusu:

200

ETag: W/"0x8DB51F14DC1A8AD"

{
  "name": "testpool",
  "type": "Microsoft.Batch/batchAccounts/pools",
  "id": "/subscriptions/12345678-1234-1234-1234-123456789012/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Batch/batchAccounts/sampleacct/pools/testpool",
  "properties": {
    "allocationState": "Resizing",
    "allocationStateTransitionTime": "2023-08-24T02:12:27.7527697Z",
    "creationTime": "2023-08-24T02:12:27.7527697Z",
    "currentDedicatedNodes": 0,
    "currentLowPriorityNodes": 0,
    "deploymentConfiguration": {
      "virtualMachineConfiguration": {
        "imageReference": {
          "offer": "windowsserver",
          "publisher": "microsoftwindowsserver",
          "sku": "2022-datacenter-smalldisk",
          "version": "latest"
        },
        "nodeAgentSkuId": "batch.node.windows amd64",
        "osDisk": {
          "caching": "ReadWrite",
          "diskSizeGB": 100,
          "managedDisk": {
            "storageAccountType": "StandardSSD_LRS"
          },
          "writeAcceleratorEnabled": false
        }
      }
    },
    "interNodeCommunication": "Disabled",
    "lastModified": "2023-08-24T02:12:27.7527697Z",
    "provisioningState": "Succeeded",
    "provisioningStateTransitionTime": "2023-08-24T02:12:27.7527697Z",
    "resizeOperationStatus": {
      "nodeDeallocationOption": "Requeue",
      "resizeTimeout": "PT15M",
      "startTime": "2023-08-24T02:12:27.7527697Z",
      "targetDedicatedNodes": 1
    },
    "scaleSettings": {
      "fixedScale": {
        "resizeTimeout": "PT15M",
        "targetDedicatedNodes": 1,
        "targetLowPriorityNodes": 0
      }
    },
    "taskSchedulingPolicy": {
      "nodeFillType": "Spread"
    },
    "taskSlotsPerNode": 1,
    "vmSize": "STANDARD_D2_V3"
  }
}

CreatePool - VirtualMachineConfiguration ServiceArtifactReference

Przykładowa prośba

HTTP

PUT https://management.azure.com/subscriptions/12345678-1234-1234-1234-123456789012/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Batch/batchAccounts/sampleacct/pools/testpool?api-version=2024-07-01

{
  "properties": {
    "deploymentConfiguration": {
      "virtualMachineConfiguration": {
        "imageReference": {
          "offer": "WindowsServer",
          "publisher": "MicrosoftWindowsServer",
          "sku": "2019-datacenter-smalldisk",
          "version": "latest"
        },
        "nodeAgentSkuId": "batch.node.windows amd64",
        "serviceArtifactReference": {
          "id": "/subscriptions/12345678-1234-1234-1234-123456789012/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Compute/galleries/myGallery/serviceArtifacts/myServiceArtifact/vmArtifactsProfiles/vmArtifactsProfile"
        },
        "windowsConfiguration": {
          "enableAutomaticUpdates": false
        }
      }
    },
    "scaleSettings": {
      "fixedScale": {
        "targetDedicatedNodes": 2,
        "targetLowPriorityNodes": 0
      }
    },
    "upgradePolicy": {
      "automaticOSUpgradePolicy": {
        "enableAutomaticOSUpgrade": true
      },
      "mode": "automatic"
    },
    "vmSize": "Standard_d4s_v3"
  }
}

Przykładowa odpowiedź

Kod statusu:

200

ETag: W/"0x8DB51F14DC1A8AD"

{
  "name": "mypool41",
  "type": "Microsoft.Batch/batchAccounts/pools",
  "id": "/subscriptions/12345678-1234-1234-1234-123456789012/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Batch/batchAccounts/sampleacct/pools/testpool",
  "properties": {
    "allocationState": "Resizing",
    "allocationStateTransitionTime": "2023-05-11T07:44:44.8580493Z",
    "creationTime": "2023-05-11T07:44:44.8580493Z",
    "currentDedicatedNodes": 0,
    "currentLowPriorityNodes": 0,
    "deploymentConfiguration": {
      "virtualMachineConfiguration": {
        "imageReference": {
          "offer": "WindowsServer",
          "publisher": "MicrosoftWindowsServer",
          "sku": "2019-datacenter-smalldisk",
          "version": "latest"
        },
        "nodeAgentSkuId": "batch.node.windows amd64",
        "serviceArtifactReference": {
          "id": "/subscriptions/12345678-1234-1234-1234-123456789012/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Compute/galleries/myGallery/serviceArtifacts/myServiceArtifact/vmArtifactsProfiles/vmArtifactsProfile"
        },
        "windowsConfiguration": {
          "enableAutomaticUpdates": false
        }
      }
    },
    "interNodeCommunication": "Disabled",
    "lastModified": "2023-05-11T07:44:44.8580493Z",
    "provisioningState": "Succeeded",
    "provisioningStateTransitionTime": "2023-05-11T07:44:44.8580493Z",
    "resizeOperationStatus": {
      "nodeDeallocationOption": "Requeue",
      "resizeTimeout": "PT15M",
      "startTime": "2023-05-11T07:44:44.8580493Z",
      "targetDedicatedNodes": 2
    },
    "scaleSettings": {
      "fixedScale": {
        "resizeTimeout": "PT15M",
        "targetDedicatedNodes": 2,
        "targetLowPriorityNodes": 0
      }
    },
    "taskSchedulingPolicy": {
      "nodeFillType": "Spread"
    },
    "taskSlotsPerNode": 1,
    "upgradePolicy": {
      "automaticOSUpgradePolicy": {
        "enableAutomaticOSUpgrade": true
      },
      "mode": "automatic"
    },
    "vmSize": "STANDARD_D4S_V3"
  }
}

Definicje

Nazwa	Opis
AllocationState	Określa, czy pula zmienia rozmiar.
ApplicationPackageReference	Łączenie z pakietem aplikacji wewnątrz konta usługi Batch
AutomaticOSUpgradePolicy	Parametry konfiguracji używane do przeprowadzania automatycznego uaktualniania systemu operacyjnego.
AutoScaleRun	Wyniki i błędy z wykonania formuły autoskalowania puli.
AutoScaleRunError	Wystąpił błąd podczas automatycznego skalowania puli.
AutoScaleSettings	Ustawienia autoskalowania dla puli.
AutoUserScope	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 przez zwykłe zadania, ale powinny być dostępne przez zadania uruchamiania.
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.
BatchPoolIdentity	Tożsamość puli usługi Batch, jeśli została skonfigurowana. Jeśli tożsamość puli zostanie zaktualizowana podczas aktualizacji istniejącej puli, tylko nowe maszyny wirtualne utworzone po zmniejszeniu puli do 0 będą miały zaktualizowane tożsamości
CachingType	Typ buforowania, który ma być włączony dla dysku.
CertificateReference	Odwołanie do certyfikatu, który ma zostać zainstalowany w węzłach obliczeniowych w puli. Musi istnieć wewnątrz tego samego konta co pula.
CertificateStoreLocation	Wartość domyślna to currentUser. Ta właściwość ma zastosowanie tylko w przypadku pul skonfigurowanych z węzłami obliczeniowymi 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 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.
CertificateVisibility
CIFSMountConfiguration	Informacje używane do nawiązywania połączenia z systemem plików CIFS.
CloudError	Odpowiedź na błąd z usługi Batch.
CloudErrorBody	Odpowiedź na błąd z usługi Batch.
ComputeNodeDeallocationOption	Określa, co należy zrobić z węzłem i uruchomionymi zadaniami po wybraniu go do cofnięcia przydziału.
ComputeNodeFillType	Sposób dystrybucji zadań między węzłami obliczeniowymi.
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.
ContainerHostBatchBindMountEntry	Wpis ścieżki i trybu instalacji, który chcesz zainstalować w kontenerze zadań.
ContainerHostDataPath	Ścieżki, które zostaną zainstalowane w kontenerze zadania kontenera.
ContainerRegistry	Prywatny rejestr kontenerów.
ContainerType	Technologia kontenera do użycia.
ContainerWorkingDirectory	Flaga wskazująca, gdzie znajduje się katalog roboczy zadania kontenera. Wartość domyślna to "taskWorkingDirectory".
createdByType	Typ tożsamości, która utworzyła zasób.
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 maszyny wirtualnej, aby ich używać.
DeploymentConfiguration	Właściwości konfiguracji wdrożenia.
DiffDiskPlacement	Miejsce, gdzie powinien być umieszczony dysk systemu operacyjnego.
DiffDiskSettings	Określa efemeryczne ustawienia dysku dla dysku systemu operacyjnego używanego przez maszynę wirtualną.
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 przy użyciu obrazu maszyny wirtualnej lub obrazu galerii obliczeń platformy Azure.
DiskEncryptionTarget	W przypadku pominięcia żadne dyski w węzłach obliczeniowych w puli nie będą szyfrowane.
DynamicVNetAssignmentScope	Zakres dynamicznego przypisania sieci wirtualnej.
ElevationLevel	Poziom podniesienia uprawnień użytkownika.
EnvironmentSetting	Zmienna środowiskowa, która ma być ustawiana w procesie zadania.
FixedScaleSettings	Naprawiono ustawienia skalowania dla puli.
ImageReference	Odwołanie do obrazu witryny Marketplace usługi Azure Virtual Machines lub zasobu obrazu platformy Azure niestandardowej maszyny wirtualnej. Aby uzyskać listę wszystkich elementów imageReferences zweryfikowanych przez usługę Azure Batch, zobacz operację "Lista obsługiwanych jednostek SKU agenta węzła".
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.
InterNodeCommunicationState	Nakłada to ograniczenia dotyczące węzłów, które można przypisać do puli. Włączenie tej wartości może zmniejszyć prawdopodobieństwo przydzielenia żądanej liczby węzłów w puli. Jeśli nie zostanie określona, ta wartość jest domyślnie ustawiona na wartość "Wyłączone".
IPAddressProvisioningType	Typ aprowizacji dla publicznych adresów IP dla puli usługi Batch.
LinuxUserConfiguration	Właściwości używane do tworzenia konta użytkownika w węźle systemu Linux.
LoginMode	Określa tryb logowania użytkownika. Wartość domyślna to Interactive.
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, jak pula komunikuje się z usługą Batch.
NodePlacementConfiguration	Konfiguracja umieszczania węzłów dla pul wsadowych.
NodePlacementPolicyType	Domyślna wartość to regionalna.
OSDisk	Ustawienia dysku systemu operacyjnego maszyny wirtualnej.
Pool	Zawiera informacje o puli.
PoolEndpointConfiguration	Konfiguracja punktu końcowego dla puli.
PoolIdentityType	Typ tożsamości używany dla puli usługi Batch.
PoolProvisioningState	Bieżący stan puli.
PublicIPAddressConfiguration	Konfiguracja publicznego adresu IP konfiguracji sieci puli.
ResizeError	Wystąpił błąd podczas zmiany rozmiaru puli.
ResizeOperationStatus	Szczegółowe informacje o bieżącej lub ostatniej zakończonej operacji zmiany rozmiaru.
ResourceFile	Jeden plik lub wiele plików do pobrania do węzła obliczeniowego.
RollingUpgradePolicy	Parametry konfiguracji używane podczas uaktualniania stopniowego.
ScaleSettings	Ustawienia skalowania puli
SecurityEncryptionTypes	Określa typ szyfrowania dysku zarządzanego. Jest ona ustawiona na VMGuestStateOnly na potrzeby szyfrowania tylko obiektu blob VMGuestState i nonPersistedTPM dla nietrwałego stanu oprogramowania układowego w obiekcie blob VMGuestState. Uwaga: można ją ustawić tylko dla poufnych maszyn wirtualnych i wymaganych podczas korzystania z poufnych maszyn wirtualnych.
SecurityProfile	Określa ustawienia profilu zabezpieczeń dla maszyny wirtualnej lub zestawu skalowania maszyn wirtualnych.
SecurityTypes	Określa typ zabezpieczeń maszyny wirtualnej. Musi być ustawiona na dowolną określoną wartość, aby włączyć interfejs 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 w przypadku używania "najnowszej" wersji obrazu.
StartTask	Zadanie uruchamiane po dołączeniu węzła obliczeniowego do puli w usłudze Azure Batch 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.
systemData	Metadane dotyczące tworzenia i ostatniej modyfikacji zasobu.
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 maszyna wirtualna vTPM używane podczas tworzenia maszyny wirtualnej.
UpgradeMode	Określa tryb uaktualniania maszyn wirtualnych w zestawie skalowania. Możliwe wartości to: ręczne — kontrolujesz stosowanie aktualizacji do maszyn wirtualnych w zestawie skalowania. W tym celu należy użyć akcji manualUpgrade. automatyczne — wszystkie maszyny wirtualne w zestawie skalowania są automatycznie aktualizowane w tym samym czasie. rolling — zestaw skalowania wykonuje aktualizacje w partiach z opcjonalnym czasem wstrzymania między.
UpgradePolicy	Opisuje zasady uaktualniania — automatyczne, ręczne lub stopniowe.
UserAccount	Właściwości używane do tworzenia użytkownika w węźle usługi Azure Batch.
UserAssignedIdentities	Lista skojarzonych tożsamości użytkowników.
UserIdentity	Definicja tożsamości użytkownika, w ramach której jest uruchamiane zadanie.
VirtualMachineConfiguration	Konfiguracja węzłów obliczeniowych w puli oparta na infrastrukturze usługi Azure Virtual Machines.
VMDiskSecurityProfile	Określa ustawienia profilu zabezpieczeń dla dysku zarządzanego. Uwaga: można go ustawić tylko dla poufnych maszyn wirtualnych i jest wymagany podczas korzystania z poufnych maszyn wirtualnych.
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 systemu Windows.

AllocationState

Wyliczenie

Określa, czy pula zmienia rozmiar.

Wartość	Opis
Steady	Pula nie zmienia rozmiaru. Brak zmian liczby węzłów w puli w toku. Pula wprowadza ten stan po jej utworzeniu i gdy w puli nie są wykonywane żadne operacje, aby zmienić liczbę węzłów.
Resizing	Rozmiar puli jest zmieniany; czyli węzły obliczeniowe są dodawane do puli lub usuwane z puli.
Stopping	Rozmiar puli został zmieniony, ale użytkownik zażądał zatrzymania zmiany rozmiaru, ale żądanie zatrzymania nie zostało jeszcze ukończone.

ApplicationPackageReference

Sprzeciwiać się

Łączenie z pakietem aplikacji wewnątrz konta usługi Batch

Nazwa	Typ	Opis
id	string	Identyfikator pakietu aplikacji do zainstalowania. Musi to być wewnątrz tego samego konta wsadowego co pula. Może to być odwołanie do określonej wersji lub wersji domyślnej, jeśli istnieje.
version	string	Wersja aplikacji do wdrożenia. W przypadku pominięcia zostanie wdrożona domyślna wersja. Jeśli zostanie pominięta, a dla tej aplikacji nie zostanie określona żadna domyślna wersja, żądanie zakończy się niepowodzeniem z kodem błędu InvalidApplicationPackageReferences. Jeśli bezpośrednio wywołujesz interfejs API REST, kod stanu HTTP to 409.

AutomaticOSUpgradePolicy

Sprzeciwiać się

Parametry konfiguracji używane do przeprowadzania automatycznego uaktualniania systemu operacyjnego.

Nazwa	Typ	Opis
disableAutomaticRollback	boolean	Czy funkcja wycofywania obrazów systemu operacyjnego powinna być wyłączona.
enableAutomaticOSUpgrade	boolean	Wskazuje, czy uaktualnienia systemu operacyjnego powinny być automatycznie stosowane do wystąpień zestawu skalowania w sposób kroczący, gdy nowsza wersja obrazu systemu operacyjnego stanie się dostępna. Jeśli dla pul opartych na systemie Windows ustawiono wartość true, WindowsConfiguration.enableAutomaticUpdates nie można ustawić wartości true.
osRollingUpgradeDeferral	boolean	Odroczenie uaktualnień systemu operacyjnego na maszynach TVM, jeśli są uruchomione zadania.
useRollingUpgradePolicy	boolean	Wskazuje, czy zasady uaktualniania stopniowego powinny być używane podczas automatycznego uaktualniania systemu operacyjnego. Automatyczne uaktualnianie systemu operacyjnego spowoduje powrót do domyślnych zasad, jeśli żadne zasady nie są zdefiniowane w zestawie skalowania maszyn wirtualnych.

AutoScaleRun

Sprzeciwiać się

Wyniki i błędy z wykonania formuły autoskalowania puli.

Nazwa	Typ	Opis
error	AutoScaleRunError	Szczegóły błędu napotkanego podczas oceniania formuły autoskalowania w puli, jeśli ocena nie powiodła się. Wystąpił błąd podczas automatycznego skalowania puli.
evaluationTime	string (date-time)	Czas ostatniego oszacowania formuły autoskalowej.
results	string	Końcowe wartości wszystkich zmiennych używanych w ocenie formuły autoskalowania. Każda wartość zmiennej jest zwracana w formularzu $variable=wartość, a zmienne są rozdzielane średnikami.

AutoScaleRunError

Sprzeciwiać się

Wystąpił błąd podczas automatycznego skalowania puli.

Nazwa	Typ	Opis
code	string	Identyfikator błędu. Kody są niezmienne i mają być używane programowo.
details	AutoScaleRunError[]	Dodatkowe szczegóły dotyczące błędu.
message	string	Komunikat opisujący błąd, który ma być odpowiedni do wyświetlania w interfejsie użytkownika.

AutoScaleSettings

Sprzeciwiać się

Ustawienia autoskalowania dla puli.

Nazwa	Typ	Opis
evaluationInterval	string (duration)	Interwał czasu, w którym ma być automatycznie dostosowywany rozmiar puli zgodnie z formułą autoskalowania. W przypadku pominięcia wartość domyślna to 15 minut (PT15M).
formula	string	Formuła dla żądanej liczby węzłów obliczeniowych w puli.

AutoUserScope

Wyliczenie

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 przez zwykłe zadania, ale powinny być dostępne przez zadania uruchamiania.

Wartość	Opis
Task	Określa, że usługa powinna utworzyć nowego użytkownika dla zadania.
Pool	Określa, że zadanie jest uruchamiane jako wspólne konto użytkownika automatycznego, które jest tworzone w każdym węźle w puli.

AutoUserSpecification

Sprzeciwiać się

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. 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 przez zwykłe zadania, ale powinny być dostępne przez zadania uruchamiania.

AzureBlobFileSystemConfiguration

Sprzeciwiać się

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

Nazwa	Typ	Opis
accountKey	string (password)	Klucz konta usługi Azure Storage. Ta właściwość wzajemnie się wyklucza zarówno z kluczem sasKey, jak i tożsamością; należy określić dokładnie jeden.
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 systemach Windows i "instalowanie" w systemie Linux.
containerName	string	Nazwa kontenera usługi Azure Blob Storage.
identityReference	ComputeNodeIdentityReference	Odwołanie do tożsamości przypisanej przez użytkownika do użycia w celu uzyskania dostępu do elementu containerName Ta właściwość wzajemnie wyklucza się zarówno z kluczem accountKey, jak i sasKey; należy określić dokładnie jeden.
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 (password)	Token SAS usługi Azure Storage. Ta właściwość wzajemnie wyklucza się zarówno z kluczem konta, jak i tożsamością; należy określić dokładnie jeden.

AzureFileShareConfiguration

Sprzeciwiać się

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

Nazwa	Typ	Opis
accountKey	string (password)	Klucz konta usługi Azure Storage.
accountName	string	Nazwa konta usługi Azure Storage.
azureFileUrl	string	Adres URL usługi 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 systemach Windows i "instalowanie" 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.

BatchPoolIdentity

Sprzeciwiać się

Tożsamość puli usługi Batch, jeśli została skonfigurowana. Jeśli tożsamość puli zostanie zaktualizowana podczas aktualizacji istniejącej puli, tylko nowe maszyny wirtualne utworzone po zmniejszeniu puli do 0 będą miały zaktualizowane tożsamości

Nazwa	Typ	Opis
type	PoolIdentityType	Typ tożsamości używany dla puli usługi Batch.
userAssignedIdentities	<string,  UserAssignedIdentities>	Lista tożsamości użytkowników skojarzonych z pulą usługi Batch.

CachingType

Wyliczenie

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

Wartość	Opis
None	Tryb buforowania dysku nie jest włączony.
ReadOnly	Tryb buforowania dysku jest tylko do odczytu.
ReadWrite	Tryb buforowania dysku jest odczytywany i zapisywany.

CertificateReference

Sprzeciwiać się

Odwołanie do certyfikatu, który ma zostać zainstalowany w węzłach obliczeniowych w puli. Musi istnieć wewnątrz tego samego konta co pula.

Nazwa	Typ	Opis
id	string	W pełni kwalifikowany identyfikator certyfikatu do zainstalowania w puli. Musi to być wewnątrz tego samego konta wsadowego co pula.
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. 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.
storeName	string	Nazwa magazynu certyfikatów w węźle obliczeniowym, do którego ma zostać zainstalowany certyfikat. Ta właściwość ma zastosowanie tylko w przypadku pul skonfigurowanych z węzłami obliczeniowymi 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.
visibility	CertificateVisibility[]	Które konta użytkowników w węźle obliczeniowym powinny mieć dostęp do prywatnych danych certyfikatu.

CertificateStoreLocation

Wyliczenie

Wartość domyślna to currentUser. Ta właściwość ma zastosowanie tylko w przypadku pul skonfigurowanych z węzłami obliczeniowymi 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 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.

Wartość	Opis
CurrentUser	Certyfikaty należy zainstalować w magazynie certyfikatów CurrentUser.
LocalMachine	Certyfikaty należy zainstalować w magazynie certyfikatów LocalMachine.

CertificateVisibility

Wyliczenie

Wartość	Opis
StartTask	Certyfikat powinien być widoczny dla konta użytkownika, w ramach którego jest uruchamiane zadanie uruchamiania. Należy pamiętać, że jeśli zakres autoużytkownika jest pulą zarówno dla zadania startowego, jak i zadania, ten certyfikat będzie również widoczny dla zadania.
Task	Certyfikat powinien być widoczny dla kont użytkowników, w ramach których są uruchamiane zadania podrzędne.
RemoteUser	Certyfikat powinien być widoczny dla kont użytkowników, w ramach których użytkownicy uzyskują zdalny dostęp do węzła.

CIFSMountConfiguration

Sprzeciwiać się

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 systemach Windows i "instalowanie" w systemie Linux.
password	string (password)	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 do użycia do uwierzytelniania w systemie plików CIFS.

CloudError

Sprzeciwiać się

Odpowiedź na błąd z usługi Batch.

Nazwa	Typ	Opis
error	CloudErrorBody	Treść odpowiedzi o błędzie.

CloudErrorBody

Sprzeciwiać się

Odpowiedź na błąd z usługi Batch.

Nazwa	Typ	Opis
code	string	Identyfikator błędu. Kody są niezmienne i mają być używane programowo.
details	CloudErrorBody[]	Lista dodatkowych szczegółów dotyczących błędu.
message	string	Komunikat opisujący błąd, który ma być odpowiedni do wyświetlania w interfejsie użytkownika.
target	string	Element docelowy określonego błędu. Na przykład nazwa właściwości w błędzie.

ComputeNodeDeallocationOption

Wyliczenie

Określa, co należy zrobić z węzłem i uruchomionymi zadaniami po wybraniu go do cofnięcia przydziału.

Wartość	Opis
Requeue	Kończenie uruchomionych procesów zadań i ponowne kolejki zadań podrzędnych. Zadania zostaną uruchomione ponownie po udostępnieniu węzła. Usuń węzły natychmiast po zakończeniu zadań.
Terminate	Kończenie uruchomionych zadań. Zadania zostaną ukończone z informacją o niepowodzeniu wskazującym, że zostały one zakończone i nie zostaną uruchomione ponownie. Usuń węzły natychmiast po zakończeniu zadań.
TaskCompletion	Zezwalaj na wykonywanie aktualnie uruchomionych zadań. Zaplanuj brak nowych zadań podczas oczekiwania. Usuń węzły po zakończeniu wszystkich zadań.
RetainedData	Przestarzałe, zachęcamy do przekazywania danych zadania do usługi Azure Storage w zadaniu i używania TaskCompletion zamiast niego. Zezwalaj na ukończenie aktualnie uruchomionych zadań, a następnie poczekaj na wygaśnięcie wszystkich okresów przechowywania danych zadań. Zaplanuj brak nowych zadań podczas oczekiwania. Usuń węzły, gdy wszystkie okresy przechowywania zadań wygasły.

ComputeNodeFillType

Wyliczenie

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

Wartość	Opis
Spread	Zadania powinny być przypisywane równomiernie we wszystkich węzłach w puli.
Pack	Jak najwięcej zadań (taskSlotsPerNode) należy przypisać do każdego węzła w puli, zanim wszystkie zadania zostaną przypisane do następnego węzła w puli.

ComputeNodeIdentityReference

Sprzeciwiać się

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

Sprzeciwiać się

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 pochodzić 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 w tym miejscu.
type	ContainerType	Technologia kontenera do użycia.

ContainerHostBatchBindMountEntry

Sprzeciwiać się

Wpis ścieżki i trybu instalacji, który chcesz zainstalować w kontenerze zadań.

Nazwa	Typ	Opis
isReadOnly	boolean	Zainstaluj tę ścieżkę źródłową jako tryb tylko do odczytu lub nie. Wartość domyślna to false (tryb odczytu/zapisu). W przypadku systemu Linux, jeśli zainstalujesz tę ścieżkę jako tryb odczytu/zapisu, nie oznacza to, że wszyscy użytkownicy w kontenerze mają dostęp do odczytu/zapisu dla ścieżki, zależy to od dostępu na maszynie wirtualnej hosta. Jeśli ta ścieżka jest instalowana tylko do odczytu, wszyscy użytkownicy w kontenerze nie będą mogli modyfikować ścieżki.
source	ContainerHostDataPath	Ścieżki, które zostaną zainstalowane w kontenerze zadania kontenera.

ContainerHostDataPath

Wyliczenie

Ścieżki, które zostaną zainstalowane w kontenerze zadania kontenera.

Wartość	Opis
Shared	Ścieżka zadania obejmującego wiele wystąpień w celu udostępnienia plików.
Startup	Ścieżka zadania podrzędnego uruchamiania.
VfsMounts	Ścieżka zawiera wszystkie wirtualne systemy plików są instalowane w tym węźle.
Task	Ścieżka zadania.
JobPrep	Ścieżka zadania przygotowania zadania.
Applications	Ścieżka aplikacji.

ContainerRegistry

Sprzeciwiać się

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 usługi 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 (password)	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

Wyliczenie

Technologia kontenera do użycia.

Wartość	Opis
DockerCompatible	Technologia kontenera zgodna z platformą Docker będzie używana do uruchamiania kontenerów.
CriCompatible	Technologia oparta na cri będzie używana do uruchamiania kontenerów.

ContainerWorkingDirectory

Wyliczenie

Flaga wskazująca, gdzie znajduje się katalog roboczy zadania kontenera. Wartość domyślna to "taskWorkingDirectory".

Wartość	Opis
TaskWorkingDirectory	Użyj standardowego katalogu roboczego zadania usługi Batch, który będzie zawierać pliki zasobów zadania wypełnione przez usługę Batch.
ContainerImageDefault	Używanie zdefiniowanego katalogu roboczego obrazu kontenera. Należy pamiętać, że ten katalog nie będzie zawierać plików zasobów pobranych przez usługę Batch.

createdByType

Wyliczenie

Typ tożsamości, która utworzyła zasób.

Wartość	Opis
User
Application
ManagedIdentity
Key

DataDisk

Sprzeciwiać się

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 maszyny wirtualnej, aby ich używać.

Nazwa	Typ	Opis
caching	CachingType	Typ buforowania, który ma być włączony dla dysku. Wartości to: none — tryb buforowania dysku nie jest włączony. readOnly — tryb buforowania dysku jest tylko do odczytu. readWrite — tryb buforowania dysku jest odczytywany i zapisywany. 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 (int32)	Początkowy rozmiar dysku w GB podczas tworzenia nowego dysku danych.
lun	integer (int32)	Numer jednostki logicznej. Jednostka lun służy do unikatowego identyfikowania każdego dysku danych. W przypadku dołączania wielu dysków każda z nich powinna mieć odrębną jednostkę lun. Wartość musi należeć do przedziału od 0 do 63 włącznie.
storageAccountType	StorageAccountType	Typ konta magazynu do użycia podczas tworzenia dysków danych lub dysku systemu operacyjnego. W przypadku pominięcia wartość domyślna to "Standard_LRS". Wartości to: Standard_LRS — dysk danych powinien używać standardowego magazynu lokalnie nadmiarowego. Premium_LRS — dysk danych powinien używać magazynu lokalnie nadmiarowego w warstwie Premium.

DeploymentConfiguration

Sprzeciwiać się

Właściwości konfiguracji wdrożenia.

Nazwa	Typ	Opis
virtualMachineConfiguration	VirtualMachineConfiguration	Konfiguracja maszyny wirtualnej dla puli. Konfiguracja węzłów obliczeniowych w puli oparta na infrastrukturze usługi Azure Virtual Machines.

DiffDiskPlacement

Wyliczenie

Miejsce, gdzie powinien być umieszczony dysk systemu operacyjnego.

Wartość	Opis
CacheDisk	Dysk systemu operacyjnego zostanie umieszczony na dysku pamięci podręcznej maszyny wirtualnej.

DiffDiskSettings

Sprzeciwiać się

Określa efemeryczne ustawienia dysku dla dysku systemu operacyjnego używanego przez maszynę wirtualną.

Nazwa	Typ	Opis
placement	DiffDiskPlacement	Określa efemeryczne umieszczanie dysku dla 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ę, w której powinien znajdować się system operacyjny. np. miejsce na dysku pamięci podręcznej na potrzeby aprowizacji efemerycznego dysku systemu operacyjnego. Aby uzyskać więcej informacji na temat wymagań dotyczących rozmiaru dysku systemu operacyjnego efemerycznego, zapoznaj się z wymaganiami dotyczącymi rozmiaru dysku efemerycznego systemu operacyjnego dla maszyn wirtualnych z systemem Windows na https://learn.microsoft.com/azure/virtual-machines/windows/ephemeral-os-disks#size-requirements i maszynach wirtualnych z systemem Linux w https://learn.microsoft.com/azure/virtual-machines/linux/ephemeral-os-disks#size-requirements.

DiskEncryptionConfiguration

Sprzeciwiać się

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 przy użyciu obrazu maszyny wirtualnej lub obrazu galerii obliczeń platformy Azure.

Nazwa	Typ	Opis
targets	DiskEncryptionTarget[]	Lista dysków docelowych obiektów docelowych usługi Batch zostanie zaszyfrowana w węźle obliczeniowym W puli systemu Linux obsługiwana jest tylko opcja "TemporaryDisk"; w puli systemu Windows należy określić wartości "OsDisk" i "TemporaryDisk".

DiskEncryptionTarget

Wyliczenie

W przypadku pominięcia żadne dyski w węzłach obliczeniowych w puli nie będą szyfrowane.

Wartość	Opis
OsDisk	Dysk systemu operacyjnego w węźle obliczeniowym jest szyfrowany.
TemporaryDisk	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

Wyliczenie

Zakres dynamicznego przypisania sieci wirtualnej.

Wartość	Opis
none	Nie włączono dynamicznego przypisania sieci wirtualnej.
job	Dynamiczne przypisywanie sieci wirtualnej jest wykonywane na zadanie. Jeśli ta wartość jest ustawiona, należy również ustawić identyfikator podsieci konfiguracji sieci. Ta funkcja wymaga zatwierdzenia przed użyciem. Skontaktuj się z pomocą techniczną

ElevationLevel

Wyliczenie

Poziom podniesienia uprawnień użytkownika.

Wartość	Opis
NonAdmin	Użytkownik jest użytkownikiem standardowym bez podwyższonego poziomu dostępu.
Admin	Użytkownik jest użytkownikiem z podwyższonym poziomem dostępu i działa z pełnymi uprawnieniami administratora.

EnvironmentSetting

Sprzeciwiać się

Zmienna środowiskowa, która ma być ustawiana w procesie zadania.

Nazwa	Typ	Opis
name	string	Nazwa zmiennej środowiskowej.
value	string	Wartość zmiennej środowiskowej.

FixedScaleSettings

Sprzeciwiać się

Naprawiono ustawienia skalowania dla puli.

Nazwa	Typ	Wartość domyślna	Opis
nodeDeallocationOption	ComputeNodeDeallocationOption		Określa, co zrobić z węzłem i uruchomionymi zadaniami, jeśli rozmiar puli zostanie zmniejszony. W przypadku pominięcia wartość domyślna to Requeue.
resizeTimeout	string (duration)	PT15M	Limit czasu alokacji węzłów obliczeniowych do puli. Wartość domyślna to 15 minut. Wartości limitu czasu używają formatu ISO 8601. Na przykład użyj pt10M przez 10 minut. Minimalna wartość to 5 minut. Jeśli określisz wartość mniejszą niż 5 minut, usługa Batch odrzuci żądanie z błędem; Jeśli bezpośrednio wywołujesz interfejs API REST, kod stanu HTTP to 400 (Nieprawidłowe żądanie).
targetDedicatedNodes	integer (int32)		Żądana liczba dedykowanych węzłów obliczeniowych w puli. Należy ustawić co najmniej jeden z elementów targetDedicatedNodes, targetLowPriorityNodes.
targetLowPriorityNodes	integer (int32)		Żądana liczba węzłów obliczeniowych typu spot/o niskim priorytcie w puli. Należy ustawić co najmniej jeden z elementów targetDedicatedNodes, targetLowPriorityNodes.

ImageReference

Sprzeciwiać się

Odwołanie do obrazu witryny Marketplace usługi Azure Virtual Machines lub zasobu obrazu platformy Azure niestandardowej maszyny wirtualnej. Aby uzyskać listę wszystkich elementów imageReferences zweryfikowanych przez usługę Azure Batch, zobacz operację "Lista obsługiwanych jednostek SKU agenta węzła".

Nazwa	Typ	Opis
communityGalleryImageId	string	Unikatowy identyfikator obrazu galerii społeczności Ta właściwość wzajemnie wyklucza się z innymi właściwościami i może być pobierana z wywołania GET obrazu galerii społeczności.
id	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/gallerys/{galleryName}/images/{imageDefinitionName}/versions/{versionId}. Ta właściwość wzajemnie wyklucza się z innymi właściwościami. Obraz z galerii obliczeń platformy Azure musi mieć repliki w tym samym regionie co konto usługi Azure Batch. Aby uzyskać informacje o ustawieniach zapory dla agenta węzła usługi Batch do komunikowania się z usługą Batch, zobacz https://learn.microsoft.com/azure/batch/batch-api-basics#virtual-network-vnet-and-firewall-configuration.
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.
sharedGalleryImageId	string	Unikatowy identyfikator obrazu galerii udostępnionej Ta właściwość wzajemnie wyklucza się z innymi właściwościami i może zostać pobrana z wywołania GET obrazu galerii udostępnionej.
sku	string	Jednostka SKU obrazu witryny Azure Virtual Machines Marketplace. Na przykład 18.04-LTS lub 2022-datacenter.
version	string	Wersja obrazu witryny Marketplace usługi Azure Virtual Machines. Można określić wartość "latest", aby wybrać najnowszą wersję obrazu. W przypadku pominięcia wartość domyślna to "latest".

InboundEndpointProtocol

Wyliczenie

Protokół punktu końcowego.

Wartość	Opis
TCP	Użyj protokołu TCP dla punktu końcowego.
UDP	Użyj protokołu UDP dla punktu końcowego.

InboundNatPool

Sprzeciwiać się

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 (int32)	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 29876 i 29877, ponieważ są one zarezerwowane. Jeśli podano jakiekolwiek wartości zarezerwowane, żądanie zakończy się niepowodzeniem z kodem stanu HTTP 400.
frontendPortRangeEnd	integer (int32)	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ć. Jeśli jakiekolwiek wartości zarezerwowane lub nakładające się zostaną dostarczone, żądanie zakończy się niepowodzeniem z kodem stanu HTTP 400.
frontendPortRangeStart	integer (int32)	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ć. Jeśli jakiekolwiek wartości zarezerwowane lub nakładające się zostaną dostarczone, żądanie zakoń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 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.

InterNodeCommunicationState

Wyliczenie

Nakłada to ograniczenia dotyczące węzłów, które można przypisać do puli. Włączenie tej wartości może zmniejszyć prawdopodobieństwo przydzielenia żądanej liczby węzłów w puli. Jeśli nie zostanie określona, ta wartość jest domyślnie ustawiona na wartość "Wyłączone".

Wartość	Opis
Enabled	Włącz komunikację siecią między maszynami wirtualnymi.
Disabled	Wyłącz komunikację siecią między maszynami wirtualnymi.

IPAddressProvisioningType

Wyliczenie

Typ aprowizacji dla publicznych adresów IP dla puli usługi Batch.

Wartość	Opis
BatchManaged	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.
UserManaged	Publiczne adresy IP są udostępniane przez użytkownika i będą używane do aprowizowania węzłów obliczeniowych.
NoPublicIPAddresses	Nie zostanie utworzony publiczny adres IP dla węzłów obliczeniowych w puli.

LinuxUserConfiguration

Sprzeciwiać się

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

Nazwa	Typ	Opis
gid	integer (int32)	Identyfikator grupy dla konta użytkownika. Właściwości uid i gid muszą być określone razem lub w ogóle. Jeśli nie określono bazowego systemu operacyjnego, wybiera gid.
sshPrivateKey	string (password)	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 w puli systemu Linux, gdy właściwość enableInterNodeCommunication puli ma wartość true (jest ignorowana, jeśli właściwość enableInterNodeCommunication ma wartość false). Robi to przez umieszczenie pary 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 (nie jest wykonywana żadna modyfikacja katalogu .ssh użytkownika).
uid	integer (int32)	Identyfikator użytkownika konta użytkownika. Właściwości uid i gid muszą być określone razem lub w ogóle. Jeśli nie określono bazowego systemu operacyjnego, wybierze identyfikator uid.

LoginMode

Wyliczenie

Określa tryb logowania użytkownika. Wartość domyślna to Interactive.

Wartość	Opis
Batch	Tryb logowania LOGON32_LOGON_BATCH Win32. Tryb logowania wsadowego jest zalecany w przypadku długotrwałych procesów równoległych.
Interactive	Tryb logowania LOGON32_LOGON_INTERACTIVE Win32. Niektóre aplikacje wymagają uprawnień skojarzonych z trybem logowania interakcyjnego. Jeśli tak jest w przypadku aplikacji używanej w zadaniu, zaleca się użycie tej opcji.

ManagedDisk

Sprzeciwiać się

Nazwa	Typ	Opis
securityProfile	VMDiskSecurityProfile	Określa profil zabezpieczeń dysku zarządzanego. Określa ustawienia profilu zabezpieczeń dla dysku zarządzanego. Uwaga: można go ustawić tylko dla poufnych maszyn wirtualnych i jest wymagany podczas korzystania z poufnych maszyn wirtualnych.
storageAccountType	StorageAccountType	Typ konta magazynu do użycia podczas tworzenia dysków danych lub dysku systemu operacyjnego.

MetadataItem

Sprzeciwiać się

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

Nazwa	Typ	Opis
name	string	Nazwa elementu metadanych.
value	string	Wartość elementu metadanych.

MountConfiguration

Sprzeciwiać się

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 funkcji FUSE obiektu blob w każdym węźle. Ta właściwość wzajemnie wyklucza się 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ść wzajemnie wyklucza się 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ść wzajemnie wyklucza się ze wszystkimi innymi właściwościami.
nfsMountConfiguration	NFSMountConfiguration	System plików NFS do zainstalowania w każdym węźle. Ta właściwość wzajemnie wyklucza się ze wszystkimi innymi właściwościami.

NetworkConfiguration

Sprzeciwiać się

Konfiguracja sieci dla puli.

Nazwa	Typ	Wartość domyślna	Opis
dynamicVnetAssignmentScope	DynamicVNetAssignmentScope	none	Zakres dynamicznego przypisania sieci wirtualnej.
enableAcceleratedNetworking	boolean		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 dla puli.
publicIPAddressConfiguration	PublicIPAddressConfiguration		Konfiguracja publicznego adresu IPAddress dla węzłów obliczeniowych w puli usługi Batch. Konfiguracja publicznego adresu IP konfiguracji sieci puli.
subnetId	string		Identyfikator zasobu usługi ARM podsieci sieci wirtualnej, do której będą 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 usługi Azure Batch. Określona podsieć powinna mieć wystarczającą liczbę wolnych adresów IP, aby pomieścić liczbę węzłów w puli. Jeśli podsieć nie ma wystarczającej liczby wolnych adresów IP, pula częściowo przydzieli węzły obliczeniowe i wystąpi błąd zmiany rozmiaru. Jednostka usługi "MicrosoftAzureBatch" musi mieć rolę "Klasyczny współautor maszyny wirtualnej" Role-Based kontroli dostępu (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 obliczeniowych. Można to sprawdzić, sprawdzając, czy określona sieć wirtualna ma skojarzone sieciowe grupy zabezpieczeń. Jeśli komunikacja z węzłami obliczeniowymi w określonej podsieci zostanie odrzucona przez sieciową grupę zabezpieczeń, usługa Batch ustawi stan węzłów obliczeniowych na bezużyteczny. Jeśli określona sieć wirtualna ma skojarzone sieciowe grupy zabezpieczeń, należy włączyć kilka zarezerwowanych portów systemowych dla komunikacji przychodzącej, w tym portów 29876 i 29877. Włącz również połączenia wychodzące z usługą Azure Storage na porcie 443. Aby uzyskać więcej informacji, zobacz: https://learn.microsoft.com/azure/batch/batch-api-basics#virtual-network-vnet-and-firewall-configuration

NetworkSecurityGroupRule

Sprzeciwiać się

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 (int32)	Priorytet tej reguły. Priorytety w puli muszą być unikatowe i oceniane według priorytetu. Im niższa liczba, tym wyższy priorytet. Na przykład można określić reguły z liczbami zamówień 150, 250 i 350. Reguła z numerem porządkowym 150 ma pierwszeństwo przed regułą, która ma kolejność 250. Dozwolone priorytety to od 150 do 4096. Jeśli jakiekolwiek wartości zarezerwowane lub zduplikowane zostaną dostarczone, żądanie zakończy się niepowodzeniem z kodem stanu HTTP 400.
sourceAddressPrefix	string	Prefiks adresu źródłowego lub tag, 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) lub tablice portów lub zakresów portów (tj. 100–200). Porty powinny mieścić się w zakresie od 0 do 65535, a zakresy portów lub porty nie mogą się nakładać. Jeśli podano inne wartości, żądanie zakończy się niepowodzeniem z kodem stanu HTTP 400. Wartość domyślna to *.

NetworkSecurityGroupRuleAccess

Wyliczenie

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

Wartość	Opis
Allow	Zezwalaj na dostęp.
Deny	Odmowa dostępu.

NFSMountConfiguration

Sprzeciwiać się

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 systemach Windows i "instalowanie" 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

Wyliczenie

Określa, jak pula komunikuje się z usługą Batch.

Wartość	Opis
Default	Tryb komunikacji węzła jest automatycznie ustawiany przez usługę Batch.
Classic	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}.
Simplified	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

Sprzeciwiać się

Konfiguracja umieszczania węzłów dla pul wsadowych.

Nazwa	Typ	Opis
policy	NodePlacementPolicyType	Zasady umieszczania dla przydzielania węzłów w puli. 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

Wyliczenie

Domyślna wartość to regionalna.

Wartość	Opis
Regional	Wszystkie węzły w puli zostaną przydzielone w tym samym regionie.
Zonal	Węzły w puli będą rozmieszczone w różnych strefach z najlepszym rozwiązaniem.

OSDisk

Sprzeciwiać się

Ustawienia dysku systemu operacyjnego maszyny wirtualnej.

Nazwa	Typ	Opis
caching	CachingType	Typ buforowania, który ma być włączony dla dysku.
diskSizeGB	integer (int32)	Początkowy rozmiar dysku w GB podczas tworzenia nowego dysku systemu operacyjnego.
ephemeralOSDiskSettings	DiffDiskSettings	Określa efemeryczne ustawienia dysku dla dysku systemu operacyjnego używanego przez maszynę wirtualną.
managedDisk	ManagedDisk	Parametry dysku zarządzanego.
writeAcceleratorEnabled	boolean	Określa, czy na dysku należy włączyć lub wyłączyć funkcję writeAccelerator.

Pool

Sprzeciwiać się

Zawiera informacje o puli.

Nazwa	Typ	Wartość domyślna	Opis
etag	string		Element ETag zasobu używany na potrzeby instrukcji współbieżności.
id	string (arm-id)		W pełni kwalifikowany identyfikator zasobu dla zasobu. Np. "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
identity	BatchPoolIdentity		Typ tożsamości używany dla puli usługi Batch.
name	string		Nazwa zasobu
properties.allocationState	AllocationState		Określa, czy pula zmienia rozmiar.
properties.allocationStateTransitionTime	string (date-time)		Czas, w którym pula wprowadziła bieżący stan alokacji.
properties.applicationLicenses	string[]		Lista licencji aplikacji, które usługa Batch udostępni 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.
properties.applicationPackages	ApplicationPackageReference[]		Lista pakietów aplikacji do zainstalowania w każdym węźle obliczeniowym w puli. Zmiany odwołań do pakietu aplikacji mają wpływ na wszystkie nowe węzły obliczeniowe łą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 z obrazu. W dowolnej puli istnieje maksymalnie 10 odwołań do pakietu aplikacji.
properties.autoScaleRun	AutoScaleRun		Wyniki i błędy z ostatniego wykonania formuły autoskalowania. Ta właściwość jest ustawiana tylko wtedy, gdy pula jest automatycznie skalowana, tj. są używane ustawienia autoskalowania.
properties.certificates	CertificateReference[]		Lista certyfikatów do zainstalowania w każdym węźle obliczeniowym w puli. W przypadku węzłów obliczeniowych 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.
properties.creationTime	string (date-time)		Czas tworzenia puli.
properties.currentDedicatedNodes	integer (int32)		Liczba dedykowanych węzłów obliczeniowych obecnie w puli.
properties.currentLowPriorityNodes	integer (int32)		Liczba węzłów obliczeniowych typu spot/o niskim priorytcie obecnie w puli.
properties.currentNodeCommunicationMode	NodeCommunicationMode		Określa, jak pula komunikuje się z usługą Batch.
properties.deploymentConfiguration	DeploymentConfiguration		Ta właściwość opisuje maszyny wirtualne, na których będą wdrażane węzły puli. Właściwości konfiguracji wdrożenia.
properties.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.
properties.interNodeCommunication	InterNodeCommunicationState		Określa, czy pula zezwala na bezpośrednią komunikację między węzłami. Nakłada to ograniczenia dotyczące węzłów, które można przypisać do puli. Włączenie tej wartości może zmniejszyć prawdopodobieństwo przydzielenia żądanej liczby węzłów w puli. Jeśli nie zostanie określona, ta wartość jest domyślnie ustawiona na wartość "Wyłączone".
properties.lastModified	string (date-time)		Czas ostatniej modyfikacji puli. Jest to ostatni raz, w którym dane na poziomie puli, takie jak targetDedicatedNodes lub autoScaleSettings, uległy zmianie. Nie uwzględnia zmian na poziomie węzła, takich jak zmiana stanu węzła obliczeniowego.
properties.metadata	MetadataItem[]		Lista par name-value skojarzonych z pulą jako metadanych. Usługa Batch nie przypisuje żadnego znaczenia metadanym; służy wyłącznie do używania kodu użytkownika.
properties.mountConfiguration	MountConfiguration[]		Lista systemów plików do zainstalowania w każdym węźle w puli. Obsługuje to usługi Azure Files, NFS, CIFS/SMB i Blobfuse.
properties.networkConfiguration	NetworkConfiguration		Konfiguracja sieci dla puli. Konfiguracja sieci dla puli.
properties.provisioningState	PoolProvisioningState		Bieżący stan puli.
properties.provisioningStateTransitionTime	string (date-time)		Czas, w którym pula weszła w bieżący stan.
properties.resizeOperationStatus	ResizeOperationStatus		Zawiera szczegółowe informacje o bieżącej lub ostatniej zakończonej operacji zmiany rozmiaru. Opisuje bieżącą operację (jeśli parametr AllocationState puli zmienia rozmiar) lub wcześniej ukończoną operację (jeśli wartość AllocationState jest stała).
properties.resourceTags	object		Tagi określone przez użytkownika skojarzone z pulą. Tagi zdefiniowane przez użytkownika, które mają być skojarzone z pulą usługi 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".
properties.scaleSettings	ScaleSettings		Ustawienia, które konfigurują liczbę węzłów w puli. Definiuje żądany rozmiar puli. Może to być wartość "fixedScale", w której określono żądany element targetDedicatedNodes lub "autoScale", który definiuje formułę, która jest okresowo ponownie obliczana. Jeśli ta właściwość nie zostanie określona, pula będzie mieć stałą skalę z 0 targetDedicatedNodes.
properties.startTask	StartTask		Zadanie określone do uruchomienia w każdym węźle obliczeniowym podczas dołączania do puli. W operacji PATCH (update) tę właściwość można ustawić na pusty obiekt, aby usunąć zadanie uruchamiania z puli.
properties.targetNodeCommunicationMode	NodeCommunicationMode		Określa, jak pula komunikuje się z usługą Batch. W przypadku pominięcia wartość domyślna to Wartość domyślna.
properties.taskSchedulingPolicy	TaskSchedulingPolicy		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.
properties.taskSlotsPerNode	integer (int32)	1	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 od 4 razy liczbie rdzeni rozmiaru maszyny wirtualnej puli lub 256.
properties.upgradePolicy	UpgradePolicy		Zasady uaktualniania puli. Opisuje zasady uaktualniania — automatyczne, ręczne lub stopniowe.
properties.userAccounts	UserAccount[]		Lista kont użytkowników do utworzenia w każdym węźle w puli.
properties.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, zobacz Rozmiary maszyn wirtualnych na platformie Azure (https://learn.microsoft.com/azure/virtual-machines/sizes/overview). 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).
systemData	systemData		Metadane usługi Azure Resource Manager zawierające informacje „createdBy” i „modifiedBy”.
tags	object		Tagi zasobu.
type	string		Typ zasobu. Np. "Microsoft.Compute/virtualMachines" lub "Microsoft.Storage/storageAccounts"

PoolEndpointConfiguration

Sprzeciwiać się

Konfiguracja punktu końcowego dla puli.

Nazwa	Typ	Opis
inboundNatPools	InboundNatPool[]	Lista pul nat dla ruchu przychodzącego, które mogą służyć do adresowania określonych portów na 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.

PoolIdentityType

Wyliczenie

Typ tożsamości używany dla puli usługi Batch.

Wartość	Opis
UserAssigned	Pula usługi Batch ma przypisane przez użytkownika tożsamości.
None	Pula usługi Batch nie ma skojarzonej tożsamości. Ustawienie None w puli aktualizacji spowoduje usunięcie istniejących tożsamości.

PoolProvisioningState

Wyliczenie

Bieżący stan puli.

Wartość	Opis
Succeeded	Pula jest dostępna do uruchamiania zadań podlegających dostępności węzłów obliczeniowych.
Deleting	Użytkownik zażądał usunięcia puli, ale operacja usuwania nie została jeszcze ukończona.

PublicIPAddressConfiguration

Sprzeciwiać się

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 tutaj 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 wymagając 250 dedykowanych maszyn wirtualnych wymaga co najmniej 3 publicznych adresów IP. 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 usługi Batch. Wartość domyślna to BatchManaged

ResizeError

Sprzeciwiać się

Wystąpił błąd podczas zmiany rozmiaru puli.

Nazwa	Typ	Opis
code	string	Identyfikator błędu. Kody są niezmienne i mają być używane programowo.
details	ResizeError[]	Dodatkowe szczegóły dotyczące błędu.
message	string	Komunikat opisujący błąd, który ma być odpowiedni do wyświetlania w interfejsie użytkownika.

ResizeOperationStatus

Sprzeciwiać się

Szczegółowe informacje o bieżącej lub ostatniej zakończonej operacji zmiany rozmiaru.

Nazwa	Typ	Opis
errors	ResizeError[]	Szczegóły błędów napotkanych podczas ostatniej zmiany rozmiaru puli. Ta właściwość jest ustawiana tylko wtedy, gdy wystąpił błąd podczas ostatniej zmiany rozmiaru puli i tylko wtedy, gdy właściwość allocationState puli jest stała.
nodeDeallocationOption	ComputeNodeDeallocationOption	Określa, co należy zrobić z węzłem i uruchomionymi zadaniami po wybraniu go do cofnięcia przydziału. Wartość domyślna to ponowne kolejki.
resizeTimeout	string (duration)	Limit czasu alokacji węzłów obliczeniowych do puli lub usunięcia węzłów obliczeniowych z puli. 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).
startTime	string (date-time)	Czas rozpoczęcia tej operacji zmiany rozmiaru.
targetDedicatedNodes	integer (int32)	Żądana liczba dedykowanych węzłów obliczeniowych w puli.
targetLowPriorityNodes	integer (int32)	Żądana liczba węzłów obliczeniowych typu spot/o niskim priorytcie w puli.

ResourceFile

Sprzeciwiać się

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

Nazwa	Typ	Opis
autoStorageContainerName	string	Nazwa kontenera magazynu na koncie automatycznego magazynu. 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, zostaną pobrane wszystkie pliki w kontenerze.
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 elementu resourceFile, który zostanie pobrany do węzła systemu Windows. Jeśli ta właściwość nie zostanie określona dla węzła systemu Linux, do pliku zostanie zastosowana wartość domyślna 0770.
filePath	string	Lokalizacja w węźle obliczeniowym, do którego ma być pobierany plik, względem katalogu roboczego zadania. Jeśli określono właściwość httpUrl, 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 filePath 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 przerwać katalogu roboczego zadania (na przykład przy użyciu ".".
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 usługę Azure Blob Storage, musi być czytelny z węzłów obliczeniowych. Istnieją trzy sposoby uzyskiwania takiego adresu URL dla obiektu blob w usłudze Azure Storage: obejmują sygnaturę dostępu współdzielonego udzielając uprawnień do odczytu dla obiektu blob, używanie tożsamości zarządzanej z uprawnieniami do odczytu lub ustawianie listy ACL dla obiektu blob lub kontenera, aby zezwolić na dostęp publiczny.
identityReference	ComputeNodeIdentityReference	Odwołanie do tożsamości przypisanej przez użytkownika w celu uzyskania dostępu do usługi Azure Blob Storage określonej przez wartość storageContainerUrl lub httpUrl 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.
storageContainerUrl	string	Adres URL kontenera obiektów blob w usłudze 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 uzyskania takiego adresu URL dla kontenera w usłudze Azure Storage: obejmują sygnaturę dostępu współdzielonego (SAS) udzielając uprawnień do odczytu i listy w kontenerze, używanie tożsamości zarządzanej z uprawnieniami do odczytu i listy lub ustawianie listy ACL dla kontenera, aby zezwolić na dostęp publiczny.

RollingUpgradePolicy

Sprzeciwiać się

Parametry konfiguracji używane podczas uaktualniania stopniowego.

Nazwa	Typ	Opis
enableCrossZoneUpgrade	boolean	Zezwalaj usłudze VMSS na ignorowanie granic az podczas konstruowania partii uaktualniania. Weź pod uwagę domenę aktualizacji i parametr maxBatchInstancePercent w celu określenia rozmiaru partii. Jeśli to pole nie jest ustawione, usługa Azure Batch nie ustawi wartości domyślnej. Wartość enableCrossZoneUpgrade w utworzonym elemercie VirtualMachineScaleSet zostanie podjęta domyślnie w konfiguracji elementu VirtualMachineScaleSet. To pole może być ustawione na wartość true lub false tylko w przypadku używania wartości NodePlacementConfiguration jako strefowej.
maxBatchInstancePercent	integer (int32) minimum: 5 maximum: 100	Maksymalny procent łącznych wystąpień maszyn wirtualnych, które zostaną uaktualnione jednocześnie przez uaktualnienie stopniowe w jednej partii. Ponieważ jest to maksimum, wystąpienia w złej kondycji w poprzednich lub przyszłych partiach mogą spowodować spadek procentu wystąpień w partii w celu zapewnienia większej niezawodności. Wartość tego pola powinna należeć do zakresu od 5 do 100 włącznie. Jeśli parametr maxBatchInstancePercent i maxUnhealthyInstancePercent są przypisywane z wartością, wartość maxBatchInstancePercent nie powinna być większa niż wartość maxUnhealthyInstancePercent.
maxUnhealthyInstancePercent	integer (int32) minimum: 5 maximum: 100	Maksymalny procent łącznej liczby wystąpień maszyn wirtualnych w zestawie skalowania, które mogą być jednocześnie w złej kondycji, w wyniku uaktualnienia lub przez odnalezienie w stanie złej kondycji przez kontrolę kondycji maszyny wirtualnej przed przerwaniem uaktualnienia stopniowego. To ograniczenie zostanie sprawdzone przed uruchomieniem dowolnej partii. Wartość tego pola powinna należeć do zakresu od 5 do 100 włącznie. Jeśli parametr maxBatchInstancePercent i maxUnhealthyInstancePercent są przypisywane z wartością, wartość maxBatchInstancePercent nie powinna być większa niż wartość maxUnhealthyInstancePercent.
maxUnhealthyUpgradedInstancePercent	integer (int32) minimum: 0 maximum: 100	Maksymalny procent uaktualnionych wystąpień maszyn wirtualnych, które można znaleźć w złej kondycji. Ta kontrola będzie miała miejsce po uaktualnieniu każdej partii. Jeśli ta wartość procentowa zostanie kiedykolwiek przekroczona, przerywa się aktualizacja stopniowa. Wartość tego pola powinna należeć do zakresu od 0 do 100 włącznie.
pauseTimeBetweenBatches	string	Czas oczekiwania między ukończeniem aktualizacji dla wszystkich maszyn wirtualnych w jednej partii a uruchomieniem następnej partii. Czas trwania należy określić w formacie ISO 8601.
prioritizeUnhealthyInstances	boolean	Uaktualnij wszystkie wystąpienia w złej kondycji w zestawie skalowania przed wszelkimi wystąpieniami w dobrej kondycji.
rollbackFailedInstancesOnPolicyBreach	boolean	Wycofywanie nie powiodło się wystąpienia do poprzedniego modelu, jeśli zasady uaktualniania stopniowego zostały naruszone.

ScaleSettings

Sprzeciwiać się

Ustawienia skalowania puli

Nazwa	Typ	Opis
autoScale	AutoScaleSettings	Ustawienia autoskalowania dla puli. Ta właściwość i stałaSkala wzajemnie się wykluczają i należy określić jedną z właściwości.
fixedScale	FixedScaleSettings	Naprawiono ustawienia skalowania dla puli. Ta właściwość i autoSkalowanie wzajemnie się wykluczają i należy określić jedną z właściwości.

SecurityEncryptionTypes

Wyliczenie

Określa typ szyfrowania dysku zarządzanego. Jest ona ustawiona na VMGuestStateOnly na potrzeby szyfrowania tylko obiektu blob VMGuestState i nonPersistedTPM dla nietrwałego stanu oprogramowania układowego w obiekcie blob VMGuestState. Uwaga: można ją ustawić tylko dla poufnych maszyn wirtualnych i wymaganych podczas korzystania z poufnych maszyn wirtualnych.

Wartość	Opis
NonPersistedTPM
VMGuestStateOnly

SecurityProfile

Sprzeciwiać się

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/tymczasowego na samym hoście.
securityType	SecurityTypes	Określa typ zabezpieczeń maszyny wirtualnej. Musi być ustawiona na dowolną określoną wartość, aby włączyć interfejs UefiSettings.
uefiSettings	UefiSettings	Określa ustawienia zabezpieczeń, takie jak bezpieczny rozruch i maszyna wirtualna vTPM używane podczas tworzenia maszyny wirtualnej.

SecurityTypes

Wyliczenie

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

Wartość	Opis
trustedLaunch	Zaufane uruchamianie chroni przed zaawansowanymi i trwałymi technikami ataków.
confidentialVM	Poufne przetwarzanie na platformie Azure oferuje poufne maszyny wirtualne przeznaczone dla dzierżaw z wysokimi wymaganiami dotyczącymi zabezpieczeń i poufności. Te maszyny wirtualne zapewniają silną, wymuszaną sprzętowo granicę, która pomaga spełnić twoje potrzeby w zakresie zabezpieczeń. Możesz użyć poufnych maszyn wirtualnych do migracji bez wprowadzania zmian w kodzie, a platforma chroni stan maszyny wirtualnej przed odczytem lub zmodyfikowaniem.

ServiceArtifactReference

Sprzeciwiać się

Określa identyfikator odwołania 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.

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

Sprzeciwiać się

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

Nazwa	Typ	Wartość domyślna	Opis
commandLine	string		Wiersz polecenia zadania uruchamiania. Wiersz polecenia nie jest uruchamiany w powłoce i dlatego nie może korzystać z funkcji powłoki, takich jak rozszerzenie zmiennej środowiskowej. Jeśli chcesz skorzystać 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. Wymagane, jeśli określono jakiekolwiek inne właściwości właściwości startTask.
containerSettings	TaskContainerSettings		Ustawienia kontenera, w którym jest uruchamiane zadanie uruchamiania. Po określeniu tego ustawienia wszystkie katalogi cyklicznie poniżej AZ_BATCH_NODE_ROOT_DIR (katalog główny katalogów usługi Azure Batch w węźle) są mapowane do kontenera, wszystkie zmienne środowiskowe zadań są mapowane do kontenera, a wiersz polecenia zadania jest wykonywany w kontenerze.
environmentSettings	EnvironmentSetting[]		Lista ustawień zmiennych środowiskowych dla zadania uruchamiania.
maxTaskRetryCount	integer (int32)	0	Maksymalna liczba ponownych prób wykonania zadania. Usługa Batch ponawia próbę zadania, jeśli jego kod zakończenia jest inny niżzer. Należy pamiętać, że ta wartość steruje liczbą ponownych prób. Usługa Batch spróbuje wykonać zadanie raz, 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. Wartość domyślna to 0
resourceFiles	ResourceFile[]		Lista plików, które usługa Batch pobierze do węzła obliczeniowego przed uruchomieniem wiersza polecenia.
userIdentity	UserIdentity		Tożsamość użytkownika, w ramach której jest uruchamiane zadanie uruchamiania. W przypadku pominięcia zadanie jest uruchamiane jako użytkownik niebędący administratorem unikatowym dla zadania.
waitForSuccess	boolean		Czy usługa Batch powinna czekać na pomyślne zakończenie zadania uruchamiania (czyli zakończenie z kodem zakończenia 0) przed zaplanowaniem zadań w węźle obliczeniowym. Jeśli wartość true i zadanie uruchamiania zakończy się niepowodzeniem w węźle obliczeniowym, usługa Batch ponawia próbę zadania podrzędnego uruchamiania do maksymalnej liczby ponownych prób (maxTaskRetryCount). Jeśli zadanie nadal nie zostało ukończone pomyślnie po ponownych próbach, usługa Batch oznaczy węzeł obliczeniowy jako bezużyteczny i nie będzie planować zadań podrzędnych. Ten warunek można wykryć za pomocą stanu węzła i szczegółów błędu planowania. Jeśli wartość false, usługa Batch nie będzie czekać na ukończenie zadania uruchamiania. W takim przypadku inne zadania mogą rozpocząć wykonywanie w węźle obliczeniowym, gdy zadanie uruchamiania jest nadal uruchomione; a nawet jeśli zadanie uruchamiania zakończy się niepowodzeniem, nowe zadania będą nadal zaplanowane w węźle. Wartość domyślna to true.

StorageAccountType

Wyliczenie

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

Wartość	Opis
Standard_LRS	Dysk danych/dysk systemu operacyjnego powinien używać standardowego magazynu lokalnie nadmiarowego.
Premium_LRS	Dysk danych/dysk systemu operacyjnego powinien używać magazynu lokalnie nadmiarowego w warstwie Premium.
StandardSSD_LRS	Dysk danych/dysk systemu operacyjnego powinien używać magazynu lokalnie nadmiarowego SSD w warstwie Standardowa.

systemData

Sprzeciwiać się

Metadane dotyczące tworzenia i ostatniej modyfikacji zasobu.

Nazwa	Typ	Opis
createdAt	string (date-time)	Sygnatura czasowa tworzenia zasobu (UTC).
createdBy	string	Tożsamość, która utworzyła zasób.
createdByType	createdByType	Typ tożsamości, która utworzyła zasób.
lastModifiedAt	string (date-time)	Znacznik czasu ostatniej modyfikacji zasobu (UTC)
lastModifiedBy	string	Tożsamość, która ostatnio zmodyfikowała zasób.
lastModifiedByType	createdByType	Typ tożsamości, która ostatnio zmodyfikowała zasób.

TaskContainerSettings

Sprzeciwiać się

Ustawienia kontenera dla zadania.

Nazwa	Typ	Opis
containerHostBatchBindMounts	ContainerHostBatchBindMountEntry[]	Ścieżki, które chcesz zamontować w zadaniu kontenera. Jeśli ta tablica ma wartość null lub nie istnieje, zadanie kontenera zainstaluje cały dysk tymczasowy w systemie Windows (lub AZ_BATCH_NODE_ROOT_DIR w systemie Linux). Jeśli ta tablica jest ustawiona jako pusta, nie zainstaluje żadnych ścieżek danych w kontenerze.
containerRunOptions	string	Dodatkowe opcje polecenia create kontenera. Te dodatkowe opcje są dostarczane jako argumenty polecenia "docker create" oprócz tych kontrolowanych przez usługę Batch.
imageName	string	Obraz do użycia 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 w nazwie obrazu nie podano żadnego tagu, tag ":latest" jest używany jako domyślny.
registry	ContainerRegistry	Prywatny rejestr zawierający obraz kontenera. To ustawienie można pominąć, jeśli zostało już udostępnione podczas tworzenia puli.
workingDirectory	ContainerWorkingDirectory	Flaga wskazująca, gdzie znajduje się katalog roboczy zadania kontenera. Wartość domyślna to "taskWorkingDirectory".

TaskSchedulingPolicy

Sprzeciwiać się

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

Nazwa	Typ	Wartość domyślna	Opis
nodeFillType	ComputeNodeFillType	Spread	Sposób dystrybucji zadań między węzłami obliczeniowymi.

UefiSettings

Sprzeciwiać się

Określa ustawienia zabezpieczeń, takie jak bezpieczny rozruch i maszyna wirtualna 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 maszyna wirtualna ma być włączona na maszynie wirtualnej.

UpgradeMode

Wyliczenie

Określa tryb uaktualniania maszyn wirtualnych w zestawie skalowania.

Możliwe wartości to:

ręczne — kontrolujesz stosowanie aktualizacji do maszyn wirtualnych w zestawie skalowania. W tym celu należy użyć akcji manualUpgrade.

automatyczne — wszystkie maszyny wirtualne w zestawie skalowania są automatycznie aktualizowane w tym samym czasie.

rolling — zestaw skalowania wykonuje aktualizacje w partiach z opcjonalnym czasem wstrzymania między.

Wartość	Opis
automatic	Wszystkie maszyny wirtualne w zestawie skalowania są automatycznie aktualizowane w tym samym czasie.
manual	Kontrolujesz stosowanie aktualizacji do maszyn wirtualnych w zestawie skalowania. W tym celu należy użyć akcji manualUpgrade.
rolling	Istniejące wystąpienia w zestawie skalowania są wyłączane w partiach, które mają zostać uaktualnione. Po zakończeniu uaktualniania partii wystąpienia zaczną ponownie kierować ruch, a następna partia rozpocznie się. Będzie to kontynuowane do momentu, aż wszystkie wystąpienia up-to-date.

UpgradePolicy

Sprzeciwiać się

Opisuje zasady uaktualniania — automatyczne, ręczne lub stopniowe.

Nazwa	Typ	Opis
automaticOSUpgradePolicy	AutomaticOSUpgradePolicy	Parametry konfiguracji używane do przeprowadzania automatycznego uaktualniania systemu operacyjnego.
mode	UpgradeMode	Określa tryb uaktualniania maszyn wirtualnych w zestawie skalowania. Możliwe wartości to: ręczne — kontrolujesz stosowanie aktualizacji do maszyn wirtualnych w zestawie skalowania. W tym celu należy użyć akcji manualUpgrade. automatyczne — wszystkie maszyny wirtualne w zestawie skalowania są automatycznie aktualizowane w tym samym czasie. rolling — zestaw skalowania wykonuje aktualizacje w partiach z opcjonalnym czasem wstrzymania między.
rollingUpgradePolicy	RollingUpgradePolicy	Parametry konfiguracji używane podczas uaktualniania stopniowego.

UserAccount

Sprzeciwiać się

Właściwości używane do tworzenia użytkownika w węźle usługi Azure Batch.

Nazwa	Typ	Opis
elevationLevel	ElevationLevel	Poziom podniesienia uprawnień użytkownika. nonAdmin — użytkownik automatyczny jest użytkownikiem standardowym bez podwyższonego poziomu dostępu. administrator — użytkownik automatyczny jest użytkownikiem z podwyższonym poziomem dostępu i działa z pełnymi uprawnieniami administratora. 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 jest określona w puli systemu Windows. Jeśli nie zostanie określony, użytkownik zostanie utworzony przy użyciu opcji domyślnych.
name	string	Nazwa konta użytkownika. Nazwy mogą zawierać dowolne znaki Unicode o maksymalnej długości do 20.
password	string (password)	Hasło do 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 przy użyciu opcji domyślnych.

UserAssignedIdentities

Sprzeciwiać się

Lista skojarzonych tożsamości użytkowników.

Nazwa	Typ	Opis
clientId	string	Identyfikator klienta tożsamości przypisanej przez użytkownika.
principalId	string	Identyfikator podmiotu zabezpieczeń tożsamości przypisanej przez użytkownika.

UserIdentity

Sprzeciwiać się

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ą; należy określić jeden, ale nie oba te elementy.
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ą; należy określić jeden, ale nie oba te elementy.

VirtualMachineConfiguration

Sprzeciwiać się

Konfiguracja węzłów obliczeniowych w puli oparta na infrastrukturze usługi Azure Virtual Machines.

Nazwa	Typ	Opis
containerConfiguration	ContainerConfiguration	Konfiguracja kontenera dla puli. Jeśli zostanie określony, konfiguracja jest wykonywana w każdym węźle w puli, aby umożliwić uruchamianie zadań w kontenerach. Wszystkie zwykłe zadania i zadania podrzędne menedżera zadań 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.
diskEncryptionConfiguration	DiskEncryptionConfiguration	Konfiguracja szyfrowania dysków dla puli. Jeśli określono, szyfrowanie jest wykonywane w każdym węźle w puli podczas aprowizacji węzłów.
extensions	VMExtension[]	Rozszerzenie maszyny wirtualnej dla puli. Jeśli zostanie określony, rozszerzenia wymienione w tej konfiguracji zostaną zainstalowane w każdym węźle.
imageReference	ImageReference	Odwołanie do obrazu witryny Marketplace usługi Azure Virtual Machines lub niestandardowego obrazu maszyny wirtualnej do użycia. Odwołanie do obrazu witryny Marketplace usługi Azure Virtual Machines lub zasobu obrazu platformy Azure niestandardowej maszyny wirtualnej. Aby uzyskać listę wszystkich elementów imageReferences zweryfikowanych przez usługę Azure Batch, zobacz operację "Lista obsługiwanych jednostek SKU agenta węzła".
licenseType	string	Typ licencji lokalnej do użycia podczas wdrażania systemu operacyjnego. Dotyczy to tylko obrazów zawierających system operacyjny Windows i powinny być używane tylko w przypadku przechowywania prawidłowych licencji lokalnych dla węzłów, 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 usługi Batch do aprowizowania w węzłach obliczeniowych w puli. Agent węzła usługi Batch to program uruchamiany w każdym węźle w puli i udostępnia interfejs polecenia i sterowania między węzłem a usługą Batch. Istnieją różne implementacje agenta węzła, znane jako jednostki SKU, dla różnych systemów operacyjnych. Należy określić jednostkę SKU agenta węzła zgodną z wybranym odwołaniem do obrazu. Aby uzyskać listę obsługiwanych jednostek SKU agenta węzła wraz z listą zweryfikowanych odwołań do obrazów, zobacz operację "Lista obsługiwanych jednostek SKU agenta węzła".
nodePlacementConfiguration	NodePlacementConfiguration	Konfiguracja umieszczania węzła 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. Zawiera konfigurację ustawień efemerycznego dysku OSDisk.
securityProfile	SecurityProfile	Określa ustawienia profilu zabezpieczeń dla maszyny wirtualnej lub zestawu skalowania maszyn wirtualnych.
serviceArtifactReference	ServiceArtifactReference	Określa identyfikator odwołania 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 artefaktu usługi w postaci /subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Compute/gallerys/{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 imageReference określa obraz systemu operacyjnego Linux.

VMDiskSecurityProfile

Sprzeciwiać się

Określa ustawienia profilu zabezpieczeń dla dysku zarządzanego. Uwaga: można go ustawić tylko dla poufnych maszyn wirtualnych i jest wymagany podczas korzystania z poufnych maszyn wirtualnych.

Nazwa	Typ	Opis
securityEncryptionType	SecurityEncryptionTypes	Określa typ szyfrowania dysku zarządzanego. Jest ona ustawiona na VMGuestStateOnly na potrzeby szyfrowania tylko obiektu blob VMGuestState i nonPersistedTPM dla nietrwałego stanu oprogramowania układowego w obiekcie blob VMGuestState. Uwaga: można ją ustawić tylko dla poufnych maszyn wirtualnych i wymaganych podczas korzystania z poufnych maszyn wirtualnych.

VMExtension

Sprzeciwiać się

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		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		Ustawienia publiczne w formacie JSON dla rozszerzenia.
type	string	Typ rozszerzeń.
typeHandlerVersion	string	Wersja programu obsługi skryptów.

WindowsConfiguration

Sprzeciwiać się

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

Sprzeciwiać się

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

Nazwa	Typ	Opis
loginMode	LoginMode	Tryb logowania użytkownika Określa tryb logowania użytkownika. Wartość domyślna to Interactive.