Merge pull request #219 from linode/release-4.59.2

Release 4.59.2

Author: leslitagordita

openapi.yaml

@@ -1,6 +1,6 @@
 openapi: 3.0.1
 info:
-  version: 4.14.1
+  version: 4.59.2
 
   title: Linode API
   description: |
@@ -36,7 +36,8 @@ info:
 
     The easiest way to access the API is with a Personal Access Token (PAT)
     generated from the
-    <a target="_top" href="https://cloud.linode.com/profile/tokens">Linode Cloud Manager</a>.
+    <a target="_top" href="https://cloud.linode.com/profile/tokens">Linode Cloud Manager</a> or
+    the [Create Personal Access Token](/api/v4/profile-tokens#post) endpoint.
 
     All scopes for the OAuth security model ([defined below](#o-auth)) apply to this
     security model as well.
@@ -3734,6 +3735,8 @@ paths:
         Up to five clone operations from any given source Linode can be run concurrently.
         If more concurrent clones are attempted, an HTTP 400 error will be
         returned by this endpoint.
+
+        Any [tags](/api/v4/tags) existing on the source Linode will be cloned to the target Linode.
       tags:
       - Linode Instances
       operationId: cloneLinodeInstance
@@ -3749,6 +3752,9 @@ paths:
           application/json:
             schema:
               type: object
+              required:
+              - region
+              - type
               properties:
                 region:
                   type: string
@@ -3854,7 +3860,7 @@ paths:
           content:
             application/json:
               schema:
-                type: object
+                $ref: '#/components/schemas/Linode'
         default:
           $ref: '#/components/responses/ErrorResponse'
       x-code-samples:
@@ -9833,6 +9839,57 @@ paths:
           curl -H "Authorization: Bearer $TOKEN" \
             -X DELETE \
             https://api.linode.com/v4/object-storage/buckets/us-east-1/example-bucket
+  /object-storage/buckets/{clusterId}:
+    parameters:
+    - name: clusterId
+      in: path
+      description: The ID of the cluster this bucket exists in.
+      required: true
+      schema:
+        type: string
+    get:
+      operationId: getObjectStorageBucketinCluster
+      x-linode-cli-skip: true
+      servers:
+      - url: https://api.linode.com/v4
+      summary: List Object Storage Buckets in Cluster
+      description: |
+        Returns a list of Buckets in this cluster belonging to this Account.
+
+
+        This endpoint is available for convenience. It is recommended that instead you
+        use the more [fully-featured S3 API](https://docs.ceph.com/docs/mimic/radosgw/s3/bucketops/#get-bucket) directly.
+      tags:
+      - Object Storage
+      security:
+      - personalAccessToken: []
+      - oauth:
+        - object_storage:read_only
+      responses:
+        '200':
+          description: A paginated list of buckets you own in this cluster.
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  data:
+                    type: array
+                    items:
+                      $ref: '#/components/schemas/ObjectStorageBucket'
+                  page:
+                    $ref: '#/components/schemas/PaginationEnvelope/properties/page'
+                  pages:
+                    $ref: '#/components/schemas/PaginationEnvelope/properties/pages'
+                  results:
+                    $ref: '#/components/schemas/PaginationEnvelope/properties/results'
+        default:
+          $ref: '#/components/responses/ErrorResponse'
+      x-code-samples:
+      - lang: Shell
+        source: >
+          curl -H "Authorization: Bearer $TOKEN" \
+            https://api.linode.com/v4/object-storage/buckets/us-east-1
   /object-storage/buckets/{clusterId}/{bucket}/access:
     parameters:
     - name: clusterId
@@ -12021,6 +12078,25 @@ paths:
                 $ref: '#/components/schemas/Tag'
         default:
           $ref: '#/components/responses/ErrorResponse'
+      x-code-samples:
+        - lang: Shell
+          source: >
+            curl -H "Content-Type: application/json" \
+                -H "Authorization: Bearer $TOKEN" \
+                -X POST -d '{
+                    "label": "example tag",
+                    "linodes": [123,456],
+                    "volumes": [9082,10003]
+                }' \
+                https://api.linode.com/v4/tags
+        - lang: CLI
+          source: >
+            linode-cli tags create \
+              --label 'example tag' \
+              --linodes 123 \
+              --linodes 456 \
+              --volumes 9082 \
+              --volumes 10003
   /tags/{label}:
     x-linode-cli-command: tags
     parameters:
@@ -12083,6 +12159,11 @@ paths:
                     $ref: '#/components/schemas/PaginationEnvelope/properties/results'
         default:
           $ref: '#/components/responses/ErrorResponse'
+      x-code-samples:
+      - lang: Shell
+        source: >
+          curl -H "Authorization: Bearer $TOKEN" \
+              "https://api.linode.com/v4/tags/example tag"
     delete:
       summary: Delete a Tag
       description: >
@@ -13373,6 +13454,8 @@ components:
                 * Lower-case letters
                 * Digits
                 * Punctuation
+              * Must meet a password strength score requirement that is calculated internally by the API.
+                If the strength requirement is not met, you will receive a `Password does not meet strength requirement` error.
           minLength: 6
           maxLength: 128
           pattern: ^(((?=.*[a-z])(?=.*[A-Z]))|((?=.*[a-z])(?=.*[0-9]))|((?=.*[A-Z])(?=.*[0-9]))|((?=.*[a-z])(?=.*[!"#$%&'()*+,-.\/:;<=>?@\[\]^_`{|}~\\]))|((?=.*[A-Z])(?=.*[!"#$%&'()*+,-.\/:;<=>?@\[\]^_`{|}~\\]))|((?=.*[0-9])(?=.*[!"#$%&'()*+,-.\/:;<=>?@\[\]^_`{|}~\\])))
@@ -13636,6 +13719,18 @@ components:
             The tag portion of a CAA record. It is invalid to set this on
             other record types.
           example: null
+        created:
+          type: string
+          format: date-time
+          description: When this Domain Record was created.
+          example: '2018-01-01T00:01:01'
+          readOnly: true
+        updated:
+          type: string
+          format: date-time
+          description: When this Domain Record was last updated.
+          example: '2018-01-01T00:01:01'
+          readOnly: true
     ErrorObject:
       type: object
       description: >
@@ -14849,8 +14944,8 @@ components:
           type: string
           description: >
             A brief description of this Linode's current state. This field may change without
-            direct action from you. For instance, the status will change to "running"
-             when the boot process completes.
+            direct action from you. For example, when a Linode goes into maintenance mode
+            its status will display "stopped".
           example: running
           readOnly: true
           enum:
@@ -14865,6 +14960,7 @@ components:
           - rebuilding
           - cloning
           - restoring
+          - stopped
           x-linode-cli-display: 7
           x-linode-cli-color:
               running: green