다음을 통해 공유

az batch job

  • 참조

Batch 작업을 관리합니다.

명령

Name Description 형식 상태
az batch job create

Batch 계정에 작업을 추가합니다.

 심 조지아
az batch job delete

Batch 계정에서 작업을 삭제합니다.

 심 조지아
az batch job disable

Batch 작업을 사용하지 않도록 설정합니다.

 심 조지아
az batch job enable

Batch 작업을 사용하도록 설정합니다.

 심 조지아
az batch job list

Batch 계정의 모든 작업 또는 작업 일정을 나열합니다.

 심 조지아
az batch job prep-release-status

Batch 작업 준비 및 릴리스 작업의 상태를 확인합니다.

 심 조지아
az batch job prep-release-status list

작업이 실행된 컴퓨팅 노드에서 지정된 작업에 대한 작업 준비 및 작업 릴리스 태스크의 실행 상태를 나열합니다.

 심 조지아
az batch job reset

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

 심 조지아
az batch job set

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

 심 조지아
az batch job show

지정된 Batch 작업에 대한 정보를 가져옵니다.

 심 조지아
az batch job stop

실행 중인 Batch 작업을 중지합니다.

 심 조지아
az batch job task-counts

Batch 작업 및 해당 상태의 작업 및 슬롯 수를 확인합니다.

 심 조지아
az batch job task-counts show

지정된 작업에 대한 작업 수를 가져옵니다.

 심 조지아

az batch job create

편집

Batch 계정에 작업을 추가합니다.

az batch job create [--account-endpoint]
                    [--account-key]
                    [--account-name]
                    [--allow-task-preemption]
                    [--id]
                    [--job-manager-task-application-package-references]
                    [--job-manager-task-command-line]
                    [--job-manager-task-environment-settings]
                    [--job-manager-task-id]
                    [--job-manager-task-resource-files]
                    [--job-max-task-retry-count]
                    [--job-max-wall-clock-time]
                    [--json-file]
                    [--max-parallel-tasks]
                    [--metadata]
                    [--on-all-tasks-complete]
                    [--pool-id]
                    [--priority]
                    [--required-slots]
                    [--uses-task-dependencies]

예제

기존 풀과 연결된 새 작업을 만듭니다.

az batch job create --id job1 --pool-id pool1

선택적 매개 변수

--account-endpoint

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

--account-key

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

--account-name

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

--allow-task-preemption

이 작업의 태스크가 다른 우선 순위가 높은 작업에서 선점할 수 있는지 여부입니다. 값이 True로 설정된 경우 시스템에 제출된 다른 우선 순위가 높은 작업이 우선적으로 적용되며 이 작업에서 작업을 다시 큐에 추가할 수 있습니다. 업데이트 작업 API를 사용하여 작업을 만든 후 작업의 allowTaskPreemption을 업데이트할 수 있습니다. 플래그가 있으면 True입니다.

--id

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

--job-manager-task-application-package-references

명령줄을 실행하기 전에 Batch 서비스가 컴퓨팅 노드에 배포할 애플리케이션 패키지 목록입니다. 애플리케이션 패키지는 작업 작업 디렉터리가 아닌 공유 디렉터리에 다운로드되고 배포됩니다. 따라서 참조된 애플리케이션 패키지가 컴퓨팅 노드에 이미 있고 최신 상태이면 다시 다운로드되지 않습니다. 컴퓨팅 노드의 기존 복사본이 사용됩니다. 예를 들어 패키지가 삭제되었거나 다운로드에 실패하여 참조된 애플리케이션 패키지를 설치할 수 없는 경우 작업이 실패합니다. 'id[#version]' 형식의 선택적 버전이 있는 공백으로 구분된 애플리케이션 ID입니다.

--job-manager-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)를 사용해야 합니다. 필수.

--job-manager-task-environment-settings

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

--job-manager-task-id

작업 내에서 작업 관리자 태스크를 고유하게 식별하는 문자열입니다. ID는 하이픈과 밑줄을 포함하여 영숫자 문자의 조합을 포함할 수 있으며 64자를 초과할 수 없습니다. 필수.

--job-manager-task-resource-files

명령줄을 실행하기 전에 Batch 서비스가 컴퓨팅 노드에 다운로드할 파일 목록입니다. 이 요소 아래에 나열된 파일은 Task의 작업 디렉터리에 있습니다. 리소스 파일 목록에 대한 최대 크기가 있습니다. 최대 크기를 초과하면 요청이 실패하고 응답 오류 코드는 RequestEntityTooLarge가 됩니다. 이 경우 ResourceFiles 컬렉션의 크기를 줄여야 합니다. 이 작업은 .zip 파일, 애플리케이션 패키지 또는 Docker 컨테이너를 사용하여 수행할 수 있습니다. filename=httpurl 형식의 공백으로 구분된 리소스 참조입니다.

--job-max-task-retry-count

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

--job-max-wall-clock-time

작업이 실행될 수 있는 최대 경과 시간이며, 작업이 만들어진 시간부터 측정됩니다. 작업이 시간 제한 내에서 완료되지 않으면 Batch 서비스는 작업을 종료하고 여전히 실행 중인 모든 작업을 종료합니다. 이 경우 종료 이유는 MaxWallClockTimeExpiry입니다. 이 속성을 지정하지 않으면 작업이 실행될 수 있는 기간에 대한 시간 제한이 없습니다. 예상 형식은 ISO-8601 기간입니다.

--json-file

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

--max-parallel-tasks

작업에 대해 병렬로 실행할 수 있는 최대 작업 수입니다. maxParallelTasks 값은 지정된 경우 -1 0보다 커야 합니다. 지정하지 않으면 기본값은 -1입니다. 즉, 한 번에 실행할 수 있는 작업 수에는 제한이 없습니다. 업데이트 작업 API를 사용하여 작업을 만든 후 작업의 maxParallelTasks를 업데이트할 수 있습니다.

--metadata

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

--on-all-tasks-complete

작업의 모든 작업이 완료된 상태일 때 Batch 서비스에서 수행해야 하는 작업입니다. 작업에 태스크가 없으면 모든 작업이 완료된 것으로 간주됩니다. 따라서 이 옵션은 작업 관리자 작업에서 가장 일반적으로 사용됩니다. 작업 관리자 없이 자동 작업 종료를 사용하려면 처음에는 OnAllTasksComplete를 noaction으로 설정하고 작업 속성을 업데이트하여 작업을 추가한 후 onAllTasksComplete를 종료하도록 설정해야 합니다. 기본값은 noaction입니다. 알려진 값은 "noaction" 및 "terminatejob"입니다.

--pool-id

기존 풀의 ID입니다. 작업의 모든 작업은 지정된 풀에서 실행됩니다. 이 속성에서 참조하는 풀이 있는지 확인해야 합니다. Batch 서비스가 작업을 예약하려고 할 때 풀이 없으면 해당 ID가 있는 풀을 만들 때까지 작업에 대한 태스크가 실행되지 않습니다. Batch 서비스는 작업 요청을 거부하지 않습니다. 풀이 존재할 때까지 작업을 실행하지 않습니다. 풀 ID 또는 자동 풀 사양을 지정해야 하지만 둘 다 지정하지는 않습니다.

--priority

작업의 우선 순위입니다. 우선 순위 값은 -1000 범위에서 1000까지 다양할 수 있으며 -1000 가장 낮은 우선 순위이고 1000은 가장 높은 우선 순위입니다. 기본값은 0입니다.

--required-slots

태스크를 실행하는 데 필요한 예약 슬롯 수입니다. 기본값은 1입니다. 노드에 사용 가능한 여유 일정 슬롯이 충분한 경우에만 컴퓨팅 노드에서 작업을 실행하도록 예약할 수 있습니다. 다중 인스턴스 작업의 경우 이 속성은 지원되지 않으며 지정해서는 안 됩니다.

--uses-task-dependencies

작업의 태스크가 서로 종속성을 정의할 수 있는지 여부입니다. 기본값은 false입니다. 플래그가 있으면 True입니다.

전역 매개 변수
--debug

로깅 세부 정보를 늘려 모든 디버그 로그를 표시합니다.

--help -h

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

--only-show-errors

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

--output -o

출력 형식입니다.

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

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

--subscription

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

--verbose

로깅 세부 정보를 늘립니다. 전체 디버그 로그에 --debug를 사용합니다.

az batch job delete

편집

Batch 계정에서 작업을 삭제합니다.

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

예제

확인 메시지를 표시하지 않고 작업 ID를 사용하여 작업을 삭제합니다.

az batch job delete --job-id job1 --yes

필수 매개 변수

--job-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

확인 메시지를 표시하지 않습니다.

Default value: False
전역 매개 변수
--debug

로깅 세부 정보를 늘려 모든 디버그 로그를 표시합니다.

--help -h

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

--only-show-errors

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

--output -o

출력 형식입니다.

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

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

--subscription

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

--verbose

로깅 세부 정보를 늘립니다. 전체 디버그 로그에 --debug를 사용합니다.

az batch job disable

편집

Batch 작업을 사용하지 않도록 설정합니다.

az batch job disable --job-id
                     [--account-endpoint]
                     [--account-key]
                     [--account-name]
                     [--disable-tasks]
                     [--if-match]
                     [--if-modified-since]
                     [--if-none-match]
                     [--if-unmodified-since]
                     [--json-file]

예제

작업을 사용하지 않도록 설정하고 실행 중인 작업을 다시 큐에 추가합니다.

az batch job disable --job-id job1 --disable-tasks requeue

필수 매개 변수

--job-id

사용하지 않도록 설정할 작업의 ID입니다. 필수.

선택적 매개 변수

--account-endpoint

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

--account-key

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

--account-name

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

--disable-tasks

작업과 연결된 활성 작업으로 수행할 작업입니다. 필수. 알려진 값은 "requeue", "terminate" 및 "wait"입니다.

--if-match

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

--if-modified-since

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

--if-none-match

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

--if-unmodified-since

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

--json-file

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

전역 매개 변수
--debug

로깅 세부 정보를 늘려 모든 디버그 로그를 표시합니다.

--help -h

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

--only-show-errors

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

--output -o

출력 형식입니다.

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

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

--subscription

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

--verbose

로깅 세부 정보를 늘립니다. 전체 디버그 로그에 --debug를 사용합니다.

az batch job enable

편집

Batch 작업을 사용하도록 설정합니다.

az batch job enable --job-id
                    [--account-endpoint]
                    [--account-key]
                    [--account-name]
                    [--if-match]
                    [--if-modified-since]
                    [--if-none-match]
                    [--if-unmodified-since]

예제

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

az batch job enable --job-id job1

필수 매개 변수

--job-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

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

전역 매개 변수
--debug

로깅 세부 정보를 늘려 모든 디버그 로그를 표시합니다.

--help -h

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

--only-show-errors

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

--output -o

출력 형식입니다.

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

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

--subscription

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

--verbose

로깅 세부 정보를 늘립니다. 전체 디버그 로그에 --debug를 사용합니다.

az batch job list

편집

Batch 계정의 모든 작업 또는 작업 일정을 나열합니다.

az batch job list [--account-endpoint]
                  [--account-key]
                  [--account-name]
                  [--expand]
                  [--filter]
                  [--job-schedule-id]
                  [--select]

예제

Batch 계정의 모든 작업 나열

az batch job list

Batch 계정의 모든 작업 일정을 나열합니다.

az batch job list --job-schedule-id jobschedule1

선택적 매개 변수

--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://learn.microsoft.com/rest/api/batchservice/odata-filters-in-batch참조하세요.

--job-schedule-id

작업 목록을 가져올 작업 일정의 ID입니다. 생략하면 계정의 모든 작업이 나열됩니다.

--select

OData $select 절입니다.

전역 매개 변수
--debug

로깅 세부 정보를 늘려 모든 디버그 로그를 표시합니다.

--help -h

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

--only-show-errors

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

--output -o

출력 형식입니다.

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

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

--subscription

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

--verbose

로깅 세부 정보를 늘립니다. 전체 디버그 로그에 --debug를 사용합니다.

az batch job reset

편집

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

az batch job reset --job-id
                   [--account-endpoint]
                   [--account-key]
                   [--account-name]
                   [--allow-task-preemption]
                   [--if-match]
                   [--if-modified-since]
                   [--if-none-match]
                   [--if-unmodified-since]
                   [--job-max-task-retry-count]
                   [--job-max-wall-clock-time]
                   [--json-file]
                   [--max-parallel-tasks]
                   [--metadata]
                   [--on-all-tasks-complete]
                   [--pool-id]
                   [--priority]

예제

우선 순위를 제외한 모든 작업 속성을 다시 설정합니다.

az batch job reset --job-id job1 --priority 100

필수 매개 변수

--job-id

속성을 업데이트하려는 작업의 ID입니다. 필수.

선택적 매개 변수

--account-endpoint

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

--account-key

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

--account-name

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

--allow-task-preemption

이 작업의 태스크가 다른 우선 순위가 높은 작업에서 선점할 수 있는지 여부입니다. 값이 True로 설정된 경우 시스템에 제출된 다른 우선 순위가 높은 작업이 우선적으로 적용되며 이 작업에서 작업을 다시 큐에 추가할 수 있습니다. 업데이트 작업 API를 사용하여 작업을 만든 후 작업의 allowTaskPreemption을 업데이트할 수 있습니다. 플래그가 있으면 True입니다.

--if-match

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

--if-modified-since

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

--if-none-match

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

--if-unmodified-since

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

--job-max-task-retry-count

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

--job-max-wall-clock-time

작업이 실행될 수 있는 최대 경과 시간이며, 작업이 만들어진 시간부터 측정됩니다. 작업이 시간 제한 내에서 완료되지 않으면 Batch 서비스는 작업을 종료하고 여전히 실행 중인 모든 작업을 종료합니다. 이 경우 종료 이유는 MaxWallClockTimeExpiry입니다. 이 속성을 지정하지 않으면 작업이 실행될 수 있는 기간에 대한 시간 제한이 없습니다. 예상 형식은 ISO-8601 기간입니다.

--json-file

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

--max-parallel-tasks

작업에 대해 병렬로 실행할 수 있는 최대 작업 수입니다. maxParallelTasks 값은 지정된 경우 -1 0보다 커야 합니다. 지정하지 않으면 기본값은 -1입니다. 즉, 한 번에 실행할 수 있는 작업 수에는 제한이 없습니다. 업데이트 작업 API를 사용하여 작업을 만든 후 작업의 maxParallelTasks를 업데이트할 수 있습니다.

--metadata

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

--on-all-tasks-complete

작업의 모든 작업이 완료된 상태일 때 Batch 서비스에서 수행해야 하는 작업입니다. 기본값은 noaction입니다. 알려진 값은 "noaction" 및 "terminatejob"입니다.

--pool-id

기존 풀의 ID입니다. 작업의 모든 작업은 지정된 풀에서 실행됩니다. 이 속성에서 참조하는 풀이 있는지 확인해야 합니다. Batch 서비스가 작업을 예약하려고 할 때 풀이 없으면 해당 ID가 있는 풀을 만들 때까지 작업에 대한 태스크가 실행되지 않습니다. Batch 서비스는 작업 요청을 거부하지 않습니다. 풀이 존재할 때까지 작업을 실행하지 않습니다. 풀 ID 또는 자동 풀 사양을 지정해야 하지만 둘 다 지정하지는 않습니다.

--priority

작업의 우선 순위입니다. 우선 순위 값은 -1000 범위에서 1000까지 다양할 수 있으며 -1000 가장 낮은 우선 순위이고 1000은 가장 높은 우선 순위입니다. 기본값은 0입니다.

전역 매개 변수
--debug

로깅 세부 정보를 늘려 모든 디버그 로그를 표시합니다.

--help -h

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

--only-show-errors

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

--output -o

출력 형식입니다.

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

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

--subscription

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

--verbose

로깅 세부 정보를 늘립니다. 전체 디버그 로그에 --debug를 사용합니다.

az batch job set

편집

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

az batch job set --job-id
                 [--account-endpoint]
                 [--account-key]
                 [--account-name]
                 [--allow-task-preemption]
                 [--if-match]
                 [--if-modified-since]
                 [--if-none-match]
                 [--if-unmodified-since]
                 [--job-max-task-retry-count]
                 [--job-max-wall-clock-time]
                 [--json-file]
                 [--max-parallel-tasks]
                 [--metadata]
                 [--on-all-tasks-complete]
                 [--pool-id]
                 [--priority]

예제

작업 우선 순위를 업데이트합니다.

az batch job set --job-id job1 --priority 100

필수 매개 변수

--job-id

속성을 업데이트하려는 작업의 ID입니다. 필수.

선택적 매개 변수

--account-endpoint

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

--account-key

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

--account-name

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

--allow-task-preemption

이 작업의 태스크가 다른 우선 순위가 높은 작업에서 선점할 수 있는지 여부입니다. 값이 True로 설정된 경우 시스템에 제출된 다른 우선 순위가 높은 작업이 우선적으로 적용되며 이 작업에서 작업을 다시 큐에 추가할 수 있습니다. 업데이트 작업 API를 사용하여 작업을 만든 후 작업의 allowTaskPreemption을 업데이트할 수 있습니다. 플래그가 있으면 True입니다.

--if-match

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

--if-modified-since

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

--if-none-match

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

--if-unmodified-since

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

--job-max-task-retry-count

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

--job-max-wall-clock-time

작업이 실행될 수 있는 최대 경과 시간이며, 작업이 만들어진 시간부터 측정됩니다. 작업이 시간 제한 내에서 완료되지 않으면 Batch 서비스는 작업을 종료하고 여전히 실행 중인 모든 작업을 종료합니다. 이 경우 종료 이유는 MaxWallClockTimeExpiry입니다. 이 속성을 지정하지 않으면 작업이 실행될 수 있는 기간에 대한 시간 제한이 없습니다. 예상 형식은 ISO-8601 기간입니다.

--json-file

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

--max-parallel-tasks

작업에 대해 병렬로 실행할 수 있는 최대 작업 수입니다. maxParallelTasks 값은 지정된 경우 -1 0보다 커야 합니다. 지정하지 않으면 기본값은 -1입니다. 즉, 한 번에 실행할 수 있는 작업 수에는 제한이 없습니다. 업데이트 작업 API를 사용하여 작업을 만든 후 작업의 maxParallelTasks를 업데이트할 수 있습니다.

--metadata

작업과 메타데이터로 연결된 이름-값 쌍의 목록입니다. 생략하면 기존 작업 메타데이터는 변경되지 않은 상태로 유지됩니다. 'key=value' 형식의 공백으로 구분된 값입니다.

--on-all-tasks-complete

작업의 모든 작업이 완료된 상태일 때 Batch 서비스에서 수행해야 하는 작업입니다. 생략하면 완료 동작은 변경되지 않은 상태로 유지됩니다. 값을 terminatejob에서 noaction으로 변경할 수 없습니다. 즉, 자동 작업 종료를 사용한 후에는 다시 해제할 수 없습니다. 이 작업을 수행하려고 하면 '잘못된 속성 값' 오류 응답과 함께 요청이 실패합니다. REST API를 직접 호출하는 경우 HTTP 상태 코드는 400(잘못된 요청)입니다. 알려진 값은 "noaction" 및 "terminatejob"입니다.

--pool-id

기존 풀의 ID입니다. 작업의 모든 작업은 지정된 풀에서 실행됩니다. 이 속성에서 참조하는 풀이 있는지 확인해야 합니다. Batch 서비스가 작업을 예약하려고 할 때 풀이 없으면 해당 ID가 있는 풀을 만들 때까지 작업에 대한 태스크가 실행되지 않습니다. Batch 서비스는 작업 요청을 거부하지 않습니다. 풀이 존재할 때까지 작업을 실행하지 않습니다. 풀 ID 또는 자동 풀 사양을 지정해야 하지만 둘 다 지정하지는 않습니다.

--priority

작업의 우선 순위입니다. 우선 순위 값은 -1000 범위에서 1000까지 다양할 수 있으며 -1000 가장 낮은 우선 순위이고 1000은 가장 높은 우선 순위입니다. 생략하면 작업의 우선 순위가 변경되지 않은 상태로 유지됩니다.

전역 매개 변수
--debug

로깅 세부 정보를 늘려 모든 디버그 로그를 표시합니다.

--help -h

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

--only-show-errors

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

--output -o

출력 형식입니다.

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

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

--subscription

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

--verbose

로깅 세부 정보를 늘립니다. 전체 디버그 로그에 --debug를 사용합니다.

az batch job show

편집

지정된 Batch 작업에 대한 정보를 가져옵니다.

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

예제

작업에 대한 정보 세부 정보를 표시합니다.

az batch job show --job-id job1

필수 매개 변수

--job-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
Default value: json
--query

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

--subscription

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

--verbose

로깅 세부 정보를 늘립니다. 전체 디버그 로그에 --debug를 사용합니다.

az batch job stop

편집

실행 중인 Batch 작업을 중지합니다.

지정된 작업을 종료하여 완료된 것으로 표시합니다. 작업 종료 요청을 받으면 Batch 서비스는 작업을 종료 상태로 설정합니다. 그런 다음 Batch 서비스는 작업과 연결된 실행 중인 작업을 종료하고 필요한 작업 릴리스 작업을 실행합니다. 그런 다음 작업이 완료된 상태로 이동합니다. 작업에 활성 상태의 태스크가 있는 경우 활성 상태로 유지됩니다. 작업이 종료되면 새 작업을 추가할 수 없으며 나머지 활성 작업은 예약되지 않습니다.

az batch job stop --job-id
                  [--account-endpoint]
                  [--account-key]
                  [--account-name]
                  [--if-match]
                  [--if-modified-since]
                  [--if-none-match]
                  [--if-unmodified-since]
                  [--terminate-reason]

예제

작업 중지 및 종료 이유 제공

az batch job stop --job-id job1 --terminate-reason "Completed workflow"

필수 매개 변수

--job-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

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

--terminate-reason

종료 이유입니다.

작업의 TerminateReason으로 표시할 텍스트입니다. 기본값은 'UserTerminate'입니다.

전역 매개 변수
--debug

로깅 세부 정보를 늘려 모든 디버그 로그를 표시합니다.

--help -h

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

--only-show-errors

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

--output -o

출력 형식입니다.

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

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

--subscription

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

--verbose

로깅 세부 정보를 늘립니다. 전체 디버그 로그에 --debug를 사용합니다.