Updated on 2025-12-01 GMT+08:00

Updating a Configuration Set

Function

This API is used to update a configuration set, excluding the repository source.

URI

PUT /v1/configsets/{configsetid}

Table 1 Path Parameters

Parameter

Mandatory

Type

Description

configsetid

Yes

String

Configuration set ID

Request Parameters

Table 2 Request header parameters

Parameter

Mandatory

Type

Description

X-Auth-Token

No

String

Identity authentication information. Requests for calling an API can be authenticated using either a token or AK/SK. If token-based authentication is used, this parameter is mandatory and must be set to a user token.

Table 3 Request body parameters

Parameter

Mandatory

Type

Description

name

No

String

Name of a configuration set

namespace

No

String

Namespace

helmReleaseSpec

No

Object

Deployment Configuration Based on Helm Chart (HelmRelease Is Not Supported Currently)

kustomizationSpec

No

KustomizationSpec object

Kustomize-based Deployment Configuration

Table 4 KustomizationSpec

Parameter

Mandatory

Type

Description

path

No

String

Path of the kustomization.yaml file

interval

No

String

Interval at which the controller executes kustomization synchronization and verification

timeout

No

String

Timeout for the verification, application, and health check operations

sourceRef

No

SourceRef object

Source reference of the kustomization file

targetNamespace

No

String

Namespace to be set or overridden in the kustomization.yaml file

prune

No

Boolean

Whether to enable garbage collection

Table 5 SourceRef

Parameter

Mandatory

Type

Description

kind

Yes

String

Type of the referent. The value must be OCIRepository, GitRepository, or Bucket.

name

Yes

String

Referent name

Response Parameters

Status code: 200

Configuration set updated

None

Example Requests

Updating a configuration set

PUT https://ucs.myhuaweicloud.com/v1/configsets/{configsetid}

{
  "name" : "test",
  "namespace" : "default",
  "kustomizationSpec" : {
    "path" : "xxx",
    "interval" : "1m",
    "timeout" : "1m",
    "sourceRef" : {
      "kind" : "GitRepository",
      "name" : "test"
    },
    "targetNamespace" : "default"
  }
}

Example Responses

Status code: 200

Configuration set updated

{ }

Status Codes

Status Code

Description

200

Configuration set updated

Error Codes

See Error Codes.