레지스트리 목록 조회

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

Container Registry에 등록된 레지스트리 목록을 조회합니다.

요청

요청 형식을 설명합니다. 요청 형식은 다음과 같습니다.

메서드	URI
GET	/repositories

요청 헤더

Container Registry API에서 공통으로 사용하는 헤더에 대한 자세한 내용은 Container Registry 공통 헤더를 참조해 주십시오.

요청 쿼리 파라미터

요청 쿼리 파라미터에 대한 설명은 다음과 같습니다.

필드	타입	필수 여부	설명
`page`	Number	Optional	조회할 페이지 번호 페이지 번호는 0보다 큰 값을 입력
`pagesize`	Number	Optional	조회할 페이지 크기 페이지 크기는 0보다 큰 값을 입력

요청 예시

요청 예시는 다음과 같습니다.

curl -X GET "https://gov-ncr.apigw.gov-ntruss.com/ncr/kr/v2/repositories" 
-H "Content-Type: application/json; charset=utf-8"
-H "x-ncp-apigw-timestamp: {Timestamp}"
-H "x-ncp-iam-access-key: {Sub Account Access Key}"
-H "x-ncp-apigw-signature-v2: {API Gateway Signature}"

응답

응답 형식을 설명합니다.

응답 구문

응답 구문은 다음과 같습니다.

{
    "count": "number",
    "next": "number",
    "previous": "number",
    "results": [
        {
            "bucket": "string",
            "created": "number",
            "end_point": "string",
            "end_point_enabled": "boolean",
            "name": "string",
            "private_end_point": "string",
            "private_id": "string",
            "public_reg_status": "boolean",
            "scan_on_push_enabled": "boolean",
            "status": "string"
        }
    ]
}

응답 바디

응답 바디에 대한 설명은 다음과 같습니다.

필드	타입	필수 여부	설명
`count`	Number	-	등록된 레지스트리의 총 개수
`next`	Number	-	다음 페이지의 번호 다음 페이지가 없다면 `null`을 반환
`previous`	Number	-	이전 페이지의 번호 이전 페이지가 없다면 `null`을 반환
`results[].bucket`	String	-	레지스트리와 연동된 Object Storage의 버킷 이름
`results[].created`	Number	-	레지스트리 생성일
`results[].end_point`	String	-	도커 클라이언트가 레지스트리에 접근하기 위한 엔드포인트
`results[].end_point_enabled`	Boolean	-	엔드포인트 접근 가능 여부
`results[].name`	String	-	레지스트리 이름
`results[].private_end_point`	String	-	도커 클라이언트가 레지스트리에 접근하기 위한 엔드포인트 네이버 클라우드 플랫폼의 VPC 네트워크에서만 사용 가능
`results[].private_id`	String	-	Private 엔드포인트의 아이디
`results[].public_reg_status`	Boolean	-	인증 없이 접근한 사용자의 Pull 권한 여부 `true` \| `false`
`results[].scan_on_push_enabled`	Boolean	-	컨테이너 이미지 업로드 시 취약점 자동 스캔 여부 `true` \| `false`
`results[].status`	String	-	레지스트리와 Object Storage의 연동 상태 `running` \| `disconnected` `running`: 정상 상태 `disconnected`: 버킷이 삭제됨

응답 상태 코드

Container Registry API에서 공통으로 사용하는 응답 상태 코드에 대한 자세한 내용은 Container Registry 응답 상태 코드를 참조해 주십시오.

응답 예시

응답 예시는 다음과 같습니다.

{
    "count": 1,
    "next": null,
    "previous": null,
    "results": [
        {
            "bucket": "ncpdocker",
            "created": 1711695272000,
            "end_point": "ncpdocker.kr.ncr.ntruss.com",
            "end_point_enabled": true,
            "name": "ncpdocker",
            "private_end_point": "pdxxxnzd.kr.private-ncr.ntruss.com",
            "private_id": "pdxxxnzd",
            "public_reg_status": false,
            "scan_on_push_enabled": false,
            "status": "running"
        }
    ]
}