cloud-container-engine/api-ref/source/kubernetes_apis/overview.rst

original_name

kubernetesapi.html

Overview

Description

You can use Kubernetes native APIs to manage your Kubernetes clusters. For details, see Kubernetes API Concepts.

To find detailed API definitions for different Kubernetes versions, visit the following links:

• 1.19: https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.19/
• 1.21: https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.21/
• 1.23: https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.23/

Based on the open source Kubernetes APIs, CCE enhances and adapts following functions.

• Ingress: For details, see Using kubectl to Create an ELB Ingress.
• PV and PVC: For details, see PV and PVC.
  • EVS: For details, see Creating a Pod Mounted with an EVS Volume.
  • SFS Turbo: For details, see Creating a Deployment Mounted with an SFS Turbo Volume and Creating a StatefulSet Mounted with an SFS Turbo Volume.
  • OBS: For details, see Creating a Deployment Mounted with an OBS Volume and Creating a StatefulSet Mounted with an OBS Volume.
  • SFS: For details, see Creating a Deployment Mounted with an SFS Volume and Creating a StatefulSet Mounted with an SFS Volume.
• Network Policies: For details, see Network Policies.

Calling Kubernetes APIs Through API Gateway

You can call Kubernetes native APIs through API Gateway using the URL in the format of https://{clusterid}.Endpoint/uri. In the URL, {clusterid} indicates the cluster ID, and uri indicates the resource path, that is, the path for API access.

Table 1 URL parameters

Parameter	Description
{clusterid}	Cluster ID. After a cluster is created, call the API for obtaining a cluster in a specified project <cce_02_0239> to obtain the cluster ID.
Endpoint	Web service entry URL. It can be obtained from Regions and Endpoints.
uri	Path in which the resource requested by the API is located. You can obtain the path from the URI of the API.

Calling Kubernetes APIs Through the API Server

You can use the API server of a Kubernetes cluster to call Kubernetes native APIs.

1. Call the API for obtaining the cluster certificate <cce_02_0248> to obtain the cluster certificates.

   There are three certificates:

   • ca.crt
   • client.crt
   • client.key

2. Go to the cluster details page and obtain the API server address (private or public network address).

   With the certificates and API server address, you can call Kubernetes native APIs.

   For example, if you run the curl command to call the API to view the pod information, you only need to carry the certificate in the command as follows:

   curl --cert ./client.crt --key ./client.key https://192.168.0.198:5443/api/v1/namespaces/default/pods/