> For the complete documentation index, see [llms.txt](https://docs.console.zenlayer.com/api-reference/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.console.zenlayer.com/api-reference/compute/zec/datastructure.md). # Data Types ## AsnObservationDetail ASN observation details. Referenced by：DescribeIpv6Cidrs, DescribeCidrs | Parameter Name | Type | Description | | ------------------ | ----------------------------------------------- | ------------------------------------------------------- | | verificationStatus | [AsnVerificationStatus](#asnverificationstatus) | ASN verification status. | | observedPrefix | String | Observed prefix. | | primarySource | String | Name of the primary data source, e.g., RIPE. | | primaryStatus | [AsnQueryStatus](#asnquerystatus) | Query status of the primary data source. | | primaryAsns | Array of Integer | List of ASNs observed by the primary data source. | | secondarySource | String | This field has been deprecated and always returns null. | | secondaryStatus | [AsnQueryStatus](#asnquerystatus) | This field has been deprecated and always returns null. | | secondaryAsns | Array of Integer | This field has been deprecated and always returns null. | ## AsnQueryStatus ASN query status. Referenced by：DescribeCidrs | Value | Description | | -------- | ---------------- | | QUERYING | Querying. | | FINISHED | Query completed. | | FAILURE | Query failed. | ## AsnVerificationStatus ASN verification status. Referenced by：DescribeCidrs | Value | Description | | ----------- | ---------------------------------------------------------- | | agreed | The RIPE-observed ASN matches the declared ASN. | | disagreed | The RIPE-observed ASN does not match the declared ASN. | | unavailable | The primary data source query failed or returned no match. | | querying | Querying. | ## AttackEventInfo Informations on a DDoS attack event. Referenced by：DescribeDDosAllEventList | Parameter Name | Type | Description | | ------------------ | ------------------------------------- | ----------------------------------- | | eventId | String | DDoS attack event ID. | | status | [DdosAttackStatus](#ddosattackstatus) | Attack state. | | ipAddress | String | Attack target IP. | | protecting | Boolean | Whether the IP is being protected. | | startTime | String | Attack start time. | | endTime | String | Attack end time. | | endBlackholeTime | String | Time to unblock from blackhole. | | attackBandwidthMax | Float | Peak attack bandwidth. Unit: bps. | | attackPackageMax | Float | Peak attack packet rate. Unit: pps. | | regionId | String | Region ID of attack event. | ## AutoSnapshotPolicy Information on snapshot schedules. Referenced by：DescribeAutoSnapshotPolicies | Parameter Name | Type | Description | | ---------------------- | --------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | autoSnapshotPolicyId | String | Snapshot schedule ID. | | zoneId | String | Availability zone ID. | | autoSnapshotPolicyName | String | Snapshot schedule name. | | repeatWeekDays | Array of Integer |

The backup date of the schedule.

Unit: day, cycle: week (e.g., 1 = Monday)

Available range: \[1, 7].

Value range: \[1, 7]

| | hours | Array of Integer |

Specify the start time of the snapshot schedule.

UTC time is used. Unit: hour.

24 time points are available from 00:00 to 23:00, 1 = 01:00, and so on.

Available range: \[0, 23].

Value range: \[0, 23]

| | diskNum | Integer | Source disk quantity. | | createTime | String | Creation time. | | resourceGroup | [ResourceGroupInfo](#resourcegroupinfo) | Resource group information. | | diskIdSet | Array of String | Source disk information. | | retentionDays | Integer |

Retention time of automatic snapshots. Unit: day.

If the value is set to -1, it means that it is retained indefinitely.

The default is indefinite.

Value range: -1 or \[1,65535].

| | tags | [Tags](#tags) | Tags bound to resources. | ## BandwidthClusterInfo Details of the bandwidth cluster. Referenced by：DescribeNetworkInterfacePublicIPv6, DescribeEips | Parameter Name | Type | Description | | -------------------- | ------ | ----------------------- | | bandwidthClusterId | String | Bandwidth Cluster ID. | | bandwidthClusterName | String | Bandwidth Cluster name. | ## BandwidthIpType IP type for QoS policy group members. Referenced by：DescribeQosPolicyGroups | Value | Description | | ----------------- | -------------------- | | Eip | Elastic IP (EIP). | | Ipv6 | IPv6 address. | | UnmanagedEgressIp | Unmanaged egress IP. | ## BandwidthPriceResponseItem Bandwidth price details. Referenced by：InquiryPriceModifyEipBandwidth, DescribeEipPrice, InquiryPriceCreateInstance, InquiryPriceModifyEipFlowPackage, InquiryPriceChangeEipInternetChargeType | Parameter Name | Type | Description | | -------------- | ----------------------- | ------------------------------------------- | | trafficType | String | Traffic direction type. | | price | [PriceItem](#priceitem) | Bandwidth price for this traffic direction. | ## BindType Information on elastic IP mode. Referenced by：ChangeEipBindType, CreateNetworkInterface, CreateEips, CreateZecInstances, DescribeEips, AssociateEipAddress | Value | Description | | ----------- | ------------ | | FullNat | NAT mode. | | Passthrough | Bypass mode. | ## BlockInfo Information on elastic IP block threshold. Referenced by：DescribeEips | Parameter Name | Type | Description | | -------------- | ------- | ------------------------------------------------------------------ | | ip | String | The elastic IP address being blocked. | | bps | Integer | Blocking threshold in bandwidth, unit: bps (bits per second). | | pps | Integer | Blocking threshold in packet rate, unit: pps (packets per second). | | inCps | Integer | Blocking threshold for inbound connections, unit: count . | | outCps | Integer | Blocking threshold for outbound connections, unit: count . | | enable | Boolean | Whether to enable the specific threshold. | ## ByoipCreateItem Information on BYOIP creation. Referenced by：CreateByoip | Parameter Name | Type | Required | Description | | ---------------- | ----------------------------------- | -------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | cidrBlock | String | Yes | Advertise an IPv4 or IPv6 BYOIP prefix. | | networkType | [NetworkLineType](#networklinetype) | Yes |

Network type.

Only Premium BGP is supported for IPv6.

| | regionId | String | Yes | Region ID. | | asn | Integer | Yes | ASN number. | | subnetMaskLength | Integer | No |

Subnet mask length.

Must be greater than or equal to the CIDR mask length, with a maximum difference of 4.

The maximum value is 64. Defaults to the CIDR mask length.

Value range: \[-, 64]

| ## ByoipPriceItem Information on BYOIP price querying. Referenced by：DescribeByoipPrice | Parameter Name | Type | Required | Description | | -------------- | ----------------------------------- | -------- | -------------------- | | cidrBlock | String | Yes | Advertised IP range. | | networkType | [NetworkLineType](#networklinetype) | Yes | Network type. | | regionId | String | Yes | Region ID. | ## CidrCreateSource Information on CIDR block ownership. Referenced by：DescribeIpv6Cidrs, DescribeCidrs | Value | Description | | --------- | ------------------------------ | | CONSOLE | CIDR block created on Console. | | BYOIP | Bring your own IP (BYOIP). | | SDN\_RIPT | IP Transit CIDR block. | ## CidrInfo Information on CIDR block. Referenced by：DescribeCidrs | Parameter Name | Type | Description | | ----------------------- | --------------------------------------------- | ---------------------------------------------------------------------------------------------------------------- | | cidrId | String | CIDR block ID. | | regionId | String | Region ID. | | name | String | CIDR block name. | | cidrBlock | String | CIDR block, for example: 10.0.0.0/16. | | totalCount | Integer | Quantity of available CIDR IPs. | | usedCount | Integer | Quantity of used CIDR IPs. | | source | [CidrCreateSource](#cidrcreatesource) |

Source of the CIDR block.

For example: CONSOLE (owned by Zenlayer) or BYOIP (customer-provided IP).

| | eipV4Type \[Deprecated] | [EipNetworkType](#eipnetworktype) |

Network type of elastic IP.

Deprecated. Please use networkLineType instead.

| | networkLineType | [NetworkLineType](#networklinetype) | Network type of elastic IP. | | netmask | Integer | CIDR block size. | | poolId | String |

IP pool ID.

Indicates the public IP pool to which this CIDR block belongs.

| | createTime | String | Creation time. | | expiredTime | String | Expiration time. | | resourceGroupId | String | Resource group ID. | | resourceGroupName | String | Resource group name. | | status | [CidrStatus](#cidrstatus) | CIDR block status. | | asn | Integer |

ASN.

Only available when the CIDR source is BYOIP.

| | tags | [Tags](#tags) | Tags bound to resources. | | asnObservation | [AsnObservationDetail](#asnobservationdetail) | ASN observation result. Only available when the CIDR source is BYOIP. | ## CidrStatus Status of CIDR block. Referenced by：DescribeIpv6Cidrs, DescribeCidrs | Value | Description | | --------- | --------------------- | | CREATING | Creating. | | AVAILABLE | Available to be used. | | CHANGING | Changing. | | RECYCLED | Recycled. | | DELETING | Deleting. | | FAILED | Created failed. | ## CrossRegionBandwidthApiMonitorMeta Values of cross-region bandwidth performance metrics. Referenced by：DescribeCrossRegionBandwidthMonitorData | Value | Description | | --------- | --------------------------------------- | | BANDWIDTH |

Bandwidth.

Unit: bps .

| | PACKETS |

Data transfer.

Unit: pps .

| ## CrossRegionBandwidthInfo Information on cross-region bandwidth. Referenced by：DescribeCrossRegionBandwidth | Parameter Name | Type | Description | | ------------------------ | ----------------------------------------------------- | ------------------------------------------------------ | | crossRegionBandwidthId | String | Cross-region bandwidth ID. | | crossRegionBandwidthName | String | Cross-region bandwidth name. | | status | [VpcRegionBandwidthStatus](#vpcregionbandwidthstatus) | Cross-region bandwidth state. | | vpcId | String | Global VPC ID where the cross-region bandwidth belong. | | regionA | String | One end of the cross-region bandwidth. | | regionZ | String | The other end of the cross-region bandwidth. | | bandwidth | Integer | Bandwidth cap. | | bandwidthCap | Integer |

Burst bandwidth.

The value may be empty.

| | createTime | String | Creation time. | | internetChargeType | [InternetChargeType](#internetchargetype) | Network pricing model. | | expiredTime | String |

Expiration time.

The value may be empty.

| | resourceGroupId | String | Resource group ID. | | resourceGroupName | String | Resource group name. | ## CrossRegionBandwidthMetricValue Metrics of cross-region bandwidth performance. Referenced by：DescribeCrossRegionBandwidthMonitorData | Parameter Name | Type | Description | | -------------- | ------ | --------------- | | time | String | Data time. | | inValue | Float | Inbound value. | | outValue | Float | Outbound value. | ## CustomImage Describes the basic information of a custom image. Referenced by：DescribeCustomImages | Parameter Name | Type | Description | | ----------------- | ------------------------------------------ | -------------------------------------------------------------------------------- | | regionIdList | Array of String | List of region IDs where the image is currently available. | | resourceGroupId | String | Resource group ID. | | resourceGroupName | String | Resource group name. | | imageId | String | Image ID. | | imageName | String | Name of the image. | | imageType | [ImageType](#imagetype) | Type of the image. | | imageSource | [ImageSource](#imagesource) | Source of the image. | | imageSize | String | Size of the image. | | minDiskSize | Integer | Minimum capacity required for the system disk when creating an instance, in GiB. | | imageDescription | String | Description of the image. | | imageVersion | String | Version of the image. | | imageStatus | [ImageStatus](#imagestatus) | Status of the image. | | nicNetworkType | Array of [NicNetworkType](#nicnetworktype) | Network interface types supported by the image. | | category | String | Category of the image. | | osType | [ImageOsType](#imageostype) | Type of operating system. | | tags | [Tags](#tags) | Tags associated with the instance. | ## DataDisk Information on disk. Referenced by：CreateZecInstances, DescribeInstances, InquiryPriceCreateInstance | Parameter Name | Type | Required | Description | | --------------- | ------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | diskSize | Integer | Yes |

Disk size.

Unit: GiB.

Value range: \[1, +)

| | diskId | String | No |

Disk ID.

This parameter is currently only used as a response parameter in query operations such as DescribeInstances, and cannot be used as an input parameter for write operations such as CreateInstances.

| | diskName | String | No |

Disk name.

This parameter is currently only used as a response parameter for query operations such as DescribeInstances.

| | diskAmount | Integer | No |

Number of disks.

This parameter is only used as an input parameter for APIs such as CreateInstances and InquiryPriceCreateInstance.

Value range: \[1, +)

Default value: 1

| | portable | Boolean | No |

Whether the disk is detachable.

This parameter is used as a response parameter in query operations, not as an input parameter.

true means the disk will not be deleted when the instance is deleted.

false means the disk will be deleted when the instance is deleted.

| | burstingEnabled | Boolean | No |

Whether to enable burstable performance.

Default value: false

| | diskCategory | String | No |

Disk type.

Basic NVMe SSD: the Basic NVMe SSD.

Standard NVMe SSD: the Standard NVMe SSD.

Default value: Standard NVMe SSD.

Default value: Standard NVMe SSD

| ## DdosAction Protection actions based on packet fingerprint rules. Referenced by：CreatePolicy | Value | Description | | ----- | ----------------------------------------------- | | Allow | Allow: Release the traffic. | | Drop | Drop traffic based on packet fingerprint rules. | ## DdosAttackStatus States of DDoS attack events. Referenced by：DescribeDDosAllEventList, DescribeDDosEventDetail | Value | Description | | --------- | ---------------------------------- | | ATTACKING | The attack target is under attack. | | ATTACKED | The attack event is resolved. | | BLOCKING | The attack event is mitigating. | ## DdosFingerprintRule Informations on fingerprint filtering rules of DDoS protection strategy. Referenced by：CreatePolicy, DescribePolicyDetail, ModifyPolicy | Parameter Name | Type | Required | Description | | -------------- | ------------------------- | -------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- | | protocol | [Protocol](#protocol) | Yes | Supported protocols of the fingerprint. | | srcPortStart | Integer | Yes |

Start value of the source port range for the fingerprint.

Valid range: \[0, 65535].

Value range: \[0, 65535]

| | srcPortEnd | Integer | Yes |

End value of the source port range for the fingerprint.

Valid range: \[0, 65535].

Value range: \[0, 65535]

| | dstPortStart | Integer | Yes |

Start value of the destination port range for the fingerprint.

Valid range: \[0, 65535].

Value range: \[0, 65535]

| | dstPortEnd | Integer | Yes |

End value of the destination port range for the fingerprint.

Valid range: \[0, 65535].

Value range: \[0, 65535]

| | minPktLength | Integer | Yes |

Minimum packet length to be filtered.

Valid range: \[1, 1500].

Value range: \[1, 1500]

| | maxPktLength | Integer | Yes |

Maximum packet length to be filtered.

Valid range: \[1, 1500].

Value range: \[1, 1500]

| | matchBytes | String | Yes |

Payload pattern to match.

Hex string in lowercase, padded to 2 digits, without 0x prefix.

| | action | [DdosAction](#ddosaction) | Yes | Action to perform after the fingerprint is matched. | | offset | Integer | No |

Byte offset of the payload signature.

Offset within TCP/UDP payload: \[0–1500].

Valid range: \[0, 1500].

Value range: \[0, 1500]

| ## DdosPolicyPort Informations on port blocking of DDoS protection strategy. Referenced by：CreatePolicy, DescribePolicyDetail, ModifyPolicy | Parameter Name | Type | Required | Description | | -------------- | ------------------------- | -------- | ---------------------------------------------------------------------------------------------------------------------------------- | | protocol | [Protocol](#protocol) | Yes |

Supported protocols of port blocking.

Only UDP and TCP are supported.

| | srcPortStart | Integer | Yes |

Start value of the source port range for port blocking.

Valid range: \[0, 65535].

Value range: \[0, 65535]

| | srcPortEnd | Integer | Yes |

End value of the source port range for port blocking.

Valid range: \[0, 65535].

Value range: \[0, 65535]

| | dstPortStart | Integer | Yes |

Start value of the destination port range for port blocking.

Valid range: \[0, 65535].

Value range: \[0, 65535]

| | dstPortEnd | Integer | Yes |

End value of the destination port range for port blocking.

Valid range: \[0, 65535].

Value range: \[0, 65535]

| | action | [DdosAction](#ddosaction) | Yes | Action to perform after the port blocking is matched. | ## DdosProtectedType Informations on DDoS protection type. Referenced by：DescribeDDosEventDetail | Value | Description | | ----- | ---------------- | | DDOS | DDoS protection. | ## DdosReflectUdpPort Informations on reflection attack filtering of DDoS protection strategy. Referenced by：CreatePolicy, DescribePolicyDetail, ModifyPolicy | Parameter Name | Type | Required | Description | | -------------- | ------- | -------- | -------------------------------------------------------------------------------------------------------- | | port | Integer | Yes |

Custom UDP reflection source port.

Valid range: \[0, 65535].

Value range: \[0, 65535]

| ## DdosTrafficControl Informations on source IP rate limiting of DDoS protection strategy. Referenced by：CreatePolicy, DescribePolicyDetail, ModifyPolicy | Parameter Name | Type | Required | Description | | -------------- | ------- | -------- | ---------------------------------------------------------------------------------------------------------------- | | bpsEnabled | Boolean | No | Enable bandwidth rate limit or not. | | bps | Integer | No |

Limited bandwidth value.

Valid range: \[8192, 2147483648].

Value range: \[8192, 2147483648]

| | ppsEnabled | Boolean | No | Enable packet rate limit or not. | | pps | Integer | No |

Limited packet rate value.

Valid range: \[32, 50000].

Value range: \[32, 50000]

| | synBPSEnabled | Boolean | No | Enable SYN bandwidth limit or not. | | synBPS | Integer | No |

Limited SYN traffic value.

Valid range: \[8192, 2147483648].

Value range: \[8192, 2147483648]

| | synPPSEnabled | Boolean | No | Enable SYN packet rate limit or not. | | synPPS | Integer | No |

Limited SYN packet rate value.

Valid range: \[1, 100000].

Value range: \[1, 100000]

| ## DescribeDiskCategoryItem Information on disk types supported in an availability zone. Referenced by：DescribeDiskCategory | Parameter Name | Type | Description | | -------------- | --------------- | ------------------------- | | zoneId | String | Availability zone ID. | | categorySet | Array of String | The supported disk types. | ## DhcpOptionsSet Information on the DHCP options set. Referenced by：DescribeDhcpOptionsSets | Parameter Name | Type | Description | | --------------------- | ------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | dhcpOptionsSetId | String | DHCP options set ID. | | dhcpOptionsSetName | String |

DHCP options set name. The length must be between 1 and 64 characters.

Value range: \[1.0, +).

Value range: \[1.0, +)

| | domainNameServers | String |

DNS server IP.

Up to 4 DNS server IPv4s can be passed in, separated by a comma (,).

| | ipv6DomainNameServers | String |

DNS server IP.

Up to 4 DNS server IPv6s can be passed in, separated by a comma (,).

| | leaseTime | String |

Lease duration for the IPv4 DHCP options set.

Unit: h.

| | ipv6LeaseTime | String |

Lease duration for the IPv6 DHCP options set.

Unit: h.

| | createTime | String |

Creation time.

Use UTC time according to the ISO8601 standard. Format: YYYY-MM-ddTHH🇲🇲ssZ .

| | description | String | Description information of the DHCP options set. | | resourceGroupId | String | Resource group ID. | | resourceGroupName | String | Resource group name. | | tags | [Tags](#tags) | Bound tags. | ## DiskInfo Information on disks, including size, type and etc. of both system disks and data disks. Referenced by：DescribeDisks | Parameter Name | Type | Description | | -------------------- | ------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------- | | diskId | String | Disk ID. | | diskName | String | Disk name. | | regionId | String | Region ID. | | zoneId | String | Zone ID to which the disks belong. | | diskType | [DiskType](#disktype) |

Disk type.

SYSTEM: Boot Disk; DATA: Disk.

| | portable | Boolean | Whether the disk is detachable or not. | | diskCategory | String |

Disk category.

cloud\_efficiency: Ultra Disk.

| | diskSize | Integer | Disk size. Unit: GB. | | diskStatus | [DiskStatus](#diskstatus) |

Disk status.

See DiskStatus for more details.

| | instanceId | String | Attached instance ID. | | instanceName | String | Attached instance name. | | createTime | String |

Creation time.

Format: YYYY-MM-ddTHH🇲🇲ssZ .

| | expiredTime | String |

Expiration time.

Format: YYYY-MM-ddTHH🇲🇲ssZ .

| | period | Integer |

Subscription term.

Unit: Month.

The value is empty for POSTPAID pricing model.

| | resourceGroupId | String | Resource group ID. | | resourceGroupName | String | Resource group name. | | serial | String |

The index of the disk.

This value may be null if unavailable.

| | snapshotAbility | Boolean | Available for snapshot creation or not. | | autoSnapshotPolicyId | String | ID of snapshot schedule attached to the disk. | | tags | [Tags](#tags) | Tags bound to resources. | | burstingEnabled | Boolean | Whether to enable disk bursting. | ## DiskMetricData Information on disk performance metrics. Referenced by：DescribeDiskMonitorData | Value | Description | | ------------------ | ------------------------------------------------- | | DISK\_WRITE\_BYTES |

Disk write throughput.

Unit: KiB/s .

| | DISK\_READ\_BYTES |

Disk read throughput.

Unit: KiB/s .

| | DISK\_READ\_OPS |

Disk read operations.

Unit: IOPS .

| | DISK\_WRITE\_OPS |

Disk write operations.

Unit: IOPS .

| | DISK\_UTIL |

Disk utilization.

Unit: % .

| ## DiskPerfItem Cloud disk performance information. Referenced by：InquiryPriceResizeDisk | Parameter Name | Type | Description | | -------------- | ------- | ------------------------------------------------- | | maxIops | Integer | Maximum IOPS without burst enabled. | | maxBandwidth | Integer | Maximum bandwidth without burst enabled, in MB/s. | | iopsBurst | Integer | IOPS after enabling burst. | | bandwidthBurst | Integer | Bandwidth after enabling burst, in MB/s. | ## DiskStatus Information on disk states. Referenced by：DescribeDisks | Value | Description | | ------------------ | ----------------------------------- | | CREATING | Disk is in creation. | | IN\_USE | Disk is active. | | AVAILABLE | Disk is inactive. | | CHANGING | Disk size is changing. | | ATTACHING | Disk is attaching to an instance. | | DETACHING | Disk is detaching from an instance. | | DELETING | Disk is in deletion. | | RECYCLED | Disk is recycled. | | FAILED | Creating a disk failed. | | SNAPSHOT\_CREATING | Snapshot is in creation. | | ROLLING\_BACK | Reverting to snapshot. | ## DiskType Information on storage type. Referenced by：DescribeSnapshots, DescribeDisks | Value | Description | | ------ | ----------- | | SYSTEM | Boot disk. | | DATA | Disk. | ## DiskWithInstance Information on data disks created along with the instance. Referenced by：CreateZecInstances | Parameter Name | Type | Description | | -------------- | --------------- | --------------------------------------------- | | instanceId | String | Instance ID. | | diskIdSet | Array of String | Data disk ID created along with the instance. | ## DnatEntry Information on the DNAT rules. Referenced by：DescribeNatGatewayDetail | Parameter Name | Type | Description | | -------------- | --------------------------------------- | ---------------------------------------------------------------------------------------------- | | dnatEntryId | String | DNAT entry ID. | | status | String | DNAT rule status. | | privateIp | String | The private IP address configured in the DNAT rule. | | eipId | String | The elastic IP ID configured in the DNAT rule. | | protocol | [DnatEntryProtocol](#dnatentryprotocol) | The protocol type configured in the DNAT rule. | | listenerPort | String |

The public port or port range forwarded by the DNAT rule.

Valid values: 1–65535.

| | internalPort | String |

The private port or port range forwarded by the DNAT rule.

Valid values: 1–65535.

| ## DnatEntryProtocol DNAT rule protocol. Referenced by：CreateDnatEntry, DescribeNatGatewayDetail, ModifyDnatEntry | Value | Description | | ----- | ------------- | | TCP | TCP protocol. | | UDP | UDP protocol. | | Any | Any protocol. | ## EipBindResourceType Information on resource type bound to elastic IP. Referenced by：DescribeEips | Value | Description | | ----- | ----------------------------- | | NIC | vNIC. | | NAT | NAT gateway. | | LB | Load balancer. | | HAVIP | High availability virtual IP. | ## EipGeoInfo IP geolocation information retrieved from third-party IP database providers such as DB-IP, ipdata, etc. Referenced by：DescribeEips | Parameter Name | Type | Description | | -------------- | ------- | ------------------------------------------------------------ | | maxMind | String | Geolocation information queried from MaxMind. | | ipInfo | String | Geolocation information queried from IPinfo (ipinfo.io). | | dbIp | String | Geolocation information queried from DB-IP (db-ip.com). | | ipData | String | Geolocation information queried from ipdata (ipdata.co). | | ipGeoLocation | String | Geographic information queried from IpGeoLocation. | | standard | String | Geolocation information of the elastic IP. | | isConsistent | Boolean | Whether the queried geolocation matches the actual location. | ## EipInfo Information on elastic IPs. Referenced by：DescribeEips | Parameter Name | Type | Description | | ----------------------- | ------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------ | | eipId | String | ID of elastic IP. | | name | String | Name of elastic IP. | | regionId | String | Region ID. | | peerRegionId | String |

Remote region ID.

This field is valid only when the IP is a Remote IP.

| | isDefault | Boolean | Default IP or not. | | status | [EipStatus](#eipstatus) | ​Status of elastic IP.​ | | publicIpAddresses | Array of String | Public IP address. | | privateIpAddress | String | Private IP bound to the elastic IP. | | eipV4Type \[Deprecated] | [EipNetworkType](#eipnetworktype) |

​Network type of elastic IP​.

Deprecated. Please use networkLineType instead.

| | networkLineType | [NetworkLineType](#networklinetype) | ​Network type of elastic IP​. | | internetChargeType | [InternetChargeType](#internetchargetype) | ​Network billing method of elastic IP.​ | | cidrId | String | CIDR block ID from which the elastic IP originates. | | nicId \[Deprecated] | String |

vNIC ID associated with the elastic IP.

This field is deprecated; please use the associatedId field instead.

| | associatedId | String |

Resource ID bound to the elastic IP.

It may be an instance ID, vNIC ID, or NAT gateway ID.

| | associatedType | [EipBindResourceType](#eipbindresourcetype) |

Resource type bound to the elastic IP.

It may be an instance, vNIC, or NAT gateway.

| | instanceId | String |

ID of the instance to which elastic IP is bound.

This field may have a value only when the associatedType is NIC .

| | bindType | [BindType](#bindtype) | Elastic IP mode. | | flowPackage | Float |

Data transfer package size of the EIP.

This field is only available when the billing type is traffic-based.

This field may be null.

| | flowPackages | Array of [FlowPackageResponseItem](#flowpackageresponseitem) | List of multi-direction traffic packages for the EIP. | | bandwidth | Integer |

Bandwidth limit of the EIP.

Unit: Mbps.

| | rateLimitMode | [RateLimitMode](#ratelimitmode) |

Rate limit mode.

Default value: LOOSE

| | eipGeoRefs | Array of [EipGeoInfo](#eipgeoinfo) | Elastic IP geolocation information. | | blockInfoList | Array of [BlockInfo](#blockinfo) | Elastic IP block threshold. | | createTime | String | Creation time. | | expiredTime | String |

Expiration time of the EIP.

This field may be null.

| | resourceGroupId | String | Resource group ID. | | resourceGroupName | String | Resource group name. | | bandwidthCluster | [BandwidthClusterInfo](#bandwidthclusterinfo) | Bandwidth cluster ID. | | tags | [Tags](#tags) | Tags bound to resources. | | operationInfo | [OperationInfo](#operationinfo) | The bandwidth and traffic package operation status of EIP. | ## EipIsp Information on the IP ISP (Internet Service Provider). Referenced by：CreateEips | Value | Description | | ------------------ | ------------------------ | | BGP | Premium BGP. | | CN2 | China dedicated line. | | PathBasedBandwidth | Multi-path bandwidth IP. | | LOCAL | Local IP. | | CHINA\_MOBILE | China Mobile. | | CHINA\_UNICOM | China Unicom. | | CHINA\_TELECOM | China Telecom. | | COGENT | Standard BGP. | ## EipMetricValue Metric value of elastic IP performance data. Referenced by：DescribeEipMonitorData | Parameter Name | Type | Description | | -------------- | ------ | -------------------- | | time | String | Time. | | inValue | Float | Inbound value. | | outValue | Float | Outbound value. | | loseIn | Float | Inbound loss value. | | loseOut | Float | Outbound loss value. | ## EipMonitorMeta Performance metrics of elastic IP. Referenced by：DescribeEipMonitorData | Value | Description | | --------- | --------------------------------------------- | | BANDWIDTH |

Bandwidth.

Unit: bps .

| | PACKETS |

Packet transmission.

Unit: pps .

| ## EipNetworkType Network type of elastic IP. See `NetworkLineType` for more details. Referenced by：CreateEips, CreateZecInstances, DescribeEipPrice, CreateCidr, DescribeEipRemoteRegions, InquiryPriceCreateInstance, DescribeEips, DescribeCidrs, DescribeEipInternetChargeTypes, DescribeCidrPrice | Value | Description | | -------------------- | -------------------------------------------------- | | BGPLine | BGP network type. | | CN2Line | CN2 GIA (CN2 Global Internet Access) network type. | | LocalLine | Local IP network type. | | ChinaMobile | China Mobile network type. | | ChinaUnicom | China Unicom network type. | | ChinaTelecom | China Telecom network type. | | Cogent | Cogent Communications network type. | | PathBasedBandwidthIP | Multi-path bandwidth IP. | ## EipRegionNetworkLineType Mapping of nodes to the types of IP lines they support. Referenced by：DescribeEipNetworkLineTypes | Parameter Name | Type | Description | | ---------------- | -------------------------------------------- | ------------------------------------------------- | | regionId | String | Region ID. | | networkLineTypes | Array of [NetworkLineType](#networklinetype) | The list of IP line types supported by this node. | ## EipStatus Status of elastic IPs. Referenced by：DescribeEips | Value | Description | | -------------- | ---------------- | | CREATING | Creating. | | DELETING | Deleting. | | ASSIGNING | Binding. | | BINDED | Bound. | | RECYCLED | Recycled. | | UNBIND | Unbound. | | CREATE\_FAILED | Creating failed. | ## EipTrafficData Information on traffic of elastic IP. Referenced by：DescribeEipTraffic | Parameter Name | Type | Description | | -------------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | internetRX | Integer | Inbound bandwidth. Unit: bps. | | internetTX | Integer | Outbound bandwidth. Unit: bps. | | time | String |

Data time.

Expressed in ISO 8601 format using UTC time.

Format: YYYY-MM-ddTHH🇲🇲ssZ.

| ## EipTrafficDirection EIP traffic direction. Referenced by：DescribeEipTraffic, DescribeEipMonitorData | Value | Description | | ------------- | ------------------------ | | LOCAL | Domestic direction. | | INTERNATIONAL | International direction. | ## FlowPackageResponseItem Flow package details. Referenced by：DescribeEips | Parameter Name | Type | Description | | -------------- | ------ | ----------------------------------------------- | | trafficType | String | Traffic direction type. | | flowPackage | Float | Traffic package size for this direction, in TB. | ## GpuInstanceTypeQuotaItem Describes the availability and sale information of a GPU instance type in a zone. Referenced by：DescribeZoneGpuInstanceConfigInfos | Parameter Name | Type | Description | | ----------------- | ------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | zoneId | String | Zone ID. | | instanceType | String |

GPU instance type ID.

For example: z3a.g.C49.c8m32.1.

When modifying an instance type, pass this value to the instanceType parameter of ModifyInstanceType.

| | cpuCount | Integer |

Number of CPU cores.

Unit: core.

| | memory | Integer |

Memory size.

Unit: GiB.

| | gpuAmount | Integer | Number of GPUs. | | instanceTypeName | String | GPU instance type name. | | bps | Integer |

Maximum bandwidth per network interface.

Unit: bit/s.

| | pps | Integer |

Maximum number of packets sent and received per network interface.

Unit: packets/second.

| | inventoryCapacity | [VmInventoryCapacity](#vminventorycapacity) | Inventory capacity level of the GPU series. | ## HaVipEipAttachment EIP attachment information for a HaVip. Referenced by：DescribeHaVips | Parameter Name | Type | Description | | -------------- | ------ | ------------------------- | | eipId | String | The ID of the elastic IP. | | eipAddress | String | The elastic IP address. | ## HaVipInfo HaVip information. Referenced by：DescribeHaVips | Parameter Name | Type | Description | | ------------------- | -------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------- | | haVipId | String | The ID of the high availability virtual IP. | | name | String | HaVip name. | | regionId | String | The ID of the node where the HaVip is located. | | vpcId | String | The ID of the VPC the HaVip belongs to. | | subnetId | String | The ID of the subnet the HaVip belongs to. | | securityGroupId | String | Security group ID. | | ipAddress | String | The private IPv4 address of the HaVip. | | associatedInstances | Array of String | List of associated instance IDs. | | masterInstanceId | String | The ID of the primary instance currently holding the VIP traffic. Returns null if no instance is bound or there is no primary instance. | | associatedEips | Array of [HaVipEipAttachment](#havipeipattachment) | List of bound Elastic IPs. Returns an empty list if none are bound. | | createTime | String | Creation time. | | tags | [Tags](#tags) | Tag list. | ## IPv6Type Whether the IPv6 address is public or private. Referenced by：CreateSubnet, ModifySubnetStackType | Value | Description | | ------- | ---------------- | | Private | Private network. | | Public | Public network. | ## Image Information on images. Referenced by：DescribeImages | Parameter Name | Type | Description | | ---------------- | ------------------------------------------ | -------------------------------------------------------------------------------- | | imageId | String | Image ID. | | imageName | String | Image name. | | imageType | [ImageType](#imagetype) | Image type. | | imageSource | [ImageSource](#imagesource) | Image source. | | imageSize | String | Image size. | | minDiskSize | Integer | Minimum capacity required for the system disk when creating an instance, in GiB. | | imageDescription | String | Image note. | | imageVersion | String | Image version. | | imageStatus | [ImageStatus](#imagestatus) | Image state. | | nicNetworkType | Array of [NicNetworkType](#nicnetworktype) | vNIC type supported by the image. | | category | String | Image category. | | osType | [ImageOsType](#imageostype) | Image operating system. | | tags | [Tags](#tags) | Tags associated with the resources. | ## ImageCopyProgress Copy progress of a custom image in a single target region. Referenced by：DescribeImageCopyProgress | Parameter Name | Type | Description | | -------------- | ----------------------------------------- | ----------------------------------------------------------------------------------------------- | | destRegionId | String | Target region ID. | | destRegionName | String | Target region name. | | syncStage | [ImageCopySyncStage](#imagecopysyncstage) | Copy stage. | | queued | Boolean | Whether the task is queued, waiting for the system to schedule and execute the transfer. | | syncPercent | Float | Copy progress percentage, retained to two decimal places (e.g., 74.23). | | errorInfo | String | Error information returned when the copy to the target region encounters an exception or fails. | ## ImageCopySyncStage The stage of the image copy process. Referenced by：DescribeImageCopyProgress | Value | Description | | ------------ | ----------------------------------------------------------------------------------------------------------------- | | PREPARING | Preparing. When transferring the image for the first time, the system must first complete the backup preparation. | | TRANSFERRING | Transferring. | ## ImageOsType Values of image operating systems. Referenced by：DescribeImages, DescribeCustomImages | Value | Description | | ------- | ---------------------------- | | linux | Linux operating system. | | bsd | BSD operating system. | | windows | Windows operating system. | | android | Android operating system. | | any | Any other operating systems. | ## ImageSource Values of image sources. Referenced by：DescribeImages, DescribeCustomImages | Value | Description | | --------- | ------------------ | | OFFICIAL | System image. | | MARKETING | Marketplace image. | | CUSTOM | Custom image. | | APP | Application image. | ## ImageStatus Values of image states. Referenced by：DescribeImages, DescribeCustomImages | Value | Description | | ----------- | -------------------------- | | CREATING | Image is being created. | | AVAILABLE | Image creation succeeded. | | UNAVAILABLE | Image is unavailable. | | SYNCING | Image is being replicated. | | FAILED | Image creation failed. | | DELETING | Image is being deleted. | | PROCESSING | Image is being operated. | ## ImageType Values of image types. Referenced by：DescribeImages, DescribeCustomImages | Value | Description | | ------------- | ------------- | | PUBLIC\_IMAGE | System image. | | CUSTOM\_IMAGE | Custom image. | ## InstanceApiMonitorMeta Performance metrics of instances. Referenced by：DescribeInstanceMonitorData | Value | Description | | -------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | CPU\_UTILIZATION |

CPU utilization.

Unit: % .

| | HYPERVISOR\_IO\_WAIT\_TIME |

Hypervisor I/O wait time.

Unit: % .

| | HYPERVISOR\_QUEUE\_TIME |

Hypervisor CPU queue time.

Unit: % .

| | HYPERVISOR\_CPU\_USER |

Hypervisor CPU user.

Unit: % .

| | HYPERVISOR\_CPU\_TIME |

Hypervisor CPU time.

Unit: % .

| | HYPERVISOR\_CPU\_SYSTEM |

Hypervisor CPU system.

Unit: % .

| | PROC\_CPU\_USER |

CPU user.

Unit: % .

| | PROC\_CPU\_SYSTEM |

CPU system.

Unit: % .

| | PROC\_CPU\_IOWAIT |

CPU IOWait.

Unit: % .

| | PROC\_CPU\_SOFTIRQ |

CPU SoftIRQ.

Unit: % .

| | PROC\_CPU\_IDLE |

CPU idle.

Unit: % .

| | PROC\_CPU\_OTHER |

CPU other.

Unit: % .

| | LOAD1 | System Load Average - Last 1 Minute. | | LOAD5 | System Load Average - Last 5 Minutes. | | LOAD15 | System Load Average - Last 15 Minutes. | | MEM\_UTIL |

Memory utilization

Unit: % .

| | REALMEM\_UTIL |

Memory real utilization

Unit: % .

| | TCP\_ESTABLISHED |

Established TCP connections.

Unit: count .

| | SWAP\_TOTAL |

The total configured swap space on the instance, which is used to assess the max swappable capacity.

Unit: KiB .

| | SWAP\_FREE |

The currently available swap space, which is used to evaluate how much swap is still free.

Unit: KiB .

| | SWAP\_IN |

Pages read from swap into memory, which indicates system memory pressure.

Unit: pages .

| | SWAP\_OUT |

Pages written from memory to swap, which reflects inactive data being moved to disk.

Unit: pages .

| | KSWAPD\_STEAL |

Pages successfully reclaimed by kswapd from memory, which indicates memory pressure.

Unit: pages .

| | KSWAPD\_LHWM |

Number of times memory reclaim was triggered due to low watermarks.

Unit: count .

| | RX\_PACKETS |

Packets received per second on the vNIC’s VF interface

Unit: packets .

| | TX\_PACKETS |

Packets transmitted per second on the vNIC’s VF interface

Unit: packets .

| | RX\_DROPPED |

Total inbound packet loss per second for the vNIC’s VF and Virtio interfaces.

Unit: packets .

| | TX\_DROPPED |

Total outbound packet loss per second for the vNIC’s VF and Virtio interfaces.

Unit: packets .

| | RX\_ERRORS |

Total inbound error packets per second for the vNIC’s VF and Virtio interfaces.

Unit: packets .

| | TX\_ERRORS |

Total outbound error packets per second for the vNIC’s VF and Virtio interfaces.

Unit: packets .

| | RX\_BITS |

Number of bits received per second by the VM VF NIC.

Unit: bits.

| | TX\_BITS |

Number of bits sent per second by the VM VF NIC.

Unit: bits.

| | CPU\_PSI\_SOME\_AVG60 |

CPU PSI (Some / 60s Avg).

The percentage of time in the past 60 seconds during which at least one task was stalled waiting for CPU resources.

A higher value indicates more pronounced CPU wait.

QGA collection is not required.

Not supported on Windows and BSD images.

Unit: percentage.

| | MEM\_PSI\_SOME\_AVG60 |

Memory PSI (Some / 60s Avg).

The percentage of time in the past 60 seconds during which at least one task was stalled waiting for memory reclamation, paging, or swap.

QGA collection is not required.

Not supported on Windows and BSD images.

Unit: percentage.

| | MEM\_PSI\_FULL\_AVG60 |

Memory PSI (Full / 60s Avg).

The percentage of time in the past 60 seconds during which all tasks were simultaneously stalled waiting for memory.

A sustained non-zero value typically indicates high memory pressure.

QGA collection is not required.

Not supported on Windows and BSD images.

Unit: percentage.

| | IO\_PSI\_SOME\_AVG60 |

IO PSI (Some / 60s Avg).

The percentage of time in the past 60 seconds during which at least one task was stalled waiting for disk or storage IO.

QGA collection is not required.

Not supported on Windows and BSD images.

Unit: percentage.

| | IO\_PSI\_FULL\_AVG60 |

IO PSI (Full / 60s Avg).

The percentage of time in the past 60 seconds during which all tasks were simultaneously stalled waiting for disk or storage IO.

A sustained non-zero value indicates severe IO wait.

QGA collection is not required.

Not supported on Windows and BSD images.

Unit: percentage.

| | UPTIME |

Instance uptime duration.

Unit: seconds.

| | GPU\_UTILIZATION |

GPU utilization.

Unit: percentage.

| | GPU\_TEMPERATURE |

GPU temperature.

Unit: degrees Celsius.

| | GPU\_MEMORY\_USED |

GPU memory used.

Unit: MiB.

| | GPU\_MEMORY\_UTILIZATION |

GPU memory utilization.

Unit: percentage.

| | GPU\_POWER\_DRAW |

GPU power draw.

Unit: watts (W).

| | GPU\_FAN\_SPEED |

GPU fan speed.

Unit: percentage.

| ## InstanceInfo Information on instances. Referenced by：DescribeInstances | Parameter Name | Type | Description | | ------------------ | ------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------- | | instanceId | String | Instance ID. | | instanceName | String | Instance name to be displayed. | | zoneId | String | Availability zone ID to which the instances belong. | | instanceType | String | Type of instance. eg. z2a.cpu.1 | | cpu | Integer |

Quantity of CPU cores.

Unit: cores.

| | memory | Integer |

Memory size.

Unit: GiB.

| | imageId | String | Image ID. | | imageName | String | Image name. | | timeZone | String | Time zone of the system. | | nicNetworkType | [NicNetworkType](#nicnetworktype) | Network interface mode. | | status | [InstanceStatusValue](#instancestatusvalue) | Status of instances. | | systemDisk | [SystemDisk](#systemdisk) | Boot disk information. | | dataDisks | Array of [DataDisk](#datadisk) | Disk information. | | publicIpAddresses | Array of String | List of public IPs. | | privateIpAddresses | Array of String | List of private IPs. | | keyId | String |

SSH key pair ID.

The value may be null, indicating that there is no valid value.

| | subnetId | String | Associated subnet ID of the primary vNIC. | | securityGroupId | String | Associated security group ID of the primary vNIC. | | enableAgent | Boolean | Whether to enable the QEMU Guest Agent (QGA). | | enableAgentMonitor | Boolean | Whether to enable data collection of the QEMU Guest Agent (QGA). | | enableIpForward | Boolean | Whether to enable IP forwarding. | | createTime | String |

Creation time.

Format: YYYY-MM-ddTHH🇲🇲ssZ .

| | expiredTime | String |

Expiration time.

Format: YYYY-MM-ddTHH🇲🇲ssZ .

| | resourceGroupId | String | Resource group ID. | | resourceGroupName | String | Resource group name. | | nics | Array of [NicInfo](#nicinfo) | Information of the vNIC attached to an instance. | | tags | [Tags](#tags) | Tags bound to resources. | | loadBalancerIds | Array of String | Attached load balancer IDs. | | placementGroupId | String | The placement group ID to which the instance belongs. | | instanceOptions | [InstanceOptions](#instanceoptions) | Instance options configuration. | ## InstanceOptions Information on options for the instance. Referenced by：CreateZecInstances, DescribeInstances | Parameter Name | Type | Required | Description | | -------------------- | ------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | nestedVirtualization | Boolean | No |

Whether to the instance for nested virtualization.

To enable nested virtualization, you must contact Support to activate it; otherwise, the setting will be ineffective.

| ## InstanceStatus Status of instances. See [InstanceStatusValue](#instancestatusvalue) for more detailed information. Referenced by：DescribeInstancesStatus | Parameter Name | Type | Description | | -------------- | ------------------------------------------- | ----------------------------------------------------------------------- | | instanceId | String | Instance ID. | | instanceStatus | [InstanceStatusValue](#instancestatusvalue) | Instance status. See InstanceStatusValue for more detailed information. | ## InstanceStatusValue Status of instance. Referenced by：DescribeInstancesStatus, DescribeInstances | Value | Description | | -------------- | ---------------- | | DEPLOYING | Creating. | | REBUILDING | Rebuilding. | | REBOOT | Rebooting. | | RUNNING | Running. | | STOPPED | Powered off. | | BOOTING | Powered on. | | RELEASING | Releasing. | | STOPPING | Powering off. | | RECYCLE | Recycled. | | CREATE\_FAILED | Creating failed. | | IMAGING | Image creating. | | RESIZING | Resizing. | ## InstanceTypeCapacityItem Inventory capacity details for an instance type. Referenced by：DescribeVmInventoryCapacity | Parameter Name | Type | Description | | -------------- | ------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | instanceType | String | CPU instance type, such as z2a, z2i, or z4a. | | gpuSpec | String |

GPU model, such as z4a.g.C49.

This field is only returned for GPU instances.

| | capacity | [VmInventoryCapacity](#vminventorycapacity) |

The inventory capacity level for this instance type.

Inventory capacity is defined based on available vCPU cores across all instance types, excluding memory, storage, or other resource factors.

| ## InstanceTypeQuotaItem Quotas of instance models. Referenced by：DescribeZoneInstanceConfigInfos | Parameter Name | Type | Description | | ---------------------------- | -------------------------------------------------- | ---------------------------------------------------------------------------- | | zoneId | String | Zone ID. | | instanceType | String | Instance model. | | instanceTypeName | String | Instance model name. | | cpuCount | Integer |

Quantity of CPU cores.

Unit: cores.

| | memory | Integer |

Memory size.

Unit: GiB.

| | bps | Integer | Bandwidth cap per vNIC. Unit: bits per second. | | pps | Integer | Maximum packet send/receive rate per vNIC. Unit: per second. | | internetMaxBandwidthOutLimit | Integer |

Outbound bandwidth cap.

Unit: Mbps.

| | withStock | Boolean | Whether the instance model is in stock. | | internetChargeTypes | Array of [InternetChargeType](#internetchargetype) |

Network billing model. See

InternetChargeType for more details.

| ## InterconnectDataCenter Information on the data center associated with a border gateway interconnect region. Referenced by：DescribeInterconnectBorderGatewayRegions | Parameter Name | Type | Description | | -------------- | ------ | ---------------------------- | | dcId | String | Data center ID. | | dcCode | String | Data center code. | | name | String | Data center name in English. | | cityName | String | City name in English. | | countryName | String | Country name in English. | ## InterconnectRegion Information on a border gateway interconnect region. Referenced by：DescribeInterconnectBorderGatewayRegions | Parameter Name | Type | Description | | -------------- | ------------------------------------------------- | ------------------------------------------ | | regionId | String | Region ID. | | name | String | Region name. | | dataCenter | [InterconnectDataCenter](#interconnectdatacenter) | Information on the associated data center. | ## InternetChargeType Network pricing model. Referenced by：CreateNetworkInterface, InquiryPriceChangeIpv6InternetChargeType, CreateEips, DescribeZoneInstanceConfigInfos, DescribeUnmanagedEgressIps, InquiryPriceCreateInstance, DescribeEips, InquiryPriceChangeUnmanagedEgressIpInternetChargeType, DescribeEipInternetChargeTypes, AssignNetworkInterfaceIpv6, InquiryPriceChangeEipInternetChargeType, CreateCrossRegionBandwidth, CreateZecInstances, DescribeEipPrice, DescribeNetworkInterfacePublicIPv6, InquiryPriceCreateCrossRegionBandwidth, DescribeCrossRegionBandwidth, ChangeEipInternetChargeType | Value | Description | | ---------------- | --------------------------------------------------------------------------------------------------------------------------------------- | | ByBandwidth | Billed by the flat rate bandwidth. | | ByTrafficPackage | Billed by the traffic package size purchased. | | BandwidthCluster | Billed by the burstable 95th bandwidth of all compute resources in a city-based or regional bandwidth cluster with a shared commitment. | ## IpType Information on IP types. Referenced by：CreateRoute, DescribeByoipRegions, DescribeRoutes | Value | Description | | ----- | ------------- | | IPv4 | IPv4 address. | | IPv6 | IPv6 address. | ## Ipv6CidrInfo Information on IPv6 CIDR block. Referenced by：DescribeIpv6Cidrs | Parameter Name | Type | Description | | --------------- | --------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------- | | cidrId | String | IPv6 CIDR block ID. | | regionId | String | The region ID to which the CIDR block belongs. | | name | String | CIDR block name. | | cidrBlock | String | CIDR block address, for example: 2400:8a00::/28. | | source | [CidrCreateSource](#cidrcreatesource) |

The ownership of the CIDR block.

For example, CONSOLE (owned by Zenlayer) or BYOIP (customer-provided IP).

| | networkLineType | [NetworkLineType](#networklinetype) |

CIDR network type.

The public IP line type supported by this CIDR block.

| | subnetIds | Array of String | Set of subnet IDs. | | nicIds | Array of String | Set of network interface IDs. | | netmask | Integer |

Subnet mask.

The length of the network prefix in CIDR notation.

| | poolId | String |

The ID of the pool.

The public IP pool to which this CIDR block belongs.

| | createTime | String | The creation time of the CIDR block. | | expiredTime | String | The expiration time of the CIDR block. | | resourceGroup | [ResourceGroupInfo](#resourcegroupinfo) | The resource group to which this CIDR block belongs. | | status | [CidrStatus](#cidrstatus) | The state of the CIDR block . | | asn | Integer |

ASN.

Only available when the CIDR source is BYOIP.

| | tags | [Tags](#tags) | The bound tags of this CIDR block. | | asnObservation | [AsnObservationDetail](#asnobservationdetail) | ASN observation result. | ## MarketingInfo Information on marketing campaigns. Referenced by：CreateCrossRegionBandwidth, CreateNetworkInterface, CreateEips, CreateZecInstances, CreateDisks, CreateCidr, InquiryPriceCreateCrossRegionBandwidth, CreateByoip | Parameter Name | Type | Required | Description | | -------------- | ------- | -------- | -------------------------------------------------------------------------------------------------- | | discountCode | String | No |

Promo Code.

If no Promo Code exists, the final discount will not apply.

| | usePocVoucher | Boolean | No |

Whether to use POC voucher.

If no POC voucher exists, the related creation will fail.

| ## MetricValue Information on performance metric values. Referenced by：DescribeInstanceMonitorData, DescribeDiskMonitorData, DescribeNetworkInterfaceMonitorData | Parameter Name | Type | Description | | -------------- | ------ | --------------------------------------------------------------------------------------------------------------------- | | time | String | The time of a data point. | | value | Float |

The value of a data point.

If the value is null, it means the corresponding data could not be retrieved.

| ## NatGateway Information on the NAT gateway. Referenced by：DescribeNatGateways | Parameter Name | Type | Description | | ----------------- | ----------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | natGatewayId | String | The unique ID of the NAT gateway. | | vpcId | String | VPC network ID to which the NAT gateway belongs. | | regionId | String | Region ID. | | status | [NatStatus](#natstatus) | NAT gateway state. | | name | String | The name of the NAT gateway. | | subnetIds | Array of String | Subnet ID list to which the NAT gateway belongs. | | eipIds | Array of String | Elastic IP ID list bound to the NAT gateway. | | zbgId | String | Border gateway ID. | | resourceGroupId | String | Resource group ID. | | resourceGroupName | String | Resource group name. | | isAllSubnets | Boolean | Whether all subnets within a region are associated with the NAT gateway. | | icmpReplyEnabled | Boolean | Whether to enable ICMP echo reply or not. | | securityGroupId | String | Associated security group ID of the NAT gateway. | | createTime | String |

Creation time.

Use UTC time according to the ISO8601 standard. Format: YYYY-MM-ddTHH🇲🇲ssZ.

| | expiredTime | String |

Expiration time.

Use UTC time according to the ISO8601 standard. Format: YYYY-MM-ddTHH🇲🇲ssZ.

| | tags | [Tags](#tags) | Tags bound to resources. | ## NatStatus State of the NAT gateway. Referenced by：DescribeNatGateways | Value | Description | | -------------- | ---------------------------------- | | CREATING | NAT gateway is being created. | | RUNNING | NAT gateway is running. | | RECYCLED | NAT gateway is in the recycle bin. | | CREATE\_FAILED | NAT gateway creation failed. | | RELEASING | NAT gateway is being released. | ## NetmaskInfo Information on CIDR block size. Referenced by：CreateCidr, DescribeCidrPrice | Parameter Name | Type | Required | Description | | -------------- | ------- | -------- | ------------------------------------------------------ | | netmask | Integer | Yes |

CIDR block size.

Value range: \[27, 32]

| | amount | Integer | Yes |

CIDR block quantity.

Value range: \[0, +)

| ## NetworkLineType Network type of public IP address. Referenced by：DescribeByoipPrice, CreateEips, DescribeIpv6Cidrs, DescribeByoipRegions, DescribeEipRemoteRegions, CreateByoip, DescribeUnmanagedEgressIps, InquiryPriceCreateInstance, DescribeEips, DescribeCidrs, DescribeEipInternetChargeTypes, CreateZecInstances, DescribeEipPrice, CreateCidr, DescribeEipNetworkLineTypes, DescribeCidrPrice | Value | Description | | -------------------- | ---------------------------------------------------------------------------------- | | PremiumBGP |

Premium BGP network.

High-performance network.

| | CN2 | China Telecom CN2 network. | | PathBasedBandwidthIP | Multi-path bandwidth IP. | | LocalLine | Provided by a local ISP. | | StandardBGP |

Standard BGP network.

General-purpose network with cost optimization.

| | CMI | 1-Line IP China Mobile. | | CUG | 1-Line IP China Unicom. | | CTG | 1-Line IP China Telecom. | ## NextHopType Information on the next hop of a route. Referenced by：DescribeRoutes | Value | Description | | ----- | ------------------ | | NIC | Network interface. | | VPC | Global VPC. | | NAT | NAT gateway. | | ZBG | Border gateway. | ## NicApiMonitorMeta Describes the value of the network interface monitoring type. Referenced by：DescribeNetworkInterfaceMonitorData | Value | Description | | ----------- | ----------------------------------------------------------------------------------------------------------------------------------------------------- | | RX\_BITS |

The number of bits received per second by the VF NIC of the virtual machine.

Unit: bits.

| | TX\_BITS |

The number of bits sent per second by the VF NIC of the virtual machine.

Unit: bits.

| | RX\_PACKETS |

The number of packets received per second by the VF NIC of the virtual machine.

Unit: Packets.

| | TX\_PACKETS |

The number of packets sent per second by the VF NIC of the virtual machine.

Unit: Packets.

| | RX\_DROPPED |

The number of dropped packets per second in the inbound direction, summed across the VF NIC and Virtio NIC for this NIC.

Unit: Packets.

| | TX\_DROPPED |

The number of dropped packets per second in the outbound direction, summed across the VF NIC and Virtio NIC for this NIC.

Unit: Packets.

| | RX\_ERRORS |

The number of error packets per second in the inbound direction, summed across the VF NIC and Virtio NIC for this NIC.

Unit: Packets.

| | TX\_ERRORS |

The number of error packets per second in the outbound direction, summed across the VF NIC and Virtio NIC for this NIC.

Unit: Packets.

| ## NicInfo Information of vNIC. Referenced by：DescribeInstances, DescribeNetworkInterfaces | Parameter Name | Type | Description | | --------------- | --------------------------------------- | -------------------------------------------------------------------------------------------- | | nicId | String | vNIC ID. | | name | String | vNIC name. | | status | [NicStatus](#nicstatus) | vNIC status. | | nicType | [NicType](#nictype) | vNIC type. | | regionId | String | Region ID. | | nicSubnetType | [SubnetStackType](#subnetstacktype) | IP stack type of the vNIC. | | publicIpList | Array of String | Public IP addresses. | | privateIpList | Array of String | Private IP addresses. | | primaryIpv4 | String | Primary private IPv4 address. | | primaryIpv6 | String |

Primary private IPv6 address.

If the IP stack type is IPv4, this value is null.

| | ipv6Cidr | String |

IPv6 CIDR block.

If the IP stack type is IPv4, this value is null.

| | secondaryIpv4s | Array of String | Secondary private IPv4 addresses. | | macAddress | String | MAC address. | | instanceId | String | Instance ID. | | vpcId | String | VPC ID. | | subnetId | String | Subnet ID. | | createTime | String | Creation time. | | updateTime | String | Updating time. | | resourceGroup | [ResourceGroupInfo](#resourcegroupinfo) | Resource group information. | | securityGroupId | String | Associated security group ID of the vNIC. | | tags | [Tags](#tags) | Tags bound to resources. | ## NicNetworkType Informations on network interface mode. Referenced by：DescribeImages, CreateZecInstances, DescribeInstances, ChangeNicNetworkType, DescribeCustomImages | Value | Description | | ---------- | ----------------------------------- | | Auto | Default mode auto-adapted to image. | | FailOver | Failover mode. | | VirtioOnly | Virtio-net mode. | | VfOnly | VFIO mode. | ## NicStatus Status of vNIC. Referenced by：DescribeInstances, DescribeNetworkInterfaces | Value | Description | | -------------- | ------------------------------------- | | PENDING | Creating. | | AVAILABLE | Available. Not bound to any instance. | | ATTACHING | Binding. | | DETACHING | Unbinding. | | DELETING | Deleting. | | CREATE\_FAILED | Creating failed. | | USED | Bound. | ## NicType Information on the vNIC types. Referenced by：DescribeInstances, DescribeNetworkInterfaces | Value | Description | | --------- | ---------------------------- | | Primary | Primary network interface. | | Secondary | Secondary network interface. | ## OperationInfo Operation details. Referenced by：DescribeNetworkInterfacePublicIPv6, DescribeEips | Parameter Name | Type | Description | | -------------- | ------ | --------------------------------------------------------------------------------------------------------------- | | operation | String | Operation action. Value range: `ModifyBandwidth` (adjust bandwidth), `ModifyFlowPackage` (adjust flow package). | | status | String | Operation status. Value range: `OPERATING` (in operation), `FAILED` (operation failed). | ## PlacementGroupConstraintStatus The placement group constraints status. Referenced by：DescribePlacementGroups | Value | Description | | ----------- | --------------------------------------------- | | Satisfied | Placement policy constraint is satisfied. | | Unsatisfied | Placement policy constraint is not satisfied. | ## PlacementGroupInfo Describes the detailed information of a placement group. Referenced by：DescribePlacementGroups | Parameter Name | Type | Description | | ---------------- | ----------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------ | | placementGroupId | String | Placement group ID | | name | String | Placement group name. | | zoneId | String | Zone ID of the placement group. | | partitionNum | Integer |

Number of partitions in the placement group.

Valid values range from 2 to 5, which determines the maximum number of associated instances.

| | affinity | Integer |

Affinity of the placement group.

Valid values range from 1 to floor(partitionNum / 2).

| | instanceCount | Integer | Number of instances within the placement group. | | instanceIds | Array of String | List of instance IDs associated with the placement group. | | constraintStatus | [PlacementGroupConstraintStatus](#placementgroupconstraintstatus) | Constraint satisfaction status of the placement group. | | createTime | String | Creation time. | | resourceGroup | [ResourceGroupInfo](#resourcegroupinfo) | Resource group information to which the placement group belongs. | | tags | [Tags](#tags) | Tags of the placement group. | ## PolicyInfo Informations on DDoS protection strategy. Referenced by：DescribePolicys | Parameter Name | Type | Description | | ----------------- | ------------- | ----------------------------------- | | policyId | String | Protection strategy ID. | | policyName | String | Protection strategy name. | | createTime | String | Creation time. | | resourceGroupId | String | Resource group ID. | | resourceGroupName | String | Resource group name. | | tags | [Tags](#tags) | Bound tags when creating resources. | ## PolicyRegion Informations on regions for geo-blocking. Referenced by：DescribePolicyRegions | Parameter Name | Type | Description | | -------------- | ------ | ------------ | | regionId | String | Region ID. | | regionName | String | Region name. | | areaName | String | Area name. | ## PolicyUpdateType Modified policy information of DDoS protection strategy. Referenced by：ModifyPolicy | Value | Description | | -------------- | ----------------------------------- | | UdpReflect | Modify UDP reflection source ports. | | TrafficControl | Modify source IP rate limiting. | | Port | Modify port blocking rules. | | BlockProtocol | Modify protocol blocking. | | IpList | Modify IP allow/deny list. | | BlockRegion | Modify regions in geo-blocking. | | Fingerprint | Modify fingerprint filtering rules. | ## PoolInfo Information on IP pools. Referenced by：DescribePools | Parameter Name | Type | Description | | -------------- | ------- | ------------------------ | | poolId | String | Pool ID. | | regionId | String | Region ID. | | name | String | Pool name. | | createTime | String | Creation time. | | ipv4CidrCount | Integer | The number of CIDR IPv4. | | ipv6CidrCount | Integer | The number of CIDR IPv6. | ## PriceCategory Information on the pricing category. Referenced by：InquiryPriceCreateInstance | Value | Description | | ---------- | --------------- | | STANDARD | Standard price. | | CUSTOMIZED | Fixed price. | ## PriceItem Information on the price. Referenced by：InquiryPriceModifyEipBandwidth, InquiryPriceChangeIpv6InternetChargeType, InquiryPriceCreateDisks, InquiryPriceResizeDisk, DescribeByoipPrice, InquiryPriceCreateInstance, InquiryPriceModifyEipFlowPackage, InquiryPriceChangeUnmanagedEgressIpInternetChargeType, InquiryPriceModifyUnmanagedEgressIpBandwidth, InquiryPriceChangeEipInternetChargeType, InquiryPriceModifyCrossRegionBandwidth, InquiryPricePublicIpv6, InquiryPriceModifyIpv6Bandwidth, DescribeEipPrice, InquiryPriceModifyInstanceType, InquiryPriceCreateCrossRegionBandwidth, InquiryPriceCreateNatGateway, DescribeCidrPrice | Parameter Name | Type | Description | | ----------------------- | -------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | discount | Float |

Discount.

For example, 80.0 means 20% off.

| | discountPrice | Float |

Discount price of postpaid resources.

Only used in pay-as-you-go model. For tiered billing, the value is empty.

| | originalPrice | Float |

Original price of prepaid resources.

Only used in subscription model. For pay-as-you-go model, the value is empty.

| | unitPrice | Float |

Original unit price of postpaid resources.

Only used in pay-as-you-go model. For tiered billing, the value is empty.

| | discountUnitPrice | Float |

Discount unit price of postpaid resources.

Only used in pay-as-you-go model. For tiered billing, the value is empty.

| | chargeUnit | String |

Unit of postpaid billing.

Only used in pay-as-you-go model.

Value range:

HOUR : you will be billed by hour.

DAY : you will be billed by day.

MONTH : you will be billed by month. For example, the burstable 95th pricing model.

| | stepPrices | Array of [StepPrice](#stepprice) |

Tiered price of postpaid billing.

Only used in pay-as-you-go model. If it is not tiered price, the value is empty.

| | amountUnit | String |

Unit of usage,

such as Mbps , LCU , and etc.

If the value is empty, it means there is no unit.

| | excessUnitPrice | Float | Original unit price of overages. | | excessDiscountUnitPrice | Float | Discount unit price of overages. | | excessAmountUnit | String |

Unit of overage usage.

If the value is empty, it means there is no unit.

| | category | [PriceCategory](#pricecategory) | The category to which the price belongs. | ## PrivateIpInfo Information on private IP address. Referenced by：AvailableLanIp | Parameter Name | Type | Description | | -------------- | ------ | ------------------------------------------------------------------------------------------------------------ | | lanIp | String | Private IPv4 address assigned to the vNIC that can be bound to the specified EIP. | | nicId | String | ID of the vNIC. | | nicName | String | vNIC name. | | instanceId | String |

ID of the instance the vNIC is attached to.

Null if the vNIC is not attached to any instance.

| | instanceName | String |

Name of the instance the vNIC is attached to.

Null if the vNIC is not attached to any instance.

| ## Protocol Informations on protocol blocking of DDoS protection strategy. Referenced by：CreatePolicy, DescribePolicyDetail, ModifyPolicy | Value | Description | | ----- | --------------------------------------------------------------------------------------- | | TCP | Block TCP traffic. | | UDP | Block UDP traffic. | | ICMP |

Blocks all ICMP traffic.

ICMP protocol is not supported for port blocking.

| ## PublicIpv6CidrAddress Information on public IPv6 address. Referenced by：DescribeNetworkInterfacePublicIPv6 | Parameter Name | Type | Description | | ------------------ | --------------------------------------------- | ------------------------------------------------------------------ | | ipv6CidrId | String | The ID of the IPv6 address. | | ipv6Cidr | String | The IPv6 address. | | primaryIpv6Address | String | The primary IPv6 address of the network interface. | | internetChargeType | [InternetChargeType](#internetchargetype) | The network billing model of the IPv6 address. | | bandwidth | Integer |

Public bandwidth cap for IPv6 address.

Unit: Mbps.

| | rateLimitMode | [RateLimitMode](#ratelimitmode) |

Rate limit mode.

Default value: LOOSE

| | trafficPackageSize | Float |

The size of the IPv6 data transfer package.

Unit: TB.

| | bandwidthCluster | [BandwidthClusterInfo](#bandwidthclusterinfo) | The associated bandwidth cluster information. | | operationInfo | [OperationInfo](#operationinfo) | The bandwidth and traffic packet operation status of IPv6. | ## QosPolicyGroup QoS policy group information. Referenced by：DescribeQosPolicyGroups | Parameter Name | Type | Description | | ---------------- | ------------------------------------------------------ | --------------------------------------------------- | | qosPolicyGroupId | String | QoS policy group ID. | | name | String | QoS policy group name. | | regionId | String | Region ID. | | bandwidthLimit | Integer | Bandwidth limit, in Mbps. | | rateLimitMode | [RateLimitMode](#ratelimitmode) | Rate limit mode. | | memberCount | Integer | Number of members. | | members | Array of [QosPolicyGroupMember](#qospolicygroupmember) | Member list. | | createTime | String | Creation time. | | resourceGroup | [ResourceGroupInfo](#resourcegroupinfo) | Information about the resource group it belongs to. | | tags | [Tags](#tags) | Tag list. | ## QosPolicyGroupMember QoS policy group member information. Referenced by：DescribeQosPolicyGroups, AddQosPolicyGroupMembers | Parameter Name | Type | Required | Description | | -------------- | ----------------------------------- | -------- | ------------------ | | resourceId | String | Yes | ID of IP resource. | | ipType | [BandwidthIpType](#bandwidthiptype) | Yes | IP type. | ## RateLimitMode Rate limit mode for QoS policy groups. Referenced by：CreateQosPolicyGroup, CreateEips, DescribeNetworkInterfacePublicIPv6, ModifyNetworkInterfacePublicIPv6BandwidthLimitMode, ModifyUnmanagedEgressIpBandwidthLimitMode, DescribeQosPolicyGroups, DescribeUnmanagedEgressIps, DescribeEips, ModifyEipBandwidthLimitMode, ModifyQosPolicyGroup, AssignNetworkInterfaceIpv6 | Value | Description | | ------ | --------------------------------------------------------- | | LOOSE | Loose mode: allows short-term bursts exceeding the limit. | | STRICT | Strict mode: strictly enforced, no bursts allowed. | ## ReflectUdpPortPolicy Information on UDP reflection source port. Referenced by：DescribeReflectUdpPortOptions | Parameter Name | Type | Description | | -------------- | ------- | ----------------------- | | name | String | Reflection attack type. | | port | Integer | Reflection source port. | ## Region Information on regions that support BYOIP CIDR blocks. Referenced by：DescribeByoipRegions | Parameter Name | Type | Description | | -------------- | ----------------------------------- | ------------------------ | | netmask | Integer | Supported subnet mask. | | regionId | String | Supported regions. | | network | [NetworkLineType](#networklinetype) | Supported network types. | | ipType | [IpType](#iptype) | Supported IP types. | ## RegionInfo Information on regions. Referenced by：DescribeSubnetRegions | Parameter Name | Type | Description | | -------------- | ------- | ----------------------------------- | | regionId | String | Region ID. | | regionName | String | Region name. | | regionTitle | String | Region title. | | enablePubIpv6 | Boolean | Whether support public IPv6 or not. | ## ReplaceIp Information of the original and target elastic IPs. Referenced by：ReplaceEipAddress | Parameter Name | Type | Required | Description | | -------------- | ------ | -------- | ------------------------------------------------------------------------------------------------- | | eipId | String | No | Elastic IP ID. | | ownIp | String | No |

Source IP.

Required when the IP line type is ThreeLine (three-line IP).

| | targetIp | String | No |

Target IP to replace.

If not specified, the system will assign one randomly.

| ## ResourceGroupInfo Information on resource group, including resource group name and resource group ID. Referenced by：DescribeAutoSnapshotPolicies, DescribeVpcs, DescribeIpv6Cidrs, DescribeInstances, DescribeQosPolicyGroups, DescribeSnapshots, DescribePlacementGroups | Parameter Name | Type | Description | | ----------------- | ------ | -------------------- | | resourceGroupId | String | Resource group ID. | | resourceGroupName | String | Resource group name. | ## RouteInfo Information on routes. Referenced by：DescribeRoutes | Parameter Name | Type | Description | | -------------------- | --------------------------- | -------------------------------------------------------------------------------------------------------------------------- | | vpcId | String | Global VPC ID. | | vpcName | String | Global VPC name. | | ipVersion | [IpType](#iptype) |

IP type.

The optional values are as follows: IPv4 , IPv6

| | type | [RouteType](#routetype) | Route type. | | destinationCidrBlock | String |

Destination CIDR block for IPv4 or IPv6.

For example: 10.0.1.0/24 .

| | cidrBlock | String |

CIDR block destination address.

This field is deprecated. Please use destinationCidrBlock instead.

| | nextHopId | String | Next hop ID. | | nextHopName | String | Next hop name. | | routeId | String | Route ID. | | name | String | Route name. | | sourceCidrBlock | String |

Source CIDR block.

This field is applicable only when the route type is RouteTypePolicy (policy-based route).

| | priority | Integer | Route priority. | | nextHopType | [NextHopType](#nexthoptype) | Next hop type. | | createTime | String | Route creation time. | ## RouteType Information on route types. Referenced by：CreateRoute, DescribeRoutes | Value | Description | | ---------------- | ----------------------------------------------------------------------------------- | | RouteTypeSubnet |

Subnet route.

Subnet route is auto-generated when a subnet is created.

| | RouteTypeStatic |

Static route.

Static route is a kind of custom route.

| | RouteTypePolicy |

Policy-based route.

Policy-based route is a kind of custom route.

| | RouteTypeNatGw | NAT gateway route. | | RouteTypeTransit | Dynamic route. | ## RoutingMode Information on dynamic routing modes. Referenced by：ModifyBorderGatewaysAttribute, DescribeBorderGateways, CreateBorderGateway | Value | Description | | -------- | -------------------------------------------------------------------------------------------------------------- | | Regional | Regional routing. Learn routes only within the region it was created in. | | Global | Global routing. Dynamically learn and distribute routes across all regions using a single VPN or Interconnect. | ## SecurityGroupInfo Information on security group, including security group creation. Referenced by：DescribeSecurityGroups | Parameter Name | Type | Description | | ------------------ | --------------- | -------------------------------------------------------------------------------------------------------------------------------------- | | securityGroupId | String | Security group ID. | | securityGroupName | String | Security group name. | | scope | String |

Security group deployed scope.

Currently only support Global .

| | createTime | String |

Creation time.

Format: YYYY-MM-ddTHH🇲🇲ssZ .

| | vpcIds | Array of String | Associated global VPC ID list. | | isDefault | Boolean | Whether the security group is default or not. | | nicIdList | Array of String | ID list of associated vNICs. | | natIdList | Array of String | ID list of associated NAT gateways. | | loadBalancerIdList | Array of String | ID list of associated load balancers. | | haVipIdList | Array of String | List of HaVip IDs associated with the security group. | ## SecurityGroupRuleInfo Information on security group rules, including inbound/outbound rules, port range, IP protocol, etc. Referenced by：CreateSecurityGroup, DescribeSecurityGroupRule, ConfigureSecurityGroupRules | Parameter Name | Type | Required | Description | | -------------- | ------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | direction | String | Yes |

Traffic directions.

ingress : inbound rules.

egress : outbound rules.

| | policy | String | Yes |

Access strategy.

Available values:

accept : allows access by default.

Only accept strategy is supported for now.

| | priority | Integer | Yes |

Priority of rules.

Available values:

\[1,100].

Default value: 1.

Value range: \[1, 999]

| | ipProtocol | String | Yes |

Transport protocol. The value is case sensitive.

Available value:

tcp : TCP protocol. udp : UDP protocol. icmp : ICMP protocol. all : all protocols supported.

| | portRange | String | Yes |

Destination port range.

Available values:

For TCP and UDP protocols: The value ranges from 1 to 65535. Use a slash (/) to separate the start port number and the end port number. Examples: 1/200 ; incorrect example: 200/1 . For ICMP protocol: -1/-1 . For all protocols: -1/-1 .

| | cidrIp | String | Yes |

Source IP address range.

Default value: 0.0.XX.XX/0 .

| | desc | String | No | Description. 255 characters in length. | ## SnapshotInfo Information on snapshots. Referenced by：DescribeSnapshots | Parameter Name | Type | Description | | -------------- | ------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------- | | snapshotId | String | Snapshot ID. | | snapshotName | String | Snapshot name. | | zoneId | String | Availability zone ID of the snapshot. | | status | [SnapshotStatusValue](#snapshotstatusvalue) | Snapshot state. | | snapshotType | [SnapshotType](#snapshottype) | Snapshot type. | | retentionTime | String |

Snapshot retention time.

If no value can be retrieved, it indicates that the snapshot is retained permanently.

| | diskId | String | Disk ID. | | createTime | String | Creation time. | | diskAbility | Boolean | Whether the disk can be created by the snapshot. | | resourceGroup | [ResourceGroupInfo](#resourcegroupinfo) | Resource group information. | ## SnapshotStatusValue Information on snapshot states. Referenced by：DescribeSnapshots | Value | Description | | ------------- | -------------------------- | | CREATING | Creating. | | AVAILABLE | Creating succeeded. | | FAILED | Creating failed. | | ROLLING\_BACK | Reverting to the snapshot. | | DELETING | Deleting. | ## SnapshotType Information on snapshot types. Referenced by：DescribeSnapshots | Value | Description | | ------ | ------------------- | | Auto | Automatic snapshot. | | Manual | Manual snapshot. | ## SnatEntry Information on the SNAT rules. Referenced by：DescribeNatGatewayDetail | Parameter Name | Type | Description | | -------------- | ---------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------ | | snatEntryId | String | SNAT entry ID. | | eipIds | Array of String | The elastic IP ID list configured in the SNAT rule. | | snatSubnets | Array of [SnatSubnet](#snatsubnet) | The subnet ID list configured in the SNAT rule. | | cidrs | Array of String |

CIDR block. The default value is 0.0.0.0/0 if not passed in.

cidrs and snatSubnets cannot exist simultaneously.

| | isAllEip | Boolean | Whether the public egress IPs are all elastic IPs bound to this NAT gateway | ## SnatSubnet Information on subnets configured in the SNAT rule. Referenced by：DescribeNatGatewayDetail | Parameter Name | Type | Description | | -------------- | ------ | ------------------------- | | subnetId | String | Subnet ID. | | cidr | String | CIDR block of the subnet. | ## StepPrice Information on tiered pricing. 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.

If the value is empty, it means the last tier.

| | unitPrice | Float | Original unit price of current price range. | | discountUnitPrice | Float | Discount unit price of current price range. | ## SubnetInfo Information on subnets Referenced by：DescribeSubnets | Parameter Name | Type | Description | | -------------------- | ------- | -------------------------------------------------------------------------------------------------------------------------------------------------------- | | subnetId | String | Subnet ID. | | regionId | String | Region ID. | | name | String | Subnet name. | | cidrBlock | String | The IPv4 CIDR block of the subnet. | | gatewayIpAddress | String | Gateway ip address. | | ipv6CidrBlock | String | The IPv6 CIDR block of the subnet. Returns null if the IP stack type does not include IPv6. | | ipv6GatewayIpAddress | String | IPv6 gateway ip address. | | stackType | String |

Subnet IP stack type.

The optional values are as follows:

IPv4 , IPv4\_IPv6 , IPv6

| | ipv6Type | String | The IPv6 type of the subnet. Valid values: Private (internal network), Public (public network). Returns null if the IP stack type does not include IPv6. | | vpcId | String | Global VPC ID to which the subnet belong. | | vpcName | String | Global VPC name to which the subnet belong. | | usageIpv4Count | Integer | Used IPv4 quantity of the subnet. | | usageIpv6Count | Integer | Used IPv6 quantity of the subnet. | | createTime | String | Creation time of subnet. | | isDefault | Boolean | Whether this is the default subnet. | | dhcpOptionsSetId | String | DHCP options set ID. | | ipv6MaskLength | Integer | The IPv6 prefix length allocated to virtual machines. Returns null if the IP stack type does not include IPv6. | ## SubnetStackType Information on the IP stack types of the vNIC. Referenced by：CreateNetworkInterface, CreateZecInstances, CreateSubnet, DescribeInstances, ModifySubnetStackType, DescribeNetworkInterfaces | Value | Description | | ---------- | ------------------------- | | IPv4 | IPv4 stack type only. | | IPv4\_IPv6 | IPv4 and IPv6 stack type. | | IPv6 | IPv6 stack type only. | ## SystemDisk Information on boot disks. Referenced by：CreateZecInstances, DescribeInstances, InquiryPriceCreateInstance | Parameter Name | Type | Required | Description | | --------------- | ------- | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | diskSize | Integer | Yes |

Boot disk size.

Unit: GiB.

Value range: \[1, +)

| | diskId | String | No |

Boot disk ID.

This parameter is currently only used as a response parameter in query operations such as DescribeInstances, and cannot be used as an input parameter in write operations like CreateInstances.

| | diskCategory | String | No |

Disk type.

Basic NVMe SSD: Economical NVMe SSD.

Standard NVMe SSD: Standard NVMe SSD.

Default is Standard NVMe SSD.

Default value: Standard NVMe SSD

| | burstingEnabled | Boolean | No |

Whether to enable burstable performance.

Default value: false

| ## Tag Information on a tag, including its key and value. Referenced by：DescribePolicys, DescribeAutoSnapshotPolicies, DescribeImages, DescribeNatGateways, DescribeIpv6Cidrs, DescribeQosPolicyGroups, DescribeNetworkInterfaces, DescribeDisks, DescribeEips, DescribeCidrs, DescribeDhcpOptionsSets, DescribeVpcs, CreateZecInstances, DescribeInstances, DescribeCustomImages, DescribeHaVips | Parameter Name | Type | Required | Description | | -------------- | ------ | -------- | -------------------------------------------- | | key | String | Yes | Tag key. Length limit: 1 to 64 characters. | | value | String | No | Tag value. Length limit: 1 to 64 characters. | ## TagAssociation Information on tags bound to resources, including their keys and values. Referenced by：CreateNetworkInterface, CreatePlacementGroup, CreateDhcpOptionsSet, CreatePolicy, CreateEips, CreateDisks, CreateByoip, CreateQosPolicyGroup, CreateVpc, CreateAutoSnapshotPolicy, CreateNatGateway, CreateZecInstances, CreateCidr, CreateHaVip, ModifyPolicy, CreateImage | 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：DescribePolicys, DescribeAutoSnapshotPolicies, DescribeImages, DescribeNatGateways, DescribeIpv6Cidrs, DescribeQosPolicyGroups, DescribeDisks, DescribeEips, DescribeCidrs, DescribeDhcpOptionsSets, DescribeVpcs, DescribeInstances, DescribePlacementGroups, DescribeCustomImages, DescribeHaVips | Parameter Name | Type | Description | | -------------- | -------------------- | ------------- | | tags | Array of [Tag](#tag) | List of tags. | ## TopPort Informations on attack ports. Referenced by：DescribeDDosEventDetail | Parameter Name | Type | Description | | -------------- | ------- | -------------- | | protocol | String | Port protocol. | | port | Integer | Port number. | ## TrafficDataPoint Traffic monitoring data point. Referenced by：DescribeQosPolicyGroupTraffic | Parameter Name | Type | Description | | -------------- | ------- | -------------------------------------------------------------------------------------------------------------------------------------------- | | timestamp | String |

Data point time.

Time format: yyyy-MM-ddTHH🇲🇲ssZ.

| | bandwidthIn | Integer | Inbound bandwidth, in bps. | | bandwidthOut | Integer | Outbound bandwidth, in bps. | ## UnmanagedEgressIpInfo Information about an unmanaged egress IP. Referenced by：DescribeUnmanagedEgressIps | Parameter Name | Type | Description | | ------------------- | --------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------- | | unmanagedEgressIpId | String | Unique ID of the unmanaged egress IP. | | ip | String | Public IP address. | | regionId | String | Region ID. | | vpcId | String | Unique ID of the VPC. | | status | [UnmanagedEgressIpStatus](#unmanagedegressipstatus) | Resource status. | | networkLineType | [NetworkLineType](#networklinetype) | Network type. | | internetChargeType | [InternetChargeType](#internetchargetype) | Internet charge type. | | bandwidthCap | Integer | Bandwidth cap, in Mbps. Returns the team's default bandwidth cap if no separate bandwidth is configured for the resource. | | rateLimitMode | [RateLimitMode](#ratelimitmode) |

Rate limit mode.

Default value: LOOSE

| | createTime | String | Creation time. | ## UnmanagedEgressIpStatus Status values of unmanaged egress IPs. Referenced by：DescribeUnmanagedEgressIps | Value | Description | | --------- | ------------------- | | CREATING | Creating. | | AVAILABLE | Available. | | RECYCLED | In the recycle bin. | | DELETING | Deleting. | | FAILED | Creation failed. | ## VmInventoryCapacity Describing inventory capacity information. Referenced by：DescribeVmInventoryCapacity, DescribeZoneGpuInstanceConfigInfos | Value | Description | | ---------- | ------------------------------------------------------------------ | | LIMITED | Limited inventory, with available vCPU cores < 1000. | | NORMAL | Normal inventory, with available vCPU cores from 1000 to 2000. | | SUFFICIENT | Sufficient inventory, with available vCPU cores from 2000 to 5000. | | ABUNDANT | Abundant inventory, with available vCPU cores ≥ 5000. | ## VmRegionCapacityItem Region inventory capacity information. Referenced by：DescribeVmInventoryCapacity | Parameter Name | Type | Description | | -------------- | -------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | regionId | String | Region ID in the format of asia-north-1. | | capacity | [VmInventoryCapacity](#vminventorycapacity) |

The overall inventory capacity level for this region.

Inventory capacity is defined based on available vCPU cores across all instance types, excluding memory, storage, or other resource factors.

| | instanceTypes | Array of [InstanceTypeCapacityItem](#instancetypecapacityitem) | Inventory capacity details for each instance type, excluding entries with zero inventory. | ## VpcInfo Information on global VPCs. Referenced by：DescribeVpcs | Parameter Name | Type | Description | | --------------- | --------------------------------------- | --------------------------------------------------------- | | vpcId | String | Global VPC ID. | | name | String | Global VPC name. | | cidrBlock | String | CIDR block of global VPC. | | ipv6CidrBlock | String | IPv6 CIDR block of global VPC. | | mtu | Integer | The MTU (Maximum Transmission Unit) of the VPC, in bytes. | | isDefault | Boolean | Whether is default global VPC or not. | | createTime | String | Creation time of global VPC. | | usageIpv4Count | Integer | The number of IPv4 addresses allocated within the VPC. | | usageIpv6Count | Integer | The number of IPv6 addresses allocated within the VPC. | | securityGroupId | String | Associated security group ID of global VPC. | | dnsZoneIds | Array of String | The DNS Zone ID associated with the VPC. | | resourceGroup | [ResourceGroupInfo](#resourcegroupinfo) | Resource group information. | | tags | [Tags](#tags) | Tags bound to resources. | ## VpcRegionBandwidthStatus Values of cross-region bandwidth states. Referenced by：DescribeCrossRegionBandwidth | Value | Description | | -------------- | ---------------------------------------------- | | CREATING | The cross-region bandwidth is being created. | | AVAILABLE | The cross-region bandwidth is available. | | CHANGING | The cross-region bandwidth is being changed. | | RECYCLED | The cross-region bandwidth is recycled. | | DELETING | The cross-region bandwidth is being deleted. | | CREATE\_FAILED | The cross-region bandwidth is creating failed. | ## ZbgAdvertisedSubnet Information on subnet route advertisement. Referenced by：ModifyBorderGatewaysAttribute, DescribeBorderGateways, CreateBorderGateway | Value | Description | | ----- | ------------------ | | ALL | Advertise all. | | NONE | Do not advertise. | | PART | Advertise partial. | ## ZbgInfo Information on border gateway. Referenced by：DescribeBorderGateways | Parameter Name | Type | Description | | ------------------- | ------------------------------------------- | --------------------------------------------------- | | zbgId | String | Border gateway ID. | | name | String | Border gateway name. | | vpcId | String | VPC ID. | | regionId | String | Region ID. | | asn | Integer | Autonomous System Number. | | interConnectCidr | String | Interconnect IP range. | | createTime | String | Creation time. | | routingMode | [RoutingMode](#routingmode) | Dynamic routing mode. | | natId | String | NAT gateway ID. | | cloudRouterIds | Array of String | Cloud router IDs that border gateway is added into. | | advertisedSubnet | [ZbgAdvertisedSubnet](#zbgadvertisedsubnet) | Subnet route advertisement. | | advertisedSubnetIds | Array of String | Subnet IDs. | | advertisedCidrs | Array of String | Custom IPv4 CIDR block list. | | advertisedRouteIds | Array of String | ID list of the custom routes to be advertised. | ## ZoneInfo Zone information, including city, etc. Referenced by：DescribeZones | Parameter Name | Type | Description | | ---------------------------------- | ------- | -------------------------------------------------------------------------------------------- | | zoneId | String | Zone ID. For example, SEL-A . | | regionId | String | Region ID of the zone. | | zoneName | String | Zone name. | | supportSecurityGroup \[Deprecated] | Boolean |

Support security groups or not.

Default value: true

| | timeZone | String | Time zone of the availability zone. | | cityName | String | Name of the city where the availability zone is located. | | cityCode | String | Three-letter IATA city code (e.g., LAX, HKG). | | countryCode | String | Country where the availability zone is located, in ISO 3166-1 alpha-2 format (e.g., US, JP). | | countryName | String | Name of the country where the availability zone is located. | | supportHaVip | Boolean | Whether the availability zone supports HaVip. |