다음을 통해 공유


az ml component

참고 항목

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

Azure ML 구성 요소를 관리합니다.

Azure ML 구성 요소는 파이프라인 작업에 대한 구성 요소의 구성을 정의합니다. 구성 요소의 입력/출력 포트, 실행 환경 및 명령을 구성할 수 있습니다. 구성 요소를 만든 후에는 파이프라인 작업의 구성 요소를 참조하여 docker 컨테이너에서 실행할 수 있습니다.

명령

Name Description 형식 상태
az ml component archive

구성 요소를 보관합니다.

내선 번호 GA
az ml component create

구성 요소 만들기

내선 번호 GA
az ml component list

작업 영역의 구성 요소를 나열합니다.

내선 번호 GA
az ml component restore

보관된 구성 요소를 복원합니다.

내선 번호 GA
az ml component show

구성 요소에 대한 세부 정보를 표시합니다.

내선 번호 GA
az ml component update

구성 요소 업데이트 현재 일부 필드(설명, display_name)만 업데이트를 지원합니다.

내선 번호 GA

az ml component archive

구성 요소를 보관합니다.

구성 요소를 보관하면 기본적으로 목록 쿼리(az ml component list)에서 해당 구성 요소가 숨겨집니다. 파이프라인에서 보관된 구성 요소를 계속 참조하고 사용할 수 있습니다. 구성 요소 컨테이너 또는 특정 구성 요소 버전을 보관할 수 있습니다. 구성 요소 컨테이너를 보관하면 지정된 이름 아래에 있는 구성 요소의 모든 버전이 보관됩니다. 를 사용하여 az ml component restore보관된 구성 요소를 복원할 수 있습니다. 전체 구성 요소 컨테이너가 보관된 경우 구성 요소의 개별 버전을 복원할 수 없습니다. 구성 요소 컨테이너를 복원해야 합니다.

az ml component archive --name
                        [--label]
                        [--registry-name]
                        [--resource-group]
                        [--version]
                        [--workspace-name]

예제

구성 요소 컨테이너 보관(해당 구성 요소의 모든 버전 보관)

az ml component archive --name my-component --resource-group my-resource-group --workspace-name my-workspace

특정 구성 요소 버전 보관

az ml component archive --name my-component --version 1 --resource-group my-resource-group --workspace-name my-workspace

필수 매개 변수

--name -n

구성 요소의 이름입니다.

선택적 매개 변수

--label -l

구성 요소의 레이블입니다.

--registry-name

제공된 경우 명령은 작업 영역 대신 레지스트리를 대상으로 합니다. 따라서 리소스 그룹 및 작업 영역은 필요하지 않습니다.

--resource-group -g

리소스 그룹의 이름입니다. az configure --defaults group=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.

--version -v

구성 요소 버전입니다.

--workspace-name -w

Azure ML 작업 영역의 이름입니다. 를 사용하여 az configure --defaults workspace=<name>기본 작업 영역을 구성할 수 있습니다.

전역 매개 변수
--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 component create

구성 요소 만들기

az ml component create --file
                       [--name]
                       [--registry-name]
                       [--resource-group]
                       [--set]
                       [--skip-validation]
                       [--version]
                       [--workspace-name]

예제

YAML 사양 파일에서 구성 요소 만들기

az ml component create --file my_component.yml --resource-group my-resource-group --workspace-name my-workspace

지정된 버전을 사용하여 YAML 사양 파일에서 구성 요소 만들기

az ml component create --file my_component.yml --version 1 --resource-group my-resource-group --workspace-name my-workspace

YAML 사양 파일에서 레지스트리의 구성 요소 만들기

az ml component create --file my_component.yml --registry-name my-registry-name --resource-group my-resource-group

지정된 버전이 있는 YAML 사양 파일에서 레지스트리의 구성 요소 만들기

az ml component create --file my_component.yml --version 1 --registry-name my-registry-name --resource-group my-resource-group

필수 매개 변수

--file -f

Azure ML 구성 요소 사양을 포함하는 YAML 파일의 로컬 경로입니다. 구성 요소에 대한 YAML 참조 문서는 다음 https://aka.ms/ml-cli-v2-component-command-yaml-reference위치에서 찾을 수 있습니다.

선택적 매개 변수

--name -n

구성 요소의 이름입니다.

--registry-name

제공된 경우 명령은 작업 영역 대신 레지스트리를 대상으로 합니다. 따라서 리소스 그룹 및 작업 영역은 필요하지 않습니다.

--resource-group -g

리소스 그룹의 이름입니다. az configure --defaults group=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.

--set

설정할 속성 경로와 값을 지정하여 개체를 업데이트합니다. 예: --set property1.property2=.

--skip-validation

리소스를 만들 때 유효성 검사를 건너뜁니다. 종속 리소스는 만들기에서 유효성 검사를 건너뛰지 않습니다.

기본값: False
--version -v

구성 요소 버전입니다.

--workspace-name -w

Azure ML 작업 영역의 이름입니다. 를 사용하여 az configure --defaults workspace=<name>기본 작업 영역을 구성할 수 있습니다.

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

작업 영역의 구성 요소를 나열합니다.

az ml component list [--archived-only]
                     [--include-archived]
                     [--max-results]
                     [--name]
                     [--registry-name]
                     [--resource-group]
                     [--workspace-name]

예제

작업 영역의 모든 구성 요소 나열

az ml component list --resource-group my-resource-group --workspace-name my-workspace

작업 영역에서 지정된 이름의 모든 구성 요소 버전을 나열합니다.

az ml component list --name my-component --resource-group my-resource-group --workspace-name my-workspace

--query 인수를 사용하여 명령 결과에 대한 JMESPath 쿼리를 실행하여 작업 영역의 모든 구성 요소를 나열합니다.

az ml component list --query "[].{Name:name}"  --output table --resource-group my-resource-group --workspace-name my-workspace

레지스트리의 모든 구성 요소 나열

az ml component list --registry-name my-registry-name --resource-group my-resource-group

레지스트리에서 지정된 이름의 모든 구성 요소 버전을 나열합니다.

az ml component list --name my-component --registry-name my-registry-name --resource-group my-resource-group

--query 인수를 사용하여 명령 결과에 대한 JMESPath 쿼리를 실행하는 레지스트리의 모든 구성 요소를 나열합니다.

az ml component list --query "[].{Name:name}"  --output table --registry-name my-registry-name --resource-group my-resource-group

선택적 매개 변수

--archived-only

보관된 구성 요소만 나열합니다.

기본값: False
--include-archived

보관된 구성 요소 및 활성 구성 요소를 나열합니다.

기본값: False
--max-results -r

반환할 최대 결과 수입니다.

--name -n

구성 요소의 이름입니다.

--registry-name

제공된 경우 명령은 작업 영역 대신 레지스트리를 대상으로 합니다. 따라서 리소스 그룹 및 작업 영역은 필요하지 않습니다.

--resource-group -g

리소스 그룹의 이름입니다. az configure --defaults group=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.

--workspace-name -w

Azure ML 작업 영역의 이름입니다. 를 사용하여 az configure --defaults workspace=<name>기본 작업 영역을 구성할 수 있습니다.

전역 매개 변수
--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 component restore

보관된 구성 요소를 복원합니다.

보관된 구성 요소가 복원되면 목록 쿼리(az ml component list)에서 더 이상 숨겨지지 않습니다. 전체 구성 요소 컨테이너가 보관된 경우 보관된 컨테이너를 복원할 수 있습니다. 그러면 지정된 이름 아래에 있는 구성 요소의 모든 버전이 복원됩니다. 전체 구성 요소 컨테이너가 보관된 경우 특정 구성 요소 버전만 복원할 수 없습니다. 전체 컨테이너를 복원해야 합니다. 개별 구성 요소 버전만 보관된 경우 해당 특정 버전을 복원할 수 있습니다.

az ml component restore --name
                        [--label]
                        [--registry-name]
                        [--resource-group]
                        [--version]
                        [--workspace-name]

예제

보관된 구성 요소 컨테이너 복원(해당 구성 요소의 모든 버전 복원)

az ml component restore --name my-component --resource-group my-resource-group --workspace-name my-workspace

보관된 특정 구성 요소 버전 복원

az ml component restore --name my-component --version 1 --resource-group my-resource-group --workspace-name my-workspace

필수 매개 변수

--name -n

구성 요소의 이름입니다.

선택적 매개 변수

--label -l

구성 요소의 레이블입니다.

--registry-name

제공된 경우 명령은 작업 영역 대신 레지스트리를 대상으로 합니다. 따라서 리소스 그룹 및 작업 영역은 필요하지 않습니다.

--resource-group -g

리소스 그룹의 이름입니다. az configure --defaults group=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.

--version -v

구성 요소 버전입니다.

--workspace-name -w

Azure ML 작업 영역의 이름입니다. 를 사용하여 az configure --defaults workspace=<name>기본 작업 영역을 구성할 수 있습니다.

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

구성 요소에 대한 세부 정보를 표시합니다.

az ml component show --name
                     [--label]
                     [--registry-name]
                     [--resource-group]
                     [--version]
                     [--workspace-name]

예제

지정된 이름 및 버전이 있는 구성 요소에 대한 세부 정보 표시

az ml component show --name my-component --version 1 --resource-group my-resource-group --workspace-name my-workspace

지정된 이름 및 버전을 사용하여 레지스트리의 구성 요소에 대한 세부 정보 표시

az ml component show --name my-component --version 1 --registry-name my-registry-name --resource-group my-resource-group

필수 매개 변수

--name -n

구성 요소의 이름입니다.

선택적 매개 변수

--label -l

구성 요소의 레이블입니다.

--registry-name

제공된 경우 명령은 작업 영역 대신 레지스트리를 대상으로 합니다. 따라서 리소스 그룹 및 작업 영역은 필요하지 않습니다.

--resource-group -g

리소스 그룹의 이름입니다. az configure --defaults group=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.

--version -v

구성 요소 버전입니다.

--workspace-name -w

Azure ML 작업 영역의 이름입니다. 를 사용하여 az configure --defaults workspace=<name>기본 작업 영역을 구성할 수 있습니다.

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

구성 요소 업데이트 현재 일부 필드(설명, display_name)만 업데이트를 지원합니다.

az ml component update --name
                       --resource-group
                       --workspace-name
                       [--add]
                       [--force-string]
                       [--label]
                       [--registry-name]
                       [--remove]
                       [--set]
                       [--version]

예제

구성 요소의 설명 업데이트

az ml component update -n my_component -v 1 --set description="new description" -g my-resource-group -w my-workspace

필수 매개 변수

--name -n

구성 요소의 이름입니다.

--resource-group -g

리소스 그룹의 이름입니다. az configure --defaults group=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.

--workspace-name -w

Azure ML 작업 영역의 이름입니다. 를 사용하여 az configure --defaults workspace=<name>기본 작업 영역을 구성할 수 있습니다.

선택적 매개 변수

--add

경로 및 키 값 쌍을 지정하여 개체 목록에 개체를 추가합니다. 예: --add property.listProperty <key=value, string or JSON string>

기본값: []
--force-string

'set' 또는 'add'를 사용하는 경우 JSON으로 변환하는 대신 문자열 리터럴을 유지합니다.

기본값: False
--label -l

구성 요소의 레이블입니다.

--registry-name

제공된 경우 명령은 작업 영역 대신 레지스트리를 대상으로 합니다. 따라서 리소스 그룹 및 작업 영역은 필요하지 않습니다.

--remove

목록에서 속성 또는 요소를 제거합니다. 예: --remove property.list <indexToRemove> OR --remove propertyToRemove.

기본값: []
--set

설정할 속성 경로와 값을 지정하여 개체를 업데이트합니다. 예: --set property1.property2=<value>

기본값: []
--version -v

구성 요소 버전입니다.

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