Megosztás a következőn keresztül:

Az Azure Sphere PARANCSSORI által támogatott kimeneti formátumok

  • Cikk

Az Azure Sphere CLI számos formátumot támogat, amelyekben az adatok megtekinthetők. Alapértelmezés szerint table a parancssori felület kimenetének megjelenítéséhez használja az alapértelmezett formátumot, de más formátumokat is támogat.

Megjegyzés

  • A parancsok kimenete eltérő lehet a különböző kimeneti típusokhoz.

Az argumentumértékek és a kimeneti típusok a következők:

Kimeneti formátum Leírás
table ASCII-tábla oszlopfejlécként kulcsokkal. Ez az alapértelmezett formátum.
json JSON-sztring.
jsonc Színezett JSON.
yaml YAML, a JSON géppel olvasható alternatíva.
yamlc Színezett YAML.
tsv Tabulátorral tagolt értékek, kulcsok nélkül.
none A hibákon és figyelmeztetéseken kívül nincs más kimenet.

Támogatott parancsok

A parancshoz szükséges kimeneti formátumot a , --outa vagy -oa használatával --outputadhatja meg. Ha hiányzik egy parancs, amelyet szkriptre kell írnia, tudassa velünk az azsphere visszajelzéssel. A következő parancsok támogatottak:

Tábla kimeneti formátuma

A table formátum az alapértelmezett formátum, amely ASCII-táblázatként nyomtatja ki a kimenetet, így könnyen olvasható és beolvasható. Ez a formátum akkor a legjobb, ha az adatok gyors, ember által kereshető áttekintésére van szüksége. Hasznos a szűrt információk összegzéséhez, különösen a listaparancsok esetében.

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

A paraméter használatával --query testre szabhatja a kimenetben megjeleníteni kívánt tulajdonságokat és oszlopokat. Az alábbi példa bemutatja, hogyan választhatja ki a bérlőazonosítót és a szerepkört a listaparancsban.

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

Megjegyzés

  • Futtassa a parancsot JSON formátumban a lekérdezésben használandó elérhető tulajdonságnevek megtekintéséhez. A parancs futtatásakor például a azsphere tenant list --output json kimenet megjeleníti a parancshoz elérhető neveket és értékeket.
  • A beágyazott objektumok, egyes kulcsok és mezők alapértelmezés szerint nem jelennek meg a tábla kimenetében. Ha ezeket meg kell jelenítenie a kimenetben, a JMESPath újrakulcsolási funkciójával módosíthatja a kulcs nevét, és elkerülheti a szűrést. További információ a lekérdezések adatok szűrésére való használatáról: Lekérdezési parancssori felület parancskimenete.

JSON kimeneti formátum

A JSON kimeneti formátuma tartalmazza az összes nyers adatot és a beágyazott adatokat strukturált formátumban. A JSON-kimenet használatát javasoljuk tömör kimeneti és szkriptelési célokra. Ez csak akkor alkalmazható, ha a parancs sikeres, és a 0 értéket adja vissza.

Az alábbi példa az alapértelmezett JSON-formátumban jeleníti meg a bérlők listáját.

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 kimeneti formátum

A yaml formátum YAML formátumban nyomtatja ki a kimenetet, amely egy egyszerű szöveges adat szerializálási formátum. A YAML általában könnyebben olvasható, mint a JSON.

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 kimeneti formátum

A tsv kimeneti formátum tabulátorral elválasztott és új sorokkal tagolt értékeket ad vissza további formázás, kulcsok és egyéb szimbólumok nélkül. A tsv kimenet hasonló a table kimenethez, de a következő módokon különbözik:

  • Az oszlopfejlécek nem jelennek meg a tsv kimenetben.
  • A table kimenet megjeleníti a listát, és tsv megjeleníti a lista hosszát.
  • A beágyazott objektumok nem lesznek kinyomtatva a tsv kimenetben.
  • A tsv kimenet tabulátorral van elválasztva, és nem méretezhető úgy, hogy illeszkedjen a terminálhoz.
azsphere tenant list --output tsv
143adbc9-1bf0-4be2-84a2-084a331d81cb    MyTenant    1
768c2cd6-059a-49ad-9f53-89f5271cea15    MyTenant1    2