이미지 상세 정보 조회
이미지 상세 정보를 조회합니다
HTTP 요청
http
GET https://<your-console-host>/api/v1/compute/images/{imageId}URI 매개변수
| 이름 | 위치 | 필수 | 형식 | 설명 |
|---|---|---|---|---|
| imageId | path | 필수 | string | 이미지 ID |
요청 헤더
인증 헤더와 조직·파티션 헤더는 모든 API 가 같습니다. 공통 규약을 참고하십시오.
응답
| 상태 코드 | 설명 |
|---|---|
| 200 OK | Successful Response |
| 422 Unprocessable Entity | Validation Error |
위 표는 정상 응답과 요청 검증 실패만 나열합니다. 이 API 는 그 밖에 401(인증 실패) · 403(권한 없음) · 404(리소스 없음) · 502(인프라 오류)를 반환할 수 있습니다. 조건은 오류 처리를 참고하십시오.
응답 본문 — 200
| 이름 | 필수 | 형식 | 설명 |
|---|---|---|---|
| message | 선택 | string 또는 null | 응답 메시지 |
| timestamp | 선택 | string | 응답 생성 시간 |
| requestId | 필수 | string | 요청 식별자 |
| result | 필수 | object | 결과 데이터 |
| result.basicInfo | 필수 | object | 이미지 기본 정보 응답 |
| result.basicInfo.status | 선택 | string 또는 null | 이미지 상태 |
| result.basicInfo.imageId | 선택 | string 또는 null | 이미지 ID |
| result.basicInfo.imageName | 선택 | string 또는 null | 이미지 이름 |
| result.basicInfo.usageType | 선택 | string 또는 null | 사용 유형 (common_server/bare_metal) |
| result.basicInfo.osDistro | 선택 | string 또는 null | OS 배포판 |
| result.basicInfo.osVersion | 선택 | string 또는 null | OS 버전 |
| result.basicInfo.size | 선택 | number 또는 null | 이미지 크기 (GiB) |
| result.basicInfo.createdAt | 선택 | string 또는 null | 생성 일시 |
| result.basicInfo.description | 선택 | string 또는 null | 이미지 설명 |
| result.basicInfo.diskFormat | 선택 | string 또는 null | 디스크 포맷 |
| result.basicInfo.containerFormat | 선택 | string 또는 null | 컨테이너 포맷 |
| result.basicInfo.ownerProjectId | 선택 | string 또는 null | 소유자 프로젝트 ID |
| result.basicInfo.ownerProjectName | 선택 | string 또는 null | 소유자 프로젝트 이름 |
| result.basicInfo.visibility | 선택 | string 또는 null | 접근 권한 (visibility) |
| result.specInfo | 필수 | object | 이미지 스펙 정보 응답 |
| result.specInfo.size | 선택 | number 또는 null | 이미지 크기 (GiB) |
| result.specInfo.virtualSize | 선택 | number 또는 null | 이미지 가상 크기 (GiB) - 실제 디스크 이미지 크기 |
| result.specInfo.osDistro | 선택 | string 또는 null | OS 배포판 |
| result.specInfo.osVersion | 선택 | string 또는 null | OS 버전 |
| result.specInfo.diskFormat | 선택 | string 또는 null | 디스크 포맷 |
| result.specInfo.containerFormat | 선택 | string 또는 null | 컨테이너 포맷 |
| result.specInfo.minDisk | 선택 | integer | 최소 디스크 요구사항 (GB, 0 = 제약 없음). 기본값 0 |
| result.specInfo.minRam | 선택 | number | 최소 RAM 요구사항 (GiB, 0 = 제약 없음). 기본값 0 |
| result.securityInfo | 필수 | object | 이미지 보안 정보 응답 |
| result.securityInfo.ownerProjectId | 선택 | string 또는 null | 소유자 프로젝트 ID |
| result.securityInfo.ownerProjectName | 선택 | string 또는 null | 소유자 프로젝트 이름 |
| result.securityInfo.visibility | 선택 | string 또는 null | 접근 권한 (visibility) |
| result.securityInfo.protected | 선택 | boolean 또는 null | 삭제 보호 여부 |
| result.securityInfo.filename | 선택 | string 또는 null | 파일명 |
| result.securityInfo.checksum | 선택 | string 또는 null | 체크섬 |
| result.advancedInfo | 필수 | object | 이미지 고급 정보 응답 |
| result.advancedInfo.qemuGuestAgent | 선택 | boolean 또는 null | QEMU Guest Agent 사용 여부 |
| result.advancedInfo.cpuPolicy | 선택 | string 또는 null | CPU 정책 |
| result.advancedInfo.cpuThreadPolicy | 선택 | string 또는 null | CPU 쓰레드 정책 |
| result.metadata | 선택 | object | 메타데이터 (OpenStack properties) |