az dt twin relationship

Note

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

Digital Twins örneğinin dijital ikiz ilişkilerini yönetin ve yapılandırın.

Komutlar

Veri Akışı Adı	Description	Tür	Durum
az dt twin relationship create	Kaynak ve hedef dijital ikizler arasında bir ilişki oluşturun.	Extension	GA
az dt twin relationship delete	Digital Twins örneğindeki dijital ikiz ilişkisini silme.	Extension	GA
az dt twin relationship delete-all	Gelen ilişkiler de dahil olmak üzere bir Digital Twins örneği içindeki tüm dijital ikiz ilişkilerini siler.	Extension	GA
az dt twin relationship list	Dijital ikizin ilişkilerini listeleme.	Extension	GA
az dt twin relationship show	Dijital ikiz ilişkisinin ayrıntılarını gösterir.	Extension	GA
az dt twin relationship update	JSON düzeltme eki belirtimi aracılığıyla iki dijital ikiz arasındaki ilişkinin özelliklerini güncelleştirir.	Extension	GA

az dt twin relationship create

Kaynak ve hedef dijital ikizler arasında bir ilişki oluşturun.

--properties satır içi JSON veya dosya yolu olabilir.

az dt twin relationship create --dt-name --dtn
                               --kind --relationship
                               --relationship-id
                               --source --twin-id
                               --target --target-twin-id
                               [--acquire-policy-token]
                               [--change-reference]
                               [--if-none-match]
                               [--properties]
                               [--resource-group]

Örnekler

İki dijital ikiz arasında bir ilişki oluşturun.

az dt twin relationship create -n {instance_or_hostname} --relationship-id {relationship_id} --relationship contains --twin-id {source_twin_id} --target {target_twin_id}

Eşleşmiyorsa etiketiyle iki dijital ikiz arasında ilişki oluşturma

az dt twin relationship create -n {instance_or_hostname} --relationship-id {relationship_id} --relationship contains --twin-id {source_twin_id} --target {target_twin_id} --if-none-match

İki dijital ikiz arasında başlatılan özelliklerle bir ilişki oluşturun.

az dt twin relationship create -n {instance_or_hostname} --relationship-id {relationship_id} --relationship contains --twin-id {source_twin_id} --target {target_twin_id} --properties '{"ownershipUser": "me", "ownershipDepartment": "Computer Science"}'

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.

--kind --relationship

İlişki adı veya türü. Örneğin: 'contains'.

--relationship-id -r

İlişki Kimliği.

--source --twin-id -t

İlişkinin kaynak ikiz kimliği.

--target --target-twin-id

bir ilişkinin hedef ikiz kimliği.

İ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

--if-none-match

Aynı kimlikte mevcut bir ikiz varsa oluşturma işleminin başarısız olması gerektiğini gösterir.

Özellik	Değer
Default value:	False

--properties -p

Dijital ikiz ilişkisinin örneğini oluşturmak için ilk özellik değerleri. Dosya yolu veya satır içi JSON sağlayın.

--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 twin relationship delete

Digital Twins örneğindeki dijital ikiz ilişkisini silme.

az dt twin relationship delete --dt-name --dtn
                               --relationship-id
                               --source --twin-id
                               [--acquire-policy-token]
                               [--change-reference]
                               [--etag]
                               [--resource-group]

Örnekler

Dijital ikiz ilişkisini silme.

az dt twin relationship delete -n {instance_or_hostname} --twin-id {twin_id} --relationship-id {relationship_id}

Etag'i kullanarak dijital ikiz ilişkisini silin.

az dt twin relationship delete -n {instance_or_hostname} --twin-id {twin_id} --relationship-id {relationship_id} --etag {etag}

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.

--relationship-id -r

İlişki Kimliği.

--source --twin-id -t

İlişkinin kaynak ikiz kimliği.

İ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

--etag -e

Varlık etiketi değeri. Etag kaynağın geçerli etag'iyle eşleşirse komut başarılı olur.

--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 twin relationship delete-all

Gelen ilişkiler de dahil olmak üzere bir Digital Twins örneği içindeki tüm dijital ikiz ilişkilerini siler.

az dt twin relationship delete-all --dt-name --dtn
                                   [--acquire-policy-token]
                                   [--change-reference]
                                   [--resource-group]
                                   [--source --twin-id]
                                   [--yes]

Örnekler

İkizle ilişkili tüm dijital ikiz ilişkilerini silin.

az dt twin relationship delete-all -n {instance_or_hostname} --twin-id {twin_id}

Digital Twins instace içindeki tüm dijital ikiz ilişkilerini silin.

az dt twin relationship 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 İ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

--resource-group -g

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

--source --twin-id -t

İlişkinin kaynak ikiz kimliği.

--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 twin relationship list

Dijital ikizin ilişkilerini listeleme.

az dt twin relationship list --dt-name --dtn
                             --source --twin-id
                             [--incoming {false, true}]
                             [--kind --relationship]
                             [--resource-group]

Örnekler

Dijital ikizin giden ilişkilerini listeleme.

az dt twin relationship list -n {instance_or_hostname} --twin-id {twin_id}

Dijital ikizin giden ilişkilerini listeleme ve 'contains' ilişkisine göre filtreleme

az dt twin relationship list -n {instance_or_hostname} --twin-id {twin_id} --relationship contains

Dijital ikizin gelen ilişkilerini listeleme.

az dt twin relationship list -n {instance_or_hostname} --twin-id {twin_id} --incoming

Dijital ikizin gelen ilişkilerini listeleyin ve 'contains' ilişkisine göre filtreleyin.

az dt twin relationship list -n {instance_or_hostname} --twin-id {twin_id} --relationship contains --incoming

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.

--source --twin-id -t

İlişkinin kaynak ikiz kimliği.

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

--incoming

Dijital ikiz için tüm gelen ilişkileri alır.

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

--kind --relationship

Sonucu ilişki türüne göre filtreleyin.

--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 twin relationship show

Dijital ikiz ilişkisinin ayrıntılarını gösterir.

az dt twin relationship show --dt-name --dtn
                             --relationship-id
                             --source --twin-id
                             [--resource-group]

Örnekler

Dijital ikiz ilişkisinin ayrıntılarını gösterir.

az dt twin relationship show -n {instance_or_hostname} --twin-id {twin_id} --relationship-id {relationship_id}

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.

--relationship-id -r

İlişki Kimliği.

--source --twin-id -t

İlişkinin kaynak ikiz kimliği.

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

--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 twin relationship update

JSON düzeltme eki belirtimi aracılığıyla iki dijital ikiz arasındaki ilişkinin özelliklerini güncelleştirir.

İşlemler ekleme, değiştirme ve kaldırma işlemleriyle sınırlıdır.

az dt twin relationship update --dt-name --dtn
                               --json-patch --patch
                               --relationship-id
                               --source --twin-id
                               [--acquire-policy-token]
                               [--change-reference]
                               [--etag]
                               [--resource-group]

Örnekler

JSON düzeltme eki belirtimi aracılığıyla bir dijital ikiz ilişkisini güncelleştirin.

az dt twin relationship update -n {instance_or_hostname} --twin-id {twin_id} --relationship-id {relationship_id} --relationship contains --json-patch '{"op":"replace", "path":"/Temperature", "value": 20.5}'

JSON düzeltme eki belirtimi ve etag kullanarak dijital ikiz ilişkisini güncelleştirin.

az dt twin relationship update -n {instance_or_hostname} --twin-id {twin_id} --relationship-id {relationship_id} --relationship contains --json-patch '{"op":"replace", "path":"/Temperature", "value": 20.5}' --etag {etag}

JSON düzeltme eki belirtimi aracılığıyla bir dijital ikiz ilişkisini güncelleştirin.

az dt twin relationship update -n {instance_or_hostname} --twin-id {twin_id} --relationship-id {relationship_id} --relationship contains --json-patch '[
  {"op":"replace", "path":"/Temperature", "value": 20.5},
  {"op":"add", "path":"/Areas", "value": ["ControlSystem"]}
]'

Bir dosyada tanımlanan JSON düzeltme eki belirtimi aracılığıyla dijital ikiz ilişkisini güncelleştirin.

az dt twin relationship update -n {instance_or_hostname} --twin-id {twin_id} --relationship-id {relationship_id} --relationship contains --json-patch ./my/patch/document.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.

--json-patch --patch

JSON düzeltme eki tarafından açıklanan bir güncelleştirme belirtimi. Özellik değerlerine ve $model öğelerine yönelik güncelleştirmeler aynı istekte gerçekleşebilir. İşlemler ekleme, değiştirme ve kaldırma işlemleriyle sınırlıdır. Dosya yolu veya satır içi JSON sağlayın.

--relationship-id -r

İlişki Kimliği.

--source --twin-id -t

İlişkinin kaynak ikiz kimliği.

İ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

--etag -e

Varlık etiketi değeri. Etag kaynağın geçerli etag'iyle eşleşirse komut başarılı olur.

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