az batch task

Batch 작업을 관리 합니다.

명령

az batch task create

일괄 처리 작업을 만듭니다.

az batch task delete

지정 된 작업에서 작업을 삭제 합니다.

az batch task file

Batch 태스크 파일을 관리합니다.

az batch task file delete

태스크가 실행된 컴퓨팅 노드에서 지정된 작업 파일을 삭제합니다.

az batch task file download

Batch 태스크 파일의 콘텐츠를 다운로드합니다.

az batch task file list

컴퓨팅 노드의 태스크 디렉터리에 있는 파일을 나열합니다.

az batch task file show

지정된 작업 파일의 속성을 가져옵니다.

az batch task list

지정 된 작업과 연결 된 모든 작업을 나열 합니다.

az batch task reactivate

작업을 다시 활성화 하 여 재시도 횟수가 모두 사용 된 경우에도 다시 실행할 수 있도록 합니다.

az batch task reset

Batch 태스크의 속성을 다시 설정 합니다.

az batch task show

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

az batch task stop

지정 된 작업을 종료 합니다.

az batch task subtask

Batch 태스크의 하위 작업 정보를 관리합니다.

az batch task subtask list

지정된 다중 인스턴스 작업과 연결된 모든 하위 작업을 나열합니다.

az batch task create

일괄 처리 작업을 만듭니다.

az batch task create --job-id
                     [--account-endpoint]
                     [--account-key]
                     [--account-name]
                     [--affinity-id]
                     [--application-package-references]
                     [--command-line]
                     [--environment-settings]
                     [--json-file]
                     [--max-task-retry-count]
                     [--max-wall-clock-time]
                     [--resource-files]
                     [--retention-time]
                     [--subscription]
                     [--task-id]

필수 매개 변수

--job-id

태스크가 포함된 작업의 ID입니다.

선택적 매개 변수

--account-endpoint

Batch 서비스 끝점입니다. 또는 환경 변수: AZURE_BATCH_ENDPOINT로 설정 합니다.

--account-key

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

--account-name

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

--affinity-id

필수 요소. 계산 노드의 위치 또는 이전에 실행 된 작업을 나타내는 불투명 문자열입니다. 노드의 affinityId를 전달 하 여이 작업을 해당 계산 노드에서 실행 해야 함을 나타낼 수 있습니다. 이는 소프트 선호도 일 뿐입니다. 작업이 예약 된 시간에 대상 계산 노드가 사용 중이거나 사용할 수 없는 경우 작업은 다른 위치에서 예약 됩니다.

--application-package-references

설치할 응용 프로그램 패키지를 지정 하는 Id의 공백으로 구분 된 목록입니다. ' Id [#version] ' 형식의 선택적 버전이 있는 공백으로 구분 된 응용 프로그램 Id입니다.

--command-line

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

--environment-settings

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

--json-file

JSON으로 만들 작업을 포함 하는 파일입니다 (REST API 요청 본문과 일치 하도록 형식이 지정). 여러 작업을 제출할 때에서는 작업 배열 또는 TaskAddCollectionParamater을 허용 합니다. 이 매개 변수를 지정 하는 경우 다른 모든 매개 변수는 무시 됩니다.

--max-task-retry-count

태스크를 다시 시도할 수 있는 최대 횟수입니다. 일괄 처리 서비스는 종료 코드가 0이 아닌 경우 작업을 다시 시도 합니다. 이 값은 0이 아닌 종료 코드로 인 한 작업 실행 파일의 다시 시도 횟수를 구체적으로 제어 합니다. Batch 서비스는 작업을 한 번 시도 하 고이 제한까지 다시 시도할 수 있습니다. 예를 들어 최대 다시 시도 횟수가 3 인 경우 Batch는 최대 4 회 (초기 시도 1 회 및 3 회 재시도) 작업을 시도 합니다. 최대 재시도 횟수가 0 이면 일괄 처리 서비스는 첫 번째 시도 후 작업을 다시 시도 하지 않습니다. 최대 재시도 횟수가-1 인 경우 Batch 서비스는 제한 없이 작업을 다시 시도 합니다.

--max-wall-clock-time

태스크가 실행 될 수 있는 최대 경과 시간으로, 작업이 시작 된 시간부터 측정 됩니다. 제한 시간 내에 작업이 완료 되지 않으면 Batch 서비스에서 작업을 종료 합니다. 지정 하지 않으면 태스크가 실행 되는 기간에 대 한 시간 제한이 없습니다.

--resource-files

명령줄을 실행 하기 전에 Batch 서비스가 계산 노드에 다운로드 하는 파일의 목록입니다. Filename = httpurl 형식의 공백으로 구분 된 리소스 참조, httpurl은 공용 액세스를 사용 하는 HTTP url 또는 읽기 액세스 권한이 있는 SAS url입니다.

--retention-time

실행이 완료 된 시간부터 실행 된 계산 노드의 태스크 디렉터리를 유지 하는 최소 시간입니다. 이 시간이 지나면 Batch 서비스에서 작업 디렉터리와 해당 내용을 모두 삭제할 수 있습니다. 기본값은 7 일입니다. 즉, 계산 노드를 제거 하거나 작업을 삭제 하지 않는 한 태스크 디렉터리는 7 일 동안 보존 됩니다.

--subscription

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

--task-id

태스크의 ID입니다.

az batch task delete

지정 된 작업에서 작업을 삭제 합니다.

작업이 삭제 되 면 해당 작업이 실행 된 계산 노드의 디렉터리에 있는 모든 파일도 삭제 됩니다 (보존 시간에 관계 없음). 다중 인스턴스 태스크의 경우 작업 삭제 작업은 주 작업에 동기적으로 적용 됩니다. 하위 작업 및 해당 파일은 백그라운드에서 비동기적으로 삭제 됩니다.

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

필수 매개 변수

--job-id

태스크를 삭제할 작업의 ID입니다.

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

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

--subscription

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

--yes -y

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

az batch task list

지정 된 작업과 연결 된 모든 작업을 나열 합니다.

다중 인스턴스 작업의 경우 affinityId, executionInfo 및 nodeInfo와 같은 정보는 기본 작업을 참조 합니다. 하위 작업 목록 API를 사용 하 여 하위 작업에 대 한 정보를 검색 합니다.

az batch task list --job-id
                   [--account-endpoint]
                   [--account-key]
                   [--account-name]
                   [--expand]
                   [--filter]
                   [--query-examples]
                   [--select]
                   [--subscription]

필수 매개 변수

--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 절입니다.

--filter

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

--query-examples

JMESPath 문자열을 권장 합니다. 쿼리 중 하나를 복사 하 여 결과를 볼 수 있도록 큰따옴표 내에서--query 매개 변수 뒤에 붙여 넣을 수 있습니다. 이러한 주요 단어를 기준으로 제안을 제공할 수 있도록 하나 이상의 위치 키워드를 추가할 수 있습니다.

--select

OData $select 절입니다.

--subscription

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

az batch task reactivate

작업을 다시 활성화 하 여 재시도 횟수가 모두 사용 된 경우에도 다시 실행할 수 있도록 합니다.

다시 활성화 하면 작업을 다시 시도할 수 있는 최대 재시도 횟수까지 다시 시도할 수 있습니다. 작업의 상태가 활성으로 변경 됩니다. 태스크가 더 이상 완료 된 상태가 아니므로 다시 활성화 한 후에는 이전 종료 코드 또는 오류 정보를 더 이상 사용할 수 없습니다. 태스크가 다시 활성화 될 때마다 재시도 횟수가 0으로 다시 설정 됩니다. 완료 되지 않았거나 이전에 성공적으로 완료 된 작업 (종료 코드 0)에 대해 다시 활성화가 실패 합니다. 또한 작업이 완료 되었거나 종료 또는 삭제 되는 경우 실패 합니다.

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

필수 매개 변수

--job-id

태스크가 포함 된 작업의 ID입니다.

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

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

--subscription

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

az batch task reset

Batch 태스크의 속성을 다시 설정 합니다.

az batch task reset --job-id
                    --task-id
                    [--account-endpoint]
                    [--account-key]
                    [--account-name]
                    [--if-match]
                    [--if-modified-since]
                    [--if-none-match]
                    [--if-unmodified-since]
                    [--json-file]
                    [--max-task-retry-count]
                    [--max-wall-clock-time]
                    [--retention-time]
                    [--subscription]

필수 매개 변수

--job-id

태스크가 포함 된 작업의 ID입니다.

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

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

--json-file

JSON의 제약 조건 사양을 포함 하는 파일입니다 (해당 REST API 본문과 일치 하도록 서식 지정). 이 매개 변수를 지정 하는 경우 모든 ' 제약 조건 인수 '는 무시 됩니다.

--max-task-retry-count

태스크를 다시 시도할 수 있는 최대 횟수입니다. 일괄 처리 서비스는 종료 코드가 0이 아닌 경우 작업을 다시 시도 합니다. 이 값은 0이 아닌 종료 코드로 인 한 작업 실행 파일의 다시 시도 횟수를 구체적으로 제어 합니다. Batch 서비스는 작업을 한 번 시도 하 고이 제한까지 다시 시도할 수 있습니다. 예를 들어 최대 다시 시도 횟수가 3 인 경우 Batch는 최대 4 회 (초기 시도 1 회 및 3 회 재시도) 작업을 시도 합니다. 최대 재시도 횟수가 0 이면 일괄 처리 서비스는 첫 번째 시도 후 작업을 다시 시도 하지 않습니다. 최대 재시도 횟수가-1 인 경우 Batch 서비스는 제한 없이 작업을 다시 시도 합니다.

--max-wall-clock-time

태스크가 실행 될 수 있는 최대 경과 시간으로, 작업이 시작 된 시간부터 측정 됩니다. 제한 시간 내에 작업이 완료 되지 않으면 Batch 서비스에서 작업을 종료 합니다. 지정 하지 않으면 태스크가 실행 되는 기간에 대 한 시간 제한이 없습니다. 필요한 형식은 ISO-8601 기간입니다.

--retention-time

실행이 완료 된 시간부터 실행 된 계산 노드의 태스크 디렉터리를 유지 하는 최소 시간입니다. 이 시간이 지나면 Batch 서비스에서 작업 디렉터리와 해당 내용을 모두 삭제할 수 있습니다. 기본값은 7 일입니다. 즉, 계산 노드를 제거 하거나 작업을 삭제 하지 않는 한 태스크 디렉터리는 7 일 동안 보존 됩니다. 필요한 형식은 ISO-8601 기간입니다.

--subscription

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

az batch task show

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

다중 인스턴스 작업의 경우 affinityId, executionInfo 및 nodeInfo와 같은 정보는 기본 작업을 참조 합니다. 하위 작업 목록 API를 사용 하 여 하위 작업에 대 한 정보를 검색 합니다.

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

필수 매개 변수

--job-id

태스크가 포함 된 작업의 ID입니다.

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

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

--query-examples

JMESPath 문자열을 권장 합니다. 쿼리 중 하나를 복사 하 여 결과를 볼 수 있도록 큰따옴표 내에서--query 매개 변수 뒤에 붙여 넣을 수 있습니다. 이러한 주요 단어를 기준으로 제안을 제공할 수 있도록 하나 이상의 위치 키워드를 추가할 수 있습니다.

--select

OData $select 절입니다.

--subscription

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

az batch task stop

지정 된 작업을 종료 합니다.

작업이 종료 되 면 완료 상태로 이동 합니다. 다중 인스턴스 태스크의 경우 작업 종료 작업이 주 작업에 동기적으로 적용 됩니다. 그러면 하위 작업은 백그라운드에서 비동기적으로 종료 됩니다.

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

필수 매개 변수

--job-id

태스크가 포함 된 작업의 ID입니다.

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

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

--subscription

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