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

필수 매개 변수

--config-file

데이터 흐름 그래프 속성을 포함하는 JSON 파일의 경로입니다.

속성
매개 변수 그룹: Config Arguments
--instance -i

IoT Operations 인스턴스 이름입니다.

--name -n

DataflowGraph 이름입니다.

--resource-group -g

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

선택적 매개 변수

다음 매개 변수는 선택 사항이지만 컨텍스트에 따라 명령이 성공적으로 실행되려면 하나 이상의 매개 변수가 필요할 수 있습니다.

--acquire-policy-token

이 리소스 작업에 대한 Azure Policy 토큰을 자동으로 획득합니다.

속성
매개 변수 그룹: Global Policy Arguments
--change-reference

이 리소스 작업에 대한 관련 변경 참조 ID입니다.

속성
매개 변수 그룹: Global Policy Arguments
--profile -p

데이터 흐름 프로필 이름입니다. 기본값: 'default'.

속성
Default value: default
전역 매개 변수
--debug

로깅 수위를 높여 모든 디버그 로그를 표시합니다.

속성
Default value: False
--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

경고를 표시하지 않고 오류만 표시합니다.

속성
Default value: False
--output -o

출력 형식

속성
Default value: json
허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc
--query

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

--subscription

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

--verbose

로깅의 자세한 정도를 증가시킵니다. 전체 디버그 로그에 --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

필수 매개 변수

--instance -i

IoT Operations 인스턴스 이름입니다.

--name -n

DataflowGraph 이름입니다.

--resource-group -g

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

선택적 매개 변수

다음 매개 변수는 선택 사항이지만 컨텍스트에 따라 명령이 성공적으로 실행되려면 하나 이상의 매개 변수가 필요할 수 있습니다.

--acquire-policy-token

이 리소스 작업에 대한 Azure Policy 토큰을 자동으로 획득합니다.

속성
매개 변수 그룹: Global Policy Arguments
--change-reference

이 리소스 작업에 대한 관련 변경 참조 ID입니다.

속성
매개 변수 그룹: Global Policy Arguments
--profile -p

데이터 흐름 프로필 이름입니다. 기본값: 'default'.

속성
Default value: default
--yes -y

프롬프트 없이 [y]es를 확인합니다. CI 및 자동화 시나리오에 유용합니다.

속성
허용되는 값: false, true
전역 매개 변수
--debug

로깅 수위를 높여 모든 디버그 로그를 표시합니다.

속성
Default value: False
--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

경고를 표시하지 않고 오류만 표시합니다.

속성
Default value: False
--output -o

출력 형식

속성
Default value: json
허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc
--query

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

--subscription

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

--verbose

로깅의 자세한 정도를 증가시킵니다. 전체 디버그 로그에 --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

필수 매개 변수

--instance -i

IoT Operations 인스턴스 이름입니다.

--resource-group -g

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

선택적 매개 변수

다음 매개 변수는 선택 사항이지만 컨텍스트에 따라 명령이 성공적으로 실행되려면 하나 이상의 매개 변수가 필요할 수 있습니다.

--profile -p

데이터 흐름 프로필 이름입니다. 기본값: 'default'.

속성
Default value: default
전역 매개 변수
--debug

로깅 수위를 높여 모든 디버그 로그를 표시합니다.

속성
Default value: False
--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

경고를 표시하지 않고 오류만 표시합니다.

속성
Default value: False
--output -o

출력 형식

속성
Default value: json
허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc
--query

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

--subscription

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

--verbose

로깅의 자세한 정도를 증가시킵니다. 전체 디버그 로그에 --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

필수 매개 변수

--instance -i

IoT Operations 인스턴스 이름입니다.

--name -n

DataflowGraph 이름입니다.

--resource-group -g

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

선택적 매개 변수

다음 매개 변수는 선택 사항이지만 컨텍스트에 따라 명령이 성공적으로 실행되려면 하나 이상의 매개 변수가 필요할 수 있습니다.

--profile -p

데이터 흐름 프로필 이름입니다. 기본값: 'default'.

속성
Default value: default
전역 매개 변수
--debug

로깅 수위를 높여 모든 디버그 로그를 표시합니다.

속성
Default value: False
--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

경고를 표시하지 않고 오류만 표시합니다.

속성
Default value: False
--output -o

출력 형식

속성
Default value: json
허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc
--query

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

--subscription

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

--verbose

로깅의 자세한 정도를 증가시킵니다. 전체 디버그 로그에 --debug를 사용합니다.

속성
Default value: False