Azure Sphere CLI에 지원되는 출력 형식

아티클
09/27/2024

Important

Azure Sphere(레거시) 설명서입니다. Azure Sphere(레거시)는 2027년 9월 27일에 사용 중지되며 사용자는 이 시간까지 Azure Sphere(통합)로 마이그레이션해야 합니다. TOC 위에 있는 버전 선택기를 사용하여 Azure Sphere(통합) 설명서를 볼 수 있습니다.

Azure Sphere CLI는 데이터를 볼 수 있는 여러 형식을 지원합니다. 기본적으로 CLI 출력을 표시하기 위한 기본 형식으로 사용 table 하지만 다른 형식도 지원합니다.

참고 항목

명령에 대해 표시되는 출력은 출력 유형에 따라 다를 수 있습니다.

인수 값 및 출력 형식은 다음과 같습니다.

출력 형식	설명
`table`	열 머리글로 키가 있는 ASCII 테이블입니다. 이것이 기본 형식입니다.
`json`	JSON 문자열입니다.
`jsonc`	색이 지정된 JSON입니다.
`yaml`	JSON에 대한 컴퓨터 읽기 가능한 대안인 YAML입니다.
`yamlc`	색이 지정 된 YAML입니다.
`tsv`	키가 없는 탭으로 구분된 값입니다.
`none`	오류 및 경고 이외의 출력이 없습니다.

지원되는 명령

또는 -o를 사용하여 --output--out명령에 필요한 출력 형식을 지정할 수 있습니다. 스크립트해야 하는 명령이 누락된 경우 azsphere 피드백을 통해 알려주세요. 다음 명령에 대해 지원됩니다.

테이블 출력 형식

이 table 형식은 출력을 ASCII 테이블로 인쇄하는 기본 형식이므로 쉽게 읽고 검색할 수 있습니다. 이 형식은 사용자가 검색할 수 있는 빠른 데이터 개요를 원하는 경우에 가장 적합합니다. 특히 목록 명령의 경우 포커스가 있는 정보의 요약을 가져오는 데 유용합니다.

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

매개 변수를 --query 사용하여 출력에 표시할 속성 및 열을 사용자 지정할 수 있습니다. 다음 예제에서는 목록 명령에서 TenantID 및 역할만 선택하는 방법을 보여줍니다.

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

참고 항목

JSON 형식으로 명령을 실행하여 쿼리에 사용할 사용 가능한 속성 이름을 확인합니다. 예를 들어 명령을 실행 azsphere tenant list --output json 하면 출력에 해당 명령에 사용할 수 있는 이름과 값이 표시됩니다.
중첩된 개체, 일부 키 및 필드는 기본적으로 테이블 출력에 인쇄되지 않습니다. 출력에서 이러한 항목을 확인해야 하는 경우 JMESPath 다시 키 지정 기능을 사용하여 키 이름을 변경하고 필터링을 방지할 수 있습니다. 쿼리를 사용하여 데이터를 필터링하는 방법에 대한 자세한 내용은 쿼리 CLI 명령 출력을 참조하세요.

JSON 출력 형식

JSON 출력 형식에는 모든 원시 데이터와 중첩된 데이터가 구조화된 형식으로 포함됩니다. 간결한 출력 및 스크립팅을 위해 JSON 출력을 사용하는 것이 좋습니다. 명령이 성공하고 0을 반환하는 경우에만 적용됩니다.

다음 예제에서는 기본 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"
    ]
  }
]

YAML 출력 형식

yaml 형식은 출력을 일반 텍스트 데이터 serialization 형식인 YAML로 인쇄합니다. YAML은 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 출력 형식

출력 형식은 tsv 추가 서식, 키 또는 기타 기호 없이 탭으로 구분된 값과 줄 바꿈으로 구분된 값을 반환합니다. 출력은 tsv 출력과 table 비슷하지만 다음과 같은 방법으로 다릅니다.

열 머리글은 출력에 tsv 표시되지 않습니다.
출력은 table 목록을 표시하고 tsv 목록의 길이를 표시합니다.
중첩된 개체는 출력에 tsv 인쇄되지 않습니다.
출력은 tsv 탭으로 구분되며 터미널에 맞게 크기가 조정되지 않습니다.

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

다음을 통해 공유