이미지 생성
이미지를 생성합니다 (multipart/form-data, 스트리밍 처리).
uploadFile 경로: parser(producer)와 Glance 업로드(consumer)를 동시 실행. fileUrl 경로: 전체 파싱 후 Glance import (기존과 동일).
HTTP 요청
http
POST https://<your-console-host>/api/v1/compute/imagesURI 매개변수
없습니다.
요청 헤더
인증 헤더와 조직·파티션 헤더는 모든 API 가 같습니다. 공통 규약을 참고하십시오.
응답
| 상태 코드 | 설명 |
|---|---|
| 201 Created | Successful Response |
| 422 Unprocessable Entity | Validation Error |
위 표는 정상 응답과 요청 검증 실패만 나열합니다. 이 API 는 그 밖에 401(인증 실패) · 403(권한 없음) · 404(리소스 없음) · 409(잠금·상태 전이 불가) · 413(쿼터 초과) · 502(인프라 오류)를 반환할 수 있습니다. 조건은 오류 처리를 참고하십시오.
응답 본문 — 201
| 이름 | 필수 | 형식 | 설명 |
|---|---|---|---|
| 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) |