API Overview

APIs provided by CCE are classified into two types: proprietary APIs and Kubernetes-native APIs. By using these two types of APIs, you can use all functions provided by CCE, including creating clusters and nodes, using the Kubernetes-native APIs to create workloads, and using the proprietary CCE APIs to monitor application data.

Type

Subtype

Description

Proprietary CCE APIs

Cluster

Manage clusters and nodes, including creating and deleting clusters and nodes.

Using these APIs, you can create clusters, add nodes to clusters, and obtain information about created clusters and nodes.

NOTICE:

When performing operations, such as creating, deleting, and scaling clusters, do not change user permission in the IAM console. Otherwise, these operations may fail.

Storage

Manage storage, including creating and deleting PersistentVolumeClaims and PersistentVolumes.

Add-on

Manage add-ons, including querying AddonTemplates and creating, updating, deleting, and obtaining AddonInstances.

Kubernetes-native APIs

Node

Manage nodes, such as obtaining, querying, and updating nodes.

NOTE:

CCE allows you to create and delete nodes using only APIs of cluster management. Using Kubernetes-native APIs to create or delete nodes is not supported.

Namespace

Manage namespaces, such as creating, querying, modifying, and deleting namespaces.

Resource Quotas

Query resource quotas.

Pod

Manage pods, such as creating, querying, modifying, and deleting pods.

Deployment

Manage Deployments, such as creating, querying, modifying, and deleting Deployments.

StatefulSet

Manage StatefulSets, such as creating, querying, modifying, and deleting StatefulSets.

DaemonSet

Manage DaemonSets, such as creating, querying, modifying, and deleting DaemonSets.

Job

Manage jobs, such as creating, querying, modifying, and deleting jobs.

CronJob

Manage cron jobs, including creating, querying, modifying, and deleting cron jobs.

ReplicaSet

Query ReplicaSets.

ReplicationController

Manage ReplicationController objects, including creating, querying, modifying, and deleting ReplicationController objects.

Endpoint

Manage endpoints, such as creating, querying, modifying, and deleting endpoints.

Service

Manage Service objects, such as creating, querying, modifying, and deleting Service objects.

Ingress

Manage ingresses, including creating, updating, and deleting ingresses.

NetworkPolicy

Manage network policies, including creating, updating, and deleting network policies.

PersistentVolume

Manage PersistentVolumes (PVs), such as creating, querying, modifying, and deleting PVs.

PersistentVolumeClaim

Manage PersistentVolumeClaims (PVCs), such as creating, querying, modifying, and deleting PVCs.

ConfigMap

Manage ConfigMaps, such as creating, querying, modifying, and deleting ConfigMaps.

Secret

Manage secrets, including creating, querying, modifying, and deleting secrets.

RBAC

Authorize users or user groups to perform operations on different Kubernetes resources.

API group

Manage API groups, including listing API groups and API versions.

Event

Query events.

The Kubernetes-native APIs called in the current version do not support HTTP persistent connections.

Cluster-related APIs

Table 1 Cluster-related APIs

API

Description

Creating a Cluster

Create an empty cluster, which has only master nodes but do not have worker nodes.

Reading a Specified Cluster

Obtain details about a specified cluster.

Listing Clusters in a Specified Project

Obtain details about all clusters in a specified project.

Updating a Specified Cluster

Update information about a specified cluster.

Deleting a Cluster

Delete a specified cluster.

Hibernating a Cluster

Hibernate a specified cluster.

Waking Up a Cluster

Wake up a hibernated cluster.

Obtaining Cluster Certificates

Obtain certificates of a specified cluster.

Creating a Node

Create a node in a specified cluster.

Reading a Specified Node

Obtain details about a node with a specified node ID.

Reading all Nodes in a Cluster

Obtain details about all nodes in a cluster with a specified cluster ID.

Updating a Specified Node

Update information about a specified node.

Deleting a Node

Delete a specified node

Creating a Node Pool

Create a node pool in a specified cluster.

Reading a Specified Node Pool

Obtain details about a specified node pool.

Listing All Node Pools in a Specified Cluster

Obtain information about all node pools in a specified cluster.

Updating a Specified Node Pool

Update information about a specified node pool.

Deleting a Node Pool

Delete a specified node pool.

Obtaining Job Information

Obtain the progress of a job with a specified job ID returned after a job request is issued.

Storage-related APIs

Table 2 Storage-related APIs

API

Description

Creating a PVC

Create a PersistentVolumeClaim (PVC) in a specified namespace in HUAWEI CLOUD. The PVC is a request for a PersistentVolume (PV) that carries details of real cloud storage such as EVS disks, SFS file systems, or OBS buckets.

Deleting a PVC

Delete a PVC from a specified namespace. It is user's choice whether to retain the real cloud storage bound to the PVC.

Add-on-related APIs

Table 3 Add-on-related APIs

API

Description

Installing an Add-on Instance

Install an add-on by using the add-on template. One or more instances will be created for the installed add-on.

Listing Add-on Templates

Query add-on information.

Updating an Add-on Instance

Update an add-on instance.

Deleting an Add-on Instance

Delete an add-on instance.

Reading an Add-on Instance

Obtain details about an add-on instance.

Listing Add-on Instances

List all add-on instances in the cluster.

Node-related APIs

Table 4 Node-related APIs

API

Description

Reading a Specified Node

Read a specified node.

Listing All Nodes

Obtain the list of specified nodes.

Updating a Specified Node

Update a specified node.

Namespace-related APIs

Table 5 Namespace-related APIs

API

Description

Creating a Namespace

Create a namespace.

Deleting a Namespace

Delete a namespace.

Querying a Specified Namespace

Obtain details about a specified namespace.

Replacing a Specified Namespace

Replace some information about a specified namespace.

Replacing the Status of a Specified Namespace

Modify the status information of a specified namespace.

Replacing the Finalize Values of a Specified Namespace

Replace the finalize value of a specified namespace.

Listing Namespaces

Obtain details about all namespaces in a cluster.

Updating a Specified Namespace

Update some information about a specified namespace.

Resource Quota-related APIs

Table 6 Resource quota-related APIs

API

Description

Obtaining Resource Quotas

List or query detailed information about resource quotas.

Pod-related APIs

Table 7 Pod-related APIs

API

Description

Creating a Pod

Create a pod in a specified namespace.

Deleting a Pod

Delete a pod in a specified namespace.

Deleting All Pods

Delete all pods.

Reading a Specified Pod

Obtain details about a specified pod in a specified namespace.

Replacing a Specified Pod

Replace a pod in a specified namespace.

Replacing the Status of a Specified Pod

Change the status of a ReplicationController in a specified namespace.

Listing All Pods in a Specified Namespace

List all pods in a specified namespace.

Listing Pods

Obtain a pod list.

Updating a Specified Pod

Update a pod in a specified namespace.

Deployment-related APIs

Table 8 Deployment-related APIs

API

Description

Creating a Deployment

Create a Deployment.

Rolling Back a Deployment

Create a Deployment rollback operation.

Deleting a Deployment

Delete a Deployment.

Deleting All Deployments

Delete all Deployments.

Reading a Specified Deployment

Obtain a specified Deployment in a namespace.

Reading the Status of a Specified Deployment

Obtain the status of a specified Deployment in a namespace.

Reading the Scaling Operation of a Specified Deployment

Obtain details about scaling a specified Deployment.

Replacing a Specified Deployment

Replace a specified Deployment.

Replacing the Status of a Specified Deployment

Change the value of the status field of a specified Deployment in a specified namespace.

Replacing the Scaling Operation of a Specified Deployment

Replace the scaling operation of a specified Deployment.

Listing Deployments in a Specified Namespace

List all Deployments in a specified namespace.

Listing All Deployments

List specified Deployments.

Updating a Specified Deployment

Update a Deployment in a specified namespace.

Updating the Status of a Specified Deployment

Update the status of a specified Deployment in a specified namespace.

Updating the Scaling Operation of a Specified Deployment

Update the scaling operation of a specified Deployment.

StatefulSet-related APIs

Table 9 StatefulSet-related APIs

API

Description

Creating a StatefulSet

Create a StatefulSet.

Deleting a Specified StatefulSet

Delete a StatefulSet.

Delete All StatefulSets

Delete all StatefulSets.

Reading a Specified StatefulSet

Obtain StatefulSets in a specified namespace.

Reading the Status of a Specified StatefulSet

Obtain the status of a specified StatefulSet in a specified namespace.

Replacing a Specified StatefulSet

Replace StatefulSets in a specified namespace.

Replacing the Status of a Specified StatefulSet

Change the value of the status field of a specified StatefulSet in a specified namespace.

Listing a StatefulSet in a Specified Namespace

List all StatefulSets in a specified namespace.

Listing All StatefulSets

List all StatefulSets.

Updating a Specified StatefulSet

Update StatefulSets in a specified namespace.

Updating the Status of a Specified StatefulSet

Update the status of a specified StatefulSet in a specified namespace.

DaemonSet-related APIs

Table 10 DaemonSet-related APIs

API

Description

Creating a DaemonSet

Create a DaemonSet.

Deleting a Specified DaemonSet

Delete a DaemonSet.

Delete All DaemonSets

Delete all DaemonSets.

Reading a Specified DaemonSet

Read a DaemonSet object in a specified namespace.

Reading the Status of a Specified DaemonSet

Obtain the status of a specified DaemonSet in a specified namespace.

Updating a Specified DaemonSet

Update a DaemonSet in a specified namespace.

Updating the Status of a Specified DaemonSet

Update the status of a specified DaemonSet in a specified namespace.

Listing All DaemonSets

List specified DaemonSets.

Listing a DaemonSet in a Specified Namespace

List all DaemonSets in a specified namespace.

Replacing a Specified DaemonSet

Replace DaemonSets in a specified namespace.

Replacing the Status of a Specified DaemonSet

Change the value of the status field of a specified DaemonSet in a specified namespace.

Job-related APIs

Table 11 Job-related APIs

API

Description

Creating a Job

Create a job.

Deleting a Job

Delete a job.

Deleting All Jobs

Delete all jobs.

Reading a Specified Job

Read a specified job.

Reading the Status of a Specified Job

Obtain the status of a specified job.

Replacing a Specified Job

Replace a specified job.

Replacing the Status of a Specified Job

Replace the status of a specified job.

Listing a Job in a Specified Namespace

List all jobs in a specified namespace.

Listing All Jobs

List all jobs.

Updating the Status of a Specified Job

Update the status of a specified job in a specified namespace.

Updating a Specified Job

Update a specified job.

Cron Job-related APIs

Table 12 Cron job-related APIs

API

Description

Creating a Cron Job

Create a cron job.

Deleting a Cron Job

Delete a cron job.

Deleting All Cron Jobs

Delete all cron jobs.

Reading a Specified Cron Job

Read a specified cron job.

Reading a Specified Cron Job

Read the status of a specified cron job.

Replacing a Specified Cron Job

Replace a specified cron job.

Replacing the Status of a Specified Cron Job

Replace the status of a specified cron job.

Listing Cron Jobs Under a Specified Namespace

List all cron jobs in a specified namespace.

Listing Cron Jobs

List all cron jobs.

Updating the Status of a Specified Cron Job

Update the status of a specified cron job in a specified namespace.

Updating a Specified Cron Job

Update a specified cron job.

ReplicaSet-related APIs

Table 13 ReplicaSet-related APIs

API

Description

Listing ReplicaSets

List all ReplicaSets in a specified namespace.

ReplicationController-related APIs

Table 14 ReplicationController-related APIs

API

Description

Creating a ReplicationController

Create a ReplicationController.

Deleting a ReplicationController

Delete a ReplicationController.

Deleting All ReplicationControllers

Delete ReplicationControllers in batches.

Reading a ReplicationController Under a Specified Namespace

Obtain information about a ReplicationControllers in a specified namespace.

Replacing a ReplicationController Under a Specified Namespace

Replace a ReplicationController in a specified namespace.

Replacing the Status of a ReplicationController Under a Specified Namespace

Change the status of a ReplicationController in a specified namespace.

Listing ReplicationControllers in a Specified Namespace

List all ReplicationControllers in a specified namespace.

Listing ReplicationControllers

Obtain a ReplicationController list.

Updating a Specified ReplicationController

Update the ReplicationController in a specified namespace.

Endpoint-related APIs

Table 15 Endpoint-related APIs

API

Description

Creating an Endpoints Object

Create an endpoint.

Deleting an Endpoints Object

Delete an endpoint.

Deleting All Endpoints

Delete all endpoints.

Querying a Specified Endpoint

Obtain details about a specified endpoint.

Replacing a Specified Endpoint

Replace a specified endpoint in a specified namespace.

Listing Endpoints

List all endpoints.

Listing Endpoints in a Specified Namespace

Obtain all endpoints in a specified namespace.

Updating a Specified Endpoint

Update endpoints in a specified namespace.

Service-related APIs

Table 16 Service-related APIs

API

Description

Creating a Service

Create a Service.

Deleting a Specified Service

Delete a Service.

Obtaining a Specified Service

Obtain a specified Service.

Replacing a Specified Service

Replace a specified Service.

Listing Services in a Specified Namespace

List Services in a specified namespace.

Listing Services

List Services in a cluster.

Updating a Specified Service

Replace a specified Service.

Ingress-related APIs

Table 17 Ingress-related APIs

API

Description

Creating an Ingress

Create an ingress.

Updating a Specified Ingress

Update a specified ingress partially.

Replacing a Specified Ingress

Replace a specified ingress.

Deleting an Ingress

Delete an ingress.

Deleting All Ingresses

Delete all ingresses.

Obtaining a Specified Ingress

Read a specified ingress.

Listing Ingresses in a Specified Namespace

List ingresses in a specified namespace.

Obtaining an Ingresses List

Obtain the ingress list.

Obtaining the Status of an Ingress in a Specified Namespace

Obtain the status of an ingress in a specified namespace.

Replacing the Status of an Ingress in a Specified Namespace

Replace the status of an ingress in a specified namespace.

Updating the Status of an Ingress in a Specified Namespace

Update the status of an ingress in a specified namespace.

Network Policy-related APIs

Table 18 Network policy-related APIs

API

Description

Creating a NetworkPolicy

Create a network policy.

Updating a Specified NetworkPolicy

Partially update a specified network policy.

Replacing a Specified NetworkPolicy

Replace a specified network policy.

Deleting a Specified NetworkPolicy

Delete a network policy.

Deleting NetworkPolicies in Batches

Delete network policies in batches.

Reading a Specified NetworkPolicy

Read a specified network policy.

Obtaining the NetworkPolicy List Under a Specified Namespace

List network policies in a specified namespace.

Obtaining the NetworkPolicy List

Obtain the network policy list.

PersistentVolume-related APIs

Table 19 PersistentVolume-related APIs

API

Description

Creating a PersistentVolume

Create a PersistentVolume.

Deleting a Specified PersistentVolume

Delete a specified PersistentVolume.

Deleting All PersistentVolumes

Delete all PersistentVolumes.

Reading a Specified PersistentVolume

Obtain details about a specified PersistentVolume.

Replacing a Specified PersistentVolume

Replace a specified PersistentVolume.

Replacing the Status of a Specified PersistentVolume

Replace the status of a specified PersistentVolume.

Listing All PersistentVolumes

List all PersistentVolumes.

Updating a Specified PersistentVolume

Update a specified PersistentVolume.

PersistentVolumeClaim-related APIs

Table 20 PersistentVolumeClaim-related APIs

API

Description

Creating a PersistentVolumeClaim

Create a PersistentVolumeClaim in a specified namespace.

Deleting a Specified PersistentVolumeClaim

Delete a PersistentVolumeClaim in a specified namespace.

Deleting All PersistentVolumeClaims

Delete all PersistentVolumeClaims.

Reading a Specified PersistentVolumeClaim

Obtain details about a PersistentVolumeClaim in a specified namespace.

Replacing a Specified PersistentVolumeClaim

Replace a PersistentVolumeClaim in a specified namespace.

Replacing the Status of a Specified PersistentVolumeClaim

Replace the status of a specified PersistentVolumeClaim in a specified namespace.

Listing PersistentVolumeClaims in a Specified Namespace

List all PersistentVolumeClaims in a specified namespace.

Listing All PersistentVolumeClaims

List all PersistentVolumeClaims.

Updating a Specified PersistentVolumeClaim

Update a specified PersistentVolumeClaim.

ConfigMap-related APIs

Table 21 ConfigMap-related APIs

API

Description

Creating a ConfigMap

Create a ConfigMap.

Deleting a ConfigMap

Delete a ConfigMap.

Deleting All ConfigMaps

Delete all ConfigMaps.

Reading a Specified ConfigMap

Read a specified ConfigMap.

Replacing a Specified ConfigMap

Replace a specified ConfigMap.

Listing ConfigMaps in a Specified Namespace

List all ConfigMaps in a specified namespace.

Listing All ConfigMaps

Obtain the ConfigMap list.

Updating a Specified ConfigMap

Update a specified ConfigMap.

Secret-related APIs

Table 22 Secret-related APIs

API

Description

Creating a Secret

Create a secret.

Deleting a Secret

Delete secrets in a specified namespace.

Deleting All Secrets in a Specified Namespace

Delete secrets in batches.

Reading a Specified Secret

Obtain details about a specified secret.

Replacing a Specified Secret

Replace secrets in a specified namespace.

Listing the Secrets in a Specified Namespace

List secrets in a specified namespace.

Listing the Secrets in a Cluster

List all secrets in a cluster.

RBAC-related APIs

Table 23 RBAC-related APIs

API

Description

Creating a ClusterRole

Create a ClusterRole.

Updating a Specified ClusterRole

Partially update a specified ClusterRole.

Replacing a Specified ClusterRole

Replace a specified ClusterRole.

Deleting a Specified ClusterRole

Delete a specified ClusterRole.

Deleting ClusterRoles in Batches

Batch delete ClusterRoles.

Reading a Specified ClusterRole

Read a specified ClusterRole.

Reading the List of ClusterRoles

Obtain the ClusterRole list.

Creating a ClusterRoleBinding

Create a ClusterRoleBinding.

Updating a Specified ClusterRoleBinding

Partially update a specified ClusterRoleBinding.

Replacing a Specified ClusterRoleBinding

Replace a specified ClusterRoleBinding.

Deleting a Specified ClusterRoleBinding

Delete a specified ClusterRoleBinding.

Deleting ClusterRoleBindings in Batches

Batch delete ClusterRoleBindings.

Reading a Specified ClusterRoleBinding

Read a specified ClusterRoleBinding.

Reading the List of ClusterRoleBindings

Obtain the ClusterRoleBinding list.

Creating a Role

Create a role.

Updating a Specified Role

Partially update a specified role.

Replacing a Specified Role

Replace a specified role.

Deleting a Specified Role

Delete a specified role.

Deleting Roles in Batches

Batch delete roles.

Reading a Specified Role

Read a specified role.

Obtaining the Role List in a Specified Namespace

List roles in a specified namespace.

Obtaining the Role List

Obtain the role list.

Creating a RoleBinding

Create a RoleBinding.

Updating a Specified RoleBinding

Partially update a specified RoleBinding.

Replacing a Specified RoleBinding

Replace a specified RoleBinding.

Deleting a Specified RoleBinding

Delete a specified RoleBinding.

Deleting RoleBindings in Batches

Batch delete RoleBindings.

Reading a Specified RoleBinding

Read a specified RoleBinding.

Obtaining the RoleBinding List in a Specified Namespace

Obtain the list of RoleBindings in a specified namespace.

Obtaining the RoleBinding List

Obtain the RoleBinding list.

API Group-related APIs

Table 24 API group-related APIs

API

Description

Listing APIVersions

List API versions.

Listing APIGroups

List API groups.

listing APIResources of GroupVersion apiregistration.k8s.io/v1beta1

List API groups.

listing APIResources of GroupVersion extensions/v1beta1

List API groups.

listing APIResources of GroupVersion apps/v1beta1

List the APIResources of Group Version "apps/v1beta1".

listing APIResources of GroupVersion authentication.k8s.io/v1

List APIResources of GroupVersion "authentication.kubernetes.io/v1"

listing APIResources of GroupVersion authentication.k8s.io/v1beta1

List APIResources of GroupVersion "authentication.k8s.io/v1beta1".

listing APIResources of GroupVersion authorization.k8s.io/v1

List APIResources of GroupVersion "authorization.k8s.io/v1".

listing APIResources of GroupVersion authorization.k8s.io/v1beta1

List APIResources of GroupVersion "authorization.k8s.io/v1beta1".

listing APIResources of GroupVersion autoscaling/v1

List APIResources of GroupVersion "autoscaling/v1".

listing APIResources of GroupVersion batch/v1

List the APIResources of GroupVersion "batch/v1".

listing APIResources of GroupVersion certificates.k8s.io/v1beta1

List the GroupVersion "certificates.k8s.io/v1beta1".

listing APIResources of GroupVersion networking.k8s.io/v1

List the APIResources of GroupVersion "networking.k8s.io/v1".

listing APIResources of GroupVersion policy/v1beta1

List the APIResources of GroupVersion "policy/v1beta1".

listing APIResources of GroupVersion rbac.authorization.k8s.io/v1beta1

List the APIResources of GroupVersion "rbac.authorization.k8s.io/v1beta1".

listing APIResources of GroupVersion storage.k8s.io/v1

List APIResources of GroupVersion "storage.k8s.io/v1".

listing APIResources of GroupVersion storage.k8s.io/v1beta1

List APIResources of GroupVersion "storage.k8s.io/v1beta1".

listing APIResources of GroupVersion apiextensions.k8s.io/v1beta1

List the APIResources of GroupVersion "apiextensions.k8s.io/v1beta1".

listing APIResources of GroupVersion v1

List the APIResources of GroupVersion "v1".

Event-related APIs

Table 25 Event-related APIs

API

Description

Listing Events in a Specified Namespace

List all events in a specified namespace.