az batch job
참고 항목
이 명령 그룹에는 Azure CLI 및 하나 이상의 확장 모두에 정의된 명령이 있습니다. 확장된 기능을 활용하려면 각 확장을 설치합니다. 확장 프로그램에 대해 자세히 알아보세요.
Batch 작업을 관리합니다.
명령
| Name | Description | 형식 | 상태 |
|---|---|---|---|
| az batch job create |
Batch 계정에 작업을 추가합니다. |
핵심 | GA |
| az batch job create (azure-batch-cli-extensions 확장) |
Batch 계정에 작업 및 관련 작업을 추가합니다. |
내선 번호 | GA |
| az batch job delete |
작업을 삭제합니다. |
핵심 | GA |
| az batch job disable |
지정된 작업을 사용하지 않도록 설정하여 새 작업이 실행되지 않도록 합니다. |
핵심 | GA |
| az batch job enable |
지정된 작업을 사용하도록 설정하여 새 작업을 실행할 수 있도록 합니다. |
핵심 | GA |
| az batch job list |
Batch 계정의 모든 작업 또는 작업 일정을 나열합니다. |
핵심 | GA |
| az batch job prep-release-status |
Batch 작업 준비 및 릴리스 작업의 상태 확인합니다. |
핵심 | GA |
| az batch job prep-release-status list |
작업이 실행된 컴퓨팅 노드에서 지정된 작업에 대한 작업 준비 및 작업 릴리스 태스크의 실행 상태 나열합니다. |
핵심 | GA |
| az batch job reset |
Batch 작업의 속성을 업데이트합니다. 업데이트할 수 있는 지정되지 않은 속성은 기본값으로 다시 설정됩니다. |
핵심 | GA |
| az batch job set |
Batch 작업의 속성을 업데이트합니다. 하위 그룹에서 속성을 업데이트하면 해당 그룹의 지정되지 않은 속성이 다시 설정됩니다. |
핵심 | GA |
| az batch job show |
지정된 작업에 대한 정보를 가져옵니다. |
핵심 | GA |
| az batch job stop |
실행 중인 Batch 작업을 중지합니다. |
핵심 | GA |
| az batch job task-counts |
Batch 작업 및 해당 상태의 작업 및 슬롯 수를 확인합니다. |
핵심 | GA |
| az batch job task-counts show |
지정된 작업에 대한 작업 수를 가져옵니다. |
핵심 | GA |
az batch job create
Batch 계정에 작업을 추가합니다.
az batch job create [--account-endpoint]
[--account-key]
[--account-name]
[--allow-task-preemption]
[--id]
[--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]
[--pool-id]
[--priority]
[--required-slots]
[--uses-task-dependencies]선택적 매개 변수
Batch 서비스 엔드포인트. 또는 환경 변수( AZURE_BATCH_ENDPOINT)로 설정합니다.
Batch 계정 키입니다. 또는 환경 변수( AZURE_BATCH_ACCESS_KEY)로 설정합니다.
Batch 계정 이름입니다. 또는 환경 변수( AZURE_BATCH_ACCOUNT)로 설정합니다.
이 작업의 태스크가 다른 우선 순위가 높은 작업에서 선점할 수 있는지 여부입니다. 값이 True로 설정된 경우 시스템에 제출된 다른 우선 순위가 높은 작업이 우선적으로 적용되며 이 작업에서 작업을 다시 큐에 추가할 수 있습니다. 업데이트 작업 API를 사용하여 작업을 만든 후 작업의 allowTaskPreemption을 업데이트할 수 있습니다. 플래그가 있으면 True입니다.
필수입니다. ID는 하이픈과 밑줄을 포함한 영숫자 문자의 조합을 포함할 수 있으며 64자를 초과할 수 없습니다. ID는 대/소문자를 구분하지 않습니다( 즉, 계정 내에 대/소문자만 다른 ID가 두 개 없을 수 있음).
필수입니다. 명령줄은 셸에서 실행되지 않으므로 환경 변수 확장과 같은 셸 기능을 활용할 수 없습니다. 이러한 기능을 활용하려면 명령줄에서 셸을 호출해야 합니다(예: Windows의 "cmd /c MyCommand" 또는 Linux의 "/bin/sh -c MyCommand"). 명령줄이 파일 경로를 참조하는 경우 상대 경로(작업 작업 디렉터리를 기준으로)를 사용하거나 Batch 제공 환경 변수(https://docs.microsoft.com/en-us/azure/batch/batch-compute-node-environment-variables)를 사용해야 합니다.
'key=value' 형식의 공백으로 구분된 값입니다.
필수입니다. ID는 하이픈과 밑줄을 포함하여 영숫자 문자의 조합을 포함할 수 있으며 64자를 초과할 수 없습니다.
이 요소 아래에 나열된 파일은 Task의 작업 디렉터리에 있습니다. 리소스 파일 목록에 대한 최대 크기가 있습니다. 최대 크기를 초과하면 요청이 실패하고 응답 오류 코드는 RequestEntityTooLarge가 됩니다. 이 경우 ResourceFiles 컬렉션의 크기를 줄여야 합니다. .zip 파일, 애플리케이션 패키지 또는 Docker 컨테이너를 사용하여 이 작업을 수행할 수 있습니다. filename=httpurl 형식의 공백으로 구분된 리소스 참조입니다.
각 작업을 재시도할 수 있는 최대 횟수입니다. Batch 서비스는 종료 코드가 0이 아닌 경우 작업을 다시 시도합니다. 이 값은 구체적으로 재시도 횟수를 제어합니다. Batch 서비스는 각 작업을 한 번 시도한 다음 이 제한까지 다시 시도할 수 있습니다. 예를 들어 최대 재시도 횟수가 3인 경우 Batch는 태스크를 최대 4번(초기 시도 1회, 재시도 3회)을 시도합니다. 최대 재시도 횟수가 0이면 Batch 서비스는 작업을 다시 시도하지 않습니다. 최대 재시도 횟수가 -1이면 Batch 서비스는 제한 없이 작업을 다시 시도합니다. 기본값은 0(재시도 안 됨)입니다.
작업이 시간 제한 내에서 완료되지 않으면 Batch 서비스는 작업을 종료하고 여전히 실행 중인 모든 작업을 종료합니다. 이 경우 종료 이유는 MaxWallClockTimeExpiry입니다. 이 속성을 지정하지 않으면 작업이 실행될 수 있는 기간에 대한 시간 제한이 없습니다. 예상 형식은 ISO-8601 기간입니다.
JSON의 작업 사양을 포함하는 파일입니다(해당 REST API 본문과 일치하도록 형식이 지정됨). 이 매개 변수를 지정하면 모든 '작업 인수'가 무시됩니다.
작업에 대해 병렬로 실행할 수 있는 최대 작업 수입니다. maxParallelTasks 값은 -1이거나 지정된 경우 0보다 커야 합니다. 지정하지 않으면 기본값은 -1입니다. 즉, 한 번에 실행할 수 있는 작업 수에는 제한이 없습니다. 업데이트 작업 API를 사용하여 작업을 만든 후 작업의 maxParallelTasks를 업데이트할 수 있습니다. 기본값: -1 .
Batch 서비스는 메타데이터에 어떤 의미도 할당하지 않습니다. 사용자 코드를 사용하기 위한 것입니다. 'key=value' 형식의 공백으로 구분된 값입니다.
기존 풀의 ID입니다. 작업의 모든 작업은 지정된 풀에서 실행됩니다.
작업의 우선 순위입니다. 우선 순위 값의 범위는 -1000에서 1000까지이며 - 1000은 가장 낮은 우선 순위이고 1000은 가장 높은 우선 순위입니다. 기본값은 0입니다.
태스크를 실행하는 데 필요한 예약 슬롯 수입니다. 기본값은 1입니다. 노드에 사용 가능한 여유 일정 슬롯이 충분한 경우에만 컴퓨팅 노드에서 작업을 실행하도록 예약할 수 있습니다. 다중 인스턴스 작업의 경우 이 속성은 지원되지 않으며 지정해서는 안 됩니다.
작업의 태스크가 서로 종속성을 정의할 수 있는지 여부입니다. 기본값은 false입니다. 플래그가 있으면 True입니다.
전역 매개 변수
로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.
이 도움말 메시지를 표시하고 종료합니다.
경고를 표시하지 않고 오류만 표시합니다.
출력 형식입니다.
JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.
구독의 이름 또는 ID입니다. 를 사용하여 az account set -s NAME_OR_ID기본 구독을 구성할 수 있습니다.
로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.
az batch job create (azure-batch-cli-extensions 확장)
Batch 계정에 작업 및 관련 작업을 추가합니다.
az batch job create [--account-endpoint]
[--account-key]
[--account-name]
[--allow-task-preemption]
[--id]
[--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]
[--parameters]
[--pool-id]
[--priority]
[--required-slots]
[--resource-group]
[--template]
[--uses-task-dependencies]선택적 매개 변수
Batch 서비스 엔드포인트. 또는 환경 변수( AZURE_BATCH_ENDPOINT)로 설정합니다.
Batch 계정 키입니다. 또는 환경 변수( AZURE_BATCH_ACCESS_KEY)로 설정합니다.
배치 계정 이름입니다. 또는 환경 변수( AZURE_BATCH_ACCOUNT)로 설정합니다.
이 작업의 태스크가 다른 우선 순위가 높은 작업에서 선점할 수 있는지 여부입니다. 값이 True로 설정된 경우 시스템에 제출된 다른 우선 순위가 높은 작업이 우선적으로 적용되며 이 작업에서 작업을 다시 큐에 추가할 수 있습니다. 업데이트 작업 API를 사용하여 작업을 만든 후 작업의 allowTaskPreemption을 업데이트할 수 있습니다.
필수입니다. ID는 하이픈과 밑줄을 포함한 영숫자 문자의 조합을 포함할 수 있으며 64자를 초과할 수 없습니다. ID는 대/소문자를 구분하지 않습니다( 즉, 계정 내에 대/소문자만 다른 ID가 두 개 없을 수 있음).
작업 관리자 태스크의 명령줄입니다. 명령줄은 셸에서 실행되지 않으므로 환경 변수 확장과 같은 셸 기능을 활용할 수 없습니다. 이러한 기능을 활용하려면 명령줄에서 셸을 호출해야 합니다(예: Windows의 "cmd /c MyCommand" 또는 Linux의 "/bin/sh -c MyCommand").
작업 관리자 작업에 대한 환경 변수 설정 목록입니다. 'key=value' 형식의 공백으로 구분된 값입니다.
작업 내에서 작업 관리자 작업을 고유하게 식별하는 문자열입니다. ID는 하이픈과 밑줄을 포함하여 영숫자 문자의 조합을 포함할 수 있으며 64자를 초과할 수 없습니다.
명령줄을 실행하기 전에 Batch 서비스가 컴퓨팅 노드에 다운로드할 파일 목록입니다. 이 요소 아래에 나열된 파일은 작업의 작업 디렉터리에 있습니다. filename=httpurl 형식의 공백으로 구분된 리소스 참조입니다.
각 작업을 재시도할 수 있는 최대 횟수입니다. Batch 서비스는 종료 코드가 0이 아닌 경우 작업을 다시 시도합니다. 이 값은 구체적으로 재시도 횟수를 제어합니다. Batch 서비스는 각 작업을 한 번 시도한 다음 이 제한까지 다시 시도할 수 있습니다. 예를 들어 최대 재시도 횟수가 3인 경우 Batch는 작업을 최대 4번(초기 시도 1회, 재시도 3회)을 시도합니다. 최대 재시도 횟수가 0일 경우 Batch 서비스는 태스크를 다시 시도하지 않습니다. 최대 재시도 횟수가 -1이면 Batch 서비스는 제한 없이 작업을 다시 시도합니다. 기본값은 0(재시도 안 됨)입니다.
작업이 실행될 수 있는 최대 경과 시간이며, 작업이 만들어진 시간부터 측정됩니다. 작업이 시간 제한 내에서 완료되지 않으면 Batch 서비스는 작업을 종료하고 여전히 실행 중인 모든 작업을 종료합니다. 이 경우 종료 이유는 MaxWallClockTimeExpiry입니다. 이 속성을 지정하지 않으면 작업이 실행될 수 있는 기간에 대한 시간 제한이 없습니다. 예상 형식은 ISO-8601 기간입니다.
JSON의 작업 사양을 포함하는 파일입니다(해당 REST API 본문과 일치하도록 형식이 지정됨). 이 매개 변수를 지정하면 모든 '작업 인수'가 무시됩니다.
작업에 대해 병렬로 실행할 수 있는 최대 작업 수입니다. maxParallelTasks 값은 -1이거나 지정된 경우 0보다 커야 합니다. 지정하지 않으면 기본값은 -1입니다. 즉, 한 번에 실행할 수 있는 작업 수에는 제한이 없습니다. 업데이트 작업 API를 사용하여 작업을 만든 후 작업의 maxParallelTasks를 업데이트할 수 있습니다. 기본값: -1 .
Batch 서비스는 메타데이터에 어떤 의미도 할당하지 않습니다. 사용자 코드를 사용하기 위한 것입니다.
Batch 작업 JSON 템플릿 파일의 매개 변수 값입니다. --template에서만 사용할 수 있습니다.
기존 풀의 ID입니다. 작업의 모든 작업은 지정된 풀에서 실행됩니다.
작업의 우선 순위입니다. 우선 순위 값의 범위는 -1000에서 1000까지이며 - 1000은 가장 낮은 우선 순위이고 1000은 가장 높은 우선 순위입니다. 기본값은 0입니다.
태스크를 실행하는 데 필요한 예약 슬롯 수입니다. 기본값은 1입니다. 노드에 사용 가능한 여유 일정 슬롯이 충분한 경우에만 컴퓨팅 노드에서 작업을 실행하도록 예약할 수 있습니다. 다중 인스턴스 작업의 경우 이 속성은 지원되지 않으며 지정해서는 안 됩니다.
Batch 계정의 리소스 그룹입니다.
Batch 작업 JSON 템플릿 파일입니다. 이 매개 변수를 지정하면 다른 모든 매개 변수가 무시됩니다.
이 작업이 종속성이 있는 작업을 사용할지 여부를 결정하는 플래그입니다. 플래그가 있으면 True입니다.
전역 매개 변수
로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.
이 도움말 메시지를 표시하고 종료합니다.
경고를 표시하지 않고 오류만 표시합니다.
출력 형식입니다.
JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.
구독의 이름 또는 ID입니다. 를 사용하여 az account set -s NAME_OR_ID기본 구독을 구성할 수 있습니다.
로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.
az batch job delete
작업을 삭제합니다.
또한 작업을 삭제하면 해당 작업의 일부인 모든 작업과 모든 작업 통계가 삭제됩니다. 또한 작업 데이터의 보존 기간도 재정의합니다. 즉, 작업에 컴퓨팅 노드에 계속 유지되는 태스크가 포함된 경우 Batch 서비스는 해당 태스크의 작업 디렉터리와 모든 내용을 삭제합니다. 작업 삭제 요청이 수신되면 Batch 서비스는 작업을 삭제 상태로 설정합니다. 삭제 상태에 있는 작업의 모든 업데이트 작업은 작업이 삭제되고 있음을 나타내는 추가 정보와 함께 상태 코드 409(충돌)로 인해 실패합니다.
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입니다.
선택적 매개 변수
Batch 서비스 엔드포인트. 또는 환경 변수( AZURE_BATCH_ENDPOINT)로 설정합니다.
Batch 계정 키입니다. 또는 환경 변수( AZURE_BATCH_ACCESS_KEY)로 설정합니다.
Batch 계정 이름입니다. 또는 환경 변수( AZURE_BATCH_ACCOUNT)로 설정합니다.
클라이언트에 알려진 리소스의 버전과 연결된 ETag 값입니다. 이 작업은 서비스에 대한 리소스의 현재 ETag가 클라이언트에서 지정한 값과 정확히 일치하는 경우에만 수행됩니다.
클라이언트에 알려진 리소스의 마지막으로 수정된 시간을 나타내는 타임스탬프입니다. 지정된 시간 이후 서비스의 리소스가 수정된 경우에만 작업이 수행됩니다.
클라이언트에 알려진 리소스의 버전과 연결된 ETag 값입니다. 이 작업은 서비스에서 리소스의 현재 ETag가 클라이언트에서 지정한 값과 일치하지 않는 경우에만 수행됩니다.
클라이언트에 알려진 리소스의 마지막으로 수정된 시간을 나타내는 타임스탬프입니다. 지정된 시간 이후 서비스의 리소스가 수정되지 않은 경우에만 작업이 수행됩니다.
확인 메시지를 표시하지 않습니다.
전역 매개 변수
로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.
이 도움말 메시지를 표시하고 종료합니다.
경고를 표시하지 않고 오류만 표시합니다.
출력 형식입니다.
JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.
구독의 이름 또는 ID입니다. 를 사용하여 az account set -s NAME_OR_ID기본 구독을 구성할 수 있습니다.
로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.
az batch job disable
지정된 작업을 사용하지 않도록 설정하여 새 작업이 실행되지 않도록 합니다.
Batch 서비스는 즉시 작업을 비활성화 상태로 이동합니다. 그런 다음 Batch는 disableTasks 매개 변수를 사용하여 현재 실행 중인 작업 작업으로 수행할 작업을 결정합니다. 사용 안 함 작업이 완료되고 disableTasks 옵션에 따라 모든 작업이 처리될 때까지 작업이 비활성화 상태로 다시 기본. 그러면 작업이 사용 안 함 상태로 이동합니다. 작업에서 활성 상태로 다시 이동할 때까지 새 작업이 시작되지 않습니다. 활성, 사용 안 함 또는 사용 안 함 이외의 상태에 있는 작업을 사용하지 않도록 설정하려고 하면 상태 코드 409로 요청이 실패합니다.
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]필수 매개 변수
사용하지 않도록 설정할 작업의 ID입니다.
선택적 매개 변수
Batch 서비스 엔드포인트. 또는 환경 변수( AZURE_BATCH_ENDPOINT)로 설정합니다.
Batch 계정 키입니다. 또는 환경 변수( AZURE_BATCH_ACCESS_KEY)로 설정합니다.
Batch 계정 이름입니다. 또는 환경 변수( AZURE_BATCH_ACCOUNT)로 설정합니다.
가능한 값은 'requeue', 'terminate', 'wait'입니다.
클라이언트에 알려진 리소스의 버전과 연결된 ETag 값입니다. 이 작업은 서비스에 대한 리소스의 현재 ETag가 클라이언트에서 지정한 값과 정확히 일치하는 경우에만 수행됩니다.
클라이언트에 알려진 리소스의 마지막으로 수정된 시간을 나타내는 타임스탬프입니다. 지정된 시간 이후 서비스의 리소스가 수정된 경우에만 작업이 수행됩니다.
클라이언트에 알려진 리소스의 버전과 연결된 ETag 값입니다. 이 작업은 서비스에서 리소스의 현재 ETag가 클라이언트에서 지정한 값과 일치하지 않는 경우에만 수행됩니다.
클라이언트에 알려진 리소스의 마지막으로 수정된 시간을 나타내는 타임스탬프입니다. 지정된 시간 이후 서비스의 리소스가 수정되지 않은 경우에만 작업이 수행됩니다.
전역 매개 변수
로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.
이 도움말 메시지를 표시하고 종료합니다.
경고를 표시하지 않고 오류만 표시합니다.
출력 형식입니다.
JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.
구독의 이름 또는 ID입니다. 를 사용하여 az account set -s NAME_OR_ID기본 구독을 구성할 수 있습니다.
로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.
az batch job enable
지정된 작업을 사용하도록 설정하여 새 작업을 실행할 수 있도록 합니다.
이 API를 호출할 때 Batch 서비스는 비활성화된 작업을 사용 상태로 설정합니다. 이 작업이 완료되면 작업이 활성 상태로 이동하고 작업 아래에 있는 새 작업의 일정이 다시 시작됩니다. Batch 서비스는 180일 이상 활성 상태에서 작업을 다시 기본 수 없습니다. 따라서 180일 전에 추가된 활성 작업이 포함된 작업을 사용하도록 설정하면 해당 작업이 실행되지 않습니다.
az batch job enable --job-id
[--account-endpoint]
[--account-key]
[--account-name]
[--if-match]
[--if-modified-since]
[--if-none-match]
[--if-unmodified-since]필수 매개 변수
사용하도록 설정할 작업의 ID입니다.
선택적 매개 변수
Batch 서비스 엔드포인트. 또는 환경 변수( AZURE_BATCH_ENDPOINT)로 설정합니다.
Batch 계정 키입니다. 또는 환경 변수( AZURE_BATCH_ACCESS_KEY)로 설정합니다.
Batch 계정 이름입니다. 또는 환경 변수( AZURE_BATCH_ACCOUNT)로 설정합니다.
클라이언트에 알려진 리소스의 버전과 연결된 ETag 값입니다. 이 작업은 서비스에 대한 리소스의 현재 ETag가 클라이언트에서 지정한 값과 정확히 일치하는 경우에만 수행됩니다.
클라이언트에 알려진 리소스의 마지막으로 수정된 시간을 나타내는 타임스탬프입니다. 지정된 시간 이후 서비스의 리소스가 수정된 경우에만 작업이 수행됩니다.
클라이언트에 알려진 리소스의 버전과 연결된 ETag 값입니다. 이 작업은 서비스에서 리소스의 현재 ETag가 클라이언트에서 지정한 값과 일치하지 않는 경우에만 수행됩니다.
클라이언트에 알려진 리소스의 마지막으로 수정된 시간을 나타내는 타임스탬프입니다. 지정된 시간 이후 서비스의 리소스가 수정되지 않은 경우에만 작업이 수행됩니다.
전역 매개 변수
로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.
이 도움말 메시지를 표시하고 종료합니다.
경고를 표시하지 않고 오류만 표시합니다.
출력 형식입니다.
JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.
구독의 이름 또는 ID입니다. 를 사용하여 az account set -s NAME_OR_ID기본 구독을 구성할 수 있습니다.
로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.
az batch job list
Batch 계정의 모든 작업 또는 작업 일정을 나열합니다.
az batch job list [--account-endpoint]
[--account-key]
[--account-name]
[--expand]
[--filter]
[--job-schedule-id]
[--select]선택적 매개 변수
Batch 서비스 엔드포인트. 또는 환경 변수( AZURE_BATCH_ENDPOINT)로 설정합니다.
Batch 계정 키입니다. 또는 환경 변수( AZURE_BATCH_ACCESS_KEY)로 설정합니다.
배치 계정 이름입니다. 또는 환경 변수( AZURE_BATCH_ACCOUNT)로 설정합니다.
OData $expand 절입니다.
OData $filter 절입니다.
작업 목록을 가져올 작업 일정의 ID입니다. 생략하면 계정의 모든 작업이 나열됩니다.
OData $select 절입니다.
전역 매개 변수
로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.
이 도움말 메시지를 표시하고 종료합니다.
경고를 표시하지 않고 오류만 표시합니다.
출력 형식입니다.
JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.
구독의 이름 또는 ID입니다. 를 사용하여 az account set -s NAME_OR_ID기본 구독을 구성할 수 있습니다.
로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --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 {noaction, terminatejob}]
[--pool-id]
[--priority]필수 매개 변수
속성을 업데이트하려는 작업의 ID입니다.
선택적 매개 변수
Batch 서비스 엔드포인트. 또는 환경 변수( AZURE_BATCH_ENDPOINT)로 설정합니다.
Batch 계정 키입니다. 또는 환경 변수( AZURE_BATCH_ACCESS_KEY)로 설정합니다.
Batch 계정 이름입니다. 또는 환경 변수( AZURE_BATCH_ACCOUNT)로 설정합니다.
이 작업의 태스크가 다른 우선 순위가 높은 작업에서 선점할 수 있는지 여부입니다. 값이 True로 설정된 경우 시스템에 제출된 다른 우선 순위가 높은 작업이 우선적으로 적용되며 이 작업에서 작업을 다시 큐에 추가할 수 있습니다. 업데이트 작업 API를 사용하여 작업을 만든 후 작업의 allowTaskPreemption을 업데이트할 수 있습니다. 플래그가 있으면 True입니다.
클라이언트에 알려진 리소스의 버전과 연결된 ETag 값입니다. 이 작업은 서비스에 대한 리소스의 현재 ETag가 클라이언트에서 지정한 값과 정확히 일치하는 경우에만 수행됩니다.
클라이언트에 알려진 리소스의 마지막으로 수정된 시간을 나타내는 타임스탬프입니다. 지정된 시간 이후 서비스의 리소스가 수정된 경우에만 작업이 수행됩니다.
클라이언트에 알려진 리소스의 버전과 연결된 ETag 값입니다. 이 작업은 서비스에서 리소스의 현재 ETag가 클라이언트에서 지정한 값과 일치하지 않는 경우에만 수행됩니다.
클라이언트에 알려진 리소스의 마지막으로 수정된 시간을 나타내는 타임스탬프입니다. 지정된 시간 이후 서비스의 리소스가 수정되지 않은 경우에만 작업이 수행됩니다.
각 작업을 재시도할 수 있는 최대 횟수입니다. Batch 서비스는 종료 코드가 0이 아닌 경우 작업을 다시 시도합니다. 이 값은 구체적으로 재시도 횟수를 제어합니다. Batch 서비스는 각 작업을 한 번 시도한 다음 이 제한까지 다시 시도할 수 있습니다. 예를 들어 최대 재시도 횟수가 3인 경우 Batch는 태스크를 최대 4번(초기 시도 1회, 재시도 3회)을 시도합니다. 최대 재시도 횟수가 0이면 Batch 서비스는 작업을 다시 시도하지 않습니다. 최대 재시도 횟수가 -1이면 Batch 서비스는 제한 없이 작업을 다시 시도합니다. 기본값은 0(재시도 안 됨)입니다.
작업이 시간 제한 내에서 완료되지 않으면 Batch 서비스는 작업을 종료하고 여전히 실행 중인 모든 작업을 종료합니다. 이 경우 종료 이유는 MaxWallClockTimeExpiry입니다. 이 속성을 지정하지 않으면 작업이 실행될 수 있는 기간에 대한 시간 제한이 없습니다. 예상 형식은 ISO-8601 기간입니다.
JSON의 작업 업데이트 매개 변수 사양을 포함하는 파일입니다(해당 REST API 본문과 일치하도록 형식이 지정됨). 이 매개 변수를 지정하면 모든 '작업 인수'가 무시됩니다.
작업에 대해 병렬로 실행할 수 있는 최대 작업 수입니다. maxParallelTasks 값은 -1이거나 지정된 경우 0보다 커야 합니다. 지정하지 않으면 기본값은 -1입니다. 즉, 한 번에 실행할 수 있는 작업 수에는 제한이 없습니다. 업데이트 작업 API를 사용하여 작업을 만든 후 작업의 maxParallelTasks를 업데이트할 수 있습니다. 기본값: -1 .
생략하면 빈 목록의 기본값이 사용됩니다. 실제로 기존 메타데이터는 삭제됩니다. 'key=value' 형식의 공백으로 구분된 값입니다.
작업의 모든 작업이 완료된 상태일 때 Batch 서비스에서 수행해야 하는 작업입니다. 생략하면 완료 동작이 noaction으로 설정됩니다. 현재 값이 terminatejob이면 작업의 완료 동작이 terminatejob에서 noaction으로 변경되지 않을 수 있으므로 오류입니다. 값을 terminatejob에서 noaction으로 변경할 수 없습니다. 즉, 자동 작업 종료를 사용한 후에는 다시 해제할 수 없습니다. 이 작업을 수행하려고 하면 요청이 실패하고 Batch는 코드 400(잘못된 요청)과 '잘못된 속성 값' 오류 응답을 상태 반환합니다. PUT 요청에서 이 요소를 지정하지 않으면 noaction을 전달하는 것과 같습니다. 현재 값이 terminatejob이면 이 오류가 발생합니다.
기존 풀의 ID입니다. 작업의 모든 작업은 지정된 풀에서 실행됩니다.
작업의 우선 순위입니다. 우선 순위 값의 범위는 -1000에서 1000까지이며 - 1000은 가장 낮은 우선 순위이고 1000은 가장 높은 우선 순위입니다. 생략하면 기본값 0으로 설정됩니다.
전역 매개 변수
로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.
이 도움말 메시지를 표시하고 종료합니다.
경고를 표시하지 않고 오류만 표시합니다.
출력 형식입니다.
JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.
구독의 이름 또는 ID입니다. 를 사용하여 az account set -s NAME_OR_ID기본 구독을 구성할 수 있습니다.
로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --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 {noaction, terminatejob}]
[--pool-id]
[--priority]필수 매개 변수
속성을 업데이트하려는 작업의 ID입니다.
선택적 매개 변수
Batch 서비스 엔드포인트. 또는 환경 변수( AZURE_BATCH_ENDPOINT)로 설정합니다.
Batch 계정 키입니다. 또는 환경 변수( AZURE_BATCH_ACCESS_KEY)로 설정합니다.
Batch 계정 이름입니다. 또는 환경 변수( AZURE_BATCH_ACCOUNT)로 설정합니다.
이 작업의 태스크가 다른 우선 순위가 높은 작업에서 선점할 수 있는지 여부입니다. 값이 True로 설정된 경우 시스템에 제출된 다른 우선 순위가 높은 작업이 우선적으로 적용되며 이 작업에서 작업을 다시 큐에 추가할 수 있습니다. 업데이트 작업 API를 사용하여 작업을 만든 후 작업의 allowTaskPreemption을 업데이트할 수 있습니다. 속성을 업데이트하려면 'true' 또는 'false'를 지정합니다.
클라이언트에 알려진 리소스의 버전과 연결된 ETag 값입니다. 이 작업은 서비스에 대한 리소스의 현재 ETag가 클라이언트에서 지정한 값과 정확히 일치하는 경우에만 수행됩니다.
클라이언트에 알려진 리소스의 마지막으로 수정된 시간을 나타내는 타임스탬프입니다. 지정된 시간 이후 서비스의 리소스가 수정된 경우에만 작업이 수행됩니다.
클라이언트에 알려진 리소스의 버전과 연결된 ETag 값입니다. 이 작업은 서비스에서 리소스의 현재 ETag가 클라이언트에서 지정한 값과 일치하지 않는 경우에만 수행됩니다.
클라이언트에 알려진 리소스의 마지막으로 수정된 시간을 나타내는 타임스탬프입니다. 지정된 시간 이후 서비스의 리소스가 수정되지 않은 경우에만 작업이 수행됩니다.
각 작업을 재시도할 수 있는 최대 횟수입니다. Batch 서비스는 종료 코드가 0이 아닌 경우 작업을 다시 시도합니다. 이 값은 구체적으로 재시도 횟수를 제어합니다. Batch 서비스는 각 작업을 한 번 시도한 다음 이 제한까지 다시 시도할 수 있습니다. 예를 들어 최대 재시도 횟수가 3인 경우 Batch는 태스크를 최대 4번(초기 시도 1회, 재시도 3회)을 시도합니다. 최대 재시도 횟수가 0이면 Batch 서비스는 작업을 다시 시도하지 않습니다. 최대 재시도 횟수가 -1이면 Batch 서비스는 제한 없이 작업을 다시 시도합니다. 기본값은 0(재시도 안 됨)입니다.
작업이 시간 제한 내에서 완료되지 않으면 Batch 서비스는 작업을 종료하고 여전히 실행 중인 모든 작업을 종료합니다. 이 경우 종료 이유는 MaxWallClockTimeExpiry입니다. 이 속성을 지정하지 않으면 작업이 실행될 수 있는 기간에 대한 시간 제한이 없습니다. 예상 형식은 ISO-8601 기간입니다.
JSON의 작업 패치 매개 변수 사양을 포함하는 파일입니다(해당 REST API 본문과 일치하도록 형식이 지정됨). 이 매개 변수를 지정하면 모든 '작업 인수'가 무시됩니다.
작업에 대해 병렬로 실행할 수 있는 최대 작업 수입니다. maxParallelTasks 값은 -1이거나 지정된 경우 0보다 커야 합니다. 지정하지 않으면 기본값은 -1입니다. 즉, 한 번에 실행할 수 있는 작업 수에는 제한이 없습니다. 업데이트 작업 API를 사용하여 작업을 만든 후 작업의 maxParallelTasks를 업데이트할 수 있습니다.
생략하면 기존 작업 메타데이터는 변경되지 않은 상태로 유지됩니다. 'key=value' 형식의 공백으로 구분된 값입니다.
작업의 모든 작업이 완료된 상태일 때 Batch 서비스에서 수행해야 하는 작업입니다. 생략하면 완료 동작은 변경되지 않은 상태로 유지됩니다. 값을 terminatejob에서 noaction으로 변경할 수 없습니다. 즉, 자동 작업 종료를 사용한 후에는 다시 해제할 수 없습니다. 이 작업을 수행하려고 하면 '잘못된 속성 값' 오류 응답과 함께 요청이 실패합니다. REST API를 직접 호출하는 경우 HTTP 상태 코드는 400(잘못된 요청)입니다.
기존 풀의 ID입니다. 작업의 모든 작업은 지정된 풀에서 실행됩니다.
작업의 우선 순위입니다. 우선 순위 값의 범위는 -1000에서 1000까지이며 - 1000은 가장 낮은 우선 순위이고 1000은 가장 높은 우선 순위입니다. 생략하면 작업의 우선 순위가 변경되지 않은 상태로 유지됩니다.
전역 매개 변수
로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.
이 도움말 메시지를 표시하고 종료합니다.
경고를 표시하지 않고 오류만 표시합니다.
출력 형식입니다.
JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.
구독의 이름 또는 ID입니다. 를 사용하여 az account set -s NAME_OR_ID기본 구독을 구성할 수 있습니다.
로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.
az batch job show
지정된 작업에 대한 정보를 가져옵니다.
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]필수 매개 변수
작업의 ID입니다.
선택적 매개 변수
Batch 서비스 엔드포인트. 또는 환경 변수( AZURE_BATCH_ENDPOINT)로 설정합니다.
Batch 계정 키입니다. 또는 환경 변수( AZURE_BATCH_ACCESS_KEY)로 설정합니다.
Batch 계정 이름입니다. 또는 환경 변수( AZURE_BATCH_ACCOUNT)로 설정합니다.
OData $expand 절입니다.
클라이언트에 알려진 리소스의 버전과 연결된 ETag 값입니다. 이 작업은 서비스에 대한 리소스의 현재 ETag가 클라이언트에서 지정한 값과 정확히 일치하는 경우에만 수행됩니다.
클라이언트에 알려진 리소스의 마지막으로 수정된 시간을 나타내는 타임스탬프입니다. 지정된 시간 이후 서비스의 리소스가 수정된 경우에만 작업이 수행됩니다.
클라이언트에 알려진 리소스의 버전과 연결된 ETag 값입니다. 이 작업은 서비스에서 리소스의 현재 ETag가 클라이언트에서 지정한 값과 일치하지 않는 경우에만 수행됩니다.
클라이언트에 알려진 리소스의 마지막으로 수정된 시간을 나타내는 타임스탬프입니다. 지정된 시간 이후 서비스의 리소스가 수정되지 않은 경우에만 작업이 수행됩니다.
OData $select 절입니다.
전역 매개 변수
로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.
이 도움말 메시지를 표시하고 종료합니다.
경고를 표시하지 않고 오류만 표시합니다.
출력 형식입니다.
JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.
구독의 이름 또는 ID입니다. 를 사용하여 az account set -s NAME_OR_ID기본 구독을 구성할 수 있습니다.
로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --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]필수 매개 변수
종료할 작업의 ID입니다.
선택적 매개 변수
Batch 서비스 엔드포인트. 또는 환경 변수( AZURE_BATCH_ENDPOINT)로 설정합니다.
Batch 계정 키입니다. 또는 환경 변수( AZURE_BATCH_ACCESS_KEY)로 설정합니다.
Batch 계정 이름입니다. 또는 환경 변수( AZURE_BATCH_ACCOUNT)로 설정합니다.
클라이언트에 알려진 리소스의 버전과 연결된 ETag 값입니다. 이 작업은 서비스에 대한 리소스의 현재 ETag가 클라이언트에서 지정한 값과 정확히 일치하는 경우에만 수행됩니다.
클라이언트에 알려진 리소스의 마지막으로 수정된 시간을 나타내는 타임스탬프입니다. 지정된 시간 이후 서비스의 리소스가 수정된 경우에만 작업이 수행됩니다.
클라이언트에 알려진 리소스의 버전과 연결된 ETag 값입니다. 이 작업은 서비스에서 리소스의 현재 ETag가 클라이언트에서 지정한 값과 일치하지 않는 경우에만 수행됩니다.
클라이언트에 알려진 리소스의 마지막으로 수정된 시간을 나타내는 타임스탬프입니다. 지정된 시간 이후 서비스의 리소스가 수정되지 않은 경우에만 작업이 수행됩니다.
종료 이유입니다.
작업의 TerminateReason으로 표시할 텍스트입니다. 기본값은 'UserTerminate'입니다.
전역 매개 변수
로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.
이 도움말 메시지를 표시하고 종료합니다.
경고를 표시하지 않고 오류만 표시합니다.
출력 형식입니다.
JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.
구독의 이름 또는 ID입니다. 를 사용하여 az account set -s NAME_OR_ID기본 구독을 구성할 수 있습니다.
로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.
피드백
출시 예정: 2024년 내내 콘텐츠에 대한 피드백 메커니즘으로 GitHub 문제를 단계적으로 폐지하고 이를 새로운 피드백 시스템으로 바꿀 예정입니다. 자세한 내용은 다음을 참조하세요. https://aka.ms/ContentUserFeedback
다음에 대한 사용자 의견 제출 및 보기