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 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.
