az iot ops connector template

Uyarı

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ı, bir az iot ops bağlayıcısı şablon komutunu ilk kez çalıştırdığınızda otomatik olarak yüklenir. Uzantılar hakkında daha fazla bilgi edinin.

Bağlayıcı şablonu yönetimi.

Bağlayıcı şablonları, bağlayıcı dağıtımına standartlaştırılmış, meta veri temelli bir yaklaşım sağlar. Şablonlar, bağlayıcı meta veri başvurularından (1. taraf bağlayıcılar için MCR, üçüncü taraf bağlayıcılar için ACR) oluşturulur ve dağıtım parametrelerinin kullanıcı tarafından özelleştirilmesine izin verirken bağlayıcıya özgü yapılandırma otomatik olarak açılır.

Komutlar

Veri Akışı Adı	Description	Tür	Durum
az iot ops connector template create	Yeni bir bağlayıcı şablonu oluşturun.	Extension	GA
az iot ops connector template delete	Bağlayıcı şablonunu silin.	Extension	GA
az iot ops connector template list	Tüm bağlayıcı şablonlarını listeleyin.	Extension	GA
az iot ops connector template show	Bağlayıcı şablonunu görüntüleme.	Extension	GA
az iot ops connector template update	Mevcut bağlayıcı şablonunu güncelleştirin.	Extension	GA

az iot ops connector template create

Yeni bir bağlayıcı şablonu oluşturun.

Kapsayıcı kayıt defterinde depolanan meta verilerden bir bağlayıcı şablonu oluşturur. Meta veriler bağlayıcıya özgü ayarları otomatik olarak doldururken çoğaltmalar, günlük düzeyleri ve gizli diziler gibi dağıtım parametreleri özelleştirilebilir.

az iot ops connector template create --connector-metadata-ref --ref
                                     --instance
                                     --name
                                     --resource-group
                                     [--acquire-policy-token]
                                     [--allocation-policy --ap]
                                     [--bs --bucket-size]
                                     [--cc --connector-config]
                                     [--change-reference]
                                     [--image-pull-policy --ipp]
                                     [--image-pull-secrets --ips]
                                     [--ll --log-level]
                                     [--replicas]
                                     [--secrets]
                                     [--storage-volumes --sv]
                                     [--trust-settings-secret-ref --tssr]

Örnekler

Varsayılan ayarlarla REST bağlayıcısı için bir şablon oluşturun.

az iot ops connector template create --name my-rest-template --resource-group myResourceGroup --instance myAIOInstance --connector-metadata-ref mcr.microsoft.com/azureiotoperations/akri-connectors/rest-metadata:1.0.6

Özel yapılandırma ile bir şablon oluşturun.

az iot ops connector template create --name my-rest-template --resource-group myResourceGroup --instance myAIOInstance --connector-metadata-ref mcr.microsoft.com/azureiotoperations/akri-connectors/rest-metadata:1.0.6 --replicas 3 --log-level debug --image-pull-secrets acr-credentials

Özel ACR'den üçüncü taraf bağlayıcısı için bir şablon oluşturun.

az iot ops connector template create --name custom-plc-template --resource-group myResourceGroup --instance myAIOInstance --connector-metadata-ref contoso.azurecr.io/connectors/plc-metadata:1.0.0 --image-pull-secrets acr-pull-secret

Gerekli Parametreler

--connector-metadata-ref --ref

Kapsayıcı kayıt defterinden bağlayıcı meta veri yapıtı URL'si.

            1st-party connectors (MCR):
            - `mcr.microsoft.com/azureiotoperations/akri-connectors/rest-metadata:VERSION`
            - `mcr.microsoft.com/azureiotoperations/akri-connectors/media-metadata:VERSION`
            - `mcr.microsoft.com/azureiotoperations/akri-connectors/mqtt-metadata:VERSION`
            - `mcr.microsoft.com/azureiotoperations/akri-connectors/sse-metadata:VERSION`
            - `mcr.microsoft.com/azureiotoperations/akri-connectors/onvif-metadata:VERSION`

            3rd-party connectors:
            - `REGISTRY.azurecr.io/PATH-metadata:VERSION`

            To list available versions for 1st-party connectors:
            `curl https://mcr.microsoft.com/v2/azureiotoperations/akri-connectors/TYPE-metadata/tags/list`.

--instance -i

IoT İşlemleri örnek adı.

--name -n

Şablon adı.

--resource-group -g

Örnek kaynak grubu.

İ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

--allocation-policy --ap

Cihaz uç noktalarını bağlayıcı örnekleri arasında ayırma ilkesi (büyük/küçük harfe duyarsız). Seçenekler: Demetli. Sağlanmazsa, hiçbir ayırma ilkesi ayarlanmaz.

--bs --bucket-size

Bağlayıcı örneği demeti başına uç nokta sayısı. Ayırma ilkesi 'Bucketized' olduğunda gereklidir.

--cc --connector-config

Boşlukla ayrılmış bağlayıcıya özgü anahtar-değer yapılandırmaları. Biçim: key=value. Bir çağrıda birden çok değer sağlayabilir veya birden çok kez kullanabilir. Örnekler: --cc brokerAddress=mqtt://broker:1883 qos=1 keepAlive=60 OR --cc brokerAddress=mqtt://broker:1883 --cc qos=1 --cc keepAlive=60. Mevcut yapılandırmaları temizlemek için '' kullanın.

--change-reference

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

Özellik	Değer
Parametre grubu:	Global Policy Arguments

--image-pull-policy --ipp

Kubernetes görüntü çekme ilkesi. Seçenekler: Always, IfNotPresent, Never.

--image-pull-secrets --ips

Özel kayıt defterlerinden kapsayıcı görüntülerini çekmek için boşlukla ayrılmış Kubernetes gizli dizi adları. Özel kapsayıcı kayıt defteri kullanan üçüncü taraf bağlayıcılar için, bağlayıcı podunun görüntüyü çekmesini sağlamak için kayıt defteri kimlik bilgilerini içeren gizli dizileri sağlayın. Mevcut görüntü çekme gizli dizilerini temizlemek için '' kullanın.

--ll --log-level

Bağlayıcı podları için günlük düzeyi. Seçenekler: izleme, hata ayıklama, bilgi, uyarı, hata. Varsayılan: bilgi.

--replicas -r

Dağıtılacak bağlayıcı pod çoğaltmalarının sayısı. Varsayılan değer, meta verilerdeki recommendedReplicas veya belirtilmezse 1'den alınır.

--secrets

Anahtar=değer biçiminde bağlamak için boşlukla ayrılmış bağlayıcı uygulama gizli dizileri. Her gizli dizi üç alan gerektirir: secretRef (bağlanılacak gizli dizinin adı), secretKey (bağlanılacak gizli dizideki anahtar) ve secretAlias (uygulama diğer adı). Örnek: secretRef=mySecret secretKey=password secretAlias=dbPassword. Birden çok gizli dizi tanımlamak için birden çok kez kullanılabilir. secretRef, gizli dizi sağlayıcı sınıfı aracılığıyla eşitlenen bir gizli diziye başvurmalıdır. Mevcut gizli dizileri temizlemek için '' kullanın.

--storage-volumes --sv

Key=value biçiminde boşlukla ayrılmış kalıcı birim talep başvurusu. Gerekli anahtarlar: claimName (mevcut PVC'nin adı), mountPath (kapsayıcıda bağlama yolu). Örnek: claimName=myPVC mountPath=/data. Mevcut depolama birimlerini temizlemek için '' kullanın.

--trust-settings-secret-ref --tssr

Güvenecek sertifikalar için gizli dizi başvurusu. Bu, güvenilen CA sertifikalarını içeren Kubernetes gizli dizisinin adını belirtir. Mevcut güven ayarlarını temizlemek için '' kullanın.

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 connector template delete

Bağlayıcı şablonunu silin.

Bağlayıcı şablonunu siler. Şablonun şu anda dağıtılan bağlayıcılar tarafından kullanımda olup olmadığını doğrular ve --evet sağlanmadığı sürece onay ister.

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

Örnekler

Onay istemiyle şablonu silin.

az iot ops connector template delete --name my-rest-template --resource-group myResourceGroup --instance myAIOInstance

Şablonu onay olmadan silin.

az iot ops connector template delete --name my-rest-template --resource-group myResourceGroup --instance myAIOInstance --yes

Gerekli Parametreler

--instance -i

IoT İşlemleri örnek adı.

--name -n

Şablon adı.

--resource-group -g

Örnek kaynak grubu.

İ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

--yes -y

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

Özellik	Değer
Default value:	False
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 connector template list

Tüm bağlayıcı şablonlarını listeleyin.

Belirli bir Azure IoT İşlemleri örneğine yönelik tüm bağlayıcı şablonlarını şablon adı, bağlayıcı türü, sürüm, çoğaltmalar ve oluşturma/değiştirme tarihleri gibi özet bilgilerle listeler.

az iot ops connector template list --instance
                                   --resource-group

Örnekler

Bir örneğin tüm şablonlarını listeleyin.

az iot ops connector template list --resource-group myResourceGroup --instance myAIOInstance

Gerekli Parametreler

--instance -i

IoT İşlemleri örnek adı.

--resource-group -g

Örnek kaynak grubu.

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 connector template show

Bağlayıcı şablonunu görüntüleme.

Meta veriler, bağlayıcı bilgileri, görüntü yapılandırması, dağıtım ayarları, storage yapılandırması ve güvenlik ayarları gibi eksiksiz şablon yapılandırmasını gösterir.

az iot ops connector template show --instance
                                   --name
                                   --resource-group

Örnekler

Şablon ayrıntılarını JSON biçiminde gösterin.

az iot ops connector template show --name my-rest-template --resource-group myResourceGroup --instance myAIOInstance

Şablonu tablo biçiminde göster.

az iot ops connector template show --name my-rest-template --resource-group myResourceGroup --instance myAIOInstance --output table

Gerekli Parametreler

--instance -i

IoT İşlemleri örnek adı.

--name -n

Şablon adı.

--resource-group -g

Örnek kaynak grubu.

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 connector template update

Mevcut bağlayıcı şablonunu güncelleştirin.

Bağlayıcı şablonunu güncelleştirir. Çoğaltmalar, günlük düzeyleri, gizli diziler, görüntü çekme ayarları ve güven ayarları gibi dağıtım parametreleri değiştirilebilir. Bağlayıcı meta verileri yalnızca düzeltme eki veya ikincil sürüm yükseltmeleri için güncelleştirilebilir. Ana sürüm güncelleştirmeleri için yeni bir şablon oluşturulması gerekir.

az iot ops connector template update --instance
                                     --name
                                     --resource-group
                                     [--acquire-policy-token]
                                     [--allocation-policy --ap]
                                     [--bs --bucket-size]
                                     [--cc --connector-config]
                                     [--change-reference]
                                     [--connector-metadata-ref --ref]
                                     [--image-pull-policy --ipp]
                                     [--image-pull-secrets --ips]
                                     [--ll --log-level]
                                     [--replicas]
                                     [--secrets]
                                     [--storage-volumes --sv]
                                     [--trust-settings-secret-ref --tssr]

Örnekler

Çoğaltma sayısını ve günlük düzeyini güncelleştirin.

az iot ops connector template update --name my-rest-template --resource-group myResourceGroup --instance myAIOInstance --replicas 5 --log-level debug

Bağlayıcının daha yeni bir yama sürümüne güncelleştirin.

az iot ops connector template update --name my-rest-template --resource-group myResourceGroup --instance myAIOInstance --connector-metadata-ref mcr.microsoft.com/azureiotoperations/akri-connectors/rest-metadata:1.0.7

Gerekli Parametreler

--instance -i

IoT İşlemleri örnek adı.

--name -n

Şablon adı.

--resource-group -g

Örnek kaynak grubu.

İ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

--allocation-policy --ap

Cihaz uç noktalarını bağlayıcı örnekleri arasında ayırma ilkesi (büyük/küçük harfe duyarsız). Seçenekler: Demetli. Sağlanmazsa, hiçbir ayırma ilkesi ayarlanmaz.

--bs --bucket-size

Bağlayıcı örneği demeti başına uç nokta sayısı. Ayırma ilkesi 'Bucketized' olduğunda gereklidir.

--cc --connector-config

Boşlukla ayrılmış bağlayıcıya özgü anahtar-değer yapılandırmaları. Biçim: key=value. Bir çağrıda birden çok değer sağlayabilir veya birden çok kez kullanabilir. Örnekler: --cc brokerAddress=mqtt://broker:1883 qos=1 keepAlive=60 OR --cc brokerAddress=mqtt://broker:1883 --cc qos=1 --cc keepAlive=60. Mevcut yapılandırmaları temizlemek için '' kullanın.

--change-reference

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

Özellik	Değer
Parametre grubu:	Global Policy Arguments

--connector-metadata-ref --ref

Kapsayıcı kayıt defterinden bağlayıcı meta veri yapıtı URL'si.

            1st-party connectors (MCR):
            - `mcr.microsoft.com/azureiotoperations/akri-connectors/rest-metadata:VERSION`
            - `mcr.microsoft.com/azureiotoperations/akri-connectors/media-metadata:VERSION`
            - `mcr.microsoft.com/azureiotoperations/akri-connectors/mqtt-metadata:VERSION`
            - `mcr.microsoft.com/azureiotoperations/akri-connectors/sse-metadata:VERSION`
            - `mcr.microsoft.com/azureiotoperations/akri-connectors/onvif-metadata:VERSION`

            3rd-party connectors:
            - `REGISTRY.azurecr.io/PATH-metadata:VERSION`

            To list available versions for 1st-party connectors:
            `curl https://mcr.microsoft.com/v2/azureiotoperations/akri-connectors/TYPE-metadata/tags/list`.

--image-pull-policy --ipp

Kubernetes görüntü çekme ilkesi. Seçenekler: Always, IfNotPresent, Never.

--image-pull-secrets --ips

Özel kayıt defterlerinden kapsayıcı görüntülerini çekmek için boşlukla ayrılmış Kubernetes gizli dizi adları. Özel kapsayıcı kayıt defteri kullanan üçüncü taraf bağlayıcılar için, bağlayıcı podunun görüntüyü çekmesini sağlamak için kayıt defteri kimlik bilgilerini içeren gizli dizileri sağlayın. Mevcut görüntü çekme gizli dizilerini temizlemek için '' kullanın.

--ll --log-level

Bağlayıcı podları için günlük düzeyi. Seçenekler: izleme, hata ayıklama, bilgi, uyarı, hata. Varsayılan: bilgi.

--replicas -r

Dağıtılacak bağlayıcı pod çoğaltmalarının sayısı. Varsayılan değer, meta verilerdeki recommendedReplicas veya belirtilmezse 1'den alınır.

--secrets

Anahtar=değer biçiminde bağlamak için boşlukla ayrılmış bağlayıcı uygulama gizli dizileri. Her gizli dizi üç alan gerektirir: secretRef (bağlanılacak gizli dizinin adı), secretKey (bağlanılacak gizli dizideki anahtar) ve secretAlias (uygulama diğer adı). Örnek: secretRef=mySecret secretKey=password secretAlias=dbPassword. Birden çok gizli dizi tanımlamak için birden çok kez kullanılabilir. secretRef, gizli dizi sağlayıcı sınıfı aracılığıyla eşitlenen bir gizli diziye başvurmalıdır. Mevcut gizli dizileri temizlemek için '' kullanın.

--storage-volumes --sv

Key=value biçiminde boşlukla ayrılmış kalıcı birim talep başvurusu. Gerekli anahtarlar: claimName (mevcut PVC'nin adı), mountPath (kapsayıcıda bağlama yolu). Örnek: claimName=myPVC mountPath=/data. Mevcut depolama birimlerini temizlemek için '' kullanın.

--trust-settings-secret-ref --tssr

Güvenecek sertifikalar için gizli dizi başvurusu. Bu, güvenilen CA sertifikalarını içeren Kubernetes gizli dizisinin adını belirtir. Mevcut güven ayarlarını temizlemek için '' kullanın.

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