v4.76.0

Added

• When you have active Domains on your Account, but no active Linodes, your domains are not served. The List Notifications (GET /account/notifications) endpoint now returns a notification to alert you when your Account falls under this case.

• The NodeBalancers endpoints error messages were improved to include information about a field's valid values.

Fixed

• The APIv4 now returns a warning when you execute a staged/approved PayPal payment (POST /account/payments/paypal/execute) and your payment is successfully processed, but an error occurs related to releasing a service suspension. Prior to this fix, a 500 error occurred instead.

• Now, when you have an outstanding balance on your account, adding more nodes to a Kubernetes Cluster fails. An error message with Cannot add or create LKE objects with an outstanding balance on your account is returned when this occurs. This affects the following endpoints:

  • Create Kubernetes Cluster (POST /lke/clusters)
  • Create Node Pool (POST /lke/clusters/{clusterId}/pools)
  • Update Node Pool (PUT /lke/clusters/{clusterId}/pools/{poolId})
  • Recycle Node Pool endpoints. (POST /lke/clusters/{clusterId}/pools/{poolId}/recycle)

• When you attempt to create a Kubernetes cluster (POST /lke/clusters) or create a node pool (POST /lke/clusters/{clusterId}/pools) with unsupported node types, you receive an error message. Currently, LKE does not support 1 GB Linode instances, or GPU Linode instances.

• You can now create an Object Storage Limited Access Key without access to any buckets. This is achieved by creating an Object Storage Key with an empty bucket_access array. This type of Limited Access Key can:

  • list all buckets available on your Account, but cannot perform any actions on a bucket.

  • create new buckets, but does not have any access to the buckets it creates.

v4.73.0

Added

• Added the BETA List Maintenance (GET /account/maintenance) endpoint. This new beta endpoint allows you to view a collection of maintenance objects for any entity you have permissions to view. Currently, Linodes are the only entities available for viewing.

Fixed

• A bug was fixed that would result in a 500 error when filtering domain records by a non-existent tag. This will now return a 200 response with an empty pagination result.
• Previously, NS and CNAME records could be created for each other, resulting in errors when the zone file is rendered. If this is attempted now, the record creation will fail with a "Record conflict" message.
• Changes were made to the (GET /linode/instances) endpoint to improve response time.

v4.72.0

Added

• The IPv4 and IPv6 addresses of the DNS resolvers for a region are now accessible at the View Region (GET /regions/{regionId}) endpoint.

Changed

• Changing your Longview subscription is no longer available at the Update Account Settings (PUT /account/settings) endpoint. Accordingly, the longview_subscription property has been removed from the Update Account Settings request body. To update your Longview plan, please use the Update Longview Plan (PUT /longview/plan) endpoint.

• Updated the description and response for the View Longview Plan (GET /longview/plan) endpoint:

  • The previous description stated that this endpoint returns a longview_subscription ID. This has been corrected to state that the response consists of a LongviewSubscription object for your current Longview Pro plan, or an empty set {} if your current plan is Longview Free.
  • The response body and sample have been updated to include the details of the returned LongviewSubscription object for your current Longview plan.

• Accessing the View Longview Plan (GET /longview/plan) endpoint now requires one of the following global User Grants:

  • "account_access": read_write
  • "account_access": read_only
  • "longview_subscription": true
  • "add_longview": true

• Updated the description, request, and response for the Update Longview Plan (PUT /longview/plan) endpoint:

  • The previous description stated that this endpoint returns a longview_subscription ID. The description has been corrected to state that the response consists of a LongviewSubscription object for the updated Longview Pro plan, or an empty set {} if the updated plan is Longview Free.
  • Accessing this endpoint now requires "longview_subscription": true as a global User Grant.
  • The required OAuth scope has been changed from account:read_write to longview:read_write.
  • The request body schema has been updated to specify possible values for the longview_subscription field and to reflect that it is nullable, with a null value corresponding to Longview Free.
  • The response body and sample have been updated to include the details of the returned LongviewSubscription object.

• Updated the response for the List Longview Subscriptions (GET /longview/subscription) and View Longview Subscription (GET /longview/subscriptions/{subscriptionID}) endpoint:

  • The response id property has been revised to specify possible values.

• Updated the Object Storage Bucket response schema to include the size property in the List Object Storage Buckets (GET /object-storage/buckets), Create Object Storage Bucket (POST /object-storage/buckets), View Object Storage Bucket (GET /object-storage/buckets/{clusterId}/{bucket}), and List Object Storage Buckets in Cluster (GET /object-storage/buckets/{clusterId}) endpoints.

Fixed

• A bug that prevented the Update Longview Plan (PUT /longview/plan) endpoint from functioning has been fixed. The endpoint will now update your account's Longview plan as expected.

v4.70.0

Added

• Added the Recycle Node Pool (POST /lke/clusters/{clusterId}/pools/{poolId}/recycle) endpoint. This new endpoint allows you to recycle the Node Pool of your specified Kubernetes Cluster by clusterId and poolId.

Changed

• Password validation is now solely reliant upon complexity (strength) score and no longer requires a set number of characters in special classes. Relevant endpoints:

  • Create Linode (POST /linode/instances)
  • Rebuild Linode (POST /linode/instances/{linodeId}/rebuild)
  • Create Managed Credential (POST /managed/credentials)
  • Update Managed Credential Username and Password (POST /managed/credentials/{credentialId}/update)
  • Create Disk (POST /linode/instances/{linodeId}/disks)
  • Reset Disk Root Password (POST /linode/instances/{linodeId}/disks/{diskId}/password)

• Updated the description for the Update Node Pool (PUT /lke/clusters/{clusterId}/pools/{poolId}) endpoint. Now the description more accurately explains that nodes are created or deleted to match the updated count and that any local storage on deleted Linodes (such as "hostPath" and "emptyDir" volumes, or "local" PersistentVolumes) will be erased.

Fixed

• Fixed a bug with domain validation where some multi-level domains were being flagged as invalid.

• Fixed a bug in CNAME record validation. It now checks all incoming CNAME records against all existing records (CNAME and otherwise) in this domain to make sure there are no conflicts. Relevant endpoints:

  • Create Domain Record (POST /domains/{domainId}/records)
  • Update Domain Record (PUT /domains/{domainId}/records/{recordId})

• Updated the OAuth Workflow section to include grant_type as a required parameter when using a refresh token.

• Switched the order of the name for the Initiate Pending Host Migration/DC Migration endpoint to Initiate DC Migration/Pending Host Migration to clear up any confusion about which part the word Pending applies. Pending refers only to the host migration and not to the data center migration. The POST /linode/instances/{linodeId}/migrate endpoint itself remains unchanged.

v4.69.0

Added

• A disks field was added to the Linode Kubernetes Engine (LKE) collection. This field allows you to define a custom disk layout for the nodes in a cluster's Node Pool. A custom disk layout is only required for specific use cases. If this field is omitted, the nodes in a Node Pool will have a default disk layout consisting of a single partition. The disks field is available from the following endpoints:

  • Create Kubernetes Cluster (POST /lke/clusters).
  • Create Node Pool (POST /lke/clusters/{clusterId}/pools)
  • View Node Pool (GET /lke/clusters/{clusterId}/pools/{poolId})

• When Listing Account Events (GET /v4/account/events), you can now filter by its action field. See Filtering and Sorting to learn how to search API v4 collections.

Changed

• Added improved error handling for the ssl_cert and ssl_key fields in the NodeBalancer collection. Error messages will now explain if a provided key is in an incorrect format. These fields are available from the following endpoints:

  • Create Config (POST /nodebalancers/{nodeBalancerId}/configs)

  • Update Config (PUT /nodebalancers/{nodeBalancerId}/configs/{configId})

• The tag field for the Domain Record collection is now filterable. See Filtering and Sorting to learn how to search API v4 collections.

Fixed

• A bug was fixed that allowed multiple Account Users to be created with the same username. This bug affected the Create User (POST /account/users) and Update User (PUT /account/users/{username}) endpoints.

• Combined the LKEClusterRequestBody into the LKECluster schema object and removed the LKEClusterRequestBody object within the APIv4 OpenAPI 3 reference. This change fixed some display issues on the Linode API Documentation website for the Linode Kubernetes Engine Endpoint collection.

• When creating an LKE Cluster (POST /lke/clusters) or updating an LKE Cluster (PUT /lke/clusters/{clusterId}), the label field supports valid Unicode outside of the ASCII table. Previously, the APIv4 reference listed the incorrect character limitations for this field.

v0.16.7 (2017-12-18)

Fixed

• Link to API mailing list 404'd