Skip to main content
Version: latest

Returns the specified EKS cloud config

GET 

/v1/cloudconfigs/eks/:configUid

Returns the specified EKS cloud config

Request​

Path Parameters

    configUid stringrequired

    Cluster's cloud config uid

Header Parameters

    ProjectUid string

    Scope the request to the specified project uid

Responses​

OK

Schema

    apiVersionstring

    APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources

    kindstring

    Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds

    metadata

    object

    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
    creationTimestampdate-time

    Time is a wrapper around time.Time which supports correct marshaling to YAML and JSON. Wrappers are provided for many of the factory methods that the time package offers.

    deletionTimestampdate-time

    Time is a wrapper around time.Time which supports correct marshaling to YAML and JSON. Wrappers are provided for many of the factory methods that the time package offers.

    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
    lastModifiedTimestampdate-time

    Time is a wrapper around time.Time which supports correct marshaling to YAML and JSON. Wrappers are provided for many of the factory methods that the time package offers.

    namestring

    Name must be unique within a namespace. Is required when creating resources, although some resources may allow a client to request the generation of an appropriate name automatically. Name is primarily intended for creation idempotence and configuration definition. Cannot be updated. More info: http://kubernetes.io/docs/user-guide/identifiers#names

    uidstring

    UID is the unique in time and space value for this object. It is typically generated by the server on successful creation of a resource and is not allowed to change on PUT operations.

    Populated by the system. Read-only. More info: http://kubernetes.io/docs/user-guide/identifiers#uids

    spec

    object

    EksCloudConfigSpec defines the cloud configuration input by user

    cloudAccountRef

    object

    ObjectReference contains enough information to let you inspect or modify the referred object.

    kindstring

    Kind of the referent. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#types-kinds

    namestring

    Name of the referent. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

    uidstring

    UID of the referent. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#uids

    clusterConfig

    object

    EksClusterConfig defines EKS specific config

    addons

    object[]

    Addons defines the EKS addons to enable with the EKS cluster. This may be required for brownfield clusters

  • Array [

  • conflictResolutionstring

    ConflictResolution is used to declare what should happen if there are parameter conflicts.

    namestringrequired

    Name is the name of the addon

    serviceAccountRoleARNstring

    ServiceAccountRoleArn is the ARN of an IAM role to bind to the addons service account

    versionstringrequired

    Version is the version of the addon to use

  • ]

  • bastionDisabledboolean

    BastionDisabled is the option to disable bastion node

    controlPlaneLoadBalancerstring

    ControlPlaneLoadBalancer specifies how API server elb will be configured, this field is optional, not provided, "", default => "Internet-facing" "Internet-facing" => "Internet-facing" "internal" => "internal" For spectro saas setup we require to talk to the apiserver from our cluster so ControlPlaneLoadBalancer should be "", not provided or "Internet-facing"

    encryptionConfig

    object

    EncryptionConfig specifies the encryption configuration for the cluster

    isEnabledboolean

    Is encryption configuration enabled for the cluster

    providerstring

    Provider specifies the ARN or alias of the CMK (in AWS KMS)

    resourcesstring[]

    Resources specifies the resources to be encrypted

    endpointAccess

    object

    Endpoints specifies access to this cluster's control plane endpoints

    privateboolean

    Private points VPC-internal control plane access to the private endpoint

    privateCIDRsstring[]

    PrivateCIDRs specifies which blocks can access the private endpoint

    publicboolean

    Public controls whether control plane endpoints are publicly accessible

    publicCIDRsstring[]

    PublicCIDRs specifies which blocks can access the public endpoint

    regionstringrequired

    The AWS Region the cluster lives in.

    sshKeyNamestring

    SSHKeyName specifies which EC2 SSH key can be used to access machines.

    vpcIdstring

    VPC Id to deploy cluster into should have one public and one private subnet for the the cluster creation, this field is optional, If VPC Id is not provided a fully managed VPC will be created

    fargateProfiles

    object[]

  • Array [

  • additionalTags

    object

    AdditionalTags is an optional set of tags to add to AWS resources managed by the AWS provider, in addition to the ones added by default.

    property name*string
    namestringrequired

    name specifies the profile name.

    selectors

    object[]

    Selectors specify fargate pod selectors.

  • Array [

  • labels

    object

    Labels specifies which pod labels this selector should match.

    property name*string
    namespacestringrequired

    Namespace specifies which namespace this selector should match.

  • ]

  • subnetIdsstring[]

    SubnetIDs specifies which subnets are used for the auto scaling group of this nodegroup.

  • ]

  • machinePoolConfig

    object[]

  • Array [

  • additionalLabels

    object

    additionalLabels

    property name*string

    additionalTags

    object

    AdditionalTags is an optional set of tags to add to resources managed by the provider, in addition to the ones added by default. For eg., tags for EKS nodeGroup or EKS NodegroupIAMRole

    property name*string

    awsLaunchTemplate

    object

    AWSLaunchTemplate specifies the launch template to use to create the managed node group

    additionalSecurityGroups

    object[]

    AdditionalSecurityGroups is an array of references to security groups that should be applied to the instances

  • Array [

  • arnstring

    ARN of resource

    filters

    object[]

    Filters is a set of key/value pairs used to identify a resource

  • Array [

  • namestring

    Name of the filter. Filter names are case-sensitive

    valuesstring[]

    Values includes one or more filter values. Filter values are case-sensitive

  • ]

  • idstring

    ID of resource

  • ]

  • ami

    object

    AMI is the reference to the AMI from which to create the machine instance

    eksOptimizedLookupTypestring

    Possible values: [AmazonLinux, AmazonLinuxGPU]

    EKSOptimizedLookupType If specified, will look up an EKS Optimized image in SSM Parameter store

    idstring

    ID of resource

    imageLookupBaseOSstring

    ImageLookupBaseOS is the name of the base operating system to use for image lookup the AMI is not set

    imageLookupFormatstring

    ImageLookupFormat is the AMI naming format to look up the image

    imageLookupOrgstring

    ImageLookupOrg is the AWS Organization ID to use for image lookup if AMI is not set

    rootVolume

    object

    Volume encapsulates the configuration options for the storage device.

    deviceNamestring

    Device name

    encryptedboolean

    EncryptionKey is the KMS key to use to encrypt the volume. Can be either a KMS key ID or ARN

    encryptionKeystring

    EncryptionKey is the KMS key to use to encrypt the volume. Can be either a KMS key ID or ARN

    iopsint64

    IOPS is the number of IOPS requested for the disk. Not applicable to all types

    throughputint64

    Throughput to provision in MiB/s supported for the volume type. Not applicable to all types.

    typestring

    Type is the type of the volume (e.g. gp2, io1, etc...)

    azsstring[]

    AZs is only used for dynamic placement

    capacityTypestring

    Possible values: [on-demand, spot]

    Default value: on-demand

    EC2 instance capacity type

    enableAwsLaunchTemplateboolean

    flag to know if aws launch template is enabled

    instanceConfig

    categorystring
    cpuSetint64
    diskGiBint64
    memoryMiBint64

    MemoryMiB is the size of a virtual machine's memory, in MiB

    namestring
    numCPUsint32

    NumCPUs is the number of virtual processors in a virtual machine

    instanceTypestring

    instance type

    isControlPlanebooleanrequired

    whether this pool is for control plane

    labelsstring[]

    labels for this pool, example: control-plane/worker, gpu, windows

    machinePoolProperties

    object

    Machine pool specific properties

    archTypestring

    Possible values: [amd64, arm64]

    Default value: amd64

    Architecture type of the pool. Default value is 'amd64'

    maxSizeint32

    max size of the pool, for scaling

    minSizeint32

    min size of the pool, for scaling

    namestring
    nodeRepaveIntervalint32

    Minimum number of seconds a node should be Ready, before the next node is selected for repave. Applicable only for workerpools in infrastructure cluster

    rootDeviceSizeint64

    rootDeviceSize in GBs

    sizeint32

    size of the pool, number of machines

    spotMarketOptions

    object

    SpotMarketOptions allows users to configure instances to be run using AWS Spot instances.

    maxPricestring

    MaxPrice defines the maximum price the user is willing to pay for Spot VM instances

    subnetIds

    object

    AZ to subnet mapping filled by ally from hubble SubnetIDs ["us-west-2d"] = "subnet-079b6061" This field is optional If we don't provide a subnetId then by default the first private subnet from the AZ will be picked up for deployment

    property name*string

    taints

    object[]

    control plane or worker taints

  • Array [

  • effectstring

    Possible values: [NoSchedule, PreferNoSchedule, NoExecute]

    keystring

    The taint key to be applied to a node

    timeAddeddate-time

    Time is a wrapper around time.Time which supports correct marshaling to YAML and JSON. Wrappers are provided for many of the factory methods that the time package offers.

    valuestring

    The taint value corresponding to the taint key.

  • ]

  • updateStrategy

    object

    rolling update strategy for this machinepool if not specified, will use ScaleOut

    typestring

    Possible values: [RollingUpdateScaleOut, RollingUpdateScaleIn]

    update strategy, either ScaleOut or ScaleIn if empty, will default to RollingUpdateScaleOut

    useControlPlaneAsWorkerboolean

    if IsControlPlane==true && useControlPlaneAsWorker==true, then will remove control plane taint this will not be used for worker pools

  • ]

Loading...