Share via

az stream-analytics cluster

  • 참조

참고 항목

이 참조는 Azure CLI(버전 2.15.0 이상)에 대한 스트림 분석 확장의 일부입니다. 이 확장은 az stream-analytics 클러스터 명령을 처음 실행할 때 자동으로 설치됩니다. 확장 프로그램에 대해 자세히 알아보세요.

스트림 분석을 사용하여 클러스터를 관리합니다.

명령

Name Description 형식 상태
az stream-analytics cluster create

Stream Analytics 클러스터를 만들거나 기존 클러스터를 대체합니다.

 내선 번호 GA
az stream-analytics cluster delete

지정된 클러스터를 삭제합니다.

 내선 번호 GA
az stream-analytics cluster list

지정된 리소스 그룹의 모든 클러스터를 나열합니다. 지정된 구독의 모든 클러스터를 나열합니다.

 내선 번호 GA
az stream-analytics cluster list-streaming-job

지정된 클러스터의 모든 스트리밍 작업을 나열합니다.

 내선 번호 GA
az stream-analytics cluster show

지정된 클러스터에 대한 정보를 가져옵니다.

 내선 번호 GA
az stream-analytics cluster update

기존 클러스터를 업데이트합니다. 클러스터 정의의 나머지 부분에 영향을 주지 않고 클러스터를 부분적으로 업데이트(예: 하나 또는 두 개의 속성 업데이트)하는 데 사용할 수 있습니다.

 내선 번호 GA
az stream-analytics cluster wait

stream-analytics 클러스터의 조건이 충족될 때까지 CLI를 대기 상태로 설정합니다.

 내선 번호 GA

az stream-analytics cluster create

Stream Analytics 클러스터를 만들거나 기존 클러스터를 대체합니다.

az stream-analytics cluster create --cluster-name
                                   --resource-group
                                   [--if-match]
                                   [--if-none-match]
                                   [--location]
                                   [--no-wait]
                                   [--sku]
                                   [--tags]

예제

새 클러스터 만들기

az stream-analytics cluster create --location "North US" --sku name="Default" capacity=36 --tags key="value" --name "An Example Cluster" --resource-group "sjrg"

필수 매개 변수

--cluster-name --name -n

클러스터의 이름입니다.

--resource-group -g

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

선택적 매개 변수

--if-match

리소스의 ETag입니다. 현재 레코드 집합을 항상 덮어쓰려면 이 값을 생략합니다. 실수로 동시 변경 내용을 덮어쓰지 않도록 마지막으로 본 ETag 값을 지정합니다.

--if-none-match

새 리소스를 만들 수 있지만 기존 레코드 집합을 업데이트하지 않도록 하려면 '*'로 설정합니다. 다른 값으로 인해 412 사전 조건 실패 응답이 발생합니다.

--location -l

위치. 값: az account list-locations. az configure --defaults location=<location>을 사용하여 기본 위치를 구성할 수 있습니다.

--no-wait

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

기본값: False
--sku

클러스터의 SKU입니다. 이렇게 하면 클러스터의 크기/용량이 결정됩니다. PUT(CreateOrUpdate) 요청에 필요합니다.

사용량: --sku name=XX capacity=XX

name: 클러스터의 SKU 이름을 지정합니다. PUT(CreateOrUpdate) 요청에 필요합니다. 용량: 클러스터에서 지원할 수 있는 스트리밍 단위 수를 표시합니다. 이 속성의 유효한 값은 최소값이 36이고 최대값이 216인 36의 배수입니다. PUT(CreateOrUpdate) 요청에 필요합니다.

--tags

공백으로 구분된 태그: key[=value] [key[=value] ...]. ""를 사용하여 기존 태그를 지웁니다.

전역 매개 변수
--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 stream-analytics cluster delete

지정된 클러스터를 삭제합니다.

az stream-analytics cluster delete [--cluster-name]
                                   [--ids]
                                   [--no-wait]
                                   [--resource-group]
                                   [--subscription]
                                   [--yes]

예제

클러스터 삭제

az stream-analytics cluster delete --name "testcluster" --resource-group "sjrg"

선택적 매개 변수

--cluster-name --name -n

클러스터의 이름입니다.

--ids

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

--no-wait

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

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

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

--subscription

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

--yes -y

확인 메시지를 표시하지 않습니다.

기본값: False
전역 매개 변수
--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 stream-analytics cluster list

지정된 리소스 그룹의 모든 클러스터를 나열합니다. 지정된 구독의 모든 클러스터를 나열합니다.

az stream-analytics cluster list [--resource-group]

예제

리소스 그룹의 클러스터 나열

az stream-analytics cluster list --resource-group "sjrg"

구독의 클러스터 나열

az stream-analytics cluster list

선택적 매개 변수

--resource-group -g

리소스 그룹의 이름입니다. 를 사용하여 az configure --defaults group=<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 stream-analytics cluster list-streaming-job

지정된 클러스터의 모든 스트리밍 작업을 나열합니다.

az stream-analytics cluster list-streaming-job --cluster-name
                                               --resource-group

예제

클러스터의 모든 스트리밍 작업 나열

az stream-analytics cluster list-streaming-job --name "testcluster" --resource-group "sjrg"

필수 매개 변수

--cluster-name --name -n

클러스터의 이름입니다.

--resource-group -g

리소스 그룹의 이름입니다. 를 사용하여 az configure --defaults group=<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 stream-analytics cluster show

지정된 클러스터에 대한 정보를 가져옵니다.

az stream-analytics cluster show [--cluster-name]
                                 [--ids]
                                 [--resource-group]
                                 [--subscription]

예제

클러스터 가져오기

az stream-analytics cluster show --name "testcluster" --resource-group "sjrg"

선택적 매개 변수

--cluster-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
기본값: json
--query

JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.

--subscription

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

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.

az stream-analytics cluster update

기존 클러스터를 업데이트합니다. 클러스터 정의의 나머지 부분에 영향을 주지 않고 클러스터를 부분적으로 업데이트(예: 하나 또는 두 개의 속성 업데이트)하는 데 사용할 수 있습니다.

az stream-analytics cluster update [--cluster-name]
                                   [--ids]
                                   [--if-match]
                                   [--location]
                                   [--no-wait]
                                   [--resource-group]
                                   [--sku]
                                   [--subscription]
                                   [--tags]

예제

클러스터 업데이트

az stream-analytics cluster update --location "Central US" --sku capacity=72 --name "testcluster" --resource-group "sjrg"

선택적 매개 변수

--cluster-name --name -n

클러스터의 이름입니다.

--ids

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

--if-match

리소스의 ETag입니다. 현재 레코드 집합을 항상 덮어쓰려면 이 값을 생략합니다. 실수로 동시 변경 내용을 덮어쓰지 않도록 마지막으로 본 ETag 값을 지정합니다.

--location -l

위치. 값: az account list-locations. az configure --defaults location=<location>을 사용하여 기본 위치를 구성할 수 있습니다.

--no-wait

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

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

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

--sku

클러스터의 SKU입니다. 이렇게 하면 클러스터의 크기/용량이 결정됩니다. PUT(CreateOrUpdate) 요청에 필요합니다.

사용량: --sku name=XX capacity=XX

name: 클러스터의 SKU 이름을 지정합니다. PUT(CreateOrUpdate) 요청에 필요합니다. 용량: 클러스터에서 지원할 수 있는 스트리밍 단위 수를 표시합니다. 이 속성의 유효한 값은 최소값이 36이고 최대값이 216인 36의 배수입니다. PUT(CreateOrUpdate) 요청에 필요합니다.

--subscription

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

--tags

공백으로 구분된 태그: key[=value] [key[=value] ...]. ""를 사용하여 기존 태그를 지웁니다.

전역 매개 변수
--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 stream-analytics cluster wait

stream-analytics 클러스터의 조건이 충족될 때까지 CLI를 대기 상태로 설정합니다.

az stream-analytics cluster wait [--cluster-name]
                                 [--created]
                                 [--custom]
                                 [--deleted]
                                 [--exists]
                                 [--ids]
                                 [--interval]
                                 [--resource-group]
                                 [--subscription]
                                 [--timeout]
                                 [--updated]

예제

stream-analytics 클러스터가 성공적으로 생성될 때까지 CLI 스크립트의 다음 줄 실행을 일시 중지합니다.

az stream-analytics cluster wait --name "testcluster" --resource-group "sjrg" --created

stream-analytics 클러스터가 성공적으로 업데이트될 때까지 CLI 스크립트의 다음 줄 실행을 일시 중지합니다.

az stream-analytics cluster wait --name "testcluster" --resource-group "sjrg" --updated

stream-analytics 클러스터가 성공적으로 삭제될 때까지 CLI 스크립트의 다음 줄 실행을 일시 중지합니다.

az stream-analytics cluster wait --name "testcluster" --resource-group "sjrg" --deleted

선택적 매개 변수

--cluster-name --name -n

클러스터의 이름입니다.

--created

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

기본값: False
--custom

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

--deleted

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

기본값: False
--exists

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

기본값: False
--ids

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

--interval

폴링 간격(초)입니다.

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

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

--subscription

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

--timeout

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

기본값: 3600
--updated

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

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