文档首页/ 华为云UCS/ API参考/ 历史API/ 配置管理/ 创建配置集合 - CreateConfigSet
更新时间：2025-12-01 GMT+08:00
查看PDF
分享

创建配置集合 - CreateConfigSet

功能介绍

创建配置集合

授权信息

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

URI

POST /v1/configsets

请求参数

表1 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

否

String

身份认证信息，调用接口的认证方式分为Token和AK/SK两种，如果您使用的Token方式，此参数为必填，请填写Token的值
表2 请求Body参数

参数

是否必选

参数类型

描述

name

是

String

配置集合的名称

namespace

是

String

命名空间

configSetType

否

String

配置集合的类型

repoName

否

String

源代码仓库名称

bucketSpec

否

Object

对象存储桶的基本信息

helmChartSpec

否

Object

Helm Chart源基本信息

gitRepositorySpec

否

GitRepositorySpec object

Git仓库源基本信息

helmRepositorySpec

否

Object

Helm仓库基本信息

kustomizationSpec

否

KustomizationSpec object

Kustomization的部署参数

clusterInfo

否

ClusterInfo object

目标集群信息

secretInfo

否

SecretInfo object

访问配置源的认证信息
表3 GitRepositorySpec

参数

是否必选

参数类型

描述

url

否

String

Git仓库地址

ref

否

GitRepositoryRef object

用于指定要解析和检出的Git引用

secretRef

否

LocalObjectReference object

包含认证信息的Secret

interval

否

String

周期性检查仓库更新的时间间隔，格式如 "1m" 表示1分钟

timeout

否

String

Git 操作（如克隆）的超时时间，默认60秒
表4 GitRepositoryRef

参数

是否必选

参数类型

描述

branch

否

String

用于指定要检出的Git分支。如果未定义其他字段，则默认检出'master'分支。
表5 LocalObjectReference

参数

是否必选

参数类型

描述

name

否

String

被引用资源的名称
表6 KustomizationSpec

参数

是否必选

参数类型

描述

path

否

String

kustomization.yaml文件的路径

interval

否

String

用于指定控制器执行 Kustomization同步与校验的时间间隔

timeout

否

String

用于定义验证、应用和健康检查操作的超时

sourceRef

否

SourceRef object

用于定义kustomization文件的源引用

targetNamespace

否

String

用于设置或覆盖kustomization.yaml文件中的命名空间

prune

否

Boolean

是否启用垃圾回收功能
表7 SourceRef

参数

是否必选

参数类型

描述

kind

是

String

被引用资源的类型，必须为 OCIRepository、GitRepository或Bucket

name

是

String

被引用资源的名称
表8 ClusterInfo

参数

是否必选

参数类型

描述

clusterID

否

String

集群ID

clusterName

否

String

集群名称

clusterPath

否

String

集群路径
表9 SecretInfo

参数

是否必选

参数类型

描述

authMode

否

String

使用的认证模式

secret

否

Object

存储了实际认证凭据的Secret

响应参数

状态码：201

表10 响应Body参数

参数

参数类型

描述

uid

String

配置集合ID

状态码：400

表11 响应Body参数

参数

参数类型

描述

-

String

-

状态码：409

表12 响应Body参数

参数

参数类型

描述

-

String

-

状态码：500

表13 响应Body参数

参数

参数类型

描述

-

String

-

请求示例

创建配置集合

POST https://ucs.myhuaweicloud.com/v1/configsets

{
  "name" : "example",
  "namespace" : "default",
  "gitRepositorySpec" : {
    "url" : "https://github.com/example/app-configs.git",
    "ref" : {
      "branch" : "master"
    },
    "interval" : "1m",
    "timeout" : "1m"
  },
  "clusterInfo" : {
    "clusterName" : "test",
    "clusterID" : "db46d87b-469e-11f0-8c47-0255ac100b09"
  },
  "repoName" : "example",
  "configSetType" : "Kustomize",
  "kustomizationSpec" : {
    "path" : "xxx",
    "interval" : "1m",
    "timeout" : "1m",
    "sourceRef" : {
      "kind" : "GitRepository",
      "name" : "example"
    },
    "targetNamespace" : "default"
  }
}

响应示例

状态码：201

配置集合创建成功

{
  "uid" : "7e1b45ef-84ab-4604-9a49-c9cba87cb1cd"
}

状态码

状态码

描述

201

配置集合创建成功

400

客户端请求错误，服务器无法执行请求

409

请求存在冲突

500

服务器内部错误

错误码

请参见错误码。

父主题： 配置管理

相关文档