az dt model

  • 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 model az dt. Pelajari lebih lanjut tentang ekstensi.

Mengelola model dan definisi DTDL pada instans Digital Twins.

Perintah

Nama Deskripsi Jenis Status
az dt model create

Mengunggah satu atau beberapa model.

 Ekstensi GA
az dt model delete

Menghapus model. Model hanya dapat dihapus jika tidak ada model lain yang mereferensikannya.

 Ekstensi GA
az dt model delete-all

Hapus semua model dalam instans Digital Twins.

 Ekstensi GA
az dt model list

Mencantumkan metadata model, definisi, dan dependensi.

 Ekstensi GA
az dt model show

Mengambil model target atau definisi model.

 Ekstensi GA
az dt model update

Memperbarui metadata untuk model. Saat ini model hanya dapat dinonaktifkan.

 Ekstensi GA

az dt model create

Mengunggah satu atau beberapa model.

--model dapat berupa json sebaris atau jalur file. Ukuran set model input (ontologi) dibatasi oleh jumlah maksimum model yang dapat disimpan instans DT (defaultnya adalah 10000 model).

az dt model create --dt-name
                   [--failure-policy {None, Rollback}]
                   [--fd]
                   [--max-models-per-batch]
                   [--models]
                   [--resource-group]

Contoh

Unggah semua file model .json atau .dtdl secara massal dari direktori target. Pemrosesan model bersifat rekursif.

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

Unggah model json sebaris atau dari jalur file.

az dt model create -n {instance_or_hostname} --models {file_path_or_inline_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.

Parameter Opsional

--failure-policy --fp

Menunjukkan kebijakan kegagalan ketika kesalahan terjadi saat memproses batch model. Dalam mode 'Putar Kembali' semua model yang dibuat dalam batch sebelumnya dihapus satu per satu. Saat dipilih sebagai 'Tidak Ada' model yang dibuat dalam batch sebelumnya tidak dihapus dari instans DT.

nilai yang diterima: None, Rollback
nilai default: Rollback
--fd --from-directory

File model JSON direktori akan diurai. Harap Dicatat: Model dibuat secara atomik ketika direktori berisi 250 model atau lebih rendah, karenanya jika terjadi kesalahan, tidak ada model yang dibuat. Set model input dipotong & dibuat dalam batch ketika direktori memiliki lebih dari 250 model (batas API). Jika terjadi kesalahan saat memproses batch, perilaku ditentukan oleh parameter --failure-policy.

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

Ukuran model maksimum per batch saat membuat lebih dari 250 model. Kurangi angka ini untuk mencegah kesalahan DTDLParser.

nilai default: 30
--models

JSON model sebaris atau jalur file ke model JSON. Harap Dicatat: Model dibuat secara atomik ketika model JSON berisi 250 model atau lebih rendah, karenanya jika terjadi kesalahan, tidak ada model yang dibuat. Set model input dipotong & dibuat dalam batch ketika model JSON memiliki lebih dari 250 model (batas API). Jika terjadi kesalahan saat memproses batch, perilaku ditentukan oleh parameter --failure-policy.

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

Menghapus model. Model hanya dapat dihapus jika tidak ada model lain yang mereferensikannya.

az dt model delete --dt-name
                   --dtmi
                   [--resource-group]

Contoh

Menghapus model target.

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

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.

--dtmi --model-id -m

Id model Digital Twins. Contoh: dtmi:com:example:Room;2.

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

Hapus semua model dalam instans Digital Twins.

Konfigurasi kembar tidak terpengaruh tetapi mungkin rusak tanpa definisi model.

az dt model delete-all --dt-name
                       [--resource-group]
                       [--yes]

Contoh

Hapus semua model.

az dt model 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>.

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

Mencantumkan metadata model, definisi, dan dependensi.

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

Contoh

Mencantumkan metadata model

az dt model list -n {instance_or_hostname}

Mencantumkan definisi model

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

Mencantumkan dependensi dari model tertentu yang sudah ada sebelumnya. Spasi memisahkan nilai dtmi.

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

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

--def --definition

Operasi akan mengambil definisi model.

nilai yang diterima: false, true
nilai default: False
--dependencies-for

Sekumpulan model yang akan mengambil dependensinya. Jika dihilangkan, semua model diambil. Format adalah daftar spasi kosong yang dipisahkan.

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

Mengambil model target atau definisi model.

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

Contoh

Perlihatkan data meta model

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

Tampilkan data dan definisi meta model

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

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.

--dtmi --model-id -m

Id model Digital Twins. Contoh: dtmi:com:example:Room;2.

Parameter Opsional

--def --definition

Operasi akan mengambil definisi model.

nilai yang diterima: false, true
nilai default: False
--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 model update

Memperbarui metadata untuk model. Saat ini model hanya dapat dinonaktifkan.

az dt model update --dt-name
                   --dtmi
                   [--decommission {false, true}]
                   [--resource-group]

Contoh

Menonaktifkan model target

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

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.

--dtmi --model-id -m

Id model Digital Twins. Contoh: dtmi:com:example:Room;2.

Parameter Opsional

--decommission

Menunjukkan niat untuk menonaktifkan model target.

nilai yang diterima: false, true
--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.