ProxmoxVE-AMS

手动新增OS

POST

/{adminPath}/insertOs

最后修改时间：2023-08-13 08:55:29

责任人：mryunqi

新增OS

请求参数

Path 参数

adminPath

string

后台路径

必需

示例值:

admin

Header 参数

Authorization

string

可选

Body 参数application/json

name

string

必需

系统名称（别称，可自定义）

fileName

string

文件全称，带后缀

必需

type

string

必需

镜像类型（win，linux）

arch

string | null

可选

镜像架构（默认x86_64）[x86_64,arm64,arm64,armhf,ppc64el,riscv64,s390x,aarch64,armv7l]

osType

string | null

可选

镜像系统类别名称，type为linux时必须填写[centos,debian,ubuntu,alpine,fedora,opensuse,ubuntukylin,other]

downType

integer

必需

添加类型（0=自动下载;1=手动上传），为0时url参数不能为空

url

string | null

可选

下载地址（downType为0时禁止为空）

path

string | null

可选

pve节点下储存路径，值为空或default则默认为/home/images

cloud

integer | null

可选

是否开启cloud-init（0=未开启，1=开启，默认为0）

示例

{
  "name": "Ubuntu-22.04-x64",
  "fileName": "Ubuntu-22.04-x64.qcow2",
  "type": "linux",
  "downType": 37,
  "arch": "x86_64",
  "url": "http://oa.chuqiyun.com:8877/Cloud/Ubuntu/Ubuntu-22.04-x64.qcow2",
  "path": "default",
  "osType": "ubuntu",
  "cloud": 1
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/admin/insertOs' \
--header 'Authorization;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "name": "Ubuntu-22.04-x64",
    "fileName": "Ubuntu-22.04-x64.qcow2",
    "type": "linux",
    "downType": 37,
    "arch": "x86_64",
    "url": "http://oa.chuqiyun.com:8877/Cloud/Ubuntu/Ubuntu-22.04-x64.qcow2",
    "path": "default",
    "osType": "ubuntu",
    "cloud": 1
}'

返回响应

🟢200成功

application/json

Body

code

integer

必需

message

string

必需

data

string

必需

示例

{
  "code": 20000,
  "message": "请求成功",
  "data": "添加成功"
}

修改于 2023-08-13 08:55:29

激活在线OS

分页获取已添加OS