Class Nodegroup
- java.lang.Object
-
- software.amazon.awssdk.services.eks.model.Nodegroup
-
- All Implemented Interfaces:
Serializable,SdkPojo,ToCopyableBuilder<Nodegroup.Builder,Nodegroup>
@Generated("software.amazon.awssdk:codegen") public final class Nodegroup extends Object implements SdkPojo, Serializable, ToCopyableBuilder<Nodegroup.Builder,Nodegroup>
An object representing an Amazon EKS managed node group.
- See Also:
- Serialized Form
-
-
Nested Class Summary
Nested Classes Modifier and Type Class Description static interfaceNodegroup.Builder
-
Method Summary
All Methods Static Methods Instance Methods Concrete Methods Modifier and Type Method Description AMITypesamiType()If the node group was deployed using a launch template with a custom AMI, then this isCUSTOM.StringamiTypeAsString()If the node group was deployed using a launch template with a custom AMI, then this isCUSTOM.static Nodegroup.Builderbuilder()CapacityTypescapacityType()The capacity type of your managed node group.StringcapacityTypeAsString()The capacity type of your managed node group.StringclusterName()The name of your cluster.InstantcreatedAt()The Unix epoch timestamp at object creation.IntegerdiskSize()If the node group wasn't deployed with a launch template, then this is the disk size in the node group configuration.booleanequals(Object obj)booleanequalsBySdkFields(Object obj)<T> Optional<T>getValueForField(String fieldName, Class<T> clazz)inthashCode()booleanhasInstanceTypes()For responses, this returns true if the service returned a value for the InstanceTypes property.booleanhasLabels()For responses, this returns true if the service returned a value for the Labels property.booleanhasSubnets()For responses, this returns true if the service returned a value for the Subnets property.booleanhasTags()For responses, this returns true if the service returned a value for the Tags property.booleanhasTaints()For responses, this returns true if the service returned a value for the Taints property.NodegroupHealthhealth()The health status of the node group.List<String>instanceTypes()If the node group wasn't deployed with a launch template, then this is the instance type that is associated with the node group.Map<String,String>labels()The Kuberneteslabelsapplied to the nodes in the node group.LaunchTemplateSpecificationlaunchTemplate()If a launch template was used to create the node group, then this is the launch template that was used.InstantmodifiedAt()The Unix epoch timestamp for the last modification to the object.StringnodegroupArn()The Amazon Resource Name (ARN) associated with the managed node group.StringnodegroupName()The name associated with an Amazon EKS managed node group.NodeRepairConfignodeRepairConfig()The node auto repair configuration for the node group.StringnodeRole()The IAM role associated with your node group.StringreleaseVersion()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.RemoteAccessConfigremoteAccess()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.NodegroupResourcesresources()The resources associated with the node group, such as Auto Scaling groups and security groups for remote access.NodegroupScalingConfigscalingConfig()The scaling configuration details for the Auto Scaling group that is associated with your node group.Map<String,SdkField<?>>sdkFieldNameToField()List<SdkField<?>>sdkFields()static Class<? extends Nodegroup.Builder>serializableBuilderClass()NodegroupStatusstatus()The current status of the managed node group.StringstatusAsString()The current status of the managed node group.List<String>subnets()The subnets that were specified for the Auto Scaling group that is associated with your node group.Map<String,String>tags()Metadata that assists with categorization and organization.List<Taint>taints()The Kubernetes taints to be applied to the nodes in the node group when they are created.Nodegroup.BuildertoBuilder()StringtoString()Returns a string representation of this object.NodegroupUpdateConfigupdateConfig()The node group update configuration.Stringversion()The Kubernetes version of the managed node group.-
Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, wait, wait, wait
-
Methods inherited from interface software.amazon.awssdk.utils.builder.ToCopyableBuilder
copy
-
-
-
-
Method Detail
-
nodegroupName
public final String nodegroupName()
The name associated with an Amazon EKS managed node group.
- Returns:
- The name associated with an Amazon EKS managed node group.
-
nodegroupArn
public final String nodegroupArn()
The Amazon Resource Name (ARN) associated with the managed node group.
- Returns:
- The Amazon Resource Name (ARN) associated with the managed node group.
-
clusterName
public final String clusterName()
The name of your cluster.
- Returns:
- The name of your cluster.
-
version
public final String version()
The Kubernetes version of the managed node group.
- Returns:
- The Kubernetes version of the managed node group.
-
releaseVersion
public final String releaseVersion()
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.
- Returns:
- 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.
-
createdAt
public final Instant createdAt()
The Unix epoch timestamp at object creation.
- Returns:
- The Unix epoch timestamp at object creation.
-
modifiedAt
public final Instant modifiedAt()
The Unix epoch timestamp for the last modification to the object.
- Returns:
- The Unix epoch timestamp for the last modification to the object.
-
status
public final NodegroupStatus status()
The current status of the managed node group.
If the service returns an enum value that is not available in the current SDK version,
statuswill returnNodegroupStatus.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available fromstatusAsString().- Returns:
- The current status of the managed node group.
- See Also:
NodegroupStatus
-
statusAsString
public final String statusAsString()
The current status of the managed node group.
If the service returns an enum value that is not available in the current SDK version,
statuswill returnNodegroupStatus.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available fromstatusAsString().- Returns:
- The current status of the managed node group.
- See Also:
NodegroupStatus
-
capacityType
public final CapacityTypes capacityType()
The capacity type of your managed node group.
If the service returns an enum value that is not available in the current SDK version,
capacityTypewill returnCapacityTypes.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available fromcapacityTypeAsString().- Returns:
- The capacity type of your managed node group.
- See Also:
CapacityTypes
-
capacityTypeAsString
public final String capacityTypeAsString()
The capacity type of your managed node group.
If the service returns an enum value that is not available in the current SDK version,
capacityTypewill returnCapacityTypes.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available fromcapacityTypeAsString().- Returns:
- The capacity type of your managed node group.
- See Also:
CapacityTypes
-
scalingConfig
public final NodegroupScalingConfig scalingConfig()
The scaling configuration details for the Auto Scaling group that is associated with your node group.
- Returns:
- The scaling configuration details for the Auto Scaling group that is associated with your node group.
-
hasInstanceTypes
public final boolean hasInstanceTypes()
For responses, this returns true if the service returned a value for the InstanceTypes property. This DOES NOT check that the value is non-empty (for which, you should check theisEmpty()method on the property). This is useful because the SDK will never return a null collection or map, but you may need to differentiate between the service returning nothing (or null) and the service returning an empty collection or map. For requests, this returns true if a value for the property was specified in the request builder, and false if a value was not specified.
-
instanceTypes
public final List<String> instanceTypes()
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.Attempts to modify the collection returned by this method will result in an UnsupportedOperationException.
This method will never return null. If you would like to know whether the service returned this field (so that you can differentiate between null and empty), you can use the
hasInstanceTypes()method.- Returns:
- 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.
-
hasSubnets
public final boolean hasSubnets()
For responses, this returns true if the service returned a value for the Subnets property. This DOES NOT check that the value is non-empty (for which, you should check theisEmpty()method on the property). This is useful because the SDK will never return a null collection or map, but you may need to differentiate between the service returning nothing (or null) and the service returning an empty collection or map. For requests, this returns true if a value for the property was specified in the request builder, and false if a value was not specified.
-
subnets
public final List<String> subnets()
The subnets that were specified for the Auto Scaling group that is associated with your node group.
Attempts to modify the collection returned by this method will result in an UnsupportedOperationException.
This method will never return null. If you would like to know whether the service returned this field (so that you can differentiate between null and empty), you can use the
hasSubnets()method.- Returns:
- The subnets that were specified for the Auto Scaling group that is associated with your node group.
-
remoteAccess
public final RemoteAccessConfig remoteAccess()
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.- Returns:
- 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.
-
amiType
public final AMITypes amiType()
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.If the service returns an enum value that is not available in the current SDK version,
amiTypewill returnAMITypes.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available fromamiTypeAsString().- Returns:
- 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. - See Also:
AMITypes
-
amiTypeAsString
public final String amiTypeAsString()
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.If the service returns an enum value that is not available in the current SDK version,
amiTypewill returnAMITypes.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available fromamiTypeAsString().- Returns:
- 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. - See Also:
AMITypes
-
nodeRole
public final String nodeRole()
The IAM role associated with your node group. The Amazon EKS node
kubeletdaemon 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.- Returns:
- The IAM role associated with your node group. The Amazon EKS node
kubeletdaemon 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.
-
hasLabels
public final boolean hasLabels()
For responses, this returns true if the service returned a value for the Labels property. This DOES NOT check that the value is non-empty (for which, you should check theisEmpty()method on the property). This is useful because the SDK will never return a null collection or map, but you may need to differentiate between the service returning nothing (or null) and the service returning an empty collection or map. For requests, this returns true if a value for the property was specified in the request builder, and false if a value was not specified.
-
labels
public final Map<String,String> labels()
The Kubernetes
labelsapplied to the nodes in the node group.Only
labelsthat are applied with the Amazon EKS API are shown here. There may be other Kuberneteslabelsapplied to the nodes in this group.Attempts to modify the collection returned by this method will result in an UnsupportedOperationException.
This method will never return null. If you would like to know whether the service returned this field (so that you can differentiate between null and empty), you can use the
hasLabels()method.- Returns:
- The Kubernetes
labelsapplied to the nodes in the node group.Only
labelsthat are applied with the Amazon EKS API are shown here. There may be other Kuberneteslabelsapplied to the nodes in this group.
-
hasTaints
public final boolean hasTaints()
For responses, this returns true if the service returned a value for the Taints property. This DOES NOT check that the value is non-empty (for which, you should check theisEmpty()method on the property). This is useful because the SDK will never return a null collection or map, but you may need to differentiate between the service returning nothing (or null) and the service returning an empty collection or map. For requests, this returns true if a value for the property was specified in the request builder, and false if a value was not specified.
-
taints
public final List<Taint> taints()
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, orNo_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.Attempts to modify the collection returned by this method will result in an UnsupportedOperationException.
This method will never return null. If you would like to know whether the service returned this field (so that you can differentiate between null and empty), you can use the
hasTaints()method.- Returns:
- 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, orNo_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.
-
resources
public final NodegroupResources resources()
The resources associated with the node group, such as Auto Scaling groups and security groups for remote access.
- Returns:
- The resources associated with the node group, such as Auto Scaling groups and security groups for remote access.
-
diskSize
public final Integer diskSize()
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.- Returns:
- 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.
-
health
public final NodegroupHealth health()
The health status of the node group. If there are issues with your node group's health, they are listed here.
- Returns:
- The health status of the node group. If there are issues with your node group's health, they are listed here.
-
updateConfig
public final NodegroupUpdateConfig updateConfig()
The node group update configuration.
- Returns:
- The node group update configuration.
-
nodeRepairConfig
public final NodeRepairConfig nodeRepairConfig()
The node auto repair configuration for the node group.
- Returns:
- The node auto repair configuration for the node group.
-
launchTemplate
public final LaunchTemplateSpecification launchTemplate()
If a launch template was used to create the node group, then this is the launch template that was used.
- Returns:
- If a launch template was used to create the node group, then this is the launch template that was used.
-
hasTags
public final boolean hasTags()
For responses, this returns true if the service returned a value for the Tags property. This DOES NOT check that the value is non-empty (for which, you should check theisEmpty()method on the property). This is useful because the SDK will never return a null collection or map, but you may need to differentiate between the service returning nothing (or null) and the service returning an empty collection or map. For requests, this returns true if a value for the property was specified in the request builder, and false if a value was not specified.
-
tags
public final Map<String,String> tags()
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.
Attempts to modify the collection returned by this method will result in an UnsupportedOperationException.
This method will never return null. If you would like to know whether the service returned this field (so that you can differentiate between null and empty), you can use the
hasTags()method.- Returns:
- 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.
-
toBuilder
public Nodegroup.Builder toBuilder()
- Specified by:
toBuilderin interfaceToCopyableBuilder<Nodegroup.Builder,Nodegroup>
-
builder
public static Nodegroup.Builder builder()
-
serializableBuilderClass
public static Class<? extends Nodegroup.Builder> serializableBuilderClass()
-
equalsBySdkFields
public final boolean equalsBySdkFields(Object obj)
- Specified by:
equalsBySdkFieldsin interfaceSdkPojo
-
toString
public final String toString()
Returns a string representation of this object. This is useful for testing and debugging. Sensitive data will be redacted from this string using a placeholder value.
-
sdkFieldNameToField
public final Map<String,SdkField<?>> sdkFieldNameToField()
- Specified by:
sdkFieldNameToFieldin interfaceSdkPojo
-
-