Gambaran umum: Terminologi Azure CLI dan tingkat dukungan

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. Seringkali, perintah referensi lengkap disebut sebagai perintah.

Layanan Azure	Grup referensi	Subgrup referensi	Command	Perintah referensi lengkap	Contoh Parameter
Azure CLI	konfigurasi az			az config	--local --output -o
Jaringan Azure	jaringan AZ	application-gateway	buat	az network application-gateway create	--name --resource-group --capacity
Azure DevOps	pipeline az	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	Command
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 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	Core	Extension
References	Merupakan bagian dari layanan utama Azure CLI	Berupa perintah referensi opsional yang harus diinstal
Install	Bersama dengan alat penginstal MSI	Satu per satu dengan az extension add
Released	Sesuai jadwal	Saat fitur atau pembaruan baru tersedia
Status	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.

# Get list of all command groups
az

Untuk daftar ekstensi, gunakan az extension list-available --output table perintah.

# Get list of extensions
az extension list-available --output table

Core

Referensi Azure CLI yang diterbitkan sebagai bagian permanen dari Azure CLI disebut sebagai referensi inti. Semua referensi inti diinstal dengan Azure CLI, dan Anda tidak dapat memilih subset referensi. Jika Anda menjalankan Azure CLI melalui Azure Cloud Shell, referensi inti selalu diperbarui.

Extension

Ekstensi tidak dikirim sebagai bagian dari Azure CLI tetapi dijalankan sebagai perintah Azure CLI. Beberapa ekstensi adalah bagian permanen dari Azure CLI, tetapi seringkali, ekstensi memberi Anda akses ke pratinjau dan perintah eksperimental. Satu grup referensi, seperti az iot hub, dapat memiliki perintah inti dan ekstensi. Berikut dua contohnya:

Perintah referensi lengkap	Adalah Inti	Adalah Ekstensi
az iot hub list	yes
az iot hub daftar pekerjaan		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	Deprecated
Stability	Permanent	Dapat berubah sebagai respons terhadap tanggapan pelanggan. Tunduk pada ketentuan Pratinjau Microsoft Azure.	Akan dihapus.

Note

Peringatan yang mengindikasikan pratinjau publik atau dihentikan adalah bagian dari output perintah Azure CLI dan dapat diharapkan.

Sebagian besar perintah dan parameter untuk satu referensi memiliki satu status, tetapi ini tidak selalu terjadi. Referensi GA yang sedang dikembangkan untuk menyediakan lebih banyak perintah dapat mencakup perintah referensi GA dan perintah referensi 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	Parameters	Type	GA	Pratinjau umum	Deprecated
az network dns zone list	All	Core	yes
az network dns zone create	--name,--resource-group,--if-none-match,--parent-name	Core	yes
	--existingParameter5	Core			yes
	--newParameter6	Core		yes
az network vhub list	All	Extension	yes
az network vhub create	--address-prefix, --name--resource-group, -vwan, --location, --sku	Extension	yes
	--existingParameter7	Extension		yes
	--newParameter8	Extension	yes
az network firewall create	All	Extension		yes

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

Lihat juga

• Siklus hidup dukungan Azure CLI