GetContainerList
    • PDF

    GetContainerList

    • PDF

    기사 요약

    개요

    컨테이너(버킷)의 목록을 조회합니다.

    주의

    Subaccount의 경우, Subaccount 전용 External API Gateway를 통해 사용할 수 있습니다.
    자세한 내용은 Subaccount를 참고해 주십시오.

    구문

    GET v1/AUTH_{project_id}
    

    요청

    요청 파라미터

    NameInTypeDescription
    limit (Optional)queryinteger호출 결과의 최대 개수 제한
    marker (Optional)querystring특정 컨테이너 이후 목록을 가져옴
    end_marker (Optional)querystring특정 컨테이너 이전 목록을 가져옴
    prefix (Optional)querystring해당 문자열로 시작하는 컨테이너 목록 호출
    reverse (Optional)querystring컨테이너의 이름으로 정렬하여 목록 출력
    default : false (descending)
    X-Auth-Token (Optional)headerstring발급한 Token 값 입력
    Accept (Optional)headerstring호출 결과의 포맷 지정 (application/json, application/xml, text/xml)

    응답

    응답 헤더

    NameInTypeDescription
    X-Account-Meta-nameheaderstring- 해당 계정의 메타데이터 정보
    - 헤더명의 name 부분이 메타데이터의 키 역할을 함
    Content-Lengthheaderstring응답 결과의 길이 (Bytes)
    X-Container-Object-Countheaderinteger해당 컨테이너(버킷)의 오브젝트 개수
    X-Container-Bytes-Usedheaderinteger해당 컨테이너(버킷)가 사용하는 전체 용량 크기 (Bytes)
    X-Container-Meta-Temp-URL-Key (Optional)headerstringtemporary URL을 위한 Secret Key 값
    X-Container-Meta-Temp-URL-Key-2 (Optional)headerstringtemporary URL을 위한 두 번째 Secret Key 값
    X-Timestampheaderinteger해당 컨테이너(버킷)가 생성된 시각 (UNIX Time)
    X-Trans-Idheaderstring해당 요청의 트랜젝션 ID
    X-Openstack-Request-Idheaderstring해당 요청의 트랜젝션 ID (X-Trans-Id와 동일)
    Content-Typeheaderstring응답 결과의 포맷
    Dateheaderstring해당 요청의 응답 시간 (UTC)

    응답 바디

    NameInTypeDescription
    namebodystring해당 오브젝트의 이름
    countbodyinteger해당 컨테이너(버킷)의 오브젝트 개수
    bytesbodyinteger해당 컨테이너(버킷)가 사용하는 전체 용량 크기 (Bytes)
    last_modifiedbodystring해당 컨테이너가 마지막으로 변경된 시각 (UTC)

    예시

    요청 예시(JSON)

    curl -i -X GET -H "X-Auth-Token: $token" https://kr.archive.gov-ncloudstorage.com/v1/AUTH_{project_id}/{container}?format=json
    

    응답 예시

    HTTP/1.1 200 OK
    Content-Length: 96
    X-Account-Object-Count: 1
    X-Timestamp: 1389453423.35964
    X-Account-Meta-Subject: Literature
    X-Account-Bytes-Used: 14
    X-Account-Container-Count: 2
    Content-Type: application/json; charset=utf-8
    Accept-Ranges: bytes
    X-Trans-Id: tx274a77a8975c4a66aeb24-0052d95365
    X-Openstack-Request-Id: tx274a77a8975c4a66aeb24-0052d95365
    Date: Fri, 17 Jan 2014 15:59:33 GMT
    
    [
        {
            "count": 0,
            "bytes": 0,
            "name": "janeausten",
            "last_modified": "2013-11-19T20:08:13.283452"
        },
        {
            "count": 1,
            "bytes": 14,
            "name": "marktwain",
            "last_modified": "2016-04-29T16:23:50.460230"
        }
    ]
    

    요청 예시(XML)

    curl -i -X GET -H "X-Auth-Token: $token" https://kr.archive.gov-ncloudstorage.com/v1/AUTH_{project_id}?format=XML
    

    응답 예시

    HTTP/1.1 200 OK
    Content-Length: 262
    X-Account-Object-Count: 1
    X-Timestamp: 1389453423.35964
    X-Account-Meta-Subject: Literature
    X-Account-Bytes-Used: 14
    X-Account-Container-Count: 2
    Content-Type: application/xml; charset=utf-8
    Accept-Ranges: bytes
    X-Trans-Id: tx69f60bc9f7634a01988e6-0052d9544b
    X-Openstack-Request-Id: tx69f60bc9f7634a01988e6-0052d9544b
    Date: Fri, 17 Jan 2014 16:03:23 GMT
    
    <?xml version="1.0" encoding="UTF-8"?>
    <account name="my_account">
        <container>
            <name>janeausten</name>
            <count>0</count>
            <bytes>0</bytes>
            <last_modified>2013-11-19T20:08:13.283452</last_modified>
        </container>
        <container>
            <name>marktwain</name>
            <count>1</count>
            <bytes>14</bytes>
            <last_modified>2016-04-29T16:23:50.460230</last_modified>
        </container>
    </account>
    

    요청이 성공하게 되면 OK(200), No Content(204) 상태 코드를 응답합니다.
    No Content (204)인 경우는 Content-Type이 plain 이고, 요청에 해당되는 내용이 없는 경우 발생합니다.
    컨테이너(버킷)이 존재하지 않는 경우는 Not Found (403) 상태 코드를 응답합니다.

    주의

    SubAccount의 경우 SubAccount전용 목록 조회 API를 사용해야 합니다.


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

    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.