Skip to content

Latest commit

 

History

History
106 lines (90 loc) · 4.3 KB

instance_type_list.md

File metadata and controls

106 lines (90 loc) · 4.3 KB
Raw

instance_type_list

List and filter on Linode Instance Types.

Minimum Required Fields

Field Type Required Description
api_token str Required The Linode account personal access token. It is necessary to run the module.
It can be exposed by the environment variable LINODE_API_TOKEN instead.
See details in Usage.

Examples

- name: List all of the Linode instance types
  linode.cloud.instance_type_list: {}
- name: Resolve all Linode instance types
  linode.cloud.instance_type_list:
    filters:
      - name: class
        values: nanode

Parameters

Field Type Required Description
order str Optional The order to list instance types in. (Choices: desc, asc; Default: asc)
order_by str Optional The attribute to order instance types by.
filters (sub-options) list Optional A list of filters to apply to the resulting instance types.
count int Optional The number of results to return. If undefined, all results will be returned.

filters

Field Type Required Description
name str Required The name of the field to filter on. Valid filterable attributes can be found here: linode.com/docs/api/linode-types/#types-list__responses
values list Required A list of values to allow for this field. Fields will pass this filter if at least one of these values matches.

Return Values

  • instance_types - The returned instance types.

    • Sample Response: 
      [
   {
      "addons": {
        "backups": {
          "price": {
            "hourly": 0.008,
            "monthly": 5
          },
          "region_prices": [
            {
              "id": "ap-west",
              "hourly": 0.02,
              "monthly": 20
            },
            {
          	  "id": "ap-northeast",
              "hourly": 0.02,
              "monthly": 20
            }
          ]
        }
      },
      "region_prices": [
        {
          "id": "ap-west",
          "hourly": 0.02,
          "monthly": 20
        },
        {
          "id": "ap-northeast",
          "hourly": 0.02,
          "monthly": 20
        }
      ],
      "class": "standard",
      "disk": 81920,
      "gpus": 0,
      "id": "g6-standard-2",
      "label": "Linode 4GB",
      "memory": 4096,
      "network_out": 1000,
      "price": {
        "hourly": 0.03,
        "monthly": 20
      },
      "successor": null,
      "transfer": 4000,
      "vcpus": 2
    }
]
    • See the Linode API response documentation for a list of returned fields