Azure Sphere CLI için desteklenen çıkış biçimleri

Makale
08/09/2023

Azure Sphere CLI, verilerin görüntülenebildiği çeşitli biçimleri destekler. Varsayılan olarak, CLI çıkışını görüntülemek için varsayılan biçim olarak kullanır table , ancak diğer biçimleri de destekler.

Not

Bir komut için görüntülenen çıkış, farklı çıkış türüne göre farklılık gösterebilir.

Bağımsız değişken değerleri ve çıkış türleri şunlardır:

Çıkış biçimi	Açıklama
`table`	Sütun başlıkları olarak anahtarlar içeren ASCII tablosu. Bu varsayılan biçimdir.
`json`	JSON dizesi.
`jsonc`	Renklendirilmiş JSON.
`yaml`	YAML, JSON'a makine tarafından okunabilir bir alternatif.
`yamlc`	Renklendirilmiş YAML.
`tsv`	Anahtar olmadan sekmeyle ayrılmış değerler.
`none`	Hata ve uyarı dışında çıkış yok.

Desteklenen komutlar

komutu için gerekli çıkış biçimini , --outveya -okullanarak --outputbelirtebilirsiniz. Betik oluşturmanız gereken bir komut eksikse azsphere geri bildirimiyle bize bildirin. Aşağıdaki komutlar için desteklenir:

Tablo çıkış biçimi

Biçim table , çıktıyı ASCII tablosu olarak yazdıran varsayılan biçimdir ve okuma ve taramayı kolaylaştırır. Bu biçim, verilere hızlı ve insan tarafından aranabilir bir genel bakış istediğinizde en iyisidir. Özellikle liste komutları için odaklanmış bilgilerin özetini almak için yararlıdır.

azsphere tenant list --output table
 ------------------------------------ --------------------- -------------
 Id                                   Name                  Roles
 ========================================================================
 143adbc9-1bf0-4be2-84a2-084a331d81cb MyTenant               Contributor
 ------------------------------------ --------------------- -------------
 768c2cd6-059a-49ad-9f53-89f5271cea15 MyTenant1              Administrator
                                                             Contributor
 ------------------------------------ --------------------- -------------

Çıkışta --query göstermek istediğiniz özellikleri ve sütunları özelleştirmek için parametresini kullanabilirsiniz. Aşağıdaki örnekte, liste komutunda yalnızca TenantID ve Rol'leri seçme gösterilmektedir.

azsphere tenant list --query '[].{TenantID:id, Role:roles}'
 ------------------------------------ -------------
 TenantID                             Role
 ==================================================
 143adbc9-1bf0-4be2-84a2-084a331d81cb Contributor
 ------------------------------------ -------------
 183adhc9-a5c8-8he2-84a2-c4f00f73a471 Administrator
                                      Contributor
 ------------------------------------ -------------

Not

Sorguda kullanılacak kullanılabilir özellik adlarını görüntülemek için komutunu JSON biçiminde çalıştırın. Örneğin, komutu çalıştırdığınızda azsphere tenant list --output json çıkış, bu komut için kullanılabilen adları ve değerleri görüntüler.
İç içe nesneler, bazı anahtarlar ve alanlar varsayılan olarak tablo çıkışında yazdırılmaz. Çıktınızda bunları görmeniz gerekiyorsa, anahtar adını değiştirmek ve filtrelemeyi önlemek için JMESPath yeniden anahtarlama özelliğini kullanabilirsiniz. Verileri filtrelemek için sorguları kullanma hakkında daha fazla bilgi için bkz. SORGU CLI komut çıkışı.

JSON çıkış biçimi

JSON çıkış biçimi, tüm ham verileri ve iç içe yerleştirilmiş verileri yapılandırılmış biçimde içerir. Kısa çıkış ve betik oluşturma amacıyla JSON çıkışını kullanmanızı öneririz. Bu yalnızca komut başarılı olduğunda ve 0 döndürdüğünde geçerlidir.

Aşağıdaki örnek, kiracı listesini varsayılan JSON biçiminde görüntüler.

azsphere tenant list --output json
[
  {
    "id": "143adbc9-1bf0-4be2-84a2-084a331d81cb",
    "name": "MyTenant",
    "roles": [
      "Contributor"
    ]
  },
  {
    "id": "768c2cd6-059a-49ad-9f53-89f5271cea15",
    "name": "MyTenant1",
    "roles": [
      "Administrator",
      "Contributor"
    ]
  }
]

YAML çıkış biçimi

Biçimi yaml , çıkışı düz metin veri serileştirme biçimi olan YAML olarak yazdırır. YAML, JSON'dan daha kolay okunur olma eğilimindedir.

azsphere tenant list --output yaml
- id: 143adbc9-1bf0-4be2-84a2-084a331d81cb
  name: MyTenant
  roles:
  - Contributor
- id: 768c2cd6-059a-49ad-9f53-89f5271cea15
  name: MyTenant1
  roles:
  - Administrator
  - Contributor

TSV çıkış biçimi

Çıkış tsv biçimi, ek biçimlendirme, tuşlar veya diğer simgeler olmadan sekmeyle ayrılmış ve yeni satırla ayrılmış değerler döndürür. Çıkış tsv , çıkışa table benzer ancak aşağıdaki yollarla farklılık gösterir:

Sütun üst bilgileri çıktıda tsv görüntülenmez.
Çıkışta table liste görüntülenir ve tsv bir listenin uzunluğu görüntülenir.
İç içe nesneler çıktıya tsv yazdırılmaz.
Çıkış tsv sekmeyle ayrılmıştır ve terminale sığacak şekilde ölçeklendirilmemektedir.

azsphere tenant list --output tsv
143adbc9-1bf0-4be2-84a2-084a331d81cb    MyTenant    1
768c2cd6-059a-49ad-9f53-89f5271cea15    MyTenant1    2

Share via