az dt model

Note

Referensi ini adalah bagian dari ekstensi azure-iot untuk Azure CLI (versi 2.67.0 atau yang lebih tinggi). Ekstensi akan secara otomatis menginstal pertama kali Anda menjalankan perintah model az dt. Pelajari selengkapnya 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.	Extension	GA
az dt model delete	Menghapus model. Model hanya dapat dihapus jika tidak ada model lain yang mereferensikannya.	Extension	GA
az dt model delete-all	Hapus semua model dalam instans Digital Twins.	Extension	GA
az dt model list	Mencantumkan metadata model, definisi, dan dependensi.	Extension	GA
az dt model show	Mengambil model target atau definisi model.	Extension	GA
az dt model update	Memperbarui metadata untuk model. Saat ini model hanya dapat dinonaktifkan.	Extension	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 --dtn
                   [--failure-policy --fp {None, Rollback}]
                   [--fd --from-directory]
                   [--max-models-per-batch --mmpb]
                   [--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

Parameter berikut bersifat opsional, tetapi tergantung pada konteksnya, satu atau beberapa mungkin menjadi diperlukan agar perintah berhasil dijalankan.

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

Properti	Nilai
Grup parameter:	Models Input Arguments
Nilai default:	Rollback
Nilai yang diterima:	None, 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.

Properti	Nilai
Grup parameter:	Models Input Arguments

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

Eksperimental

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

Properti	Nilai
Grup parameter:	Models Input Arguments
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.

Properti	Nilai
Grup parameter:	Models Input Arguments

--resource-group -g

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

Parameter Global

--debug

Tingkatkan verbositas pengelogan untuk menampilkan semua log debug.

Properti	Nilai
Nilai default:	False

--help -h

Tampilkan pesan bantuan ini dan keluar.

--only-show-errors

Hanya tampilkan kesalahan, menekan peringatan.

Properti	Nilai
Nilai default:	False

--output -o

Format output.

Properti	Nilai
Nilai default:	json
Nilai yang diterima:	json, jsonc, none, table, tsv, yaml, yamlc

--query

String kueri JMESPath. Lihat http://jmespath.org/ untuk informasi dan contoh selengkapnya.

--subscription

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

--verbose

Tingkatkan verbositas pengelogan. Gunakan --debug untuk log debug penuh.

Properti	Nilai
Nilai default:	False

az dt model delete

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

az dt model delete --dt-name --dtn
                   --dtmi --model-id
                   [--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

Parameter berikut bersifat opsional, tetapi tergantung pada konteksnya, satu atau beberapa mungkin menjadi diperlukan agar perintah berhasil dijalankan.

--resource-group -g

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

Parameter Global

--debug

Tingkatkan verbositas pengelogan untuk menampilkan semua log debug.

Properti	Nilai
Nilai default:	False

--help -h

Tampilkan pesan bantuan ini dan keluar.

--only-show-errors

Hanya tampilkan kesalahan, menekan peringatan.

Properti	Nilai
Nilai default:	False

--output -o

Format output.

Properti	Nilai
Nilai default:	json
Nilai yang diterima:	json, jsonc, none, table, tsv, yaml, yamlc

--query

String kueri JMESPath. Lihat http://jmespath.org/ untuk informasi dan contoh selengkapnya.

--subscription

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

--verbose

Tingkatkan verbositas pengelogan. Gunakan --debug untuk log debug penuh.

Properti	Nilai
Nilai default:	False

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

Parameter berikut bersifat opsional, tetapi tergantung pada konteksnya, satu atau beberapa mungkin menjadi diperlukan agar perintah berhasil dijalankan.

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

Properti	Nilai
Nilai default:	False

Parameter Global

--debug

Tingkatkan verbositas pengelogan untuk menampilkan semua log debug.

Properti	Nilai
Nilai default:	False

--help -h

Tampilkan pesan bantuan ini dan keluar.

--only-show-errors

Hanya tampilkan kesalahan, menekan peringatan.

Properti	Nilai
Nilai default:	False

--output -o

Format output.

Properti	Nilai
Nilai default:	json
Nilai yang diterima:	json, jsonc, none, table, tsv, yaml, yamlc

--query

String kueri JMESPath. Lihat http://jmespath.org/ untuk informasi dan contoh selengkapnya.

--subscription

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

--verbose

Tingkatkan verbositas pengelogan. Gunakan --debug untuk log debug penuh.

Properti	Nilai
Nilai default:	False

az dt model list

Mencantumkan metadata model, definisi, dan dependensi.

az dt model list --dt-name --dtn
                 [--def --definition {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

Parameter berikut bersifat opsional, tetapi tergantung pada konteksnya, satu atau beberapa mungkin menjadi diperlukan agar perintah berhasil dijalankan.

--def --definition

Operasi akan mengambil definisi model.

Properti	Nilai
Nilai default:	False
Nilai yang diterima:	false, true

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

Tingkatkan verbositas pengelogan untuk menampilkan semua log debug.

Properti	Nilai
Nilai default:	False

--help -h

Tampilkan pesan bantuan ini dan keluar.

--only-show-errors

Hanya tampilkan kesalahan, menekan peringatan.

Properti	Nilai
Nilai default:	False

--output -o

Format output.

Properti	Nilai
Nilai default:	json
Nilai yang diterima:	json, jsonc, none, table, tsv, yaml, yamlc

--query

String kueri JMESPath. Lihat http://jmespath.org/ untuk informasi dan contoh selengkapnya.

--subscription

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

--verbose

Tingkatkan verbositas pengelogan. Gunakan --debug untuk log debug penuh.

Properti	Nilai
Nilai default:	False

az dt model show

Mengambil model target atau definisi model.

az dt model show --dt-name --dtn
                 --dtmi --model-id
                 [--def --definition {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

Parameter berikut bersifat opsional, tetapi tergantung pada konteksnya, satu atau beberapa mungkin menjadi diperlukan agar perintah berhasil dijalankan.

--def --definition

Operasi akan mengambil definisi model.

Properti	Nilai
Nilai default:	False
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

Tingkatkan verbositas pengelogan untuk menampilkan semua log debug.

Properti	Nilai
Nilai default:	False

--help -h

Tampilkan pesan bantuan ini dan keluar.

--only-show-errors

Hanya tampilkan kesalahan, menekan peringatan.

Properti	Nilai
Nilai default:	False

--output -o

Format output.

Properti	Nilai
Nilai default:	json
Nilai yang diterima:	json, jsonc, none, table, tsv, yaml, yamlc

--query

String kueri JMESPath. Lihat http://jmespath.org/ untuk informasi dan contoh selengkapnya.

--subscription

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

--verbose

Tingkatkan verbositas pengelogan. Gunakan --debug untuk log debug penuh.

Properti	Nilai
Nilai default:	False

az dt model update

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

az dt model update --dt-name --dtn
                   --dtmi --model-id
                   [--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

Parameter berikut bersifat opsional, tetapi tergantung pada konteksnya, satu atau beberapa mungkin menjadi diperlukan agar perintah berhasil dijalankan.

--decommission

Menunjukkan niat untuk menonaktifkan model target.

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

Tingkatkan verbositas pengelogan untuk menampilkan semua log debug.

Properti	Nilai
Nilai default:	False

--help -h

Tampilkan pesan bantuan ini dan keluar.

--only-show-errors

Hanya tampilkan kesalahan, menekan peringatan.

Properti	Nilai
Nilai default:	False

--output -o

Format output.

Properti	Nilai
Nilai default:	json
Nilai yang diterima:	json, jsonc, none, table, tsv, yaml, yamlc

--query

String kueri JMESPath. Lihat http://jmespath.org/ untuk informasi dan contoh selengkapnya.

--subscription

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

--verbose

Tingkatkan verbositas pengelogan. Gunakan --debug untuk log debug penuh.

Properti	Nilai
Nilai default:	False