Aracılığıyla paylaş

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

  • Makale

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 komutu komut olarak adlandırılır.

Azure Hizmeti Başvuru grubu Başvuru alt grupları Command 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ı listele az pipelines agent list --pool-id, --agent-name, --demands

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

Başvuru Grubu Alt Grup 1 Alt Grup 2 Alt Grup 3 Command
network application-gateway private-link ip-config 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 Temel Dahili
Başvurular Birincil Azure CLI hizmetinin bir parçasıdır Yüklenmesi gereken isteğe bağlı başvuru komutları mı?
Yükle 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
Statü GA (Genel Kullanılabilir), önizleme veya kullanım dışı olabilir Ga, önizleme veya kullanım dışı da 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 tablo komutlarını kullanın.

# Get list of all command groups
az

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

Temel

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üncel olur.

Dahili

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. Burada 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. 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ü 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 Kullanım Dışı
Istikrar Kalıcı Müşteri geri bildirimlerine yanıt olarak değişebilir. Microsoft Azure Önizlemeleri koşullarına tabidir. Kaldırılacak.

Not

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 her zaman yoktur. Daha fazla komut sunmak için oluşturulan bir GA başvurusu hem GA hem de önizleme başvuru komutlarına sahip olabilir. İş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 başvurular verilmiştir:

Tam başvuru komutu Parametreler Tür GA Genel önizleme Kullanım Dışı
az network dns zone list Tümünü Temel evet
az network dns zone create --name, --resource-group, --if-none-match, --parent-name Temel evet
--existingParameter5 Temel evet
--newParameter6 Temel evet
az network vhub list Tümünü Extension evet
az network vhub create --address-prefix, --name, --resource-group, -vwan, --location, --sku Extension evet
--exsitingParameter7 Extension evet
--newParameter8 Extension evet
az network firewall create Tümünü Extension evet

Yukarıdaki tablo yalnızca bir örnektir ve için az networkgeçerli başvuru durumlarının temsili değildir.

Ayrıca bkz.