Merge pull request #241 from leslitagordita/lke-api-endpoints-update

[New ] GET /lke/clusters/{clusterId}/api-endpoints

Author: leslitagordita

openapi.yaml

@@ -6587,6 +6587,73 @@ paths:
       - lang: CLI
         source: >
           linode-cli lke pool-delete 12345 456
+  /lke/clusters/{clusterId}/api-endpoints:
+    parameters:
+    - name: clusterId
+      in: path
+      description: ID of the Kubernetes cluster to look up.
+      required: true
+      schema:
+        type: integer
+    x-linode-cli-command: lke
+    get:
+      operationId: getLKEClusterAPIEndpoints
+      x-linode-cli-action: api-endpoints-list
+      security:
+      - personalAccessToken: []
+      - oauth:
+        - lke:read_only
+      tags:
+      - Linode Kubernetes Engine (LKE)
+      servers:
+      - url: https://api.linode.com/v4beta
+      summary: List Kubernetes API Endpoints
+      description: >
+        List the Kubernetes API server endpoints for this cluster. Please note that it often takes
+        2-5 minutes before the endpoint is ready after first [creating a new cluster](/api/v4/lke-clusters/#post).
+
+
+        **Beta**: This endpoint is in private beta. Please make sure to prepend all requests with
+        `/v4beta` instead of `/v4`, and be aware that this endpoint may receive breaking
+        updates in the future. This notice will be removed when this endpoint is out of
+        beta. Sign up for the beta [here](https://welcome.linode.com/lkebeta/).
+      responses:
+        '200':
+          description: Returns the Kubernetes API server endpoints for this cluster.
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  data:
+                    type: array
+                    items:
+                      type: object
+                      description: >
+                        The Kubernetes API server endpoints for this cluster.
+                      properties:
+                        endpoint:
+                          type: string
+                          readOnly: true
+                          description: >
+                            A Kubernetes API server endpoint for this cluster.
+                          example: "https://192.0.2.1:6443"
+                  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/v4beta/lke/clusters/12345/api-endpoints
+      - lang: CLI
+        source: >
+          linode-cli lke api-endpoint-list 12345
   /lke/clusters/{clusterId}/api-endpoint:
     parameters:
     - name: clusterId
@@ -6613,6 +6680,10 @@ paths:
         2-5 minutes before the endpoint is ready after first
         [creating a new cluster](/api/v4/lke-clusters/#post).
 
+        **Note** This endpoint will be deprecated in favor of
+        [List Kubernetes API Endpoints](/api/v4/lke-clusters-cluster-id-api-endpoints).
+
+
         **Beta**: This endpoint is in private beta. Please make sure to prepend all requests with
         `/v4beta` instead of `/v4`, and be aware that this endpoint may receive breaking
         updates in the future. This notice will be removed when this endpoint is out of