Merge pull request #511 from bbiggerr/get-linode-nodebalancers

[New] Linode NodeBalancers View

Author: bbiggerr

openapi.yaml

@@ -4175,7 +4175,7 @@ paths:
                         A Backup ID from another Linode's available backups. Your User must have
                         `read_write` access to that Linode, the Backup must have a `status` of
                         `successful`, and the Linode must be deployed to the same `region` as the Backup.
-                        See [/linode/instances/{linodeId}/backups](/docs/api/linode-instances/#backups-list)
+                        See [GET /linode/instances/{linodeId}/backups](/docs/api/linode-instances/#backups-list)
                         for a Linode's available backups.
 
                         This field and the `image` field are mutually exclusive.
@@ -6356,6 +6356,57 @@ paths:
       - lang: CLI
         source: >
           linode-cli linodes upgrade 123
+  /linode/instances/{linodeId}/nodebalancers:
+    parameters:
+    - name: linodeId
+      in: path
+      description: ID of the Linode to look up
+      required: true
+      schema:
+        type: integer
+    x-linode-cli-command: linodes
+    get:
+      x-linode-grant: read_only
+      tags:
+      - Linode Instances
+      summary: Linode NodeBalancers View
+      description: |
+        Returns a list of NodeBalancers that are assigned to this Linode and readable by the requesting User.
+
+        Read permission to a NodeBalancer can be given to a User by accessing the User's Grants Update
+        ([PUT /account/users/{username}/grants](https://www.linode.com/docs/api/account/#users-grants-update)) endpoint.
+      operationId: getLinodeNodeBalancers
+      x-linode-cli-action: nodebalancers
+      security:
+      - personalAccessToken: []
+      - oauth:
+        - linodes:read_only
+      responses:
+        '200':
+          description: Returns a paginated list of NodeBalancers.
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  data:
+                    type: array
+                    items:
+                      $ref: '#/components/schemas/NodeBalancer'
+                  page:
+                    $ref: '#/components/schemas/PaginationEnvelope/properties/page'
+                  pages:
+                    $ref: '#/components/schemas/PaginationEnvelope/properties/pages'
+                  results:
+                    $ref: '#/components/schemas/PaginationEnvelope/properties/results'
+      x-code-samples:
+      - lang: Shell
+        source: >
+          curl -H "Authorization: Bearer $TOKEN" \
+              https://api.linode.com/v4/linode/instances/123/nodebalancers
+      - lang: CLI
+        source: >
+          linode-cli linodes nodebalancers 123
   /linode/instances/{linodeId}/password:
     parameters:
     - name: linodeId