1.17. 버킷 정보 가져오기

기존 버킷의 하위 집합에 대한 정보를 가져옵니다. 버킷 없이 uid 를 지정하면 사용자에게 속한 모든 버킷이 반환됩니다. 버킷 만 지정하면 특정 버킷에 대한 정보가 검색됩니다.

capabilities

`buckets=read`

구문

GET /admin/bucket?format=json HTTP/1.1
Host FULLY_QUALIFIED_DOMAIN_NAME

표 1.27. 요청 매개변수
이름	설명	유형	예제	필수 항목
`bucket`	정보를 반환하는 버킷입니다.	문자열	`foo_bucket`	없음
`uid`	버킷 정보를 검색할 사용자입니다.	문자열	`foo_user`	없음
`통계`	버킷 통계 반환.	부울	true [False]	없음

표 1.28. 응답 엔티티
이름	설명	유형	parent
`통계`	버킷 정보당.	컨테이너	해당 없음
`buckets`	하나 이상의 버킷 컨테이너 목록을 포함합니다.	컨테이너	`bucket`
단일 버킷 정보용 컨테이너입니다.	컨테이너	`buckets`	`name`
버킷의 이름입니다.	문자열	`bucket`	`pool`
버킷이 저장된 풀입니다.	문자열	`bucket`	`id`
고유한 버킷 ID입니다.	문자열	`bucket`	`marker`
내부 버킷 태그.	문자열	`bucket`	`소유자`
버킷 소유자의 사용자 ID입니다.	문자열	`bucket`	`사용법`
스토리지 사용량 정보.	컨테이너	`bucket`	`index`

요청이 성공하면 원하는 버킷 정보가 포함된 버킷 컨테이너를 반환합니다.

표 1.29. 특수 오류 응답
이름	설명	코드
`IndexRepairFailed`	버킷 인덱스 복구에 실패했습니다.	409 충돌