Skip to main content
PATCH
Update BYOC Infrastructure
Update configuration of the BYOC infrastructure: rename it, toggle private link and load balancers, or replace its tags. The request is validated as a whole before anything is applied. If applying a field then fails in the data plane, client errors name the fields already applied, while internal errors return a generic message; retrying the same request is safe either way and converges the infrastructure to the requested state. Returns the modified infrastructure

Permission

The API key must have the control-plane:organization:manage permission.

授权

Authorization
string
header
必填

Use key ID and key secret obtained in ClickHouse Cloud console: https://clickhouse.com/docs/cloud/manage/openapi

路径参数

organizationId
string<uuid>
必填

ID of the requested organization.

byocInfrastructureId
string<uuid>
必填

ID of the requested BYOC Infrastructure

请求体

application/json
displayName
string

Human readable name for infrastructure object

Enable or disable private link connectivity on the infrastructure. Disabling is rejected while any service in the organization has active private endpoints

gcpPscSubnetId
string

GCP BYO-VPC only: customer-provided Private Service Connect NAT subnet name required to enable private link. Only accepted together with enablePrivateLink: true

enablePrivateLoadBalancer
boolean

Enable or disable the private (internal) load balancer of the infrastructure

enablePublicLoadBalancer
boolean

Enable or disable the public (internet-facing) load balancer of the infrastructure

tags
object

响应

Successful response

status
number

HTTP status code.

示例:

200

requestId
string<uuid>

Unique id assigned to every request. UUIDv4

result
object
最后修改于 2026年10月9日