az dt twin relationship

  • Referensi

Catatan

Referensi ini adalah bagian dari ekstensi azure-iot untuk Azure CLI (versi 2.37.0 atau yang lebih tinggi). Ekstensi akan secara otomatis menginstal pertama kali Anda menjalankan perintah hubungan kembar az dt. Pelajari lebih lanjut tentang ekstensi.

Mengelola dan mengonfigurasi hubungan kembar digital instans Digital Twins.

Perintah

Nama Deskripsi Jenis Status
az dt twin relationship create

Buat hubungan antara kembar digital sumber dan target.

 Ekstensi GA
az dt twin relationship delete

Menghapus hubungan kembar digital pada instans Digital Twins.

 Ekstensi GA
az dt twin relationship delete-all

Menghapus semua hubungan kembar digital dalam instans Digital Twins, termasuk hubungan masuk.

 Ekstensi GA
az dt twin relationship list

Mencantumkan hubungan kembar digital.

 Ekstensi GA
az dt twin relationship show

Memperlihatkan detail hubungan kembar digital.

 Ekstensi GA
az dt twin relationship update

Memperbarui properti hubungan antara dua kembar digital melalui spesifikasi patch JSON.

 Ekstensi GA

az dt twin relationship create

Buat hubungan antara kembar digital sumber dan target.

--properties dapat berupa JSON sebaris atau jalur file.

az dt twin relationship create --dt-name
                               --kind
                               --relationship-id
                               --source
                               --target
                               [--if-none-match]
                               [--properties]
                               [--resource-group]

Contoh

Buat hubungan antara dua kembar digital.

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

Membuat hubungan antara dua kembar digital dengan tag if-none-match

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

Buat hubungan dengan properti yang diinisialisasi antara dua kembar digital.

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"}'

Parameter yang Diperlukan

--dt-name --dtn -n

Nama instans digital Twins atau nama host. Jika nama instans disediakan, langganan pengguna pertama kali dikueri agar instans target mengambil nama host. Jika nama host disediakan, kueri langganan dilewati dan nilai yang disediakan digunakan untuk interaksi berikutnya.

--kind --relationship

Nama atau jenis hubungan. Misalnya: 'contains'.

--relationship-id -r

Id Hubungan.

--source --twin-id -t

Id kembar sumber untuk hubungan.

--target --target-twin-id

Id kembar target untuk hubungan.

Parameter Opsional

--if-none-match

Menunjukkan operasi buat harus gagal jika ada kembar dengan id yang sama.

nilai default: False
--properties -p

Nilai properti awal untuk membuat instans hubungan kembar digital. Sediakan jalur file atau JSON sebaris.

--resource-group -g

Grup sumber daya instans Digital Twins. Anda dapat mengonfigurasi grup default menggunakan az configure --defaults group=<name>.

Parameter Global
--debug

Meningkatkan verbositas pengelogan untuk menampilkan semua log debug.

--help -h

Menampilkan pesan bantuan ini dan keluar.

--only-show-errors

Hanya menampilkan kesalahan, menyembunyikan peringatan.

--output -o

Format output.

nilai yang diterima: json, jsonc, none, table, tsv, yaml, yamlc
nilai default: json
--query

String kueri JMESPath. Lihat http://jmespath.org/ untuk informasi selengkapnya beserta contohnya.

--subscription

Nama atau ID langganan. Anda dapat mengonfigurasi langganan default menggunakan az account set -s NAME_OR_ID.

--verbose

Meningkatkan verbositas pengelogan. Gunakan --debug untuk log waktu lengkap.

az dt twin relationship delete

Menghapus hubungan kembar digital pada instans Digital Twins.

az dt twin relationship delete --dt-name
                               --relationship-id
                               --source
                               [--etag]
                               [--resource-group]

Contoh

Menghapus hubungan kembar digital.

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

Menghapus hubungan kembar digital menggunakan etag.

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

Parameter yang Diperlukan

--dt-name --dtn -n

Nama instans digital Twins atau nama host. Jika nama instans disediakan, langganan pengguna pertama kali dikueri agar instans target mengambil nama host. Jika nama host disediakan, kueri langganan dilewati dan nilai yang disediakan digunakan untuk interaksi berikutnya.

--relationship-id -r

Id Hubungan.

--source --twin-id -t

Id kembar sumber untuk hubungan.

Parameter Opsional

--etag -e

Nilai tag entitas. Perintah akan berhasil jika etag cocok dengan etag saat ini untuk sumber daya.

--resource-group -g

Grup sumber daya instans Digital Twins. Anda dapat mengonfigurasi grup default menggunakan az configure --defaults group=<name>.

Parameter Global
--debug

Meningkatkan verbositas pengelogan untuk menampilkan semua log debug.

--help -h

Menampilkan pesan bantuan ini dan keluar.

--only-show-errors

Hanya menampilkan kesalahan, menyembunyikan peringatan.

--output -o

Format output.

nilai yang diterima: json, jsonc, none, table, tsv, yaml, yamlc
nilai default: json
--query

String kueri JMESPath. Lihat http://jmespath.org/ untuk informasi selengkapnya beserta contohnya.

--subscription

Nama atau ID langganan. Anda dapat mengonfigurasi langganan default menggunakan az account set -s NAME_OR_ID.

--verbose

Meningkatkan verbositas pengelogan. Gunakan --debug untuk log waktu lengkap.

az dt twin relationship delete-all

Menghapus semua hubungan kembar digital dalam instans Digital Twins, termasuk hubungan masuk.

az dt twin relationship delete-all --dt-name
                                   [--resource-group]
                                   [--source]
                                   [--yes]

Contoh

Hapus semua hubungan kembar digital yang terkait dengan kembar.

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

Hapus semua hubungan kembar digital dalam instace Digital Twins.

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

Parameter yang Diperlukan

--dt-name --dtn -n

Nama instans digital Twins atau nama host. Jika nama instans disediakan, langganan pengguna pertama kali dikueri agar instans target mengambil nama host. Jika nama host disediakan, kueri langganan dilewati dan nilai yang disediakan digunakan untuk interaksi berikutnya.

Parameter Opsional

--resource-group -g

Grup sumber daya instans Digital Twins. Anda dapat mengonfigurasi grup default menggunakan az configure --defaults group=<name>.

--source --twin-id -t

Id kembar sumber untuk hubungan.

--yes -y

Jangan meminta konfirmasi.

nilai default: False
Parameter Global
--debug

Meningkatkan verbositas pengelogan untuk menampilkan semua log debug.

--help -h

Menampilkan pesan bantuan ini dan keluar.

--only-show-errors

Hanya menampilkan kesalahan, menyembunyikan peringatan.

--output -o

Format output.

nilai yang diterima: json, jsonc, none, table, tsv, yaml, yamlc
nilai default: json
--query

String kueri JMESPath. Lihat http://jmespath.org/ untuk informasi selengkapnya beserta contohnya.

--subscription

Nama atau ID langganan. Anda dapat mengonfigurasi langganan default menggunakan az account set -s NAME_OR_ID.

--verbose

Meningkatkan verbositas pengelogan. Gunakan --debug untuk log waktu lengkap.

az dt twin relationship list

Mencantumkan hubungan kembar digital.

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

Contoh

Mencantumkan hubungan keluar dari kembar digital.

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

Mencantumkan hubungan keluar dari kembar digital dan filter pada hubungan 'contains'

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

Mencantumkan hubungan masuk dari kembar digital.

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

Cantumkan hubungan masuk kembar digital dan filter pada hubungan 'contains'.

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

Parameter yang Diperlukan

--dt-name --dtn -n

Nama instans digital Twins atau nama host. Jika nama instans disediakan, langganan pengguna pertama kali dikueri agar instans target mengambil nama host. Jika nama host disediakan, kueri langganan dilewati dan nilai yang disediakan digunakan untuk interaksi berikutnya.

--source --twin-id -t

Id kembar sumber untuk hubungan.

Parameter Opsional

--incoming

Mengambil semua hubungan masuk untuk kembar digital.

nilai yang diterima: false, true
nilai default: False
--kind --relationship

Memfilter hasil berdasarkan jenis hubungan.

--resource-group -g

Grup sumber daya instans Digital Twins. Anda dapat mengonfigurasi grup default menggunakan az configure --defaults group=<name>.

Parameter Global
--debug

Meningkatkan verbositas pengelogan untuk menampilkan semua log debug.

--help -h

Menampilkan pesan bantuan ini dan keluar.

--only-show-errors

Hanya menampilkan kesalahan, menyembunyikan peringatan.

--output -o

Format output.

nilai yang diterima: json, jsonc, none, table, tsv, yaml, yamlc
nilai default: json
--query

String kueri JMESPath. Lihat http://jmespath.org/ untuk informasi selengkapnya beserta contohnya.

--subscription

Nama atau ID langganan. Anda dapat mengonfigurasi langganan default menggunakan az account set -s NAME_OR_ID.

--verbose

Meningkatkan verbositas pengelogan. Gunakan --debug untuk log waktu lengkap.

az dt twin relationship show

Memperlihatkan detail hubungan kembar digital.

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

Contoh

Memperlihatkan detail hubungan kembar digital.

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

Parameter yang Diperlukan

--dt-name --dtn -n

Nama instans digital Twins atau nama host. Jika nama instans disediakan, langganan pengguna pertama kali dikueri agar instans target mengambil nama host. Jika nama host disediakan, kueri langganan dilewati dan nilai yang disediakan digunakan untuk interaksi berikutnya.

--relationship-id -r

Id Hubungan.

--source --twin-id -t

Id kembar sumber untuk hubungan.

Parameter Opsional

--resource-group -g

Grup sumber daya instans Digital Twins. Anda dapat mengonfigurasi grup default menggunakan az configure --defaults group=<name>.

Parameter Global
--debug

Meningkatkan verbositas pengelogan untuk menampilkan semua log debug.

--help -h

Menampilkan pesan bantuan ini dan keluar.

--only-show-errors

Hanya menampilkan kesalahan, menyembunyikan peringatan.

--output -o

Format output.

nilai yang diterima: json, jsonc, none, table, tsv, yaml, yamlc
nilai default: json
--query

String kueri JMESPath. Lihat http://jmespath.org/ untuk informasi selengkapnya beserta contohnya.

--subscription

Nama atau ID langganan. Anda dapat mengonfigurasi langganan default menggunakan az account set -s NAME_OR_ID.

--verbose

Meningkatkan verbositas pengelogan. Gunakan --debug untuk log waktu lengkap.

az dt twin relationship update

Memperbarui properti hubungan antara dua kembar digital melalui spesifikasi patch JSON.

Operasi dibatasi untuk menambahkan, mengganti, dan menghapus.

az dt twin relationship update --dt-name
                               --json-patch
                               --relationship-id
                               --source
                               [--etag]
                               [--resource-group]

Contoh

Perbarui hubungan kembar digital melalui spesifikasi patch JSON.

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

Perbarui hubungan kembar digital melalui spesifikasi patch JSON dan menggunakan etag.

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}

Perbarui hubungan kembar digital melalui spesifikasi patch JSON.

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

Perbarui hubungan kembar digital melalui spesifikasi patch JSON yang ditentukan dalam file.

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

Parameter yang Diperlukan

--dt-name --dtn -n

Nama instans digital Twins atau nama host. Jika nama instans disediakan, langganan pengguna pertama kali dikueri agar instans target mengambil nama host. Jika nama host disediakan, kueri langganan dilewati dan nilai yang disediakan digunakan untuk interaksi berikutnya.

--json-patch --patch

Spesifikasi pembaruan yang dijelaskan oleh JSON-patch. Pembaruan pada nilai properti dan elemen $model mungkin terjadi dalam permintaan yang sama. Operasi dibatasi untuk menambahkan, mengganti, dan menghapus. Sediakan jalur file atau JSON sebaris.

--relationship-id -r

Id Hubungan.

--source --twin-id -t

Id kembar sumber untuk hubungan.

Parameter Opsional

--etag -e

Nilai tag entitas. Perintah akan berhasil jika etag cocok dengan etag saat ini untuk sumber daya.

--resource-group -g

Grup sumber daya instans Digital Twins. Anda dapat mengonfigurasi grup default menggunakan az configure --defaults group=<name>.

Parameter Global
--debug

Meningkatkan verbositas pengelogan untuk menampilkan semua log debug.

--help -h

Menampilkan pesan bantuan ini dan keluar.

--only-show-errors

Hanya menampilkan kesalahan, menyembunyikan peringatan.

--output -o

Format output.

nilai yang diterima: json, jsonc, none, table, tsv, yaml, yamlc
nilai default: json
--query

String kueri JMESPath. Lihat http://jmespath.org/ untuk informasi selengkapnya beserta contohnya.

--subscription

Nama atau ID langganan. Anda dapat mengonfigurasi langganan default menggunakan az account set -s NAME_OR_ID.

--verbose

Meningkatkan verbositas pengelogan. Gunakan --debug untuk log waktu lengkap.