Releases: linode/linode-api-docs
v4.93.0
Added
-
StackScripts now have the
mine
boolean read-only property, which indicates whether the StackScript is owned by the account of the user making the request. This property can be used to easily filter responses so that only your account's StackScripts are returned when using the StackScripts List (GET /stackscripts) endpoint. -
The Domain Zone File View (GET /domains/{domainId}/zone-file) has been added. Access this endpoint to view an array containing the lines of the zone file for the last rendered zone of the specified domain.
-
Restricted users can now access Images they created using the Image Upload (POST /images/upload) beta endpoint.
Changed
-
The responses for the Linodes List (GET /linode/instances) and NodeBalancers List (GET /nodebalancers) endpoints are now filterable by their respective
ipv4
properties. -
The response for the Images List (GET /images) endpoint is now filterable by the
type
property.
Fixed
-
The
read_only
property of the Disk Create (POST /linode/instances/{linodeId}/disks) endpoint's request body schema was nonfunctional and has been removed from the specification. -
A bug was fixed that caused the Firewall Update (PUT /networking/firewalls/{firewallId}) endpoint to incorrectly return a "too many active Firewalls" error. The error incorrectly appeared when a Firewall's
status
was set fromdisabled
toenabled
after attached Linodes were deleted.
v4.92.0
Changed
- The Linode Firewalls feature has completed beta testing! All beta notices have been removed for endpoints involving Firewalls, and Vthe following endpoints are now accessible from the
/v4
path:- Firewalls List (GET/networking/firewalls)
- Firewall Create (POST /networking/firewalls)
- Firewall Delete (DELETE /networking/firewalls/{firewallId})
- Firewall View (GET /networking/firewalls/{firewallId})
- Firewall Update (PUT /networking/firewalls/{firewallId})
- Firewall Devices List (GET /networking/firewalls/{firewallId}/devices)
- Firewall Device Create (POST /networking/firewalls/{firewallId}/devices)
- Firewall Device Delete (DELETE /networking/firewalls/{firewallId}/devices/{deviceId})
- Firewall Device View (GET /networking/firewalls/{firewallId}/devices/{deviceId})
- Firewall Rules List (GET /networking/firewalls/{firewallId}/rules)
- Firewall Rules Update (PUT /networking/firewalls/{firewallId}/rules)
v4.91.0
Changed
-
The Linode VLANs feature has completed beta testing! All beta notices have been removed for endpoints involving VLANs, and VLANS List (GET /networking/vlans) requests are now accessible at
/v4
instead of/v4beta
. -
The descriptions for the following Images endpoints were updated to improve accuracy and clarity:
- Images List (GET /images)
- Image Create (POST /images)
- Image Upload (POST /images/upload)
Fixed
- A bug was fixed that caused 500 errors to return when empty request bodies or strings were submitted to the Firewall Rules Update (PUT /networking/firewalls/{firewallId}/rules) beta endpoint. An error is now returned instead.
v4.90.3
Added
- The Machine Image Upload (POST /images/upload) beta endpoint has been added. This endpoint can be used to initiate a Machine Image upload by creating a new private Image object and returning it, along with the URL the image data can be uploaded to.
v4.90.1
v4.90.0
Added
- Support Tickets for VLANs can now be opened. Accordingly, the following properties were added to the Support Ticket Open (POST /support/tickets) endpoint:
vlan
: The label of the VLAN this ticket is regarding, if relevant. Requires a specifiedregion
to identify the VLAN.region
: The Region ID for the associated VLAN this ticket is regarding. This property is only allowed when opening a VLAN ticket.
Fixed
- Previously, submitting
ssl_cert
orssl_key
values with improper formatting resulted in a 500 error when using the NodeBalancers Config Update (/nodebalancers/{nodeBalancerId}/configs/{configId}) endpoint. Now, an error message is returned if improperly formattedssl_cert
orssl_key
values are submitted with a request to this endpoint.
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