`groups list` — 그룹 목록 조회하기

groups list — 그룹 목록 조회하기

boundary groups list 명령어는 특정 스코프나 리소스 안에 정의된 모든 그룹을 나열해요.

출처: HashiCorp Boundary docs

본문

예시 (Examples)

다음 예시는 스코프 o_R0wbo0H6Zl 안에 정의된 모든 그룹을 나열해요.

$ boundary groups list -scope-id o_R0wbo0H6Zl

예시 출력:

Group information:
  ID:                    g_XzlDiNLgoz
    Version:             2
    Name:                group01
    Description:         A test group
    Authorized Actions:
      no-op
      read
      update
      delete
      add-members
      set-members
      remove-members

  ID:                    g_FNVVhAd0on
    Version:             1
    Name:                webdev
    Description:         Web dev group
    Authorized Actions:
      no-op
      read
      update
      delete
      add-members
      set-members
      remove-members

  ID:                    g_9SpLKOoTse
    Version:             1
    Name:                support
    Description:         Support engineering group
    Authorized Actions:
      no-op
      read
      update
      delete
      add-members
      set-members
      remove-members

사용법 (Usage)

$ boundary groups list [options] [args]

명령 옵션 (Command options)

  • -filter (string: "") — 설정하면 Boundary가 결과를 반환하기 전에 목록 연산을 필터링해요. 필터는 목록에 있는 각 항목을 대상으로 동작해요. 필터에는 큰따옴표가 들어 있으니 작은따옴표를 쓰는 걸 권장해요. 자세한 내용은 리소스 필터링 및 목록 조회 문서를 참고하세요.
  • -recursive — 설정하면 타입이 지원할 때 하위 스코프에 대해서도 목록 연산을 재귀적으로 수행해요. 기본값은 false예요.
  • -scope-id (string: "") — 그룹을 나열할 스코프예요. 기본값은 global이에요. 이 값은 BOUNDARY_SCOPE_ID 환경 변수로도 지정할 수 있어요.
  • list_token (선택) — 이전 list 응답에서 반환된 불투명한 토큰이에요. 값을 주지 않으면 페이지네이션은 처음부터 시작돼요.
  • page_size (선택) — 검색 결과 페이지에 포함될 항목 수를 나타내는 부호 없는 정수예요. 값을 제공하지 않거나 0을 제공하면 Boundary는 기본 페이지 크기인 1000개 항목을 사용해요. 설정하면 page_size 값이 기본 페이지 크기를 덮어써요. 컨트롤러 관리자는 사용자가 요청할 수 있는 최대 페이지 크기를 제한하는 max_page_size 옵션도 구성할 수 있어요.