列出资源池下的UDhost实例-DescribeUDSetInstance
列出资源池下的UDhost实例
Request Parameters
| Parameter name | Type | Description | Required |
| Region | string | 地域。 参见 地域和可用区列表 | Yes |
| ProjectId | string | 项目ID。不填写为默认项目，子帐号必须填写。 请参考GetProjectList接口 | No |
| HostIds.n | string | 资源池的短ID, 如果为空, 则返回当前Region所有符合条件的UHost实例，否则返回指定资源池上的所有UHost实例 | No |
| UHostIds.n | string | 专区主机的短ID, 如果为空, 则返回指定资源池的UHost实例，否则返回指定主机的实例信息 | No |
| Tag | string | 要查询的业务组名称 | No |
| Offset | int | 主机数据偏移量, 默认为0 | No |
| Limit | int | 返回主机数据长度, 默认为20 | No |
Response Elements
| Parameter name | Type | Description | Required |
| RetCode | int | 操作返回码 | Yes |
| Action | string | 操作名称 | Yes |
| TotalCount | int | 满足条件的总数 | No |
| UHostSet | array | 满足条件的私有专区主机列表 | No |
UDSetInstanceSet
| Parameter name | Type | Description | Required |
| Zone | string | 可用区 | No |
| UHostId | string | UHost实例ID | No |
| HostId | string | 资源池短ID | No |
| UHostType | string | Normal：标准机型，SSD：SSD机型 | No |
| OsType | string | 操作系统类型: Liunx, Windows | No |
| OsName | string | 操作系统名称 | No |
| ImageId | string | 镜像Id | No |
| BasicImageId | string | 基础镜像Id | No |
| BasicImageName | string | 基础镜像名称 | No |
| Tag | string | 业务组名称 | No |
| Remark | string | 备注 | No |
| Name | string | 实例名称 | No |
| State | string | 实例状态, 初始化:Initializing, 启动中:Starting, 运行中:Running, 关机中:Stopping,关机:Stopped, 安装失败:Install Fail, 重启中:Rebooting 重置密码中 迁移中 | No |
| ExpireTime | int | 到期时间 | No |
| CPU | int | 虚拟CPU核数, 单位:个 | No |
| Memory | int | 内存大小, 单位:MB | No |
| DiskSet | array | 磁盘信息 | No |
| NetCapability | string | 正常：Normal；网络增强：Enhance | No |
| IPSet | array | IP信息 | No |
| SubnetType | string | 是否私有网络，Default，Private | No |
| NetworkState | string | Connected，NotConnected | No |
| TimemachineFeature | string | 是否开启数据方舟。Yes: 开启；No：未开启。 | No |
| BootDiskState | string | 系统盘状态。在Initializing时主机不能创建镜像。 | No |
UHostDiskSet
| Parameter name | Type | Description | Required |
| Type | string | 磁盘类型。系统盘: Boot，数据盘: Data,网络盘：Udisk | No |
| DiskId | string | 磁盘ID | No |
| Name | int | UDisk名字（仅当磁盘是UDisk时返回） | No |
| Drive | int | 磁盘盘符 | No |
| Size | int | 磁盘大小，单位: GB | No |
UHostIPSet
| Parameter name | Type | Description | Required |
| Type | string | 国际: Internation，BGP: Bgp，内网: Private | No |
| IPId | string | IP资源ID (内网IP无对应的资源ID) | No |
| IP | string | IP地址 | No |
| Bandwidth | int | IP对应的带宽, 单位: Mb (内网IP不显示带宽信息) | No |
| Default | string | 是否默认的弹性网卡的信息。true: 是默认弹性网卡；其他值：不是。 | No |
Request Example
https://api.ucloud.cn?Action=DescribeUDSetInstance &Region=mBqVzITv &HostIds.n=XhwutBWo &UHostIds.n=dPplcWeS &Tag=yoOOTstO &Offset=9 &Limit=FMICfjGc &ProjectId=nihbmJrX
Response Example
{
"RetCode": 0,
"Action": "DescribeUDSetInstanceResponse",
"UHostSet": [
{
"UHostId": "udhost-xxx",
"HostId": "udset-xxx",
"Zone": "cn-bj2-02",
"UHostType": "Normal",
"OsType": "Linux",
"OsName": "CentOS 6.5 64位",
"ImageId": "7fe9a7ce-8414-400a-80c7-a5325419b0fb",
"BasicImageId": "uimage-qegj3w",
"BasicImageName": "CentOS 6.5 64位",
"Tag": "Default",
"Name": "test",
"Remark": "",
"State": "Running",
"NetworkState": "Connected",
"CreateTime": 1543333491,
"CPU": 2,
"Memory": 4096,
"TotalDiskSpace": 20,
"DiskSet": [
{
"Type": "Boot",
"DiskId": "7fe9a7ce-8414-400a-80c7-a5325419b0fb",
"Drive": "vda",
"Size": 20
},
{
"Type": "Data",
"DiskId": "9f23a13e-c14c-43f9-a530-8d2c1993a186",
"Drive": "vdb",
"Size": 20
}
],
"NetCapability": "Normal",
"TimemachineFeature": "no",
"IPSet": [
{
"Type": "Private",
"IP": "10.9.159.36",
"VPCId": "uvnet-xxx",
"SubnetId": "subnet-xxx"
}
],
"SubnetType": "Default",
"BootDiskState": "Initializing"
}
],
"TotalCount": 1
}