vmware_admin_clusters

Creates, updates, deletes, gets or lists a vmware_admin_clusters resource.

Overview

Name	vmware_admin_clusters
Type	Resource
Id	google.gkeonprem.vmware_admin_clusters

Fields

The following fields are returned by SELECT queries:

projects_locations_vmware_admin_clusters_get

Name	Datatype	Description
name	string	Immutable. The VMware admin cluster resource name.
addonNode	object	The VMware admin cluster addon node configuration. (id: VmwareAdminAddonNodeConfig)
annotations	object	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.
antiAffinityGroups	object	The VMware admin cluster anti affinity group configuration. (id: VmwareAAGConfig)
authorization	object	The VMware admin cluster authorization configuration. (id: VmwareAdminAuthorizationConfig)
autoRepairConfig	object	The VMware admin cluster auto repair configuration. (id: VmwareAutoRepairConfig)
bootstrapClusterMembership	string	The bootstrap cluster this VMware admin cluster belongs to.
controlPlaneNode	object	The VMware admin cluster control plane node configuration. (id: VmwareAdminControlPlaneNodeConfig)
createTime	string (google-datetime)	Output only. The time at which VMware admin cluster was created.
description	string	A human readable description of this VMware admin cluster.
enableAdvancedCluster	boolean	Enable advanced cluster.
endpoint	string	Output only. The DNS name of VMware admin cluster's API server.
etag	string	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.
fleet	object	Output only. Fleet configuration for the cluster. (id: Fleet)
imageType	string	The OS image type for the VMware admin cluster.
loadBalancer	object	The VMware admin cluster load balancer configuration. (id: VmwareAdminLoadBalancerConfig)
localName	string	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.
networkConfig	object	The VMware admin cluster network configuration. (id: VmwareAdminNetworkConfig)
onPremVersion	string	The Anthos clusters on the VMware version for the admin cluster.
platformConfig	object	The VMware platform configuration. (id: VmwarePlatformConfig)
preparedSecrets	object	Output only. The VMware admin cluster prepared secrets configuration. It should always be enabled by the Central API, instead of letting users set it. (id: VmwareAdminPreparedSecretsConfig)
privateRegistryConfig	object	Configuration for registry. (id: VmwareAdminPrivateRegistryConfig)
proxy	object	Configuration for proxy. (id: VmwareAdminProxy)
reconciling	boolean	Output only. If set, there are currently changes in flight to the VMware admin cluster.
state	string	Output only. The current state of VMware admin cluster. (STATE_UNSPECIFIED, PROVISIONING, RUNNING, RECONCILING, STOPPING, ERROR, DEGRADED)
status	object	Output only. ResourceStatus representing detailed cluster state. (id: ResourceStatus)
uid	string	Output only. The unique identifier of the VMware admin cluster.
updateTime	string (google-datetime)	Output only. The time at which VMware admin cluster was last updated.
validationCheck	object	Output only. ValidationCheck represents the result of the preflight check job. (id: ValidationCheck)
vcenter	object	The VMware admin cluster VCenter configuration. (id: VmwareAdminVCenterConfig)

projects_locations_vmware_admin_clusters_list

Name	Datatype	Description
name	string	Immutable. The VMware admin cluster resource name.
addonNode	object	The VMware admin cluster addon node configuration. (id: VmwareAdminAddonNodeConfig)
annotations	object	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.
antiAffinityGroups	object	The VMware admin cluster anti affinity group configuration. (id: VmwareAAGConfig)
authorization	object	The VMware admin cluster authorization configuration. (id: VmwareAdminAuthorizationConfig)
autoRepairConfig	object	The VMware admin cluster auto repair configuration. (id: VmwareAutoRepairConfig)
bootstrapClusterMembership	string	The bootstrap cluster this VMware admin cluster belongs to.
controlPlaneNode	object	The VMware admin cluster control plane node configuration. (id: VmwareAdminControlPlaneNodeConfig)
createTime	string (google-datetime)	Output only. The time at which VMware admin cluster was created.
description	string	A human readable description of this VMware admin cluster.
enableAdvancedCluster	boolean	Enable advanced cluster.
endpoint	string	Output only. The DNS name of VMware admin cluster's API server.
etag	string	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.
fleet	object	Output only. Fleet configuration for the cluster. (id: Fleet)
imageType	string	The OS image type for the VMware admin cluster.
loadBalancer	object	The VMware admin cluster load balancer configuration. (id: VmwareAdminLoadBalancerConfig)
localName	string	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.
networkConfig	object	The VMware admin cluster network configuration. (id: VmwareAdminNetworkConfig)
onPremVersion	string	The Anthos clusters on the VMware version for the admin cluster.
platformConfig	object	The VMware platform configuration. (id: VmwarePlatformConfig)
preparedSecrets	object	Output only. The VMware admin cluster prepared secrets configuration. It should always be enabled by the Central API, instead of letting users set it. (id: VmwareAdminPreparedSecretsConfig)
privateRegistryConfig	object	Configuration for registry. (id: VmwareAdminPrivateRegistryConfig)
proxy	object	Configuration for proxy. (id: VmwareAdminProxy)
reconciling	boolean	Output only. If set, there are currently changes in flight to the VMware admin cluster.
state	string	Output only. The current state of VMware admin cluster. (STATE_UNSPECIFIED, PROVISIONING, RUNNING, RECONCILING, STOPPING, ERROR, DEGRADED)
status	object	Output only. ResourceStatus representing detailed cluster state. (id: ResourceStatus)
uid	string	Output only. The unique identifier of the VMware admin cluster.
updateTime	string (google-datetime)	Output only. The time at which VMware admin cluster was last updated.
validationCheck	object	Output only. ValidationCheck represents the result of the preflight check job. (id: ValidationCheck)
vcenter	object	The VMware admin cluster VCenter configuration. (id: VmwareAdminVCenterConfig)

Methods

The following methods are available for this resource:

Name	Accessible by	Required Params	Optional Params	Description
projects_locations_vmware_admin_clusters_get	select	projectsId, locationsId, vmwareAdminClustersId	allowMissing, view	Gets details of a single VMware admin cluster.
projects_locations_vmware_admin_clusters_list	select	projectsId, locationsId	allowMissing, pageSize, pageToken, view	Lists VMware admin clusters in a given project and location.
projects_locations_vmware_admin_clusters_create	insert	projectsId, locationsId	allowPreflightFailure, skipValidations, validateOnly, vmwareAdminClusterId	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.
projects_locations_vmware_admin_clusters_patch	update	projectsId, locationsId, vmwareAdminClustersId	skipValidations, updateMask, validateOnly	Updates the parameters of a single VMware admin cluster.
projects_locations_vmware_admin_clusters_enroll	exec	projectsId, locationsId		Enrolls an existing VMware admin cluster to the Anthos On-Prem API within a given project and location. Through enrollment, an existing admin cluster will become Anthos On-Prem API managed. The corresponding GCP resources will be created and all future modifications to the cluster will be expected to be performed through the API.
projects_locations_vmware_admin_clusters_unenroll	exec	projectsId, locationsId, vmwareAdminClustersId	allowMissing, etag, ignoreErrors, validateOnly	Unenrolls an existing VMware admin cluster from the Anthos On-Prem API within a given project and location. Unenrollment removes the Cloud reference to the cluster without modifying the underlying OnPrem Resources. Clusters will continue to run; however, they will no longer be accessible through the Anthos On-Prem API or its clients.

Parameters

Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.

Name	Datatype	Description
locationsId	string
projectsId	string
vmwareAdminClustersId	string
allowMissing	boolean
allowPreflightFailure	boolean
etag	string
ignoreErrors	boolean
pageSize	integer (int32)
pageToken	string
skipValidations	string
updateMask	string (google-fieldmask)
validateOnly	boolean
view	string
vmwareAdminClusterId	string

SELECT examples

projects_locations_vmware_admin_clusters_get

Gets details of a single VMware admin cluster.

SELECT
name,
addonNode,
annotations,
antiAffinityGroups,
authorization,
autoRepairConfig,
bootstrapClusterMembership,
controlPlaneNode,
createTime,
description,
enableAdvancedCluster,
endpoint,
etag,
fleet,
imageType,
loadBalancer,
localName,
networkConfig,
onPremVersion,
platformConfig,
preparedSecrets,
privateRegistryConfig,
proxy,
reconciling,
state,
status,
uid,
updateTime,
validationCheck,
vcenter
FROM google.gkeonprem.vmware_admin_clusters
WHERE projectsId = '{{ projectsId }}' -- required
AND locationsId = '{{ locationsId }}' -- required
AND vmwareAdminClustersId = '{{ vmwareAdminClustersId }}' -- required
AND allowMissing = '{{ allowMissing }}'
AND view = '{{ view }}'
;

projects_locations_vmware_admin_clusters_list

Lists VMware admin clusters in a given project and location.

SELECT
name,
addonNode,
annotations,
antiAffinityGroups,
authorization,
autoRepairConfig,
bootstrapClusterMembership,
controlPlaneNode,
createTime,
description,
enableAdvancedCluster,
endpoint,
etag,
fleet,
imageType,
loadBalancer,
localName,
networkConfig,
onPremVersion,
platformConfig,
preparedSecrets,
privateRegistryConfig,
proxy,
reconciling,
state,
status,
uid,
updateTime,
validationCheck,
vcenter
FROM google.gkeonprem.vmware_admin_clusters
WHERE projectsId = '{{ projectsId }}' -- required
AND locationsId = '{{ locationsId }}' -- required
AND allowMissing = '{{ allowMissing }}'
AND pageSize = '{{ pageSize }}'
AND pageToken = '{{ pageToken }}'
AND view = '{{ view }}'
;

INSERT examples

projects_locations_vmware_admin_clusters_create

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.

INSERT INTO google.gkeonprem.vmware_admin_clusters (
data__addonNode,
data__annotations,
data__antiAffinityGroups,
data__authorization,
data__autoRepairConfig,
data__bootstrapClusterMembership,
data__controlPlaneNode,
data__description,
data__enableAdvancedCluster,
data__etag,
data__imageType,
data__loadBalancer,
data__name,
data__networkConfig,
data__onPremVersion,
data__platformConfig,
data__privateRegistryConfig,
data__proxy,
data__vcenter,
projectsId,
locationsId,
allowPreflightFailure,
skipValidations,
validateOnly,
vmwareAdminClusterId
)
SELECT 
'{{ addonNode }}',
'{{ annotations }}',
'{{ antiAffinityGroups }}',
'{{ authorization }}',
'{{ autoRepairConfig }}',
'{{ bootstrapClusterMembership }}',
'{{ controlPlaneNode }}',
'{{ description }}',
{{ enableAdvancedCluster }},
'{{ etag }}',
'{{ imageType }}',
'{{ loadBalancer }}',
'{{ name }}',
'{{ networkConfig }}',
'{{ onPremVersion }}',
'{{ platformConfig }}',
'{{ privateRegistryConfig }}',
'{{ proxy }}',
'{{ vcenter }}',
'{{ projectsId }}',
'{{ locationsId }}',
'{{ allowPreflightFailure }}',
'{{ skipValidations }}',
'{{ validateOnly }}',
'{{ vmwareAdminClusterId }}'
RETURNING
name,
done,
error,
metadata,
response
;

Manifest

# Description fields are for documentation purposes
- name: vmware_admin_clusters
props:
  - name: projectsId
    value: "{{ projectsId }}"
    description: Required parameter for the vmware_admin_clusters resource.
  - name: locationsId
    value: "{{ locationsId }}"
    description: Required parameter for the vmware_admin_clusters resource.
  - name: addonNode
    description: |
      The VMware admin cluster addon node configuration.
    value:
      autoResizeConfig:
        enabled: {{ enabled }}
  - name: annotations
    value: "{{ annotations }}"
    description: |
      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.
  - name: antiAffinityGroups
    description: |
      The VMware admin cluster anti affinity group configuration.
    value:
      aagConfigDisabled: {{ aagConfigDisabled }}
  - name: authorization
    description: |
      The VMware admin cluster authorization configuration.
    value:
      viewerUsers:
        - username: "{{ username }}"
  - name: autoRepairConfig
    description: |
      The VMware admin cluster auto repair configuration.
    value:
      enabled: {{ enabled }}
  - name: bootstrapClusterMembership
    value: "{{ bootstrapClusterMembership }}"
    description: |
      The bootstrap cluster this VMware admin cluster belongs to.
  - name: controlPlaneNode
    description: |
      The VMware admin cluster control plane node configuration.
    value:
      cpus: "{{ cpus }}"
      memory: "{{ memory }}"
      replicas: "{{ replicas }}"
  - name: description
    value: "{{ description }}"
    description: |
      A human readable description of this VMware admin cluster.
  - name: enableAdvancedCluster
    value: {{ enableAdvancedCluster }}
    description: |
      Enable advanced cluster.
  - name: etag
    value: "{{ etag }}"
    description: |
      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.
  - name: imageType
    value: "{{ imageType }}"
    description: |
      The OS image type for the VMware admin cluster.
  - name: loadBalancer
    description: |
      The VMware admin cluster load balancer configuration.
    value:
      f5Config:
        address: "{{ address }}"
        partition: "{{ partition }}"
        snatPool: "{{ snatPool }}"
      manualLbConfig:
        addonsNodePort: {{ addonsNodePort }}
        controlPlaneNodePort: {{ controlPlaneNodePort }}
        ingressHttpNodePort: {{ ingressHttpNodePort }}
        ingressHttpsNodePort: {{ ingressHttpsNodePort }}
        konnectivityServerNodePort: {{ konnectivityServerNodePort }}
      metalLbConfig:
        enabled: {{ enabled }}
      seesawConfig:
        enableHa: {{ enableHa }}
        group: "{{ group }}"
        ipBlocks:
          - gateway: "{{ gateway }}"
            ips: "{{ ips }}"
            netmask: "{{ netmask }}"
        masterIp: "{{ masterIp }}"
        stackdriverName: "{{ stackdriverName }}"
        vms:
          - "{{ vms }}"
      vipConfig:
        addonsVip: "{{ addonsVip }}"
        controlPlaneVip: "{{ controlPlaneVip }}"
  - name: name
    value: "{{ name }}"
    description: |
      Immutable. The VMware admin cluster resource name.
  - name: networkConfig
    description: |
      The VMware admin cluster network configuration.
    value:
      dhcpIpConfig:
        enabled: {{ enabled }}
      haControlPlaneConfig:
        controlPlaneIpBlock:
          gateway: "{{ gateway }}"
          ips:
            - hostname: "{{ hostname }}"
              ip: "{{ ip }}"
          netmask: "{{ netmask }}"
      hostConfig:
        dnsSearchDomains:
          - "{{ dnsSearchDomains }}"
        dnsServers:
          - "{{ dnsServers }}"
        ntpServers:
          - "{{ ntpServers }}"
      podAddressCidrBlocks:
        - "{{ podAddressCidrBlocks }}"
      serviceAddressCidrBlocks:
        - "{{ serviceAddressCidrBlocks }}"
      staticIpConfig:
        ipBlocks:
          - gateway: "{{ gateway }}"
            ips: "{{ ips }}"
            netmask: "{{ netmask }}"
      vcenterNetwork: "{{ vcenterNetwork }}"
  - name: onPremVersion
    value: "{{ onPremVersion }}"
    description: |
      The Anthos clusters on the VMware version for the admin cluster.
  - name: platformConfig
    description: |
      The VMware platform configuration.
    value:
      bundles:
        - status:
            conditions:
              - lastTransitionTime: "{{ lastTransitionTime }}"
                message: "{{ message }}"
                reason: "{{ reason }}"
                state: "{{ state }}"
                type: "{{ type }}"
            errorMessage: "{{ errorMessage }}"
            version: "{{ version }}"
            versions:
              versions:
                - count: "{{ count }}"
                  version: "{{ version }}"
          version: "{{ version }}"
      platformVersion: "{{ platformVersion }}"
      requiredPlatformVersion: "{{ requiredPlatformVersion }}"
      status:
        conditions:
          - lastTransitionTime: "{{ lastTransitionTime }}"
            message: "{{ message }}"
            reason: "{{ reason }}"
            state: "{{ state }}"
            type: "{{ type }}"
        errorMessage: "{{ errorMessage }}"
        version: "{{ version }}"
        versions:
          versions:
            - count: "{{ count }}"
              version: "{{ version }}"
  - name: privateRegistryConfig
    description: |
      Configuration for registry.
    value:
      address: "{{ address }}"
      caCert: "{{ caCert }}"
  - name: proxy
    description: |
      Configuration for proxy.
    value:
      noProxy: "{{ noProxy }}"
      url: "{{ url }}"
  - name: vcenter
    description: |
      The VMware admin cluster VCenter configuration.
    value:
      address: "{{ address }}"
      caCertData: "{{ caCertData }}"
      cluster: "{{ cluster }}"
      dataDisk: "{{ dataDisk }}"
      datacenter: "{{ datacenter }}"
      datastore: "{{ datastore }}"
      folder: "{{ folder }}"
      resourcePool: "{{ resourcePool }}"
      storagePolicyName: "{{ storagePolicyName }}"
  - name: allowPreflightFailure
    value: {{ allowPreflightFailure }}
  - name: skipValidations
    value: "{{ skipValidations }}"
  - name: validateOnly
    value: {{ validateOnly }}
  - name: vmwareAdminClusterId
    value: "{{ vmwareAdminClusterId }}"

UPDATE examples

projects_locations_vmware_admin_clusters_patch

Updates the parameters of a single VMware admin cluster.

UPDATE google.gkeonprem.vmware_admin_clusters
SET 
data__addonNode = '{{ addonNode }}',
data__annotations = '{{ annotations }}',
data__antiAffinityGroups = '{{ antiAffinityGroups }}',
data__authorization = '{{ authorization }}',
data__autoRepairConfig = '{{ autoRepairConfig }}',
data__bootstrapClusterMembership = '{{ bootstrapClusterMembership }}',
data__controlPlaneNode = '{{ controlPlaneNode }}',
data__description = '{{ description }}',
data__enableAdvancedCluster = {{ enableAdvancedCluster }},
data__etag = '{{ etag }}',
data__imageType = '{{ imageType }}',
data__loadBalancer = '{{ loadBalancer }}',
data__name = '{{ name }}',
data__networkConfig = '{{ networkConfig }}',
data__onPremVersion = '{{ onPremVersion }}',
data__platformConfig = '{{ platformConfig }}',
data__privateRegistryConfig = '{{ privateRegistryConfig }}',
data__proxy = '{{ proxy }}',
data__vcenter = '{{ vcenter }}'
WHERE 
projectsId = '{{ projectsId }}' --required
AND locationsId = '{{ locationsId }}' --required
AND vmwareAdminClustersId = '{{ vmwareAdminClustersId }}' --required
AND skipValidations = '{{ skipValidations}}'
AND updateMask = '{{ updateMask}}'
AND validateOnly = {{ validateOnly}}
RETURNING
name,
done,
error,
metadata,
response;

Lifecycle Methods

projects_locations_vmware_admin_clusters_enroll

Enrolls an existing VMware admin cluster to the Anthos On-Prem API within a given project and location. Through enrollment, an existing admin cluster will become Anthos On-Prem API managed. The corresponding GCP resources will be created and all future modifications to the cluster will be expected to be performed through the API.

EXEC google.gkeonprem.vmware_admin_clusters.projects_locations_vmware_admin_clusters_enroll 
@projectsId='{{ projectsId }}' --required, 
@locationsId='{{ locationsId }}' --required 
@@json=
'{
"membership": "{{ membership }}", 
"vmwareAdminClusterId": "{{ vmwareAdminClusterId }}"
}'
;

projects_locations_vmware_admin_clusters_unenroll

Unenrolls an existing VMware admin cluster from the Anthos On-Prem API within a given project and location. Unenrollment removes the Cloud reference to the cluster without modifying the underlying OnPrem Resources. Clusters will continue to run; however, they will no longer be accessible through the Anthos On-Prem API or its clients.

EXEC google.gkeonprem.vmware_admin_clusters.projects_locations_vmware_admin_clusters_unenroll 
@projectsId='{{ projectsId }}' --required, 
@locationsId='{{ locationsId }}' --required, 
@vmwareAdminClustersId='{{ vmwareAdminClustersId }}' --required, 
@allowMissing={{ allowMissing }}, 
@etag='{{ etag }}', 
@ignoreErrors={{ ignoreErrors }}, 
@validateOnly={{ validateOnly }}
;