Documentation ¶
Index ¶
- type AMITypes
- type AccessDeniedException
- type Addon
- type AddonHealth
- type AddonInfo
- type AddonIssue
- type AddonIssueCode
- type AddonStatus
- type AddonVersionInfo
- type AutoScalingGroup
- type BadRequestException
- type CapacityTypes
- type Certificate
- type ClientException
- type Cluster
- type ClusterHealth
- type ClusterIssue
- type ClusterIssueCode
- type ClusterStatus
- type Compatibility
- type ConfigStatus
- type ConnectorConfigProvider
- type ConnectorConfigRequest
- type ConnectorConfigResponse
- type ControlPlanePlacementRequest
- type ControlPlanePlacementResponse
- type EncryptionConfig
- type ErrorCode
- type ErrorDetail
- type FargateProfile
- type FargateProfileSelector
- type FargateProfileStatus
- type Identity
- type IdentityProviderConfig
- type IdentityProviderConfigResponse
- type InvalidParameterException
- type InvalidRequestException
- type IpFamily
- type Issue
- type KubernetesNetworkConfigRequest
- type KubernetesNetworkConfigResponse
- type LaunchTemplateSpecification
- type LogSetup
- type LogType
- type Logging
- type MarketplaceInformation
- 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 Provider
- type RemoteAccessConfig
- type ResolveConflicts
- type ResourceInUseException
- type ResourceLimitExceededException
- type ResourceNotFoundException
- type ResourcePropagationDelayException
- type ServerException
- type ServiceUnavailableException
- type Taint
- type TaintEffect
- type UnsupportedAvailabilityZoneException
- type Update
- type UpdateLabelsPayload
- type UpdateParam
- type UpdateParamType
- type UpdateStatus
- type UpdateTaintsPayload
- type UpdateType
- type VpcConfigRequest
- type VpcConfigResponse
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" )
Enum values for AMITypes
type AccessDeniedException ¶ added in v1.14.0
type AccessDeniedException struct { Message *string // contains filtered or unexported fields }
You don't have permissions to perform the requested operation. The user or role that is making the request must have at least one IAM permissions policy attached that grants the required permissions. For more information, see Access Management (https://docs.aws.amazon.com/IAM/latest/UserGuide/access.html) in 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 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 the cluster. ClusterName *string // The date and time that the add-on was created. CreatedAt *time.Time // An object representing the health of the add-on. Health *AddonHealth // Information about an Amazon EKS add-on from the Amazon Web Services Marketplace. MarketplaceInformation *MarketplaceInformation // The date and time that the add-on was last modified. ModifiedAt *time.Time // The owner of the add-on. Owner *string // The publisher of the add-on. Publisher *string // The Amazon Resource Name (ARN) of the IAM role that is bound to the Kubernetes // service account used by the add-on. ServiceAccountRoleArn *string // The status of the add-on. Status AddonStatus // The metadata that you apply to the add-on to assist with categorization and // organization. Each tag consists of a key and an optional value. You define both. // Add-on tags do not propagate to any other resources associated with the cluster. Tags map[string]string // contains filtered or unexported fields }
An Amazon EKS add-on. For more information, see Amazon EKS add-ons (https://docs.aws.amazon.com/eks/latest/userguide/eks-add-ons.html) in the Amazon EKS User Guide.
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" )
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 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 // Whether the add-on requires configuration. RequiresConfiguration bool // contains filtered or unexported fields }
Information about an add-on version.
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 // 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 CapacityTypes ¶ added in v0.31.0
type CapacityTypes string
const ( CapacityTypesOnDemand CapacityTypes = "ON_DEMAND" CapacityTypesSpot CapacityTypes = "SPOT" )
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 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 ClusterName *string NodegroupName *string AddonName *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 a user that 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 Cluster ¶
type Cluster struct { // The Amazon Resource Name (ARN) of the cluster. Arn *string // The certificate-authority-data for your cluster. CertificateAuthority *Certificate // Unique, case-sensitive identifier that you provide to ensure the idempotency of // the request. ClientRequestToken *string // The configuration used to connect to a cluster for registration. ConnectorConfig *ConnectorConfigResponse // The Unix epoch timestamp in seconds for when the cluster was created. 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 local Amazon EKS cluster on an Amazon // Web Services Outpost. This object isn't available for clusters on the Amazon Web // Services cloud. 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 the 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, see // Platform Versions // (https://docs.aws.amazon.com/eks/latest/userguide/platform-versions.html) in the // Amazon EKS User Guide . PlatformVersion *string // 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 // (https://docs.aws.amazon.com/eks/latest/userguide/network_reqs.html) and Cluster // Security Group Considerations // (https://docs.aws.amazon.com/eks/latest/userguide/sec-group-reqs.html) in the // Amazon EKS User Guide. 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 // The metadata that you apply to the cluster to assist with categorization and // organization. Each tag consists of a key and an optional value. You define both. // Cluster tags do not propagate to any other resources associated with the // cluster. Tags map[string]string // The Kubernetes server version for the cluster. Version *string // 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 local Amazon EKS cluster on an // Amazon Web Services Outpost. Issues []ClusterIssue // contains filtered or unexported fields }
An object representing the health of your local Amazon EKS cluster on an Amazon Web Services Outpost. You can't use this API with an Amazon EKS cluster on the Amazon Web Services cloud.
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 local Amazon EKS cluster on an Amazon Web Services Outpost. You can't use this API with an Amazon EKS cluster on the Amazon Web Services cloud.
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" )
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 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 (https://docs.aws.amazon.com/eks/latest/userguide/eks-outposts-capacity-considerations.html) 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 (https://docs.aws.amazon.com/eks/latest/userguide/eks-outposts-capacity-considerations.html) in the Amazon 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 free 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 the Amazon EKS cluster that the Fargate profile belongs to. ClusterName *string // The Unix epoch timestamp in seconds for when the Fargate profile was created. CreatedAt *time.Time // The full Amazon Resource Name (ARN) of the Fargate profile. FargateProfileArn *string // The name of the Fargate profile. FargateProfileName *string // The Amazon Resource Name (ARN) of the pod execution role to use for pods that // match the selectors in the Fargate profile. For more information, see Pod // Execution Role // (https://docs.aws.amazon.com/eks/latest/userguide/pod-execution-role.html) in // the Amazon EKS User Guide. PodExecutionRoleArn *string // The selectors to match for pods to use this Fargate profile. Selectors []FargateProfileSelector // The current status of the Fargate profile. Status FargateProfileStatus // The IDs of subnets to launch pods into. Subnets []string // The metadata applied to the Fargate profile to assist with categorization and // organization. Each tag consists of a key and an optional value. You define both. // Fargate profile tags do not propagate to any other resources associated with the // Fargate profile, such as the pods that are scheduled with it. Tags map[string]string // contains filtered or unexported fields }
An object representing an Fargate profile.
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 (https://openid.net/connect/) identity // provider information. 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 InvalidParameterException ¶
type InvalidParameterException struct { Message *string ClusterName *string NodegroupName *string FargateProfileName *string AddonName *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 ClusterName *string NodegroupName *string AddonName *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. // // * 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 // (https://docs.aws.amazon.com/vpc/latest/userguide/vpc-ip-addressing.html#subnet-public-ip) // 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 // (https://docs.aws.amazon.com/eks/latest/userguide/create-node-role.html) // permissions or lack of outbound internet access for the nodes. 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 { // 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 // (https://docs.aws.amazon.com/eks/latest/userguide/cni-ipv6.html) 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. 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 and // can't change this value once 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 { // The IP family used to assign Kubernetes pod and service 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 add-on and specified ipv6 when you created // the cluster. IpFamily IpFamily // The CIDR block that Kubernetes pod and service 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 SubnetId (https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_CreateNetworkInterface.html), IamInstanceProfile (https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_IamInstanceProfile.html), RequestSpotInstances (https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_RequestSpotInstances.html), HibernationOptions (https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_HibernationOptionsRequest.html), or TerminateInstances (https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_TerminateInstances.html), or the node group deployment or update will fail. For more information about launch templates, see CreateLaunchTemplate (https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_CreateLaunchTemplate.html) in the Amazon EC2 API Reference. For more information about using launch templates with Amazon EKS, see Launch template support (https://docs.aws.amazon.com/eks/latest/userguide/launch-templates.html) in 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 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 the cluster that the managed node group resides in. ClusterName *string // The Unix epoch timestamp in seconds for when the managed node group was created. 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 in seconds for when the managed node group was last // modified. ModifiedAt *time.Time // 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 // The metadata applied to the node group to assist with categorization and // organization. Each tag consists of a key and an optional value. You define both. // Node group tags do not propagate to any other resources associated with the node // group, such as the Amazon EC2 instances or subnets. 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 // (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" 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" NodegroupIssueCodeEc2SubnetMissingIpv6Assignment NodegroupIssueCode = "Ec2SubnetMissingIpv6Assignment" )
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 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 Cluster Autoscaler // reduce the number if there are too many. When Cluster Autoscaler is used, the // desiredSize parameter is altered by Cluster Autoscaler (but can be out-of-date // for short periods of time). Cluster Autoscaler doesn't scale a managed node // group lower than minSize or higher than maxSize. 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 // (https://docs.aws.amazon.com/eks/latest/userguide/service-quotas.html) in the // Amazon EKS User Guide. 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 { // will be updated in parallel. This value or maxUnavailablePercentage is required // to have a value.The maximum number is 100. MaxUnavailable *int32 // percentage of nodes will be 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 // 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 (https://openid.net/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 cluster that the configuration is associated to. 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 // The metadata to apply to the provider configuration to assist with // categorization and organization. Each tag consists of a key and an optional // value. You define both. 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 OpenID 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 OpenID 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. Per 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 // (https://docs.aws.amazon.com/eks/latest/userguide/service-quotas.html) in the // Amazon EKS User Guide. 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 OpenID 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 OpenID Connect identity provider (https://docs.aws.amazon.com/eks/latest/userguide/authenticate-oidc-identity-provider.html) in 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 // (https://docs.aws.amazon.com/eks/latest/userguide/eks-outposts-capacity-considerations.html) // 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. // // 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 // (https://docs.aws.amazon.com/eks/latest/userguide/eks-outposts-capacity-considerations.html) // in the Amazon EKS User Guide. 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 Outpost (https://docs.aws.amazon.com/eks/latest/userguide/eks-outposts-local-cluster-create.html) in 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 // (https://docs.aws.amazon.com/eks/latest/userguide/eks-outposts-capacity-considerations.html) // in the Amazon EKS User Guide. 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 Provider ¶
type Provider struct { // Amazon Resource Name (ARN) or alias of the KMS key. The KMS key must be // symmetric, created in the same region as the cluster, and if the KMS key was // created in a different account, the user must have access to the KMS key. For // more information, see Allowing Users in Other Accounts to Use a KMS key // (https://docs.aws.amazon.com/kms/latest/developerguide/key-policy-modifying-external-accounts.html) // in the Key Management Service Developer Guide. 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 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 // (https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-key-pairs.html) in the // Amazon Elastic Compute Cloud User Guide for Linux Instances. Ec2SshKey *string // The security groups that are allowed SSH access (port 22) to the nodes. If you // specify an Amazon EC2 SSH key but do not specify a source security group when // you create a managed node group, then port 22 on the nodes is opened to the // internet (0.0.0.0/0). For more information, see Security Groups for Your VPC // (https://docs.aws.amazon.com/vpc/latest/userguide/VPC_SecurityGroups.html) in // the Amazon Virtual Private Cloud User Guide. SourceSecurityGroups []string // contains filtered or unexported fields }
An object representing the remote access configuration for the managed node group.
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 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 ClusterName *string NodegroupName *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 ClusterName *string NodegroupName *string FargateProfileName *string AddonName *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 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 // 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 ClusterName *string NodegroupName *string AddonName *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 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 set of pods. For more information, see Node taints on managed node groups (https://docs.aws.amazon.com/eks/latest/userguide/node-taints-managed-node-groups.html).
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 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 in seconds for when the update was created. 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 UpdateLabelsPayload ¶
type UpdateLabelsPayload struct { // Kubernetes labels to be added or updated. AddOrUpdateLabels map[string]string // Kubernetes labels to be removed. 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" )
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 groups (https://docs.aws.amazon.com/eks/latest/userguide/node-taints-managed-node-groups.html).
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" )
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 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 // (https://docs.aws.amazon.com/eks/latest/userguide/cluster-endpoint.html) in the // Amazon EKS User Guide . 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 // (https://docs.aws.amazon.com/eks/latest/userguide/cluster-endpoint.html) in the // Amazon EKS User Guide . 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 and you have nodes or Fargate pods in // the cluster, then ensure that you specify the necessary CIDR blocks. For more // information, see Amazon EKS cluster endpoint access control // (https://docs.aws.amazon.com/eks/latest/userguide/cluster-endpoint.html) in the // Amazon EKS User Guide . 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 // (https://docs.aws.amazon.com/eks/latest/userguide/sec-group-reqs.html) in the // Amazon EKS User Guide . 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 // (https://docs.aws.amazon.com/eks/latest/userguide/cluster-endpoint.html) in the // Amazon EKS User Guide . EndpointPrivateAccess bool // This parameter indicates whether the Amazon EKS public API server endpoint is // enabled. If the Amazon EKS public API server endpoint is disabled, your // cluster's Kubernetes API server can only receive requests that originate from // within the cluster VPC. 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 // listed CIDR blocks is denied. The default value is 0.0.0.0/0. If you've disabled // private endpoint access and you have nodes or Fargate pods in the cluster, then // ensure that the necessary CIDR blocks are listed. For more information, see // Amazon EKS cluster endpoint access control // (https://docs.aws.amazon.com/eks/latest/userguide/cluster-endpoint.html) in the // Amazon EKS User Guide . 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.