Gambaran umum: Terminologi Azure CLI dan tingkat dukungan
Artikel ini menjelaskan terminologi Azure CLI. Terdapat komponen sintaks, jenis referensi, dan status. ini adalah status yang menentukan tingkat dukungan.
Komponen sintaks Azure CLI
Sintaks Azure CLI adalah kombinasi grup, referensi, perintah, dan parameter. Perintah referensi lengkap sering kali disebut sebagai perintah.
| Layanan Azure | Grup Referensi | Subgrup referensi | Perintah | Perintah referensi lengkap | Contoh Parameter |
|---|---|---|---|---|---|
| Azure CLI | az config | az config | --local, --output -o | ||
| Azure Network | az network | application-gateway | buat | az network application-gateway create | --name, --resource-group, --capacity |
| Azure DevOps | az pipelines | agen | list | az pipelines agent list | --pool-id, --agent-name, --demands |
Subgrup referensi dapat memiliki beberapa tingkat seperti az network application-gateway private-link ip-config add
| Grup Referensi | Subgrup 1 | Subgrup 2 | Subgrup 3 | Perintah |
|---|---|---|---|---|
| jaringan | application-gateway | private-link | ip-config | $add |
Lihat Daftar referensi A ke Z untuk daftar lengkap perintah referensi.
Apa yang dimaksud dengan jenis referensi?
Perintah Azure CLI adalah bagian dari layanan Azure CLI inti , atau merupakan ekstensi. Ekstensi adalah add-on opsional. Jenis referensi menentukan jadwal rilis, status, dan metode penginstalan seperti yang dijelaskan di sini:
| Istilah | Core | Extensi |
|---|---|---|
| Referensi | Merupakan bagian dari layanan utama Azure CLI | Berupa perintah referensi opsional yang harus diinstal |
| Instal | Bersama dengan alat penginstal MSI | Secara individual dengan az extension add |
| Dirilis | Sesuai jadwal | Saat fitur atau pembaruan baru tersedia |
| Status | Bisa berupa GA (Tersedia Umum), pratinjau atau percobaan | Juga bisa berupa GA, pratinjau atau percobaan |
Untuk mendapatkan daftar grup perintah, jalankan az. Untuk daftar ekstensi, gunakan perintah az extension list-available --output table.
# Get list of all command groups
az
# Get list of extensions
az extension list-available --output table
Core
Referensi Azure CLI yang telah diterbitkan sebagai bagian permanen dari CLI disebut referensi inti. Semua referensi inti diinstal dengan Azure CLI dan Anda tidak dapat memilih subset referensi. Jika Anda menjalankan CLI melalui Azure Cloud Shell, referensi inti selalu diperbarui.
Extensi
Ekstensi tidak dikirim sebagai bagian dari CLI, tetapi dijalankan sebagai perintah CLI. Beberapa ekstensi adalah bagian permanen dari Azure CLI, tetapi seringkali, ekstensi memberi Anda akses ke pratinjau dan perintah eksperimental. Referensi tunggal, seperti az iot hub, dapat memiliki perintah inti dan ekstensi. Berikut dua contohnya:
| Perintah referensi lengkap | Berupa Inti | Berupa ekstensi |
|---|---|---|
| az iot hub list | ya | |
| az iot hub job list | ya |
Anda diminta untuk menginstal ekstensi saat pertama kali digunakan. Anda juga dapat menginstal ekstensi dengan menjalankan perintah az extension add.
Anda dapat mempelajari referensi ekstensi lebih lanjut termasuk penginstalan dan pembaruan di Menggunakan ekstensi dengan Azure CLI. Lihat Ekstensi yang tersedia untuk Azure CLI untuk mengetahui daftar lengkap perintah referensi ekstensi.
Apa itu status referensi?
Terlepas dari jenis referensinya, referensi Azure CLI memiliki tiga kategori status: GA (Tersedia Umum), pratinjau publik, atau percobaan. Ini adalah status perintah referensi (bukan jenis) yang menentukan stabilitas dan tingkat dukungan.
| GA | Pratinjau umum | Eksperimental | |
|---|---|---|---|
| Stabilitas | Permanen | Dapat berubah sebagai respons terhadap tanggapan pelanggan. Tunduk pada ketentuan Pratinjau Microsoft Azure. | Dapat berubah sebagai respons terhadap tanggapan pelanggan. Sering kali bermigrasi ke pratinjau publik. Dapat dihapus. |
| Tingkat dukungan | Data | Sebagian | Tidak ada |
Catatan
Peringatan yang menunjukkan pratinjau umum atau percobaan adalah bagian dari output perintah Azure CLI dan harus dipertimbangkan.
Sebagian besar perintah dan parameter untuk satu referensi memiliki satu status, tetapi tidak selalu. Referensi GA yang dibangun untuk menawarkan lebih banyak perintah bisa memiliki perintah referensi GA, pratinjau, dan percobaan. Karena parameter baru ditambahkan untuk meningkatkan fungsionalitas, satu perintah juga bisa memiliki beberapa parameter yang termasuk dalam kategori status lainnya. Berikut beberapa contoh referensi dengan status yang berbeda:
| Perintah referensi lengkap | Parameter | Jenis | GA | Pratinjau umum | Eksperimental |
|---|---|---|---|---|---|
| az network dns zone list | Semua | Core | ya | ||
| buat zona dns jaringan az | --name, --resource-group, --if-none-match, --parent-name | Core | ya | ||
| --newFutureParameter1 | Core | ya | |||
| --newFutureParameter2 | Core | ya | |||
| az network vhub list | Semua | Extensi | ya | ||
| az network vhub create | --address-prefix, --name, --resource-group, -vwan, --location, --sku | Extensi | ya | ||
| --newFutureParameter1 | Extensi | ya | |||
| --newFutureParameter2 | Extensi | ya | |||
| az network firewall create | Semua | Extensi | ya |
Tabel di atas hanya sebagai contoh dan tidak mewakili status referensi saat ini untuk perintah.