Skip to main content

instance_sizes

Creates, updates, deletes, gets or lists an instance_sizes resource.

Overview

Nameinstance_sizes
TypeResource
Iddigitalocean.apps.instance_sizes

Fields

The following fields are returned by SELECT queries:

A JSON with key instance_size

NameDatatypeDescription
namestring (title: A human-readable name of the instance size, example: name)
bandwidth_allowance_gibstring (int64) (title: The bandwidth allowance in GiB for the instance size, example: 1)
cpu_typestring (default: UNSPECIFIED, title: - SHARED: Shared vCPU cores
- DEDICATED: Dedicated vCPU cores, example: SHARED)
cpusstring (int64) (title: The number of allotted vCPU cores, example: 3)
deprecation_intentboolean (title: Indicates if the instance size is intended for deprecation)
memory_bytesstring (int64) (title: The allotted memory in bytes, example: 1048)
scalableboolean (title: Indicates if the instance size can enable autoscaling)
single_instance_onlyboolean (title: Indicates if the instance size allows more than one instance)
slugstring (title: The slug of the instance size, example: apps-s-1vcpu-1gb)
tier_downgrade_tostring (title: The slug of the corresponding downgradable instance size on the lower tier, example: basic)
tier_slugstring (title: The slug of the tier to which this instance size belongs, example: basic)
tier_upgrade_tostring (title: The slug of the corresponding upgradable instance size on the higher tier, example: basic)
usd_per_monthstring (title: The cost of this instance size in USD per month, example: 23)
usd_per_secondstring (title: The cost of this instance size in USD per second, example: 0.00000001232)

Methods

The following methods are available for this resource:

NameAccessible byRequired ParamsOptional ParamsDescription
apps_get_instance_sizeselectslugRetrieve information about a specific instance size for service, worker, and job components.
apps_list_instance_sizesselectList all instance sizes for service, worker, and job components.

Parameters

Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.

NameDatatypeDescription
slugstringThe slug of the instance size (example: apps-s-1vcpu-0.5gb)

SELECT examples

Retrieve information about a specific instance size for service, worker, and job components.

SELECT
name,
bandwidth_allowance_gib,
cpu_type,
cpus,
deprecation_intent,
memory_bytes,
scalable,
single_instance_only,
slug,
tier_downgrade_to,
tier_slug,
tier_upgrade_to,
usd_per_month,
usd_per_second
FROM digitalocean.apps.instance_sizes
WHERE slug = '{{ slug }}' -- required;