Merge pull request #569 from bbiggerr/obj-cancel-remove-update

[Update] Object Storage Cancel; Object Storage Bucket Remove

Author: bbiggerr

openapi.yaml

@@ -504,8 +504,7 @@ paths:
                   survey_link:
                     type: string
                     description: A link to Linode's exit survey.
-                example: {'survey_link':
-                'https://alinktothesurvey.com'}
+                example: {'survey_link': https://alinktothesurvey.com'}
         '409':
           description: Could not charge the credit card on file
           content:
@@ -12561,14 +12560,15 @@ paths:
       servers:
       - url: https://api.linode.com/v4
       summary: Object Storage Bucket Remove
-      description: >
-        Removes a single bucket. While buckets containing objects _may_ be
-        deleted by including the `force` option in the request, such operations
-        will fail if the bucket contains too many objects. The recommended
+      description: |
+        Removes a single bucket.
+
+        Bucket objects must be removed prior to removing the bucket. While buckets containing objects _may_ be
+        deleted using the [s3cmd command-line tool](/docs/products/storage/object-storage/guides/s3cmd/#delete-a-bucket), such operations
+        can fail if the bucket contains too many objects. The recommended
         way to empty large buckets is to use the [S3 API to configure lifecycle policies](https://docs.ceph.com/en/latest/radosgw/bucketpolicy/#) that
         remove all objects, then delete the bucket.
 
-
         This endpoint is available for convenience. It is recommended that instead you
         use the more [fully-featured S3 API](https://docs.ceph.com/en/latest/radosgw/s3/bucketops/#delete-bucket) directly.
       tags:
@@ -13443,14 +13443,9 @@ paths:
       - url: https://api.linode.com/v4
       summary: Object Storage Cancel
       description: |
-        Cancel Object Storage on an Account. All buckets on the Account must be empty
-        before Object Storage can be cancelled:
-
-        - To delete a smaller number of objects, review the instructions in our
-        [How to Use Object Storage](/docs/platform/object-storage/how-to-use-object-storage/)
-        guide.
-        - To delete large amounts of objects, consult our guide on
-        [Lifecycle Policies](/docs/platform/object-storage/lifecycle-policies/).
+        Cancel Object Storage on an Account.
+
+        **Warning**: Removes all buckets and their contents from your Account. This data is irretrievable once removed.
       security:
       - personalAccessToken: []
       - oauth: