settings
Creates, updates, deletes, gets or lists a settings resource.
Overview
| Name | settings |
| Type | Resource |
| Id | linode.account.settings |
Fields
The following fields are returned by SELECT queries:
- get_account_settings
Returns a single Account settings object.
| Name | Datatype | Description |
|---|---|---|
backups_enabled | boolean | Account-wide backups default. If true, all Linodes created will automatically be enrolled in the Backups service. If false, Linodes will not be enrolled by default, but may still be enrolled on creation or later. |
interfaces_for_new_linodes | string | Beta Defines if new Linodes can use legacy configuration interfaces: - legacy_config_only. All new Linodes need to use legacy configuration interfaces. Prevously created Linodes with Linode Interfaces can still exist. Linodes using legacy configuration interfaces can't be upgraded to use Linode Interfaces. - legacy_config_default_but_linode_allowed. New Linodes can use legacy configuration interfaces or Linode Interfaces, depending on the interface_generation setting specified when creating the Linode. By default, new Linodes use legacy configuration interfaces unless otherwise specified. Linodes that use legacy configuration interfaces can upgrade to Linode Interfaces. This is the default setting for existing accounts. - linode_default_but_legacy_config_allowed. New Linodes can use legacy configuration interfaces or Linode Interfaces, depending on the interface_generation setting specified when creating the Linode. By default, new Linodes use Linode Interfaces unless otherwise specified. Linodes that use legacy configuration interfaces can upgrade to Linode interfaces. This is the default setting for new accounts. - linode_only. All new Linodes need to use Linode Interfaces. Prevously created Linodes with legacy configuration profile interfaces can still exist if they were created under a previous setting. Linodes using legacy configuration interfaces can be upgraded to Linode Interfaces. (example: linode_only) |
longview_subscription | string | Read-only The Longview Pro tier you are currently subscribed to. The value must be a Longview subscription ID or null for Longview Free. (example: longview-3) |
managed | boolean | Read-only Our 24/7 incident response service. This robust, multi-homed monitoring system distributes monitoring checks to ensure that your servers remain online and available at all times. Linode Managed can monitor any service or software stack reachable over TCP or HTTP. Once you add a service to Linode Managed, we'll monitor it for connectivity, response, and total request time. |
network_helper | boolean | Enables network helper across all users by default for new Linodes and Linode Configs. |
object_storage | string | Read-only A string describing the status of this account's Object Storage service enrollment. (default: disabled, example: active) |
Methods
The following methods are available for this resource:
| Name | Accessible by | Required Params | Optional Params | Description |
|---|---|---|---|---|
get_account_settings | select | Returns information related to your Account settings: Managed service subscription, interface settings for new Linodes, Longview subscription, and Network Helper. Learn more... Learn more... | ||
put_account_settings | replace | Updates your account settings. For a Longview subscription plan, see Update a Longview plan. Learn more... Learn more... | ||
post_enable_account_managed | exec | Enables Linode Managed for the entire account and sends a welcome email to the account's associated email address. Linode Managed can monitor any service or software stack reachable over TCP or HTTP. See our Linode Managed guide to learn more. Learn more... Learn more... |
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.
| Name | Datatype | Description |
|---|
SELECT examples
- get_account_settings
Returns information related to your Account settings: Managed service subscription, interface settings for new Linodes, Longview subscription, and Network Helper.
Learn more...
Learn more...
SELECT
backups_enabled,
interfaces_for_new_linodes,
longview_subscription,
managed,
network_helper,
object_storage
FROM linode.account.settings;
REPLACE examples
- put_account_settings
Updates your account settings. For a Longview subscription plan, see Update a Longview plan.
Learn more...
Learn more...
REPLACE linode.account.settings
SET
data__backups_enabled = {{ backups_enabled }},
data__interfaces_for_new_linodes = '{{ interfaces_for_new_linodes }}',
data__network_helper = {{ network_helper }}
WHERE
RETURNING
backups_enabled,
interfaces_for_new_linodes,
longview_subscription,
managed,
network_helper,
object_storage;
Lifecycle Methods
- post_enable_account_managed
Enables Linode Managed for the entire account and sends a welcome email to the account's associated email address. Linode Managed can monitor any service or software stack reachable over TCP or HTTP. See our Linode Managed guide to learn more.
Learn more...
Learn more...
EXEC linode.account.settings.post_enable_account_managed
;