az dt model

Note

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

Digital Twins örneğinde DTDL modellerini ve tanımlarını yönetin.

Komutlar

Name	Description	Tür	Durum
az dt model create	Bir veya daha fazla modeli karşıya yükler.	Extension	GA
az dt model delete	Modeli silme. Bir model yalnızca başka hiçbir model başvurmazsa silinebilir.	Extension	GA
az dt model delete-all	Digital Twins örneği içindeki tüm modelleri silin.	Extension	GA
az dt model list	Model meta verilerini, tanımlarını ve bağımlılıklarını listeleyin.	Extension	GA
az dt model show	Bir hedef model veya model tanımı alın.	Extension	GA
az dt model update	Modelin meta verilerini güncelleştirir. Şu anda bir model yalnızca kullanımdan kaldırılabilir.	Extension	GA

az dt model create

Bir veya daha fazla modeli karşıya yükler.

--models satır içi json veya dosya yolu olabilir. Giriş modeli kümesinin (ontoloji) boyutu, DT örneğinin depolayabileceğiniz maksimum model sayısıyla kısıtlanır (varsayılan değer 10000 modeldir).

az dt model create --dt-name --dtn
                   [--acquire-policy-token]
                   [--change-reference]
                   [--failure-policy --fp {None, Rollback}]
                   [--fd --from-directory]
                   [--max-models-per-batch --mmpb]
                   [--models]
                   [--resource-group]

Örnekler

Hedef dizinden tüm .json veya .dtdl model dosyalarını toplu olarak karşıya yükleyin. Model işleme özyinelemeli.

az dt model create -n {instance_or_hostname} --from-directory {directory_path}

Model json'larını satır içinde veya dosya yolundan karşıya yükleyin.

az dt model create -n {instance_or_hostname} --models {file_path_or_inline_json}

Gerekli Parametreler

--dt-name --dtn -n

Digital Twins örneği adı veya konak adı. Bir örnek adı sağlanırsa, hedef örneğin konak adını alması için önce kullanıcı aboneliği sorgulanır. Bir konak adı sağlanırsa abonelik sorgusu atlanır ve sağlanan değer sonraki etkileşim için kullanılır.

İ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 Policy 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

--failure-policy --fp

Bir model toplu işlemi işlenirken bir hata oluştuğunda hata ilkesini gösterir. 'Geri Alma' modunda, önceki toplu işlemlerde oluşturulan tüm modeller birer birer silinir. 'Yok' olarak seçildiğinde, önceki toplu işlemlerde oluşturulan modeller DT örneğinden silinmez.

Özellik	Değer
Parametre grubu:	Models Input Arguments
Default value:	Rollback
Kabul edilen değerler:	None, Rollback

--fd --from-directory

JSON model dosyaları dizininden ayrıştırılır. Lütfen Unutmayın: Dizinde 250 veya daha az model bulunduğunda modeller atomik olarak oluşturulur, bu nedenle bir hata olması durumunda modellerden hiçbiri oluşturulmaz. Dizinde 250'den fazla model (API sınırı) olduğunda giriş modeli kümesi toplu olarak oluşturulan & öbeklenir. Toplu işlemi işlerken hata olması durumunda, davranış --failure-policy parametresi tarafından belirlenir.

Özellik	Değer
Parametre grubu:	Models Input Arguments

--max-models-per-batch --mmpb

Deneysel

250'den fazla model oluştururken toplu iş başına maksimum model boyutu. DTDLParser hatasını önlemek için bu sayıyı azaltın.

Özellik	Değer
Parametre grubu:	Models Input Arguments
Default value:	30

--models

Satır içi model JSON veya model JSON için dosya yolu. Lütfen Unutmayın: Model JSON 250 veya daha az model içerdiğinde modeller atomik olarak oluşturulur, bu nedenle bir hata olması durumunda modellerden hiçbiri oluşturulmaz. Giriş modeli kümesi, JSON modelinde 250'den fazla model (API sınırı) olduğunda toplu olarak oluşturulan & öbeklenir. Toplu işlemi işlerken hata olması durumunda, davranış --failure-policy parametresi tarafından belirlenir.

Özellik	Değer
Parametre grubu:	Models Input Arguments

--resource-group -g

Digital Twins örneği kaynak grubu. az configure --defaults group={name}kullanarak varsayılan grubu yapılandırabilirsiniz.

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 dt model delete

Modeli silme. Bir model yalnızca başka hiçbir model başvurmazsa silinebilir.

az dt model delete --dt-name --dtn
                   --dtmi --model-id
                   [--acquire-policy-token]
                   [--change-reference]
                   [--resource-group]

Örnekler

Hedef modeli silme.

az dt model delete -n {instance_or_hostname} --dtmi "dtmi:com:example:Floor;1"

Gerekli Parametreler

--dt-name --dtn -n

Digital Twins örneği adı veya konak adı. Bir örnek adı sağlanırsa, hedef örneğin konak adını alması için önce kullanıcı aboneliği sorgulanır. Bir konak adı sağlanırsa abonelik sorgusu atlanır ve sağlanan değer sonraki etkileşim için kullanılır.

--dtmi --model-id -m

Digital Twins model kimliği. Örnek: dtmi:com:example:Room;2.

İ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 Policy 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

--resource-group -g

Digital Twins örneği kaynak grubu. az configure --defaults group={name}kullanarak varsayılan grubu yapılandırabilirsiniz.

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 dt model delete-all

Digital Twins örneği içindeki tüm modelleri silin.

İkiz yapılandırmaları etkilenmez ancak model tanımları olmadan bozulabilir.

az dt model delete-all --dt-name --dtn
                       [--acquire-policy-token]
                       [--change-reference]
                       [--resource-group]
                       [--yes]

Örnekler

Tüm modelleri silin.

az dt model delete-all -n {instance_or_hostname}

Gerekli Parametreler

--dt-name --dtn -n

Digital Twins örneği adı veya konak adı. Bir örnek adı sağlanırsa, hedef örneğin konak adını alması için önce kullanıcı aboneliği sorgulanır. Bir konak adı sağlanırsa abonelik sorgusu atlanır ve sağlanan değer sonraki etkileşim için kullanılır.

İ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 Policy 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

--resource-group -g

Digital Twins örneği kaynak grubu. az configure --defaults group={name}kullanarak varsayılan grubu yapılandırabilirsiniz.

--yes -y

Onay istemde bulunmayın.

Özellik	Değer
Default value:	False

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 dt model list

Model meta verilerini, tanımlarını ve bağımlılıklarını listeleyin.

az dt model list --dt-name --dtn
                 [--def --definition {false, true}]
                 [--dependencies-for]
                 [--resource-group]

Örnekler

Model meta verilerini listeleme

az dt model list -n {instance_or_hostname}

Model tanımlarını listeleme

az dt model list -n {instance_or_hostname} --definition

Önceden var olan belirli modellerin bağımlılıklarını listeleyin. Boşluk, dtmi değerlerini ayırır.

az dt model list -n {instance_or_hostname} --dependencies-for {model_id0} {model_id1}

Gerekli Parametreler

--dt-name --dtn -n

Digital Twins örneği adı veya konak adı. Bir örnek adı sağlanırsa, hedef örneğin konak adını alması için önce kullanıcı aboneliği sorgulanır. Bir konak adı sağlanırsa abonelik sorgusu atlanır ve sağlanan değer sonraki etkileşim için kullanılır.

İ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.

--def --definition

İşlem model tanımını alır.

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

--dependencies-for

Bağımlılıklarının alınacağı model kümesi. Atlanırsa, tüm modeller alınır. Biçim, boşlukla ayrılmış bir listedir.

--resource-group -g

Digital Twins örneği kaynak grubu. az configure --defaults group={name}kullanarak varsayılan grubu yapılandırabilirsiniz.

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 dt model show

Bir hedef model veya model tanımı alın.

az dt model show --dt-name --dtn
                 --dtmi --model-id
                 [--def --definition {false, true}]
                 [--resource-group]

Örnekler

Model meta verilerini göster

az dt model show -n {instance_or_hostname} --dtmi "dtmi:com:example:Floor;1"

Model meta verilerini ve tanımını gösterme

az dt model show -n {instance_or_hostname} --dtmi "dtmi:com:example:Floor;1" --definition

Gerekli Parametreler

--dt-name --dtn -n

Digital Twins örneği adı veya konak adı. Bir örnek adı sağlanırsa, hedef örneğin konak adını alması için önce kullanıcı aboneliği sorgulanır. Bir konak adı sağlanırsa abonelik sorgusu atlanır ve sağlanan değer sonraki etkileşim için kullanılır.

--dtmi --model-id -m

Digital Twins model kimliği. Örnek: dtmi:com:example:Room;2.

İ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.

--def --definition

İşlem model tanımını alır.

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

--resource-group -g

Digital Twins örneği kaynak grubu. az configure --defaults group={name}kullanarak varsayılan grubu yapılandırabilirsiniz.

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 dt model update

Modelin meta verilerini güncelleştirir. Şu anda bir model yalnızca kullanımdan kaldırılabilir.

az dt model update --dt-name --dtn
                   --dtmi --model-id
                   [--acquire-policy-token]
                   [--change-reference]
                   [--decommission {false, true}]
                   [--resource-group]

Örnekler

Hedef modelin kullanımdan kaldırılması

az dt model update -n {instance_or_hostname} --dtmi "dtmi:com:example:Floor;1" --decommission

Gerekli Parametreler

--dt-name --dtn -n

Digital Twins örneği adı veya konak adı. Bir örnek adı sağlanırsa, hedef örneğin konak adını alması için önce kullanıcı aboneliği sorgulanır. Bir konak adı sağlanırsa abonelik sorgusu atlanır ve sağlanan değer sonraki etkileşim için kullanılır.

--dtmi --model-id -m

Digital Twins model kimliği. Örnek: dtmi:com:example:Room;2.

İ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 Policy 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

--decommission

Hedef modelin yetkisini alma amacını gösterir.

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

--resource-group -g

Digital Twins örneği kaynak grubu. az configure --defaults group={name}kullanarak varsayılan grubu yapılandırabilirsiniz.

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