Updated descriptions and examples.

Author: bbiggerr

openapi.yaml

@@ -6200,7 +6200,7 @@ paths:
             --authorized_keys "ssh-rsa AAAA_valid_public_ssh_key_123456785== user@their-computer" \
             --authorized_users "myUser" \
             --authorized_users "secondaryUser" \
-            --metadata.user_data "I2Nsb3VkLWNvbmZpZw==)"
+            --metadata.user_data "I2Nsb3VkLWNvbmZpZw=="
   /linode/instances/{linodeId}:
     parameters:
     - name: linodeId
@@ -6796,6 +6796,8 @@ paths:
         returned by this endpoint.
 
         Any [tags](/docs/api/tags/#tags-list) existing on the source Linode will be cloned to the target Linode.
+
+        Linodes utilizing Metadata (`"has_user_data": true`) must be cloned to a new Linode with `metadata.user_data` included with the clone request.
       tags:
       - Linode Instances
       operationId: cloneLinodeInstance
@@ -6923,6 +6925,8 @@ paths:
 
                       * Can only be provided when cloning to a new Linode.
                     example: true
+                metadata:
+                  $ref: '#/components/schemas/LinodeRequest/properties/metadata'
       responses:
         '200':
           description: Clone started.
@@ -6946,7 +6950,10 @@ paths:
                 "backups_enabled": true,
                 "disks": [25674],
                 "configs": [23456],
-                "private_ip": true
+                "private_ip": true,
+                "metadata": {
+                  "user_data": "I2Nsb3VkLWNvbmZpZw=="
+                }
               }' \
               https://api.linode.com/v4/linode/instances/123/clone
       - lang: CLI
@@ -6959,7 +6966,8 @@ paths:
             --backups_enabled true \
             --disks 25674 \
             --configs 23456 \
-            --private_ip true
+            --private_ip true \
+            --metadata.user_data I2Nsb3VkLWNvbmZpZw==
   /linode/instances/{linodeId}/configs:
     parameters:
     - name: linodeId
@@ -8480,6 +8488,7 @@ paths:
           * Requires a `root_pass` be supplied to use for the root User's Account.
           * It is recommended to supply SSH keys for the root User using the
             `authorized_keys` field.
+          * Linodes utilizing Metadata (`"has_user_data": true`) should include `metadata.user_data` in the rebuild request to continue using the service.
 
         You also have the option to resize the Linode to a different plan by including the `type` parameter with your request. Note that resizing involves migrating the Linode to a new hardware host, while rebuilding without resizing maintains the same hardware host. Resizing also requires significantly more time for completion of this command. The following additional conditions apply:
 
@@ -8543,7 +8552,10 @@ paths:
                 "stackscript_data": {
                   "gh_username": "linode"
                 }
-                "type": "g6-standard-2"
+                "type": "g6-standard-2",
+                "metadata": {
+                  "user_data": "I2Nsb3VkLWNvbmZpZw=="
+                }
               }' \
               https://api.linode.com/v4/linode/instances/123/rebuild
       - lang: CLI
@@ -8557,7 +8569,8 @@ paths:
             --booted true \
             --stackscript_id 10079 \
             --stackscript_data '{"gh_username": "linode"}' \
-            --type "g6-standard-2"
+            --type "g6-standard-2" \
+            --metadata.userdata "I2Nsb3VkLWNvbmZpZw=="
   /linode/instances/{linodeId}/rescue:
     parameters:
     - name: linodeId
@@ -22728,6 +22741,8 @@ components:
               description: |
                 Base64-encoded [cloud-config](/docs/products/compute/compute-instances/guides/metadata-cloud-config/) data.
 
+                Cannot be modified after provisioning. To update, use either the [Linode Clone](/docs/api/linode-instances/#linode-clone) or [Linode Rebuild](/docs/api/linode-instances/#linode-rebuild) commands.
+
                 Must not be included when cloning to an existing Linode.
 
                 Unencoded data must not exceed 65535 bytes, or about 16kb encoded.