文档首页/ 华为云UCS/ API参考/ API/ 容器舰队/ 创建联邦工作负载 - CreateProxyUnitedWorkload

更新时间：2025-11-17 GMT+08:00

查看PDF

创建联邦工作负载 - CreateProxyUnitedWorkload

功能介绍

创建联邦工作负载

授权信息

账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限，具体权限要求请参见权限和授权项。

URI

POST /v1/clustergroups/{clustergroupid}/unitedworkload

表1 路径参数
参数	是否必选	参数类型	描述
clustergroupid	是	String	容器舰队id

请求参数

表2 请求Header参数
参数	是否必选	参数类型	描述
X-Auth-Token	否	String	身份认证信息，调用接口的认证方式分为Token和AK/SK两种，如果您使用的Token方式，此参数为必填，请填写Token的值

表3 请求Body参数
参数	是否必选	参数类型	描述
kind	否	String	资源类型，有以下取值： Deployment：用于管理无状态应用 Service：实现服务发现和负载均衡 Ingress：管理对集群内服务的外部 HTTP/HTTPS 访问 ConfigMap：用于存储非敏感的配置数据 Secret：用于存储敏感信息 Job：用于运行一次性任务的资源 StatefulSet：用于管理有状态应用 DaemonSet：用于在每个节点上运行一个 Pod 的资源 PersistentVolumeClaim：用于请求和使用持久化存储资源的资源
apiVersion	否	String	API版本
metadata	否	ObjectMeta object	工作负载元数据
template	否	Object	要部署的应用模板
propagationPolicy	否	PropagationPolicy object	资源在多个集群间传播的策略
overridePolicy	否	OverridePolicy object	资源覆盖策略
resourceBinding	否	ResourceBinding object	资源与传播策略的绑定关系

表4 PropagationPolicy
参数	是否必选	参数类型	描述
kind	否	String	API类型，固定值“PropagationPolicy”
apiVersion	否	String	API版本
metadata	否	ObjectMeta object	基本信息
spec	否	PropagationSpec object	传播策略的具体说明

表5 PropagationSpec
参数	是否必选	参数类型	描述
resourceSelectors	否	Array of ResourceSelector objects	资源选择器，用于选择要传播的资源
propagateDeps	否	Boolean	是否自动传播引用的资源
placement	否	Placement object	定义资源传播到哪些集群的规则
priority	否	Integer	策略的优先级，默认值为0
schedulerName	否	String	调度器名称，默认值为“default-scheduler”

表6 OverridePolicy
参数	是否必选	参数类型	描述
kind	否	String	API类型，固定值“OverridePolicy”
apiVersion	否	String	API版本
spec	否	OverrideSpec object	覆盖策略的具体说明

表7 OverrideSpec
参数	是否必选	参数类型	描述
resourceSelectors	否	Array of ResourceSelector objects	资源选择器，限制该覆盖策略适用的资源类型
overriders	否	Object	将应用于资源的覆盖规则

表8 ResourceSelector
参数	是否必选	参数类型	描述
apiVersion	否	String	目标资源的API版本
kind	否	String	目标资源的类型
namespace	否	String	目标资源的名称
name	否	String	目标资源所在命名空间

表9 ResourceBinding
参数	是否必选	参数类型	描述
kind	否	String	API类型，固定值“ResourceBinding”
apiVersion	否	String	API版本
metadata	否	ObjectMeta object	资源的元数据
spec	否	ResourceBindingSpec object	表示资源绑定的期望行为
status	否	ResourceBindingStatus object	表示资源绑定的当前实际状态

**表10** ObjectMeta
参数	是否必选	参数类型	描述
uid	否	String	资源ID
name	否	String	资源名称
generateName	否	String	当未提供name时，服务器使用的前缀来生成唯一名称
namespace	否	String	命名空间
labels	否	Map<String,String>	标签
annotations	否	Map<String,String>	注解
creationTimestamp	否	String	创建时间
updateTimestamp	否	String	更新时间
resourceVersion	否	String	资源内部版本
generation	否	String	资源期望状态的代数
managedFields	否	Array of ManagedFieldsEntry objects	记录哪些字段由哪些工作流管理
ownerReferences	否	Array of OwnerReference objects	用于定义对象间所有权关系，管理对象的依赖关系和垃圾回收机制，支持控制器对资源的管理

**表11** ManagedFieldsEntry
参数	是否必选	参数类型	描述
manager	否	String	管理者的名称
operation	否	String	记录导致此条目创建的操作类型，只能是 Apply 或 Update 两种操作类型
apiVersion	否	String	该管理者定义字段时所依据的资源 API 版本
time	否	String	此管理条目被创建或最后一次更新的时间戳
fieldsType	否	String	固定为 "FieldsV1"，标记字段结构格式
fieldsV1	否	Object	用于存储实际被管理的字段信息

**表12** OwnerReference
参数	是否必选	参数类型	描述
apiVersion	否	String	标识引用对象的API版本
kind	否	String	引用对象的类型
name	否	String	引用对象的名称
uid	否	String	引用对象的uid
controller	否	Boolean	如果为true，表示该引用指向管理该资源的控制器
blockOwnerDeletion	否	Boolean	当为true且拥有者有名为"foregroundDeletion"的finalizer 时，会阻止拥有者被删除，直到这个引用被移除

**表13** ResourceBindingSpec
参数	是否必选	参数类型	描述
resource	否	Object	要传播的Kubernetes资源引用
propagateDeps	否	Boolean	是否自动传播相关资源
replicaRequirements	否	Object	定义每个副本的需求
replicas	否	Integer	要创建的副本数量
placement	否	Placement object	集群选择规则
clusters	否	Array of TargetCluster objects	目标成员集群列表

**表14** Placement
参数	是否必选	参数类型	描述
clusterAffinity	否	ClusterAffinity object	集群亲和性规则
clusterTolerations	否	Array of Toleration objects	集群容忍规则
replicaScheduling	否	Object	定义如何在成员集群间分配副本

**表15** ClusterAffinity
参数	是否必选	参数类型	描述
clusterNames	否	Array of strings	指定要选择的集群名称列表
exclude	否	Array of strings	指定要排除的集群名称列表

**表16** Toleration
参数	是否必选	参数类型	描述
key	否	String	表示要容忍的污点键名
operator	否	String	定义Key与Value之间的关系，可选值为Exists或Equal，默认为Equal
value	否	String	表示要匹配的污点值，当Operator为Exists时，Value应为空
effect	否	String	指定要匹配的污点效果，可选值为 NoSchedule、PreferNoSchedule或NoExecute，如果为空，表示匹配所有效果
tolerationSeconds	否	String	仅对NoExecute效果有效，表示Pod能容忍污点的时间

**表17** TargetCluster
参数	是否必选	参数类型	描述
name	否	String	目标集群名称
replicas	否	String	在该集群创建的副本数

**表18** ResourceBindingStatus
参数	是否必选	参数类型	描述
schedulerObservedGeneration	否	Integer	记录调度器当前观察到的资源生成版本代数
conditions	否	Array of ConditionStatus objects	资源的各种状态条件

**表19** ConditionStatus
参数	是否必选	参数类型	描述
type	否	String	状态类型
status	否	String	状态
observedgeneration	否	Integer	状态对象的版本
lastTransitionTime	否	String	上次状态更新的时间
reason	否	String	状态原因
message	否	String	状态信息

响应参数

状态码：200

创建联邦工作负载成功

无

请求示例

创建联邦工作负载

POST https://ucs.myhuaweicloud.com/v1/clustergroups/{clustergroupid}/unitedworkload

{
  "kind" : "Deployment",
  "metadata" : {
    "name" : "test",
    "namespace" : "default"
  },
  "template" : {
    "apiVersion" : "apps/v1",
    "kind" : "Deployment",
    "metadata" : {
      "labels" : {
        "version" : "v1"
      },
      "name" : "test",
      "namespace" : "default"
    },
    "spec" : {
      "selector" : {
        "matchLabels" : {
          "app" : "test",
          "version" : "v1"
        }
      },
      "template" : {
        "metadata" : {
          "labels" : {
            "app" : "test",
            "version" : "v1"
          }
        },
        "spec" : {
          "containers" : [ {
            "name" : "nginx",
            "image" : "xxxxxx",
            "imagePullPolicy" : "IfNotPresent"
          } ],
          "terminationGracePeriodSeconds" : 30,
          "tolerations" : [ {
            "key" : "node.kubernetes.io/not-ready",
            "operator" : "Exists",
            "effect" : "NoExecute",
            "tolerationSeconds" : 300
          }, {
            "key" : "node.kubernetes.io/unreachable",
            "operator" : "Exists",
            "effect" : "NoExecute",
            "tolerationSeconds" : 300
          } ],
          "volumes" : [ ],
          "initContainers" : [ ]
        }
      },
      "serviceName" : "headless-kd3s6e",
      "replicas" : 2,
      "revisionHistoryLimit" : 10,
      "progressDeadlineSeconds" : 600
    }
  },
  "propagationPolicy" : {
    "spec" : {
      "placement" : {
        "clusterAffinity" : {
          "clusterNames" : [ ]
        },
        "replicaScheduling" : {
          "replicaSchedulingType" : "Divided",
          "replicaDivisionPreference" : "Weighted",
          "weightPreference" : {
            "dynamicWeight" : "AvailableReplicas"
          }
        }
      },
      "propagateDeps" : true
    }
  },
  "overridePolicy" : { }
}

响应示例

无

状态码

状态码	描述
200	创建联邦工作负载成功
400	客户端请求错误，服务器无法执行请求
403	服务器拒绝执行请求
404	资源不存在
500	服务器内部错误

错误码

请参见错误码。

父主题： 容器舰队

上一篇：查询联邦工作负载 - ShowProxyUnitedWorkload

下一篇：删除联邦工作负载 - DeleteProxyUnitedWorkload

意见反馈

文档内容是否对您有帮助？

有帮助没帮助

提供反馈

提交成功！非常感谢您的反馈，我们会继续努力做到更好！您可在我的云声建议查看反馈及问题处理状态。

系统繁忙，请稍后重试

在使用文档中是否遇到以下问题

内容与产品页面不一致

内容不易理解

缺失示例代码

步骤不可操作

搜不到想要的内容

缺少最佳实践

意见反馈（选填）

0/500

请至少选择一项反馈信息并填写问题反馈

字符长度不能超过500

直接提交取消

如您有其它疑问，您也可以通过华为云社区问答频道来与我们联系探讨

盘古Doer提问云社区提问