Documentation ¶
Index ¶
- type AMITypes
- type AccessConfigResponse
- type AccessDeniedException
- type AccessEntry
- type AccessPolicy
- type AccessScope
- type AccessScopeType
- type Addon
- type AddonCompatibilityDetail
- type AddonHealth
- type AddonInfo
- type AddonIssue
- type AddonIssueCode
- type AddonPodIdentityAssociations
- type AddonPodIdentityConfiguration
- type AddonStatus
- type AddonVersionInfo
- type AssociatedAccessPolicy
- type AuthenticationMode
- type AutoScalingGroup
- type BadRequestException
- type BlockStorage
- type CapacityTypes
- type Category
- type Certificate
- type ClientException
- type ClientStat
- type Cluster
- type ClusterHealth
- type ClusterIssue
- type ClusterIssueCode
- type ClusterStatus
- type Compatibility
- type ComputeConfigRequest
- type ComputeConfigResponse
- type ConfigStatus
- type ConnectorConfigProvider
- type ConnectorConfigRequest
- type ConnectorConfigResponse
- type ControlPlanePlacementRequest
- type ControlPlanePlacementResponse
- type CreateAccessConfigRequest
- type DeprecationDetail
- type EksAnywhereSubscription
- type EksAnywhereSubscriptionLicenseType
- type EksAnywhereSubscriptionStatus
- type EksAnywhereSubscriptionTerm
- type EksAnywhereSubscriptionTermUnit
- type ElasticLoadBalancing
- type EncryptionConfig
- type ErrorCode
- type ErrorDetail
- type FargateProfile
- type FargateProfileHealth
- type FargateProfileIssue
- type FargateProfileIssueCode
- type FargateProfileSelector
- type FargateProfileStatus
- type Identity
- type IdentityProviderConfig
- type IdentityProviderConfigResponse
- type Insight
- type InsightCategorySpecificSummary
- type InsightResourceDetail
- type InsightStatus
- type InsightStatusValue
- type InsightSummary
- type InsightsFilter
- type InvalidParameterException
- type InvalidRequestException
- type IpFamily
- type Issue
- type KubernetesNetworkConfigRequest
- type KubernetesNetworkConfigResponse
- type LaunchTemplateSpecification
- type LogSetup
- type LogType
- type Logging
- type MarketplaceInformation
- type NodeRepairConfig
- type Nodegroup
- type NodegroupHealth
- type NodegroupIssueCode
- type NodegroupResources
- type NodegroupScalingConfig
- type NodegroupStatus
- type NodegroupUpdateConfig
- type NotFoundException
- type OIDC
- type OidcIdentityProviderConfig
- type OidcIdentityProviderConfigRequest
- type OutpostConfigRequest
- type OutpostConfigResponse
- type PodIdentityAssociation
- type PodIdentityAssociationSummary
- type Provider
- type RemoteAccessConfig
- type RemoteNetworkConfigRequest
- type RemoteNetworkConfigResponse
- type RemoteNodeNetwork
- type RemotePodNetwork
- type ResolveConflicts
- type ResourceInUseException
- type ResourceLimitExceededException
- type ResourceNotFoundException
- type ResourcePropagationDelayException
- type ServerException
- type ServiceUnavailableException
- type StorageConfigRequest
- type StorageConfigResponse
- type SupportType
- type Taint
- type TaintEffect
- type UnsupportedAvailabilityZoneException
- type Update
- type UpdateAccessConfigRequest
- type UpdateLabelsPayload
- type UpdateParam
- type UpdateParamType
- type UpdateStatus
- type UpdateTaintsPayload
- type UpdateType
- type UpgradePolicyRequest
- type UpgradePolicyResponse
- type VpcConfigRequest
- type VpcConfigResponse
- type ZonalShiftConfigRequest
- type ZonalShiftConfigResponse
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
This section is empty.
Types ¶
type AMITypes ¶
type AMITypes string
const ( AMITypesAl2X8664 AMITypes = "AL2_x86_64" AMITypesAl2X8664Gpu AMITypes = "AL2_x86_64_GPU" AMITypesAl2Arm64 AMITypes = "AL2_ARM_64" AMITypesCustom AMITypes = "CUSTOM" AMITypesBottlerocketArm64 AMITypes = "BOTTLEROCKET_ARM_64" AMITypesBottlerocketX8664 AMITypes = "BOTTLEROCKET_x86_64" AMITypesBottlerocketArm64Nvidia AMITypes = "BOTTLEROCKET_ARM_64_NVIDIA" AMITypesBottlerocketX8664Nvidia AMITypes = "BOTTLEROCKET_x86_64_NVIDIA" AMITypesWindowsCore2019X8664 AMITypes = "WINDOWS_CORE_2019_x86_64" AMITypesWindowsFull2019X8664 AMITypes = "WINDOWS_FULL_2019_x86_64" AMITypesWindowsCore2022X8664 AMITypes = "WINDOWS_CORE_2022_x86_64" AMITypesWindowsFull2022X8664 AMITypes = "WINDOWS_FULL_2022_x86_64" AMITypesAl2023X8664Standard AMITypes = "AL2023_x86_64_STANDARD" AMITypesAl2023Arm64Standard AMITypes = "AL2023_ARM_64_STANDARD" AMITypesAl2023X8664Neuron AMITypes = "AL2023_x86_64_NEURON" AMITypesAl2023X8664Nvidia AMITypes = "AL2023_x86_64_NVIDIA" )
Enum values for AMITypes
type AccessConfigResponse ¶ added in v1.36.0
type AccessConfigResponse struct { // The current authentication mode of the cluster. AuthenticationMode AuthenticationMode // Specifies whether or not the cluster creator IAM principal was set as a cluster // admin access entry during cluster creation time. BootstrapClusterCreatorAdminPermissions *bool // contains filtered or unexported fields }
The access configuration for the cluster.
type AccessDeniedException ¶ added in v1.14.0
type AccessDeniedException struct { Message *string ErrorCodeOverride *string // contains filtered or unexported fields }
You don't have permissions to perform the requested operation. The IAM principal making the request must have at least one IAM permissions policy attached that grants the required permissions. For more information, see Access managementin the IAM User Guide.
func (*AccessDeniedException) Error ¶ added in v1.14.0
func (e *AccessDeniedException) Error() string
func (*AccessDeniedException) ErrorCode ¶ added in v1.14.0
func (e *AccessDeniedException) ErrorCode() string
func (*AccessDeniedException) ErrorFault ¶ added in v1.14.0
func (e *AccessDeniedException) ErrorFault() smithy.ErrorFault
func (*AccessDeniedException) ErrorMessage ¶ added in v1.14.0
func (e *AccessDeniedException) ErrorMessage() string
type AccessEntry ¶ added in v1.36.0
type AccessEntry struct { // The ARN of the access entry. AccessEntryArn *string // The name of your cluster. ClusterName *string // The Unix epoch timestamp at object creation. CreatedAt *time.Time // A name that you've specified in a Kubernetes RoleBinding or ClusterRoleBinding // object so that Kubernetes authorizes the principalARN access to cluster objects. KubernetesGroups []string // The Unix epoch timestamp for the last modification to the object. ModifiedAt *time.Time // The ARN of the IAM principal for the access entry. If you ever delete the IAM // principal with this ARN, the access entry isn't automatically deleted. We // recommend that you delete the access entry with an ARN for an IAM principal that // you delete. If you don't delete the access entry and ever recreate the IAM // principal, even if it has the same ARN, the access entry won't work. This is // because even though the ARN is the same for the recreated IAM principal, the // roleID or userID (you can see this with the Security Token Service // GetCallerIdentity API) is different for the recreated IAM principal than it was // for the original IAM principal. Even though you don't see the IAM principal's // roleID or userID for an access entry, Amazon EKS stores it with the access // entry. PrincipalArn *string // Metadata that assists with categorization and organization. Each tag consists // of a key and an optional value. You define both. Tags don't propagate to any // other cluster or Amazon Web Services resources. Tags map[string]string // The type of the access entry. Type *string // The name of a user that can authenticate to your cluster. Username *string // contains filtered or unexported fields }
An access entry allows an IAM principal (user or role) to access your cluster. Access entries can replace the need to maintain the aws-auth ConfigMap for authentication. For more information about access entries, see Access entriesin the Amazon EKS User Guide.
type AccessPolicy ¶ added in v1.36.0
type AccessPolicy struct { // The ARN of the access policy. Arn *string // The name of the access policy. Name *string // contains filtered or unexported fields }
An access policy includes permissions that allow Amazon EKS to authorize an IAM principal to work with Kubernetes objects on your cluster. The policies are managed by Amazon EKS, but they're not IAM policies. You can't view the permissions in the policies using the API. The permissions for many of the policies are similar to the Kubernetes cluster-admin , admin , edit , and view cluster roles. For more information about these cluster roles, see User-facing rolesin the Kubernetes documentation. To view the contents of the policies, see Access policy permissionsin the Amazon EKS User Guide.
type AccessScope ¶ added in v1.36.0
type AccessScope struct { // A Kubernetes namespace that an access policy is scoped to. A value is required // if you specified namespace for Type . Namespaces []string // The scope type of an access policy. Type AccessScopeType // contains filtered or unexported fields }
The scope of an AccessPolicy that's associated to an AccessEntry .
type AccessScopeType ¶ added in v1.36.0
type AccessScopeType string
const ( AccessScopeTypeCluster AccessScopeType = "cluster" AccessScopeTypeNamespace AccessScopeType = "namespace" )
Enum values for AccessScopeType
func (AccessScopeType) Values ¶ added in v1.36.0
func (AccessScopeType) Values() []AccessScopeType
Values returns all known values for AccessScopeType. Note that this can be expanded in the future, and so it is only as up to date as the client.
The ordering of this slice is not guaranteed to be stable across updates.
type Addon ¶ added in v0.31.0
type Addon struct { // The Amazon Resource Name (ARN) of the add-on. AddonArn *string // The name of the add-on. AddonName *string // The version of the add-on. AddonVersion *string // The name of your cluster. ClusterName *string // The configuration values that you provided. ConfigurationValues *string // The Unix epoch timestamp at object creation. CreatedAt *time.Time // An object that represents the health of the add-on. Health *AddonHealth // Information about an Amazon EKS add-on from the Amazon Web Services Marketplace. MarketplaceInformation *MarketplaceInformation // The Unix epoch timestamp for the last modification to the object. ModifiedAt *time.Time // The owner of the add-on. Owner *string // An array of Pod Identity Assocations owned by the Addon. Each EKS Pod Identity // association maps a role to a service account in a namespace in the cluster. // // For more information, see [Attach an IAM Role to an Amazon EKS add-on using Pod Identity] in the EKS User Guide. // // [Attach an IAM Role to an Amazon EKS add-on using Pod Identity]: https://docs.aws.amazon.com/eks/latest/userguide/add-ons-iam.html PodIdentityAssociations []string // The publisher of the add-on. Publisher *string // The Amazon Resource Name (ARN) of the IAM role that's bound to the Kubernetes // ServiceAccount object that the add-on uses. ServiceAccountRoleArn *string // The status of the add-on. Status AddonStatus // Metadata that assists with categorization and organization. Each tag consists // of a key and an optional value. You define both. Tags don't propagate to any // other cluster or Amazon Web Services resources. Tags map[string]string // contains filtered or unexported fields }
An Amazon EKS add-on. For more information, see Amazon EKS add-ons in the Amazon EKS User Guide.
type AddonCompatibilityDetail ¶ added in v1.55.0
type AddonCompatibilityDetail struct { // The list of compatible Amazon EKS add-on versions for the next Kubernetes // version. CompatibleVersions []string // The name of the Amazon EKS add-on. Name *string // contains filtered or unexported fields }
The summary information about the Amazon EKS add-on compatibility for the next Kubernetes version for an insight check in the UPGRADE_READINESS category.
type AddonHealth ¶ added in v0.31.0
type AddonHealth struct { // An object representing the health issues for an add-on. Issues []AddonIssue // contains filtered or unexported fields }
The health of the add-on.
type AddonInfo ¶ added in v0.31.0
type AddonInfo struct { // The name of the add-on. AddonName *string // An object representing information about available add-on versions and // compatible Kubernetes versions. AddonVersions []AddonVersionInfo // Information about the add-on from the Amazon Web Services Marketplace. MarketplaceInformation *MarketplaceInformation // The owner of the add-on. Owner *string // The publisher of the add-on. Publisher *string // The type of the add-on. Type *string // contains filtered or unexported fields }
Information about an add-on.
type AddonIssue ¶ added in v0.31.0
type AddonIssue struct { // A code that describes the type of issue. Code AddonIssueCode // A message that provides details about the issue and what might cause it. Message *string // The resource IDs of the issue. ResourceIds []string // contains filtered or unexported fields }
An issue related to an add-on.
type AddonIssueCode ¶ added in v0.31.0
type AddonIssueCode string
const ( AddonIssueCodeAccessDenied AddonIssueCode = "AccessDenied" AddonIssueCodeInternalFailure AddonIssueCode = "InternalFailure" AddonIssueCodeClusterUnreachable AddonIssueCode = "ClusterUnreachable" AddonIssueCodeInsufficientNumberOfReplicas AddonIssueCode = "InsufficientNumberOfReplicas" AddonIssueCodeConfigurationConflict AddonIssueCode = "ConfigurationConflict" AddonIssueCodeAdmissionRequestDenied AddonIssueCode = "AdmissionRequestDenied" AddonIssueCodeUnsupportedAddonModification AddonIssueCode = "UnsupportedAddonModification" AddonIssueCodeK8sResourceNotFound AddonIssueCode = "K8sResourceNotFound" AddonIssueCodeAddonSubscriptionNeeded AddonIssueCode = "AddonSubscriptionNeeded" AddonIssueCodeAddonPermissionFailure AddonIssueCode = "AddonPermissionFailure" )
Enum values for AddonIssueCode
func (AddonIssueCode) Values ¶ added in v0.31.0
func (AddonIssueCode) Values() []AddonIssueCode
Values returns all known values for AddonIssueCode. Note that this can be expanded in the future, and so it is only as up to date as the client.
The ordering of this slice is not guaranteed to be stable across updates.
type AddonPodIdentityAssociations ¶ added in v1.43.0
type AddonPodIdentityAssociations struct { // The ARN of an IAM Role. // // This member is required. RoleArn *string // The name of a Kubernetes Service Account. // // This member is required. ServiceAccount *string // contains filtered or unexported fields }
A type of Pod Identity Association owned by an Amazon EKS Add-on.
Each EKS Pod Identity Association maps a role to a service account in a namespace in the cluster.
For more information, see Attach an IAM Role to an Amazon EKS add-on using Pod Identity in the EKS User Guide.
type AddonPodIdentityConfiguration ¶ added in v1.43.0
type AddonPodIdentityConfiguration struct { // A suggested IAM Policy for the addon. RecommendedManagedPolicies []string // The Kubernetes Service Account name used by the addon. ServiceAccount *string // contains filtered or unexported fields }
Information about how to configure IAM for an Addon.
type AddonStatus ¶ added in v0.31.0
type AddonStatus string
const ( AddonStatusCreating AddonStatus = "CREATING" AddonStatusActive AddonStatus = "ACTIVE" AddonStatusCreateFailed AddonStatus = "CREATE_FAILED" AddonStatusUpdating AddonStatus = "UPDATING" AddonStatusDeleting AddonStatus = "DELETING" AddonStatusDeleteFailed AddonStatus = "DELETE_FAILED" AddonStatusDegraded AddonStatus = "DEGRADED" AddonStatusUpdateFailed AddonStatus = "UPDATE_FAILED" )
Enum values for AddonStatus
func (AddonStatus) Values ¶ added in v0.31.0
func (AddonStatus) Values() []AddonStatus
Values returns all known values for AddonStatus. Note that this can be expanded in the future, and so it is only as up to date as the client.
The ordering of this slice is not guaranteed to be stable across updates.
type AddonVersionInfo ¶ added in v0.31.0
type AddonVersionInfo struct { // The version of the add-on. AddonVersion *string // The architectures that the version supports. Architecture []string // An object representing the compatibilities of a version. Compatibilities []Compatibility // Indicates the compute type of the addon version. ComputeTypes []string // Whether the add-on requires configuration. RequiresConfiguration bool // Indicates if the Addon requires IAM Permissions to operate, such as networking // permissions. RequiresIamPermissions bool // contains filtered or unexported fields }
Information about an add-on version.
type AssociatedAccessPolicy ¶ added in v1.36.0
type AssociatedAccessPolicy struct { // The scope of the access policy. AccessScope *AccessScope // The date and time the AccessPolicy was associated with an AccessEntry . AssociatedAt *time.Time // The Unix epoch timestamp for the last modification to the object. ModifiedAt *time.Time // The ARN of the AccessPolicy . PolicyArn *string // contains filtered or unexported fields }
An access policy association.
type AuthenticationMode ¶ added in v1.36.0
type AuthenticationMode string
const ( AuthenticationModeApi AuthenticationMode = "API" AuthenticationModeApiAndConfigMap AuthenticationMode = "API_AND_CONFIG_MAP" AuthenticationModeConfigMap AuthenticationMode = "CONFIG_MAP" )
Enum values for AuthenticationMode
func (AuthenticationMode) Values ¶ added in v1.36.0
func (AuthenticationMode) Values() []AuthenticationMode
Values returns all known values for AuthenticationMode. Note that this can be expanded in the future, and so it is only as up to date as the client.
The ordering of this slice is not guaranteed to be stable across updates.
type AutoScalingGroup ¶
type AutoScalingGroup struct { // The name of the Auto Scaling group associated with an Amazon EKS managed node // group. Name *string // contains filtered or unexported fields }
An Auto Scaling group that is associated with an Amazon EKS managed node group.
type BadRequestException ¶
type BadRequestException struct { Message *string ErrorCodeOverride *string // contains filtered or unexported fields }
This exception is thrown if the request contains a semantic error. The precise meaning will depend on the API, and will be documented in the error message.
func (*BadRequestException) Error ¶
func (e *BadRequestException) Error() string
func (*BadRequestException) ErrorCode ¶
func (e *BadRequestException) ErrorCode() string
func (*BadRequestException) ErrorFault ¶
func (e *BadRequestException) ErrorFault() smithy.ErrorFault
func (*BadRequestException) ErrorMessage ¶
func (e *BadRequestException) ErrorMessage() string
type BlockStorage ¶ added in v1.53.0
type BlockStorage struct { // Indicates if the block storage capability is enabled on your EKS Auto Mode // cluster. If the block storage capability is enabled, EKS Auto Mode will create // and delete EBS volumes in your Amazon Web Services account. Enabled *bool // contains filtered or unexported fields }
Indicates the current configuration of the block storage capability on your EKS Auto Mode cluster. For example, if the capability is enabled or disabled. If the block storage capability is enabled, EKS Auto Mode will create and delete EBS volumes in your Amazon Web Services account. For more information, see EKS Auto Mode block storage capability in the EKS User Guide.
type CapacityTypes ¶ added in v0.31.0
type CapacityTypes string
const ( CapacityTypesOnDemand CapacityTypes = "ON_DEMAND" CapacityTypesSpot CapacityTypes = "SPOT" CapacityTypesCapacityBlock CapacityTypes = "CAPACITY_BLOCK" )
Enum values for CapacityTypes
func (CapacityTypes) Values ¶ added in v0.31.0
func (CapacityTypes) Values() []CapacityTypes
Values returns all known values for CapacityTypes. Note that this can be expanded in the future, and so it is only as up to date as the client.
The ordering of this slice is not guaranteed to be stable across updates.
type Category ¶ added in v1.37.0
type Category string
const (
CategoryUpgradeReadiness Category = "UPGRADE_READINESS"
)
Enum values for Category
type Certificate ¶
type Certificate struct { // The Base64-encoded certificate data required to communicate with your cluster. // Add this to the certificate-authority-data section of the kubeconfig file for // your cluster. Data *string // contains filtered or unexported fields }
An object representing the certificate-authority-data for your cluster.
type ClientException ¶
type ClientException struct { Message *string ErrorCodeOverride *string ClusterName *string NodegroupName *string AddonName *string SubscriptionId *string // contains filtered or unexported fields }
These errors are usually caused by a client action. Actions can include using an action or resource on behalf of an IAM principalthat doesn't have permissions to use the action or resource or specifying an identifier that is not valid.
func (*ClientException) Error ¶
func (e *ClientException) Error() string
func (*ClientException) ErrorCode ¶
func (e *ClientException) ErrorCode() string
func (*ClientException) ErrorFault ¶
func (e *ClientException) ErrorFault() smithy.ErrorFault
func (*ClientException) ErrorMessage ¶
func (e *ClientException) ErrorMessage() string
type ClientStat ¶ added in v1.37.0
type ClientStat struct { // The timestamp of the last request seen from the Kubernetes client. LastRequestTime *time.Time // The number of requests from the Kubernetes client seen over the last 30 days. NumberOfRequestsLast30Days int32 // The user agent of the Kubernetes client using the deprecated resource. UserAgent *string // contains filtered or unexported fields }
Details about clients using the deprecated resources.
type Cluster ¶
type Cluster struct { // The access configuration for the cluster. AccessConfig *AccessConfigResponse // The Amazon Resource Name (ARN) of the cluster. Arn *string // The certificate-authority-data for your cluster. CertificateAuthority *Certificate // A unique, case-sensitive identifier that you provide to ensure the idempotency // of the request. ClientRequestToken *string // Indicates the current configuration of the compute capability on your EKS Auto // Mode cluster. For example, if the capability is enabled or disabled. If the // compute capability is enabled, EKS Auto Mode will create and delete EC2 Managed // Instances in your Amazon Web Services account. For more information, see EKS // Auto Mode compute capability in the EKS User Guide. ComputeConfig *ComputeConfigResponse // The configuration used to connect to a cluster for registration. ConnectorConfig *ConnectorConfigResponse // The Unix epoch timestamp at object creation. CreatedAt *time.Time // The encryption configuration for the cluster. EncryptionConfig []EncryptionConfig // The endpoint for your Kubernetes API server. Endpoint *string // An object representing the health of your Amazon EKS cluster. Health *ClusterHealth // The ID of your local Amazon EKS cluster on an Amazon Web Services Outpost. This // property isn't available for an Amazon EKS cluster on the Amazon Web Services // cloud. Id *string // The identity provider information for the cluster. Identity *Identity // The Kubernetes network configuration for the cluster. KubernetesNetworkConfig *KubernetesNetworkConfigResponse // The logging configuration for your cluster. Logging *Logging // The name of your cluster. Name *string // An object representing the configuration of your local Amazon EKS cluster on an // Amazon Web Services Outpost. This object isn't available for clusters on the // Amazon Web Services cloud. OutpostConfig *OutpostConfigResponse // The platform version of your Amazon EKS cluster. For more information about // clusters deployed on the Amazon Web Services Cloud, see [Platform versions]in the Amazon EKS User // Guide . For more information about local clusters deployed on an Outpost, see [Amazon EKS local cluster platform versions] // in the Amazon EKS User Guide . // // [Platform versions]: https://docs.aws.amazon.com/eks/latest/userguide/platform-versions.html // [Amazon EKS local cluster platform versions]: https://docs.aws.amazon.com/eks/latest/userguide/eks-outposts-platform-versions.html PlatformVersion *string // The configuration in the cluster for EKS Hybrid Nodes. You can't change or // update this configuration after the cluster is created. RemoteNetworkConfig *RemoteNetworkConfigResponse // The VPC configuration used by the cluster control plane. Amazon EKS VPC // resources have specific requirements to work properly with Kubernetes. For more // information, see [Cluster VPC considerations]and [Cluster security group considerations] in the Amazon EKS User Guide. // // [Cluster security group considerations]: https://docs.aws.amazon.com/eks/latest/userguide/sec-group-reqs.html // [Cluster VPC considerations]: https://docs.aws.amazon.com/eks/latest/userguide/network_reqs.html ResourcesVpcConfig *VpcConfigResponse // The Amazon Resource Name (ARN) of the IAM role that provides permissions for // the Kubernetes control plane to make calls to Amazon Web Services API operations // on your behalf. RoleArn *string // The current status of the cluster. Status ClusterStatus // Indicates the current configuration of the block storage capability on your EKS // Auto Mode cluster. For example, if the capability is enabled or disabled. If the // block storage capability is enabled, EKS Auto Mode will create and delete EBS // volumes in your Amazon Web Services account. For more information, see EKS Auto // Mode block storage capability in the EKS User Guide. StorageConfig *StorageConfigResponse // Metadata that assists with categorization and organization. Each tag consists // of a key and an optional value. You define both. Tags don't propagate to any // other cluster or Amazon Web Services resources. Tags map[string]string // This value indicates if extended support is enabled or disabled for the cluster. // // [Learn more about EKS Extended Support in the EKS User Guide.] // // [Learn more about EKS Extended Support in the EKS User Guide.]: https://docs.aws.amazon.com/eks/latest/userguide/extended-support-control.html UpgradePolicy *UpgradePolicyResponse // The Kubernetes server version for the cluster. Version *string // The configuration for zonal shift for the cluster. ZonalShiftConfig *ZonalShiftConfigResponse // contains filtered or unexported fields }
An object representing an Amazon EKS cluster.
type ClusterHealth ¶ added in v1.22.0
type ClusterHealth struct { // An object representing the health issues of your Amazon EKS cluster. Issues []ClusterIssue // contains filtered or unexported fields }
An object representing the health of your Amazon EKS cluster.
type ClusterIssue ¶ added in v1.22.0
type ClusterIssue struct { // The error code of the issue. Code ClusterIssueCode // A description of the issue. Message *string // The resource IDs that the issue relates to. ResourceIds []string // contains filtered or unexported fields }
An issue with your Amazon EKS cluster.
type ClusterIssueCode ¶ added in v1.22.0
type ClusterIssueCode string
const ( ClusterIssueCodeAccessDenied ClusterIssueCode = "AccessDenied" ClusterIssueCodeClusterUnreachable ClusterIssueCode = "ClusterUnreachable" ClusterIssueCodeConfigurationConflict ClusterIssueCode = "ConfigurationConflict" ClusterIssueCodeInternalFailure ClusterIssueCode = "InternalFailure" ClusterIssueCodeResourceLimitExceeded ClusterIssueCode = "ResourceLimitExceeded" ClusterIssueCodeResourceNotFound ClusterIssueCode = "ResourceNotFound" ClusterIssueCodeIamRoleNotFound ClusterIssueCode = "IamRoleNotFound" ClusterIssueCodeVpcNotFound ClusterIssueCode = "VpcNotFound" ClusterIssueCodeInsufficientFreeAddresses ClusterIssueCode = "InsufficientFreeAddresses" ClusterIssueCodeEc2ServiceNotSubscribed ClusterIssueCode = "Ec2ServiceNotSubscribed" ClusterIssueCodeEc2SubnetNotFound ClusterIssueCode = "Ec2SubnetNotFound" ClusterIssueCodeEc2SecurityGroupNotFound ClusterIssueCode = "Ec2SecurityGroupNotFound" ClusterIssueCodeKmsGrantRevoked ClusterIssueCode = "KmsGrantRevoked" ClusterIssueCodeKmsKeyNotFound ClusterIssueCode = "KmsKeyNotFound" ClusterIssueCodeKmsKeyMarkedForDeletion ClusterIssueCode = "KmsKeyMarkedForDeletion" ClusterIssueCodeKmsKeyDisabled ClusterIssueCode = "KmsKeyDisabled" ClusterIssueCodeStsRegionalEndpointDisabled ClusterIssueCode = "StsRegionalEndpointDisabled" ClusterIssueCodeUnsupportedVersion ClusterIssueCode = "UnsupportedVersion" ClusterIssueCodeOther ClusterIssueCode = "Other" )
Enum values for ClusterIssueCode
func (ClusterIssueCode) Values ¶ added in v1.22.0
func (ClusterIssueCode) Values() []ClusterIssueCode
Values returns all known values for ClusterIssueCode. Note that this can be expanded in the future, and so it is only as up to date as the client.
The ordering of this slice is not guaranteed to be stable across updates.
type ClusterStatus ¶
type ClusterStatus string
const ( ClusterStatusCreating ClusterStatus = "CREATING" ClusterStatusActive ClusterStatus = "ACTIVE" ClusterStatusDeleting ClusterStatus = "DELETING" ClusterStatusFailed ClusterStatus = "FAILED" ClusterStatusUpdating ClusterStatus = "UPDATING" ClusterStatusPending ClusterStatus = "PENDING" )
Enum values for ClusterStatus
func (ClusterStatus) Values ¶ added in v0.29.0
func (ClusterStatus) Values() []ClusterStatus
Values returns all known values for ClusterStatus. Note that this can be expanded in the future, and so it is only as up to date as the client.
The ordering of this slice is not guaranteed to be stable across updates.
type Compatibility ¶ added in v0.31.0
type Compatibility struct { // The supported Kubernetes version of the cluster. ClusterVersion *string // The supported default version. DefaultVersion bool // The supported compute platform. PlatformVersions []string // contains filtered or unexported fields }
Compatibility information.
type ComputeConfigRequest ¶ added in v1.53.0
type ComputeConfigRequest struct { // Request to enable or disable the compute capability on your EKS Auto Mode // cluster. If the compute capability is enabled, EKS Auto Mode will create and // delete EC2 Managed Instances in your Amazon Web Services account. Enabled *bool // Configuration for node pools that defines the compute resources for your EKS // Auto Mode cluster. For more information, see EKS Auto Mode Node Pools in the EKS // User Guide. NodePools []string // The ARN of the IAM Role EKS will assign to EC2 Managed Instances in your EKS // Auto Mode cluster. This value cannot be changed after the compute capability of // EKS Auto Mode is enabled. For more information, see the IAM Reference in the EKS // User Guide. NodeRoleArn *string // contains filtered or unexported fields }
Request to update the configuration of the compute capability of your EKS Auto Mode cluster. For example, enable the capability. For more information, see EKS Auto Mode compute capability in the EKS User Guide.
type ComputeConfigResponse ¶ added in v1.53.0
type ComputeConfigResponse struct { // Indicates if the compute capability is enabled on your EKS Auto Mode cluster. // If the compute capability is enabled, EKS Auto Mode will create and delete EC2 // Managed Instances in your Amazon Web Services account. Enabled *bool // Indicates the current configuration of node pools in your EKS Auto Mode // cluster. For more information, see EKS Auto Mode Node Pools in the EKS User // Guide. NodePools []string // The ARN of the IAM Role EKS will assign to EC2 Managed Instances in your EKS // Auto Mode cluster. NodeRoleArn *string // contains filtered or unexported fields }
Indicates the status of the request to update the compute capability of your EKS Auto Mode cluster.
type ConfigStatus ¶ added in v1.2.0
type ConfigStatus string
const ( ConfigStatusCreating ConfigStatus = "CREATING" ConfigStatusDeleting ConfigStatus = "DELETING" ConfigStatusActive ConfigStatus = "ACTIVE" )
Enum values for ConfigStatus
func (ConfigStatus) Values ¶ added in v1.2.0
func (ConfigStatus) Values() []ConfigStatus
Values returns all known values for ConfigStatus. Note that this can be expanded in the future, and so it is only as up to date as the client.
The ordering of this slice is not guaranteed to be stable across updates.
type ConnectorConfigProvider ¶ added in v1.10.0
type ConnectorConfigProvider string
const ( ConnectorConfigProviderEksAnywhere ConnectorConfigProvider = "EKS_ANYWHERE" ConnectorConfigProviderAnthos ConnectorConfigProvider = "ANTHOS" ConnectorConfigProviderGke ConnectorConfigProvider = "GKE" ConnectorConfigProviderAks ConnectorConfigProvider = "AKS" ConnectorConfigProviderOpenshift ConnectorConfigProvider = "OPENSHIFT" ConnectorConfigProviderTanzu ConnectorConfigProvider = "TANZU" ConnectorConfigProviderRancher ConnectorConfigProvider = "RANCHER" ConnectorConfigProviderEc2 ConnectorConfigProvider = "EC2" ConnectorConfigProviderOther ConnectorConfigProvider = "OTHER" )
Enum values for ConnectorConfigProvider
func (ConnectorConfigProvider) Values ¶ added in v1.10.0
func (ConnectorConfigProvider) Values() []ConnectorConfigProvider
Values returns all known values for ConnectorConfigProvider. Note that this can be expanded in the future, and so it is only as up to date as the client.
The ordering of this slice is not guaranteed to be stable across updates.
type ConnectorConfigRequest ¶ added in v1.10.0
type ConnectorConfigRequest struct { // The cloud provider for the target cluster to connect. // // This member is required. Provider ConnectorConfigProvider // The Amazon Resource Name (ARN) of the role that is authorized to request the // connector configuration. // // This member is required. RoleArn *string // contains filtered or unexported fields }
The configuration sent to a cluster for configuration.
type ConnectorConfigResponse ¶ added in v1.10.0
type ConnectorConfigResponse struct { // A unique code associated with the cluster for registration purposes. ActivationCode *string // The expiration time of the connected cluster. The cluster's YAML file must be // applied through the native provider. ActivationExpiry *time.Time // A unique ID associated with the cluster for registration purposes. ActivationId *string // The cluster's cloud service provider. Provider *string // The Amazon Resource Name (ARN) of the role to communicate with services from // the connected Kubernetes cluster. RoleArn *string // contains filtered or unexported fields }
The full description of your connected cluster.
type ControlPlanePlacementRequest ¶ added in v1.23.0
type ControlPlanePlacementRequest struct { // The name of the placement group for the Kubernetes control plane instances. // This setting can't be changed after cluster creation. GroupName *string // contains filtered or unexported fields }
The placement configuration for all the control plane instances of your local Amazon EKS cluster on an Amazon Web Services Outpost. For more information, see Capacity considerations in the Amazon EKS User Guide.
type ControlPlanePlacementResponse ¶ added in v1.23.0
type ControlPlanePlacementResponse struct { // The name of the placement group for the Kubernetes control plane instances. GroupName *string // contains filtered or unexported fields }
The placement configuration for all the control plane instances of your local Amazon EKS cluster on an Amazon Web Services Outpost. For more information, see Capacity considerations in the Amazon EKS User Guide.
type CreateAccessConfigRequest ¶ added in v1.36.0
type CreateAccessConfigRequest struct { // The desired authentication mode for the cluster. If you create a cluster by // using the EKS API, Amazon Web Services SDKs, or CloudFormation, the default is // CONFIG_MAP . If you create the cluster by using the Amazon Web Services // Management Console, the default value is API_AND_CONFIG_MAP . AuthenticationMode AuthenticationMode // Specifies whether or not the cluster creator IAM principal was set as a cluster // admin access entry during cluster creation time. The default value is true . BootstrapClusterCreatorAdminPermissions *bool // contains filtered or unexported fields }
The access configuration information for the cluster.
type DeprecationDetail ¶ added in v1.37.0
type DeprecationDetail struct { // Details about Kubernetes clients using the deprecated resources. ClientStats []ClientStat // The newer version of the resource to migrate to if applicable. ReplacedWith *string // The version of the software where the newer resource version became available // to migrate to if applicable. StartServingReplacementVersion *string // The version of the software where the deprecated resource version will stop // being served. StopServingVersion *string // The deprecated version of the resource. Usage *string // contains filtered or unexported fields }
The summary information about deprecated resource usage for an insight check in the UPGRADE_READINESS category.
type EksAnywhereSubscription ¶ added in v1.33.0
type EksAnywhereSubscription struct { // The Amazon Resource Name (ARN) for the subscription. Arn *string // A boolean indicating whether or not a subscription will auto renew when it // expires. AutoRenew bool // The Unix timestamp in seconds for when the subscription was created. CreatedAt *time.Time // The Unix timestamp in seconds for when the subscription is effective. EffectiveDate *time.Time // The Unix timestamp in seconds for when the subscription will expire or auto // renew, depending on the auto renew configuration of the subscription object. ExpirationDate *time.Time // UUID identifying a subscription. Id *string // Amazon Web Services License Manager ARN associated with the subscription. LicenseArns []string // The number of licenses included in a subscription. Valid values are between 1 // and 100. LicenseQuantity int32 // The type of licenses included in the subscription. Valid value is CLUSTER. With // the CLUSTER license type, each license covers support for a single EKS Anywhere // cluster. LicenseType EksAnywhereSubscriptionLicenseType // The status of a subscription. Status *string // The metadata for a subscription to assist with categorization and organization. // Each tag consists of a key and an optional value. Subscription tags do not // propagate to any other resources associated with the subscription. Tags map[string]string // An EksAnywhereSubscriptionTerm object. Term *EksAnywhereSubscriptionTerm // contains filtered or unexported fields }
An EKS Anywhere subscription authorizing the customer to support for licensed clusters and access to EKS Anywhere Curated Packages.
type EksAnywhereSubscriptionLicenseType ¶ added in v1.33.0
type EksAnywhereSubscriptionLicenseType string
const (
EksAnywhereSubscriptionLicenseTypeCluster EksAnywhereSubscriptionLicenseType = "Cluster"
)
Enum values for EksAnywhereSubscriptionLicenseType
func (EksAnywhereSubscriptionLicenseType) Values ¶ added in v1.33.0
func (EksAnywhereSubscriptionLicenseType) Values() []EksAnywhereSubscriptionLicenseType
Values returns all known values for EksAnywhereSubscriptionLicenseType. Note that this can be expanded in the future, and so it is only as up to date as the client.
The ordering of this slice is not guaranteed to be stable across updates.
type EksAnywhereSubscriptionStatus ¶ added in v1.33.0
type EksAnywhereSubscriptionStatus string
const ( EksAnywhereSubscriptionStatusCreating EksAnywhereSubscriptionStatus = "CREATING" EksAnywhereSubscriptionStatusActive EksAnywhereSubscriptionStatus = "ACTIVE" EksAnywhereSubscriptionStatusUpdating EksAnywhereSubscriptionStatus = "UPDATING" EksAnywhereSubscriptionStatusExpiring EksAnywhereSubscriptionStatus = "EXPIRING" EksAnywhereSubscriptionStatusExpired EksAnywhereSubscriptionStatus = "EXPIRED" EksAnywhereSubscriptionStatusDeleting EksAnywhereSubscriptionStatus = "DELETING" )
Enum values for EksAnywhereSubscriptionStatus
func (EksAnywhereSubscriptionStatus) Values ¶ added in v1.33.0
func (EksAnywhereSubscriptionStatus) Values() []EksAnywhereSubscriptionStatus
Values returns all known values for EksAnywhereSubscriptionStatus. Note that this can be expanded in the future, and so it is only as up to date as the client.
The ordering of this slice is not guaranteed to be stable across updates.
type EksAnywhereSubscriptionTerm ¶ added in v1.33.0
type EksAnywhereSubscriptionTerm struct { // The duration of the subscription term. Valid values are 12 and 36, indicating a // 12 month or 36 month subscription. Duration int32 // The term unit of the subscription. Valid value is MONTHS . Unit EksAnywhereSubscriptionTermUnit // contains filtered or unexported fields }
An object representing the term duration and term unit type of your subscription. This determines the term length of your subscription. Valid values are MONTHS for term unit and 12 or 36 for term duration, indicating a 12 month or 36 month subscription.
type EksAnywhereSubscriptionTermUnit ¶ added in v1.33.0
type EksAnywhereSubscriptionTermUnit string
const (
EksAnywhereSubscriptionTermUnitMonths EksAnywhereSubscriptionTermUnit = "MONTHS"
)
Enum values for EksAnywhereSubscriptionTermUnit
func (EksAnywhereSubscriptionTermUnit) Values ¶ added in v1.33.0
func (EksAnywhereSubscriptionTermUnit) Values() []EksAnywhereSubscriptionTermUnit
Values returns all known values for EksAnywhereSubscriptionTermUnit. Note that this can be expanded in the future, and so it is only as up to date as the client.
The ordering of this slice is not guaranteed to be stable across updates.
type ElasticLoadBalancing ¶ added in v1.53.0
type ElasticLoadBalancing struct { // Indicates if the load balancing capability is enabled on your EKS Auto Mode // cluster. If the load balancing capability is enabled, EKS Auto Mode will create // and delete load balancers in your Amazon Web Services account. Enabled *bool // contains filtered or unexported fields }
Indicates the current configuration of the load balancing capability on your EKS Auto Mode cluster. For example, if the capability is enabled or disabled. For more information, see EKS Auto Mode load balancing capability in the EKS User Guide.
type EncryptionConfig ¶
type EncryptionConfig struct { // Key Management Service (KMS) key. Either the ARN or the alias can be used. Provider *Provider // Specifies the resources to be encrypted. The only supported value is secrets . Resources []string // contains filtered or unexported fields }
The encryption configuration for the cluster.
type ErrorCode ¶
type ErrorCode string
const ( ErrorCodeSubnetNotFound ErrorCode = "SubnetNotFound" ErrorCodeSecurityGroupNotFound ErrorCode = "SecurityGroupNotFound" ErrorCodeEniLimitReached ErrorCode = "EniLimitReached" ErrorCodeIpNotAvailable ErrorCode = "IpNotAvailable" ErrorCodeAccessDenied ErrorCode = "AccessDenied" ErrorCodeOperationNotPermitted ErrorCode = "OperationNotPermitted" ErrorCodeVpcIdNotFound ErrorCode = "VpcIdNotFound" ErrorCodeUnknown ErrorCode = "Unknown" ErrorCodeNodeCreationFailure ErrorCode = "NodeCreationFailure" ErrorCodePodEvictionFailure ErrorCode = "PodEvictionFailure" ErrorCodeInsufficientFreeAddresses ErrorCode = "InsufficientFreeAddresses" ErrorCodeClusterUnreachable ErrorCode = "ClusterUnreachable" ErrorCodeInsufficientNumberOfReplicas ErrorCode = "InsufficientNumberOfReplicas" ErrorCodeConfigurationConflict ErrorCode = "ConfigurationConflict" ErrorCodeAdmissionRequestDenied ErrorCode = "AdmissionRequestDenied" ErrorCodeUnsupportedAddonModification ErrorCode = "UnsupportedAddonModification" ErrorCodeK8sResourceNotFound ErrorCode = "K8sResourceNotFound" )
Enum values for ErrorCode
type ErrorDetail ¶
type ErrorDetail struct { // A brief description of the error. // // - SubnetNotFound: We couldn't find one of the subnets associated with the // cluster. // // - SecurityGroupNotFound: We couldn't find one of the security groups // associated with the cluster. // // - EniLimitReached: You have reached the elastic network interface limit for // your account. // // - IpNotAvailable: A subnet associated with the cluster doesn't have any // available IP addresses. // // - AccessDenied: You don't have permissions to perform the specified operation. // // - OperationNotPermitted: The service role associated with the cluster doesn't // have the required access permissions for Amazon EKS. // // - VpcIdNotFound: We couldn't find the VPC associated with the cluster. ErrorCode ErrorCode // A more complete description of the error. ErrorMessage *string // An optional field that contains the resource IDs associated with the error. ResourceIds []string // contains filtered or unexported fields }
An object representing an error when an asynchronous operation fails.
type FargateProfile ¶
type FargateProfile struct { // The name of your cluster. ClusterName *string // The Unix epoch timestamp at object creation. CreatedAt *time.Time // The full Amazon Resource Name (ARN) of the Fargate profile. FargateProfileArn *string // The name of the Fargate profile. FargateProfileName *string // The health status of the Fargate profile. If there are issues with your Fargate // profile's health, they are listed here. Health *FargateProfileHealth // The Amazon Resource Name (ARN) of the Pod execution role to use for any Pod // that matches the selectors in the Fargate profile. For more information, see [Pod execution role]Pod // in the Amazon EKS User Guide. // // [Pod execution role]: https://docs.aws.amazon.com/eks/latest/userguide/pod-execution-role.html PodExecutionRoleArn *string // The selectors to match for a Pod to use this Fargate profile. Selectors []FargateProfileSelector // The current status of the Fargate profile. Status FargateProfileStatus // The IDs of subnets to launch a Pod into. Subnets []string // Metadata that assists with categorization and organization. Each tag consists // of a key and an optional value. You define both. Tags don't propagate to any // other cluster or Amazon Web Services resources. Tags map[string]string // contains filtered or unexported fields }
An object representing an Fargate profile.
type FargateProfileHealth ¶ added in v1.44.0
type FargateProfileHealth struct { // Any issues that are associated with the Fargate profile. Issues []FargateProfileIssue // contains filtered or unexported fields }
The health status of the Fargate profile. If there are issues with your Fargate profile's health, they are listed here.
type FargateProfileIssue ¶ added in v1.44.0
type FargateProfileIssue struct { // A brief description of the error. Code FargateProfileIssueCode // The error message associated with the issue. Message *string // The Amazon Web Services resources that are affected by this issue. ResourceIds []string // contains filtered or unexported fields }
An issue that is associated with the Fargate profile.
type FargateProfileIssueCode ¶ added in v1.44.0
type FargateProfileIssueCode string
const ( FargateProfileIssueCodePodExecutionRoleAlreadyInUse FargateProfileIssueCode = "PodExecutionRoleAlreadyInUse" FargateProfileIssueCodeAccessDenied FargateProfileIssueCode = "AccessDenied" FargateProfileIssueCodeClusterUnreachable FargateProfileIssueCode = "ClusterUnreachable" FargateProfileIssueCodeInternalFailure FargateProfileIssueCode = "InternalFailure" )
Enum values for FargateProfileIssueCode
func (FargateProfileIssueCode) Values ¶ added in v1.44.0
func (FargateProfileIssueCode) Values() []FargateProfileIssueCode
Values returns all known values for FargateProfileIssueCode. Note that this can be expanded in the future, and so it is only as up to date as the client.
The ordering of this slice is not guaranteed to be stable across updates.
type FargateProfileSelector ¶
type FargateProfileSelector struct { // The Kubernetes labels that the selector should match. A pod must contain all of // the labels that are specified in the selector for it to be considered a match. Labels map[string]string // The Kubernetes namespace that the selector should match. Namespace *string // contains filtered or unexported fields }
An object representing an Fargate profile selector.
type FargateProfileStatus ¶
type FargateProfileStatus string
const ( FargateProfileStatusCreating FargateProfileStatus = "CREATING" FargateProfileStatusActive FargateProfileStatus = "ACTIVE" FargateProfileStatusDeleting FargateProfileStatus = "DELETING" FargateProfileStatusCreateFailed FargateProfileStatus = "CREATE_FAILED" FargateProfileStatusDeleteFailed FargateProfileStatus = "DELETE_FAILED" )
Enum values for FargateProfileStatus
func (FargateProfileStatus) Values ¶ added in v0.29.0
func (FargateProfileStatus) Values() []FargateProfileStatus
Values returns all known values for FargateProfileStatus. Note that this can be expanded in the future, and so it is only as up to date as the client.
The ordering of this slice is not guaranteed to be stable across updates.
type Identity ¶
type Identity struct { // An object representing the [OpenID Connect] identity provider information. // // [OpenID Connect]: https://openid.net/connect/ Oidc *OIDC // contains filtered or unexported fields }
An object representing an identity provider.
type IdentityProviderConfig ¶ added in v1.2.0
type IdentityProviderConfig struct { // The name of the identity provider configuration. // // This member is required. Name *string // The type of the identity provider configuration. The only type available is oidc // . // // This member is required. Type *string // contains filtered or unexported fields }
An object representing an identity provider configuration.
type IdentityProviderConfigResponse ¶ added in v1.2.0
type IdentityProviderConfigResponse struct { // An object representing an OpenID Connect (OIDC) identity provider configuration. Oidc *OidcIdentityProviderConfig // contains filtered or unexported fields }
The full description of your identity configuration.
type Insight ¶ added in v1.37.0
type Insight struct { // Links to sources that provide additional context on the insight. AdditionalInfo map[string]string // The category of the insight. Category Category // Summary information that relates to the category of the insight. Currently only // returned with certain insights having category UPGRADE_READINESS . CategorySpecificSummary *InsightCategorySpecificSummary // The description of the insight which includes alert criteria, remediation // recommendation, and additional resources (contains Markdown). Description *string // The ID of the insight. Id *string // An object containing more detail on the status of the insight resource. InsightStatus *InsightStatus // The Kubernetes minor version associated with an insight if applicable. KubernetesVersion *string // The time Amazon EKS last successfully completed a refresh of this insight check // on the cluster. LastRefreshTime *time.Time // The time the status of the insight last changed. LastTransitionTime *time.Time // The name of the insight. Name *string // A summary of how to remediate the finding of this insight if applicable. Recommendation *string // The details about each resource listed in the insight check result. Resources []InsightResourceDetail // contains filtered or unexported fields }
A check that provides recommendations to remedy potential upgrade-impacting issues.
type InsightCategorySpecificSummary ¶ added in v1.37.0
type InsightCategorySpecificSummary struct { // A list of AddonCompatibilityDetail objects for Amazon EKS add-ons. AddonCompatibilityDetails []AddonCompatibilityDetail // The summary information about deprecated resource usage for an insight check in // the UPGRADE_READINESS category. DeprecationDetails []DeprecationDetail // contains filtered or unexported fields }
Summary information that relates to the category of the insight. Currently only returned with certain insights having category UPGRADE_READINESS .
type InsightResourceDetail ¶ added in v1.37.0
type InsightResourceDetail struct { // The Amazon Resource Name (ARN) if applicable. Arn *string // An object containing more detail on the status of the insight resource. InsightStatus *InsightStatus // The Kubernetes resource URI if applicable. KubernetesResourceUri *string // contains filtered or unexported fields }
Returns information about the resource being evaluated.
type InsightStatus ¶ added in v1.37.0
type InsightStatus struct { // Explanation on the reasoning for the status of the resource. Reason *string // The status of the resource. Status InsightStatusValue // contains filtered or unexported fields }
The status of the insight.
type InsightStatusValue ¶ added in v1.37.0
type InsightStatusValue string
const ( InsightStatusValuePassing InsightStatusValue = "PASSING" InsightStatusValueWarning InsightStatusValue = "WARNING" InsightStatusValueError InsightStatusValue = "ERROR" InsightStatusValueUnknown InsightStatusValue = "UNKNOWN" )
Enum values for InsightStatusValue
func (InsightStatusValue) Values ¶ added in v1.37.0
func (InsightStatusValue) Values() []InsightStatusValue
Values returns all known values for InsightStatusValue. Note that this can be expanded in the future, and so it is only as up to date as the client.
The ordering of this slice is not guaranteed to be stable across updates.
type InsightSummary ¶ added in v1.37.0
type InsightSummary struct { // The category of the insight. Category Category // The description of the insight which includes alert criteria, remediation // recommendation, and additional resources (contains Markdown). Description *string // The ID of the insight. Id *string // An object containing more detail on the status of the insight. InsightStatus *InsightStatus // The Kubernetes minor version associated with an insight if applicable. KubernetesVersion *string // The time Amazon EKS last successfully completed a refresh of this insight check // on the cluster. LastRefreshTime *time.Time // The time the status of the insight last changed. LastTransitionTime *time.Time // The name of the insight. Name *string // contains filtered or unexported fields }
The summarized description of the insight.
type InsightsFilter ¶ added in v1.37.0
type InsightsFilter struct { // The categories to use to filter insights. Categories []Category // The Kubernetes versions to use to filter the insights. KubernetesVersions []string // The statuses to use to filter the insights. Statuses []InsightStatusValue // contains filtered or unexported fields }
The criteria to use for the insights.
type InvalidParameterException ¶
type InvalidParameterException struct { Message *string ErrorCodeOverride *string ClusterName *string NodegroupName *string FargateProfileName *string AddonName *string SubscriptionId *string // contains filtered or unexported fields }
The specified parameter is invalid. Review the available parameters for the API request.
func (*InvalidParameterException) Error ¶
func (e *InvalidParameterException) Error() string
func (*InvalidParameterException) ErrorCode ¶
func (e *InvalidParameterException) ErrorCode() string
func (*InvalidParameterException) ErrorFault ¶
func (e *InvalidParameterException) ErrorFault() smithy.ErrorFault
func (*InvalidParameterException) ErrorMessage ¶
func (e *InvalidParameterException) ErrorMessage() string
type InvalidRequestException ¶
type InvalidRequestException struct { Message *string ErrorCodeOverride *string ClusterName *string NodegroupName *string AddonName *string SubscriptionId *string // contains filtered or unexported fields }
The request is invalid given the state of the cluster. Check the state of the cluster and the associated operations.
func (*InvalidRequestException) Error ¶
func (e *InvalidRequestException) Error() string
func (*InvalidRequestException) ErrorCode ¶
func (e *InvalidRequestException) ErrorCode() string
func (*InvalidRequestException) ErrorFault ¶
func (e *InvalidRequestException) ErrorFault() smithy.ErrorFault
func (*InvalidRequestException) ErrorMessage ¶
func (e *InvalidRequestException) ErrorMessage() string
type Issue ¶
type Issue struct { // A brief description of the error. // // - AccessDenied: Amazon EKS or one or more of your managed nodes is failing to // authenticate or authorize with your Kubernetes cluster API server. // // - AsgInstanceLaunchFailures: Your Auto Scaling group is experiencing failures // while attempting to launch instances. // // - AutoScalingGroupNotFound: We couldn't find the Auto Scaling group // associated with the managed node group. You may be able to recreate an Auto // Scaling group with the same settings to recover. // // - ClusterUnreachable: Amazon EKS or one or more of your managed nodes is // unable to to communicate with your Kubernetes cluster API server. This can // happen if there are network disruptions or if API servers are timing out // processing requests. // // - Ec2InstanceTypeDoesNotExist: One or more of the supplied Amazon EC2 // instance types do not exist. Amazon EKS checked for the instance types that you // provided in this Amazon Web Services Region, and one or more aren't available. // // - Ec2LaunchTemplateNotFound: We couldn't find the Amazon EC2 launch template // for your managed node group. You may be able to recreate a launch template with // the same settings to recover. // // - Ec2LaunchTemplateVersionMismatch: The Amazon EC2 launch template version // for your managed node group does not match the version that Amazon EKS created. // You may be able to revert to the version that Amazon EKS created to recover. // // - Ec2SecurityGroupDeletionFailure: We could not delete the remote access // security group for your managed node group. Remove any dependencies from the // security group. // // - Ec2SecurityGroupNotFound: We couldn't find the cluster security group for // the cluster. You must recreate your cluster. // // - Ec2SubnetInvalidConfiguration: One or more Amazon EC2 subnets specified for // a node group do not automatically assign public IP addresses to instances // launched into it. If you want your instances to be assigned a public IP address, // then you need to enable the auto-assign public IP address setting for the // subnet. See [Modifying the public IPv4 addressing attribute for your subnet]IPv4 in the Amazon VPC User Guide. // // - IamInstanceProfileNotFound: We couldn't find the IAM instance profile for // your managed node group. You may be able to recreate an instance profile with // the same settings to recover. // // - IamNodeRoleNotFound: We couldn't find the IAM role for your managed node // group. You may be able to recreate an IAM role with the same settings to // recover. // // - InstanceLimitExceeded: Your Amazon Web Services account is unable to launch // any more instances of the specified instance type. You may be able to request an // Amazon EC2 instance limit increase to recover. // // - InsufficientFreeAddresses: One or more of the subnets associated with your // managed node group does not have enough available IP addresses for new nodes. // // - InternalFailure: These errors are usually caused by an Amazon EKS // server-side issue. // // - NodeCreationFailure: Your launched instances are unable to register with // your Amazon EKS cluster. Common causes of this failure are insufficient [node IAM role] // permissions or lack of outbound internet access for the nodes. // // [Modifying the public IPv4 addressing attribute for your subnet]: https://docs.aws.amazon.com/vpc/latest/userguide/vpc-ip-addressing.html#subnet-public-ip // [node IAM role]: https://docs.aws.amazon.com/eks/latest/userguide/create-node-role.html Code NodegroupIssueCode // The error message associated with the issue. Message *string // The Amazon Web Services resources that are afflicted by this issue. ResourceIds []string // contains filtered or unexported fields }
An object representing an issue with an Amazon EKS resource.
type KubernetesNetworkConfigRequest ¶ added in v0.29.0
type KubernetesNetworkConfigRequest struct { // Request to enable or disable the load balancing capability on your EKS Auto // Mode cluster. For more information, see EKS Auto Mode load balancing capability // in the EKS User Guide. ElasticLoadBalancing *ElasticLoadBalancing // Specify which IP family is used to assign Kubernetes pod and service IP // addresses. If you don't specify a value, ipv4 is used by default. You can only // specify an IP family when you create a cluster and can't change this value once // the cluster is created. If you specify ipv6 , the VPC and subnets that you // specify for cluster creation must have both IPv4 and IPv6 CIDR blocks assigned // to them. You can't specify ipv6 for clusters in China Regions. // // You can only specify ipv6 for 1.21 and later clusters that use version 1.10.1 // or later of the Amazon VPC CNI add-on. If you specify ipv6 , then ensure that // your VPC meets the requirements listed in the considerations listed in [Assigning IPv6 addresses to pods and services]in the // Amazon EKS User Guide. Kubernetes assigns services IPv6 addresses from the // unique local address range (fc00::/7) . You can't specify a custom IPv6 CIDR // block. Pod addresses are assigned from the subnet's IPv6 CIDR. // // [Assigning IPv6 addresses to pods and services]: https://docs.aws.amazon.com/eks/latest/userguide/cni-ipv6.html IpFamily IpFamily // Don't specify a value if you select ipv6 for ipFamily. The CIDR block to assign // Kubernetes service IP addresses from. If you don't specify a block, Kubernetes // assigns addresses from either the 10.100.0.0/16 or 172.20.0.0/16 CIDR blocks. // We recommend that you specify a block that does not overlap with resources in // other networks that are peered or connected to your VPC. The block must meet the // following requirements: // // - Within one of the following private IP address blocks: 10.0.0.0/8 , // 172.16.0.0/12 , or 192.168.0.0/16 . // // - Doesn't overlap with any CIDR block assigned to the VPC that you selected // for VPC. // // - Between /24 and /12 . // // You can only specify a custom CIDR block when you create a cluster. You can't // change this value after the cluster is created. ServiceIpv4Cidr *string // contains filtered or unexported fields }
The Kubernetes network configuration for the cluster.
type KubernetesNetworkConfigResponse ¶ added in v0.29.0
type KubernetesNetworkConfigResponse struct { // Indicates the current configuration of the load balancing capability on your // EKS Auto Mode cluster. For example, if the capability is enabled or disabled. ElasticLoadBalancing *ElasticLoadBalancing // The IP family used to assign Kubernetes Pod and Service objects IP addresses. // The IP family is always ipv4 , unless you have a 1.21 or later cluster running // version 1.10.1 or later of the Amazon VPC CNI plugin for Kubernetes and // specified ipv6 when you created the cluster. IpFamily IpFamily // The CIDR block that Kubernetes Pod and Service object IP addresses are assigned // from. Kubernetes assigns addresses from an IPv4 CIDR block assigned to a subnet // that the node is in. If you didn't specify a CIDR block when you created the // cluster, then Kubernetes assigns addresses from either the 10.100.0.0/16 or // 172.20.0.0/16 CIDR blocks. If this was specified, then it was specified when the // cluster was created and it can't be changed. ServiceIpv4Cidr *string // The CIDR block that Kubernetes pod and service IP addresses are assigned from // if you created a 1.21 or later cluster with version 1.10.1 or later of the // Amazon VPC CNI add-on and specified ipv6 for ipFamily when you created the // cluster. Kubernetes assigns service addresses from the unique local address // range ( fc00::/7 ) because you can't specify a custom IPv6 CIDR block when you // create the cluster. ServiceIpv6Cidr *string // contains filtered or unexported fields }
The Kubernetes network configuration for the cluster. The response contains a value for serviceIpv6Cidr or serviceIpv4Cidr, but not both.
type LaunchTemplateSpecification ¶ added in v0.29.0
type LaunchTemplateSpecification struct { // The ID of the launch template. // // You must specify either the launch template ID or the launch template name in // the request, but not both. Id *string // The name of the launch template. // // You must specify either the launch template name or the launch template ID in // the request, but not both. Name *string // The version number of the launch template to use. If no version is specified, // then the template's default version is used. Version *string // contains filtered or unexported fields }
An object representing a node group launch template specification. The launch template can't include SubnetIdSubnetId , IamInstanceProfileIamInstanceProfile , RequestSpotInstancesRequestSpotInstances , HibernationOptions HibernationOptions , or TerminateInstancesTerminateInstances , or the node group deployment or update will fail. For more information about launch templates, see CreateLaunchTemplate CreateLaunchTemplate in the Amazon EC2 API Reference. For more information about using launch templates with Amazon EKS, see Customizing managed nodes with launch templatesin the Amazon EKS User Guide.
You must specify either the launch template ID or the launch template name in the request, but not both.
type LogSetup ¶
type LogSetup struct { // If a log type is enabled, that log type exports its control plane logs to // CloudWatch Logs. If a log type isn't enabled, that log type doesn't export its // control plane logs. Each individual log type can be enabled or disabled // independently. Enabled *bool // The available cluster control plane log types. Types []LogType // contains filtered or unexported fields }
An object representing the enabled or disabled Kubernetes control plane logs for your cluster.
type LogType ¶
type LogType string
type Logging ¶
type Logging struct { // The cluster control plane logging configuration for your cluster. ClusterLogging []LogSetup // contains filtered or unexported fields }
An object representing the logging configuration for resources in your cluster.
type MarketplaceInformation ¶ added in v1.24.0
type MarketplaceInformation struct { // The product ID from the Amazon Web Services Marketplace. ProductId *string // The product URL from the Amazon Web Services Marketplace. ProductUrl *string // contains filtered or unexported fields }
Information about an Amazon EKS add-on from the Amazon Web Services Marketplace.
type NodeRepairConfig ¶ added in v1.54.0
type NodeRepairConfig struct { // Specifies whether to enable node auto repair for the node group. Node auto // repair is disabled by default. Enabled *bool // contains filtered or unexported fields }
The node auto repair configuration for the node group.
type Nodegroup ¶
type Nodegroup struct { // If the node group was deployed using a launch template with a custom AMI, then // this is CUSTOM . For node groups that weren't deployed using a launch template, // this is the AMI type that was specified in the node group configuration. AmiType AMITypes // The capacity type of your managed node group. CapacityType CapacityTypes // The name of your cluster. ClusterName *string // The Unix epoch timestamp at object creation. CreatedAt *time.Time // If the node group wasn't deployed with a launch template, then this is the disk // size in the node group configuration. If the node group was deployed with a // launch template, then this is null . DiskSize *int32 // The health status of the node group. If there are issues with your node group's // health, they are listed here. Health *NodegroupHealth // If the node group wasn't deployed with a launch template, then this is the // instance type that is associated with the node group. If the node group was // deployed with a launch template, then this is null . InstanceTypes []string // The Kubernetes labels applied to the nodes in the node group. // // Only labels that are applied with the Amazon EKS API are shown here. There may // be other Kubernetes labels applied to the nodes in this group. Labels map[string]string // If a launch template was used to create the node group, then this is the launch // template that was used. LaunchTemplate *LaunchTemplateSpecification // The Unix epoch timestamp for the last modification to the object. ModifiedAt *time.Time // The node auto repair configuration for the node group. NodeRepairConfig *NodeRepairConfig // The IAM role associated with your node group. The Amazon EKS node kubelet // daemon makes calls to Amazon Web Services APIs on your behalf. Nodes receive // permissions for these API calls through an IAM instance profile and associated // policies. NodeRole *string // The Amazon Resource Name (ARN) associated with the managed node group. NodegroupArn *string // The name associated with an Amazon EKS managed node group. NodegroupName *string // If the node group was deployed using a launch template with a custom AMI, then // this is the AMI ID that was specified in the launch template. For node groups // that weren't deployed using a launch template, this is the version of the Amazon // EKS optimized AMI that the node group was deployed with. ReleaseVersion *string // If the node group wasn't deployed with a launch template, then this is the // remote access configuration that is associated with the node group. If the node // group was deployed with a launch template, then this is null . RemoteAccess *RemoteAccessConfig // The resources associated with the node group, such as Auto Scaling groups and // security groups for remote access. Resources *NodegroupResources // The scaling configuration details for the Auto Scaling group that is associated // with your node group. ScalingConfig *NodegroupScalingConfig // The current status of the managed node group. Status NodegroupStatus // The subnets that were specified for the Auto Scaling group that is associated // with your node group. Subnets []string // Metadata that assists with categorization and organization. Each tag consists // of a key and an optional value. You define both. Tags don't propagate to any // other cluster or Amazon Web Services resources. Tags map[string]string // The Kubernetes taints to be applied to the nodes in the node group when they // are created. Effect is one of No_Schedule , Prefer_No_Schedule , or No_Execute . // Kubernetes taints can be used together with tolerations to control how workloads // are scheduled to your nodes. For more information, see [Node taints on managed node groups]. // // [Node taints on managed node groups]: https://docs.aws.amazon.com/eks/latest/userguide/node-taints-managed-node-groups.html Taints []Taint // The node group update configuration. UpdateConfig *NodegroupUpdateConfig // The Kubernetes version of the managed node group. Version *string // contains filtered or unexported fields }
An object representing an Amazon EKS managed node group.
type NodegroupHealth ¶
type NodegroupHealth struct { // Any issues that are associated with the node group. Issues []Issue // contains filtered or unexported fields }
An object representing the health status of the node group.
type NodegroupIssueCode ¶
type NodegroupIssueCode string
const ( NodegroupIssueCodeAutoScalingGroupNotFound NodegroupIssueCode = "AutoScalingGroupNotFound" NodegroupIssueCodeAutoScalingGroupInvalidConfiguration NodegroupIssueCode = "AutoScalingGroupInvalidConfiguration" NodegroupIssueCodeEc2SecurityGroupNotFound NodegroupIssueCode = "Ec2SecurityGroupNotFound" NodegroupIssueCodeEc2SecurityGroupDeletionFailure NodegroupIssueCode = "Ec2SecurityGroupDeletionFailure" NodegroupIssueCodeEc2LaunchTemplateNotFound NodegroupIssueCode = "Ec2LaunchTemplateNotFound" NodegroupIssueCodeEc2LaunchTemplateVersionMismatch NodegroupIssueCode = "Ec2LaunchTemplateVersionMismatch" NodegroupIssueCodeEc2SubnetNotFound NodegroupIssueCode = "Ec2SubnetNotFound" NodegroupIssueCodeEc2SubnetInvalidConfiguration NodegroupIssueCode = "Ec2SubnetInvalidConfiguration" NodegroupIssueCodeIamInstanceProfileNotFound NodegroupIssueCode = "IamInstanceProfileNotFound" NodegroupIssueCodeEc2SubnetMissingIpv6Assignment NodegroupIssueCode = "Ec2SubnetMissingIpv6Assignment" NodegroupIssueCodeIamLimitExceeded NodegroupIssueCode = "IamLimitExceeded" NodegroupIssueCodeIamNodeRoleNotFound NodegroupIssueCode = "IamNodeRoleNotFound" NodegroupIssueCodeNodeCreationFailure NodegroupIssueCode = "NodeCreationFailure" NodegroupIssueCodeAsgInstanceLaunchFailures NodegroupIssueCode = "AsgInstanceLaunchFailures" NodegroupIssueCodeInstanceLimitExceeded NodegroupIssueCode = "InstanceLimitExceeded" NodegroupIssueCodeInsufficientFreeAddresses NodegroupIssueCode = "InsufficientFreeAddresses" NodegroupIssueCodeAccessDenied NodegroupIssueCode = "AccessDenied" NodegroupIssueCodeInternalFailure NodegroupIssueCode = "InternalFailure" NodegroupIssueCodeClusterUnreachable NodegroupIssueCode = "ClusterUnreachable" NodegroupIssueCodeAmiIdNotFound NodegroupIssueCode = "AmiIdNotFound" NodegroupIssueCodeAutoScalingGroupOptInRequired NodegroupIssueCode = "AutoScalingGroupOptInRequired" NodegroupIssueCodeAutoScalingGroupRateLimitExceeded NodegroupIssueCode = "AutoScalingGroupRateLimitExceeded" NodegroupIssueCodeEc2LaunchTemplateDeletionFailure NodegroupIssueCode = "Ec2LaunchTemplateDeletionFailure" NodegroupIssueCodeEc2LaunchTemplateInvalidConfiguration NodegroupIssueCode = "Ec2LaunchTemplateInvalidConfiguration" NodegroupIssueCodeEc2LaunchTemplateMaxLimitExceeded NodegroupIssueCode = "Ec2LaunchTemplateMaxLimitExceeded" NodegroupIssueCodeEc2SubnetListTooLong NodegroupIssueCode = "Ec2SubnetListTooLong" NodegroupIssueCodeIamThrottling NodegroupIssueCode = "IamThrottling" NodegroupIssueCodeNodeTerminationFailure NodegroupIssueCode = "NodeTerminationFailure" NodegroupIssueCodePodEvictionFailure NodegroupIssueCode = "PodEvictionFailure" NodegroupIssueCodeSourceEc2LaunchTemplateNotFound NodegroupIssueCode = "SourceEc2LaunchTemplateNotFound" NodegroupIssueCodeLimitExceeded NodegroupIssueCode = "LimitExceeded" NodegroupIssueCodeUnknown NodegroupIssueCode = "Unknown" NodegroupIssueCodeAutoScalingGroupInstanceRefreshActive NodegroupIssueCode = "AutoScalingGroupInstanceRefreshActive" NodegroupIssueCodeKubernetesLabelInvalid NodegroupIssueCode = "KubernetesLabelInvalid" NodegroupIssueCodeEc2LaunchTemplateVersionMaxLimitExceeded NodegroupIssueCode = "Ec2LaunchTemplateVersionMaxLimitExceeded" NodegroupIssueCodeEc2InstanceTypeDoesNotExist NodegroupIssueCode = "Ec2InstanceTypeDoesNotExist" )
Enum values for NodegroupIssueCode
func (NodegroupIssueCode) Values ¶ added in v0.29.0
func (NodegroupIssueCode) Values() []NodegroupIssueCode
Values returns all known values for NodegroupIssueCode. Note that this can be expanded in the future, and so it is only as up to date as the client.
The ordering of this slice is not guaranteed to be stable across updates.
type NodegroupResources ¶
type NodegroupResources struct { // The Auto Scaling groups associated with the node group. AutoScalingGroups []AutoScalingGroup // The remote access security group associated with the node group. This security // group controls SSH access to the nodes. RemoteAccessSecurityGroup *string // contains filtered or unexported fields }
An object representing the resources associated with the node group, such as Auto Scaling groups and security groups for remote access.
type NodegroupScalingConfig ¶
type NodegroupScalingConfig struct { // The current number of nodes that the managed node group should maintain. // // If you use the Kubernetes [Cluster Autoscaler], you shouldn't change the desiredSize value // directly, as this can cause the Cluster Autoscaler to suddenly scale up or scale // down. // // Whenever this parameter changes, the number of worker nodes in the node group // is updated to the specified size. If this parameter is given a value that is // smaller than the current number of running worker nodes, the necessary number of // worker nodes are terminated to match the given value. // // When using CloudFormation, no action occurs if you remove this parameter from // your CFN template. // // This parameter can be different from minSize in some cases, such as when // starting with extra hosts for testing. This parameter can also be different when // you want to start with an estimated number of needed hosts, but let the Cluster // Autoscaler reduce the number if there are too many. When the Cluster Autoscaler // is used, the desiredSize parameter is altered by the Cluster Autoscaler (but // can be out-of-date for short periods of time). the Cluster Autoscaler doesn't // scale a managed node group lower than minSize or higher than maxSize . // // [Cluster Autoscaler]: https://github.com/kubernetes/autoscaler#kubernetes-autoscaler DesiredSize *int32 // The maximum number of nodes that the managed node group can scale out to. For // information about the maximum number that you can specify, see [Amazon EKS service quotas]in the Amazon // EKS User Guide. // // [Amazon EKS service quotas]: https://docs.aws.amazon.com/eks/latest/userguide/service-quotas.html MaxSize *int32 // The minimum number of nodes that the managed node group can scale in to. MinSize *int32 // contains filtered or unexported fields }
An object representing the scaling configuration details for the Auto Scaling group that is associated with your node group. When creating a node group, you must specify all or none of the properties. When updating a node group, you can specify any or none of the properties.
type NodegroupStatus ¶
type NodegroupStatus string
const ( NodegroupStatusCreating NodegroupStatus = "CREATING" NodegroupStatusActive NodegroupStatus = "ACTIVE" NodegroupStatusUpdating NodegroupStatus = "UPDATING" NodegroupStatusDeleting NodegroupStatus = "DELETING" NodegroupStatusCreateFailed NodegroupStatus = "CREATE_FAILED" NodegroupStatusDeleteFailed NodegroupStatus = "DELETE_FAILED" NodegroupStatusDegraded NodegroupStatus = "DEGRADED" )
Enum values for NodegroupStatus
func (NodegroupStatus) Values ¶ added in v0.29.0
func (NodegroupStatus) Values() []NodegroupStatus
Values returns all known values for NodegroupStatus. Note that this can be expanded in the future, and so it is only as up to date as the client.
The ordering of this slice is not guaranteed to be stable across updates.
type NodegroupUpdateConfig ¶ added in v1.6.0
type NodegroupUpdateConfig struct { // are updated in parallel. This value or maxUnavailablePercentage is required to // have a value.The maximum number is 100. MaxUnavailable *int32 // percentage of nodes are updated in parallel, up to 100 nodes at once. This value // or maxUnavailable is required to have a value. MaxUnavailablePercentage *int32 // contains filtered or unexported fields }
The node group update configuration.
type NotFoundException ¶
type NotFoundException struct { Message *string ErrorCodeOverride *string // contains filtered or unexported fields }
A service resource associated with the request could not be found. Clients should not retry such requests.
func (*NotFoundException) Error ¶
func (e *NotFoundException) Error() string
func (*NotFoundException) ErrorCode ¶
func (e *NotFoundException) ErrorCode() string
func (*NotFoundException) ErrorFault ¶
func (e *NotFoundException) ErrorFault() smithy.ErrorFault
func (*NotFoundException) ErrorMessage ¶
func (e *NotFoundException) ErrorMessage() string
type OIDC ¶
type OIDC struct { // The issuer URL for the OIDC identity provider. Issuer *string // contains filtered or unexported fields }
An object representing the OpenID Connect (OIDC) identity provider information for the cluster.
type OidcIdentityProviderConfig ¶ added in v1.2.0
type OidcIdentityProviderConfig struct { // This is also known as audience. The ID of the client application that makes // authentication requests to the OIDC identity provider. ClientId *string // The name of your cluster. ClusterName *string // The JSON web token (JWT) claim that the provider uses to return your groups. GroupsClaim *string // The prefix that is prepended to group claims to prevent clashes with existing // names (such as system: groups). For example, the value oidc: creates group // names like oidc:engineering and oidc:infra . The prefix can't contain system: GroupsPrefix *string // The ARN of the configuration. IdentityProviderConfigArn *string // The name of the configuration. IdentityProviderConfigName *string // The URL of the OIDC identity provider that allows the API server to discover // public signing keys for verifying tokens. IssuerUrl *string // The key-value pairs that describe required claims in the identity token. If // set, each claim is verified to be present in the token with a matching value. RequiredClaims map[string]string // The status of the OIDC identity provider. Status ConfigStatus // Metadata that assists with categorization and organization. Each tag consists // of a key and an optional value. You define both. Tags don't propagate to any // other cluster or Amazon Web Services resources. Tags map[string]string // The JSON Web token (JWT) claim that is used as the username. UsernameClaim *string // The prefix that is prepended to username claims to prevent clashes with // existing names. The prefix can't contain system: UsernamePrefix *string // contains filtered or unexported fields }
An object representing the configuration for an OpenID Connect (OIDC) identity provider.
type OidcIdentityProviderConfigRequest ¶ added in v1.2.0
type OidcIdentityProviderConfigRequest struct { // This is also known as audience. The ID for the client application that makes // authentication requests to the OIDC identity provider. // // This member is required. ClientId *string // The name of the OIDC provider configuration. // // This member is required. IdentityProviderConfigName *string // The URL of the OIDC identity provider that allows the API server to discover // public signing keys for verifying tokens. The URL must begin with https:// and // should correspond to the iss claim in the provider's OIDC ID tokens. Based on // the OIDC standard, path components are allowed but query parameters are not. // Typically the URL consists of only a hostname, like https://server.example.org // or https://example.com . This URL should point to the level below // .well-known/openid-configuration and must be publicly accessible over the // internet. // // This member is required. IssuerUrl *string // The JWT claim that the provider uses to return your groups. GroupsClaim *string // The prefix that is prepended to group claims to prevent clashes with existing // names (such as system: groups). For example, the value oidc: will create group // names like oidc:engineering and oidc:infra . GroupsPrefix *string // The key value pairs that describe required claims in the identity token. If // set, each claim is verified to be present in the token with a matching value. // For the maximum number of claims that you can require, see [Amazon EKS service quotas]in the Amazon EKS // User Guide. // // [Amazon EKS service quotas]: https://docs.aws.amazon.com/eks/latest/userguide/service-quotas.html RequiredClaims map[string]string // The JSON Web Token (JWT) claim to use as the username. The default is sub , // which is expected to be a unique identifier of the end user. You can choose // other claims, such as email or name , depending on the OIDC identity provider. // Claims other than email are prefixed with the issuer URL to prevent naming // clashes with other plug-ins. UsernameClaim *string // The prefix that is prepended to username claims to prevent clashes with // existing names. If you do not provide this field, and username is a value other // than email , the prefix defaults to issuerurl# . You can use the value - to // disable all prefixing. UsernamePrefix *string // contains filtered or unexported fields }
An object representing an OpenID Connect (OIDC) configuration. Before associating an OIDC identity provider to your cluster, review the considerations in Authenticating users for your cluster from an OIDC identity providerin the Amazon EKS User Guide.
type OutpostConfigRequest ¶ added in v1.22.0
type OutpostConfigRequest struct { // The Amazon EC2 instance type that you want to use for your local Amazon EKS // cluster on Outposts. Choose an instance type based on the number of nodes that // your cluster will have. For more information, see [Capacity considerations]in the Amazon EKS User Guide. // // The instance type that you specify is used for all Kubernetes control plane // instances. The instance type can't be changed after cluster creation. The // control plane is not automatically scaled by Amazon EKS. // // [Capacity considerations]: https://docs.aws.amazon.com/eks/latest/userguide/eks-outposts-capacity-considerations.html // // This member is required. ControlPlaneInstanceType *string // The ARN of the Outpost that you want to use for your local Amazon EKS cluster // on Outposts. Only a single Outpost ARN is supported. // // This member is required. OutpostArns []string // An object representing the placement configuration for all the control plane // instances of your local Amazon EKS cluster on an Amazon Web Services Outpost. // For more information, see [Capacity considerations]in the Amazon EKS User Guide. // // [Capacity considerations]: https://docs.aws.amazon.com/eks/latest/userguide/eks-outposts-capacity-considerations.html ControlPlanePlacement *ControlPlanePlacementRequest // contains filtered or unexported fields }
The configuration of your local Amazon EKS cluster on an Amazon Web Services Outpost. Before creating a cluster on an Outpost, review Creating a local cluster on an Outpostin the Amazon EKS User Guide. This API isn't available for Amazon EKS clusters on the Amazon Web Services cloud.
type OutpostConfigResponse ¶ added in v1.22.0
type OutpostConfigResponse struct { // The Amazon EC2 instance type used for the control plane. The instance type is // the same for all control plane instances. // // This member is required. ControlPlaneInstanceType *string // The ARN of the Outpost that you specified for use with your local Amazon EKS // cluster on Outposts. // // This member is required. OutpostArns []string // An object representing the placement configuration for all the control plane // instances of your local Amazon EKS cluster on an Amazon Web Services Outpost. // For more information, see [Capacity considerations]in the Amazon EKS User Guide. // // [Capacity considerations]: https://docs.aws.amazon.com/eks/latest/userguide/eks-outposts-capacity-considerations.html ControlPlanePlacement *ControlPlanePlacementResponse // contains filtered or unexported fields }
An object representing the configuration of your local Amazon EKS cluster on an Amazon Web Services Outpost. This API isn't available for Amazon EKS clusters on the Amazon Web Services cloud.
type PodIdentityAssociation ¶ added in v1.34.0
type PodIdentityAssociation struct { // The Amazon Resource Name (ARN) of the association. AssociationArn *string // The ID of the association. AssociationId *string // The name of the cluster that the association is in. ClusterName *string // The timestamp that the association was created at. CreatedAt *time.Time // The most recent timestamp that the association was modified at ModifiedAt *time.Time // The name of the Kubernetes namespace inside the cluster to create the // association in. The service account and the pods that use the service account // must be in this namespace. Namespace *string // If defined, the Pod Identity Association is owned by an Amazon EKS Addon. OwnerArn *string // The Amazon Resource Name (ARN) of the IAM role to associate with the service // account. The EKS Pod Identity agent manages credentials to assume this role for // applications in the containers in the pods that use this service account. RoleArn *string // The name of the Kubernetes service account inside the cluster to associate the // IAM credentials with. ServiceAccount *string // Metadata that assists with categorization and organization. Each tag consists // of a key and an optional value. You define both. Tags don't propagate to any // other cluster or Amazon Web Services resources. // // The following basic restrictions apply to tags: // // - Maximum number of tags per resource – 50 // // - For each resource, each tag key must be unique, and each tag key can have // only one value. // // - Maximum key length – 128 Unicode characters in UTF-8 // // - Maximum value length – 256 Unicode characters in UTF-8 // // - If your tagging schema is used across multiple services and resources, // remember that other services may have restrictions on allowed characters. // Generally allowed characters are: letters, numbers, and spaces representable in // UTF-8, and the following characters: + - = . _ : / @. // // - Tag keys and values are case-sensitive. // // - Do not use aws: , AWS: , or any upper or lowercase combination of such as a // prefix for either keys or values as it is reserved for Amazon Web Services use. // You cannot edit or delete tag keys or values with this prefix. Tags with this // prefix do not count against your tags per resource limit. Tags map[string]string // contains filtered or unexported fields }
Amazon EKS Pod Identity associations provide the ability to manage credentials for your applications, similar to the way that Amazon EC2 instance profiles provide credentials to Amazon EC2 instances.
type PodIdentityAssociationSummary ¶ added in v1.34.0
type PodIdentityAssociationSummary struct { // The Amazon Resource Name (ARN) of the association. AssociationArn *string // The ID of the association. AssociationId *string // The name of the cluster that the association is in. ClusterName *string // The name of the Kubernetes namespace inside the cluster to create the // association in. The service account and the pods that use the service account // must be in this namespace. Namespace *string // If defined, the Pod Identity Association is owned by an Amazon EKS Addon. OwnerArn *string // The name of the Kubernetes service account inside the cluster to associate the // IAM credentials with. ServiceAccount *string // contains filtered or unexported fields }
The summarized description of the association.
Each summary is simplified by removing these fields compared to the full PodIdentityAssociation:
The IAM role: roleArn
The timestamp that the association was created at: createdAt
The most recent timestamp that the association was modified at:. modifiedAt
The tags on the association: tags
type Provider ¶
type Provider struct { // Amazon Resource Name (ARN) or alias of the KMS key. The KMS key must be // symmetric and created in the same Amazon Web Services Region as the cluster. If // the KMS key was created in a different account, the [IAM principal]must have access to the KMS // key. For more information, see [Allowing users in other accounts to use a KMS key]in the Key Management Service Developer Guide. // // [IAM principal]: https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_terms-and-concepts.html // [Allowing users in other accounts to use a KMS key]: https://docs.aws.amazon.com/kms/latest/developerguide/key-policy-modifying-external-accounts.html KeyArn *string // contains filtered or unexported fields }
Identifies the Key Management Service (KMS) key used to encrypt the secrets.
type RemoteAccessConfig ¶
type RemoteAccessConfig struct { // The Amazon EC2 SSH key name that provides access for SSH communication with the // nodes in the managed node group. For more information, see [Amazon EC2 key pairs and Linux instances]in the Amazon // Elastic Compute Cloud User Guide for Linux Instances. For Windows, an Amazon EC2 // SSH key is used to obtain the RDP password. For more information, see [Amazon EC2 key pairs and Windows instances]in the // Amazon Elastic Compute Cloud User Guide for Windows Instances. // // [Amazon EC2 key pairs and Windows instances]: https://docs.aws.amazon.com/AWSEC2/latest/WindowsGuide/ec2-key-pairs.html // [Amazon EC2 key pairs and Linux instances]: https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-key-pairs.html Ec2SshKey *string // The security group IDs that are allowed SSH access (port 22) to the nodes. For // Windows, the port is 3389. If you specify an Amazon EC2 SSH key but don't // specify a source security group when you create a managed node group, then the // port on the nodes is opened to the internet ( 0.0.0.0/0 ). For more information, // see [Security Groups for Your VPC]in the Amazon Virtual Private Cloud User Guide. // // [Security Groups for Your VPC]: https://docs.aws.amazon.com/vpc/latest/userguide/VPC_SecurityGroups.html SourceSecurityGroups []string // contains filtered or unexported fields }
An object representing the remote access configuration for the managed node group.
type RemoteNetworkConfigRequest ¶ added in v1.53.0
type RemoteNetworkConfigRequest struct { // The list of network CIDRs that can contain hybrid nodes. // // These CIDR blocks define the expected IP address range of the hybrid nodes that // join the cluster. These blocks are typically determined by your network // administrator. // // Enter one or more IPv4 CIDR blocks in decimal dotted-quad notation (for // example, 10.2.0.0/16 ). // // It must satisfy the following requirements: // // - Each block must be within an IPv4 RFC-1918 network range. Minimum allowed // size is /24, maximum allowed size is /8. Publicly-routable addresses aren't // supported. // // - Each block cannot overlap with the range of the VPC CIDR blocks for your // EKS resources, or the block of the Kubernetes service IP range. // // - Each block must have a route to the VPC that uses the VPC CIDR blocks, not // public IPs or Elastic IPs. There are many options including Transit Gateway, // Site-to-Site VPN, or Direct Connect. // // - Each host must allow outbound connection to the EKS cluster control plane // on TCP ports 443 and 10250 . // // - Each host must allow inbound connection from the EKS cluster control plane // on TCP port 10250 for logs, exec and port-forward operations. // // - Each host must allow TCP and UDP network connectivity to and from other // hosts that are running CoreDNS on UDP port 53 for service and pod DNS names. RemoteNodeNetworks []RemoteNodeNetwork // The list of network CIDRs that can contain pods that run Kubernetes webhooks on // hybrid nodes. // // These CIDR blocks are determined by configuring your Container Network // Interface (CNI) plugin. We recommend the Calico CNI or Cilium CNI. Note that the // Amazon VPC CNI plugin for Kubernetes isn't available for on-premises and edge // locations. // // Enter one or more IPv4 CIDR blocks in decimal dotted-quad notation (for // example, 10.2.0.0/16 ). // // It must satisfy the following requirements: // // - Each block must be within an IPv4 RFC-1918 network range. Minimum allowed // size is /24, maximum allowed size is /8. Publicly-routable addresses aren't // supported. // // - Each block cannot overlap with the range of the VPC CIDR blocks for your // EKS resources, or the block of the Kubernetes service IP range. RemotePodNetworks []RemotePodNetwork // contains filtered or unexported fields }
The configuration in the cluster for EKS Hybrid Nodes. You can't change or update this configuration after the cluster is created.
type RemoteNetworkConfigResponse ¶ added in v1.53.0
type RemoteNetworkConfigResponse struct { // The list of network CIDRs that can contain hybrid nodes. RemoteNodeNetworks []RemoteNodeNetwork // The list of network CIDRs that can contain pods that run Kubernetes webhooks on // hybrid nodes. RemotePodNetworks []RemotePodNetwork // contains filtered or unexported fields }
The configuration in the cluster for EKS Hybrid Nodes. You can't change or update this configuration after the cluster is created.
type RemoteNodeNetwork ¶ added in v1.53.0
type RemoteNodeNetwork struct { // A network CIDR that can contain hybrid nodes. // // These CIDR blocks define the expected IP address range of the hybrid nodes that // join the cluster. These blocks are typically determined by your network // administrator. // // Enter one or more IPv4 CIDR blocks in decimal dotted-quad notation (for // example, 10.2.0.0/16 ). // // It must satisfy the following requirements: // // - Each block must be within an IPv4 RFC-1918 network range. Minimum allowed // size is /24, maximum allowed size is /8. Publicly-routable addresses aren't // supported. // // - Each block cannot overlap with the range of the VPC CIDR blocks for your // EKS resources, or the block of the Kubernetes service IP range. // // - Each block must have a route to the VPC that uses the VPC CIDR blocks, not // public IPs or Elastic IPs. There are many options including Transit Gateway, // Site-to-Site VPN, or Direct Connect. // // - Each host must allow outbound connection to the EKS cluster control plane // on TCP ports 443 and 10250 . // // - Each host must allow inbound connection from the EKS cluster control plane // on TCP port 10250 for logs, exec and port-forward operations. // // - Each host must allow TCP and UDP network connectivity to and from other // hosts that are running CoreDNS on UDP port 53 for service and pod DNS names. Cidrs []string // contains filtered or unexported fields }
A network CIDR that can contain hybrid nodes.
These CIDR blocks define the expected IP address range of the hybrid nodes that join the cluster. These blocks are typically determined by your network administrator.
Enter one or more IPv4 CIDR blocks in decimal dotted-quad notation (for example, 10.2.0.0/16 ).
It must satisfy the following requirements:
Each block must be within an IPv4 RFC-1918 network range. Minimum allowed size is /24, maximum allowed size is /8. Publicly-routable addresses aren't supported.
Each block cannot overlap with the range of the VPC CIDR blocks for your EKS resources, or the block of the Kubernetes service IP range.
Each block must have a route to the VPC that uses the VPC CIDR blocks, not public IPs or Elastic IPs. There are many options including Transit Gateway, Site-to-Site VPN, or Direct Connect.
Each host must allow outbound connection to the EKS cluster control plane on TCP ports 443 and 10250 .
Each host must allow inbound connection from the EKS cluster control plane on TCP port 10250 for logs, exec and port-forward operations.
Each host must allow TCP and UDP network connectivity to and from other hosts that are running CoreDNS on UDP port 53 for service and pod DNS names.
type RemotePodNetwork ¶ added in v1.53.0
type RemotePodNetwork struct { // A network CIDR that can contain pods that run Kubernetes webhooks on hybrid // nodes. // // These CIDR blocks are determined by configuring your Container Network // Interface (CNI) plugin. We recommend the Calico CNI or Cilium CNI. Note that the // Amazon VPC CNI plugin for Kubernetes isn't available for on-premises and edge // locations. // // Enter one or more IPv4 CIDR blocks in decimal dotted-quad notation (for // example, 10.2.0.0/16 ). // // It must satisfy the following requirements: // // - Each block must be within an IPv4 RFC-1918 network range. Minimum allowed // size is /24, maximum allowed size is /8. Publicly-routable addresses aren't // supported. // // - Each block cannot overlap with the range of the VPC CIDR blocks for your // EKS resources, or the block of the Kubernetes service IP range. Cidrs []string // contains filtered or unexported fields }
A network CIDR that can contain pods that run Kubernetes webhooks on hybrid nodes.
These CIDR blocks are determined by configuring your Container Network Interface (CNI) plugin. We recommend the Calico CNI or Cilium CNI. Note that the Amazon VPC CNI plugin for Kubernetes isn't available for on-premises and edge locations.
Enter one or more IPv4 CIDR blocks in decimal dotted-quad notation (for example, 10.2.0.0/16 ).
It must satisfy the following requirements:
Each block must be within an IPv4 RFC-1918 network range. Minimum allowed size is /24, maximum allowed size is /8. Publicly-routable addresses aren't supported.
Each block cannot overlap with the range of the VPC CIDR blocks for your EKS resources, or the block of the Kubernetes service IP range.
type ResolveConflicts ¶ added in v0.31.0
type ResolveConflicts string
const ( ResolveConflictsOverwrite ResolveConflicts = "OVERWRITE" ResolveConflictsNone ResolveConflicts = "NONE" ResolveConflictsPreserve ResolveConflicts = "PRESERVE" )
Enum values for ResolveConflicts
func (ResolveConflicts) Values ¶ added in v0.31.0
func (ResolveConflicts) Values() []ResolveConflicts
Values returns all known values for ResolveConflicts. Note that this can be expanded in the future, and so it is only as up to date as the client.
The ordering of this slice is not guaranteed to be stable across updates.
type ResourceInUseException ¶
type ResourceInUseException struct { Message *string ErrorCodeOverride *string ClusterName *string NodegroupName *string AddonName *string // contains filtered or unexported fields }
The specified resource is in use.
func (*ResourceInUseException) Error ¶
func (e *ResourceInUseException) Error() string
func (*ResourceInUseException) ErrorCode ¶
func (e *ResourceInUseException) ErrorCode() string
func (*ResourceInUseException) ErrorFault ¶
func (e *ResourceInUseException) ErrorFault() smithy.ErrorFault
func (*ResourceInUseException) ErrorMessage ¶
func (e *ResourceInUseException) ErrorMessage() string
type ResourceLimitExceededException ¶
type ResourceLimitExceededException struct { Message *string ErrorCodeOverride *string ClusterName *string NodegroupName *string SubscriptionId *string // contains filtered or unexported fields }
You have encountered a service limit on the specified resource.
func (*ResourceLimitExceededException) Error ¶
func (e *ResourceLimitExceededException) Error() string
func (*ResourceLimitExceededException) ErrorCode ¶
func (e *ResourceLimitExceededException) ErrorCode() string
func (*ResourceLimitExceededException) ErrorFault ¶
func (e *ResourceLimitExceededException) ErrorFault() smithy.ErrorFault
func (*ResourceLimitExceededException) ErrorMessage ¶
func (e *ResourceLimitExceededException) ErrorMessage() string
type ResourceNotFoundException ¶
type ResourceNotFoundException struct { Message *string ErrorCodeOverride *string ClusterName *string NodegroupName *string FargateProfileName *string AddonName *string SubscriptionId *string // contains filtered or unexported fields }
The specified resource could not be found. You can view your available clusters with ListClusters . You can view your available managed node groups with ListNodegroups . Amazon EKS clusters and node groups are Amazon Web Services Region specific.
func (*ResourceNotFoundException) Error ¶
func (e *ResourceNotFoundException) Error() string
func (*ResourceNotFoundException) ErrorCode ¶
func (e *ResourceNotFoundException) ErrorCode() string
func (*ResourceNotFoundException) ErrorFault ¶
func (e *ResourceNotFoundException) ErrorFault() smithy.ErrorFault
func (*ResourceNotFoundException) ErrorMessage ¶
func (e *ResourceNotFoundException) ErrorMessage() string
type ResourcePropagationDelayException ¶ added in v1.15.0
type ResourcePropagationDelayException struct { Message *string ErrorCodeOverride *string // contains filtered or unexported fields }
Required resources (such as service-linked roles) were created and are still propagating. Retry later.
func (*ResourcePropagationDelayException) Error ¶ added in v1.15.0
func (e *ResourcePropagationDelayException) Error() string
func (*ResourcePropagationDelayException) ErrorCode ¶ added in v1.15.0
func (e *ResourcePropagationDelayException) ErrorCode() string
func (*ResourcePropagationDelayException) ErrorFault ¶ added in v1.15.0
func (e *ResourcePropagationDelayException) ErrorFault() smithy.ErrorFault
func (*ResourcePropagationDelayException) ErrorMessage ¶ added in v1.15.0
func (e *ResourcePropagationDelayException) ErrorMessage() string
type ServerException ¶
type ServerException struct { Message *string ErrorCodeOverride *string ClusterName *string NodegroupName *string AddonName *string SubscriptionId *string // contains filtered or unexported fields }
These errors are usually caused by a server-side issue.
func (*ServerException) Error ¶
func (e *ServerException) Error() string
func (*ServerException) ErrorCode ¶
func (e *ServerException) ErrorCode() string
func (*ServerException) ErrorFault ¶
func (e *ServerException) ErrorFault() smithy.ErrorFault
func (*ServerException) ErrorMessage ¶
func (e *ServerException) ErrorMessage() string
type ServiceUnavailableException ¶
type ServiceUnavailableException struct { // contains filtered or unexported fields }
The service is unavailable. Back off and retry the operation.
func (*ServiceUnavailableException) Error ¶
func (e *ServiceUnavailableException) Error() string
func (*ServiceUnavailableException) ErrorCode ¶
func (e *ServiceUnavailableException) ErrorCode() string
func (*ServiceUnavailableException) ErrorFault ¶
func (e *ServiceUnavailableException) ErrorFault() smithy.ErrorFault
func (*ServiceUnavailableException) ErrorMessage ¶
func (e *ServiceUnavailableException) ErrorMessage() string
type StorageConfigRequest ¶ added in v1.53.0
type StorageConfigRequest struct { // Request to configure EBS Block Storage settings for your EKS Auto Mode cluster. BlockStorage *BlockStorage // contains filtered or unexported fields }
Request to update the configuration of the storage capability of your EKS Auto Mode cluster. For example, enable the capability. For more information, see EKS Auto Mode block storage capability in the EKS User Guide.
type StorageConfigResponse ¶ added in v1.53.0
type StorageConfigResponse struct { // Indicates the current configuration of the block storage capability on your EKS // Auto Mode cluster. For example, if the capability is enabled or disabled. BlockStorage *BlockStorage // contains filtered or unexported fields }
Indicates the status of the request to update the block storage capability of your EKS Auto Mode cluster.
type SupportType ¶ added in v1.47.0
type SupportType string
const ( SupportTypeStandard SupportType = "STANDARD" SupportTypeExtended SupportType = "EXTENDED" )
Enum values for SupportType
func (SupportType) Values ¶ added in v1.47.0
func (SupportType) Values() []SupportType
Values returns all known values for SupportType. Note that this can be expanded in the future, and so it is only as up to date as the client.
The ordering of this slice is not guaranteed to be stable across updates.
type Taint ¶ added in v1.4.0
type Taint struct { // The effect of the taint. Effect TaintEffect // The key of the taint. Key *string // The value of the taint. Value *string // contains filtered or unexported fields }
A property that allows a node to repel a Pod . For more information, see Node taints on managed node groups in the Amazon EKS User Guide.
type TaintEffect ¶ added in v1.4.0
type TaintEffect string
const ( TaintEffectNoSchedule TaintEffect = "NO_SCHEDULE" TaintEffectNoExecute TaintEffect = "NO_EXECUTE" TaintEffectPreferNoSchedule TaintEffect = "PREFER_NO_SCHEDULE" )
Enum values for TaintEffect
func (TaintEffect) Values ¶ added in v1.4.0
func (TaintEffect) Values() []TaintEffect
Values returns all known values for TaintEffect. Note that this can be expanded in the future, and so it is only as up to date as the client.
The ordering of this slice is not guaranteed to be stable across updates.
type UnsupportedAvailabilityZoneException ¶
type UnsupportedAvailabilityZoneException struct { Message *string ErrorCodeOverride *string ClusterName *string NodegroupName *string ValidZones []string // contains filtered or unexported fields }
At least one of your specified cluster subnets is in an Availability Zone that does not support Amazon EKS. The exception output specifies the supported Availability Zones for your account, from which you can choose subnets for your cluster.
func (*UnsupportedAvailabilityZoneException) Error ¶
func (e *UnsupportedAvailabilityZoneException) Error() string
func (*UnsupportedAvailabilityZoneException) ErrorCode ¶
func (e *UnsupportedAvailabilityZoneException) ErrorCode() string
func (*UnsupportedAvailabilityZoneException) ErrorFault ¶
func (e *UnsupportedAvailabilityZoneException) ErrorFault() smithy.ErrorFault
func (*UnsupportedAvailabilityZoneException) ErrorMessage ¶
func (e *UnsupportedAvailabilityZoneException) ErrorMessage() string
type Update ¶
type Update struct { // The Unix epoch timestamp at object creation. CreatedAt *time.Time // Any errors associated with a Failed update. Errors []ErrorDetail // A UUID that is used to track the update. Id *string // A key-value map that contains the parameters associated with the update. Params []UpdateParam // The current status of the update. Status UpdateStatus // The type of the update. Type UpdateType // contains filtered or unexported fields }
An object representing an asynchronous update.
type UpdateAccessConfigRequest ¶ added in v1.36.0
type UpdateAccessConfigRequest struct { // The desired authentication mode for the cluster. AuthenticationMode AuthenticationMode // contains filtered or unexported fields }
The access configuration information for the cluster.
type UpdateLabelsPayload ¶
type UpdateLabelsPayload struct { // The Kubernetes labels to add or update. AddOrUpdateLabels map[string]string // The Kubernetes labels to remove. RemoveLabels []string // contains filtered or unexported fields }
An object representing a Kubernetes label change for a managed node group.
type UpdateParam ¶
type UpdateParam struct { // The keys associated with an update request. Type UpdateParamType // The value of the keys submitted as part of an update request. Value *string // contains filtered or unexported fields }
An object representing the details of an update request.
type UpdateParamType ¶
type UpdateParamType string
const ( UpdateParamTypeVersion UpdateParamType = "Version" UpdateParamTypePlatformVersion UpdateParamType = "PlatformVersion" UpdateParamTypeEndpointPrivateAccess UpdateParamType = "EndpointPrivateAccess" UpdateParamTypeEndpointPublicAccess UpdateParamType = "EndpointPublicAccess" UpdateParamTypeClusterLogging UpdateParamType = "ClusterLogging" UpdateParamTypeDesiredSize UpdateParamType = "DesiredSize" UpdateParamTypeLabelsToAdd UpdateParamType = "LabelsToAdd" UpdateParamTypeLabelsToRemove UpdateParamType = "LabelsToRemove" UpdateParamTypeTaintsToAdd UpdateParamType = "TaintsToAdd" UpdateParamTypeTaintsToRemove UpdateParamType = "TaintsToRemove" UpdateParamTypeMaxSize UpdateParamType = "MaxSize" UpdateParamTypeMinSize UpdateParamType = "MinSize" UpdateParamTypeReleaseVersion UpdateParamType = "ReleaseVersion" UpdateParamTypePublicAccessCidrs UpdateParamType = "PublicAccessCidrs" UpdateParamTypeLaunchTemplateName UpdateParamType = "LaunchTemplateName" UpdateParamTypeLaunchTemplateVersion UpdateParamType = "LaunchTemplateVersion" UpdateParamTypeIdentityProviderConfig UpdateParamType = "IdentityProviderConfig" UpdateParamTypeEncryptionConfig UpdateParamType = "EncryptionConfig" UpdateParamTypeAddonVersion UpdateParamType = "AddonVersion" UpdateParamTypeServiceAccountRoleArn UpdateParamType = "ServiceAccountRoleArn" UpdateParamTypeResolveConflicts UpdateParamType = "ResolveConflicts" UpdateParamTypeNodeRepairEnabled UpdateParamType = "NodeRepairEnabled" UpdateParamTypeConfigurationValues UpdateParamType = "ConfigurationValues" UpdateParamTypeSecurityGroups UpdateParamType = "SecurityGroups" UpdateParamTypeSubnets UpdateParamType = "Subnets" UpdateParamTypeAuthenticationMode UpdateParamType = "AuthenticationMode" UpdateParamTypePodIdentityAssociations UpdateParamType = "PodIdentityAssociations" UpdateParamTypeUpgradePolicy UpdateParamType = "UpgradePolicy" UpdateParamTypeZonalShiftConfig UpdateParamType = "ZonalShiftConfig" UpdateParamTypeComputeConfig UpdateParamType = "ComputeConfig" UpdateParamTypeStorageConfig UpdateParamType = "StorageConfig" UpdateParamTypeKubernetesNetworkConfig UpdateParamType = "KubernetesNetworkConfig" )
Enum values for UpdateParamType
func (UpdateParamType) Values ¶ added in v0.29.0
func (UpdateParamType) Values() []UpdateParamType
Values returns all known values for UpdateParamType. Note that this can be expanded in the future, and so it is only as up to date as the client.
The ordering of this slice is not guaranteed to be stable across updates.
type UpdateStatus ¶
type UpdateStatus string
const ( UpdateStatusInProgress UpdateStatus = "InProgress" UpdateStatusFailed UpdateStatus = "Failed" UpdateStatusCancelled UpdateStatus = "Cancelled" UpdateStatusSuccessful UpdateStatus = "Successful" )
Enum values for UpdateStatus
func (UpdateStatus) Values ¶ added in v0.29.0
func (UpdateStatus) Values() []UpdateStatus
Values returns all known values for UpdateStatus. Note that this can be expanded in the future, and so it is only as up to date as the client.
The ordering of this slice is not guaranteed to be stable across updates.
type UpdateTaintsPayload ¶ added in v1.4.0
type UpdateTaintsPayload struct { // Kubernetes taints to be added or updated. AddOrUpdateTaints []Taint // Kubernetes taints to remove. RemoveTaints []Taint // contains filtered or unexported fields }
An object representing the details of an update to a taints payload. For more information, see Node taints on managed node groupsin the Amazon EKS User Guide.
type UpdateType ¶
type UpdateType string
const ( UpdateTypeVersionUpdate UpdateType = "VersionUpdate" UpdateTypeEndpointAccessUpdate UpdateType = "EndpointAccessUpdate" UpdateTypeLoggingUpdate UpdateType = "LoggingUpdate" UpdateTypeConfigUpdate UpdateType = "ConfigUpdate" UpdateTypeAssociateIdentityProviderConfig UpdateType = "AssociateIdentityProviderConfig" UpdateTypeDisassociateIdentityProviderConfig UpdateType = "DisassociateIdentityProviderConfig" UpdateTypeAssociateEncryptionConfig UpdateType = "AssociateEncryptionConfig" UpdateTypeAddonUpdate UpdateType = "AddonUpdate" UpdateTypeVpcConfigUpdate UpdateType = "VpcConfigUpdate" UpdateTypeAccessConfigUpdate UpdateType = "AccessConfigUpdate" UpdateTypeUpgradePolicyUpdate UpdateType = "UpgradePolicyUpdate" UpdateTypeZonalShiftConfigUpdate UpdateType = "ZonalShiftConfigUpdate" UpdateTypeAutoModeUpdate UpdateType = "AutoModeUpdate" )
Enum values for UpdateType
func (UpdateType) Values ¶ added in v0.29.0
func (UpdateType) Values() []UpdateType
Values returns all known values for UpdateType. Note that this can be expanded in the future, and so it is only as up to date as the client.
The ordering of this slice is not guaranteed to be stable across updates.
type UpgradePolicyRequest ¶ added in v1.47.0
type UpgradePolicyRequest struct { // If the cluster is set to EXTENDED , it will enter extended support at the end of // standard support. If the cluster is set to STANDARD , it will be automatically // upgraded at the end of standard support. // // [Learn more about EKS Extended Support in the EKS User Guide.] // // [Learn more about EKS Extended Support in the EKS User Guide.]: https://docs.aws.amazon.com/eks/latest/userguide/extended-support-control.html SupportType SupportType // contains filtered or unexported fields }
The support policy to use for the cluster. Extended support allows you to remain on specific Kubernetes versions for longer. Clusters in extended support have higher costs. The default value is EXTENDED . Use STANDARD to disable extended support.
Learn more about EKS Extended Support in the EKS User Guide.
type UpgradePolicyResponse ¶ added in v1.47.0
type UpgradePolicyResponse struct { // If the cluster is set to EXTENDED , it will enter extended support at the end of // standard support. If the cluster is set to STANDARD , it will be automatically // upgraded at the end of standard support. // // [Learn more about EKS Extended Support in the EKS User Guide.] // // [Learn more about EKS Extended Support in the EKS User Guide.]: https://docs.aws.amazon.com/eks/latest/userguide/extended-support-control.html SupportType SupportType // contains filtered or unexported fields }
This value indicates if extended support is enabled or disabled for the cluster.
Learn more about EKS Extended Support in the EKS User Guide.
type VpcConfigRequest ¶
type VpcConfigRequest struct { // Set this value to true to enable private access for your cluster's Kubernetes // API server endpoint. If you enable private access, Kubernetes API requests from // within your cluster's VPC use the private VPC endpoint. The default value for // this parameter is false , which disables private access for your Kubernetes API // server. If you disable private access and you have nodes or Fargate pods in the // cluster, then ensure that publicAccessCidrs includes the necessary CIDR blocks // for communication with the nodes or Fargate pods. For more information, see [Amazon EKS cluster endpoint access control]in // the Amazon EKS User Guide . // // [Amazon EKS cluster endpoint access control]: https://docs.aws.amazon.com/eks/latest/userguide/cluster-endpoint.html EndpointPrivateAccess *bool // Set this value to false to disable public access to your cluster's Kubernetes // API server endpoint. If you disable public access, your cluster's Kubernetes API // server can only receive requests from within the cluster VPC. The default value // for this parameter is true , which enables public access for your Kubernetes API // server. For more information, see [Amazon EKS cluster endpoint access control]in the Amazon EKS User Guide . // // [Amazon EKS cluster endpoint access control]: https://docs.aws.amazon.com/eks/latest/userguide/cluster-endpoint.html EndpointPublicAccess *bool // The CIDR blocks that are allowed access to your cluster's public Kubernetes API // server endpoint. Communication to the endpoint from addresses outside of the // CIDR blocks that you specify is denied. The default value is 0.0.0.0/0 . If // you've disabled private endpoint access, make sure that you specify the // necessary CIDR blocks for every node and Fargate Pod in the cluster. For more // information, see [Amazon EKS cluster endpoint access control]in the Amazon EKS User Guide . // // [Amazon EKS cluster endpoint access control]: https://docs.aws.amazon.com/eks/latest/userguide/cluster-endpoint.html PublicAccessCidrs []string // Specify one or more security groups for the cross-account elastic network // interfaces that Amazon EKS creates to use that allow communication between your // nodes and the Kubernetes control plane. If you don't specify any security // groups, then familiarize yourself with the difference between Amazon EKS // defaults for clusters deployed with Kubernetes. For more information, see [Amazon EKS security group considerations]in // the Amazon EKS User Guide . // // [Amazon EKS security group considerations]: https://docs.aws.amazon.com/eks/latest/userguide/sec-group-reqs.html SecurityGroupIds []string // Specify subnets for your Amazon EKS nodes. Amazon EKS creates cross-account // elastic network interfaces in these subnets to allow communication between your // nodes and the Kubernetes control plane. SubnetIds []string // contains filtered or unexported fields }
An object representing the VPC configuration to use for an Amazon EKS cluster.
type VpcConfigResponse ¶
type VpcConfigResponse struct { // The cluster security group that was created by Amazon EKS for the cluster. // Managed node groups use this security group for control-plane-to-data-plane // communication. ClusterSecurityGroupId *string // This parameter indicates whether the Amazon EKS private API server endpoint is // enabled. If the Amazon EKS private API server endpoint is enabled, Kubernetes // API requests that originate from within your cluster's VPC use the private VPC // endpoint instead of traversing the internet. If this value is disabled and you // have nodes or Fargate pods in the cluster, then ensure that publicAccessCidrs // includes the necessary CIDR blocks for communication with the nodes or Fargate // pods. For more information, see [Amazon EKS cluster endpoint access control]in the Amazon EKS User Guide . // // [Amazon EKS cluster endpoint access control]: https://docs.aws.amazon.com/eks/latest/userguide/cluster-endpoint.html EndpointPrivateAccess bool // Whether the public API server endpoint is enabled. EndpointPublicAccess bool // The CIDR blocks that are allowed access to your cluster's public Kubernetes API // server endpoint. PublicAccessCidrs []string // The security groups associated with the cross-account elastic network // interfaces that are used to allow communication between your nodes and the // Kubernetes control plane. SecurityGroupIds []string // The subnets associated with your cluster. SubnetIds []string // The VPC associated with your cluster. VpcId *string // contains filtered or unexported fields }
An object representing an Amazon EKS cluster VPC configuration response.
type ZonalShiftConfigRequest ¶ added in v1.51.0
type ZonalShiftConfigRequest struct { // If zonal shift is enabled, Amazon Web Services configures zonal autoshift for // the cluster. Enabled *bool // contains filtered or unexported fields }
The configuration for zonal shift for the cluster.
type ZonalShiftConfigResponse ¶ added in v1.51.0
type ZonalShiftConfigResponse struct { // Whether the zonal shift is enabled. Enabled *bool // contains filtered or unexported fields }
The status of zonal shift configuration for the cluster