Bagikan melalui

Gambaran umum: Terminologi Azure CLI dan tingkat dukungan

  • Artikel

Artikel ini menjelaskan terminologi Azure CLI. Terdapat komponen sintaks, jenis referensi, dan status.

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 tambahkan

Lihat Daftar referensi A ke Z untuk daftar lengkap perintah referensi.

Apa yang dimaksud dengan jenis referensi?

Perintah Azure CLI adalah bagian dari layanan Inti Azure CLI, atau merupakan ekstensi. Ekstensi adalah add-on opsional. Jenis referensi menentukan jadwal rilis, status, dan metode penginstalan seperti yang dijelaskan di sini:

Term Inti Ekstensi
Referensi Merupakan bagian dari layanan utama Azure CLI Berupa perintah referensi opsional yang harus diinstal
Pemasangan Bersama dengan alat penginstal MSI Secara individual dengan az extension add
Dirilis Sesuai jadwal Saat fitur atau pembaruan baru tersedia
Keadaan Dapat berupa GA (Umumnya Tersedia), pratinjau atau tidak digunakan lagi Juga dapat berupa GA, pratinjau, atau tidak digunakan lagi

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

Inti

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.

Ekstensi

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 yes
az iot hub job list yes

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 referensi, referensi Azure CLI termasuk dalam tiga kategori status: GA (Tersedia Secara Umum), pratinjau publik atau tidak digunakan lagi. Ini adalah status perintah referensi (bukan jenis) yang menentukan stabilitas.

GA Pratinjau umum Tidak digunakan lagi
Stabilitas Permanen Dapat berubah sebagai respons terhadap tanggapan pelanggan. Tunduk pada ketentuan Pratinjau Microsoft Azure. Akan dihapus.

Catatan

Peringatan yang menunjukkan pratinjau publik atau tidak digunakan lagi adalah bagian dari output perintah Azure CLI dan harus diharapkan.

Sebagian besar perintah dan parameter untuk referensi tunggal memiliki satu status, tetapi tidak selalu. Referensi GA yang sedang dibangun untuk menawarkan lebih banyak perintah dapat memiliki perintah referensi GA dan pratinjau. 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 Tidak digunakan lagi
az network dns zone list Semua Inti yes
buat zona dns jaringan az --name, --resource-group, --if-none-match, --parent-name Inti yes
--existingParameter5 Inti yes
--newParameter6 Inti yes
az network vhub list Semua Ekstensi yes
az network vhub create --address-prefix, --name, --resource-group, -vwan, --location, --sku Ekstensi yes
--exsitingParameter7 Ekstensi yes
--newParameter8 Ekstensi yes
az network firewall create Semua Ekstensi yes

Tabel di atas hanyalah contoh dan tidak mewakili status referensi saat ini untuk az network.

Lihat juga