文档首页/ 华为云UCS/ API参考/ API/ 配置管理/ 获取所有配置集合信息 - ListConfigSets
更新时间：2025-11-17 GMT+08:00
查看PDF
分享

获取所有配置集合信息 - ListConfigSets

功能介绍

获取所有配置集合信息

授权信息

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

URI

GET /v1/configsets

表1 Query参数

参数

是否必选

参数类型

描述

clusterid

是

String

集群id

limit

否

Integer

分页获取列表时，页的大小，默认为-1

offset

否

String

分页获取列表时，起始偏移量，默认为0

order_by

否

String

分页获取列表时，排序参数，支持create_at和update_at，默认create_at：

  • create_at：按创建时间排序

  • update_at：按更新时间排序

order

否

String

分页获取列表时，排序方向，支持desc和asc，默认desc：

  • desc：降序排序

  • asc：升序排序

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

否

String

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

响应参数

状态码：200

表3 响应Body参数

参数

参数类型

描述

items

Array of ConfigSetResponse objects

配置集合列表

total

Integer

符合查询条件的配置集合总数
表4 ConfigSetResponse

参数

参数类型

描述

uid

String

配置集合的唯一标识

name

String

配置集合的名称

namespace

String

命名空间

configSetType

String

配置集合的类型

repoName

String

仓库名称

bucket

Object

bucket基本信息

helmChart

Object

Helm Chart源基本信息

gitRepository

GitRepository object

Git仓库的定义与状态等信息

helmRepository

Object

Helm仓库的定义与状态等信息

repoStatus

String

仓库状态信息

helmRelease

Object

Helm Chart的发布配置和状态信息

kustomization

Kustomization object

Kustomize配置的定义与当前应用状态

configSetStatus

String

配置集合状态信息

clusterInfo

ClusterInfo object

集群基本信息

secretInfo

SecretInfo object

Secret信息
表5 GitRepository

参数

参数类型

描述

metadata

GitRepositoryMetaData object

资源的元数据

spec

GitRepositorySpec object

Git仓库的配置信息

status

GitRepositoryStatus object

Git仓库的状态
表6 GitRepositoryMetaData

参数

参数类型

描述

name

String

仓库名称

namespace

String

所属命名空间

uid

String

唯一标识符

resourceVersion

String

资源的内部版本标识，用于并发控制

generation

Integer

资源的期望状态的代数，每次修改spec会自增

creationTimestamp

String

创建时间

finalizers

Array of strings

删除前需要执行的清理操作

managedFields

Array of ManagedFieldsEntry objects

用于跟踪资源字段管理权，记录每个字段的管理者
表7 ManagedFieldsEntry

参数

参数类型

描述

manager

String

管理者的名称

operation

String

记录导致此条目创建的操作类型，只能是 Apply 或 Update 两种操作类型

apiVersion

String

该管理者定义字段时所依据的资源 API 版本

time

String

此管理条目被创建或最后一次更新的时间戳

fieldsType

String

固定为 "FieldsV1"，标记字段结构格式

fieldsV1

Object

用于存储实际被管理的字段信息
表8 GitRepositorySpec

参数

参数类型

描述

url

String

Git仓库地址

ref

GitRepositoryRef object

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

secretRef

LocalObjectReference object

包含认证信息的Secret

interval

String

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

timeout

String

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

参数

参数类型

描述

branch

String

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

参数

参数类型

描述

name

String

被引用资源的名称
表11 GitRepositoryStatus

参数

参数类型

描述

observedGeneration

Integer

控制器上次处理的GitRepository版本号

conditions

Array of objects

GitRepository当前的条件集合，用于表示对象的不同状态

artifact

Artifact object

最近一次成功协调生成的制品
表12 Artifact

参数

参数类型

描述

path

String

制品的相对文件路径

url

String

HTTP地址，可通过该地址下载或访问制品内容

revision

String

版本标识符

digest

String

文件摘要，格式为 <算法>:<校验值>

lastUpdateTime

String

最后更新时间

size

Integer

文件大小（以字节为单位）
表13 Kustomization

参数

参数类型

描述

metadata

KustomizationMetaData object

资源的元数据，包含名称、命名空间等信息

spec

KustomizationSpec object

用户定义Kustomization的期望状态

status

KustomizationStatus object

控制器写入的实际运行状态
表14 KustomizationMetaData

参数

参数类型

描述

name

String

Kustomization名称

namespace

String

所属命名空间

uid

String

唯一标识符

resourceVersion

String

资源的内部版本标识，用于并发控制

generation

Integer

资源的期望状态的代数，每次修改spec会自增

creationTimestamp

String

创建时间

finalizers

Array of strings

删除前需要执行的清理操作
表15 KustomizationSpec

参数

参数类型

描述

path

String

kustomization.yaml文件的路径

interval

String

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

timeout

String

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

sourceRef

SourceRef object

用于定义kustomization文件的源引用

targetNamespace

String

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

prune

Boolean

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

参数

参数类型

描述

kind

String

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

name

String

被引用资源的名称
表17 KustomizationStatus

参数

参数类型

描述

observedGeneration

Integer

最近一次成功协调的资源版本号，用于标识控制器已处理的对象代

conditions

Array of objects

当前对象的状态条件列表

lastAttemptedRevision

String

最近一次成功应用的版本号
表18 ClusterInfo

参数

参数类型

描述

clusterID

String

集群ID

clusterName

String

集群名称

clusterPath

String

集群路径
表19 SecretInfo

参数

参数类型

描述

authMode

String

使用的认证模式

secret

Object

存储了实际认证凭据的Secret

状态码：400

表20 响应Body参数

参数

参数类型

描述

-

String

状态码：403

表21 响应Body参数

参数

参数类型

描述

-

String

状态码：500

表22 响应Body参数

参数

参数类型

描述

-

String

请求示例

无

响应示例

状态码：200

获取所有配置集合信息

{
  "items" : [ {
    "name" : "config-0320-10",
    "configSetType" : "Kustomization",
    "namespace" : "default",
    "repoName" : "podinfo-repo-21",
    "gitRepository" : {
      "metadata" : {
        "name" : "podinfo-repo-21",
        "namespace" : "default",
        "uid" : "d44adb1d-6a88-4f74-92b1-f96d6d797884",
        "resourceVersion" : "6048341",
        "generation" : 1,
        "creationTimestamp" : "2023-03-20T13:49:01Z",
        "finalizers" : [ "finalizers.fluxcd.io" ]
      },
      "spec" : {
        "url" : "https://github.com/wangyuan249/podinfo",
        "secretRef" : {
          "name" : "https-ca-credentials"
        },
        "interval" : "1m0s",
        "timeout" : "1m0s",
        "ref" : {
          "branch" : "master"
        }
      },
      "status" : {
        "observedGeneration" : 1,
        "conditions" : [ {
          "type" : "Ready",
          "status" : "True",
          "observedGeneration" : 1,
          "lastTransitionTime" : "2023-03-23T23:32:54Z",
          "reason" : "Succeeded",
          "message" : "stored artifact for revision 'master/1abc44f0d8dd6cd9df76090ea4ad694b70e03ee4'"
        }, {
          "type" : "ArtifactInStorage",
          "status" : "True",
          "observedGeneration" : 1,
          "lastTransitionTime" : "2023-03-20T13:49:21Z",
          "reason" : "Succeeded",
          "message" : "stored artifact for revision 'master/1abc44f0d8dd6cd9df76090ea4ad694b70e03ee4'"
        } ],
        "artifact" : {
          "path" : "gitrepository/default/podinfo-repo-21/1abc44f0d8dd6cd9df76090ea4ad694b70e03ee4.tar.gz",
          "url" : "http://source-controller.flux-system.svc.cluster.local./gitrepository/default/podinfo-repo-21/1abc44f0d8dd6cd9df76090ea4ad694b70e03ee4.tar.gz",
          "revision" : "master/1abc44f0d8dd6cd9df76090ea4ad694b70e03ee4",
          "lastUpdateTime" : "2023-03-20T13:49:21Z",
          "size" : 92464
        }
      }
    },
    "kustomization" : {
      "metadata" : {
        "name" : "config-0320-10",
        "namespace" : "default",
        "uid" : "990eb189-e5e0-41d8-a75b-b1622d9dcc34",
        "resourceVersion" : "5098199",
        "generation" : 1,
        "creationTimestamp" : "2023-03-20T13:49:01Z",
        "finalizers" : [ "finalizers.fluxcd.io" ]
      },
      "spec" : {
        "interval" : "0s",
        "path" : "kustomize-not-found",
        "prune" : false,
        "sourceRef" : {
          "kind" : "GitRepository",
          "name" : "podinfo-repo-21"
        },
        "targetNamespace" : "default"
      },
      "status" : {
        "observedGeneration" : 1,
        "conditions" : [ {
          "type" : "Ready",
          "status" : "False",
          "lastTransitionTime" : "2023-03-22T14:48:58Z",
          "reason" : "ArtifactFailed",
          "message" : "kustomization path not found: stat /tmp/kustomization-2606438047/kustomize-not-found: no such file or directory"
        } ],
        "lastAttemptedRevision" : "master/1abc44f0d8dd6cd9df76090ea4ad694b70e03ee4"
      }
    },
    "clusterInfo" : { },
    "secretInfo" : { }
  } ],
  "total" : 1
}

状态码

状态码

描述

200

获取所有配置集合信息

400

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

403

服务器拒绝执行请求

500

服务器内部错误

错误码

请参见错误码。

父主题： 配置管理

相关文档