Add more unrestricted user messages

Author: bbiggerr

openapi.yaml

@@ -2716,12 +2716,12 @@ paths:
       tags:
       - Account
       summary: Users List
-      description: >
-        Returns a paginated list of Users on your Account. Users may access all
-        or part of your Account based on their restricted status and grants.  An
-        unrestricted User may access everything on the account, whereas restricted
-        User may only access entities or perform actions they've been given specific
-        grants to.
+      description: |
+        Returns a paginated list of Users on your Account.
+
+        This command can only be accessed by the unrestricted users of an account.
+
+        Users may access all or part of your Account based on their restricted status and grants.  An unrestricted User may access everything on the account, whereas restricted User may only access entities or perform actions they've been given specific grants to.
       operationId: getUsers
       x-linode-cli-action: list
       security:
@@ -2761,10 +2761,11 @@ paths:
       tags:
       - Account
       summary: User Create
-      description: >
+      description: |
         Creates a User on your Account. Once created, a confirmation message containing
         password creation and login instructions is sent to the User's email address.
 
+        This command can only be accessed by the unrestricted users of an account.
 
         The User's account access is determined by whether or not they are restricted,
         and what grants they have been given.
@@ -2824,8 +2825,10 @@ paths:
       tags:
       - Account
       summary: User View
-      description: >
+      description: |
         Returns information about a single User on your Account.
+
+        This command can only be accessed by the unrestricted users of an account.
       operationId: getUser
       x-linode-cli-action: view
       security:
@@ -2854,11 +2857,13 @@ paths:
       tags:
       - Account
       summary: User Update
-      description: >
+      description: |
         Update information about a User on your Account. This can be used to
         change the restricted status of a User. When making a User restricted,
         no grants will be configured by default and you must then set up grants
         in order for the User to access anything on the Account.
+
+        This command can only be accessed by the unrestricted users of an account.
       operationId: updateUser
       x-linode-cli-action: update
       security:
@@ -2902,10 +2907,12 @@ paths:
       tags:
       - Account
       summary: User Delete
-      description: >
+      description: |
         Deletes a User. The deleted User will be immediately logged out and
         may no longer log in or perform any actions. All of the User's Grants
         will be removed.
+
+        This command can only be accessed by the unrestricted users of an account.
       operationId: deleteUser
       x-linode-cli-action: delete
       security:
@@ -2944,11 +2951,12 @@ paths:
       tags:
       - Account
       summary: User's Grants View
-      description: >
+      description: |
         Returns the full grants structure for the specified account User
         (other than the account owner, see below for details). This includes all entities
         on the Account alongside the level of access this User has to each of them.
 
+        This command can only be accessed by the unrestricted users of an account.
 
         The current authenticated User, including the account owner, may view their
         own grants at the [/profile/grants](/docs/api/profile/#grants-list)
@@ -2983,11 +2991,13 @@ paths:
       tags:
       - Account
       summary: User's Grants Update
-      description: >
+      description: |
         Update the grants a User has. This can be used to give a User access
         to new entities or actions, or take access away.  You do not need to
         include the grant for every entity on the Account in this request; any
         that are not included will remain unchanged.
+
+        This command can only be accessed by the unrestricted users of an account.
       operationId: updateUserGrants
       x-linode-cli-action: update-grants
       x-linode-cli-skip: true
@@ -3729,7 +3739,6 @@ paths:
       - url: https://api.linode.com/v4
       - url: https://api.linode.com/v4beta
       x-linode-cli-action: mongodb-backup-delete
-      x-linode-grant: unrestricted only
       description: |
         Delete a single backup for an accessible Managed MongoDB Database.
 
@@ -4509,7 +4518,6 @@ paths:
       - url: https://api.linode.com/v4
       - url: https://api.linode.com/v4beta
       x-linode-cli-action: mysql-backup-delete
-      x-linode-grant: unrestricted only
       description: |
         Delete a single backup for an accessible Managed MySQL Database.
 
@@ -5280,7 +5288,6 @@ paths:
       - url: https://api.linode.com/v4
       - url: https://api.linode.com/v4beta
       x-linode-cli-action: postgresql-backup-delete
-      x-linode-grant: unrestricted only
       description: |
         Delete a single backup for an accessible Managed PostgreSQL Database.
 
@@ -11548,7 +11555,7 @@ paths:
       tags:
       - Managed
       summary: Managed Contacts List
-      description: >
+      description: |
         Returns a paginated list of Managed Contacts on your Account.
 
         This command can only be accessed by the unrestricted users of an account.
@@ -11591,7 +11598,7 @@ paths:
       tags:
       - Managed
       summary: Managed Contact Create
-      description: >
+      description: |
         Creates a Managed Contact.  A Managed Contact is someone Linode
         special forces can contact in the course of attempting to resolve an issue
         with a Managed Service.
@@ -11653,7 +11660,7 @@ paths:
       tags:
       - Managed
       summary: Managed Contact View
-      description: >
+      description: |
         Returns a single Managed Contact.
 
         This command can only be accessed by the unrestricted users of an account.
@@ -11737,7 +11744,7 @@ paths:
       tags:
       - Managed
       summary: Managed Contact Delete
-      description: >
+      description: |
         Deletes a Managed Contact.
 
         This command can only be accessed by the unrestricted users of an account.
@@ -11775,7 +11782,7 @@ paths:
       tags:
       - Managed
       summary: Managed Credentials List
-      description: >
+      description: |
         Returns a paginated list of Managed Credentials on your Account.
 
         This command can only be accessed by the unrestricted users of an account.
@@ -11818,7 +11825,7 @@ paths:
       tags:
       - Managed
       summary: Managed Credential Create
-      description: >
+      description: |
         Creates a Managed Credential. A Managed Credential is stored securely
         to allow Linode special forces to access your Managed Services and resolve
         issues.
@@ -11894,7 +11901,7 @@ paths:
       tags:
       - Managed
       summary: Managed Credential View
-      description: >
+      description: |
         Returns a single Managed Credential.
 
         This command can only be accessed by the unrestricted users of an account.
@@ -11983,7 +11990,7 @@ paths:
       tags:
       - Managed
       summary: Managed Credential Username and Password Update
-      description: >
+      description: |
         Updates the username and password for a Managed Credential.
 
         This command can only be accessed by the unrestricted users of an account.
@@ -12053,7 +12060,7 @@ paths:
       tags:
       - Managed
       summary: Managed Credential Delete
-      description: >
+      description: |
         Deletes a Managed Credential.  Linode special forces will no longer
         have access to this Credential when attempting to resolve issues.
 
@@ -12089,7 +12096,7 @@ paths:
       tags:
       - Managed
       summary: Managed SSH Key View
-      description: >
+      description: |
         Returns the unique SSH public key assigned to your Linode account's
         Managed service. If you [add this public key](/docs/platform/linode-managed/#adding-the-public-key) to a Linode on your account,
         Linode special forces will be able to log in to the Linode with this key
@@ -12140,7 +12147,7 @@ paths:
       tags:
       - Managed
       summary: Managed Issues List
-      description: >
+      description: |
         Returns a paginated list of recent and ongoing issues detected on your
         Managed Services.
 
@@ -12194,7 +12201,7 @@ paths:
       tags:
       - Managed
       summary: Managed Issue View
-      description: >
+      description: |
         Returns a single Issue that is impacting or did impact one of your
         Managed Services.
 
@@ -12232,7 +12239,7 @@ paths:
       tags:
       - Managed
       summary: Managed Linode Settings List
-      description: >
+      description: |
         Returns a paginated list of Managed Settings for your Linodes. There will
         be one entry per Linode on your Account.
 
@@ -12286,7 +12293,7 @@ paths:
       tags:
       - Managed
       summary: Linode's Managed Settings View
-      description: >
+      description: |
         Returns a single Linode's Managed settings.
 
         This command can only be accessed by the unrestricted users of an account.
@@ -12373,7 +12380,7 @@ paths:
       tags:
       - Managed
       summary: Managed Services List
-      description: >
+      description: |
         Returns a paginated list of Managed Services on your Account. These
         are the services Linode Managed is monitoring and will report and attempt
         to resolve issues with.
@@ -12418,7 +12425,7 @@ paths:
       tags:
       - Managed
       summary: Managed Service Create
-      description: >
+      description: |
         Creates a Managed Service. Linode Managed will begin monitoring this
         service and reporting and attempting to resolve any Issues.
 
@@ -12494,7 +12501,7 @@ paths:
       tags:
       - Managed
       summary: Managed Service View
-      description: >
+      description: |
         Returns information about a single Managed Service on your Account.
 
         This command can only be accessed by the unrestricted users of an account.
@@ -12526,7 +12533,7 @@ paths:
       tags:
       - Managed
       summary: Managed Service Update
-      description: >
+      description: |
         Updates information about a Managed Service.
 
         This command can only be accessed by the unrestricted users of an account.
@@ -12586,7 +12593,7 @@ paths:
       tags:
       - Managed
       summary: Managed Service Delete
-      description: >
+      description: |
         Deletes a Managed Service.  This service will no longer be monitored by
         Linode Managed.
 
@@ -12629,7 +12636,7 @@ paths:
       tags:
       - Managed
       summary: Managed Service Disable
-      description: >
+      description: |
         Temporarily disables monitoring of a Managed Service.
 
         This command can only be accessed by the unrestricted users of an account.
@@ -12672,7 +12679,7 @@ paths:
       tags:
       - Managed
       summary: Managed Service Enable
-      description: >
+      description: |
         Enables monitoring of a Managed Service.
 
         This command can only be accessed by the unrestricted users of an account.