Genel bakış: Azure CLI terminolojisi ve destek düzeyleri

Bu makalede Azure CLI terimleri açıklanmaktadır. Söz dizimi bileşenleri, başvuru türleri ve durumlar vardır.

Azure CLI söz dizimi bileşenleri

Azure CLI söz dizimi grupların, başvuruların, komutların ve parametrelerin birleşimidir. Genellikle tam başvuru komutuna komut denir.

Azure Hizmeti	Başvuru grubu	Başvuru alt grubu	Command	Tam referans komutu	Parametre Örnekleri
Azure CLI	az config			az config	--local, --output, -o
Azure Ağı	az network	application-gateway	create	az network application-gateway create	--name, --resource-group, --capacity
Azure DevOps	az pipelines	agent	list	az pipelines agent list	--pool-id, --agent-name, --demands

Bir başvuru alt grubunun az network application-gateway private-link ip-config add gibi birden çok düzeyi olabilir.

Referans Grubu	Alt Grup 1	Alt Grup 2	Alt Grup 3	Command
network	application-gateway	private-link	ip-config	add

Referans komutlarının tam listesi için bkz. Başvuru listesi A'dan Z'ye.

Referans türü nedir?

Azure CLI komutları, temel Azure CLI hizmetinin bir parçasıdır veya bir uzantıdır. Uzantılar isteğe bağlı eklentilerdir. Başvuru türü burada açıklandığı gibi yayın zamanlamasını, durumunu ve yükleme yöntemini belirler:

Term	Core	Extension
References	Birincil Azure CLI hizmetinin bir parçasıdır	Yüklenmesi gereken isteğe bağlı referans komutlarıdır.
Install	MSI yükleyicisi ile birlikte	Tek tek az extension add ile
Released	Program dahilinde	Yeni özellikler veya güncelleştirmeler kullanıma sunuldukçe
Status	GA (Genel Kullanılabilir), önizleme veya kullanım dışı olabilir	GA, önizleme veya kullanımdan kaldırılmış da olabilir

Komut gruplarının listesini almak için komutunu çalıştırın az.

# Get list of all command groups
az

Uzantıların listesi için komutları kullanın az extension list-available --output table .

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

Core

Azure CLI'nin kalıcı bir parçası olarak yayımlanan Azure CLI başvuruları, temel başvurular olarak adlandırılır. Tüm temel başvurular Azure CLI ile yüklenir ve bir başvuru alt kümesi seçemezsiniz. Azure CLI'yı Azure Cloud Shell aracılığıyla çalıştırırsanız, temel başvurular her zaman güncel olur.

Extension

Uzantılar Azure CLI'nın bir parçası olarak gönderilmez ancak Azure CLI komutları olarak çalıştırılır. Bazı uzantılar Azure CLI'nın kalıcı bir parçasıdır, ancak çoğu zaman uzantı önizleme ve deneysel komutlara erişmenizi sağlar. gibi az iot hubtek bir başvuru grubu hem çekirdek hem de uzantı komutlarını içerebilir. Burada iki örnek verilmiştir:

Tam referans komutu	Çekirdek	Uzantıdır
az iot hub listele	yes
az iot hub iş listesi		yes

İlk kullanımda bir uzantı yüklemeniz istenir. az extension add komutunu çalıştırarak bir uzantı da yükleyebilirsiniz.

Azure CLI ile uzantıları kullanma bölümünden yükleme ve güncelleştirme dahil olmak üzere uzantı başvuruları hakkında daha fazla bilgi edinebilirsiniz. Uzantı başvuru komutlarının tam listesi için bkz . Azure CLI için kullanılabilir uzantılar.

Referans durumu nedir?

Başvuru türü ne olursa olsun, Azure CLI başvuruları üç durum kategorisine ayrılır: GA (Genel Kullanıma Sunuldu), genel önizleme veya kullanım dışı. Kararlılığı belirleyen başvuru komut durumudur (tür değil).

	GA	Genel önizleme	Deprecated
Stability	Permanent	Müşteri geri bildirimlerine yanıt olarak değişebilir. Microsoft Azure Önizlemeleri koşullarına tabidir.	Kaldırılacak.

Note

Genel önizlemeyi veya kullanım dışı bırakıldığını gösteren uyarılar, Azure CLI komut çıkışının bir parçasıdır ve beklenmelidir.

Tek bir başvuru için çoğu komut ve parametrenin tek bir durumu vardır, ancak bu her zaman geçerli değildir. Daha fazla komut sunmak için oluşturulan ga başvurusu hem GA hem de önizleme başvuru komutlarını içerebilir. İşlevselliği artırmak için yeni parametreler eklendikçe, tek bir komutun farklı durum kategorilerine giren parametreleri de olabilir. Aşağıda farklı durumlara sahip örnek referanslar verilmiştir.

Tam referans komutu	Parameters	Type	GA	Genel önizleme	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

Önceki tablo yalnızca bir örnektir ve az network için geçerli referans durumlarını temsil etmez.

Ayrıca bakınız

• Azure CLI destek yaşam döngüsü