Merge pull request #278 from linode/release-4.68.0

Release-4.68.0

Author: nmelehan

openapi.yaml

@@ -1,6 +1,6 @@
 openapi: 3.0.1
 info:
-  version: 4.67.0
+  version: 4.68.0
 
   title: Linode API
   description: |
@@ -877,6 +877,86 @@ paths:
         - lang: CLI
           source: >
             linode-cli account invoice-items 123
+  /account/logins:
+    x-linode-cli-command: account
+    get:
+      tags:
+      - Account
+      summary: List All User Logins
+      description: >
+        Returns a collection of successful logins for all users on the account during the last
+        90 days. This command can only be accessed by the unrestricted users of an account.
+      operationId: getAccountLogins
+      x-linode-cli-action: logins-list
+      security:
+      - personalAccessToken: []
+      - oauth:
+        - account:read_only
+      responses:
+        '200':
+          description: >
+            A collection of successful logins for all users on the account during the last
+            90 days.
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  data:
+                    type: array
+                    items:
+                      $ref: '#/components/schemas/Login'
+        default:
+          $ref: '#/components/responses/ErrorResponse'
+      x-code-samples:
+      - lang: Shell
+        source: >
+          curl -H "Authorization: Bearer $TOKEN" \
+              https://api.linode.com/v4/account/logins
+      - lang: CLI
+        source: >
+          linode-cli account logins-list
+  /account/logins/{loginId}:
+    parameters:
+    - name: loginId
+      in: path
+      description: The ID of the login object to access.
+      required: true
+      schema:
+        type: integer
+    x-linode-cli-command: account
+    get:
+      tags:
+      - Account
+      summary: View Login
+      description: >
+        Returns a Login object that displays information about a successful login.
+        The logins that can be viewed can be for any user on the account, and are not
+        limited to only the logins of the user that is accessing this API endpoint.
+        This command can only be accessed by the unrestricted users of the account.
+      operationId: getAccountLogin
+      x-linode-cli-action: login-view
+      security:
+      - personalAccessToken: []
+      - oauth:
+        - account:read_only
+      responses:
+        '200':
+          description: The requested login object.
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/Login'
+        default:
+          $ref: '#/components/responses/ErrorResponse'
+      x-code-samples:
+      - lang: Shell
+        source: >
+          curl -H "Authorization: Bearer $TOKEN" \
+              https://api.linode.com/v4/account/logins/1234
+      - lang: CLI
+        source: >
+          linode-cli account login-view 1234
   /account/notifications:
     x-linode-cli-command: account
     get:
@@ -6995,6 +7075,90 @@ paths:
       - lang: CLI
         source: >
           linode-cli longview delete 789
+  /longview/plan:
+    x-linode-cli-command: longview
+    get:
+      tags:
+      - Longview
+      summary: View Longview Plan
+      description: >
+        Returns the Longview subscription plan for this account. You can send a request to the
+        [View Longview Subscription](/api/v4/longview-subscriptions-subscription-id) endpoint for details on each particular subscription plan.
+      operationId: getLongviewPlan
+      x-linode-cli-action: plan-view
+      security:
+      - personalAccessToken: []
+      - oauth:
+        - longview:read_only
+      responses:
+        '200':
+          description: The Longview Subscription plan for this account.
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/LongviewPlan'
+        default:
+          $ref: '#/components/responses/ErrorResponse'
+      x-code-samples:
+      - lang: Shell
+        source: >
+          curl -H "Authorization: Bearer $TOKEN" \
+              https://api.linode.com/v4/longview/plan
+      - lang: CLI
+        source: >
+          linode-cli longview plan-view
+    put:
+      tags:
+      - Longview
+      summary: Update Longview Plan
+      description: >
+        Updates the Longview subscription plan for this account. You can send a request to the
+        [View Longview Subscription](/api/v4/longview-subscriptions-subscription-id) endpoint for details on each particular subscription plan.
+      operationId: updateLongviewPlan
+      x-linode-cli-action: plan-update
+      security:
+      - personalAccessToken: []
+      - oauth:
+        - account:read_write
+      requestBody:
+        description: Update your Longview subscription plan.
+        required: true
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/LongviewPlan'
+      responses:
+        '200':
+          description: The requested Longview Subscription.
+          content:
+            application/json:
+              schema:
+                properties:
+                  longview_subscription:
+                    type: string
+                    description: >
+                      The Longview subscription plan you are currently subscribed to.
+
+
+
+                      To update your subscription plan send a request to [Update Longview Plan](/api/v4/longview-plan/#put).
+                      The value must be a [Longview Subscription ID](/api/v4/longview-subscriptions) or `null`. Note that a value of `null` will cancel the longview subscription.
+                    example: longview-10
+                    x-linode-cli-display: 1
+        default:
+          $ref: '#/components/responses/ErrorResponse'
+      x-code-samples:
+      - lang: Shell
+        source: >
+            curl -H "Content-Type: application/json" \
+                -H "Authorization: Bearer $TOKEN" \
+                -X PUT -d '{
+                    "longview_subscription": "longview-10"
+                }' \
+                https://api.linode.com/v4/longview/plan
+      - lang: CLI
+        source: >
+          linode-cli longview plan-update --longview_subscription longview-10
   /longview/subscriptions:
     x-linode-cli-command: longview
     get:
@@ -11166,7 +11330,7 @@ paths:
                   data:
                     type: array
                     items:
-                      $ref: '#/components/schemas/Logins'
+                      $ref: '#/components/schemas/Login'
         default:
           $ref: '#/components/responses/ErrorResponse'
       x-code-samples:
@@ -11208,7 +11372,7 @@ paths:
           content:
             application/json:
               schema:
-                $ref: '#/components/schemas/Logins'
+                $ref: '#/components/schemas/Login'
         default:
           $ref: '#/components/responses/ErrorResponse'
       x-code-samples:
@@ -13797,12 +13961,16 @@ components:
           description: >
             The relative weight of this Record. Higher values are preferred.
           example: 50
+          minimum: 0
+          maximum: 65535
           x-linode-cli-display: 7
         port:
           type: integer
           description: >
             The port this Record points to.
           example: 80
+          minimum: 0
+          maximum: 65535
         service:
           type: string
           nullable: true
@@ -14215,7 +14383,7 @@ components:
               example: true
             add_longview:
               type: boolean
-              description: If true, this User may create Longview clients.
+              description: If true, this User may create Longview clients and view the current plan.
               example: true
             longview_subscription:
               type: boolean
@@ -16000,11 +16168,10 @@ components:
             When this Longview Client was last updated.
           example: 2018-01-01T00:01:01
           readOnly: true
-    Logins:
+    Login:
       type: object
       description: >
-        A collection of successful account logins from this user during the last
-        90 days
+        An object representing a previous successful login for a User.
       properties:
         id:
           type: integer
@@ -16029,6 +16196,20 @@ components:
           example: 192.0.2.0
           readOnly: true
           x-linode-cli-display: 3
+        username:
+          type: string
+          description: >
+            The username of the User that was logged into.
+          example: example_user
+          readOnly: true
+          x-linode-cli-display: 4
+        restricted:
+          type: boolean
+          description: >
+            True if the User that was logged into was a restricted User, false otherwise.
+          example: true
+          readOnly: true
+          x-linode-cli-display: 5
     LongviewSubscription:
       type: object
       description: >
@@ -16077,6 +16258,22 @@ components:
           example: 10
           readOnly: true
           x-linode-cli-display: 3
+    LongviewPlan:
+      type: object
+      description: >
+        Longview Plan object.
+      properties:
+        longview_subscription:
+          type: string
+          description: >
+            The Longview subscription plan you are currently subscribed to.
+
+
+
+            To update your subscription plan send a request to [Update Longview Plan](/api/v4/longview-plan/#put).
+            The value must be a [Longview Subscription ID](/api/v4/longview-subscriptions) or `null`. Note that a value of `null` will cancel the Longview subscription.
+          example: longview-30
+          x-linode-cli-display: 1
     ManagedContact:
       type: object
       description: >