Releases: linode/linode-api-docs
v4.89.1
Changed
- The VLANs List (GET /networking/vlans) beta endpoint description has been updated with the following:
- Clearer instructions on how to detach a Linode from a VLAN.
- A note that VLANs cannot be renamed.
- A note that VLANs cannot be manually deleted. VLANs that are not attached to any Linodes are automatically deleted within a short timeframe.
Fixed
-
A bug was fixed that prevented
public
purpose VLAN interfaces that weren't configured for eth0 from working. This bug has been fixed, and the request body descriptions for thepurpose
property have been updated accordingly for the following endpoints:- Linode Create (POST /linode/instances)
- Configuration Profile Create (POST /linode/instances/{linodeId}/configs)
- Configuration Profile Update (PUT /linode/instances/{linodeId}/configs/{configId})
-
Previously, the Configuration Profile Update (PUT /linode/instances/{linodeId}/configs/{configId}) endpoint erroneously stated the
label
anddevices
properties as required and theinterfaces.purpose
property as optional. Thelabel
anddevices
properties are now stated as optional, while theinterfaces.purpose
property is now stated as required.
v4.89.0
Added
- The VLANs List (GET /networking/vlans) beta endpoint has been added. VLANs provide a mechanism for secure communication between two or more Linodes that are assigned to the same VLAN and are both within the same Layer 2 broadcast domain. VLANs can be created and attached to Linodes by using the new
interfaces
property at the following endpoints:- Linode Create (POST /linode/instances)
- Configuration Profile Create (POST /linode/instances/{linodeId}/configs)
- Configuration Profile Update (PUT /linode/instances/{linodeId}/configs/{configId})
Changed
- The Account Update (PUT /account) endpoint
zip
property has been updated with new restrictions. Previously, thezip
only had a 16 character limit. Now,zip
may only consist of letters, numbers, spaces, and hyphens, and must not contain more than 9 letter or number characters. These conditions must also be satisfied when accessing the Credit Card Add/Edit (POST /account/credit-card) endpoint.
Fixed
-
Previously, users without read-write access to Longview Clients could still access their
api_key
andinstall_code
when accessing the Longview Clients List (GET /longview/clients) and Longview Client View (GET /longview/clients/{clientId}) endpoints. Now,[REDACTED]
is returned for these properties for users without read-write access to the associated Longview Clients. -
Previously, the
label
property for the Linode Create (POST /linode/instances) request body schema lacked a type specification and restriction. The endpoint's request body schema has been refactored to include thestring
type specification and the restriction that Linode labels must end with an alphanumeric character.
v4.87.0
Changed
- The Account View (GET /account) endpoint response schema has been updated to include the
active_promotions.service_type
property which specifies the services to which a promotion applies.
Fixed
-
The Service Transfer Create (POST /account/service-transfers) endpoint description incorrectly stated that Backups for transferred Linodes were not included in a transfer, and associated data would be removed/cancelled. This has been corrected to state that Backups are transferred with Linodes as well.
-
Previously, the IPv6 SLAAC address for Linodes were incorrectly returned with /64 prefixes for endpoints such as Linode View (GET /linode/instances/{linodeId}). This has been fixed so that Linode IPv6 SLAAC addresses are accurately returned with /128 prefixes.
v4.86.1
Fixed
- The Config Rebuild (POST /nodebalancers/{nodeBalancerId}/configs/{configId}/rebuild) endpoint has been updated as follows:
- An error was fixed that prevented the
linode-cli nodebalancers config-rebuild
command from working. - Previously, the request body schema incorrectly stated only a
configs
array is passed to this endpoint. This has been corrected to fully state the request body schema object and properties. - The CLI request sample has been updated to include examples of
nodes
arguments for thelinode-cli nodebalancers config-rebuild
command.
- An error was fixed that prevented the
v4.86.0
Added
- The following endpoints for the new Service Transfer feature, which enables transfers of Linodes between customer accounts, have been added:
- Service Transfers List (GET /account/service-transfers). Returns a collection of all created and accepted Service Transfers.
- Service Transfer Create (POST /account/service-transfers). Creates a transfer request for the specified services. At this time, only Linodes can be transferred.
- Service Transfer Cancel (DELETE /account/service-transfers/{token}). Cancels the Service Transfer for the provided token.
- Service Transfer View (GET /account/service-transfers/{token}). Returns the details of the Service Transfer for the provided token.
- Service Transfer Accept (POST /account/service-transfers/{token}/accept). Accept an Service Transfer for the provided token to receive the services included in the transfer to your account.
Changed
-
The following endpoints have been deprecated:
- Entity Transfers List (GET /account/entity-transfers).
- Entity Transfer Create (POST /account/entity-transfers).
- Entity Transfer Cancel (DELETE /account/entity-transfers/{token}).
- Entity Transfer View (GET /account/entity-transfers/{token}).
- Entity Transfer Accept (POST /account/entity-transfers/{token}/accept).
-
The Firewall Create (POST /networking/firewalls) beta endpoint has been updated with the following:
- The required
rules.inbound_policy
andrules.outbound_policy
properties were added to allow controlling default behavior for inbound and outbound traffic, respectively. - The
rules.inbound.action
andrules.outbound.action
properties were added to control traffic for individual rules. These properties are required for inbound and outbound rules and override therules.inbound_policy
andrules.outbound_policy
properties, respectively. - Previously,
rules.inbound
was required. It is now optional. - The
rules.inbound.label
,rules.inbound.description
,rules.outbound.label
, andrules.outbound.description
properties were added for organization and display purposes. - Previously, up to five active Firewalls could be assigned to a single Linode service. Now, only one active Firewall can be assigned to a single Linode service.
- The required
Fixed
-
A bug has been fixed that prevented correct filtering for the Service Transfers List (GET /account/service-transfers) endpoint
is_sender
property. -
The Volume Attach (POST /volumes/{volumeId}/attach) endpoint erroneously marked the
linode_id
property as nullable and required. This has been corrected to state that the property is optional and only accepts an integer .
v4.85.0
Fixed
-
The Maintenance List (GET /account/maintenance) beta endpoint previously returned information for inactive Linodes. This has been fixed to exclude information for inactive Linodes.
-
The Domain Update (PUT /domains/{domainId}) endpoint request body schema erroneously stated that the
domain
andtype
properties were required. The spec has been updated to mark these properties as optional. -
The Domain Create (POST /domains) endpoint and Domain Update (PUT /domains/{domainId}) endpoint SHELL request samples incorrectly stated a
display_group
property and excluded thetags
property. The samples have been updated to state thegroup
andtags
properties. -
The following Domain schema properties have been updated to include the following missing value traits:
domain
: minimum 1 and maximum 255 charactersstatus
: a default value of activerefresh_sec
: a valid, default value of 0, which is equivalent to 14400retry_sec
: a valid, default value of 0, which is equivalent to 14400expire_sec
: a valid, default value of 0, which is equivalent to 1209600
-
The Account View (GET /account) endpoint response body
balance_uninvoiced
description inaccurately stated that "Bandwidth charges are not included in the estimate." This has been corrected to state that "Transfer charges are not included in the estimate."
v4.84.1
Changed
- The Entity Transfer Create (POST /account/entity-transfers) endpoint description has been updated to include warnings regarding Linode Backups and associated DNS records.
Fixed
-
The Linode CLI command examples and schema were faulty and have been fixed for the following endpoints:
- Entity Transfers List (GET /account/entity-transfers).
- Entity Transfer Create (POST /account/entity-transfers).
- Entity Transfer Cancel (DELETE /account/entity-transfers/{token}).
- Entity Transfer View (GET /account/entity-transfers/{token}).
- Entity Transfer Accept (POST /account/entity-transfers/{token}/accept).
v4.84.0
Added
-
The following endpoints for the new Entity Transfer feature, which enables transfers of Linodes between customer accounts, have been added:
- Entity Transfers List (GET /account/entity-transfers). Returns a collection of all created and accepted Entity Transfers.
- Entity Transfer Create (POST /account/entity-transfers). Creates a transfer request for the specified entities. At this time, only Linodes can be transferred.
- Entity Transfer Cancel (DELETE /account/entity-transfers/{token}). Cancels the Entity Transfer for the provided token.
- Entity Transfer View (GET /account/entity-transfers/{token}). Returns the details of the Entity Transfer for the provided token.
- Entity Transfer Accept (POST /account/entity-transfers/{token}/accept). Accept an Entity Transfer for the provided token to receive the entities included in the transfer to your account.
-
The Linode Firewalls List (GET /linode/instances/{linodeId}/firewalls) endpoint has been added. This endpoint provides Firewall information for Firewalls associated with a particular Linode.
Changed
-
The request body schema for the Domain Record Create (POST /domains/{domainId}/records) endpoint has been updated to include details regarding the different functions of the
name
andtarget
properties for all record types. Previously, only minor details for theA
andAAAA
record types were provided. -
The request body schema for the Firewalls Create (POST /networking/firewalls) beta endpoint has been updated to specify that the
label
property is now required and must be unique.
Fixed
- The shell request sample for the Volume Attach (POST /volumes/{volumeId}/attach) endpoint erroneously stated a PUT request. It has been corrected to state a POST request.
v4.83.2
Changed
-
The limit of Firewalls per Linode service has been increased from 3 to 5. Descriptions for Firewall (/networking) beta endpoints were updated to reflect this increase.
-
The description for the User Create (POST /account/users) endpoint has been updated to include details for the email confirmation that is sent to newly-created Users.
-
The description for the Kubernetes Cluster Recycle (POST /lke/clusters/{clusterId}/recycle) endpoint has been updated to include more descriptive language regarding recycling all Nodes within an LKE Cluster.
Fixed
- Descriptions for Object Storage (/object-storage) endpoints contained broken links to S3 API documentation. These links have been fixed.