Linode API - Release Notes

Changed

Updated account availability-related endpoints, to apply new functionality and bring them from beta to GA:

• Account Availability ( GET /account/availability)
• Region Service Availability ( GET /account/availability/{id})

Fixed

• Service Transfer Create ( POST /account/service-transfers). Included VPC in list of services that a Linode can’t use.
• VPC-related fixes:
  • Corrections to nat_1_1 objects for proper support.
  • Proper IP address formatting for VPC IP addresses.
  • IP Addresses List ( GET /linode/instances/{linodeId}/ips). Corrected response example to show VPC’s displayed as objects in an array and added ipv4.vpc attribute to x-linode-cli-subtables.
• Domain Clone ( POST /domains/{domainId}/clone). Updated regex examples to proper format.
• IP Addresses List ( GET /linode/instances/{linodeId}/ips). Replaced requestBody with query string.
• Object Storage Bucket Contents List ( GET /object-storage/buckets/{clusterId}/{bucket}/object-list). Fixed incorrect response sample.
• Parent/Child Account fixes Applied pagination and missing warning message.

Added

Included new endpoints for parent-child account support:

• Child Account List ( GET /account/child-accounts)
• Child Account View ( GET /account/child-accounts/{euuid})
• Proxy User Token Create ( POST /account/child-accounts/{euuid}/token)

Updated

• Modified existing endpoints to include specifics for parent-child account support:

  • Users List ( GET /account/users)
  • User View ( GET /account/users/{username})
  • User Create ( POST /account/users)
  • User Delete ( DELETE /account/users/{username})
  • User Update ( PUT /account/users/{username})
  • Profile Update ( PUT /profile)
  • User’s Grants View ( GET /account/users/{username}/grants – Added the new child_account_access grant.)
  • User’s Grants Update ( PUT /account/users/ {username}/grants)
  • Account Cancel ( POST /account/cancel)
  • Account Update ( PUT /account)
  • Personal Access Token Create ( POST /profile/tokens)

• Pointed out non-availability of these billing-related endpoints for child account use:

  • Account Update ( PUT /account)
  • Credit Card Add/Edit ( POST /account/credit-card)
  • Payment Method Add ( POST /account/payment-methods/)
  • Payment Make ( POST /account/payments/)
  • Promo Credit Add ( POST /account/promo-codes)

• Other minor edits for formatting and compatibility.

Fixed

• Payment Make ( POST /account/payments). Removed references to CVV which is no longer required by vendor.
• Linode Create ( POST /linode/instances). Request body example incorrectly listed "nat_1_1": "add" when it’s supposed to be "nat_1_1": "any".
• NodeBalancer CLI commands. Updated to use proper operators.

Added

Included new endpoints for VPC-related IP addresses:

• VPC IP Addresses List ( GET /vpc/ips)
• VPC IP Addresses View ( GET /vpc/{id}/ips)

Updated

• Networking Information List ( GET /linode/instances/{linodeId}/ips). Added the vpc array that includes all VPC IP addresses for a specified Linode.
• Updated operations that allow you to set a time to live (TTL). Values of 30 and 120 seconds are supported.

Fixed

• Removed message for IPv6 beta support with VPC’s when creating a Linode. (IPv6 is not supported.)
• Disk Update ( PUT /linode/instances/{linodeId}/disks/{diskId}). Only a disk’s label can be updated with this operation.
• Replaced references of none to null for private Images, to address APIv4’s multi-language support.

Changed

• Managed MySQL Database Update ( PUT /databases/mysql/instances/{instanceId})

  Managed PostgreSQL Database Update ( PUT /databases/postgresql/instances/{instanceId})

  When updating Managed Databases with these commands, you can now resize clusters to use Linodes of equal or greater disk space by including the desired plan type in your request.

Fixed

• Fixed a bug that allowed unsupported IPv6 address zone_id notation in requests when creating or updating Cloud Firewall rules.

Added

• Linode Resize ( POST /linode/instances/{linodeId}/resize)

• Added type property with two values:

  • warm: the Linode remains powered on until the migration is complete.
  • cold: the Linode is powered down and migrated. When the migration is complete, the Linode is powered on.

• Linode Migrate ( POST /linode/instances/{linodeId}/migrate)

• Added migration_type property with two values:

  • warm: the Linode remains powered on until the migration is complete.
  • cold: the Linode is powered down and migrated. When the migration is complete, the Linode is powered on.

Added

• Customers can now view, create, update, and delete VPCs, VPC subnets, and Configuration Profile Interfaces with the API.
  • VPCs List (GET /vpcs)
  • VPC Create (POST /vpcs)
  • VPC View (GET /vpcs/{vpcId})
  • VPC Update (PUT /vpcs/{vpcId})
  • VPC Delete (DELETE /vpcs/{vpcId})
  • VPC Subnets List (GET /vpcs/{vpcId}/subnets)
  • VPC Subnet Create (POST /vpcs/{vpcId}/subnets)
  • VPC Subnet View (GET /vpcs/{vpcId}/subnets/{vpcSubnetId})
  • VPC Subnet Update (PUT /vpcs/{vpcId}/subnets/{vpcSubnetId})
  • VPC Subnet Delete (DELETE /vpcs/{vpcId}/subnets/{vpcSubnetId})
  • Configuration Profile Interfaces List (GET /linode/instances/{linodeId}/configs/{configId}/interfaces)
  • Configuration Profile Interface Add (POST /linode/instances/{linodeId}/configs/{configId}/interfaces)
  • Configuration Profile Interface View (GET /linode/instances/{linodeId}/configs/{configId}/interfaces/{interfaceId})
  • Configuration Profile Interface Update (PUT /linode/instances/{linodeId}/configs/{configId}/interfaces/{interfaceId})
  • Configuration Profile Interface Delete (DELETE /linode/instances/{linodeId}/configs/{configId}/interfaces/{interfaceId})
  • Configuration Profile Interfaces Order (POST /linode/instances/{linodeId}/configs/{configId}/interfaces/order)

Changed

• As part of the VPC launch, the following endpoints have been modified:
  • Linode Create (POST /linode/instances)
  • Linode Clone (POST /linode/instances/{linodeId}/clone)
  • Firewall Create (POST /networking/firewalls)
  • IPv4 Address Delete (DELETE /linode/instances/{linodeId}/ips/{address})
  • IP Addresses Assign (POST /networking/ips/assign)
  • IP Addresses Share (POST /networking/ips/share)
  • Support Ticket Request (POST /support/tickets)
  • User’s Grants View (GET /account/users/{username}/grants)
  • User’s Grants Update (PUT /account/users/{username}/grants)
  • All commands with request and response bodies that include Interfaces.

Fixed

• Account Availability ( GET /account/availability)
  • Update CLI actions from Camel case (e.g. getAvailability) to Hyphen-cased (e.g. get-availability )
  • Fix server URL so the CLI will be able to target the endpoints in v4beta path.

Added

• Account Availability ( GET /account/availability)

  • Added endpoints for retrieving service availability by region

Changed

• Database Engine ( GET /databases/engines):

  • Added database size and used space data for Managed Database object response

• Images ( POST /images, POST /images/upload)

  • Adds documentation for the cloud_init field in the POST /images and POST /images/upload request bodies

Fixed

• Regions ( GET /regions/{regionId}/availability)

  • Updates the response documentation for the GET /regions/{regionId}/availability to properly reflect what is returned from the API

Added

Cloud Firewall is now available on NodeBalancer.

• You can list Firewalls assigned to NodeBalancers Firewalls List.
• You can add a firewall to a NodeBalancer NodeBalancer Create.
• Firewall rule information for NodeBalancers; firewalls only apply to inbound TCP traffic to NodeBalancers.

Changed

• You can now assign a Firewall to a Linode compute instance by utilizing the firewall_id when running the Linode Create operation.

• The following rate limit changes have been made:

  • General API request rate limit reduced from 1,600 requests every 2 minutes to 800 requests every 2 minutes.
  • Default operation rate limit reduced from 800 requests per minute to 400 requests per minute.
  • GET collection operation default rate limit reduced from 400 requests per minute to 200 requests per minute.
  • Statistics operations rate limit reduced from 100 requests per minute to 50 requests per minute.