Prev Next

5.3. Showing flavor details¶

GET /flavors/{flavor_id}

Show details of a flavor with the specified ID.

Source: https://docs.openstack.org/api-ref/compute/?expanded=#show-flavor-details

5.3.1. Request¶

Name	In	Type	Description
`flavor_id`	path	string	The ID of the flavor.

5.3.1.1. Example¶

# curl -ks -H 'Content-Type: application/json' -H 'X-Auth-Token: gAAAAA<...>' \
https://<node_IP_addr>:8774/v2.1/f5d834d636c642c7bfe8af86139c6f26/flavors/100

5.3.2. Response¶

Name	In	Type	Description
`flavor`	body	object	The ID and links for the flavor for your server instance. A flavor is a combination of memory, disk size, and CPUs.
`name`	body	string	The display name of a flavor.
`description`	body	string	The description of the flavor. New in version 2.55
`id`	body	string	The ID of the flavor. While people often make this look like an int, this is really a string.
`ram`	body	integer	The amount of RAM a flavor has, in MiB.
`disk`	body	integer	The size of the root disk that will be created in GiB. If 0 the root disk will be set to exactly the size of the image used to deploy the instance. However, in this case filter scheduler cannot select the compute host based on the virtual image size. Therefore, 0 should only be used for volume-booted instances or for testing purposes. Volume-backed instances can be enforced for flavors with zero root disk via the `os_compute_api:servers:create:zero_disk_flavor` policy rule. Note This platform supports only volume-booted instances, so this parameter value should be 0.
`vcpus`	body	integer	The number of virtual CPUs that will be allocated to the server.
`links`	body	array	Links to the resources in question. See API Guide / Links and References for more info.
`OS-FLV-EXT-DATA:ephemeral`	body	integer	The size of the ephemeral disk that will be created, in GiB. Ephemeral disks may be written over on server state changes. So should only be used as a scratch space for applications that are aware of its limitations. Defaults to 0.
`OS-FLV-DISABLED:disabled` (Optional)	body	boolean	Whether or not the flavor has been administratively disabled. This is typically only visible to administrative users.
`swap`	body	integer	The size of a dedicated swap disk that will be allocated, in MiB. If 0 (the default), no dedicated swap disk will be created. Currently, the empty string (‘’) is used to represent 0. As of microversion 2.75 default return value of swap is 0 instead of empty string.
`rxtx_factor`	body	float	The receive / transmit factor (as a float) that will be set on ports if the network backend supports the QOS extension. Otherwise it will be ignored. It defaults to 1.0.
`os-flavor-access:is_public`	body	boolean	Whether the flavor is public (available to all projects) or scoped to a set of projects. Default is True if not specified.
`extra_specs` (Optional)	body	object	A dictionary of the flavor’s extra-specs key-and-value pairs. This will only be included if the user is allowed by policy to index flavor extra_specs. New in version 2.61

5.3.2.1. Status codes¶

5.3.2.1.1. Success¶

Code	Reason
`200 - OK`	Request was successful.

5.3.2.1.2. Error¶

Code	Reason
`401 - Unauthorized`	User must authenticate before making a request.
`403 - Forbidden`	Policy does not allow current user to do this operation.
`404 - Not Found`	The requested resource could not be found.

5.3.2.2. Example¶

{
  "flavor": {
    "links": [
      {
        "href": "https://<node_IP_addr>:8774/v2.1/f5d834d636c642c7bfe8af86139c6f26/flavors/100",
        "rel": "self"
      },
      {
        "href": "https://<node_IP_addr>:8774/f5d834d636c642c7bfe8af86139c6f26/flavors/100",
        "rel": "bookmark"
      }
    ],
    "ram": 512,
    "OS-FLV-DISABLED:disabled": false,
    "os-flavor-access:is_public": true,
    "rxtx_factor": 1,
    "disk": 0,
    "id": "100",
    "name": "tiny",
    "vcpus": 1,
    "swap": "",
    "OS-FLV-EXT-DATA:ephemeral": 0
  }
}

Version 4.7.0 — Oct 18, 2021

Prev Next