Help Center/Elastic Cloud Server/API Reference/Data Structure/Data Structure for Querying Details About Specifications
Updated on 2026-03-19 GMT+08:00
View PDF
Share

Data Structure for Querying Details About Specifications

os_extra_specs (flavor) Field Description

This field is used by the following APIs:
  • Querying details about flavors and extended flavor information: /v1/{project_id}/cloudservers/flavors
  • Querying details about the extended ECS flavor field: /v1/{project_id}/flavors/{flavor_id}/os-extra_specs
Table 1 os_extra_specs field description (only common parameters are listed)

Parameter

Type

Description

ecs:performancetype

String

Definition

Specifies the ECS flavor type.

Range

  • normal: general computing
  • computingv3: general computing-plus
  • highmem: memory-optimized
  • cpuv1: computing I
  • cpuv2: computing II
  • highcpu: high-performance computing
  • diskintensive: disk-intensive
  • saphana: large-memory
  • kunpeng_highio: Kunpeng ultra-high I/O
  • kunpeng_accelerator: Kunpeng application-accelerated
  • advanced_smb: general computing (providing resources for Huawei Cloud FlexusX)
NOTE:

In an earlier registered flavor, this field is hws:performancetype.

Xen ECSs do not support this parameter.

Only the flavors displayed on the console are listed. To view other flavors, contact technical support.

hw:numa_nodes

String

Definition

Specifies the number of physical CPUs of the host. The ECS specifications determine whether to return the parameter value.

Range

N/A

resource_type

String

Definition

Specifies the resource type. resource_type is used to differentiate between the types of the physical servers accommodating ECSs.

Range

N/A

hpet_support

String

Definition

Specifies whether the high-precision clock is enabled for the ECS. The ECS specifications determine whether to return the parameter value.

Range

  • true: The high-precision clock is enabled.
  • false: The high-precision clock is disabled.

instance_vnic:type

String

Definition

Specifies the NIC type.

Range

The value is fixed at enhanced, indicating that network-enhanced resources are used to create ECSs.

instance_vnic:instance_bandwidth

String

Definition

Specifies the maximum bandwidth.

Range

Maximum value: 10000 (in Mbit/s)

instance_vnic:max_count

String

Definition

Specifies the maximum number of NICs.

Range

Maximum value: 4

quota:local_disk

String

Definition

This field is dedicated for disk-intensive ECSs.

Range

The value of this parameter is in format of {type}:{count}:{size}:{safeFormat}.

  • type: indicates the disk type, which can only be HDD.
  • count: indicates the number of local disks. The following types are supported:
    • For D1 ECSs, the value can be 3, 6, 12, or 24.
    • For D2 ECSs, the value can be 2, 4, 8, 12, 16, or 24.
    • For D3 ECSs, the value can be 2, 4, 8, 12, 16, 24, or 28.
  • size: indicates the capacity of a single disk, in GiB. Currently, only 1675 is supported. The actual disk size is 1800, and the available size after formatting is 1675.
  • safeFormat: indicates whether the local disks of the ECS are securely formatted. The following types are supported:
    • For D1 ECSs, the value is FALSE.
    • For D2 or D3 ECSs, the value is True.

quota:nvme_ssd

String

Definition

This field is dedicated for ultra-high I/O ECSs.

Range

The value of this parameter is in the format of {type}:{spec}:{num}:{size}:{safeFormat}.

  • type: indicates the capacity of a single NVMe SSD disk attached to the ECS, which can only be 1.6 TB or 3.2 TB.
  • spec: indicates the specifications of the NVMe SSD disk, which can be large (large specifications) or lvs (small specifications).

    If spec is set to large, only the I series (for example, I3) is supported.

  • num indicates the number of local disks.
  • size: indicates the capacity, in the unit of GiB, of the disk used by the guest user. If the spec value is large, the value of this parameter is the size of a single disk attached to the ECS. If the value of spec is lvs, the value of size is an integer multiple of 50.
  • safeFormat: indicates whether the local disks of the ECS are securely formatted.

    If safeFormat is set to True, only the I series (for example, I3) is supported.

extra_spec:io:persistent_grant

String

Definition

Specifies whether persistent storage is supported. This parameter is only available for disk-intensive D1 ECSs.

Range

This value is true, indicating that the ECS is persistently authorized to access the storage.

ecs:generation

String

Definition

Specifies the generation of an ECS type.

For example, 3 in s3 indicates the general computing III generation. For details about flavors and generations, see ECS Specifications in the Elastic Cloud Server User Guide.

Range

N/A

ecs:virtualization_env_types

String

Definition

Specifies a virtualization type.

Range

  • If the parameter value is FusionCompute, the ECS uses Xen virtualization.
  • If the parameter value is CloudCompute, the ECS uses KVM virtualization.

cond:operation:status

String

Definition

This parameter takes effect region-wide. If an AZ is not configured in the cond:operation:az parameter, the value of this parameter is used by default. If this parameter is not specified or used, the status is normal.

Range

  • normal: indicates that the flavor is commercially used.
  • abandon: indicates that the flavor has been taken offline (not displayed).
  • sellout: indicates that the flavor has been sold out.
  • obt: indicates that the flavor is under open beta testing (OBT).
  • obt_sellout: indicates that the OBT resources are sold out.
  • promotion: indicates that the flavor is recommended (for commercial use, which is similar to normal).

cond:operation:az

String

Definition

This parameter takes effect AZ-wide. If an AZ is not configured in this parameter, the value of the cond:operation:status parameter is used by default. This parameter is in the format of "az(xx)". The value in parentheses is the flavor status in an AZ. If the parentheses are left blank, the configuration is invalid. The cond:operation:az options are the same as the cond:operation:status options.

For example, a flavor is for commercial use in AZs 0 and 3, sold out in AZ 1, for OBT in AZ 2, and is canceled in other AZs. Then, set parameters as follows:

  • cond:operation:status: abandon
  • cond:operation:az: az0(normal), az1(sellout), az2(obt), az3(normal)
NOTE:

Configure this parameter if the flavor status in an AZ is different from the cond:operation:status value.

Range

N/A

quota:max_rate

String

Definition

Specifies the maximum bandwidth.

Range

Unit: Mbit/s. If the unit is Gbit/s, the value is divided by 1000.

quota:min_rate

String

Definition

Specifies the assured bandwidth.

Range

Unit: Mbit/s. If the unit is Gbit/s, the value is divided by 1000.

quota:max_pps

String

Definition

Specifies the maximum intranet PPS.

Range

Unit: number. If a value is in the unit of 10000, the value is divided by 10000.

cond:operation:charge:stop

String

Definition

Specifies whether charges apply after the ECS is stopped. By default, no charge applies.

Range

  • charge
  • free

cond:operation:charge

String

Definition

Specifies the billing mode. All billing modes are supported if this parameter is not specified.

Range

  • period: The billing mode is yearly/monthly.
  • demand: The billing mode is pay-per-use.

cond:spot:operation:az

String

Definition

For sales information about spot ECSs, use the API for querying flavor sales policies.

Specifies the AZ for the flavors in spot pricing billing mode.

Range

N/A

cond:operation:roles

String

Definition

Specifies the allowed roles.

Roles match the tags specified by op_gatexxx of roles. If this parameter is not specified, all users can use this API.

Range

N/A

cond:spot:operation:status

String

Definition

Specifies the status of a flavor in spot pricing billing mode. For sales information about spot ECSs, use the API for listing flavor sales policies. If this parameter is not specified, abandon is used.

Range

  • normal: indicates commercial use of the flavor.
  • abandon: indicates that the flavor has been taken offline.
  • sellout: indicates that the flavor has been sold out.
  • obt: indicates that the flavor is under OBT (not supported currently).
  • private: indicates that the flavor is private and only available to specified users (not supported currently).
  • test: indicates that the flavor is at free trial phase (not supported currently).
  • promotion: indicates that the flavor is recommended.

cond:network

String

Definition

Specifies network constraints.

Network features are supported. If this parameter is not specified, the default configuration on the console is used.

Range

N/A

cond:storage

String

Definition

Specifies storage constraints. Disk features are supported. If this parameter is not specified, the default configuration on the console is used.

Range

  • scsi: indicates that SCSI is supported.
  • localdisk: indicates that local disks are supported.
  • ib: indicates that IB is supported.

cond:storage:type

String

Definition

Specifies supported disk types. If you do not specify this parameter, the configuration on the console is used.

Range

  • SATA: common I/O disks (sold out)
  • SAS: high I/O disks
  • GPSSD: General Purpose SSDs
  • SSD: ultra-I/O disks
  • ESSD: extreme SSDs
  • GPSSD2: General Purpose SSD V2
  • ESSD2: extreme SSD V2

cond:compute:live_resizable

String

Definition

Specifies compute constraints.

Range

  • If the value of this parameter is true, online capacity expansion is supported.
  • If this parameter does not exist or its value is set to false, online capacity expansion is not supported.

cond:compute

String

Definition

Specifies compute constraints.

Range

  • autorecovery: indicates that automatic recovery is supported.
  • If this parameter does not exist, automatic recovery is not supported.

ecs:instance_architecture

String

Definition

Specifies the CPU architecture corresponding to the flavor. This parameter is returned only for Kunpeng ECSs.

Range

The value arm64 indicates that the CPU architecture is Kunpeng.

info:gpu:name

String

Definition

Specifies the number and names of GPUs.

Range

N/A

info:cpu:name

String

Definition

Specifies the CPU name.

Range

N/A

quota:gpu

String

Definition

Specifies the GPU name.

Range

N/A

quota:vif_max_num

String

Definition

Specifies the maximum number of elastic network interfaces that can be bound to an ECS.

Range

N/A

quota:sub_network_interface_max_num

String

Definition

Specifies the maximum number of auxiliary network interfaces that can be bound to an ECS.

Range

N/A

network_interface:traffic_mirroring_supported

String

Definition

Specifies whether the flavor supports traffic mirroring.

Range

N/A

info:features

String

Definition

Specifies the features supported by the flavor.

Range

N/A

security:enclave_supported

String

Definition

Specifies whether the flavor supports QingTian Enclave.

Range

N/A

info:gpus

String

Definition

Specifies information about the GPU.

Range

  • name: GPU name
  • memory_mb: GPU memory
  • count: the number of GPUs
  • alias_prefix: internal alias of a GPU

info:asic_accelerators

String

Definition

Specifies information about the accelerator.

Range

  • name: accelerator name
  • memory_mb: accelerator memory
  • count: the number of accelerators
  • alias_prefix: internal alias of an accelerator

Parent topic:Data Structure