Skip to main content

Returns all the available clusters​

Returns all the available clusters

Path Parameters
    workspace stringrequired

    Workspace to use

Query Parameters
    owner string

    List clusters owned by specified owner

    owned string

    Set to true to only return object owned by this workspace

Responses​

A list of clusters

Schema
    apiVersion string
    items undefined[]
    apiVersion string
    kind string
    metadata

    ObjectMeta is metadata that all persisted resources must have, which includes all objects users must create.

    annotations object

    Annotations is an unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. More info: http://kubernetes.io/docs/user-guide/annotations

  • property name* string
    • clusterName string
    creationTimestamp string
    deletionGracePeriodSeconds int64
    deletionTimestamp string
    finalizers string[]
    generateName string
    generation int64
    labels object

    Map of string keys and values that can be used to organize and categorize (scope and select) objects. May match selectors of replication controllers and services. More info: http://kubernetes.io/docs/user-guide/labels

  • property name* string
    • managedFields undefined[]

    ManagedFields maps workflow-id and version to the set of fields that are managed by that workflow. This is mostly for internal housekeeping, and users typically shouldn't need to set or understand this field. A workflow can be the user's name, a controller's name, or the name of a specific apply path like "ci-cd". The set of fields is always in the version that the workflow used when modifying the object.

    apiVersion string
    fieldsType string
    fieldsV1 string
    manager string
    operation string
    subresource string
    time string
    name string
    namespace string
    ownerReferences undefined[]

    List of objects depended by this object. If ALL objects in the list have been deleted, this object will be garbage collected. If this object is managed by a controller, then an entry in this list will point to this controller, with the controller field set to true. There cannot be more than one managing controller.

    apiVersion string
    blockOwnerDeletion boolean
    controller boolean
    kind string
    name string
    uid string
    resourceVersion string
    selfLink string
    uid string
    spec

    ClusterSpec defines the desired state of a cluster

    allocation

    Allocation describes which workspaces can use this cluster.

    type string
    workspaces string[]
    channel string
    cloudAccessConfigRef

    CloudAccessConfigRef is a reference to the cloud access configuration to use when building the cluster

    name string
    namespace string
    cloudResourceName string
    description string
    enableAutoUpgrade boolean
    enablePrivateCluster boolean
    expires string
    maintenance

    Maintenance provides the details around the maintenance window

    windowDuration string
    windowStart string
    networking

    Networking provides the details around the cluster networking options

    authorizedMasterNetworks undefined[]

    AuthorizedMasterNetworks is a collection of authorized networks which is permitted to speak to the cloud kubernetes API, default to all if not provided.

    cidr string
    name string
    authorizedNetworks undefined[]

    AuthorizedNetworks is a collection of authorized networks which is permitted to speak to our authentication proxy

    cidr string
    name string
    networkPlan string
    networkProvider string
    networkRef

    NetworkRef is reference to a network where the cluster should reside

    group string
    kind string
    name string
    namespace string
    version string
    nodePools undefined[]

    NodePools is a collection of node pools associated to the cluster

    autoscaling

    Autoscaling indicates the node pool should autoscale

    enabled boolean
    maxSize int64
    minSize int64
    channel string
    cloudResourceName string
    defaultUpdateOptions

    DefaultUpdateOptions defines how this nodepool can be upgraded - Used by the cluster controller to generate NodePoolUpdates based on spec changes - Ignored when a NodePoolUpdate is created directly

    cloudUpdateStrategy string
    newReplacementConfig

    NewReplacementConfig specifies how to create a new node pool and migrate workloads to it

    nodeDrainTimeOut string
    replacementStrategy string
    description string
    diskSize int64
    expires string
    image string
    labels object

    Labels is a collection of label placed on to the nodepool

  • property name* string
    • logicalName string
    machine string
    maxPodsPerNode int64
    providerDetails

    ProviderDetails provides any cloud specific options for this nodepool

    aks

    AKS defines the cloud specific options for AKS clusters

    mode string
    eks

    EKS defines a cloud specific options for EKS clusters

    ami string
    eC2SSHKey string
    sshSourceSecurityGroups string[]
    userData string
    gke

    GKE is the provider specification for their clusters

    enableAutorepair boolean
    enableAutoupgrade boolean
    type string
    unmanaged
    size int64
    spot

    Spot if defines enables nodepool to use spot instances

    aks

    AKS defines the options for AKS spot instances

    maxSpotPrice string
    eks

    EKS provides additional options for EKS

    additionalInstanceTypes string[]
    enabled boolean
    taints undefined[]

    Taints defines a collection scheduling taints placed on the nodepool

    effect string
    key string
    value string
    version string
    zones string[]
    plan string
    provider string
    providerDetails

    ProviderDetails defines cloud specific cluster options

    aks

    AKS defines the cloud specific options for AKS clusters

    infraResourceGroupOverride string
    linuxProfile

    LinuxProfile is the configuration for Linux VMs

    adminUsername string
    sshPublicKeys string[]
    resourceGroupOverride string
    skuTier string
    windowsProfile

    WindowsProfile is the configuration for Windows VMs

    adminPassword string
    adminUsername string
    eks

    EKS defines a cloud specific options for EKS clusters

    adminARNs string[]
    cloudWatchLogging

    CloudWatchLogging allows all control plane logging to be enabled

    api boolean
    audit boolean
    authenticator boolean
    controllerManager boolean
    scheduler boolean
    enableEndpointPrivate boolean
    securityGroupIDs string[]
    gke

    GKE is the provider specification for their clusters

    enableHTTPLoadBalancer boolean
    enableHorizontalPodAutoscaler boolean
    enableShieldedNodes boolean
    enableStackDriverLogging boolean
    enableStackDriverMetrics boolean
    masterIPV4Cidr string
    type string
    unmanaged
    quotaLimits

    QuotaLimits provide defaults for quotas and limits which are critical for multi-tenancy

    default string
    templates undefined[]

    Templates provide initial defaults for Quotas and Limits for allocated namespaces used when a cluster is allocated to other workspaces to control ResourceQuotas and LimitRanges These values will result in a one time creation of: - a new cluster workspace QuotaLimit object for "constraints" per workspace (with a namespace claim) - a tenant workspace QuotaLimit object for namespace defaults per workspace Required if a cluster is allocated for any tenant workspaces

    constraints

    Constraints are for providing management of resource constraints to workloads - Typically only managed by cluster owners to provide hard resource constraints - Used to prevent noisy neigbor issues in a multi-tenanted environment

    hardQuota object

    QuotaHard are applied as ResourceQuota objects to all namespaces for a tenant of that type There are the maximun resource usage in total for a namespace e.g.: hardQuota: requests.cpu: "1" requests.memory: "1Gi" limit.cpu: "2"

  • property name* string
    • limitRanges undefined[]

    LimitRanges (in the context of constraints) are applied as LimitRanges (using Max) These are the largest values that can be used by a single resource in a namespace They will prevent workloads from using up all resources on a single node

    max object

    Max usage constraints on this kind by resource name.

  • property name* string
    • maxLimitRequestRatio object

    MaxLimitRequestRatio if specified, the named resource must have a request and limit that are both non-zero where limit divided by request is less than or equal to the enumerated value; this represents the max burst for the named resource.

  • property name* string
    • type string
    name string
    resourceDefaults undefined[]

    ResourceDefaults provide defaults for workloads (to prevent initial constraint violations) Not set directly or managed by owners (as only maximum values taken so should not conflict)

    default object

    Default resource requirement limit value by resource name if resource limit is omitted.

  • property name* string
    • defaultRequest object

    DefaultRequest is the default resource requirement request value by resource name if resource request is omitted.

  • property name* string
    • type string
    region string
    secretRef

    SecretRef is a reference to an existing secret containing an administrative access token for this cluster. Required only for clusters which are not created by Wayfinder.

    name string
    namespace string
    security

    Security contains security settings for the cluster

    podSecurityStandard

    PodSecurityStandard indicates we want to use the pod security standard

    allowed string[]
    defaultProfile string
    enabled boolean
    stage string
    version string
    status

    ClusterStatus defines the observed state of a cluster

    authProxyCertificate string
    authProxyEndpoint string
    caCertificate string
    cloudResourcesCreated boolean
    conditions undefined[]
    detail string
    lastTransitionTime string
    message string
    name string
    negativePolarity boolean
    observedGeneration int64
    reason string
    status string
    type string
    deployedAuthProxyImage string
    deployedChartsImage string
    deployedResourceHashes undefined[]

    DeployedResourceHashes is set to a hash of the resources deployed into the cluster so we can re-apply if the resources change but quickly no-op if they have not.

    hash string
    name string
    detail string
    dnsZones string[]
    expires string
    kubeApiEndpoint string
    lastReconcile
    generation int64
    time string
    lastSuccess
    generation int64
    time string
    message string
    metrics

    Metrics is a list of metrics for this cluster

    lastChecked string
    metrics undefined[]

    Metrics are the metrics of the cluster

    cpu string
    memory string
    name string
    pods string
    networkFabric

    Network contains the network configuration used by this cluster

    aws

    AWS contains the AWS-specific state for the network

    accountID string
    availabilityZoneIDs string[]
    availabilityZoneNames string[]
    ipv4EgressAddresses string[]
    privateIPV4Addresses string[]
    privateSubnetIDs string[]
    publicIPV4Addresses string[]
    publicSubnetIDs string[]
    securityGroupIDs string[]
    vpcID string
    azure

    Azure contains the Azure-specific state for the network

    subnetIDs string[]
    virtualNetworkID string
    cloudResourcesCreated boolean
    conditions undefined[]
    detail string
    lastTransitionTime string
    message string
    name string
    negativePolarity boolean
    observedGeneration int64
    reason string
    status string
    type string
    detail string
    gcp

    GCP contains the GCP-specific state for the network

    gateways undefined[]

    Gateways provides a status on the gateways and any external addresses

    addresses string[]
    location string
    name string
    name string
    networkRef string
    lastReconcile
    generation int64
    time string
    lastSuccess
    generation int64
    time string
    message string
    obsoleteResources undefined[]
    kind string
    name string
    status string
    wayfinderVersion string
    obsoleteResources undefined[]
    kind string
    name string
    providerStatus

    ProviderStatus is provider specific data with types

    aks

    AKS is the provider status for Azure

    clusterPrincipalId string
    infraResourceGroupName string
    eks

    EKS is the provider status for AWS

    oidc string
    status string
    version string
    wayfinderVersion string
    kind string
    metadata

    ListMeta describes metadata that synthetic resources must have, including lists and various status objects. A resource may have only one of {ObjectMeta, ListMeta}.

    continue string
    remainingItemCount int64
    resourceVersion string
    selfLink string
Loading...
Last updated on 28 Dec 2023