4.81.0: [Update] Managed Service Create/Update address examples (#364)

* Add URL examples to POST /managed/services

* Add spacing

v4.80.0

Changed

• CNAME records now allow for a trailing period (.) on target entries. Previously, a CNAME record ending in a period (.) would result in an error. The endpoints affected by this change are:

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

v4.79.0

Added

• Added the Object Storage Object ACL View (GET /object-storage/buckets/{clusterId}/{bucket}/object-acl) endpoint. This endpoint returns an Object Storage bucket's currently configured Access Control List (ACL). ACLs define who can access your buckets and objects and specify the level of access granted to those users.

• Added the Object Storage Bucket Access Update (PUT /object-storage/buckets/{clusterId}/{bucket}/access) endpoint. Use this endpoint to update a bucket's basic Cross-origin Resource Sharing (CORS) and Access Control Level (ACL) settings.

• Added the Object Storage Transfer View (GET /object-storage/transfer) endpoint. This endpoint returns the amount of outbound data transfer used by your account's Object Storage buckets. Object Storage adds 1 terabyte of outbound data transfer to your data transfer pool. See the Object Storage Pricing and Limitations guide for details on Object Storage transfer quotas.

• Added the objects field to the following Object Storage endpoints:

  • Object Storage Buckets List (GET /object-storage/buckets)
  • Object Storage Buckets in Cluster List (GET /object-storage/buckets/{clusterId})
  • Object Storage Bucket View (GET /object-storage/buckets/{clusterId}/{bucket})

  The object field returns the number of objects stored in a bucket.

Fixed

• Error messages for Firewalls endpoints have been improved. When applicable, they now return a Firewall Device's label and id.

v4.78.3

Changed

• Linode's API v4 documentation has been moved to reside in the new Linode Docs site.

  • Our OpenAPI specification can now be downloaded at https://www.linode.com/docs/api/openapi.yaml.
  • Any links within the spec file have been updated to reflect this new location.

• All links within API changelog entries have been updated to reflect the new location of the API v4 spec file.

v4.78.0

• The cvv field in the Credit Card Add/Edit (POST
  https://api.linode.com/v4/account/credit-card) endpoint is now required.

v4.77.0

Added

• Added the message field to the Event schema object. The message field provides additional information about the event. Additional information may include, but is not limited to, a more detailed representation of events which can help diagnose non-obvious failures. This new field is available on the following Account Event endpoints:

  • Event List (GET /account/events)
  • Event View (GET /account/events/{eventId})

• Added the deprecated field to the Kernel schema object. If this Kernel is marked as deprecated, this field has a value of true; otherwise, this field is false. This new field is available on the Linode Instances Kernel endpoints:

  • Kernels List (GET /linode/kernels)
  • Kernel View (GET /linode/kernels/{kernelId})

Changed

• Updated the endpoint names to follow the convention noun followed by verb. For example, View Account is now named Account View.

• Updated the description for the Object Storage Key Create (POST /object-storage/keys) endpoint with information on the available Access Key and Limited Access Key creation options.

• Updated the bucket_access field description in the ObjectStorageKey schema object with a note about the results of omitting this field when creating a limited access Object Storage Key.

Fixed

• The User's Grants View (GET /account/users/{username}/grants) endpoint was updated to have a less restrictive authorization of account:read_only instead of account:read_write. This fixes the discrepancy between specification and endpoint behavior.

v4.76.1

• Object Storage bring your own TLS/SSL Cert endpoints.
• Spec version bump to 4.76.1

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.