az iot ops dataflowgraph
메모
이 참조는 Azure CLI azure-iot-ops 확장의 일부입니다(버전 2.70.0 이상). az iot ops dataflowgraph 명령을 처음 실행할 때 확장이 자동으로 설치됩니다. 확장 프로그램에 대해 자세히 알아보세요.
DataflowGraph 관리.
명령
| Name | Description | 형식 | 상태 |
|---|---|---|---|
| az iot ops dataflowgraph apply |
데이터 흐름 프로필과 연결된 DataflowGraph를 만들거나 대체합니다. |
Extension | GA |
| az iot ops dataflowgraph delete |
데이터 흐름 프로필과 연결된 DataflowGraph를 삭제합니다. |
Extension | GA |
| az iot ops dataflowgraph list |
데이터 흐름 프로필과 연결된 DataflowGraph를 나열합니다. |
Extension | GA |
| az iot ops dataflowgraph show |
데이터 흐름 프로필과 연결된 DataflowGraph의 세부 정보를 표시합니다. |
Extension | GA |
az iot ops dataflowgraph apply
데이터 흐름 프로필과 연결된 DataflowGraph를 만들거나 대체합니다.
구성 파일 형식의 예는 다음과 같습니다.
{
"mode": "Enabled",
"nodes": [
{
"name": "source-mqtt",
"nodeType": "Source",
"sourceSettings": {
"endpointRef": "default-broker",
"dataSources": ["sensors/temperature/#"]
}
},
{
"name": "dest-broker",
"nodeType": "Destination",
"destinationSettings": {
"endpointRef": "my-kafka-endpoint",
"dataDestination": "telemetry/temperature"
}
},
{
"name": "dest-otel",
"nodeType": "Destination",
"destinationSettings": {
"endpointRef": "my-otel-endpoint",
"dataDestination": "telemetry/all"
}
},
{
"name": "graph-processor",
"nodeType": "Graph",
"graphSettings": {
"registryEndpointRef": "my-registry-endpoint",
"artifact": "my-processing-module:1.0.0",
"configuration": [
{ "key": "paramName", "value": "paramValue" },
{ "key": "anotherParam", "value": "anotherValue" }
]
}
}
],
"nodeConnections": [
{ "from": { "name": "source-mqtt" }, "to": { "name": "graph-processor" } },
{ "from": { "name": "graph-processor" }, "to": { "name": "dest-broker" } },
{ "from": { "name": "graph-processor" }, "to": { "name": "dest-otel" } }
]
}
위의 예제에서는 Kafka 대상 및 OpenTelemetry 대상으로 팬아웃하는 그래프 처리 노드를 통해 흐르는 MQTT 원본을 사용하여 그래프를 정의합니다. 그래프 노드는 레지스트리 엔드포인트에서 아티팩트(형식: <name>:<version>)를 참조합니다. 위의 예제에는 아티팩트에서 구성 매개 변수가 필요한 경우에만 형식을 보여 주는 graphSettings.configuration이 포함되어 있습니다. 이 경우 {"key", "value"} 문자열 쌍 목록으로 제공합니다. 구성이 필요하지 않은 경우 graphSettings.configuration을 완전히 생략합니다.
지원되는 nodeType은 원본, 대상 및 그래프입니다. 데이터 흐름 그래프는 MQTT, Kafka 및 OpenTelemetry 엔드포인트만 지원합니다. 파일은 전체 ARM 리소스 래퍼일 수도 있습니다(속성은 자동 추출됨). extendedLocation은 항상 --instance 및 -g 자동으로 채워지며 파일에 포함되어서는 안 됩니다.
위의 콘텐츠를 적용하는 데 사용하면 대상 DataflowGraph 리소스를 만들거나 대체합니다.
az iot ops dataflowgraph apply --config-file
--instance
--name
--resource-group
[--acquire-policy-token]
[--change-reference]
[--profile]
예제
구성 파일을 사용하여 'myprofile' 프로필과 연결된 DataflowGraph 'mygraph'를 만들거나 대체합니다.
az iot ops dataflowgraph apply -n mygraph -p myprofile -i myinstance -g myresourcegroup --config-file /path/to/graph/config.json
필수 매개 변수
데이터 흐름 그래프 속성을 포함하는 JSON 파일의 경로입니다.
| 속성 | 값 |
|---|---|
| 매개 변수 그룹: | Config Arguments |
IoT Operations 인스턴스 이름입니다.
DataflowGraph 이름입니다.
리소스 그룹의 이름입니다.
az configure --defaults group=<name>사용하여 기본 그룹을 구성할 수 있습니다.
선택적 매개 변수
다음 매개 변수는 선택 사항이지만 컨텍스트에 따라 명령이 성공적으로 실행되려면 하나 이상의 매개 변수가 필요할 수 있습니다.
이 리소스 작업에 대한 Azure Policy 토큰을 자동으로 획득합니다.
| 속성 | 값 |
|---|---|
| 매개 변수 그룹: | Global Policy Arguments |
이 리소스 작업에 대한 관련 변경 참조 ID입니다.
| 속성 | 값 |
|---|---|
| 매개 변수 그룹: | Global Policy Arguments |
데이터 흐름 프로필 이름입니다. 기본값: 'default'.
| 속성 | 값 |
|---|---|
| Default value: | default |
전역 매개 변수
로깅 수위를 높여 모든 디버그 로그를 표시합니다.
| 속성 | 값 |
|---|---|
| Default value: | False |
이 도움말 메시지를 표시하고 종료합니다.
경고를 표시하지 않고 오류만 표시합니다.
| 속성 | 값 |
|---|---|
| Default value: | False |
출력 형식
| 속성 | 값 |
|---|---|
| Default value: | json |
| 허용되는 값: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath 쿼리 문자열입니다. 자세한 내용 및 예제는 http://jmespath.org/ 참조하세요.
구독의 이름 또는 ID입니다.
az account set -s NAME_OR_ID를 사용하여 기본 구독을 구성할 수 있습니다.
로깅의 자세한 정도를 증가시킵니다. 전체 디버그 로그에 --debug를 사용합니다.
| 속성 | 값 |
|---|---|
| Default value: | False |
az iot ops dataflowgraph delete
데이터 흐름 프로필과 연결된 DataflowGraph를 삭제합니다.
az iot ops dataflowgraph delete --instance
--name
--resource-group
[--acquire-policy-token]
[--change-reference]
[--profile]
[--yes {false, true}]
예제
'myprofile' 프로필과 연결된 DataflowGraph 'mygraph'를 삭제합니다.
az iot ops dataflowgraph delete -n mygraph -p myprofile -i mycluster-ops-instance -g myresourcegroup
확인 프롬프트 없이 DataflowGraph 'mygraph'를 삭제합니다.
az iot ops dataflowgraph delete -n mygraph -p myprofile -i mycluster-ops-instance -g myresourcegroup -y
필수 매개 변수
IoT Operations 인스턴스 이름입니다.
DataflowGraph 이름입니다.
리소스 그룹의 이름입니다.
az configure --defaults group=<name>사용하여 기본 그룹을 구성할 수 있습니다.
선택적 매개 변수
다음 매개 변수는 선택 사항이지만 컨텍스트에 따라 명령이 성공적으로 실행되려면 하나 이상의 매개 변수가 필요할 수 있습니다.
이 리소스 작업에 대한 Azure Policy 토큰을 자동으로 획득합니다.
| 속성 | 값 |
|---|---|
| 매개 변수 그룹: | Global Policy Arguments |
이 리소스 작업에 대한 관련 변경 참조 ID입니다.
| 속성 | 값 |
|---|---|
| 매개 변수 그룹: | Global Policy Arguments |
데이터 흐름 프로필 이름입니다. 기본값: 'default'.
| 속성 | 값 |
|---|---|
| Default value: | default |
프롬프트 없이 [y]es를 확인합니다. CI 및 자동화 시나리오에 유용합니다.
| 속성 | 값 |
|---|---|
| 허용되는 값: | false, true |
전역 매개 변수
로깅 수위를 높여 모든 디버그 로그를 표시합니다.
| 속성 | 값 |
|---|---|
| Default value: | False |
이 도움말 메시지를 표시하고 종료합니다.
경고를 표시하지 않고 오류만 표시합니다.
| 속성 | 값 |
|---|---|
| Default value: | False |
출력 형식
| 속성 | 값 |
|---|---|
| Default value: | json |
| 허용되는 값: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath 쿼리 문자열입니다. 자세한 내용 및 예제는 http://jmespath.org/ 참조하세요.
구독의 이름 또는 ID입니다.
az account set -s NAME_OR_ID를 사용하여 기본 구독을 구성할 수 있습니다.
로깅의 자세한 정도를 증가시킵니다. 전체 디버그 로그에 --debug를 사용합니다.
| 속성 | 값 |
|---|---|
| Default value: | False |
az iot ops dataflowgraph list
데이터 흐름 프로필과 연결된 DataflowGraph를 나열합니다.
az iot ops dataflowgraph list --instance
--resource-group
[--profile]
예제
'myprofile' 프로필과 연결된 DataflowGraphs를 열거합니다.
az iot ops dataflowgraph list -p myprofile -i mycluster-ops-instance -g myresourcegroup
필수 매개 변수
IoT Operations 인스턴스 이름입니다.
리소스 그룹의 이름입니다.
az configure --defaults group=<name>사용하여 기본 그룹을 구성할 수 있습니다.
선택적 매개 변수
다음 매개 변수는 선택 사항이지만 컨텍스트에 따라 명령이 성공적으로 실행되려면 하나 이상의 매개 변수가 필요할 수 있습니다.
데이터 흐름 프로필 이름입니다. 기본값: 'default'.
| 속성 | 값 |
|---|---|
| Default value: | default |
전역 매개 변수
로깅 수위를 높여 모든 디버그 로그를 표시합니다.
| 속성 | 값 |
|---|---|
| Default value: | False |
이 도움말 메시지를 표시하고 종료합니다.
경고를 표시하지 않고 오류만 표시합니다.
| 속성 | 값 |
|---|---|
| Default value: | False |
출력 형식
| 속성 | 값 |
|---|---|
| Default value: | json |
| 허용되는 값: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath 쿼리 문자열입니다. 자세한 내용 및 예제는 http://jmespath.org/ 참조하세요.
구독의 이름 또는 ID입니다.
az account set -s NAME_OR_ID를 사용하여 기본 구독을 구성할 수 있습니다.
로깅의 자세한 정도를 증가시킵니다. 전체 디버그 로그에 --debug를 사용합니다.
| 속성 | 값 |
|---|---|
| Default value: | False |
az iot ops dataflowgraph show
데이터 흐름 프로필과 연결된 DataflowGraph의 세부 정보를 표시합니다.
az iot ops dataflowgraph show --instance
--name
--resource-group
[--profile]
예제
'myprofile' 프로필과 연결된 DataflowGraph 'mygraph'의 세부 정보를 표시합니다.
az iot ops dataflowgraph show -n mygraph -p myprofile -i mycluster-ops-instance -g myresourcegroup
필수 매개 변수
IoT Operations 인스턴스 이름입니다.
DataflowGraph 이름입니다.
리소스 그룹의 이름입니다.
az configure --defaults group=<name>사용하여 기본 그룹을 구성할 수 있습니다.
선택적 매개 변수
다음 매개 변수는 선택 사항이지만 컨텍스트에 따라 명령이 성공적으로 실행되려면 하나 이상의 매개 변수가 필요할 수 있습니다.
데이터 흐름 프로필 이름입니다. 기본값: 'default'.
| 속성 | 값 |
|---|---|
| Default value: | default |
전역 매개 변수
로깅 수위를 높여 모든 디버그 로그를 표시합니다.
| 속성 | 값 |
|---|---|
| Default value: | False |
이 도움말 메시지를 표시하고 종료합니다.
경고를 표시하지 않고 오류만 표시합니다.
| 속성 | 값 |
|---|---|
| Default value: | False |
출력 형식
| 속성 | 값 |
|---|---|
| Default value: | json |
| 허용되는 값: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath 쿼리 문자열입니다. 자세한 내용 및 예제는 http://jmespath.org/ 참조하세요.
구독의 이름 또는 ID입니다.
az account set -s NAME_OR_ID를 사용하여 기본 구독을 구성할 수 있습니다.
로깅의 자세한 정도를 증가시킵니다. 전체 디버그 로그에 --debug를 사용합니다.
| 속성 | 값 |
|---|---|
| Default value: | False |