`boundary roles list` — 역할 목록 조회

boundary roles list — 역할 목록 조회

boundary roles list 명령어는 특정 스코프나 자원 안의 Boundary 역할들을 목록으로 조회할 때 사용해요. 하위 스코프까지 재귀적으로 조회할 수도 있어요.

출처: HashiCorp Boundary docs

본문

예시

아래 예시는 s_1234567890 스코프 안의 모든 역할을 나열해요. recursive 옵션을 주면 해당 스코프의 하위 스코프에도 재귀적으로 작업을 수행해요.

$ boundary roles list -scope-id s_1234567890 -recursive

사용법

$ boundary roles list [options] [args]

명령어 옵션 (Command options)

  • -filter=<string> — 설정하면 결과가 반환되기 전에 목록 작업을 필터링해요. 필터는 목록의 각 항목에 대해 동작해요. 필터에는 큰따옴표가 포함되므로 작은따옴표를 사용할 것을 권장해요. 자세한 내용은 'Filtering and listing resources' 문서를 참고하세요.
  • -recursive — 설정하면 해당 유형이 지원할 때 하위 스코프에 대해 재귀적으로 목록 작업을 수행해요. 기본값은 false예요.
  • -scope-id=<string> — 역할을 조회할 기준이 되는 상위 스코프. 기본값은 global이에요. BOUNDARY_SCOPE_ID 환경 변수로도 지정할 수 있어요.
  • list_token (선택) — 이전 list 응답에서 반환된 불투명(opaque) 토큰. 값을 주지 않으면 페이지네이션이 처음부터 시작돼요.
  • page_size (선택) — 검색 결과 페이지에 포함할 항목 수를 나타내는 부호 없는 정수. 값을 주지 않거나 0을 주면 Boundary는 기본 페이지 크기인 1000개 항목을 사용해요. 설정하면 page_size 값이 기본 페이지 크기를 덮어써요. 컨트롤러 관리자는 사용자가 요청할 수 있는 최대 페이지 크기를 제한하는 max_page_size 옵션도 구성할 수 있어요.

CLI 옵션 — 이 명령어 고유 옵션 외에도 모든 CLI 명령어·하위 명령어에 공통으로 적용되는 옵션들이 있어요. 연결(Connection) 옵션, 클라이언트(Client) 옵션, 출력(Output) 옵션, 환경 변수(Environment variables)를 참고하세요.