MENU
      버킷 목록 조회

        버킷 목록 조회


        기사 요약

        설명

        Object Storage Bucket 목록을 조회합니다.

        • 설정한 API 인증키 기반으로 Bucket의 사용 권한을 확인합니다.

        요청

        요청 URL

        GET https://vpcsearchengine.apigw.ntruss.com/api/v2/snapshot/getBucketList/{service-group-instance-no} [KR]
        GET https://vpcsearchengine.apigw.ntruss.com/api/sgn-v2/snapshot/getBucketList/{service-group-instance-no} [SGN]
        HTTP

        요청 헤더

        헤더명설명
        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-v2Access Key ID 값과 Secret Key로 암호화한 서명
        x-ncp-apigw-signature-v2:{API Gateway Signature}
        Content-TypeRequest body content type을 application/json으로 지정
        Content-Type: application/json

        요청 예시

        GET https://vpcsearchengine.apigw.ntruss.com/api/v2/snapshot/getBucketList/1789920
        HOST: vpcsearchengine.apigw.ntruss.com
        Content-Type: application/json
        x-ncp-apigw-signature-v2: zq0FrtlU8JZJi9esTK31bCQUNG3H+jo4CMjMkJDoWSc=
        x-ncp-apigw-timestamp: 1593848345548
        x-ncp-iam-access-key: 7fIvgFY428mtY6sY8maw
        HTTP
        curl -X GET "https://vpcsearchengine.apigw.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="
        Bash

        응답 파라미터

        public class GetObjectStorageBucketList {
            List<BucketInfo> bucketList;
        }
        
        public class BucketInfo {
            String name;
            Long bytesUsed;
            Long  objectCount;
            Long creationTime;
        }
        Java

        응답 예시

        {
          "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"
        }
        JSON

        이 문서가 도움이 되었습니까?

        Changing your password will log you out immediately. Use the new password to log back in.
        First name must have atleast 2 characters. Numbers and special characters are not allowed.
        Last name must have atleast 1 characters. Numbers and special characters are not allowed.
        Enter a valid email
        Enter a valid password
        Your profile has been successfully updated.