Sign in

v1

latestOpenAPI 3.0.0Creative Commons Attribution 3.02026-07-1331159174.5 KB
projects

Creates a new VMware admin cluster in a given project and location. The API needs to be combined with creating a bootstrap cluster to work.

post/v1/{+parent}/vmwareAdminClusters

Path parameters

parentstring required

Required. The parent of the project and location where the cluster is created in. Format: "projects/{project}/locations/{location}"

Query parameters

allowPreflightFailureboolean

Optional. If set to true, CLM will force CCFE to persist the cluster resource in RMS when the creation fails during standalone preflight checks. In that case the subsequent create call will fail with "cluster already exists" error and hence a update cluster is required to fix the cluster.

skipValidationsstring[]

Optional. If set, skip the specified validations.

validateOnlyboolean

Validate the request without actually doing any updates.

vmwareAdminClusterIdstring

Required. User provided identifier that is used as part of the resource name; must conform to RFC-1034 and additionally restrict to lower-cased letters. This comes out roughly to: /^a-z+[a-z0-9]$/

Request body

enableAdvancedClusterboolean

Enable advanced cluster.

imageTypestring

The OS image type for the VMware admin cluster.

reconcilingboolean

Output only. If set, there are currently changes in flight to the VMware admin cluster.

descriptionstring

A human readable description of this VMware admin cluster.

onPremVersionstring

The Anthos clusters on the VMware version for the admin cluster.

uidstring

Output only. The unique identifier of the VMware admin cluster.

createTimestring google-datetime

Output only. The time at which VMware admin cluster was created.

annotationsobject

Annotations on the VMware admin cluster. This field has the same restrictions as Kubernetes annotations. The total size of all keys and values combined is limited to 256k. Key can have 2 segments: prefix (optional) and name (required), separated by a slash (/). Prefix must be a DNS subdomain. Name must be 63 characters or less, begin and end with alphanumerics, with dashes (-), underscores (_), dots (.), and alphanumerics between.

namestring

Immutable. The VMware admin cluster resource name.

localNamestring

Output only. The object name of the VMware OnPremAdminCluster custom resource. This field is used to support conflicting names when enrolling existing clusters to the API. When used as a part of cluster enrollment, this field will differ from the ID in the resource name. For new clusters, this field will match the user provided cluster name and be visible in the last component of the resource name. It is not modifiable. All users should use this name to access their cluster using gkectl or kubectl and should expect to see the local name when viewing admin cluster controller logs.

state'STATE_UNSPECIFIED' | 'PROVISIONING' | 'RUNNING' | 'RECONCILING' | 'STOPPING' | 'ERROR' | 'DEGRADED'

Output only. The current state of VMware admin cluster.

updateTimestring google-datetime

Output only. The time at which VMware admin cluster was last updated.

endpointstring

Output only. The DNS name of VMware admin cluster's API server.

bootstrapClusterMembershipstring

The bootstrap cluster this VMware admin cluster belongs to.

etagstring

This checksum is computed by the server based on the value of other fields, and may be sent on update and delete requests to ensure the client has an up-to-date value before proceeding. Allows clients to perform consistent read-modify-writes through optimistic concurrency control.

Response

Successful response