다음을 통해 공유


az hdinsight-on-aks clusterpool

참고 항목

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

이 명령 그룹은 미리 보기 상태이며 개발 중입니다. 참조 및 지원 수준: https://aka.ms/CLI_refstatus

Clusterpool 작업.

명령

Name Description 형식 상태
az hdinsight-on-aks clusterpool create

클러스터 풀을 만듭니다.

내선 번호 프리뷰
az hdinsight-on-aks clusterpool delete

클러스터 풀을 삭제합니다.

내선 번호 프리뷰
az hdinsight-on-aks clusterpool list

구독 내의 클러스터 풀 목록을 나열합니다.

내선 번호 프리뷰
az hdinsight-on-aks clusterpool show

클러스터 풀을 가져옵니다.

내선 번호 프리뷰
az hdinsight-on-aks clusterpool update

클러스터 풀을 업데이트합니다.

내선 번호 프리뷰
az hdinsight-on-aks clusterpool upgrade

clusterpool을 업그레이드합니다.

내선 번호 프리뷰
az hdinsight-on-aks clusterpool upgrade history

업그레이드 기록 목록을 나열합니다.

내선 번호 프리뷰
az hdinsight-on-aks clusterpool upgrade list

사용 가능한 클러스터 풀 업그레이드를 나열합니다.

내선 번호 프리뷰
az hdinsight-on-aks clusterpool upgrade run

클러스터 풀을 업그레이드합니다.

내선 번호 프리뷰
az hdinsight-on-aks clusterpool wait

조건이 충족될 때까지 CLI를 대기 상태로 유지합니다.

내선 번호 프리뷰

az hdinsight-on-aks clusterpool create

미리 보기

명령 그룹 'az hdinsight-on-aks clusterpool'은 미리 보기로 제공되며 개발 중입니다. 참조 및 지원 수준: https://aka.ms/CLI_refstatus

클러스터 풀을 만듭니다.

az hdinsight-on-aks clusterpool create --cluster-pool-name
                                       --resource-group
                                       [--api-server-authorized-ip-ranges]
                                       [--availability-zones]
                                       [--cluster-pool-version]
                                       [--enable-log-analytics {0, 1, f, false, n, no, t, true, y, yes}]
                                       [--la-workspace-id]
                                       [--location]
                                       [--managed-rg-name]
                                       [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                                       [--outbound-type {loadBalancer, userDefinedRouting}]
                                       [--private-server-enabled {0, 1, f, false, n, no, t, true, y, yes}]
                                       [--subnet-id]
                                       [--tags]
                                       [--workernode-size]

예제

클러스터 풀을 만듭니다.

az hdinsight-on-aks clusterpool create -g {RG} -n {poolName} -l {westus3} --workernode-size {Standard_E4s_v3} --version {1.1}

필수 매개 변수

--cluster-pool-name --name -n

클러스터 풀의 이름입니다.

--resource-group -g

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

선택적 매개 변수

--api-server-authorized-ip-ranges --api-server-ip-ranges

IP 범위는 CIDR 형식(예: 137.117.106.88/29)으로 지정됩니다. 이 기능은 프라이빗 AKS 클러스터와 호환되지 않습니다. 따라서 enablePrivateApiServer를 true로 설정하고 apiServerAuthorizedIpRanges를 동시에 설정할 수 없습니다. 약식 구문, json-file 및 yaml-file을 지원합니다. 더 많은 것을 표시하려면 "??"를 시도해 보세요.

--availability-zones

AKS VMSS 노드에 사용할 가용성 영역 목록입니다. 약식 구문, json-file 및 yaml-file을 지원합니다. 더 많은 것을 표시하려면 "??"를 시도해 보세요.

--cluster-pool-version --version

클러스터 풀 버전은 2부로 구성된 버전입니다.

--enable-log-analytics

클러스터 풀에 대해 로그 분석을 사용하도록 설정하면 True이고, 그렇지 않으면 false입니다.

허용되는 값: 0, 1, f, false, n, no, t, true, y, yes
--la-workspace-id --log-analytic-workspace-id

OMS 에이전트와 연결할 Log Analytics 작업 영역입니다.

--location -l

리소스가 있는 지리적 위치(지정되지 않은 경우) 리소스 그룹의 위치가 사용됩니다.

--managed-rg-name

고객을 대신하여 RP에서 만든 리소스를 보관하기 위해 RP에서 만든 리소스 그룹입니다. 또한 패턴별로 aksManagedResourceGroupName을 생성하는 데 사용됩니다. MC_{managedResourceGroupName}{clusterPoolName}{region}. 리소스 그룹 이름 제한을 충족하는지 확인하세요.

--no-wait

장기 실행 작업이 완료되기를 기다리지 마세요.

허용되는 값: 0, 1, f, false, n, no, t, true, y, yes
--outbound-type

클러스터 풀을 만들 때만 설정할 수 있으며 나중에 변경할 수 없습니다.

허용되는 값: loadBalancer, userDefinedRouting
Default value: loadBalancer
--private-server-enabled

ClusterPool은 AKS 클러스터를 기반으로 합니다. AKS 클러스터는 기본적으로 공용 인터넷에 API 서버를 노출합니다. 이 속성을 true로 설정하면 프라이빗 AKS 클러스터가 만들어지고 공용 인터넷에 노출되지 않는 프라이빗 apiserver를 사용합니다.

허용되는 값: 0, 1, f, false, n, no, t, true, y, yes
--subnet-id

클러스터 풀 서브넷 리소스 ID입니다.

--tags

리소스 태그. 약식 구문, json-file 및 yaml-file을 지원합니다. 더 많은 것을 표시하려면 "??"를 시도해 보세요.

--workernode-size

가상 머신 SKU입니다.

전역 매개 변수
--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 hdinsight-on-aks clusterpool delete

미리 보기

명령 그룹 'az hdinsight-on-aks clusterpool'은 미리 보기로 제공되며 개발 중입니다. 참조 및 지원 수준: https://aka.ms/CLI_refstatus

클러스터 풀을 삭제합니다.

az hdinsight-on-aks clusterpool delete [--cluster-pool-name]
                                       [--ids]
                                       [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                                       [--resource-group]
                                       [--subscription]
                                       [--yes]

예제

클러스터 풀을 삭제합니다.

az hdinsight-on-aks clusterpool delete -g {RG} -n {poolName}

선택적 매개 변수

--cluster-pool-name --name -n

클러스터 풀의 이름입니다.

--ids

하나 이상의 리소스 ID(공백으로 구분)입니다. '리소스 ID' 인수의 모든 정보를 포함하는 완전한 리소스 ID여야 합니다. --ids 또는 기타 '리소스 ID' 인수를 제공해야 합니다.

--no-wait

장기 실행 작업이 완료되기를 기다리지 마세요.

허용되는 값: 0, 1, f, false, n, no, t, true, y, yes
--resource-group -g

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

--subscription

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

--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 hdinsight-on-aks clusterpool list

미리 보기

명령 그룹 'az hdinsight-on-aks clusterpool'은 미리 보기로 제공되며 개발 중입니다. 참조 및 지원 수준: https://aka.ms/CLI_refstatus

구독 내의 클러스터 풀 목록을 나열합니다.

az hdinsight-on-aks clusterpool list [--max-items]
                                     [--next-token]
                                     [--resource-group]

예제

리소스 그룹의 clusterpool 목록을 나열합니다.

az hdinsight-on-aks clusterpool list -g {RG}

구독 내의 클러스터 풀 목록을 나열합니다.

az hdinsightonaks clusterpool list

선택적 매개 변수

--max-items

명령의 출력에서 반환할 총 항목 수입니다. 사용 가능한 총 항목 수가 지정된 값보다 많으면 명령의 출력에 토큰이 제공됩니다. 페이지 매김을 다시 시작하려면 후속 명령의 인수에 --next-token 토큰 값을 제공합니다.

--next-token

페이지 매김을 시작할 위치를 지정하는 토큰입니다. 이는 이전에 잘린 응답의 토큰 값입니다.

--resource-group -g

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

전역 매개 변수
--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 hdinsight-on-aks clusterpool show

미리 보기

명령 그룹 'az hdinsight-on-aks clusterpool'은 미리 보기로 제공되며 개발 중입니다. 참조 및 지원 수준: https://aka.ms/CLI_refstatus

클러스터 풀을 가져옵니다.

az hdinsight-on-aks clusterpool show [--cluster-pool-name]
                                     [--ids]
                                     [--resource-group]
                                     [--subscription]

예제

clusterpool을 가져옵니다.

az hdinsight-on-aks clusterpool show -g {RG} -n {poolName}

선택적 매개 변수

--cluster-pool-name --name -n

클러스터 풀의 이름입니다.

--ids

하나 이상의 리소스 ID(공백으로 구분)입니다. '리소스 ID' 인수의 모든 정보를 포함하는 완전한 리소스 ID여야 합니다. --ids 또는 기타 '리소스 ID' 인수를 제공해야 합니다.

--resource-group -g

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

--subscription

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

전역 매개 변수
--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 hdinsight-on-aks clusterpool update

미리 보기

명령 그룹 'az hdinsight-on-aks clusterpool'은 미리 보기로 제공되며 개발 중입니다. 참조 및 지원 수준: https://aka.ms/CLI_refstatus

클러스터 풀을 업데이트합니다.

az hdinsight-on-aks clusterpool update [--add]
                                       [--api-server-authorized-ip-ranges]
                                       [--cluster-pool-name]
                                       [--cluster-pool-version]
                                       [--compute-profile]
                                       [--enable-log-analytics {0, 1, f, false, n, no, t, true, y, yes}]
                                       [--force-string {0, 1, f, false, n, no, t, true, y, yes}]
                                       [--ids]
                                       [--la-workspace-id]
                                       [--managed-rg-name]
                                       [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                                       [--outbound-type {loadBalancer, userDefinedRouting}]
                                       [--remove]
                                       [--resource-group]
                                       [--set]
                                       [--subnet-id]
                                       [--subscription]
                                       [--tags]

예제

기존 클러스터를 업데이트하여 로그 분석을 사용하도록 설정합니다.

az hdinsight-on-aksclusterpool update -g {RG} -n {poolName} --enable-log-analytics --log-analytic-workspace-id {"/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/RG/providers/microsoft.operationalinsights/workspaces/yourworkspace"}

선택적 매개 변수

--add

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

--api-server-authorized-ip-ranges --api-server-ip-ranges

IP 범위는 CIDR 형식(예: 137.117.106.88/29)으로 지정됩니다. 이 기능은 프라이빗 AKS 클러스터와 호환되지 않습니다. 따라서 enablePrivateApiServer를 true로 설정하고 apiServerAuthorizedIpRanges를 동시에 설정할 수 없습니다. 약식 구문, json-file 및 yaml-file을 지원합니다. 더 많은 것을 표시하려면 "??"를 시도해 보세요.

--cluster-pool-name --name -n

클러스터 풀의 이름입니다.

--cluster-pool-version --version

클러스터 풀 버전은 2부로 구성된 버전입니다.

--compute-profile

CLuster 풀 컴퓨팅 프로필입니다. 약식 구문, json-file 및 yaml-file을 지원합니다. 더 많은 것을 표시하려면 "??"를 시도해 보세요.

--enable-log-analytics

클러스터 풀에 대해 로그 분석을 사용하도록 설정하면 True이고, 그렇지 않으면 false입니다.

허용되는 값: 0, 1, f, false, n, no, t, true, y, yes
--force-string

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

허용되는 값: 0, 1, f, false, n, no, t, true, y, yes
--ids

하나 이상의 리소스 ID(공백으로 구분)입니다. '리소스 ID' 인수의 모든 정보를 포함하는 완전한 리소스 ID여야 합니다. --ids 또는 기타 '리소스 ID' 인수를 제공해야 합니다.

--la-workspace-id --log-analytic-workspace-id

OMS 에이전트와 연결할 Log Analytics 작업 영역입니다.

--managed-rg-name

고객을 대신하여 RP에서 만든 리소스를 보관하기 위해 RP에서 만든 리소스 그룹입니다. 또한 패턴별로 aksManagedResourceGroupName을 생성하는 데 사용됩니다. MC_{managedResourceGroupName}{clusterPoolName}{region}. 리소스 그룹 이름 제한을 충족하는지 확인하세요.

--no-wait

장기 실행 작업이 완료되기를 기다리지 마세요.

허용되는 값: 0, 1, f, false, n, no, t, true, y, yes
--outbound-type

클러스터 풀을 만들 때만 설정할 수 있으며 나중에 변경할 수 없습니다.

허용되는 값: loadBalancer, userDefinedRouting
--remove

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

--resource-group -g

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

--set

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

--subnet-id

클러스터 풀 서브넷 리소스 ID입니다.

--subscription

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

--tags

리소스 태그. 약식 구문, json-file 및 yaml-file을 지원합니다. 더 많은 것을 표시하려면 "??"를 시도해 보세요.

전역 매개 변수
--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 hdinsight-on-aks clusterpool wait

미리 보기

명령 그룹 'az hdinsight-on-aks clusterpool'은 미리 보기로 제공되며 개발 중입니다. 참조 및 지원 수준: https://aka.ms/CLI_refstatus

조건이 충족될 때까지 CLI를 대기 상태로 유지합니다.

az hdinsight-on-aks clusterpool wait [--cluster-pool-name]
                                     [--created]
                                     [--custom]
                                     [--deleted]
                                     [--exists]
                                     [--ids]
                                     [--interval]
                                     [--resource-group]
                                     [--subscription]
                                     [--timeout]
                                     [--updated]

선택적 매개 변수

--cluster-pool-name --name -n

클러스터 풀의 이름입니다.

--created

'Succeeded'에서 'provisioningState'를 사용하여 생성될 때까지 기다립니다.

Default value: False
--custom

조건이 사용자 지정 JMESPath 쿼리를 충족할 때까지 기다립니다. 예: provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].

--deleted

삭제될 때까지 기다립니다.

Default value: False
--exists

리소스가 존재할 때까지 기다립니다.

Default value: False
--ids

하나 이상의 리소스 ID(공백으로 구분)입니다. '리소스 ID' 인수의 모든 정보를 포함하는 완전한 리소스 ID여야 합니다. --ids 또는 기타 '리소스 ID' 인수를 제공해야 합니다.

--interval

폴링 간격(초)입니다.

Default value: 30
--resource-group -g

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

--subscription

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

--timeout

최대 대기 시간(초)입니다.

Default value: 3600
--updated

'Succeeded'에서 provisioningState로 업데이트될 때까지 기다립니다.

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를 사용합니다.