获取指定资源类的信息NodeCount

GET

/hosts/node-count

获取指定资源类的信息NodeCount

请求参数

Query 参数

limit

integer

查询限制量

可选

offset

integer

查询偏移量

可选

order_by

array[string]

可选

列表排序时，用于排序的字段的名称，该字段不提供时，则按默认字段排序。一般时按照资源的新建时间逆序排序。

order

string

可选

列表排序时的顺序，desc为从高到低，asc为从低到高。默认是按照资源的创建时间desc排序。

示例值:

desc|asc

details

string

可选

列表返回资源的更多详细信息。默认只显示基本字段，该字段为true则返回扩展字段信息。

string

模糊搜索所有字段

可选

filter

array[string]

可选

指定过滤条件，允许指定多个，每个条件的格式为"字段名称.操作符(匹配信息)"，例如name字段等于test的过滤器为：name.equals('test')
支持的操作符如下：

操作符	参数个数	举例	说明
in	> 0	name.in("test", "good")	在给定数组中
notin	> 0	name.notin('test')	不在给定数组中
between	2	created_at.between('2019-12-10', '2020-01-02')	在两个值之间
ge	1	created_at.ge('2020-01-01')	大于或等于给定值
gt	1	created_at.gt('2020-01-01')	严格大于给定值
le	1	created_at.le('2020-01-01')	小于或等于给定值
lt	1	sync_seconds.lt(900)	严格大于给定值
like	> 0	name.like('%test%')	sql字符串匹配任意一个字符串
contains	> 0	name.contains('test')	包含任意一个给定字符串
startswith	> 0	name.startswith('test')	以任意一个给定字符串开头
endswith	> 0	name.endswith('test')	以任意一个给定字符串结尾
equals	> 0	name.equals('test')	等于任意一个给定值
notequals	1	name.notequals('test')	不等于给定值
isnull	0	name.isnull()	值为SQL的NULL
isnotnull	0	name.isnotnull()	值不为SQL的NULL
isempty	0	name.isempty('test')	值为空字符串
isnotempty	0	name.isnotempty('test')	值不是空字符串
isnullorempty	0	name.isnullorempty('test')	值为SQL的NULL或者空字符串

joint_filter

array[string]

可选

指定关联过滤条件，允许指定多个，后端将根据关联过滤条件和其他表关联查询，支持的查询语法和filter相同，
和其他表关联的语法如下：
joint_resources.related_key(origin_key).filter_col.filter_ops(values)
其中，joint_resources为要关联的资源名称，related_key为关联表column，origin_key为当前表column, filter_col为
关联表用于查询匹配的field名称，field_ops为filter支持的操作，values为匹配的值
举例：
guestnetworks.guest_id(id).ip_addr.equals('10.168.21.222')

filter_any

string

可选

如果filter_any为true，则查询所有filter的并集，否则为交集

field

array[string]

可选

返回结果只包含指定的字段

export_keys

string

可选

用于数据导出，指定导出的数据字段

show_fail_reason

string

可选

返回结果携带delete_fail_reason和update_fail_reason字段

summary_stats

string

可选

是否返回状态统计信息，默认为False

order_by_tag

string

通过标签排序

可选

without_user_meta

string

可选

deprecated
返回资源的标签不包含用户标签

with_user_meta

string

可选

返回包含用户标签的资源

with_cloud_meta

string

可选

返回包含外部标签的资源

with_any_meta

string

可选

返回包含任意标签的资源

with_meta

string

可选

返回列表数据中包含资源的标签数据（Metadata）

show_emulated

string

可选

显示所有的资源，包括模拟的资源

array[string]

以资源ID过滤列表

可选

name

array[string]

以资源名称过滤列表

可选

is_public

string

可选

以资源是否共享过滤列表

public_scope

string

可选

根据资源的共享范围过滤列表，可能值为：system, domain, project

status

array[string]

可选

以资源的状态过滤列表

enabled

string

可选

以资源是否启用/禁用过滤列表

external_id

string

以资源外部ID过滤

可选

vpc_id

array[string]

可选

关联VPC(ID或Name)

external_access_mode

string

Vpc外网访问模式

可选

order_by_vpc

string

按VPC名称排序

可选

wire_id

string

可选

二层网络(ID或Name)的资源

order_by_wire

string

以二层网络名称排序

可选

schedtag_id

string

可选

以关联的调度标签（ID或Name）过滤列表

order_by_schedtag

string

按调度标签名称排序

可选

order_by_resource_type

string

可选

按调度标签资源类型排序

storage_id

string

可选

存储（ID或Name）

storage_host_id

string

以host过滤

可选

string

可选

filter shared storage

local

string

可选

filter local storage

cloudregion_id

array[string]

区域名称或ID

可选

city

string

可选

过滤位于指定城市区域的资源

order_by_region

string

按区域名称过滤

可选

order_by_city

string

按城市过滤

可选

zone_id

string

可用区ID或名称

可选

示例值:

zone1

zone_ids

array[string]

可选

过滤处于多个指定可用区内的资源

order_by_zone

string

按可用区名称排序

可选

scope

string

可选

指定查询的权限范围，可能值为project, domain or system

project_domain_id

string

可选

指定项目归属域名称或ID

project_domain_ids

array[string]

可选

对具有域属性的资源，严格匹配域ID

order_by_domain

string

可选

按domain名称排序，可能值为asc|desc

providers

array[string]

可选

列出指定云平台的资源，支持的云平台如下

Provider	开始支持版本	平台
OneCloud	0.0	OneCloud内置私有云，包括KVM和裸金属管理
VMware	1.2	VMware vCenter
OpenStack	2.6	OpenStack M版本以上私有云
ZStack	2.10	ZStack私有云
Aliyun	2.0	阿里云
Aws	2.3	Amazon AWS
Azure	2.2	Microsoft Azure
Google	2.13	Google Cloud Platform
Qcloud	2.3	腾讯云
Huawei	2.5	华为公有云
Ucloud	2.7	UCLOUD
Ctyun	2.13	天翼云
S3	2.11	通用s3对象存储
Ceph	2.11	Ceph对象存储
Xsky	2.11	XSKY启明星辰Ceph对象存储

brands

array[string]

可选

cloud_env

string

可选

列出指定云环境的资源，支持云环境如下：

CloudEnv	说明
public	公有云
private	私有云
onpremise	本地IDC

order_by_provider

string

以平台名称排序

可选

order_by_brand

string

以平台品牌排序

可选

cloudprovider_id

array[string]

可选

列出关联指定云订阅(ID或Name)的资源

cloudaccount_id

array[string]

可选

列出关联指定云账号(ID或Name)的资源

is_managed

string

可选

过滤资源，是否为非OneCloud内置私有云管理的资源

order_by_account

string

以云账号名称排序

可选

order_by_manager

string

以云订阅名称排序

可选

usable

string

可选

filter by network usability of the resource

backupstorage_id

string

可选

备份存储（ID或Name）

order_by_backupstorage

string

以备份存储名称排序

可选

resource_type

string

可选

filter by ResourceType

any_mac

string

可选

filter by mac of any network interface

any_ip

array[string]

可选

filter by ip of any network interface

storage_not_attached

string

可选

filter storages not attached to this host

hypervisor

string

可选

filter by Hypervisor

is_empty

string

可选

filter host that is empty

baremetal

string

可选

filter host that is baremetal

rack

array[string]

机架

可选

slots

array[string]

机位

可选

access_mac

array[string]

管理口MAC

可选

access_ip

array[string]

管理口Ip地址

可选

array[string]

物理机序列号信息

可选

cpu_count

array[string]

CPU大小

可选

mem_size

array[string]

内存大小,单位Mb

可选

storage_type

array[string]

可选

存储类型(磁盘类型，sdd, rotate, hybrid)

host_storage_type

array[string]

宿主机绑定存储类型

可选

ipmi_ip

array[string]

IPMI地址

可选

host_status

array[string]

宿主机状态

可选

示例值:

online

host_type

array[string]

宿主机类型

可选

version

array[string]

可选

host服务软件版本

ovn_version

array[string]

OVN软件版本

可选

is_maintenance

string

是否处于维护状态

可选

is_import

string

是否为导入的宿主机

可选

enable_pxe_boot

string

是否允许PXE启动

可选

uuid

array[string]

主机UUID

可选

boot_mode

array[string]

可选

主机启动模式, 可能值位PXE和ISO

server_id_for_network

string

可选

虚拟机所在的二层网络

cpu_architecture

array[string]

可选

宿主机 cpu 架构

os_arch

array[string]

可选

order_by_server_count

string

按虚拟机数量排序

可选

order_by_storage

string

可选

按存储大小排序
enmu: asc,desc

order_by_storage_commit_rate

string

可选

按存储超分率排序
enmu: asc,desc

order_by_cpu_commit_rate

string

可选

按cpu超分率排序
enmu: asc,desc

order_by_mem_commit_rate

string

可选

按内存超分率排序
enmu: asc,desc

order_by_storage_used

string

可选

按本地存储分配大小排序
enmu: asc,desc

order_by_cpu_commit

string

可选

按cpu分配大小排序
enmu: asc,desc

order_by_mem_commit

string

可选

按内存分配大小排序
enmu: asc,desc

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Body

object {0}

示例

{}

修改于 2025-06-24 06:35:28

获取指定资源类的信息K8sMasterNodeIps

执行操作PurgeSplitable