# Data Types

## AssociateSubnetInstance

Add an instance into a subnet.

Referenced by：AssociateSubnetInstances

| Parameter Name   | Type   | Required | Description                                                                                                                                                                                            |
| ---------------- | ------ | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| instanceId       | String | Yes      | Instance ID.                                                                                                                                                                                           |
| privateIpAddress | String | No       | <p>Private IPv4 address.</p><p>The value should be in the range of subnet CIDR block. If the value is not passed in, any available private IP addresses will be assigned to the instance randomly.</p> |

## AvailableIpv4Resource

Available IPv4 CIDR blocks.

Referenced by：DescribeAvailableIpv4Resources

| Parameter Name | Type                            | Description                                                                                                                           |
| -------------- | ------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------- |
| zoneId         | String                          | Zone ID to which the CIDR block belongs.                                                                                              |
| netmask        | Integer                         | Netmask.                                                                                                                              |
| sellStatus     | [SellStatus](#sellstatus)       | <p>Status for sale.</p><p>SELL : available for sale, stock > 10. SELL\_SHORTAGE : available for sale, stock SOLD\_OUT : sold out.</p> |
| cidrType       | [CidrBlockType](#cidrblocktype) | CIDR block type.                                                                                                                      |

## AvailableIpv6Resource

Available IPv6 CIDR blocks.

Referenced by：DescribeAvailableIpv6Resources

| Parameter Name | Type                      | Description                                                                                                                           |
| -------------- | ------------------------- | ------------------------------------------------------------------------------------------------------------------------------------- |
| zoneId         | String                    | Zone ID to which the CIDR block belongs.                                                                                              |
| sellStatus     | [SellStatus](#sellstatus) | <p>Status for sale.</p><p>SELL : available for sale, stock > 10. SELL\_SHORTAGE : available for sale, stock SOLD\_OUT : sold out.</p> |

## AvailableResource

Information on instance resources for sale. Describe what kinds of instance models are available for sale in the specified zones.

Referenced by：DescribeAvailableResources

| Parameter Name            | Type                                               | Description                                                                                                                           |
| ------------------------- | -------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------- |
| zoneId                    | String                                             | Zone ID                                                                                                                               |
| sellStatus                | [SellStatus](#sellstatus)                          | <p>Status for sale.</p><p>SELL : available for sale, stock > 10. SELL\_SHORTAGE : available for sale, stock SOLD\_OUT : sold out.</p> |
| internetChargeTypes       | Array of [InternetChargeType](#internetchargetype) | Network pricing model.                                                                                                                |
| instanceTypeId            | String                                             | ID of the instance model.                                                                                                             |
| maximumBandwidthOut       | Integer                                            | <p>Public outbound bandwidth cap.</p><p>Unit: Mbps.</p>                                                                               |
| defaultBandwidthOut       | Integer                                            | <p>Default free public bandwidth for the pricing model of flat rate.</p><p>Unit: GB.</p>                                              |
| defaultTrafficPackageSize | Float                                              | <p>Default free traffic package for the pricing model of data transfer.</p><p>Unit: TB.</p>                                           |
| qty                       | Integer                                            | The inventory quantity of the instance model at zone.                                                                                 |

## BackendInfo

Information on load balance backend servers.

Referenced by：DescribeLoadBalancers, DescribeBackends

| Parameter Name | Type                                        | Description                                                                                                |
| -------------- | ------------------------------------------- | ---------------------------------------------------------------------------------------------------------- |
| listenerId     | String                                      | Listener ID.                                                                                               |
| backendId      | String                                      | Backend server ID.                                                                                         |
| backendName    | String                                      | Backend server name.                                                                                       |
| status         | String                                      | Backend server state.                                                                                      |
| port           | String                                      | Backend port.                                                                                              |
| weight         | Integer                                     | Backend server weight.                                                                                     |
| instanceId     | String                                      | Instance ID.                                                                                               |
| instanceType   | [InstanceProductType](#instanceproducttype) | Instance type.                                                                                             |
| instanceName   | String                                      | Instance name.                                                                                             |
| createTime     | String                                      | <p>Creation time.</p><p>Use UTC time according to the ISO8601 standard. Format: YYYY-MM-ddTHH:mm:ssZ .</p> |

## ChargePrepaid

Details of the monthly subscription, including the purchase period, auto-renewal, etc.

Referenced by：CreateLoadBalancer, InquiryPriceCreateEipAddress, CreateInstances, InquiryPriceCreateIpv4Block, AllocateEipAddresses, InquiryPriceCreateInstance, CreateIpv4Block

| Parameter Name | Type    | Required | Description                                                                  |
| -------------- | ------- | -------- | ---------------------------------------------------------------------------- |
| period         | Integer | Yes      | <p>Period of subscription.</p><p>Unit: month.</p><p>Value range: \[1, +)</p> |

## ChargeType

Information on pricing model.

Referenced by：DescribeAvailableResources, DescribeLoadBalancerSpecs, InquiryPriceCreateEipAddress, DescribeAvailableIpv4Resources, InquiryPriceCreateIpv4Block, DescribeEipAvailableResources, DescribeCidrBlocks, InquiryPriceCreateInstance, CreateIpv4Block, CreateLoadBalancer, DescribeLoadBalancerZones, CreateInstances, DescribeInstances, AllocateEipAddresses, DescribeEipAddresses

| Value    | Description    |
| -------- | -------------- |
| PREPAID  | Subscription.  |
| POSTPAID | Pay-as-you-go. |

## CidrBlockInfo

Information on CIDR blocks.

Referenced by：DescribeCidrBlocks

| Parameter Name    | Type                                | Description                                                                               |
| ----------------- | ----------------------------------- | ----------------------------------------------------------------------------------------- |
| cidrBlockId       | String                              | ID of CIDR block.                                                                         |
| cidrBlockType     | [IpType](#iptype)                   | <p>Type of CIDR block. The optional values are as follows:</p><p>IPv4 IPv6</p>            |
| cidrType          | [CidrBlockType](#cidrblocktype)     | CIDR block type.                                                                          |
| cidrBlockName     | String                              | CIDR block name.                                                                          |
| zoneId            | String                              | Zone ID to which the CIDR block belong.                                                   |
| cidrBlock         | String                              | CIDR block.                                                                               |
| gateway           | String                              | Gateway address.                                                                          |
| availableIpStart  | String                              | Available IP starts.                                                                      |
| availableIpEnd    | String                              | Available IP ends.                                                                        |
| availableIpCount  | Integer                             | Quantity of available IPs.                                                                |
| instanceIds       | Array of String                     | List of instance IDs.                                                                     |
| status            | [CidrBlockStatus](#cidrblockstatus) | Status of CIDR block .                                                                    |
| chargeType        | [ChargeType](#chargetype)           | <p>Pricing model.</p><p>PREPAID: monthly subscription.</p><p>POSTPAID: pay-as-you-go.</p> |
| createTime        | String                              | <p>Creation time.</p><p>Format: YYYY-MM-ddTHH:mm:ssZ .</p>                                |
| expireTime        | String                              | <p>Expiration time.</p><p>Format: YYYY-MM-ddTHH:mm:ssZ .</p>                              |
| resourceGroupId   | String                              | Resource group ID.                                                                        |
| resourceGroupName | String                              | Resource group name.                                                                      |
| tags              | [Tags](#tags)                       | Bound tags.                                                                               |

## CidrBlockIp

Information on CIDR IPs on the CIDR block.

Referenced by：DescribeCidrBlockIps

| Parameter Name | Type                                    | Description                                                                    |
| -------------- | --------------------------------------- | ------------------------------------------------------------------------------ |
| cidrBlockId    | String                                  | ID of CIDR block.                                                              |
| cidrBlockType  | [IpType](#iptype)                       | <p>Type of CIDR block. The optional values are as follows:</p><p>IPv4 IPv6</p> |
| ip             | String                                  | IP address.                                                                    |
| instanceId     | String                                  | List of instance IDs.                                                          |
| status         | [CidrBlockIpStatus](#cidrblockipstatus) | Status of IPs .                                                                |

## CidrBlockIpStatus

Status of CIDR block IPs.

Referenced by：DescribeCidrBlockIps

| Value     | Description |
| --------- | ----------- |
| BINDING   | Binding.    |
| UNBINDING | Unbinding.  |
| BOUND     | Bound.      |
| AVAILABLE | Available.  |

## CidrBlockStatus

Status of CIDR blocks.

Referenced by：DescribeCidrBlocks

| Value          | Description      |
| -------------- | ---------------- |
| CREATING       | Creating.        |
| CREATE\_FAILED | Creating failed. |
| RECYCLING      | Recycling.       |
| RECYCLE        | Recycled.        |
| AVAILABLE      | Available.       |

## CidrBlockType

The type of the CIDR block.

Referenced by：DescribeAvailableIpv4Resources, InquiryPriceCreateIpv4Block, DescribeCidrBlocks, DescribeInstanceAvailableCidrBlock, CreateIpv4Block

| Value | Description |
| ----- | ----------- |
| BGP   | BGP IP.     |
| Local | Local IP.   |

## CustomRaid

RAID levels and disk serial number for custom RAID settings.

Referenced by：CreateInstances

| Parameter Name | Type             | Required | Description                                                                                                                       |
| -------------- | ---------------- | -------- | --------------------------------------------------------------------------------------------------------------------------------- |
| raidType       | Integer          | Yes      | <p>RAID levels.</p><p>Value possible: 0, 1, 5, 10.</p>                                                                            |
| diskSequence   | Array of Integer | Yes      | <p>Serial number of the disk</p><p>Numbered sequentially starting from 1. Multiple disk serial numbers should be consecutive.</p> |

## Disk

Information on disks.

Referenced by：DescribeInstanceTypes

| Parameter Name | Type    | Description                       |
| -------------- | ------- | --------------------------------- |
| diskSize       | Integer | <p>Disk size.</p><p>Unit: GB.</p> |
| diskCount      | Integer | Quantity of disks of the size.    |

## EipAddress

Information on elastic IPs.

Referenced by：DescribeEipAddresses

| Parameter Name    | Type          | Description                                                                                                                                                                    |
| ----------------- | ------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| eipId             | String        | ID of the elastic IP.                                                                                                                                                          |
| zoneId            | String        | Zone ID to which the elastic IPs belong.                                                                                                                                       |
| ipAddress         | String        | IP address.                                                                                                                                                                    |
| netmask           | Integer       | IP netmask.                                                                                                                                                                    |
| instanceId        | String        | Instance ID                                                                                                                                                                    |
| instanceName      | String        | Instance name.                                                                                                                                                                 |
| eipChargeType     | String        | <p>Pricing model.</p><p>PREPAID: monthly subscription.</p><p>POSTPAID: pay-as-you-go.</p>                                                                                      |
| period            | Integer       | <p>Period of elastic IP subscription.</p><p>Unit: month.</p><p>The value is empty for pay-as-you-go elastic IPs.</p>                                                           |
| createTime        | String        | <p>Creation time.</p><p>Use UTC time according to the ISO8601 standard. Format: YYYY-MM-ddTHH:mm:ssZ .</p>                                                                     |
| expiredTime       | String        | <p>Expiration time.</p><p>Use UTC time according to the ISO8601 standard. Format: YYYY-MM-ddTHH:mm:ssZ .</p><p>Note:</p><p>The value is empty for pay-as-you-go resources.</p> |
| resourceGroupId   | String        | Resource group ID.                                                                                                                                                             |
| resourceGroupName | String        | Resource group name.                                                                                                                                                           |
| eipStatus         | String        | Status of elastic IP .                                                                                                                                                         |
| tags              | [Tags](#tags) | Bound tags.                                                                                                                                                                    |

## EipAvailable

Available elastic IPs for sale in specified zones.

Referenced by：DescribeEipAvailableResources

| Parameter Name | Type    | Description                                                                                                                           |
| -------------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------- |
| zoneId         | String  | Zone ID to which the elastic IPs belong.                                                                                              |
| status         | String  | <p>Status for sale.</p><p>SELL : available for sale, stock > 10. SELL\_SHORTAGE : available for sale, stock SOLD\_OUT : sold out.</p> |
| netmask        | Integer | IP netmask.                                                                                                                           |

## EipStatus

Status of elastic IPs.

Referenced by：DescribeEipAddresses

| Value          | Description      |
| -------------- | ---------------- |
| CREATING       | Creating.        |
| CREATE\_FAILED | Creating failed. |
| ASSOCIATING    | Assigning.       |
| UNASSOCIATING  | Unassigning.     |
| ASSOCIATED     | Assigned.        |
| AVAILABLE      | Available.       |
| RECYCLING      | Recycling.       |
| RECYCLE        | Recycled.        |

## HealthCheck

Information on load balance health check.

Referenced by：CreateListener, ModifyListenerAttribute, DescribeLoadBalancers

| Parameter Name        | Type    | Required | Description                            |
| --------------------- | ------- | -------- | -------------------------------------- |
| checkEnabled          | Boolean | No       | Whether to enable health check.        |
| checkType             | String  | No       | Health check protocols.                |
| checkConnectTimeout   | Integer | No       | Health check timeout period.           |
| checkRetry            | Integer | No       | Health check retry count.              |
| checkDelayBeforeRetry | Integer | No       | Interval between health check retries. |
| checkIntervalTime     | Integer | No       | Health check interval.                 |
| checkPort             | Integer | No       | Health check port.                     |
| httpVersion           | String  | No       | Health check HTTP protocol version.    |
| httpCheckPath         | String  | No       | Health check HTTP request path.        |
| httpCheckDigest       | Integer | No       | Health check HTTP digest               |
| httpCode              | Integer | No       | Health check HTTP status code          |
| miscCheckPath         | String  | No       | Health check MISC request path.        |
| miscTimeout           | Integer | No       | Health check MISC timeout.             |

## ImageInfo

Information on images.

Referenced by：DescribeImages

| Parameter Name | Type                    | Description                                                                                                                                                                                                                            |
| -------------- | ----------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| imageId        | String                  | Image ID                                                                                                                                                                                                                               |
| imageName      | String                  | Image name.                                                                                                                                                                                                                            |
| catalog        | String                  | <p>Image catalog.</p><p>The optional values are as follows:</p><p>CentOS Windows Ubuntu Debian ESXi</p>                                                                                                                                |
| imageType      | [ImageType](#imagetype) | <p>Image type.</p><p>The optional values are as follows:</p><p>PUBLIC\_IMAGE: public image.</p><p>CUSTOM\_IMAGE: custom image.</p><p>You cannot create a custom image by yourself currently. If necessary, please submit a ticket.</p> |
| osType         | [OsType](#ostype)       | <p>Operating system type.</p><p>The optional values are as follows:</p><p>Windows Linux</p>                                                                                                                                            |

## ImageType

Image type

Referenced by：DescribeImages

| Value         | Description   |
| ------------- | ------------- |
| PUBLIC\_IMAGE | System image. |
| CUSTOM\_IMAGE | Custom image. |

## InstanceAvailableCidrBlock

Available CIDR blocks for instances.

Referenced by：DescribeInstanceAvailableCidrBlock

| Parameter Name   | Type                            | Description                              |
| ---------------- | ------------------------------- | ---------------------------------------- |
| cidrBlockId      | String                          | ID of CIDR block.                        |
| zoneId           | String                          | Zone ID to which the CIDR block belongs. |
| cidrBlockType    | [IpType](#iptype)               | CIDR block type.                         |
| cidrType         | [CidrBlockType](#cidrblocktype) | CIDR block type.                         |
| cidrBlock        | String                          | CIDR block.                              |
| availableIps     | Array of String                 | List of available IPs.                   |
| availableIpCount | Integer                         | Quantity of available IPs.               |

## InstanceAvailableEip

Information on elastic IPs.

Referenced by：DescribeInstanceAvailableEipResources

| Parameter Name | Type    | Description                                                                                                                          |
| -------------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------ |
| eipId          | String  | <p>ID of an elastic IP.</p><p>To obtain the elastic IP ID, you can call DescribeEipAddresses and look for eipId in the response.</p> |
| ipAddress      | String  | IP address.                                                                                                                          |
| netmask        | Integer | IP netmask.                                                                                                                          |

## InstanceDiskInfo

Information on disks.

Referenced by：DescribeInstanceTypes

| Parameter Name  | Type                   | Description                                                                                                                                                                                                                                      |
| --------------- | ---------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| totalDiskSize   | Integer                | <p>Total disk size.</p><p>Unit: GiB.</p><p>The available storage space is relatively less than the total disk size to create partitions successfully. What remains actually will be added to the last partition.</p>                             |
| diskDescription | String                 | Description of the disks.                                                                                                                                                                                                                        |
| disks           | Array of [Disk](#disk) | <p>Disk information available for RAID and partition.</p><p>Numbered sequentially. For example, for 880 x 2 and 220 x 2, the disk serial numbers 1, 2, 3, and 4 respectively correspond to disk sizes of 880 GB, 880 GB, 220 GB, and 220 GB.</p> |

## InstanceHealth

Server hardware health information.

Referenced by：DescribeInstancesMonitorHealth

| Parameter Name | Type    | Description                                                                                                                                                                                                                                 |
| -------------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| instanceId     | String  | Instance ID.                                                                                                                                                                                                                                |
| cpuStatus      | String  | <p>CPU health state.</p><p>OK : Normal state. WARNING : Abnormal state. UNKNOWN : State detected failed.</p>                                                                                                                                |
| diskStatus     | String  | <p>Disk health state.</p><p>OK : Normal state. WARNING : Abnormal state. UNKNOWN : State detected failed.</p>                                                                                                                               |
| ipmiPing       | String  | <p>IPMI IP health state.</p><p>OK : ICMP detected normal. CRITICAL : ICMP detected failed. UNKNOWN : State detected failed.</p>                                                                                                             |
| ipmiStatus     | String  | <p>IPMI health state.</p><p>OK : ICMP detected normal. WARNING : Abnormal state. UNKNOWN : State detected failed.</p>                                                                                                                       |
| memoryStatus   | String  | <p>Memory health state.</p><p>OK : Normal state. WARNING : Abnormal state. UNKNOWN : State detected failed.</p>                                                                                                                             |
| psuStatus      | String  | <p>Power supply health state.</p><p>OK : Normal state. WARNING : Abnormal state. UNKNOWN : State detected failed.</p>                                                                                                                       |
| wanPortStatus  | String  | <p>Server's public network interface connection state.</p><p>OK : Normal state. WARNING : Abnormal state. UNKNOWN : State detected failed.</p>                                                                                              |
| fanStatus      | String  | <p>Fan state.</p><p>OK : Normal state. WARNING : Abnormal state. UNKNOWN : State detected failed.</p>                                                                                                                                       |
| serverBrand    | String  | Server supplier brand.                                                                                                                                                                                                                      |
| serverModel    | String  | Server supplier model.                                                                                                                                                                                                                      |
| cpuTemp        | Integer | <p>Temperature of a single CPU in Supermicro blade servers.</p><p>The range is from 0 to 100. The unit is ℃.</p><p>Note that a value of 0 is generally not retrievable, and a value of 100 signifies an exceptionally high temperature.</p> |
| cpu0Temp       | Integer | CPU0 temperature. The range is from 0 to 100. The unit is ℃. If the value is empty, it means the temperature is not retrievable.                                                                                                            |
| cpu1Temp       | Integer | CPU1 temperature. The range is from 0 to 100. The unit is ℃. If the value is empty, it means the temperature is not retrievable.                                                                                                            |
| cpu2Temp       | Integer | CPU2 temperature. The range is from 0 to 100. The unit is ℃. If the value is empty, it means the temperature is not retrievable.                                                                                                            |
| inletTemp      | Integer | Temperature of the air or environment surrounding the server equipment in a data center or server room.                                                                                                                                     |
| tempUnit       | String  | <p>Temperature unit.</p><p>Only Celsius is supported, that is ℃.</p>                                                                                                                                                                        |

## InstanceInfo

Information on instances.

Referenced by：DescribeInstances

| Parameter Name           | Type                                      | Description                                                                                                                                                                                   |
| ------------------------ | ----------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| instanceId               | String                                    | Instance ID                                                                                                                                                                                   |
| zoneId                   | String                                    | Zone ID to which the instances belong.                                                                                                                                                        |
| instanceName             | String                                    | Instance name to be displayed.                                                                                                                                                                |
| hostname                 | String                                    | Instance hostname.                                                                                                                                                                            |
| instanceTypeId           | String                                    | Instance model ID.                                                                                                                                                                            |
| instanceType             | [InstanceType](#instancetype)             | Instance model configuration info.                                                                                                                                                            |
| imageId                  | String                                    | Image ID.                                                                                                                                                                                     |
| imageName                | String                                    | Image name.                                                                                                                                                                                   |
| ipxeUrl                  | String                                    | iPXE URL.                                                                                                                                                                                     |
| instanceChargeType       | [ChargeType](#chargetype)                 | <p>Instance pricing model.</p><p>PREPAID:monthly subscription.</p><p>POSTPAID:pay-as-you-go.</p>                                                                                              |
| bandwidthOutMbps         | Integer                                   | <p>Public outbound bandwidth.</p><p>Unit:Mbps.</p><p>Value 0 means no limit,but not exceeds the upper limit of the instance model supported.</p>                                              |
| internetChargeType       | [InternetChargeType](#internetchargetype) | Network pricing model.                                                                                                                                                                        |
| period                   | Integer                                   | <p>Period of instance subscription.</p><p>Unit:month.</p><p>For postpaid instances,the value is empty.</p>                                                                                    |
| primaryPublicIpAddress   | String                                    | Instance primary IP address.                                                                                                                                                                  |
| primaryPublicIPv6Address | String                                    | Instance primary IPv6 address.                                                                                                                                                                |
| publicIpAddresses        | Array of String                           | <p>List of public IPv4 addresses.</p><p>If the instance primary IP is not added to the public network interface,the primary IP will not be available.,and its value will not be returned.</p> |
| privateIpAddresses       | Array of String                           | List of private IPv4 addresses.                                                                                                                                                               |
| ipv6Addresses            | Array of String                           | <p>Instance IPv6 addresses.</p><p>The value may be empty,which means no available IPv6 address exists.</p>                                                                                    |
| subnetIds                | Array of String                           | List of subnet IDs.                                                                                                                                                                           |
| createTime               | String                                    | <p>Creation time.</p><p>Use UTC time according to the ISO8601 standard.Format: YYYY-MM-ddTHH:mm:ssZ .</p>                                                                                     |
| expiredTime              | String                                    | <p>Expiration time.</p><p>Use UTC time according to the ISO8601 standard.Format: YYYY-MM-ddTHH:mm:ssZ .</p>                                                                                   |
| resourceGroupId          | String                                    | Resource group ID to which instances belong.                                                                                                                                                  |
| resourceGroupName        | String                                    | Resource group name to which instances belong.                                                                                                                                                |
| instanceStatus           | [InstanceStatus](#instancestatus)         | Status of instances.                                                                                                                                                                          |
| trafficPackageSize       | Float                                     | <p>Traffic package size purchased.</p><p>Unit:TB.</p>                                                                                                                                         |
| raidConfig               | [RaidConfig](#raidconfig)                 | Disk array configuration.                                                                                                                                                                     |
| partitions               | Array of [Partition](#partition)          | Partition configuration.                                                                                                                                                                      |
| nic                      | [Nic](#nic)                               | NIC configuration.                                                                                                                                                                            |
| autoRenew                | Boolean                                   | Whether to enable auto-renewal.                                                                                                                                                               |
| keyId                    | String                                    | <p>SSH key pair ID.</p><p>The value may be null,indicating that there is no valid value.</p>                                                                                                  |
| tags                     | [Tags](#tags)                             | Bound tags.                                                                                                                                                                                   |
| enableGatewayMode        | Boolean                                   | Whether to enable Gateway Mode.                                                                                                                                                               |

## InstanceProductType

Instance type.

Referenced by：DescribeLoadBalancers, DescribeBackends, RegisterBackend

| Value | Description      |
| ----- | ---------------- |
| BM    | Bare Metal       |
| VM    | Virtual machine. |

## InstanceStatus

Status of instance.

Referenced by：DescribeInstances

| Value           | Description        |
| --------------- | ------------------ |
| PENDING         | To be created.     |
| CREATING        | Creating.          |
| CREATE\_FAILED  | Creating failed.   |
| INSTALLING      | Installing.        |
| INSTALL\_FAILED | Installing failed. |
| RUNNING         | Running.           |
| STOPPED         | Powered off.       |
| BOOTING         | Powered on.        |
| STOPPING        | Powering off.      |
| RECYCLE         | Recycled.          |

## InstanceTrafficData

Instance bandwidth data.

Referenced by：DescribeInstanceTraffic, DescribeManagedInstanceTraffic

| Parameter Name | Type    | Description                                            |
| -------------- | ------- | ------------------------------------------------------ |
| internetRX     | Integer | Inbound bandwidth. Unit: bps.                          |
| internetTX     | Integer | Outbound bandwidth. Unit: bps.                         |
| time           | String  | <p>Data time.</p><p>Format: YYYY-MM-ddTHH:mm:ssZ .</p> |

## InstanceType

Information on instance models, including CPU, memory, subnet supported or not, etc.

Referenced by：DescribeInstances, DescribeInstanceTypes

| Parameter Name   | Type                                  | Description                                                         |
| ---------------- | ------------------------------------- | ------------------------------------------------------------------- |
| imageIds         | Array of String                       | Image ID supported. Hint: only accessible in DescribeInstanceType . |
| instanceTypeId   | String                                | Instance model ID.                                                  |
| description      | String                                | Model description, including memory size, disk, etc.                |
| cpuCoreCount     | Integer                               | Quantity of CPUs.                                                   |
| cpuDetail        | String                                | Details of CPU.                                                     |
| cpuCores         | Integer                               | Quantity of CPU cores.                                              |
| cpuThreads       | Integer                               | CPU threads.                                                        |
| baseFrequency    | String                                | CPU base frequency.                                                 |
| memorySize       | Integer                               | <p>Memory size.</p><p>Unit: GB.</p>                                 |
| maximumBandwidth | Integer                               | <p>Outbound bandwidth cap.</p><p>Unit: Mbps.</p>                    |
| supportRaids     | Array of Integer                      | RAID level supported.                                               |
| supportSubnet    | Boolean                               | Subnet supported or not.                                            |
| isHA             | Boolean                               | High availability supported or not.                                 |
| diskInfo         | [InstanceDiskInfo](#instancediskinfo) | <p>Disk size.</p><p>Unit: GB.</p>                                   |
| vpuVendor        | String                                | VPU vendor                                                          |
| vpuCard          | String                                | VPU Model. Example: T1U                                             |
| vpuCount         | Integer                               | VPU count.                                                          |

## InternetChargeType

Network pricing model.

Referenced by：DescribeAvailableResources, CreateInstances, DescribeInstances, InquiryPriceCreateInstance

| Value                 | Description                                                                                                                             |
| --------------------- | --------------------------------------------------------------------------------------------------------------------------------------- |
| ByBandwidth           | Billed by the flat rate bandwidth.                                                                                                      |
| ByTrafficPackage      | Billed by the traffic package size purchased.                                                                                           |
| ByInstanceBandwidth95 | Burstable 95th billing.                                                                                                                 |
| ByClusterBandwidth95  | Billed by the burstable 95th bandwidth of instances in a city-based bandwidth cluster.                                                  |
| ByBandwidthCluster    | Billed by the burstable 95th bandwidth of all compute resources in a city-based or regional bandwidth cluster with a shared commitment. |

## IpBindParam

Status of CIDR block IPs assigned to instances.

Referenced by：BindCidrBlockIps

| Parameter Name | Type   | Required | Description                                                                                                                                         |
| -------------- | ------ | -------- | --------------------------------------------------------------------------------------------------------------------------------------------------- |
| instanceId     | String | Yes      | Instance ID.                                                                                                                                        |
| ip             | String | Yes      | <p>CIDR block IP.</p><p>To obtain the CIDR block IP, you can call DescribeInstanceAvailableCidrBlock and look for availableIps in the response.</p> |

## IpType

Information on IP type.

Referenced by：DescribeCidrBlockIps, DescribeCidrBlocks, DescribeInstanceAvailableCidrBlock, CreateByoip

| Value | Description |
| ----- | ----------- |
| IPV4  | IPv4.       |
| IPV6  | IPv6.       |

## LbKind

Forwarding mode.

Referenced by：CreateListener, ModifyListenerAttribute, DescribeLoadBalancers

| Value | Description                         |
| ----- | ----------------------------------- |
| DR    | Direct Routing.                     |
| FNAT  | Global Network Address Translation. |

## ListenerInfo

Information on load balance listeners.

Referenced by：DescribeLoadBalancers, DescribeListeners

| Parameter Name  | Type                        | Description                                                                                                |
| --------------- | --------------------------- | ---------------------------------------------------------------------------------------------------------- |
| loadBalancerId  | String                      | Load balance instance ID.                                                                                  |
| listenerId      | String                      | Listener ID.                                                                                               |
| listenerName    | String                      | Listener name.                                                                                             |
| status          | String                      | State of a listener.                                                                                       |
| port            | String                      | Listening port.                                                                                            |
| protocol        | String                      | Listening protocol.                                                                                        |
| backendProtocol | String                      | Backend forwarding protocol.                                                                               |
| scheduler       | String                      | Scheduling algorithm.                                                                                      |
| kind            | [LbKind](#lbkind)           | Forwarding mode.                                                                                           |
| healthCheck     | [HealthCheck](#healthcheck) | Heath check information of a listener.                                                                     |
| notify          | [Notify](#notify)           | Alarm.                                                                                                     |
| createTime      | String                      | <p>Creation time.</p><p>Use UTC time according to the ISO8601 standard. Format: YYYY-MM-ddTHH:mm:ssZ .</p> |

## LoadBalancerInfo

Information on load balance instances.

Referenced by：DescribeLoadBalancers

| Parameter Name    | Type                                       | Description                                                                                                |
| ----------------- | ------------------------------------------ | ---------------------------------------------------------------------------------------------------------- |
| loadBalancerId    | String                                     | Load balance instance ID.                                                                                  |
| zoneId            | String                                     | Zone ID of a load balancer.                                                                                |
| loadBalancerName  | String                                     | Load balance instance name.                                                                                |
| specName          | String                                     | <p>Specification name.</p><p>Default value: Unlimited LoadBalancer</p>                                     |
| vipList           | Array of [LoadBalancerIp](#loadbalancerip) | Virtual IP list of a load balancer.                                                                        |
| chargeType        | String                                     | Pricing model.                                                                                             |
| period            | Integer                                    | Billing cycle.                                                                                             |
| createTime        | String                                     | <p>Creation time.</p><p>Use UTC time according to the ISO8601 standard. Format: YYYY-MM-ddTHH:mm:ssZ .</p> |
| expiredTime       | String                                     | Expiration time.                                                                                           |
| status            | String                                     | State of a load balancer.                                                                                  |
| resourceGroupId   | String                                     | Resource group ID.                                                                                         |
| resourceGroupName | String                                     | Resource group name.                                                                                       |
| masterIp          | String                                     | Primary IP.                                                                                                |
| backupIp          | String                                     | Secondary IP.                                                                                              |
| ipType            | String                                     | IPv4.                                                                                                      |
| bandwidth         | Integer                                    | <p>Bandwidth.</p><p>Default value: 0</p>                                                                   |
| isWorking         | Boolean                                    | Whether the load balancer is active or not.                                                                |
| listenerList      | Array of [ListenerInfo](#listenerinfo)     | Listener set.                                                                                              |
| backendList       | Array of [BackendInfo](#backendinfo)       | Backend server set.                                                                                        |
| tags              | [Tags](#tags)                              | Bound tags.                                                                                                |

## LoadBalancerIp

Information on load balancer virtual IPs (VIPs).

Referenced by：DescribeLoadBalancers

| Parameter Name | Type   | Description                                              |
| -------------- | ------ | -------------------------------------------------------- |
| vipId          | String | VIP ID.                                                  |
| ipAddress      | String | VIP address.                                             |
| type           | String | <p>VIP type.</p><p>Available values: DEFAULT , EXTRA</p> |
| status         | String | VIP state.                                               |

## LoadBalancerSpec

Information on load balancer specifications.

Referenced by：DescribeLoadBalancerSpecs

| Parameter Name | Type    | Description                   |
| -------------- | ------- | ----------------------------- |
| specName       | String  | Specification name.           |
| maxConnection  | Integer | Max connections.              |
| cps            | Integer | Connections Per Second (CPS). |
| qps            | Integer | Queries Per Second (QPS).     |

## ManagedInstanceInfo

Information on managed instances.

Referenced by：DescribeManagedInstances

| Parameter Name | Type            | Description      |
| -------------- | --------------- | ---------------- |
| instanceId     | String          | Instance ID.     |
| instanceName   | String          | Instance name.   |
| facName        | String          | Location name.   |
| ips            | Array of String | Public IP list.  |
| lanIps         | Array of String | Private IP list. |
| createTime     | String          | Creation time.   |

## MarketingInfo

Information on marketing campaigns.

Referenced by：CreateLoadBalancer, CreateInstances, AllocateEipAddresses, CreateIpv4Block

| Parameter Name | Type    | Required | Description                                                                                        |
| -------------- | ------- | -------- | -------------------------------------------------------------------------------------------------- |
| discountCode   | String  | No       | <p>Promo Code.</p><p>If no Promo Code exists, the final discount will not apply.</p>               |
| usePocVoucher  | Boolean | No       | <p>Whether to use POC voucher.</p><p>If no POC voucher exists, the related creation will fail.</p> |

## Nic

NIC configuration, including public and private NIC names settings.

Referenced by：ReinstallInstance, CreateInstances, DescribeInstances

| Parameter Name | Type   | Required | Description                                                                                                                                                                                                                                                                                                                                                                                              |
| -------------- | ------ | -------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| wanName        | String | No       | <p>Public NIC name.</p><p>Only numbers, uppercase and lowercase letters are allowed, starting with a letter with a length limit of 4 to 10 characters.</p><p>For non-high-availability models, the default public NIC name is wan0 . It cannot start with lan .</p><p>For high-availability models, the default public NIC name is bond0 .</p><p>Public and private NIC names cannot be the same.</p>    |
| lanName        | String | No       | <p>Private NIC name.</p><p>Only numbers, uppercase and lowercase letters are allowed, starting with a letter with a length limit of 4 to 10 characters.</p><p>For non-high-availability models, the default private NIC name is lan0 . It cannot start with wan .</p><p>For high-availability models, the default private NIC name is bond1 .</p><p>Public and private NIC names cannot be the same.</p> |

## Notify

Information on load balance health check alarm.

Referenced by：CreateListener, ModifyListenerAttribute, DescribeLoadBalancers

| Parameter Name | Type    | Required | Description                           |
| -------------- | ------- | -------- | ------------------------------------- |
| enable         | Boolean | No       | Whether to enable health check alarm. |
| apiAddress     | String  | No       | Alarm address.                        |

## OsType

Operating system type.

Referenced by：DescribeImages

| Value   | Description |
| ------- | ----------- |
| windows | Windows.    |
| linux   | Linux.      |

## Partition

Partition configuration information, including file type, partition size, etc.

Referenced by：ReinstallInstance, CreateInstances, DescribeInstances

| Parameter Name | Type    | Required | Description                                                                                                                                                                               |
| -------------- | ------- | -------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| fsPath         | String  | Yes      | <p>Partition letter.</p><p>Linux: must start with "/", and the first system partition must be "/".</p><p>Windows: support C\~H, the first system partition must be designated as "C".</p> |
| fsType         | String  | Yes      | <p>File type of partition.</p><p>Linux: ext2 , ext3 , ext4 , ext type is needed.</p><p>Windows: NTFS .</p>                                                                                |
| size           | Integer | Yes      | <p>Partition size.</p><p>Unit: GiB.</p><p>Value range: \[1, +)</p>                                                                                                                        |

## PriceCategory

Information on price type.

Referenced by：InquiryPriceCreateInstance

| Value      | Description     |
| ---------- | --------------- |
| STANDARD   | Standard price. |
| CUSTOMIZED | Fixed price.    |

## PriceItem

Information on the price.

Referenced by：InquiryPriceInstanceBandwidth, InquiryPriceInstanceTrafficPackage, InquiryPriceCreateEipAddress, InquiryPriceCreateIpv4Block, InquiryPriceCreateInstance

| Parameter Name          | Type                             | Description                                                                                                                                                                                                                                                        |
| ----------------------- | -------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| discount                | Float                            | <p>Discount.</p><p>For example, 80.0 means 20% off.</p>                                                                                                                                                                                                            |
| discountPrice           | Float                            | <p>Discount price of postpaid resources.</p><p>Only used in pay-as-you-go model. For tiered billing, the value is empty.</p>                                                                                                                                       |
| originalPrice           | Float                            | <p>Original price of prepaid resources.</p><p>Only used in subscription model. For pay-as-you-go model, the value is empty.</p>                                                                                                                                    |
| unitPrice               | Float                            | <p>Original unit price of postpaid resources.</p><p>Only used in pay-as-you-go model. For tiered billing, the value is empty.</p>                                                                                                                                  |
| discountUnitPrice       | Float                            | <p>Discount unit price of postpaid resources.</p><p>Only used in pay-as-you-go model. For tiered billing, the value is empty.</p>                                                                                                                                  |
| chargeUnit              | String                           | <p>Unit of postpaid billing.</p><p>Only used in pay-as-you-go model.</p><p>Value range:</p><p>HOUR: you will be billed by hour.</p><p>DAY: you will be billed by day.</p><p>MONTH: you will be billed by month. For example, the burstable 95th pricing model.</p> |
| stepPrices              | Array of [StepPrice](#stepprice) | <p>Tiered price of postpaid billing.</p><p>Only used in pay-as-you-go model. If it is not tiered price, the value is empty.</p>                                                                                                                                    |
| amountUnit              | String                           | <p>Unit of usage,</p><p>such as Mbps, LCU, and etc.</p><p>If the value is empty, it means there is no unit.</p>                                                                                                                                                    |
| excessUnitPrice         | Float                            | Original unit price of overages.                                                                                                                                                                                                                                   |
| excessDiscountUnitPrice | Float                            | Discount unit price of overages.                                                                                                                                                                                                                                   |
| excessAmountUnit        | String                           | <p>Unit of overage usage.</p><p>If the value is empty, it means there is no unit.</p>                                                                                                                                                                              |
| category                | [PriceCategory](#pricecategory)  | The price category                                                                                                                                                                                                                                                 |

## RaidConfig

Disk RAID configuration, including custom RAID settings.

Referenced by：ReinstallInstance, CreateInstances, DescribeInstances

| Parameter Name | Type                               | Required | Description                                                                                                                                 |
| -------------- | ---------------------------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------- |
| raidType       | Integer                            | No       | <p>RAID levels for rapid RAID settings.</p><p>Value possible: 0, 1, 5, 10.</p><p>Only one of raidType and customRaids can be specified.</p> |
| customRaids    | Array of [CustomRaid](#customraid) | No       | <p>RAID levels for custom RAID settings.</p><p>Only one of raidType and customRaids can be specified.</p>                                   |

## SellStatus

Information in sale status.

Referenced by：DescribeAvailableResources, DescribeAvailableIpv4Resources, DescribeAvailableIpv6Resources

| Value          | Description                      |
| -------------- | -------------------------------- |
| SOLD\_OUT      | Sold out.                        |
| SELL\_SHORTAGE | Available for sale, stock <= 10. |
| SELL           | Available for sale, stock > 10.  |

## StepPrice

Tiered price of postpaid billing. Describe a tier of the price.

Referenced by：InquiryPriceCreateInstance

| Parameter Name    | Type  | Description                                                                                |
| ----------------- | ----- | ------------------------------------------------------------------------------------------ |
| stepStart         | Float | First price range of a tiered price.                                                       |
| stepEnd           | Float | Last price range of a tiered price.                                                        |
| unitPrice         | Float | <p>Original unit price of current price range.</p><p>Only used in pay-as-you-go model.</p> |
| discountUnitPrice | Float | <p>Discount unit price of current price range.</p><p>Only used in pay-as-you-go model.</p> |

## SubnetInfo

Information on subnets.

Referenced by：DescribeSubnets

| Parameter Name    | Type                                       | Description                                                                                                |
| ----------------- | ------------------------------------------ | ---------------------------------------------------------------------------------------------------------- |
| subnetId          | String                                     | Subnet ID.                                                                                                 |
| subnetName        | String                                     | Subnet name.                                                                                               |
| zoneId            | String                                     | Zone ID to which the subnet belongs.                                                                       |
| availableIpCount  | Integer                                    | Quantity of available IPs in subnet.                                                                       |
| cidrBlock         | String                                     | CIDR block of subnet.                                                                                      |
| subnetStatus      | String                                     | Status of subnet .                                                                                         |
| createTime        | String                                     | <p>Creation time.</p><p>Use UTC time according to the ISO8601 standard. Format: YYYY-MM-ddTHH:mm:ssZ .</p> |
| vpcSubnetStatus   | String                                     | Status of subnets in VPC .                                                                                 |
| vpcId             | String                                     | VPC ID.                                                                                                    |
| vpcName           | String                                     | VPC name.                                                                                                  |
| resourceGroupId   | String                                     | Resource group ID.                                                                                         |
| resourceGroupName | String                                     | Resource group name.                                                                                       |
| subnetInstanceSet | Array of [SubnetInstance](#subnetinstance) | Information about instances in the subnet.                                                                 |

## SubnetInstance

Information on instances in subnet.

Referenced by：DescribeSubnets

| Parameter Name   | Type   | Description                   |
| ---------------- | ------ | ----------------------------- |
| instanceId       | String | Instance ID.                  |
| privateIpAddress | String | Private IP address.           |
| privateIpStatus  | String | Status of private IP address. |

## SubnetStatus

Status of subnet.

Referenced by：DescribeSubnets

| Value          | Description      |
| -------------- | ---------------- |
| CREATING       | Creating.        |
| CREATE\_FAILED | Creating failed. |
| AVAILABLE      | Available.       |
| DELETING       | Deleting.        |

## Tag

Information on a tag, including its key and value.

Referenced by：DescribeVpcs, CreateInstances, DescribeInstances, DescribeLoadBalancers, DescribeCidrBlocks, DescribeEipAddresses

| Parameter Name | Type   | Required | Description                                   |
| -------------- | ------ | -------- | --------------------------------------------- |
| key            | String | Yes      | Tag key. Length limit: 1 to 128 characters.   |
| value          | String | No       | Tag value. Length limit: 1 to 128 characters. |

## TagAssociation

Information on tags bound to resources, including their keys and values.

Referenced by：CreateVpc, CreateLoadBalancer, CreateIpv6Block, CreateInstances, AllocateEipAddresses, CreateIpv4Block

| Parameter Name | Type                 | Required | Description   |
| -------------- | -------------------- | -------- | ------------- |
| tags           | Array of [Tag](#tag) | Yes      | List of tags. |

## Tags

Information on tags, including their keys and values.

Referenced by：DescribeVpcs, DescribeInstances, DescribeLoadBalancers, DescribeCidrBlocks, DescribeEipAddresses

| Parameter Name | Type                 | Description   |
| -------------- | -------------------- | ------------- |
| tags           | Array of [Tag](#tag) | List of tags. |

## VpcInfo

Information on VPCs.

Referenced by：DescribeVpcs

| Parameter Name    | Type          | Description                                                |
| ----------------- | ------------- | ---------------------------------------------------------- |
| vpcId             | String        | VPC ID.                                                    |
| vpcRegionId       | String        | Availability region ID of VPC.                             |
| vpcRegionName     | String        | Availability region name of VPC.                           |
| vpcName           | String        | VPC name.                                                  |
| cidrBlock         | String        | CIDR block of VPC.                                         |
| createTime        | String        | <p>Creation time.</p><p>Format: YYYY-MM-ddTHH:mm:ssZ .</p> |
| vpcStatus         | String        | Status of VPC .                                            |
| resourceGroupId   | String        | Resource group ID.                                         |
| resourceGroupName | String        | Resource group name.                                       |
| tags              | [Tags](#tags) | Bound tags.                                                |

## VpcRegionInfo

Information on availability region of VPC.

Referenced by：DescribeVpcAvailableRegions

| Parameter Name | Type            | Description                      |
| -------------- | --------------- | -------------------------------- |
| vpcRegionId    | String          | Availability region ID of VPC.   |
| vpcRegionName  | String          | Availability region name of VPC. |
| zoneIds        | Array of String | List if zone IDs.                |

## VpcStatus

Status of VPC.

Referenced by：DescribeVpcs

| Value          | Description      |
| -------------- | ---------------- |
| CREATING       | Creating.        |
| CREATE\_FAILED | Creating failed. |
| AVAILABLE      | Available.       |
| DELETING       | Deleting.        |

## Zone

Zone information, including city, etc.

Referenced by：DescribeZones

| Parameter Name         | Type    | Description                                                                                                |
| ---------------------- | ------- | ---------------------------------------------------------------------------------------------------------- |
| zoneId                 | String  | Zone ID. For example, SEL-A .                                                                              |
| zoneName               | String  | Zone name.                                                                                                 |
| cityName               | String  | City name of the zone.                                                                                     |
| areaName               | String  | Region name of the zone.                                                                                   |
| isCloudRouterAvailable | Boolean | <p>Whether the zone supports Layer 3 cloud router.</p><p>Default value: false</p>                          |
| isByoipEnabled         | Boolean | <p>Indicate whether the availability zone support BYO IP addressing or not.</p><p>Default value: false</p> |


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.console.zenlayer.com/api-reference/compute/bmc/datastructure.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
