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

Bu makalede Azure CLI terminolojileri açıklanmaktadır. Söz dizimi bileşenleri, başvuru türleri ve durumlar vardır. destek düzeyini belirleyen durumdur.

Azure CLI söz dizimi bileşenleri

Azure CLI söz dizimi grupların, başvuruların, komutların ve parametrelerin birleşimidir. Tam başvuru komutu genellikle komut olarak adlandırılır.

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

Başvuru alt grubunun birden çok düzeyi olabilir, örneğinaz network application-gateway private-link ip-config add

Başvuru Grubu Alt Grup 1 Alt Grup 2 Alt Grup 3 Komut
network application-gateway özel bağlantı ip yapılandırması add

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

Başvuru 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ü yayın zamanlamasını, durumunu ve yükleme yöntemini burada açıklandığı gibi belirler:

Süre Çekirdek Uzantı
Başvurular Birincil Azure CLI hizmetinin bir parçasıdır Yüklenmesi gereken isteğe bağlı başvuru komutlarıdır
Yükleme MSI yükleyicisi ile birlikte az extension add ile tek tek
Yayınlandı Zamanlamaya göre Yeni özellikler veya güncelleştirmeler kullanıma sunuldukçe
Durum GA (Genel Kullanılabilir), önizleme veya deneysel olabilir Ga, önizleme veya deneysel de olabilir

Komut gruplarının listesini almak için komutunu çalıştırın az. Uzantıların listesi için az extension list-available --output table komutlarını kullanın.

# Get list of all command groups
az

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

Çekirdek

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 başvuruların bir alt kümesini seçemezsiniz. CLI'yi Azure Cloud Shell aracılığıyla çalıştırırsanız, temel başvurular her zaman günceldir.

Uzantı

Uzantılar CLI'nın bir parçası olarak gönderilmez ancak 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. az iot hub gibi tek bir başvuru grubunda hem çekirdek hem de uzantı komutları olabilir. Aşağıda iki örnek verilmiştir:

Tam başvuru komutu Çekirdek Uzantıdır
az iot hub list evet
az iot hub iş listesi evet

İlk kullanımda bir uzantı yüklemeniz istenir. Ayrıca az extension add komutunu çalıştırarak da bir uzantı 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 .

Başvuru durumu nedir?

Başvuru türünden bağımsız olarak Azure CLI başvuruları üç durum kategorisine ayrılır: GA (Genel Kullanıma Sunuldu), genel önizleme veya deneysel. Kararlılığı ve destek düzeyini belirleyen başvuru komut durumudur (tür değildir).

GA Genel önizleme Deneysel
Istikrar Kalıcı Müşteri geri bildirimlerine yanıt olarak değişebilir. Microsoft Azure Önizlemeleri koşullarına tabidir. Müşteri geri bildirimlerine yanıt olarak değişebilir. Genellikle genel önizlemeye geçiş yapılır. Kaldırılabilir.
Destek düzeyi Tam Kısmi Hiçbiri

Not

Genel önizlemeyi veya deneyseli belirten 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 her zaman yoktur. Daha fazla komut sunmak için oluşturulan ga başvurusunda GA, önizleme ve deneysel başvuru komutları olabilir. İşlevselliği artırmak için yeni parametreler eklendikçe, tek bir komutun farklı durum kategorilerine giren parametreleri de olabilir. Farklı durumlara sahip örnek başvurular aşağıda verilmiştir:

Tam başvuru komutu Parametreler Tür GA Genel önizleme Deneysel
az network dns zone list Tümü Çekirdek evet
az network dns zone create --name, --resource-group, --if-none-match, --parent-name Çekirdek evet
--newFutureParameter1 Çekirdek evet
--newFutureParameter2 Çekirdek evet
az network vhub list Tümü Uzantı evet
az network vhub create --address-prefix, --name, --resource-group, -vwan, --location, --sku Uzantı evet
--newFutureParameter1 Uzantı evet
--newFutureParameter2 Uzantı evet
az network firewall create Tümü Uzantı evet

Yukarıdaki tablo yalnızca bir örnektir ve örnekler için geçerli başvuru durumunu temsil etmez .

Ayrıca bkz.