Udostępnij za pośrednictwem

Obsługiwane formaty wyjściowe dla środowiska Azure Sphere CLI

  • Artykuł

Platforma Azure Sphere CLI obsługuje kilka formatów, w których można wyświetlać dane. Domyślnie jest table używany jako domyślny format wyświetlania danych wyjściowych interfejsu cli, ale także obsługuje inne formaty.

Uwaga

  • Dane wyjściowe wyświetlane dla polecenia mogą się różnić w zależności od typu danych wyjściowych.

Wartości argumentów i typy danych wyjściowych to:

Format wyjściowy Opis
table Tabela ASCII z klawiszami jako nagłówkami kolumn. Jest to format domyślny.
json Ciąg JSON.
jsonc Kolorowy JSON.
yaml YAML , czytelna maszynowa alternatywa dla JSON.
yamlc Kolorowy YAML.
tsv Wartości rozdzielone tabulatorami bez klawiszy.
none Dane wyjściowe nie są inne niż błędy i ostrzeżenia.

Obsługiwane polecenia

Wymagany format wyjściowy polecenia można określić za pomocą --outputopcji , --outlub -o. Jeśli brakuje polecenia, które trzeba wykonać w scenariuszu, podziel się z nami opiniami na temat azsphere. Jest obsługiwana w przypadku następujących poleceń:

Format wyjściowy tabeli

Format table jest formatem domyślnym, który służy do drukowania danych wyjściowych jako tabeli ASCII, co ułatwia czytanie i skanowanie. Ten format jest najlepszy, gdy potrzebujesz szybkiego, przeszukiwanego przez człowieka przeglądu danych. Przydaje się do uzyskiwania podsumowania informacji priorytetowych, szczególnie w przypadku poleceń listy.

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

Za pomocą parametru --query możesz dostosować właściwości i kolumny, które mają być wyświetlane w wynikach. W poniższym przykładzie pokazano, jak wybrać tylko identyfikator dzierżawy i rolę w poleceniu listy.

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

Uwaga

  • Uruchom polecenie w formacie JSON, aby wyświetlić dostępne nazwy właściwości, które mają być używane w zapytaniu. Na przykład po uruchomieniu azsphere tenant list --output json polecenia wyniki wyświetlają nazwy i wartości dostępne dla tego polecenia.
  • Obiekty zagnieżdżone, niektóre klawisze i pola nie są domyślnie drukowane w wynikach tabeli. Jeśli chcesz wyświetlić te informacje w wynikach, możesz użyć funkcji ponownego klawiszy JMESPath, aby zmienić nazwę klucza i uniknąć filtrowania. Aby uzyskać więcej informacji na temat filtrowania danych za pomocą zapytań, zobacz Dane wyjściowe poleceń cli zapytania.

Format wyjściowy JSON

Format wyjściowy JSON zawiera wszystkie nieprzetworzone dane i dane zagnieżdżone w formacie strukturalnym. Zalecamy używanie danych wyjściowych JSON do zwięzłych celów wyjściowych i skryptów. Ma to zastosowanie tylko wtedy, gdy polecenie zakończy się powodzeniem i zwróci wartość 0.

W poniższym przykładzie przedstawiono listę dzierżaw w domyślnym formacie JSON.

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"
    ]
  }
]

Format wyjściowy YAML

Format yaml wydrukuje dane wyjściowe jako YAML, format serializacji danych w formacie zwykłego tekstu. Yaml wydaje się być łatwiejsze do odczytania niż 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

Format wyjściowy TSV

Format wyjściowy tsv zwraca wartości rozdzielone tabulatorami i newline bez dodatkowego formatowania, klawiszy i innych symboli. Dane wyjściowe tsv są podobne do danych wyjściowych, table ale różnią się w następujący sposób:

  • Nagłówki kolumn nie są wyświetlane w wynikach tsv .
  • Dane wyjściowe table są wyświetlane na liście i tsv wyświetlają długość listy.
  • Obiekty zagnieżdżone nie są drukowane na wydruku tsv .
  • Dane tsv wyjściowe są oddzielone tabulatorami i nie są skalowane w celu dopasowania do zacisku.
azsphere tenant list --output tsv
143adbc9-1bf0-4be2-84a2-084a331d81cb    MyTenant    1
768c2cd6-059a-49ad-9f53-89f5271cea15    MyTenant1    2