更新NFV组

PUT/zstack/v1/nfvinstgroup/group/{uuid}/actions

操作 ID

UpdateNfvInstGroup

起始版本

3.5

执行模式

同步

认证信息

需要认证

认证信息

调用该 API 时需要在请求头中携带以下认证信息。

Authorizationstring必填

Bearer 令牌

X-Tenant-IDstring

X-Tenant-ID

请求参数

application/json

路径参数

uuid
String必填
资源的UUID，唯一标示该资源

请求体字段

updateNfvInstGroupstructure
Object必填
请求体对象。
- name
  String
  资源名称。
- description
  String
  资源的详细描述。
systemTags
List
系统标签。
userTags
List
用户标签。

响应状态

200 OK

该 API 成功时返回以下响应结构。

success
boolean必填
操作是否成功。
error
ErrorCode必填
错误码，若不为null，则表示操作失败, 操作成功时该字段为null。详情参考error
- code
  String必填
  错误码号，错误的全局唯一标识，例如SYS.1000, HOST.1001
- description
  String必填
  错误的概要描述
- details
  String必填
  错误的详细信息
- elaboration
  String必填
  保留字段，默认为null
- opaque
  LinkedHashMap必填
  保留字段，默认为null
- cause
  ErrorCode必填
  根错误，引发当前错误的源错误，若无原错误，该字段为null
inventory
NfvInstGroupInventory必填
详情参考inventory
- name
  String必填
  资源名称
- uuid
  String必填
  资源的UUID，唯一标示该资源
- description
  String
  资源的详细描述
- nfvInstOfferingUuid
  String必填
  暂无描述。
- configVersion
  int必填
  配置版本。
- netOsDistro
  String必填
  net操作系统distro。
- baseOsDistro
  String必填
  基础操作系统distro。
- statusDetail
  String必填
  状态详情。
- createDate
  Timestamp必填
  创建时间
- lastOpDate
  Timestamp必填
  最后一次修改时间
- vipUuid
  String必填
  暂无描述。
- ipv6VipUuid
  String必填
  暂无描述。
- primaryStorageUuid
  String必填
  主存储UUID
- primaryStoragePoolUuid
  String必填
  主存储池UUID。
- clusterUuid
  String必填
  集群UUID
- zoneUuid
  String必填
  区域UUID
- instType
  InstType必填
  详情参考instType
  KVM
  InstType必填
  暂无描述。
  CONTAINER
  InstType必填
  容器。
  HOST
  InstType必填
  主机。
- funcType
  FuncType必填
  详情参考funcType
  OVN_SDN_CONTROLLER
  FuncType必填
  暂无描述。
- status
  NfvInstGroupStatus必填
  详情参考status
  Initializing
  NfvInstGroupStatus必填
  暂无描述。
  Healthy
  NfvInstGroupStatus必填
  健康。
  Degraded
  NfvInstGroupStatus必填
  降级。
  Operating
  NfvInstGroupStatus必填
  操作。
  Unavailable
  NfvInstGroupStatus必填
  不可用。
- operationMode
  NfvInstGroupOperationMode必填
  详情参考operationMode
  Normal
  NfvInstGroupOperationMode必填
  正常。
  Maintenance
  NfvInstGroupOperationMode必填
  维护。
- instances
  List必填
  详情参考instances
  configVersion
  int必填
  配置版本。
  nfvInstGroupUuid
  String必填
  暂无描述。
  netOsDistro
  String必填
  net操作系统distro。
  baseOsDistro
  String必填
  基础操作系统distro。
  clusterStatus
  String必填
  集群状态。
  statusDetail
  String必填
  状态详情。
  applianceVmType
  String必填
  设备云主机实例类型。
  managementNetworkUuid
  String必填
  管理网络UUID。
  defaultRouteL3NetworkUuid
  String必填
  默认route三层3网络UUID。
  status
  String必填
  状态信息。
  Initializing
  NfvInstGroupStatus必填
  暂无描述。
  Healthy
  NfvInstGroupStatus必填
  健康。
  Degraded
  NfvInstGroupStatus必填
  降级。
  Operating
  NfvInstGroupStatus必填
  操作。
  Unavailable
  NfvInstGroupStatus必填
  不可用。
  agentPort
  Integer必填
  代理端口。
  haStatus
  String必填
  HA状态。
  uuid
  String必填
  资源的UUID，唯一标示该资源
  name
  String必填
  资源名称
  description
  String
  资源的详细描述
  zoneUuid
  String必填
  区域UUID
  clusterUuid
  String必填
  集群UUID
  imageUuid
  String必填
  镜像UUID
  hostUuid
  String必填
  物理机UUID
  lastHostUuid
  String必填
  最近一次主机UUID。
  instanceOfferingUuid
  String必填
  计算规格UUID
  rootVolumeUuid
  String必填
  根云盘UUID
  platform
  String必填
  平台。
  architecture
  String必填
  架构。
  defaultL3NetworkUuid
  String必填
  默认三层3网络UUID。
  type
  String必填
  类型。
  hypervisorType
  String必填
  hypervisor类型。
  memorySize
  Long必填
  内存大小。
  reservedMemorySize
  Long必填
  已预留内存大小。
  cpuNum
  Integer必填
  暂无描述。
  cpuSpeed
  Long必填
  暂无描述。
  allocatorStrategy
  String必填
  allocator策略。
  createDate
  Timestamp必填
  创建时间
  lastOpDate
  Timestamp必填
  最后一次修改时间
  state
  String必填
  当前状态。
  guestOsType
  String必填
  guest操作系统类型。
  vmNics
  List必填
  详情参考vmNics
  uuid
  String必填
  资源的UUID，唯一标示该资源
  vmInstanceUuid
  String必填
  云主机UUID
  l3NetworkUuid
  String必填
  三层网络UUID
  ip
  String必填
  来源IP地址。
  mac
  String必填
  MAC地址。
  hypervisorType
  String必填
  hypervisor类型。
  netmask
  String必填
  暂无描述。
  gateway
  String必填
  网关IP地址。
  metaData
  String必填
  元数据。
  ipVersion
  Integer必填
  IP版本。
  driverType
  String必填
  driver类型。
  internalName
  String必填
  内部名称。
  deviceId
  Integer必填
  设备ID。
  type
  String必填
  类型。
  state
  String必填
  网卡状态
  createDate
  Timestamp必填
  创建时间
  lastOpDate
  Timestamp必填
  最后一次修改时间
  usedIps
  List必填
  详情参考usedIps
  uuid
  String必填
  资源的UUID，唯一标示该资源
  ipRangeUuid
  String必填
  IP段UUID
  l3NetworkUuid
  String必填
  三层网络UUID
  ipVersion
  Integer必填
  IP版本。
  ip
  String必填
  来源IP地址。
  netmask
  String必填
  暂无描述。
  gateway
  String必填
  网关IP地址。
  usedFor
  String必填
  分配原因
  ipInLong
  long必填
  IP地址represented长integer。
  ipInBinary
  byte[]必填
  暂无描述。
  vmNicUuid
  String必填
  云主机网卡UUID
  createDate
  Timestamp必填
  创建时间
  lastOpDate
  Timestamp必填
  最后一次修改时间
  allVolumes
  List必填
  详情参考allVolumes
  uuid
  String必填
  资源的UUID，唯一标示该资源
  name
  String必填
  资源名称
  description
  String
  资源的详细描述
  primaryStorageUuid
  String必填
  主存储UUID
  vmInstanceUuid
  String必填
  云主机UUID
  diskOfferingUuid
  String必填
  云盘规格UUID
  rootImageUuid
  String必填
  根镜像UUID。
  installPath
  String必填
  安装路径。
  type
  String必填
  类型。
  format
  String必填
  数据格式或导出格式。
  size
  Long必填
  返回记录数。
  actualSize
  Long必填
  实际大小。
  deviceId
  Integer必填
  设备ID。
  state
  String必填
  当前状态。
  status
  String必填
  状态信息。
  Initializing
  NfvInstGroupStatus必填
  暂无描述。
  Healthy
  NfvInstGroupStatus必填
  健康。
  Degraded
  NfvInstGroupStatus必填
  降级。
  Operating
  NfvInstGroupStatus必填
  操作。
  Unavailable
  NfvInstGroupStatus必填
  不可用。
  createDate
  Timestamp必填
  创建时间
  lastOpDate
  Timestamp必填
  最后一次修改时间
  isShareable
  Boolean必填
  是否资源可分享。
  volumeQos
  String必填
  暂无描述。
  lastDetachDate
  Timestamp必填
  最近一次detach时间。
  lastVmInstanceUuid
  String必填
  最近一次云主机实例UUID。
  vmCdRoms
  List必填
  详情参考vmCdRoms
  uuid
  String必填
  资源的UUID，唯一标示该资源
  vmInstanceUuid
  String必填
  云主机UUID
  deviceId
  Integer必填
  设备ID。
  isoUuid
  String必填
  暂无描述。
  isoInstallPath
  String必填
  iso安装路径。
  name
  String必填
  资源名称
  description
  String
  资源的详细描述
  createDate
  Timestamp必填
  创建时间
  lastOpDate
  Timestamp必填
  最后一次修改时间
- monitors
  List必填
  详情参考monitors
  id
  Long必填
  资源ID。
  nfvInstGroupUuid
  String必填
  暂无描述。
  monitorIp
  String必填
  监控IP。
  createDate
  Timestamp必填
  创建时间
  lastOpDate
  Timestamp必填
  最后一次修改时间
- services
  List必填
  详情参考services
  id
  Long必填
  资源ID。
  nfvInstGroupUuid
  String必填
  暂无描述。
  networkServiceName
  String必填
  网络服务名称。
  networkServiceUuid
  String必填
  网络服务UUID。
  createDate
  Timestamp必填
  创建时间
  lastOpDate
  Timestamp必填
  最后一次修改时间
- configTasks
  List必填
  详情参考configTasks
  id
  long必填
  资源ID。
  nfvInstGroupUuid
  String必填
  暂无描述。
  configVersion
  int必填
  配置版本。
  serviceUuid
  String必填
  服务UUID。
  taskName
  String必填
  任务名称。
  taskData
  String必填
  任务数据。
  path
  String必填
  路径。
  checkStatus
  boolean必填
  检查状态。
- l3Networks
  List必填
  详情参考l3Networks
  nfvInstGroupUuid
  String必填
  暂无描述。
  networkServiceUuid
  String必填
  网络服务UUID。
  l3NetworkUuid
  String必填
  三层网络UUID
  l3NetworkCategory
  String必填
  三层3网络分类。
  l3NetworkType
  String必填
  三层3网络类型。
  type
  String必填
  类型。
  createDate
  Timestamp必填
  创建时间
  lastOpDate
  Timestamp必填
  最后一次修改时间

请求示例

转换警告

python: command should begin with "curl" but instead begins with "http://localhost:8080/zstac..." http://localhost:8080/zstack/v1/nfvinstgroup/group/ff57ab6e79613a40b7e55d38e3069ea5/actions ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
javascript: command should begin with "curl" but instead begins with "http://localhost:8080/zstac..." http://localhost:8080/zstack/v1/nfvinstgroup/group/ff57ab6e79613a40b7e55d38e3069ea5/actions ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
java: command should begin with "curl" but instead begins with "http://localhost:8080/zstac..." http://localhost:8080/zstack/v1/nfvinstgroup/group/ff57ab6e79613a40b7e55d38e3069ea5/actions ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
go: command should begin with "curl" but instead begins with "http://localhost:8080/zstac..." http://localhost:8080/zstack/v1/nfvinstgroup/group/ff57ab6e79613a40b7e55d38e3069ea5/actions ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

curl -X PUT '{host}/zstack/v1/nfvinstgroup/group/{uuid}/actions' \
  -H 'Authorization: Bearer {token}' \
  -H 'Content-Type: application/json' \
  -d '{
  "updateNfvInstGroupstructure": {
    "name": "{name}",
    "description": "{description}"
  },
  "systemTags": [
    "{systemTags}"
  ],
  "userTags": [
    "{userTags}"
  ]
}'

响应示例

{
  "inventory": {
    "name": "test-nfvinstgroup",
    "uuid": "ca9371db50593f2786205e163e5e99d6",
    "description": "nfv inst group description",
    "configVersion": 0,
    "l3Networks": []
  }
}

变更历史

查看全部变更历史

变更时间变更内容概要操作

变更时间
2026-09-23
新增请求体字段 updateNfvInstGroupstructure
查看 API

云主机相关接口

云盘相关接口

镜像相关接口

亲和组相关接口

云主机调度策略相关接口

计算规格相关接口

云盘规格相关接口

弹性伸缩组相关接口

快照组相关接口

SSH密钥相关接口

区域相关接口

集群相关接口

物理机相关接口

GPU设备相关接口

主存储相关接口

镜像服务器相关接口

SAN存储相关接口

物理网络相关接口

PCI设备相关接口

USB重定向相关接口

USB透传相关接口

SR-IOV相关接口

龙芯SE模块相关接口

海光SE模块相关接口

本地存储相关接口

NFS主存储相关接口

Shared Mount Point主存储相关接口

Ceph主存储相关接口

Shared Block主存储相关接口

XStor Block主存储相关接口

镜像仓库服务器相关接口

Ceph镜像服务器相关接口

iSCSI服务器相关接口

FC存储相关接口

NVMe存储相关接口

SDN设备相关接口

二层网络资源相关接口

三层网络相关接口

路由资源相关接口

VPC相关接口

OSPF相关接口

组播路由相关接口

策略路由相关接口

路由器路由表相关接口

网络服务相关接口

防火墙相关接口

安全组相关接口

虚拟IP相关接口

弹性IP相关接口

端口转发相关接口

负载均衡相关接口

IPsec相关接口

Netflow相关接口

端口镜像相关接口

共享带宽相关接口

安全策略定时计划相关接口

资源编排相关接口

裸金属管理相关接口

安装服务相关接口

弹性裸金属管理(Plus)

vCenter相关接口

容量管理相关接口

管理节点相关接口

通知服务相关接口

时序数据（Metric）

事件（Event）

报警器（Alarm）

事件订阅（Event Subscription）

报警文本模板（Text Template）

审计

CBT相关接口

灾备服务相关接口

持续数据保护(CDP)相关接口

脚本库相关接口

XML Hook相关接口

定时运维相关接口

标签管理相关接口

迁移服务相关接口

组织架构相关接口

项目管理相关接口