Updates an Amazon EKS managed node group configuration¶

Description¶

Updates an Amazon EKS managed node group configuration. Your node group continues to function during the update. The response output includes an update ID that you can use to track the status of your node group update with the describe_update API operation. You can update the Kubernetes labels and taints for a node group and the scaling and version update configuration.

Usage¶

eks_update_nodegroup_config(clusterName, nodegroupName, labels, taints,
  scalingConfig, updateConfig, nodeRepairConfig, warmPoolConfig,
  clientRequestToken)

Arguments¶

clusterName

[required] The name of your cluster.
nodegroupName

[required] The name of the managed node group to update.
labels

The Kubernetes labels to apply to the nodes in the node group after the update.
taints

The Kubernetes taints to be applied to the nodes in the node group after the update. For more information, see Node taints on managed node groups.
scalingConfig

The scaling configuration details for the Auto Scaling group after the update.
updateConfig

The node group update configuration.
nodeRepairConfig

The node auto repair configuration for the node group.
warmPoolConfig

The warm pool configuration to apply to the node group. You can use this to add a warm pool to an existing node group or modify the settings of an existing warm pool.
clientRequestToken

A unique, case-sensitive identifier that you provide to ensure the idempotency of the request.

Value¶

A list with the following syntax:

list(
  update = list(
    id = "string",
    status = "InProgress"|"Failed"|"Cancelled"|"Successful",
    type = "VersionUpdate"|"EndpointAccessUpdate"|"LoggingUpdate"|"ConfigUpdate"|"AssociateIdentityProviderConfig"|"DisassociateIdentityProviderConfig"|"AssociateEncryptionConfig"|"AddonUpdate"|"VpcConfigUpdate"|"AccessConfigUpdate"|"UpgradePolicyUpdate"|"ZonalShiftConfigUpdate"|"AutoModeUpdate"|"RemoteNetworkConfigUpdate"|"DeletionProtectionUpdate"|"CapabilityUpdate"|"ControlPlaneScalingConfigUpdate"|"VendedLogsUpdate"|"ControlPlaneEgressUpdate"|"VersionRollback"|"ControlPlaneComponentConfigUpdate"|"CertificateAuthorityUpdate",
    params = list(
      list(
        type = "Version"|"PlatformVersion"|"EndpointPrivateAccess"|"EndpointPublicAccess"|"ClusterLogging"|"DesiredSize"|"LabelsToAdd"|"LabelsToRemove"|"TaintsToAdd"|"TaintsToRemove"|"MaxSize"|"MinSize"|"ReleaseVersion"|"PublicAccessCidrs"|"LaunchTemplateName"|"LaunchTemplateVersion"|"IdentityProviderConfig"|"EncryptionConfig"|"AddonVersion"|"ServiceAccountRoleArn"|"ResolveConflicts"|"MaxUnavailable"|"MaxUnavailablePercentage"|"NodeRepairEnabled"|"UpdateStrategy"|"ConfigurationValues"|"SecurityGroups"|"Subnets"|"AuthenticationMode"|"PodIdentityAssociations"|"UpgradePolicy"|"ZonalShiftConfig"|"ComputeConfig"|"StorageConfig"|"KubernetesNetworkConfig"|"RemoteNetworkConfig"|"DeletionProtection"|"NodeRepairConfig"|"RoleArn"|"RoleMappingsToAddOrUpdate"|"RoleMappingsToRemove"|"NetworkAccess"|"VendedLogs"|"UpdatedTier"|"PreviousTier"|"WarmPoolEnabled"|"WarmPoolMaxGroupPreparedCapacity"|"WarmPoolMinSize"|"WarmPoolState"|"WarmPoolReuseOnScaleIn"|"ControlPlaneEgressMode"|"KubeApiServerConfig"|"KubeSchedulerConfig"|"KubeControllerManagerConfig"|"ActiveCertificateAuthority"|"TrustedCertificateAuthorities"|"CertificateAuthorityId"|"SigningStatus",
        value = "string"
      )
    ),
    createdAt = as.POSIXct(
      "2015-01-01"
    ),
    errors = list(
      list(
        errorCode = "SubnetNotFound"|"SecurityGroupNotFound"|"EniLimitReached"|"IpNotAvailable"|"AccessDenied"|"OperationNotPermitted"|"VpcIdNotFound"|"Unknown"|"NodeCreationFailure"|"PodEvictionFailure"|"InsufficientFreeAddresses"|"ClusterUnreachable"|"InsufficientNumberOfReplicas"|"ConfigurationConflict"|"AdmissionRequestDenied"|"UnsupportedAddonModification"|"K8sResourceNotFound",
        errorMessage = "string",
        resourceIds = list(
          "string"
        )
      )
    ),
    cancellation = list(
      status = "InProgress"|"Failed"|"Successful",
      reason = "string"
    )
  )
)

Request syntax¶

svc$update_nodegroup_config(
  clusterName = "string",
  nodegroupName = "string",
  labels = list(
    addOrUpdateLabels = list(
      "string"
    ),
    removeLabels = list(
      "string"
    )
  ),
  taints = list(
    addOrUpdateTaints = list(
      list(
        key = "string",
        value = "string",
        effect = "NO_SCHEDULE"|"NO_EXECUTE"|"PREFER_NO_SCHEDULE"
      )
    ),
    removeTaints = list(
      list(
        key = "string",
        value = "string",
        effect = "NO_SCHEDULE"|"NO_EXECUTE"|"PREFER_NO_SCHEDULE"
      )
    )
  ),
  scalingConfig = list(
    minSize = 123,
    maxSize = 123,
    desiredSize = 123
  ),
  updateConfig = list(
    maxUnavailable = 123,
    maxUnavailablePercentage = 123,
    updateStrategy = "DEFAULT"|"MINIMAL"
  ),
  nodeRepairConfig = list(
    enabled = TRUE|FALSE,
    maxUnhealthyNodeThresholdCount = 123,
    maxUnhealthyNodeThresholdPercentage = 123,
    maxParallelNodesRepairedCount = 123,
    maxParallelNodesRepairedPercentage = 123,
    nodeRepairConfigOverrides = list(
      list(
        nodeMonitoringCondition = "string",
        nodeUnhealthyReason = "string",
        minRepairWaitTimeMins = 123,
        repairAction = "Replace"|"Reboot"|"NoAction"
      )
    )
  ),
  warmPoolConfig = list(
    enabled = TRUE|FALSE,
    minSize = 123,
    maxGroupPreparedCapacity = 123,
    poolState = "STOPPED"|"RUNNING"|"HIBERNATED",
    reuseOnScaleIn = TRUE|FALSE
  ),
  clientRequestToken = "string"
)