az iot ops dataflowgraph

Note

Bu başvuru, Azure CLI (sürüm 2.70.0 veya üzeri) için azure-iot-ops uzantısının bir parçasıdır. Uzantı, az iot ops dataflowgraph komutunu ilk kez çalıştırdığınızda otomatik olarak yüklenir. Uzantılar hakkında daha fazla bilgi edinin.

DataflowGraph yönetimi.

Komutlar

Name	Description	Tür	Durum
az iot ops dataflowgraph apply	Veri akışı profiliyle ilişkilendirilmiş bir DataflowGraph oluşturun veya değiştirin.	Extension	GA
az iot ops dataflowgraph delete	Veri akışı profiliyle ilişkilendirilmiş bir DataflowGraph'i silin.	Extension	GA
az iot ops dataflowgraph list	Veri akışı profiliyle ilişkili DataflowGraphs listesini oluşturma.	Extension	GA
az iot ops dataflowgraph show	Veri akışı profiliyle ilişkilendirilmiş bir DataflowGraph'ın ayrıntılarını gösterin.	Extension	GA

az iot ops dataflowgraph apply

Veri akışı profiliyle ilişkilendirilmiş bir DataflowGraph oluşturun veya değiştirin.

Yapılandırma dosyası biçimine bir örnek aşağıdaki gibidir:

{
  "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" } }
  ]
}

Yukarıdaki örnek, Kafka hedefine ve OpenTelemetry hedefine giden bir Graf işleme düğümünden akan MQTT kaynağı olan bir grafı tanımlar. Grafik düğümleri, kayıt defteri uç noktasından bir yapıta (biçim: <name>:<version>) başvurur. Yukarıdaki örnek, yalnızca yapıtın yapılandırma parametreleri gerektirdiğinde biçimi göstermek için graphSettings.configuration içerir; bu durumda, bunları {"key", "value"} dize çiftlerinin listesi olarak sağlayın. Yapılandırma gerekli olmadığında graphSettings.configuration dosyasını tamamen atlayın. Desteklenen nodeType'lar şunlardır: Kaynak, Hedef ve Graf. Veri akışı grafikleri yalnızca MQTT, Kafka ve OpenTelemetry uç noktalarını destekler. Dosya tam ARM kaynak sarmalayıcısı da olabilir (özellikler otomatik olarak ayıklanır). extendedLocation her zaman --instance ve -g'dan otomatik olarak doldurulur ve dosyaya dahil edilmemelidir.

Uygulama ile kullanıldığında yukarıdaki içerik bir hedef DataflowGraph kaynağı oluşturur veya değiştirir.

az iot ops dataflowgraph apply --config-file
                               --instance
                               --name
                               --resource-group
                               [--acquire-policy-token]
                               [--change-reference]
                               [--profile]

Örnekler

Yapılandırma dosyası kullanarak 'myprofile' profiliyle ilişkilendirilmiş bir DataflowGraph 'mygraph' oluşturun veya değiştirin.

az iot ops dataflowgraph apply -n mygraph -p myprofile -i myinstance -g myresourcegroup --config-file /path/to/graph/config.json

Gerekli Parametreler

--config-file

Veri akışı grafiği özelliklerini içeren bir JSON dosyasının yolu.

Özellik	Değer
Parametre grubu:	Config Arguments

--instance -i

IoT İşlemleri örnek adı.

--name -n

DataflowGraph adı.

--resource-group -g

Kaynak grubunun adı. Varsayılan grubu az configure --defaults group=<name> kullanarak yapılandırabilirsiniz.

İsteğe Bağlı Parametreler

Aşağıdaki parametreler isteğe bağlıdır, ancak bağlama bağlı olarak komutun başarıyla yürütülmesi için bir veya daha fazla parametre gerekli olabilir.

--acquire-policy-token

Bu kaynak işlemi için otomatik olarak bir Azure İlkesi belirteci alma.

Özellik	Değer
Parametre grubu:	Global Policy Arguments

--change-reference

Bu kaynak işlemi için ilgili değişiklik başvuru kimliği.

Özellik	Değer
Parametre grubu:	Global Policy Arguments

--profile -p

Veri akışı profili adı. Varsayılan: 'default'.

Özellik	Değer
Default value:	default

Global Parametreler

--debug

Tüm hata ayıklama günlüklerini göstermek için günlük ayrıntı düzeyini artırın.

Özellik	Değer
Default value:	False

--help -h

Bu yardım iletisini göster ve çık.

--only-show-errors

Yalnızca hataları gösterir ve uyarıları gizler.

Özellik	Değer
Default value:	False

--output -o

Çıkış biçimi.

Özellik	Değer
Default value:	json
Kabul edilen değerler:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath sorgu dizesi. Daha fazla bilgi ve örnek için bkz. http://jmespath.org/.

--subscription

Aboneliğin adı veya kimliği. az account set -s NAME_OR_IDkullanarak varsayılan aboneliği yapılandırabilirsiniz.

--verbose

Günlük ayrıntı düzeyini artırın. Tam hata ayıklama günlükleri için --debug komutunu kullanın.

Özellik	Değer
Default value:	False

az iot ops dataflowgraph delete

Veri akışı profiliyle ilişkilendirilmiş bir DataflowGraph'i silin.

az iot ops dataflowgraph delete --instance
                                --name
                                --resource-group
                                [--acquire-policy-token]
                                [--change-reference]
                                [--profile]
                                [--yes {false, true}]

Örnekler

'myprofile' profiliyle ilişkilendirilmiş 'mygraph' DataflowGraph'ını silin.

az iot ops dataflowgraph delete -n mygraph -p myprofile -i mycluster-ops-instance -g myresourcegroup

Bir DataflowGraph 'mygraph' öğesini onay istemi olmadan silin.

az iot ops dataflowgraph delete -n mygraph -p myprofile -i mycluster-ops-instance -g myresourcegroup -y

Gerekli Parametreler

--instance -i

IoT İşlemleri örnek adı.

--name -n

DataflowGraph adı.

--resource-group -g

Kaynak grubunun adı. Varsayılan grubu az configure --defaults group=<name> kullanarak yapılandırabilirsiniz.

İsteğe Bağlı Parametreler

Aşağıdaki parametreler isteğe bağlıdır, ancak bağlama bağlı olarak komutun başarıyla yürütülmesi için bir veya daha fazla parametre gerekli olabilir.

--acquire-policy-token

Bu kaynak işlemi için otomatik olarak bir Azure İlkesi belirteci alma.

Özellik	Değer
Parametre grubu:	Global Policy Arguments

--change-reference

Bu kaynak işlemi için ilgili değişiklik başvuru kimliği.

Özellik	Değer
Parametre grubu:	Global Policy Arguments

--profile -p

Veri akışı profili adı. Varsayılan: 'default'.

Özellik	Değer
Default value:	default

--yes -y

[y]es öğesini istem olmadan onaylayın. CI ve otomasyon senaryoları için kullanışlıdır.

Özellik	Değer
Kabul edilen değerler:	false, true

Global Parametreler

--debug

Tüm hata ayıklama günlüklerini göstermek için günlük ayrıntı düzeyini artırın.

Özellik	Değer
Default value:	False

--help -h

Bu yardım iletisini göster ve çık.

--only-show-errors

Yalnızca hataları gösterir ve uyarıları gizler.

Özellik	Değer
Default value:	False

--output -o

Çıkış biçimi.

Özellik	Değer
Default value:	json
Kabul edilen değerler:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath sorgu dizesi. Daha fazla bilgi ve örnek için bkz. http://jmespath.org/.

--subscription

Aboneliğin adı veya kimliği. az account set -s NAME_OR_IDkullanarak varsayılan aboneliği yapılandırabilirsiniz.

--verbose

Günlük ayrıntı düzeyini artırın. Tam hata ayıklama günlükleri için --debug komutunu kullanın.

Özellik	Değer
Default value:	False

az iot ops dataflowgraph list

Veri akışı profiliyle ilişkili DataflowGraphs listesini oluşturma.

az iot ops dataflowgraph list --instance
                              --resource-group
                              [--profile]

Örnekler

'myprofile' profiliyle ilişkili DataflowGraphs'ı numaralandırın.

az iot ops dataflowgraph list -p myprofile -i mycluster-ops-instance -g myresourcegroup

Gerekli Parametreler

--instance -i

IoT İşlemleri örnek adı.

--resource-group -g

Kaynak grubunun adı. Varsayılan grubu az configure --defaults group=<name> kullanarak yapılandırabilirsiniz.

İsteğe Bağlı Parametreler

Aşağıdaki parametreler isteğe bağlıdır, ancak bağlama bağlı olarak komutun başarıyla yürütülmesi için bir veya daha fazla parametre gerekli olabilir.

--profile -p

Veri akışı profili adı. Varsayılan: 'default'.

Özellik	Değer
Default value:	default

Global Parametreler

--debug

Tüm hata ayıklama günlüklerini göstermek için günlük ayrıntı düzeyini artırın.

Özellik	Değer
Default value:	False

--help -h

Bu yardım iletisini göster ve çık.

--only-show-errors

Yalnızca hataları gösterir ve uyarıları gizler.

Özellik	Değer
Default value:	False

--output -o

Çıkış biçimi.

Özellik	Değer
Default value:	json
Kabul edilen değerler:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath sorgu dizesi. Daha fazla bilgi ve örnek için bkz. http://jmespath.org/.

--subscription

Aboneliğin adı veya kimliği. az account set -s NAME_OR_IDkullanarak varsayılan aboneliği yapılandırabilirsiniz.

--verbose

Günlük ayrıntı düzeyini artırın. Tam hata ayıklama günlükleri için --debug komutunu kullanın.

Özellik	Değer
Default value:	False

az iot ops dataflowgraph show

Veri akışı profiliyle ilişkilendirilmiş bir DataflowGraph'ın ayrıntılarını gösterin.

az iot ops dataflowgraph show --instance
                              --name
                              --resource-group
                              [--profile]

Örnekler

'myprofile' profiliyle ilişkilendirilmiş 'mygraph' DataflowGraph'ın ayrıntılarını gösterin.

az iot ops dataflowgraph show -n mygraph -p myprofile -i mycluster-ops-instance -g myresourcegroup

Gerekli Parametreler

--instance -i

IoT İşlemleri örnek adı.

--name -n

DataflowGraph adı.

--resource-group -g

Kaynak grubunun adı. Varsayılan grubu az configure --defaults group=<name> kullanarak yapılandırabilirsiniz.

İsteğe Bağlı Parametreler

Aşağıdaki parametreler isteğe bağlıdır, ancak bağlama bağlı olarak komutun başarıyla yürütülmesi için bir veya daha fazla parametre gerekli olabilir.

--profile -p

Veri akışı profili adı. Varsayılan: 'default'.

Özellik	Değer
Default value:	default

Global Parametreler

--debug

Tüm hata ayıklama günlüklerini göstermek için günlük ayrıntı düzeyini artırın.

Özellik	Değer
Default value:	False

--help -h

Bu yardım iletisini göster ve çık.

--only-show-errors

Yalnızca hataları gösterir ve uyarıları gizler.

Özellik	Değer
Default value:	False

--output -o

Çıkış biçimi.

Özellik	Değer
Default value:	json
Kabul edilen değerler:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath sorgu dizesi. Daha fazla bilgi ve örnek için bkz. http://jmespath.org/.

--subscription

Aboneliğin adı veya kimliği. az account set -s NAME_OR_IDkullanarak varsayılan aboneliği yapılandırabilirsiniz.

--verbose

Günlük ayrıntı düzeyini artırın. Tam hata ayıklama günlükleri için --debug komutunu kullanın.

Özellik	Değer
Default value:	False