Obtain Bucket Stat
최신 업데이트：2025-08-18 15:32:03
이 인터페이스는 지정한 기간 동안 오브젝트 스토리지 버킷의 저장 용량 사용 정보를 조회할 수 있도록 지원합니다. 주로 버킷의 일별 최대 저장 용량(피크 값) 정보를 포함하며, 본 인터페이스를 통해 조회되는 값은 참고용입니다. 실제 과금은 CDNetworks SAP에서 제공하는 데이터에 따라 산정됩니다.
요청 설명
요청 형식
GET /bucket/stat?name=<Urlsafe_Base64_Encoded_Names>&startdate=<startdate>&enddate=<enddate>
Host:<MgrDomain>
Authorization:<AccessToken>
헤더 설명
| 파라미터 | 필수 여부 | 설명 |
|---|---|---|
| Host | 예 | Management domain name, 콘솔의 Bucket 개요 화면에서 확인 가능 |
| Authorization | 예 | Management Credential |
파라미터 설명
| 파라미터 | 필수 여부 | 설명 |
|---|---|---|
| name | 예 | 조회할 버킷 목록을 지정합니다. 형식: Urlsafe_Base64_Encode(<bucket_name1>|<bucket_name2> |
| startdate | 예 | 통계 시작일, yyyy-mm-dd 형식 |
| enddate | 예 | 통계 종료일, yyyy-mm-dd 형식 참고: 최대 조회 기간은 6개월입니다. |
| isListDetails | 아니오 | true/false 중 택1. 저장 상세 내역 반환 여부. 기본값은 false(반환하지 않음). |
| storageType | 아니오 | 선택 값: Standard, InfrequentAccess, Archive(표준/저빈도/아카이브 스토리지). 미지정 시 전체 스토리지 정보가 반환됨. |
응답 설명
- 요청이 성공하면, 아래와 같은 JSON 형식의 문자열이 반환됩니다:
{
"code": "200",
"message": "OK",
"buckets": [
{
"name": "<bucket_name>",
"detail": [
{
"data_time": "<Datatime string>", // yyyy-MM-dd
"storage": "<storage>"
}
]
},
……
]
}
| 필드명 | 필수 여부 | 설명 |
|---|---|---|
| buckets | 예 | 조회된 버킷 정보 |
| name | 예 | 버킷 이름 |
| detail | 예 | 버킷 상세 정보 |
| data_time | 예 | 통계 일자, yyyy-MM-dd 형식 |
| storage | 예 | 저장 용량 피크값(최대 사용량), 단위: MB, 소수점 셋째 자리까지 표시 |
- 요청이 실패할 경우, 아래와 같은 JSON 형식의 문자열이 반환됩니다:
{
"code": "<code string>",
"message": "<message string>"
}
| 필드명 | 필수 여부 | 설명 |
|---|---|---|
| code | 예 | HTTP 요청 응답 코드. |
| message | 예 | 버킷 정보 조회 실패 시 안내 메시지 |
예시
curl -v -o bucketlist.json -H "Authorization:86622e227a50d49d858c2494a935bc2e4ac543a7:NTVjZWZmOThhYjUzMjhkMWQ3YzE3OGM0NTRhYzFmODc5MDQ0MWExNQ==" --url "http://mgrDomain/bucket/stat?name=YnVja2V0MXxidWNrZXQyfGJ1Y2tldDM=&startdate=2017-01-01&enddate=2017-02-01"
이 문서의 내용이 도움이 되었습니까?
예
아니오