az batch pool

참고 항목

이 명령 그룹에는 Azure CLI 및 하나 이상의 확장 모두에 정의된 명령이 있습니다. 확장된 기능을 활용하려면 각 확장을 설치합니다. 확장 프로그램에 대해 자세히 알아보세요.

Batch 풀을 관리합니다.

명령

Name Description 형식 상태
az batch pool autoscale

Batch 풀의 자동 크기 조정을 관리합니다.

핵심 GA
az batch pool autoscale disable

풀에 대한 자동 크기 조정을 사용하지 않도록 설정합니다.

핵심 GA
az batch pool autoscale enable

풀에 대해 자동 크기 조정을 사용하도록 설정합니다.

핵심 GA
az batch pool autoscale evaluate

풀에서 자동 크기 조정 수식을 계산한 결과를 가져옵니다.

핵심 GA
az batch pool create

계정에 Batch 풀을 만듭니다. 풀을 만들 때 Cloud Services 구성 또는 Virtual Machine 구성에서 인수를 선택합니다.

핵심 GA
az batch pool create (azure-batch-cli-extensions 확장)

계정에 Batch 풀을 만듭니다. 풀을 만들 때 Cloud Services 구성 또는 Virtual Machine 구성에서 인수를 선택합니다.

내선 번호 GA
az batch pool delete

지정된 계정에서 풀을 삭제합니다.

핵심 GA
az batch pool list

지정된 계정의 모든 풀을 나열합니다.

핵심 GA
az batch pool node-counts

Batch 풀에 대한 노드 수를 가져옵니다.

핵심 GA
az batch pool node-counts list

풀별로 그룹화된 각 상태의 컴퓨팅 노드 수를 가져옵니다.

핵심 GA
az batch pool reset

Batch 풀의 속성을 업데이트합니다. 업데이트할 수 있는 지정되지 않은 속성은 기본값으로 다시 설정됩니다.

핵심 GA
az batch pool resize

Batch 풀의 크기를 조정하거나 크기를 조정하지 않습니다.

핵심 GA
az batch pool set

Batch 풀의 속성을 업데이트합니다. 하위 그룹에서 속성을 업데이트하면 해당 그룹의 지정되지 않은 속성이 다시 설정됩니다.

핵심 GA
az batch pool show

지정된 풀에 대한 정보를 가져옵니다.

핵심 GA
az batch pool supported-images

Azure Batch 서비스에서 지원하는 VM 이미지에 대한 정보를 쿼리합니다.

핵심 GA
az batch pool supported-images list

Azure Batch 서비스에서 지원하는 모든 Virtual Machine 이미지를 나열합니다.

핵심 GA
az batch pool usage-metrics

Batch 풀의 사용 메트릭을 봅니다.

핵심 GA
az batch pool usage-metrics list

지정된 계정에 대해 개별 시간 간격에 걸쳐 풀별로 집계된 사용 메트릭을 나열합니다.

핵심 GA

az batch pool create

계정에 Batch 풀을 만듭니다. 풀을 만들 때 Cloud Services 구성 또는 Virtual Machine 구성에서 인수를 선택합니다.

az batch pool create [--accelerated-networking {false, true}]
                     [--account-endpoint]
                     [--account-key]
                     [--account-name]
                     [--application-licenses]
                     [--application-package-references]
                     [--auto-scale-formula]
                     [--certificate-references]
                     [--defer-os-rolling-upgrade {false, true}]
                     [--disable-auto-rollback {false, true}]
                     [--disk-encryption-targets]
                     [--enable-auto-os-upgrade {false, true}]
                     [--enable-cross-zone-upgrade {false, true}]
                     [--enable-inter-node-communication]
                     [--enable-secure-boot {false, true}]
                     [--enable-vtpm {false, true}]
                     [--enable-write-accel {false, true}]
                     [--encryption-at-host {false, true}]
                     [--id]
                     [--image]
                     [--json-file]
                     [--max-batch-instance-percent]
                     [--max-unhealthy-instance-percent]
                     [--max-unhealthy-upgraded-instance-percent]
                     [--metadata]
                     [--node-agent-sku-id]
                     [--os-disk-caching {none, readonly, readwrite}]
                     [--os-disk-size]
                     [--os-family {2, 3, 4, 5, 6}]
                     [--os-version]
                     [--pause-time-between-batches]
                     [--placement {cachedisk}]
                     [--policy {regional, zonal}]
                     [--prioritize-unhealthy-instances {false, true}]
                     [--resize-timeout]
                     [--resource-tags]
                     [--rollback-failed-instances-on-policy-breach {false, true}]
                     [--security-type]
                     [--start-task-command-line]
                     [--start-task-resource-files]
                     [--start-task-wait-for-success]
                     [--storage-account-type {premium_lrs, standard_lrs, standardssd_lrs}]
                     [--target-communication {classic, default, simplified}]
                     [--target-dedicated-nodes]
                     [--target-low-priority-nodes]
                     [--targets]
                     [--task-slots-per-node]
                     [--upgrade-policy-mode {automatic, manual, rolling}]
                     [--use-rolling-upgrade-policy {false, true}]
                     [--vm-size]

선택적 매개 변수

--accelerated-networking

이 풀이 가속화된 네트워킹을 사용하도록 설정해야 하는지 여부입니다. 가속화된 네트워킹을 사용하면 VM에 대한 SR-IOV(단일 루트 I/O 가상화)가 가능하므로 네트워킹 성능이 향상될 수 있습니다. 자세한 내용은 다음을 참조하세요 https://learn.microsoft.com/azure/virtual- . network/accelerated-networking-overview. true를 설정하여 사용하도록 설정합니다.

허용되는 값: false, true
--account-endpoint

Batch 서비스 엔드포인트. 또는 환경 변수( AZURE_BATCH_ENDPOINT)로 설정합니다.

--account-key

Batch 계정 키입니다. 또는 환경 변수( AZURE_BATCH_ACCESS_KEY)로 설정합니다.

--account-name

Batch 계정 이름입니다. 또는 환경 변수( AZURE_BATCH_ACCOUNT)로 설정합니다.

--application-licenses

애플리케이션 라이선스 목록은 사용 가능한 Batch 서비스 애플리케이션 라이선스의 하위 집합이어야 합니다. 지원되지 않는 라이선스가 요청되면 풀 만들기가 실패합니다. 공백으로 구분된 값입니다.

--application-package-references

풀을 만들 때 패키지의 애플리케이션 ID는 정규화되어야 합니다(/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Batch/batchAccounts/{accountName}/applications/{applicationName}). 패키지 참조에 대한 변경 내용은 풀에 조인하는 모든 새 노드에 영향을 주지만 다시 부팅하거나 이미지로 다시 설치할 때까지 풀에 이미 있는 컴퓨팅 노드에는 영향을 미치지 않습니다. 지정된 풀에는 최대 10개의 패키지 참조가 있습니다. 'id[#version]' 형식의 선택적 버전이 있는 공백으로 구분된 애플리케이션 ID입니다.

--auto-scale-formula

풀에서 원하는 수의 컴퓨팅 노드에 대한 수식입니다. 풀을 만들기 전에 유효성을 위해 수식이 검사. 수식이 유효하지 않으면 Batch 서비스는 자세한 오류 정보가 포함된 요청을 거부합니다. 이 수식을 지정하는 방법에 대한 자세한 내용은 다음을 참조하세요 https://azure.microsoft.com/documentation/articles/batch-automatic-scaling/.

--certificate-references

Windows 노드의 경우 Batch 서비스는 지정된 인증서 저장소 및 위치에 인증서를 설치합니다. Linux 컴퓨팅 노드의 경우 인증서는 작업 작업 디렉터리 내의 디렉터리에 저장되고 AZ_BATCH_CERTIFICATES_DIR 환경 변수는 이 위치를 쿼리하기 위해 태스크에 제공됩니다. 'remoteUser'의 표시 유형이 있는 인증서의 경우 사용자의 홈 디렉터리(예: /home/{user-name}/certs)에 'certs' 디렉터리가 만들어지고 인증서가 해당 디렉터리에 배치됩니다. 경고: 이 속성은 더 이상 사용되지 않으며 2024년 2월 이후에 제거됩니다. 대신 Azure KeyVault 확장을 사용하세요. 공백으로 구분된 인증서 지문입니다.

--defer-os-rolling-upgrade

작업을 실행하는 경우 TVM에서 OS 업그레이드를 연기합니다. 플래그가 있으면 True입니다.

허용되는 값: false, true
--disable-auto-rollback

OS 이미지 롤백 기능을 사용하지 않도록 설정해야 하는지 여부입니다. 플래그가 있으면 True입니다.

허용되는 값: false, true
--disk-encryption-targets

DiskEncryptionTargets의 공백으로 구분된 목록입니다. 현재 가능한 값에는 OsDisk 및 TemporaryDisk가 포함됩니다.

--enable-auto-os-upgrade

최신 버전의 OS 이미지를 사용할 수 있게 되면 OS 업그레이드를 롤링 방식으로 확장 집합 인스턴스에 자동으로 적용해야 하는지 여부를 나타냅니다.

Windows 기반 풀에 대해 true로 설정된 경우 WindowsConfiguration.enableAutomatic업데이트 true로 설정할 수 없습니다. 플래그가 있으면 True입니다.

허용되는 값: false, true
--enable-cross-zone-upgrade

업그레이드 일괄 처리를 생성할 때 VMSS가 AZ 경계를 무시하도록 허용합니다. 업데이트 Do기본 및 maxBatchInstancePercent를 고려하여 일괄 처리 크기를 결정합니다. 이 필드는 NodePlacementConfiguration을 영역으로 사용하는 경우에만 true 또는 false로 설정할 수 있습니다. 플래그가 있으면 True입니다.

허용되는 값: false, true
--enable-inter-node-communication

풀이 컴퓨팅 노드 간의 직접 통신을 허용하는지 여부입니다. 노드 간 통신을 사용하도록 설정하면 풀의 컴퓨팅 노드에 대한 배포 제한으로 인해 풀의 최대 크기가 제한됩니다. 이로 인해 풀이 원하는 크기에 도달하지 못할 수 있습니다. 기본값은 false입니다. 플래그가 있으면 True입니다.

--enable-secure-boot

보안 부팅을 사용하도록 설정합니다.

허용되는 값: false, true
--enable-vtpm

vTPM을 사용하도록 설정합니다.

허용되는 값: false, true
--enable-write-accel

디스크에서 writeAccelerator를 사용하도록 설정하거나 사용하지 않도록 설정할지 여부를 지정합니다.

허용되는 값: false, true
--encryption-at-host

이 속성은 요청에서 사용자가 가상 머신 또는 가상 머신 확장 집합에 대한 호스트 암호화를 사용하거나 사용하지 않도록 설정하는 데 사용할 수 있습니다. 이렇게 하면 호스트 자체의 리소스/임시 디스크를 비롯한 모든 디스크에 대한 암호화가 활성화됩니다. 기본 동작은 리소스에 대해 이 속성을 true로 설정하지 않는 한 호스트의 암호화를 사용하지 않도록 설정하는 것입니다.

허용되는 값: false, true
--id

필수입니다. ID는 하이픈과 밑줄을 포함한 영숫자 문자의 조합을 포함할 수 있으며 64자를 초과할 수 없습니다. ID는 대/소문자를 구분하지 않습니다( 즉, 대/소문자만 다른 계정 내에 풀 ID가 두 개 없을 수 있음).

--image

OS 이미지 참조입니다. 'publisher:offer:sku[:version]' 형식 또는 '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Compute/images/{imageName}' 형식의 정규화된 ARM 이미지 ID일 수 있습니다. 'publisher:offer:sku[:version]' 형식인 경우 버전은 선택 사항이며 생략된 최신 버전이 사용됩니다. 유효한 값은 'az batch pool supported-images list'를 통해 검색할 수 있습니다. 예: 'MicrosoftWindowsServer:WindowsServer:2012-R2-Datacenter:latest'.

--json-file

풀이 포함된 파일은 JSON(REST API 요청 본문과 일치하도록 형식이 지정됨)에서 속성 매개 변수 사양을 만듭니다. 이 매개 변수를 지정하면 모든 '풀 만들기 속성 매개 변수 인수'가 무시됩니다. https://docs.microsoft.com/en-us/rest/api/batchservice/pool/add?tabs=HTTP#request-body을 참조하세요.

--max-batch-instance-percent

롤링 업그레이드를 통해 동시에 업그레이드될 총 가상 머신 인스턴스의 최대 백분율입니다. 이는 이전 또는 이후 일괄 처리의 최대 비정상 인스턴스이므로 더 높은 안정성을 보장하기 위해 일괄 처리의 인스턴스 비율이 감소할 수 있습니다. 이 필드의 값은 5에서 100 사이여야 합니다. maxBatchInstancePercent와 maxUnhealthyInstancePercent가 모두 값으로 할당된 경우 maxBatchInstancePercent 값은 maxUnhealthyInstancePercent보다 작으면 안 됩니다.

--max-unhealthy-instance-percent

업그레이드의 결과로 또는 롤링 업그레이드가 중단되기 전에 가상 머신 상태 검사 의해 비정상 상태로 발견되어 동시에 비정상 상태가 될 수 있는 확장 집합의 총 가상 머신 인스턴스의 최대 비율입니다. 이 제약 조건은 일괄 처리를 시작하기 전에 검사. 이 필드의 값은 5에서 100 사이여야 합니다. maxBatchInstancePercent와 maxUnhealthyInstancePercent가 모두 값으로 할당된 경우 maxBatchInstancePercent 값은 maxUnhealthyInstancePercent보다 작으면 안 됩니다.

--max-unhealthy-upgraded-instance-percent

비정상 상태인 것으로 확인될 수 있는 업그레이드된 가상 머신 인스턴스의 최대 비율입니다. 이 검사 각 일괄 처리가 업그레이드된 후에 발생합니다. 이 비율을 초과하면 롤링 업데이트가 중단됩니다. 이 필드의 값은 0에서 100 사이여야 합니다.

--metadata

Batch 서비스는 메타데이터에 어떤 의미도 할당하지 않습니다. 사용자 코드를 사용하기 위한 것입니다. 'key=value' 형식의 공백으로 구분된 값입니다.

--node-agent-sku-id

필수입니다. Batch Compute Node 에이전트는 풀의 각 컴퓨팅 노드에서 실행되는 프로그램이며 컴퓨팅 노드와 Batch 서비스 간에 명령 및 제어 인터페이스를 제공합니다. 여러 운영 체제에 대해 SKU라고 하는 컴퓨팅 노드 에이전트의 구현은 서로 다릅니다. 선택한 이미지 참조와 일치하는 컴퓨팅 노드 에이전트 SKU를 지정해야 합니다. 확인된 이미지 참조 목록과 함께 지원되는 컴퓨팅 노드 에이전트 SKU 목록을 얻으려면 '지원되는 컴퓨팅 노드 에이전트 SKU 나열' 작업을 참조하세요.

--os-disk-caching

캐싱 요구 사항을 지정합니다. 가능한 값은 None, ReadOnly, ReadWrite입니다. 기본값은 표준 스토리지에 대한 없음입니다. Premium Storage의 경우 ReadOnly입니다.

허용되는 값: none, readonly, readwrite
--os-disk-size

새 OS 디스크를 만들 때의 초기 디스크 크기(GB)입니다.

--os-family

필수입니다. 가능한 값은 Windows Server 2008 R2 SP1과 동일한 2 - OS 제품군 2입니다. 3 - WINDOWS Server 2012와 동일한 OS 제품군 3. 4 - WINDOWS Server 2012 R2와 동일한 OS 제품군 4 5 - WINDOWS Server 2016에 해당하는 OS 제품군 5. 6 - WINDOWS Server 2019에 해당하는 OS 제품군 6. 자세한 내용은 Azure 게스트 OS 릴리스(https://azure.microsoft.com/documentation/articles/cloud-services-guestos-update-matrix/#releases)를 참조하세요.

허용되는 값: 2, 3, 4, 5, 6
--os-version

기본값은 지정된 OS 제품군의 최신 운영 체제 버전을 지정하는 *입니다.

--pause-time-between-batches

모든 가상 머신에 대한 업데이트를 한 일괄 처리로 완료하고 다음 일괄 처리를 시작하는 것 사이의 대기 시간입니다. 기간은 ISO 8601 형식으로 지정해야 합니다. 예상 형식은 ISO-8601 기간입니다.

--placement

풀의 모든 VM에 대한 운영 체제 디스크의 임시 디스크 배치를 지정합니다. 이 속성은 임시 OS 디스크 프로비저닝을 위한 캐시 디스크 공간과 같은 위치를 선택하기 위해 요청에서 사용자가 사용할 수 있습니다. 임시 OS 디스크 크기 요구 사항에 대한 자세한 내용은 Windows VM 및 Linux VM https://docs.microsoft.com/en-us/azure/virtual-machines/windows/ephemeral-os-disks#size-requirementshttps://docs.microsoft.com/en-us/azure/virtual-machines/linux/ephemeral-os-disks#size-requirements의 사용 후 삭제 OS 디스크 크기 요구 사항을 참조하세요.

허용되는 값: cachedisk
--policy

Batch 풀의 노드 배치 정책 유형입니다. Batch 서비스에서 노드를 프로비전하는 데 사용하는 할당 정책입니다. 지정하지 않으면 Batch는 지역 정책을 사용합니다.

허용되는 값: regional, zonal
--prioritize-unhealthy-instances

확장 집합의 모든 비정상 인스턴스를 정상 인스턴스로 업그레이드합니다. 플래그가 있으면 True입니다.

허용되는 값: false, true
--resize-timeout

이 시간 제한은 수동 크기 조정에만 적용됩니다. enableAutoScale이 true로 설정된 경우에는 효과가 없습니다. 기본값은 15분입니다. 최소값은 5분입니다. 5분 미만의 값을 지정하면 Batch 서비스에서 오류가 반환됩니다. REST API를 직접 호출하는 경우 HTTP 상태 코드는 400(잘못된 요청)입니다. 예상 형식은 ISO-8601 기간입니다.

--resource-tags

사용자는 풀에 대한 리소스 태그를 지정할 수 있습니다. 풀에 대해 생성된 모든 리소스는 동일한 리소스 태그로 태그가 지정됩니다.

--rollback-failed-instances-on-policy-breach

롤링 업그레이드 정책을 위반하는 경우 인스턴스를 이전 모델로 롤백하지 못했습니다. 플래그가 있으면 True입니다.

허용되는 값: false, true
--security-type

가상 머신의 SecurityType을 지정합니다. Uefi설정 사용하도록 설정하려면 지정된 값으로 설정해야 합니다. 기본 동작: Uefi설정이 속성을 설정 하지 않는 한 사용 되지 않습니다.

--start-task-command-line

필수입니다. 명령줄은 셸에서 실행되지 않으므로 환경 변수 확장과 같은 셸 기능을 활용할 수 없습니다. 이러한 기능을 활용하려면 명령줄에서 셸을 호출해야 합니다(예: Windows의 "cmd /c MyCommand" 또는 Linux의 "/bin/sh -c MyCommand"). 명령줄이 파일 경로를 참조하는 경우 상대 경로(작업 작업 디렉터리를 기준으로)를 사용하거나 Batch 제공 환경 변수(https://docs.microsoft.com/en-us/azure/batch/batch-compute-node-environment-variables)를 사용해야 합니다.

--start-task-resource-files

이 요소 아래에 나열된 파일은 Task의 작업 디렉터리에 있습니다. filename=httpurl 형식의 공백으로 구분된 리소스 참조입니다.

--start-task-wait-for-success

Batch 서비스가 Compute 노드에서 작업을 예약하기 전에 StartTask가 성공적으로 완료될 때까지 대기해야 하는지 여부(즉, 종료 코드 0으로 종료). True이고 StartTask가 노드에서 실패하는 경우 Batch 서비스는 StartTask를 최대 다시 시도 횟수(maxTaskRetryCount)까지 다시 시도합니다. 모든 재시도 후에도 작업이 성공적으로 완료되지 않은 경우 Batch 서비스는 노드를 사용할 수 없음으로 표시하고 작업을 예약하지 않습니다. 이 조건은 컴퓨팅 노드 상태 및 오류 정보 세부 정보를 통해 검색할 수 있습니다. false이면 Batch 서비스는 StartTask가 완료될 때까지 기다리지 않습니다. 이 경우 StartTask가 계속 실행되는 동안 다른 태스크가 컴퓨팅 노드에서 실행을 시작할 수 있습니다. StartTask가 실패하더라도 컴퓨팅 노드에서 새 작업이 계속 예약됩니다. 기본값은 true입니다. 플래그가 있으면 True입니다.

--storage-account-type

관리 디스크의 스토리지 계정 유형입니다.

허용되는 값: premium_lrs, standard_lrs, standardssd_lrs
--target-communication

풀에 대해 원하는 노드 통신 모드입니다. 이 요소가 있으면 풀에 구성된 기존 targetNodeCommunicationMode를 대체합니다. 생략하면 기존 메타데이터는 변경되지 않은 상태로 유지됩니다.

허용되는 값: classic, default, simplified
--target-dedicated-nodes

풀에서 원하는 전용 컴퓨팅 노드 수입니다. enableAutoScale이 true로 설정된 경우 이 속성을 지정해서는 안 됩니다. enableAutoScale이 false로 설정된 경우 targetDedicatedNodes, targetLowPriorityNodes 또는 둘 다를 설정해야 합니다.

--target-low-priority-nodes

풀에서 원하는 스폿/낮은 우선 순위 컴퓨팅 노드 수입니다. enableAutoScale이 true로 설정된 경우 이 속성을 지정해서는 안 됩니다. enableAutoScale이 false로 설정된 경우 targetDedicatedNodes, targetLowPriorityNodes 또는 둘 다를 설정해야 합니다.

--targets

생략하면 풀의 컴퓨팅 노드에 있는 디스크가 암호화되지 않습니다. Linux 풀에서는 "TemporaryDisk"만 지원됩니다. Windows 풀에서 "OsDisk" 및 "TemporaryDisk"를 지정해야 합니다. 암호화할 공간 구분 대상 디스크입니다. 값은 OsDisk 또는 TemporaryDisk일 수 있습니다.

--task-slots-per-node

풀의 단일 컴퓨팅 노드에서 동시 태스크를 실행하는 데 사용할 수 있는 태스크 슬롯의 수입니다. 기본값은 1입니다. 최대값은 풀의 vmSize 코어 수의 4배 또는 256의 작은 값입니다.

--upgrade-policy-mode

풀 OS 업그레이드의 모드입니다.

허용되는 값: automatic, manual, rolling
--use-rolling-upgrade-policy

자동 OS 업그레이드 중에 롤링 업그레이드 정책을 사용해야 하는지 여부를 나타냅니다. VMSS에 정의된 정책이 없는 경우 자동 OS 업그레이드가 기본 정책으로 대체됩니다. 플래그가 있으면 True입니다.

허용되는 값: false, true
--vm-size

필수입니다. Cloud Services 풀에 사용 가능한 가상 머신 크기(cloudServiceConfiguration으로 만든 풀)에 대한 자세한 내용은 Cloud Services 크기(https://azure.microsoft.com/documentation/articles/cloud-services-sizes-specs/)를 참조하세요. Batch는 ExtraSmall, A1V2 및 A2V2를 제외한 모든 Cloud Services VM 크기를 지원합니다. Virtual Machines Marketplace(virtualMachineConfiguration으로 만든 풀)의 이미지를 사용하여 풀에 사용할 수 있는 VM 크기에 대한 자세한 내용은 Virtual Machines(Linux) 또는 Virtual Machines 크기(https://azure.microsoft.com/documentation/articles/virtual-machines-linux-sizes/Windows)(https://azure.microsoft.com/documentation/articles/virtual-machines-windows-sizes/)를 참조하세요. Batch는 STANDARD_A0 및 Premium Storage(STANDARD_GS, STANDARD_DS 및 STANDARD_DSV2 시리즈)를 제외한 모든 Azure VM 크기를 지원합니다.

전역 매개 변수
--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

오류만 표시하고, 경고를 표시하지 않습니다.

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc
기본값: json
--query

JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.

--subscription

구독의 이름 또는 ID입니다. az account set -s NAME_OR_ID를 사용하여 기본 위치를 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.

az batch pool create (azure-batch-cli-extensions 확장)

계정에 Batch 풀을 만듭니다. 풀을 만들 때 Cloud Services 구성 또는 Virtual Machine 구성에서 인수를 선택합니다.

az batch pool create [--account-endpoint]
                     [--account-key]
                     [--account-name]
                     [--application-licenses]
                     [--application-package-references]
                     [--auto-scale-formula]
                     [--certificate-references]
                     [--disk-encryption-targets]
                     [--enable-inter-node-communication]
                     [--id]
                     [--image]
                     [--json-file]
                     [--metadata]
                     [--node-agent-sku-id]
                     [--os-family]
                     [--os-version]
                     [--parameters]
                     [--policy]
                     [--resize-timeout]
                     [--resource-group]
                     [--start-task-command-line]
                     [--start-task-resource-files]
                     [--start-task-wait-for-success]
                     [--target-dedicated-nodes]
                     [--target-low-priority-nodes]
                     [--targets]
                     [--task-slots-per-node]
                     [--template]
                     [--vm-size]

선택적 매개 변수

--account-endpoint

Batch 서비스 엔드포인트. 또는 환경 변수( AZURE_BATCH_ENDPOINT)로 설정합니다.

--account-key

Batch 계정 키입니다. 또는 환경 변수( AZURE_BATCH_ACCESS_KEY)로 설정합니다.

--account-name

배치 계정 이름입니다. 또는 환경 변수( AZURE_BATCH_ACCOUNT)로 설정합니다.

--application-licenses

애플리케이션 라이선스 목록은 사용 가능한 Batch 서비스 애플리케이션 라이선스의 하위 집합이어야 합니다. 지원되지 않는 라이선스가 요청되면 풀 만들기가 실패합니다.

--application-package-references

풀을 만들 때 패키지의 애플리케이션 ID는 정규화되어야 합니다(/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Batch/batchAccounts/{accountName}/applications/{applicationName}). 패키지 참조에 대한 변경 내용은 풀에 조인하는 모든 새 노드에 영향을 주지만 다시 부팅하거나 이미지로 다시 설치할 때까지 풀에 이미 있는 컴퓨팅 노드에는 영향을 미치지 않습니다. 지정된 풀에는 최대 10개의 패키지 참조가 있습니다.

--auto-scale-formula

enableAutoScale이 false로 설정된 경우 이 속성을 지정해서는 안 됩니다. enableAutoScale이 true로 설정된 경우 필요합니다. 풀을 만들기 전에 유효성을 위해 수식이 검사. 수식이 유효하지 않으면 Batch 서비스는 자세한 오류 정보가 포함된 요청을 거부합니다. 이 수식을 지정하는 방법에 대한 자세한 내용은 'Azure Batch 풀에서 자동으로 컴퓨팅 노드 크기 조정'(https://azure.microsoft.com/documentation/articles/batch-automatic-scaling/)을 참조하세요.

--certificate-references

Windows 노드의 경우 Batch 서비스는 지정된 인증서 저장소 및 위치에 인증서를 설치합니다. Linux 컴퓨팅 노드의 경우 인증서는 작업 작업 디렉터리 내의 디렉터리에 저장되고 AZ_BATCH_CERTIFICATES_DIR 환경 변수는 이 위치를 쿼리하기 위해 태스크에 제공됩니다. 'remoteUser'의 표시 유형이 있는 인증서의 경우 사용자의 홈 디렉터리(예: /home/{user-name}/certs)에 'certs' 디렉터리가 만들어지고 인증서가 해당 디렉터리에 배치됩니다. 경고: 이 속성은 더 이상 사용되지 않으며 2024년 2월 이후에 제거됩니다. 대신 Azure KeyVault 확장을 사용하세요.

--disk-encryption-targets

DiskEncryptionTargets의 공백으로 분리된 목록입니다. 현재 가능한 값에는 OsDisk 및 TemporaryDisk가 포함됩니다.

--enable-inter-node-communication

풀이 컴퓨팅 노드 간의 직접 통신을 허용하는지 여부입니다. 노드 간 통신을 사용하도록 설정하면 풀의 컴퓨팅 노드에 대한 배포 제한으로 인해 풀의 최대 크기가 제한됩니다. 이로 인해 풀이 원하는 크기에 도달하지 못할 수 있습니다. 기본값은 false입니다.

기본값: False
--id

필수입니다. ID는 하이픈과 밑줄을 포함한 영숫자 문자의 조합을 포함할 수 있으며 64자를 초과할 수 없습니다. ID는 대/소문자를 구분하지 않습니다( 즉, 대/소문자만 다른 계정 내에 풀 ID가 두 개 없을 수 있음).

--image

OS 이미지 참조입니다. 'publisher:offer:sku[:version]' 형식 또는 '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Compute/images/{imageName}' 형식의 정규화된 ARM 이미지 ID일 수 있습니다. 'publisher:offer:sku[:version]' 형식인 경우 버전은 선택 사항이며 생략된 최신 버전이 사용됩니다. 유효한 값은 'az batch pool node-agent-skus list'를 통해 검색할 수 있습니다. 예: 'MicrosoftWindowsServer:WindowsServer:2012-R2-Datacenter:latest'.

--json-file

JSON 형식으로 만들 풀이 포함된 파일입니다. 이 매개 변수를 지정하면 다른 모든 매개 변수는 무시됩니다.

--metadata

Batch 서비스는 메타데이터에 어떤 의미도 할당하지 않습니다. 사용자 코드를 사용하기 위한 것입니다.

--node-agent-sku-id

풀의 컴퓨팅 노드에 프로비전할 Batch 노드 에이전트의 SKU입니다. Batch 노드 에이전트는 풀의 각 노드에서 실행되는 프로그램이며 노드와 Batch 서비스 간의 명령 및 제어 인터페이스를 제공합니다. SKU라고 하는 노드 에이전트의 구현은 서로 다른 운영 체제에 대해 여러 가지가 있습니다. 선택한 이미지 참조와 일치하는 노드 에이전트 SKU를 지정해야 합니다. 확인된 이미지 참조 목록과 함께 지원되는 노드 에이전트 SKU 목록을 얻으려면 '지원되는 노드 에이전트 SKU 나열' 작업을 참조하세요.

--os-family

풀의 가상 머신에 설치할 Azure 게스트 OS 제품군입니다. 가능한 값은 Windows Server 2008 R2 SP1과 동일한 2 - OS 제품군 2입니다. 3 - WINDOWS Server 2012와 동일한 OS 제품군 3. 4 - WINDOWS Server 2012 R2와 동일한 OS 제품군 4 5 - WINDOWS Server 2016에 해당하는 OS 제품군 5. 자세한 내용은 Azure 게스트 OS 릴리스(https://azure.microsoft.com/documentation/articles/cloud-services-guestos-update-matrix/#releases)를 참조하세요. 허용되는 값: 2, 3, 4, 5.

--os-version

기본값은 지정된 OS 제품군의 최신 운영 체제 버전을 지정하는 *입니다.

--parameters

Batch 풀 JSON 템플릿 파일의 매개 변수 값입니다. --template에서만 사용할 수 있습니다.

--policy

Batch 풀의 노드 배치 정책 유형입니다. Batch 서비스에서 노드를 프로비전하는 데 사용하는 할당 정책입니다. 지정하지 않으면 Batch는 지역 정책을 사용합니다. 허용되는 값: 지역, 영역

--resize-timeout

이 시간 제한은 수동 크기 조정에만 적용됩니다. enableAutoScale이 true로 설정된 경우에는 효과가 없습니다. 기본값은 15분입니다. 최소값은 5분입니다. 5분 미만의 값을 지정하면 Batch 서비스에서 오류가 반환됩니다. REST API를 직접 호출하는 경우 HTTP 상태 코드는 400(잘못된 요청)입니다.

--resource-group

Batch 계정의 리소스 그룹입니다.

--start-task-command-line

시작 태스크의 명령줄입니다. 명령줄은 셸에서 실행되지 않으므로 환경 변수 확장과 같은 셸 기능을 활용할 수 없습니다. 이러한 기능을 활용하려면 명령줄에서 셸을 호출해야 합니다(예: Windows의 "cmd /c MyCommand" 또는 Linux의 "/bin/sh -c MyCommand").

--start-task-resource-files

명령줄을 실행하기 전에 Batch 서비스가 컴퓨팅 노드에 다운로드할 파일 목록입니다. filename=httpurl 형식의 공백으로 구분된 리소스 참조입니다.

--start-task-wait-for-success

Batch 서비스가 컴퓨팅 노드에서 작업을 예약하기 전에 시작 작업이 성공적으로 완료될 때까지 대기해야 하는지 여부(즉, 종료 코드 0으로 종료). true이고 컴퓨팅 노드에서 시작 작업이 실패하면 Batch 서비스는 최대 재시도 횟수(maxTaskRetryCount)까지 시작 작업을 다시 시도합니다. 모든 재시도 후에도 작업이 성공적으로 완료되지 않은 경우 Batch 서비스는 컴퓨팅 노드를 사용할 수 없도록 표시하고 작업을 예약하지 않습니다. 이 조건은 노드 상태 및 예약 오류 세부 정보를 통해 검색할 수 있습니다. false이면 Batch 서비스는 시작 작업이 완료될 때까지 기다리지 않습니다. 이 경우 시작 태스크가 계속 실행되는 동안 다른 태스크가 컴퓨팅 노드에서 실행을 시작할 수 있습니다. 시작 작업이 실패하더라도 노드에서 새 작업이 계속 예약됩니다. 기본 설정은 거짓입니다. 플래그가 있으면 True입니다.

기본값: False
--target-dedicated-nodes

풀에서 원하는 전용 컴퓨팅 노드 수입니다. enableAutoScale이 true로 설정된 경우 이 속성을 지정해서는 안 됩니다. enableAutoScale이 false로 설정된 경우 targetDedicatedNodes, targetLowPriorityNodes 또는 둘 다를 설정해야 합니다.

--target-low-priority-nodes

풀에서 원하는 스폿/낮은 우선 순위 컴퓨팅 노드 수입니다. enableAutoScale이 true로 설정된 경우 이 속성을 지정해서는 안 됩니다. enableAutoScale이 false로 설정된 경우 targetDedicatedNodes, targetLowPriorityNodes 또는 둘 다를 설정해야 합니다.

--targets

생략하면 풀의 컴퓨팅 노드에 있는 디스크가 암호화되지 않습니다. Linux 풀에서는 "TemporaryDisk"만 지원됩니다. Windows 풀에서 "OsDisk" 및 "TemporaryDisk"를 지정해야 합니다. 암호화할 공간 구분 대상 디스크입니다. 값은 OsDisk 또는 TemporaryDisk일 수 있습니다.

--task-slots-per-node

풀의 단일 컴퓨팅 노드에서 동시 태스크를 실행하는 데 사용할 수 있는 태스크 슬롯의 수입니다. 기본값은 1입니다. 최대값은 풀의 vmSize 코어 수의 4배 또는 256의 작은 값입니다.

--template

Batch 풀 JSON 템플릿 파일입니다. 이 매개 변수를 지정하면 다른 모든 매개 변수가 무시됩니다.

--vm-size

필수입니다. Cloud Services 풀에 사용 가능한 가상 머신 크기(cloudServiceConfiguration으로 만든 풀)에 대한 자세한 내용은 Cloud Services 크기(https://azure.microsoft.com/documentation/articles/cloud-services-sizes-specs/)를 참조하세요. Batch는 ExtraSmall, A1V2 및 A2V2를 제외한 모든 Cloud Services VM 크기를 지원합니다. Virtual Machines Marketplace(virtualMachineConfiguration으로 만든 풀)의 이미지를 사용하여 풀에 사용할 수 있는 VM 크기에 대한 자세한 내용은 Virtual Machines(Linux) 또는 Virtual Machines 크기(https://azure.microsoft.com/documentation/articles/virtual-machines-linux-sizes/Windows)(https://azure.microsoft.com/documentation/articles/virtual-machines-windows-sizes/)를 참조하세요. Batch는 STANDARD_A0 및 Premium Storage(STANDARD_GS, STANDARD_DS 및 STANDARD_DSV2 시리즈)를 제외한 모든 Azure VM 크기를 지원합니다.

전역 매개 변수
--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

오류만 표시하고, 경고를 표시하지 않습니다.

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc
기본값: json
--query

JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.

--subscription

구독의 이름 또는 ID입니다. az account set -s NAME_OR_ID를 사용하여 기본 위치를 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.

az batch pool delete

지정된 계정에서 풀을 삭제합니다.

풀을 삭제하도록 요청하면 다음 작업이 발생합니다. 풀 상태는 삭제로 설정됩니다. 풀에서 진행 중인 크기 조정 작업이 중지됩니다. Batch 서비스는 풀 크기를 컴퓨팅 노드 0으로 조정하기 시작합니다. 기존 컴퓨팅 노드에서 실행되는 모든 태스크는 종료되고 다시 큐에 추가됩니다(기본 다시 큐 옵션으로 풀 크기 조정 작업이 요청된 것처럼). 마지막으로 풀이 시스템에서 제거됩니다. 실행 중인 작업은 다시 큐에 추가되므로 사용자는 작업을 업데이트하여 다른 풀을 대상으로 하여 이러한 작업을 다시 실행할 수 있습니다. 그러면 새 풀에서 작업을 실행할 수 있습니다. 다시 큐에 넣기 동작을 재정의하려면 풀을 삭제하기 전에 크기 조정 풀을 명시적으로 호출하여 풀 크기를 0으로 줄여야 합니다. 삭제 상태에서 풀에서 업데이트, 패치 또는 삭제 API를 호출하는 경우 오류 코드 PoolBeingDeleted가 있는 HTTP 상태 코드 409로 실패합니다.

az batch pool delete --pool-id
                     [--account-endpoint]
                     [--account-key]
                     [--account-name]
                     [--if-match]
                     [--if-modified-since]
                     [--if-none-match]
                     [--if-unmodified-since]
                     [--yes]

필수 매개 변수

--pool-id

삭제할 풀의 ID입니다.

선택적 매개 변수

--account-endpoint

Batch 서비스 엔드포인트. 또는 환경 변수( AZURE_BATCH_ENDPOINT)로 설정합니다.

--account-key

Batch 계정 키입니다. 또는 환경 변수( AZURE_BATCH_ACCESS_KEY)로 설정합니다.

--account-name

Batch 계정 이름입니다. 또는 환경 변수( AZURE_BATCH_ACCOUNT)로 설정합니다.

--if-match

클라이언트에 알려진 리소스의 버전과 연결된 ETag 값입니다. 이 작업은 서비스에 대한 리소스의 현재 ETag가 클라이언트에서 지정한 값과 정확히 일치하는 경우에만 수행됩니다.

--if-modified-since

클라이언트에 알려진 리소스의 마지막으로 수정된 시간을 나타내는 타임스탬프입니다. 지정된 시간 이후 서비스의 리소스가 수정된 경우에만 작업이 수행됩니다.

--if-none-match

클라이언트에 알려진 리소스의 버전과 연결된 ETag 값입니다. 이 작업은 서비스에서 리소스의 현재 ETag가 클라이언트에서 지정한 값과 일치하지 않는 경우에만 수행됩니다.

--if-unmodified-since

클라이언트에 알려진 리소스의 마지막으로 수정된 시간을 나타내는 타임스탬프입니다. 지정된 시간 이후 서비스의 리소스가 수정되지 않은 경우에만 작업이 수행됩니다.

--yes -y

확인을 묻는 메시지를 표시하지 마세요.

기본값: False
전역 매개 변수
--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

오류만 표시하고, 경고를 표시하지 않습니다.

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc
기본값: json
--query

JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.

--subscription

구독의 이름 또는 ID입니다. az account set -s NAME_OR_ID를 사용하여 기본 위치를 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.

az batch pool list

지정된 계정의 모든 풀을 나열합니다.

az batch pool list [--account-endpoint]
                   [--account-key]
                   [--account-name]
                   [--expand]
                   [--filter]
                   [--select]

선택적 매개 변수

--account-endpoint

Batch 서비스 엔드포인트. 또는 환경 변수( AZURE_BATCH_ENDPOINT)로 설정합니다.

--account-key

Batch 계정 키입니다. 또는 환경 변수( AZURE_BATCH_ACCESS_KEY)로 설정합니다.

--account-name

Batch 계정 이름입니다. 또는 환경 변수( AZURE_BATCH_ACCOUNT)로 설정합니다.

--expand

OData $expand 절입니다.

--filter

OData $filter 절입니다. 이 필터를 생성하는 방법에 대한 자세한 내용은 다음을 참조하세요 https://docs.microsoft.com/en-us/rest/api/batchservice/odata-filters-in-batch#list-pools.

--select

OData $select 절입니다.

전역 매개 변수
--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

오류만 표시하고, 경고를 표시하지 않습니다.

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc
기본값: json
--query

JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.

--subscription

구독의 이름 또는 ID입니다. az account set -s NAME_OR_ID를 사용하여 기본 위치를 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.

az batch pool reset

Batch 풀의 속성을 업데이트합니다. 업데이트할 수 있는 지정되지 않은 속성은 기본값으로 다시 설정됩니다.

az batch pool reset --pool-id
                    [--account-endpoint]
                    [--account-key]
                    [--account-name]
                    [--application-package-references]
                    [--certificate-references]
                    [--json-file]
                    [--metadata]
                    [--start-task-command-line]
                    [--start-task-environment-settings]
                    [--start-task-max-task-retry-count]
                    [--start-task-wait-for-success]

필수 매개 변수

--pool-id

업데이트할 풀의 ID입니다.

선택적 매개 변수

--account-endpoint

Batch 서비스 엔드포인트. 또는 환경 변수( AZURE_BATCH_ENDPOINT)로 설정합니다.

--account-key

Batch 계정 키입니다. 또는 환경 변수( AZURE_BATCH_ACCESS_KEY)로 설정합니다.

--account-name

배치 계정 이름입니다. 또는 환경 변수( AZURE_BATCH_ACCOUNT)로 설정합니다.

--application-package-references

필수입니다. 이 목록은 풀의 기존 애플리케이션 패키지 참조를 대체합니다. 애플리케이션 패키지 참조에 대한 변경 내용은 풀에 조인하는 모든 새 컴퓨팅 노드에 영향을 주지만 다시 부팅하거나 이미지로 다시 설치할 때까지 풀에 이미 있는 컴퓨팅 노드에는 영향을 미치지 않습니다. 지정된 풀에는 최대 10개의 애플리케이션 패키지 참조가 있습니다. 생략하거나 빈 컬렉션을 지정하는 경우 기존 애플리케이션 패키지 참조가 풀에서 제거됩니다. 지정된 풀에 최대 10개의 참조를 지정할 수 있습니다.

--certificate-references

필수입니다. 이 목록은 풀에 구성된 기존 인증서 참조를 대체합니다. 빈 컬렉션을 지정하면 기존 인증서 참조가 풀에서 제거됩니다. Windows 노드의 경우 Batch 서비스는 지정된 인증서 저장소 및 위치에 인증서를 설치합니다. Linux 컴퓨팅 노드의 경우 인증서는 작업 작업 디렉터리 내의 디렉터리에 저장되고 AZ_BATCH_CERTIFICATES_DIR 환경 변수는 이 위치를 쿼리하기 위해 태스크에 제공됩니다. 'remoteUser'의 표시 유형이 있는 인증서의 경우 사용자의 홈 디렉터리(예: /home/{user-name}/certs)에 'certs' 디렉터리가 만들어지고 인증서가 해당 디렉터리에 배치됩니다. 경고: 이 속성은 더 이상 사용되지 않으며 2024년 2월 이후에 제거됩니다. 대신 Azure KeyVault 확장을 사용하세요.

--json-file

JSON(REST API 요청 본문과 일치하도록 형식이 지정됨)의 풀 업데이트 속성 매개 변수 사양을 포함하는 파일입니다. 이 매개 변수를 지정하면 모든 '풀 업데이트 속성 매개 변수 인수'가 무시됩니다.

--metadata

필수입니다. 이 목록은 풀에 구성된 기존 메타데이터를 대체합니다. 생략하거나 빈 컬렉션을 지정하는 경우 풀에서 기존 메타데이터가 제거됩니다.

--start-task-command-line

시작 태스크의 명령줄입니다. 명령줄은 셸에서 실행되지 않으므로 환경 변수 확장과 같은 셸 기능을 활용할 수 없습니다. 이러한 기능을 활용하려면 명령줄에서 셸을 호출해야 합니다(예: Windows의 "cmd /c MyCommand" 또는 Linux의 "/bin/sh -c MyCommand").

--start-task-environment-settings

시작 작업에 대한 환경 변수 설정 목록입니다. 'key=value' 형식의 공백으로 구분된 값입니다.

--start-task-max-task-retry-count

태스크를 다시 시도할 수 있는 최대 횟수입니다.

--start-task-wait-for-success

Batch 서비스가 컴퓨팅 노드에서 작업을 예약하기 전에 시작 작업이 성공적으로 완료될 때까지 대기해야 하는지 여부(즉, 종료 코드 0으로 종료). 플래그가 있으면 True이고, 그렇지 않으면 기본값이 False입니다.

전역 매개 변수
--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

오류만 표시하고, 경고를 표시하지 않습니다.

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc
기본값: json
--query

JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.

--subscription

구독의 이름 또는 ID입니다. az account set -s NAME_OR_ID를 사용하여 기본 위치를 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.

az batch pool resize

Batch 풀의 크기를 조정하거나 크기를 조정하지 않습니다.

az batch pool resize --pool-id
                     [--abort]
                     [--account-endpoint]
                     [--account-key]
                     [--account-name]
                     [--if-match]
                     [--if-modified-since]
                     [--if-none-match]
                     [--if-unmodified-since]
                     [--node-deallocation-option {requeue, retaineddata, taskcompletion, terminate}]
                     [--resize-timeout]
                     [--target-dedicated-nodes]
                     [--target-low-priority-nodes]

필수 매개 변수

--pool-id

풀의 ID입니다.

선택적 매개 변수

--abort

풀 크기 조정 작업을 중지합니다.

기본값: False
--account-endpoint

Batch 서비스 엔드포인트. 또는 환경 변수( AZURE_BATCH_ENDPOINT)로 설정합니다.

--account-key

Batch 계정 키입니다. 또는 환경 변수( AZURE_BATCH_ACCESS_KEY)로 설정합니다.

--account-name

배치 계정 이름입니다. 또는 환경 변수( AZURE_BATCH_ACCOUNT)로 설정합니다.

--if-match

이 작업은 리소스의 현재 ETag가 지정된 값과 정확히 일치하는 경우에만 수행됩니다.

--if-modified-since

지정된 타임스탬프 이후 리소스가 수정된 경우에만 작업이 수행됩니다.

--if-none-match

이 작업은 리소스의 현재 ETag가 지정된 값과 정확히 일치하는 경우에만 수행되지 않습니다.

--if-unmodified-since

지정된 타임스탬프 이후 리소스가 수정된 경우에만 작업이 수행되지 않습니다.

--node-deallocation-option

풀 크기가 감소하는 경우 풀에서 노드를 제거할 수 있는 경우

허용되는 값: requeue, retaineddata, taskcompletion, terminate
--resize-timeout

기본값은 15분입니다. 최소값은 5분입니다. 5분 미만의 값을 지정하면 Batch 서비스에서 오류가 반환됩니다. REST API를 직접 호출하는 경우 HTTP 상태 코드는 400(잘못된 요청)입니다.

--target-dedicated-nodes

풀에서 원하는 전용 컴퓨팅 노드 수입니다.

--target-low-priority-nodes

풀에서 원하는 스폿/낮은 우선 순위 컴퓨팅 노드 수입니다.

전역 매개 변수
--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

오류만 표시하고, 경고를 표시하지 않습니다.

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc
기본값: json
--query

JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.

--subscription

구독의 이름 또는 ID입니다. az account set -s NAME_OR_ID를 사용하여 기본 위치를 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.

az batch pool set

Batch 풀의 속성을 업데이트합니다. 하위 그룹에서 속성을 업데이트하면 해당 그룹의 지정되지 않은 속성이 다시 설정됩니다.

az batch pool set --pool-id
                  [--account-endpoint]
                  [--account-key]
                  [--account-name]
                  [--application-package-references]
                  [--certificate-references]
                  [--if-match]
                  [--if-modified-since]
                  [--if-none-match]
                  [--if-unmodified-since]
                  [--json-file]
                  [--metadata]
                  [--start-task-command-line]
                  [--start-task-environment-settings]
                  [--start-task-max-task-retry-count]
                  [--start-task-resource-files]
                  [--start-task-wait-for-success]
                  [--target-communication {classic, default, simplified}]

필수 매개 변수

--pool-id

업데이트할 풀의 ID입니다.

선택적 매개 변수

--account-endpoint

Batch 서비스 엔드포인트. 또는 환경 변수( AZURE_BATCH_ENDPOINT)로 설정합니다.

--account-key

Batch 계정 키입니다. 또는 환경 변수( AZURE_BATCH_ACCESS_KEY)로 설정합니다.

--account-name

Batch 계정 이름입니다. 또는 환경 변수( AZURE_BATCH_ACCOUNT)로 설정합니다.

--application-package-references

패키지 참조에 대한 변경 내용은 풀에 조인하는 모든 새 노드에 영향을 주지만 다시 부팅하거나 이미지로 다시 설치할 때까지 풀에 이미 있는 컴퓨팅 노드에는 영향을 미치지 않습니다. 이 요소가 있으면 기존 패키지 참조를 대체합니다. 빈 컬렉션을 지정하면 모든 패키지 참조가 풀에서 제거됩니다. 생략하면 기존 패키지 참조는 변경되지 않은 상태로 유지됩니다. 'id[#version]' 형식의 선택적 버전이 있는 공백으로 구분된 애플리케이션 ID입니다.

--certificate-references

이 요소가 있으면 풀에 구성된 기존 인증서 참조를 대체합니다. 생략하면 기존 인증서 참조는 변경되지 않은 상태로 유지됩니다. Windows 노드의 경우 Batch 서비스는 지정된 인증서 저장소 및 위치에 인증서를 설치합니다. Linux 컴퓨팅 노드의 경우 인증서는 작업 작업 디렉터리 내의 디렉터리에 저장되고 AZ_BATCH_CERTIFICATES_DIR 환경 변수는 이 위치를 쿼리하기 위해 태스크에 제공됩니다. 'remoteUser'의 표시 유형이 있는 인증서의 경우 사용자의 홈 디렉터리(예: /home/{user-name}/certs)에 'certs' 디렉터리가 만들어지고 인증서가 해당 디렉터리에 배치됩니다. 경고: 이 속성은 더 이상 사용되지 않으며 2024년 2월 이후에 제거됩니다. 대신 Azure KeyVault 확장을 사용하세요. 공백으로 구분된 인증서 지문입니다.

--if-match

클라이언트에 알려진 리소스의 버전과 연결된 ETag 값입니다. 이 작업은 서비스에 대한 리소스의 현재 ETag가 클라이언트에서 지정한 값과 정확히 일치하는 경우에만 수행됩니다.

--if-modified-since

클라이언트에 알려진 리소스의 마지막으로 수정된 시간을 나타내는 타임스탬프입니다. 지정된 시간 이후 서비스의 리소스가 수정된 경우에만 작업이 수행됩니다.

--if-none-match

클라이언트에 알려진 리소스의 버전과 연결된 ETag 값입니다. 이 작업은 서비스에서 리소스의 현재 ETag가 클라이언트에서 지정한 값과 일치하지 않는 경우에만 수행됩니다.

--if-unmodified-since

클라이언트에 알려진 리소스의 마지막으로 수정된 시간을 나타내는 타임스탬프입니다. 지정된 시간 이후 서비스의 리소스가 수정되지 않은 경우에만 작업이 수행됩니다.

--json-file

JSON의 풀 패치 매개 변수 사양을 포함하는 파일입니다(해당 REST API 본문과 일치하도록 형식이 지정됨). 이 매개 변수를 지정하면 모든 '풀 인수'가 무시됩니다.

--metadata

이 요소가 있으면 풀에 구성된 기존 메타데이터를 대체합니다. 빈 컬렉션을 지정하면 풀에서 메타데이터가 제거됩니다. 생략하면 기존 메타데이터는 변경되지 않은 상태로 유지됩니다. 'key=value' 형식의 공백으로 구분된 값입니다.

--start-task-command-line

필수입니다. 명령줄은 셸에서 실행되지 않으므로 환경 변수 확장과 같은 셸 기능을 활용할 수 없습니다. 이러한 기능을 활용하려면 명령줄에서 셸을 호출해야 합니다(예: Windows의 "cmd /c MyCommand" 또는 Linux의 "/bin/sh -c MyCommand"). 명령줄이 파일 경로를 참조하는 경우 상대 경로(작업 작업 디렉터리를 기준으로)를 사용하거나 Batch 제공 환경 변수(https://docs.microsoft.com/en-us/azure/batch/batch-compute-node-environment-variables)를 사용해야 합니다.

--start-task-environment-settings

'key=value' 형식의 공백으로 구분된 값입니다.

--start-task-max-task-retry-count

작업을 재시도할 수 있는 최대 횟수입니다. Batch 서비스는 종료 코드가 0이 아닌 경우 작업을 다시 시도합니다. 이 값은 구체적으로 재시도 횟수를 제어합니다. Batch 서비스는 작업을 한 번 시도한 다음 이 제한까지 다시 시도할 수 있습니다. 예를 들어 최대 재시도 횟수가 3인 경우 Batch는 태스크를 최대 4번(초기 시도 1회, 재시도 3회)을 시도합니다. 최대 재시도 횟수가 0이면 Batch 서비스가 작업을 다시 시도하지 않습니다. 최대 재시도 횟수가 -1인 경우 Batch 서비스는 제한 없이 작업을 다시 시도합니다. 그러나 시작 작업이나 작업에는 권장되지 않습니다. 기본값은 0(재시도 안 됨)입니다.

--start-task-resource-files

이 요소 아래에 나열된 파일은 Task의 작업 디렉터리에 있습니다. filename=httpurl 형식의 공백으로 구분된 리소스 참조입니다.

--start-task-wait-for-success

Batch 서비스가 Compute 노드에서 작업을 예약하기 전에 StartTask가 성공적으로 완료될 때까지 대기해야 하는지 여부(즉, 종료 코드 0으로 종료). True이고 StartTask가 노드에서 실패하는 경우 Batch 서비스는 StartTask를 최대 다시 시도 횟수(maxTaskRetryCount)까지 다시 시도합니다. 모든 재시도 후에도 작업이 성공적으로 완료되지 않은 경우 Batch 서비스는 노드를 사용할 수 없음으로 표시하고 작업을 예약하지 않습니다. 이 조건은 컴퓨팅 노드 상태 및 오류 정보 세부 정보를 통해 검색할 수 있습니다. false이면 Batch 서비스는 StartTask가 완료될 때까지 기다리지 않습니다. 이 경우 StartTask가 계속 실행되는 동안 다른 태스크가 컴퓨팅 노드에서 실행을 시작할 수 있습니다. StartTask가 실패하더라도 컴퓨팅 노드에서 새 작업이 계속 예약됩니다. 기본값은 true입니다. 속성을 업데이트하려면 'true' 또는 'false'를 지정합니다.

--target-communication

풀에 대해 원하는 노드 통신 모드입니다. 이 요소가 있으면 풀에 구성된 기존 targetNodeCommunicationMode를 대체합니다. 생략하면 기존 메타데이터는 변경되지 않은 상태로 유지됩니다.

허용되는 값: classic, default, simplified
전역 매개 변수
--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

오류만 표시하고, 경고를 표시하지 않습니다.

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc
기본값: json
--query

JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.

--subscription

구독의 이름 또는 ID입니다. az account set -s NAME_OR_ID를 사용하여 기본 위치를 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.

az batch pool show

지정된 풀에 대한 정보를 가져옵니다.

az batch pool show --pool-id
                   [--account-endpoint]
                   [--account-key]
                   [--account-name]
                   [--expand]
                   [--if-match]
                   [--if-modified-since]
                   [--if-none-match]
                   [--if-unmodified-since]
                   [--select]

필수 매개 변수

--pool-id

가져올 풀의 ID입니다.

선택적 매개 변수

--account-endpoint

Batch 서비스 엔드포인트. 또는 환경 변수( AZURE_BATCH_ENDPOINT)로 설정합니다.

--account-key

Batch 계정 키입니다. 또는 환경 변수( AZURE_BATCH_ACCESS_KEY)로 설정합니다.

--account-name

Batch 계정 이름입니다. 또는 환경 변수( AZURE_BATCH_ACCOUNT)로 설정합니다.

--expand

OData $expand 절입니다.

--if-match

클라이언트에 알려진 리소스의 버전과 연결된 ETag 값입니다. 이 작업은 서비스에 대한 리소스의 현재 ETag가 클라이언트에서 지정한 값과 정확히 일치하는 경우에만 수행됩니다.

--if-modified-since

클라이언트에 알려진 리소스의 마지막으로 수정된 시간을 나타내는 타임스탬프입니다. 지정된 시간 이후 서비스의 리소스가 수정된 경우에만 작업이 수행됩니다.

--if-none-match

클라이언트에 알려진 리소스의 버전과 연결된 ETag 값입니다. 이 작업은 서비스에서 리소스의 현재 ETag가 클라이언트에서 지정한 값과 일치하지 않는 경우에만 수행됩니다.

--if-unmodified-since

클라이언트에 알려진 리소스의 마지막으로 수정된 시간을 나타내는 타임스탬프입니다. 지정된 시간 이후 서비스의 리소스가 수정되지 않은 경우에만 작업이 수행됩니다.

--select

OData $select 절입니다.

전역 매개 변수
--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

오류만 표시하고, 경고를 표시하지 않습니다.

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc
기본값: json
--query

JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.

--subscription

구독의 이름 또는 ID입니다. az account set -s NAME_OR_ID를 사용하여 기본 위치를 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.