storage-buckets list 명령어

boundary storage-buckets list는 주어진 스코프(scope)나 리소스 안의 storage bucket을 나열하는 명령어예요. 하위 스코프까지 재귀적으로 조회할 수도 있어요.

출처: HashiCorp Boundary docs

본문

boundary storage-buckets list 명령어는 주어진 스코프나 리소스 안의 storage bucket을 나열해요.

다음 예제는 스코프 s_1234567890 안의 모든 storage bucket을 나열해요. recursive 옵션은 가능하면 하위 스코프에서도 재귀적으로 작업을 실행한다는 뜻이에요.

$ boundary storage-buckets list -scope-id s_1234567890 -recursive

$ boundary storage-buckets list [options] [args]

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

명령어 고유 옵션 외에도 모든 Boundary CLI 명령어·하위 명령어에 공통으로 적용되는 옵션들이 있어요.