레지스트리 목록 조회
- 인쇄
- PDF
레지스트리 목록 조회
- 인쇄
- PDF
기사 요약
이 요약이 도움이 되었나요?
의견을 보내 주셔서 감사합니다.
Classic/VPC 환경에서 이용 가능합니다.
Container Registry에 등록된 레지스트리 목록을 조회합니다.
요청
요청 형식을 설명합니다. 요청 형식은 다음과 같습니다.
| 메서드 | URI |
|---|---|
| GET | /repositories |
요청 헤더
Container Registry API에서 공통으로 사용하는 헤더에 대한 자세한 내용은 Container Registry 공통 헤더를 참조해 주십시오.
요청 쿼리 파라미터
요청 쿼리 파라미터에 대한 설명은 다음과 같습니다.
| 필드 | 타입 | 필수 여부 | 설명 |
|---|---|---|---|
page | Number | Optional | 조회할 페이지 번호
|
pagesize | Number | Optional | 조회할 페이지 크기
|
요청 예시
요청 예시는 다음과 같습니다.
curl -X GET "https://ncr.apigw.ntruss.com/ncr/api/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 | - | 다음 페이지의 번호
|
previous | Number | - | 이전 페이지의 번호
|
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 | - | 도커 클라이언트가 레지스트리에 접근하기 위한 엔드포인트
|
results[].private_id | String | - | Private 엔드포인트의 아이디 |
results[].public_reg_status | Boolean | - | 인증 없이 접근한 사용자의 Pull 권한 여부
|
results[].scan_on_push_enabled | Boolean | - | 컨테이너 이미지 업로드 시 취약점 자동 스캔 여부
|
results[].status | String | - | 레지스트리와 Object Storage의 연동 상태
|
응답 상태 코드
응답 상태 코드는 다음과 같습니다. Container Registry API에서 공통으로 사용하는 응답 상태 코드에 대한 자세한 내용은 Container Registry 응답 상태 코드를 참조해 주십시오.
| HTTP 상태 코드 | 코드 | 메시지 | 설명 |
|---|---|---|---|
| 200 | - | OK | 요청 성공 |
응답 예시
응답 예시는 다음과 같습니다.
{
"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"
}
]
}
이 문서가 도움이 되었습니까?