버킷 목록 조회
- 인쇄
- PDF
버킷 목록 조회
- 인쇄
- PDF
기사 요약
이 요약이 도움이 되었나요?
의견을 보내 주셔서 감사합니다.
Object Storage Bucket 목록을 조회합니다.
요청
요청 URL
GET https://vpcsearchengine.apigw.gov-ntruss.com/api/v2/snapshot/getBucketList/{service-group-instance-no} [수도권]
GET https://vpcsearchengine.apigw.gov-ntruss.com/api/krs-v2/snapshot/getBucketList/{service-group-instance-no} [남부권]
요청 헤더
| 헤더명 | 설명 |
|---|---|
| x-ncp-apigw-timestamp | 1970년 1월 1일 00:00:00 협정 세계시(UTC)부터의 경과 시간을 밀리초(Millisecond)로 나타낸 것 API Gateway 서버와 시간 차가 5분 이상 나는 경우 유효하지 않은 요청으로 간주 x-ncp-apigw-timestamp:{Timestamp} |
| x-ncp-iam-access-key | 네이버 클라우드 플랫폼 포털에서 발급받은 Access Key ID 값x-ncp-iam-access-key:{Account Access Key} |
| x-ncp-apigw-signature-v2 | Access Key ID 값과 Secret Key로 암호화한 서명x-ncp-apigw-signature-v2:{API Gateway Signature} |
| Content-Type | Request body content type을 application/json으로 지정 - Content-Type: application/json |
요청 파라미터
| 파라미터 | 타입 | 필수 여부 | 설명 |
|---|---|---|---|
| serviceGroupInstanceNo | String | Y | 사용 가능한 Bucket 목록을 조회할 Cluster 번호 |
| 설정된 API 인증키를 기반으로 사용할 수 있는 Bucket 목록을 조회합니다. |
요청 예시
GET https://vpcsearchengine.apigw.gov-ntruss.com/api/v2/snapshot/getBucketList/1789920
HOST: vpcsearchengine.apigw.gov-ntruss.com
Content-Type: application/json
x-ncp-apigw-signature-v2: zq0FrtlU8JZJi9esTK31bCQUNG3H+jo4CMjMkJDoWSc=
x-ncp-apigw-timestamp: 1593848345548
x-ncp-iam-access-key: 7fIvgFY428mtY6sY8maw
curl -X GET "https://vpcsearchengine.apigw.gov-ntruss.com/api/v2/snapshot/getBucketList/1789920 \
-H "accept: application/json" \
-H "Content-Type: application/json" \
-H "x-ncp-iam-access-key: 7fIvgFY428mtY6sY8maw" \
-H "x-ncp-apigw-timestamp: 1601971222179" \
-H "x-ncp-apigw-signature-v2: zrCelnR48AADdK/uh6Xe3yy468i8KpQoewYHUmeqYh4="
응답 파라미터
public class GetObjectStorageBucketList {
List<BucketInfo> bucketList;
}
public class BucketInfo {
String name;
Long bytesUsed;
Long objectCount;
Long creationTime;
}
응답 예시
{
"code": 0,
"message": "SUCCESS",
"result": {
"bucketList": [
{
"name": "common",
"bytesUsed": 8053428730,
"objectCount": 1174,
"creationTime": 1626053207541,
"bucketProtectionState": "DISABLED",
"permission": "Allow"
},
{
"name": "common2",
"bytesUsed": 25542177823,
"objectCount": 227,
"creationTime": 1626054508184,
"bucketProtectionState": "DISABLED",
"permission": "Allow"
},
{
"name": "estest",
"bytesUsed": 981474971046,
"objectCount": 11508,
"creationTime": 1626053041402,
"bucketProtectionState": "DISABLED",
"permission": "Allow"
}
]
},
"requestId": "d7ea6d82-afcc-4675-886a-f304497ea465"
}
이 문서가 도움이 되었습니까?