버킷 목록 조회

Prev Next

VPC 환경에서 이용 가능합니다.

설명

Bucket 목록을 확인합니다.

  • API 호출에 사용된 x-ncp-iam-access-key 기반으로 Bucket의 사용 권한을 확인합니다.

요청

요청 URL

GET https://vpcsearchengine.apigw.gov-ntruss.com/api/v2/import/getBucketList/{service-group-instance-no} [수도권]
GET https://vpcsearchengine.apigw.gov-ntruss.com/api/krs-v2/import/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 사용 가능한 버킷 목록을 확인할 클러스터 번호

요청 예시

GET https://vpcsearchengine.apigw.gov-ntruss.com/api/v2/import/createDataImportJob/1714400
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/import/createDataImportJob/1714400" \
-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"
}