From 3899c94e919573db615d301fc83a3c11cd7fe0e2 Mon Sep 17 00:00:00 2001
From: yexinru <yexinru@huawei.com>
Date: Sat, 30 May 2026 14:07:27 +0800
Subject: [PATCH] update the UCS api yaml

---
 docs/ucs/openapi/UCS_openapi_v3.yaml | 21 ++++++++++-----------
 1 file changed, 10 insertions(+), 11 deletions(-)

diff --git a/docs/ucs/openapi/UCS_openapi_v3.yaml b/docs/ucs/openapi/UCS_openapi_v3.yaml
index 4d35f83aa..809174d09 100644
--- a/docs/ucs/openapi/UCS_openapi_v3.yaml
+++ b/docs/ucs/openapi/UCS_openapi_v3.yaml
@@ -490,9 +490,7 @@ paths:
       tags:
         - UCS Cluster
       summary: Updating a Cluster
-      description: This API is used to update a cluster. Currently, only the
-        country/city of attached clusters and on-premises clusters can be
-        updated.
+      description: This API is used to update a cluster. Currently, only the country/city of attached clusters can be updated.
       operationId: UpdateCluster
       parameters:
         - name: clusterid
@@ -2162,7 +2160,7 @@ components:
           properties:
             uid:
               type: string
-              description: 集群ID信息，仅在注册CCE导入集群时使用，其他类型集群无需填写。
+              description: Cluster ID. This parameter is used only when a CCE cluster is imported for registration. For other types of clusters, you do not need to set this parameter.
             name:
               type: string
               description: CCE cluster name or a custom cluster name (for other types of
@@ -2687,9 +2685,10 @@ components:
           type: object
           description: Cluster annotation
           properties: {}
-      description: Object Meta Data
+      description: Basic information about a cluster. Metadata is a collection of attributes.
     UpdateClusterSpec:
       type: object
+      description: Detailed description of a cluster. UCS creates or updates objects by defining or updating spec.
       properties:
         country:
           type: string
@@ -3084,13 +3083,13 @@ components:
           x-api-type: open-api
         federationUID:
           type: string
-          description: 联邦uid
+          description: Federation uid
         resourceID:
           type: string
-          description: 资源id
+          description: Resource id
         resourceName:
           type: string
-          description: 资源名字
+          description: Resource Name
         extendparam:
           type: object
           description: Extended parameter
@@ -3098,7 +3097,7 @@ components:
             type: string
         subJobs:
           type: array
-          description: 子Job
+          description: Sub Jobs
           items:
             $ref: "#/components/schemas/Job"
     JobStatus:
@@ -3112,10 +3111,10 @@ components:
           description: Job reason
         completionTime:
           type: string
-          description: Job完成时间
+          description: Job Completion Time
         startTime:
           type: string
-          description: Job开始时间
+          description: Job Start Time
     UpdateAssociatedZonesRequest:
       type: object
       properties: