Chapter 11. Cluster Init Service


11.1. Cluster Init Service

11.1.1. GenerateCRS

POST /v1/cluster-init/crs

11.1.1.1. Description

11.1.1.2. Parameters

11.1.1.2.1. Body Parameter
Expand
NameDescriptionRequiredDefaultPattern

body

V1CRSGenRequest

X

  

11.1.1.3. Return Type

V1CRSGenResponse

11.1.1.4. Content Type

  • application/json

11.1.1.5. Responses

Expand
Table 11.1. HTTP Response Codes
CodeMessageDatatype

200

A successful response.

V1CRSGenResponse

0

An unexpected error response.

GoogleRpcStatus

11.1.1.6. Samples

11.1.2. GenerateCRSExtended

POST /v1/cluster-init/crs-extended

11.1.2.1. Description

11.1.2.2. Parameters

11.1.2.2.1. Body Parameter
Expand
NameDescriptionRequiredDefaultPattern

body

V1CRSGenRequestExtended

X

  

11.1.2.3. Return Type

V1CRSGenResponse

11.1.2.4. Content Type

  • application/json

11.1.2.5. Responses

Expand
Table 11.2. HTTP Response Codes
CodeMessageDatatype

200

A successful response.

V1CRSGenResponse

0

An unexpected error response.

GoogleRpcStatus

11.1.2.6. Samples

11.1.3. GenerateInitBundle

POST /v1/cluster-init/init-bundles

Init bundles are deprecated in favor of Cluster Registration Secrets (CRS).

11.1.3.1. Description

11.1.3.2. Parameters

11.1.3.2.1. Body Parameter
Expand
NameDescriptionRequiredDefaultPattern

body

V1InitBundleGenRequest

X

  

11.1.3.3. Return Type

V1InitBundleGenResponse

11.1.3.4. Content Type

  • application/json

11.1.3.5. Responses

Expand
Table 11.3. HTTP Response Codes
CodeMessageDatatype

200

A successful response.

V1InitBundleGenResponse

0

An unexpected error response.

GoogleRpcStatus

11.1.3.6. Samples

11.1.4. GetCAConfig

GET /v1/cluster-init/ca-config

GetCAConfig is deprecated. Use operator-based installation with CRS instead.

11.1.4.1. Description

11.1.4.2. Parameters

11.1.4.3. Return Type

V1GetCAConfigResponse

11.1.4.4. Content Type

  • application/json

11.1.4.5. Responses

Expand
Table 11.4. HTTP Response Codes
CodeMessageDatatype

200

A successful response.

V1GetCAConfigResponse

0

An unexpected error response.

GoogleRpcStatus

11.1.4.6. Samples

11.1.5. GetCRSs

GET /v1/cluster-init/crs

11.1.5.1. Description

11.1.5.2. Parameters

11.1.5.3. Return Type

V1CRSMetasResponse

11.1.5.4. Content Type

  • application/json

11.1.5.5. Responses

Expand
Table 11.5. HTTP Response Codes
CodeMessageDatatype

200

A successful response.

V1CRSMetasResponse

0

An unexpected error response.

GoogleRpcStatus

11.1.5.6. Samples

11.1.6. GetInitBundles

GET /v1/cluster-init/init-bundles

Init bundles are deprecated in favor of Cluster Registration Secrets (CRS).

11.1.6.1. Description

11.1.6.2. Parameters

11.1.6.3. Return Type

V1InitBundleMetasResponse

11.1.6.4. Content Type

  • application/json

11.1.6.5. Responses

Expand
Table 11.6. HTTP Response Codes
CodeMessageDatatype

200

A successful response.

V1InitBundleMetasResponse

0

An unexpected error response.

GoogleRpcStatus

11.1.6.6. Samples

11.1.7. RevokeCRS

PATCH /v1/cluster-init/crs/revoke

RevokeCRSBundle deletes cluster registration secrets.

11.1.7.1. Description

11.1.7.2. Parameters

11.1.7.2.1. Body Parameter
Expand
NameDescriptionRequiredDefaultPattern

body

V1CRSRevokeRequest

X

  

11.1.7.3. Return Type

V1CRSRevokeResponse

11.1.7.4. Content Type

  • application/json

11.1.7.5. Responses

Expand
Table 11.7. HTTP Response Codes
CodeMessageDatatype

200

A successful response.

V1CRSRevokeResponse

0

An unexpected error response.

GoogleRpcStatus

11.1.7.6. Samples

11.1.8. RevokeInitBundle

PATCH /v1/cluster-init/init-bundles/revoke

RevokeInitBundle deletes cluster init bundle. If this operation impacts any cluster then its ID should be included in request. If confirm_impacted_clusters_ids does not match with current impacted clusters then request will fail with error that includes all impacted clusters. Init bundles are deprecated in favor of Cluster Registration Secrets (CRS).

11.1.8.1. Description

11.1.8.2. Parameters

11.1.8.2.1. Body Parameter
Expand
NameDescriptionRequiredDefaultPattern

body

V1InitBundleRevokeRequest

X

  

11.1.8.3. Return Type

V1InitBundleRevokeResponse

11.1.8.4. Content Type

  • application/json

11.1.8.5. Responses

Expand
Table 11.8. HTTP Response Codes
CodeMessageDatatype

200

A successful response.

V1InitBundleRevokeResponse

0

An unexpected error response.

GoogleRpcStatus

11.1.8.6. Samples

Red Hat logoGithubredditYoutubeTwitter

Learn

Try, buy, & sell

Communities

About Red Hat

We deliver hardened solutions that make it easier for enterprises to work across platforms and environments, from the core datacenter to the network edge.

Making open source more inclusive

Red Hat is committed to replacing problematic language in our code, documentation, and web properties. For more details, see the Red Hat Blog.

About Red Hat Documentation

Legal Notice

Theme

© 2026 Red Hat
Back to top