Get bucket list
    • PDF

    Get bucket list

    • PDF

    Article summary

    Available in Classic and VPC

    Get the list of available Object Storage buckets when exporting logs retrieved from the Cloud Log Analytics service.

    Request

    This section describes the request format. The method and URI are as follows:

    MethodURI
    GET/api/{regionCode}-v1/export/buckets

    Request headers

    For information about the headers common to all Cloud Log Analytics APIs, see Cloud Log Analytics request headers.

    Request path parameters

    You can use the following path parameters with your request:

    FieldTypeRequiredDescription
    regionCodeStringRequiredRegion code
    • kr | sgn | jpn | uswn | den
      • kr: Korea Region
      • sgn: Singapore Region
      • jpn: Japan Region
      • uswn: US West Region
      • den: Germany Region

    Request example

    The request example is as follows:

    curl --location --request GET 'https://cloudloganalytics.apigw.ntruss.com/api/{regionCode}-v1/export/buckets' \
    --header 'x-ncp-apigw-timestamp: {Timestamp}' \
    --header 'x-ncp-iam-access-key: {Access Key}' \
    --header 'x-ncp-apigw-signature-v2: {API Gateway Signature}' \
    --header 'Content-Type: application/json' \
    -date '{
      "bucketname": "asdcx"
    }'
    

    Response

    This section describes the response format.

    Response body

    The response body includes the following data:

    FieldTypeRequiredDescription
    codeInteger-Response status codes
    messageString-Response status message
    resultObject-Response result
    result.memberNoInteger-User's NAVER Cloud Platform member ID
    result.returnCodeInteger-Return code
    result.subAccountNoInteger-Sub account number
    result.returnMsgString-Return message
    result.boxUsageInteger-Bucket usage
    result.regionNoInteger-Region number
    result.bucketListArray-Object Storage's bucket list

    bucketList

    The following describes bucketList.

    FieldTypeRequiredDescription
    nameInteger-Bucket name
    bytesUsedInteger-Available bucket capacity
    storageLocationString-Bucket location
    objectCountInteger-Number of objects
    creationTimeString-Bucket creation date

    Response status codes

    For response status codes common to all Cloud Log Analytics APIs, see Cloud Log Analytics response status codes.

    Response example

    The response example is as follows:

    {
        "code": 0,
        "message": "The request has been successfully processed.",
        "result": {
            "memberNo": "*******",
            "returnCode": null,
            "subAccountNo": null,
            "returnMsg": null,
            "boxUsage": null,
            "regionNo": "1",
            "bucketList": [
                {
                    "name": "test.cla",
                    "bytesUsed": 526150,
                    "storageLocation": "KR-Container",
                    "objectCount": 6,
                    "creationTime": 1729491347694
                }
            ]
        }
    }
    

    Was this article helpful?

    What's Next
    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.