az ml run

참고 항목

이 참조는 Azure CLI(버전 2.0.28 이상)에 대한 azure-cli-ml 확장의 일부입니다. az ml run 명령을 처음 실행할 때 확장이 자동으로 설치됩니다. 확장 프로그램에 대해 자세히 알아보세요.

실행을 제출, 업데이트 및 모니터링하기 위한 명령입니다.

명령

Name Description 형식 상태
az ml run cancel

실행을 취소합니다.

내선 번호 GA
az ml run download-logs

로그 파일을 다운로드합니다.

내선 번호 GA
az ml run list

목록 실행

내선 번호 GA
az ml run monitor-logs

기존 실행에 대한 로그를 모니터링합니다.

내선 번호 GA
az ml run monitor-tensorboard

tensorboard를 사용하여 기존 실행을 모니터링합니다.

내선 번호 GA
az ml run show

실행을 표시합니다.

내선 번호 GA
az ml run submit-hyperdrive

실행 구성을 사용하여 하이퍼 매개 변수 스윕을 제출합니다.

내선 번호 GA
az ml run submit-pipeline

게시된 파이프라인 ID 또는 파이프라인 YAML 파일에서 실행을 위한 파이프라인을 제출합니다.

내선 번호 GA
az ml run submit-script

실행을 위한 스크립트를 제출합니다.

내선 번호 GA
az ml run update

태그를 추가하여 실행을 업데이트합니다.

내선 번호 GA

az ml run cancel

실행을 취소합니다.

az ml run cancel --run
                 [--experiment-name]
                 [--output-metadata-file]
                 [--path]
                 [--resource-group]
                 [--subscription-id]
                 [--workspace-name]

필수 매개 변수

--run -r

실험 실행의 runId입니다.

선택적 매개 변수

--experiment-name -e

실험 이름입니다.

--output-metadata-file -t

구조화된 개체 출력에 대한 선택적 출력 파일 위치를 제공합니다.

--path

구성 파일 실행을 위한 루트 디렉터리의 경로입니다.

기본값: .
--resource-group -g

리소스 그룹 이름

--subscription-id

구독 ID를 지정합니다.

--workspace-name -w

작업 영역 이름입니다.

전역 매개 변수
--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 ml run download-logs

로그 파일을 다운로드합니다.

az ml run download-logs --output-dir
                        --run
                        [--experiment-name]
                        [--output-metadata-file]
                        [--path]
                        [--resource-group]
                        [--subscription-id]
                        [--workspace-name]

필수 매개 변수

--output-dir -d

로그 파일을 다운로드할 출력 디렉터리입니다.

--run -r

실험 실행의 runId입니다.

선택적 매개 변수

--experiment-name -e

실험 이름입니다.

--output-metadata-file -t

구조화된 개체 출력에 대한 선택적 출력 파일 위치를 제공합니다.

--path

구성 파일 실행을 위한 루트 디렉터리의 경로입니다.

기본값: .
--resource-group -g

리소스 그룹 이름

--subscription-id

구독 ID를 지정합니다.

--workspace-name -w

작업 영역 이름입니다.

전역 매개 변수
--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 ml run list

목록 실행

az ml run list [--compute-target-name]
               [--experiment-name]
               [--last]
               [--minimal]
               [--output-metadata-file]
               [--parent-run-id]
               [--path]
               [--pipeline-run-id]
               [--resource-group]
               [--status {Completed, Failed, Finalizing, Preparing, Provisioning, Queued, Running, Starting}]
               [--subscription-id]
               [--tags]
               [--workspace-name]

선택적 매개 변수

--compute-target-name

컴퓨팅 대상 이름입니다.

--experiment-name -e

실험 이름입니다.

--last

최신 N 요소를 가져옵니다.

기본값: 10
--minimal

실행 출력에 대한 최소 속성을 제공하는 플래그입니다.

기본값: False
--output-metadata-file -t

구조화된 개체 출력에 대한 선택적 출력 파일 위치를 제공합니다.

--parent-run-id

부모 실행 ID입니다.

--path

구성 파일 실행을 위한 루트 디렉터리의 경로입니다.

기본값: .
--pipeline-run-id

파이프라인 실행 ID입니다.

--resource-group -g

리소스 그룹 이름

--status

실행의 상태입니다.

허용되는 값: Completed, Failed, Finalizing, Preparing, Provisioning, Queued, Running, Starting
--subscription-id

구독 ID를 지정합니다.

--tags

'key[=value]' 구문이 있는 실행에 대한 태그입니다.

--workspace-name -w

작업 영역 이름입니다.

전역 매개 변수
--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 ml run monitor-logs

기존 실행에 대한 로그를 모니터링합니다.

az ml run monitor-logs --run
                       [--experiment-name]
                       [--output-metadata-file]
                       [--path]
                       [--resource-group]
                       [--subscription-id]
                       [--workspace-name]

필수 매개 변수

--run -r

실험 실행의 runId입니다.

선택적 매개 변수

--experiment-name -e

실험 이름입니다.

--output-metadata-file -t

구조화된 개체 출력에 대한 선택적 출력 파일 위치를 제공합니다.

--path

구성 파일 실행을 위한 루트 디렉터리의 경로입니다.

기본값: .
--resource-group -g

리소스 그룹 이름

--subscription-id

구독 ID를 지정합니다.

--workspace-name -w

작업 영역 이름입니다.

전역 매개 변수
--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 ml run monitor-tensorboard

tensorboard를 사용하여 기존 실행을 모니터링합니다.

az ml run monitor-tensorboard --run
                              [--experiment-name]
                              [--local-directory]
                              [--output-metadata-file]
                              [--path]
                              [--resource-group]
                              [--subscription-id]
                              [--workspace-name]

필수 매개 변수

--run -r

실험 실행의 runId입니다.

선택적 매개 변수

--experiment-name -e

실험 이름입니다.

--local-directory

모니터링 중인 텐서보드 파일을 스테이징하는 로컬 디렉터리입니다.

--output-metadata-file -t

구조화된 개체 출력에 대한 선택적 출력 파일 위치를 제공합니다.

--path

구성 파일 실행을 위한 루트 디렉터리의 경로입니다.

기본값: .
--resource-group -g

리소스 그룹 이름

--subscription-id

구독 ID를 지정합니다.

--workspace-name -w

작업 영역 이름입니다.

전역 매개 변수
--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 ml run show

실행을 표시합니다.

az ml run show --run
               [--experiment-name]
               [--output-metadata-file]
               [--path]
               [--resource-group]
               [--subscription-id]
               [--workspace-name]

필수 매개 변수

--run -r

실험 실행의 runId입니다.

선택적 매개 변수

--experiment-name -e

실험 이름입니다.

--output-metadata-file -t

구조화된 개체 출력에 대한 선택적 출력 파일 위치를 제공합니다.

--path

구성 파일 실행을 위한 루트 디렉터리의 경로입니다.

기본값: .
--resource-group -g

리소스 그룹 이름

--subscription-id

구독 ID를 지정합니다.

--workspace-name -w

작업 영역 이름입니다.

전역 매개 변수
--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 ml run submit-hyperdrive

실행 구성을 사용하여 하이퍼 매개 변수 스윕을 제출합니다.

az ml run submit-hyperdrive --hyperdrive-configuration-name
                            [--async]
                            [--conda-dependencies]
                            [--ct]
                            [--experiment-name]
                            [--output-metadata-file]
                            [--path]
                            [--resource-group]
                            [--run-configuration-name]
                            [--source-directory]
                            [--subscription-id]
                            [--workspace-name]
                            [<USER_SCRIPT_AND_ARGUMENTS>]

필수 매개 변수

--hyperdrive-configuration-name

하이퍼드라이브 구성 파일의 전체 이름입니다. 파일은 경로 매개 변수로 지정된 디렉터리의 하위 폴더에 있어야 합니다.

선택적 매개 변수

--async

출력 스트리밍을 사용하지 않도록 설정합니다.

기본값: False
--conda-dependencies -d

기본 Conda 종속성 파일을 재정의합니다.

--ct --target

실행에 사용할 컴퓨팅 대상의 이름입니다.

--experiment-name -e

실험 이름입니다.

--output-metadata-file -t

구조화된 개체 출력에 대한 선택적 출력 파일 위치를 제공합니다.

--path

구성 파일 실행을 위한 루트 디렉터리의 경로입니다.

기본값: .
--resource-group -g

리소스 그룹 이름

--run-configuration-name -c

실행 구성 파일의 이름(확장명 없음)입니다. 파일은 경로 매개 변수로 지정된 디렉터리의 하위 폴더에 있어야 합니다.

--source-directory

소스 코드 파일이 포함된 로컬 디렉터리입니다. 원본 디렉터리가 제공되지 않은 경우 기본적으로 경로로 설정됩니다.

--subscription-id

구독 ID를 지정합니다.

--workspace-name -w

작업 영역 이름입니다.

<USER_SCRIPT_AND_ARGUMENTS>

실행은 스크립트 이름 및 스크립트 인수와 같은 인수를 제출합니다.

전역 매개 변수
--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 ml run submit-pipeline

게시된 파이프라인 ID 또는 파이프라인 YAML 파일에서 실행을 위한 파이프라인을 제출합니다.

az ml run submit-pipeline [--datapaths]
                          [--experiment-name]
                          [--output-metadata-file]
                          [--output_file]
                          [--parameters]
                          [--path]
                          [--pipeline-id]
                          [--pipeline-yaml]
                          [--resource-group]
                          [--subscription-id]
                          [--workspace-name]

선택적 매개 변수

--datapaths -d

데이터 경로 매개 변수 할당에 대한 name=datastore/path 쌍의 쉼표로 구분된 목록입니다.

--experiment-name -n

실행 제출의 실험 이름입니다. 지정되지 않은 경우 파이프라인 이름을 사용합니다.

--output-metadata-file -t

구조화된 개체 출력에 대한 선택적 출력 파일 위치를 제공합니다.

--output_file -f

JSON 형식으로 출력을 쓸 파일입니다.

--parameters -p

파이프라인 매개 변수 할당에 대한 name=value 쌍의 쉼표로 구분된 목록입니다.

--path

구성 파일 실행을 위한 루트 디렉터리의 경로입니다.

기본값: .
--pipeline-id -i

제출할 파이프라인의 ID(guid)입니다.

--pipeline-yaml -y

파이프라인을 정의하는 YAML 파일입니다.

--resource-group -g

리소스 그룹 이름

--subscription-id

구독 ID를 지정합니다.

--workspace-name -w

작업 영역 이름입니다.

전역 매개 변수
--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 ml run submit-script

실행을 위한 스크립트를 제출합니다.

az ml run submit-script [--async]
                        [--conda-dependencies]
                        [--ct]
                        [--experiment-name]
                        [--output-metadata-file]
                        [--path]
                        [--resource-group]
                        [--run-configuration-name]
                        [--source-directory]
                        [--subscription-id]
                        [--workspace-name]
                        [<USER_SCRIPT_AND_ARGUMENTS>]

선택적 매개 변수

--async

출력 스트리밍을 사용하지 않도록 설정합니다.

기본값: False
--conda-dependencies -d

기본 Conda 종속성 파일을 재정의합니다.

--ct --target

실행에 사용할 컴퓨팅 대상의 이름입니다.

--experiment-name -e

실험 이름입니다.

--output-metadata-file -t

구조화된 개체 출력에 대한 선택적 출력 파일 위치를 제공합니다.

--path

구성 파일 실행을 위한 루트 디렉터리의 경로입니다.

기본값: .
--resource-group -g

리소스 그룹 이름

--run-configuration-name -c

실행 구성 파일의 이름(확장명 없음)입니다. 파일은 경로 매개 변수로 지정된 디렉터리의 하위 폴더에 있어야 합니다.

--source-directory

소스 코드 파일이 포함된 로컬 디렉터리입니다. 원본 디렉터리가 제공되지 않은 경우 기본적으로 경로로 설정됩니다.

--subscription-id

구독 ID를 지정합니다.

--workspace-name -w

작업 영역 이름입니다.

<USER_SCRIPT_AND_ARGUMENTS>

실행은 스크립트 이름 및 스크립트 인수와 같은 인수를 제출합니다.

전역 매개 변수
--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 ml run update

태그를 추가하여 실행을 업데이트합니다.

az ml run update --run
                 [--add-tag]
                 [--experiment-name]
                 [--output-metadata-file]
                 [--path]
                 [--resource-group]
                 [--subscription-id]
                 [--workspace-name]

필수 매개 변수

--run -r

실험 실행의 runId입니다.

선택적 매개 변수

--add-tag

'key[=value]' 구문을 사용하여 엔터티에 태그를 지정합니다.

--experiment-name -e

실험 이름입니다.

--output-metadata-file -t

구조화된 개체 출력에 대한 선택적 출력 파일 위치를 제공합니다.

--path

구성 파일 실행을 위한 루트 디렉터리의 경로입니다.

기본값: .
--resource-group -g

리소스 그룹 이름

--subscription-id

구독 ID를 지정합니다.

--workspace-name -w

작업 영역 이름입니다.

전역 매개 변수
--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를 사용합니다.