Linode API - Release Notes

Added

Several new operations in support of the Placement Groups service launch (Limited Availability):

• List placement groups (GET /placement/groups) )
• Get a placement group (GET /placement/groups/{id} )
• Create a placement group (POST /placement/groups/ )
• Update a placement group (PUT /placement/groups/ )
• Assign a placement group (POST /placement/groups/{id}/assign )
• Unassign a placement group (POST /placement/groups/{id}/unassign )
• Delete a placement group (DELETE /placement/groups/{id} )

Changed

• Updated operations in support of the Placement Groups service launch (Limited Availability):

  • List Linodes (GET /linode/instances ) - Added placement_group object to show the placement group the Linode belongs to.
  • Get a Linode (GET /linode/instances/{linodeId} ) - Added placement_group object to show the placement group the Linode belongs to.
  • Create a Linode (POST /linode/instances ) - Added placement_group parameter to include a new Linode in an existing placement group.
  • Clone a Linode (POST /linode/instances/{linodeId}/clone ) - Added placement_group parameter to include the cloned Linode in an existing placement group.
  • Initiate a DC Migration/Pending Host Migration (POST /linode/instances/migrate ) - Added placement_group parameter to include the migrated Linode in an existing placement group.
  • Get your account (GET /account ) - Includes Placement Group in the capabilities array for accounts with access to the service.
  • Get a region (GET /regions/{regionId} ) - Included various parameters that describe placement group availability and limitations in a region.

• Updated several Object Storage operations to support the new regions objects:

  • Create an Object Storage bucket (POST /object-storage/buckets )
  • List Object Storage buckets (GET /object-storage/buckets )
  • List Object Storage buckets in a region (GET /object-storage/buckets/{regionId} – Replaces the “List Object Storage buckets in a cluster” operation.)
  • Get an Object Storage bucket (GET /object-storage/buckets/{regionId}/{bucket} )
  • Remove an Object Storage bucket (DELETE /object-storage/buckets/{regionId}/{bucket} )
  • Create a URL for an object (POST /object-storage/buckets/{regionId}/{bucket}/object-url )
  • Modify access to an Object Storage bucket (POST /object-storage/buckets/{regionId}/{bucket}/access )
  • Update access to an Object Storage bucket (PUT /object-storage/buckets/{regionId}/{bucket}/access )
  • Get an Object Storage object ACL config (GET /object-storage/buckets/{regionId}/{bucket}/object-acl )
  • Update an object’s ACL config (PUT /object-storage/buckets/{regionId}/{bucket}/object-acl )
  • List Object Storage bucket contents (GET /object-storage/buckets/{regionId}/{bucket}/object-list )
  • Upload an Object Storage TLS/SSL certificate (POST /object-storage/buckets/{regionId}/{bucket}/ssl )
  • Get an Object Storage TLS/SSL certificate (GET /object-storage/buckets/{regionId}/{bucket}/ssl )
  • Delete an Object Storage TLS/SSL certificate (DELETE /object-storage/buckets/{regionId}/{bucket}/ssl )
  • Create an Object Storage key (POST /object-storage/keys )
  • List Object Storage keys (GET /object-storage/keys )
  • Get an Object Storage key (GET /object-storage/keys/{keyId} )
  • Update an Object Storage key (PUT /object-storage/keys/{keyId} )

• Deprecated the following Object Storage-related operations. They are still available, but other operations should be used instead:

  • List clusters (GET /object-storage/clusters )
  • Get a cluster (GET /object-storage/clusters/{clusterId} )

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.