Help Center/ Elastic Cloud Server/ API Reference/ Data Structure/ Data Structure for Query Details About Specifications
Updated on 2023-05-29 GMT+08:00

Data Structure for Query 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

Specifies the ECS flavor type:

  • normal: general computing
  • cpuv1: computing I
  • cpuv2: computing II
  • computingv3: general computing-plus
  • highmem: memory-optimized
  • saphana: large-memory HANA ECS
  • diskintensive: disk-intensive

hw:numa_nodes

String

Specifies the number of physical CPUs of the host. The ECS flavor determines whether to return the parameter value.

resource_type

String

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

hpet_support

String

Specifies whether to enable the high-precision clock on the ECS. true indicates to enable the function, and false indicates to disable the function. The ECS specifications determine whether to return the parameter value.

instance_vnic:type

String

Specifies the NIC type. The value of this parameter is consistently enhanced, indicating that network enhancement ECSs are to be created.

instance_vnic:instance_bandwidth

String

Specifies the maximum bandwidth in the unit of Mbit/s. The maximum value of this parameter is 10000.

instance_vnic:max_count

String

Specifies the maximum number of NICs. The maximum value of this parameter is 4.

quota:local_disk

String

The value of this parameter is in format of "{type}:{count}:{size}:{safeFormat}", where,

  • type: indicates the disk type, which can only be HDD.
  • count: indicates the number of local disks.
    • 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 GB. 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.
    • For D1 ECSs, the value is FALSE.
    • For D2 or D3 ECSs, the value is True.
NOTE:

This field is dedicated for disk-intensive ECSs.

quota:nvme_ssd

String

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 specification of the NVME SSD disk, which can be large or small.

    If the value is large, only I3 ECSs are supported.

  • num: indicates the number of partitions on the disk.
  • size: indicates the capacity, in the unit of GB, 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 spec value is small, the value of this parameter is 1/4 or 1/2 of the specification.
  • safeFormat: indicates whether the local disks of the ECS are securely formatted.

    If the value is True, only I3 ECSs are supported.

NOTE:

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

extra_spec:io:persistent_grant

String

Specifies whether persistence is supported. The value of this parameter is true.

This parameter indicates that the ECS is persistently authorized to access the storage.

NOTE:

This field is dedicated for disk-intensive D1 ECSs.

ecs:generation

String

Specifies the generation of an ECS type.

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

ecs:virtualization_env_types

String

Specifies a virtualization type.

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

This field is optional.

cond:operation:status

String

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 set or used, the meaning of normal applies. Options:

  • normal: indicates normal commercial use of the flavor.
  • abandon: indicates that the flavor has been canceled (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 the recommended flavor (commercial use, which is similar to normal).

cond:operation:az

String

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.

quota:max_rate

String

Specifies the maximum bandwidth.

  • Unit: Mbit/s. If a bandwidth is in the unit of Gbit/s, it must be divided by 1000.

quota:min_rate

String

Specified the assured bandwidth.

  • Unit: Mbit/s. If a bandwidth is in the unit of Gbit/s, it must be divided by 1000.

quota:max_pps

String

Specifies the maximum intranet PPS.

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

cond:operation:charge:stop

String

Specifies whether fees are billed for a stopped ECS.

  • No fees by default
  • charge
  • free

cond:operation:charge

String

Specifies a billing type.

  • All the billing types are supported if this parameter is not set.
  • period: The billing type is yearly or monthly.
  • demand: The billing type is pay-per-use.

cond:spot:operation:az

String

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

cond:operation:roles

String

Specifies the allowed roles.

Matched user tag (roles op_gatexxx), which is available to all users if this parameter is not set

cond:spot:operation:status

String

Specifies the status of a flavor in spot pricing billing mode.

  • Equivalent to abandon if this parameter is not set.
  • normal: indicates commercial use of the flavor.
  • abandon: indicates that the flavor has been terminated.
  • sellout: indicates that the flavor has been sold out.
  • obt: indicates that the flavor is at OBT phase (not supported currently).
  • private: indicates that the flavor is private, which is available only 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

Specifies network constraints.

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

cond:storage

String

Specifies storage constraints.

  • Disk features are supported. If this parameter is not set, the default configuration on the console is used.
  • scsi: indicates that SCSI is supported.
  • localdisk: indicates that local disks are supported.
  • ib: indicates that IB is supported.

cond:compute:live_resizable

String

Specifies computing constraints.

  • 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

Specifies computing constraints.

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

ecs:instance_architecture

String

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

The value arm64 indicates that the CPU architecture is Kunpeng.

info:gpu:name

String

Specifies the number and names of GPUs.

info:cpu:name

String

Specifies the CPU name.

quota:gpu

String

Specifies the GPU name.