describe_update

describe_update(**kwargs)

Returns descriptive information about an update against your Amazon EKS cluster or associated managed node group or Amazon EKS add-on.

When the status of the update is Succeeded , the update is complete. If an update fails, the status is Failed , and an error detail explains the reason for the failure.

See also: AWS API Documentation

Request Syntax

response = client.describe_update(
    name='string',
    updateId='string',
    nodegroupName='string',
    addonName='string'
)

Parameters

• name (string) --

  [REQUIRED]

  The name of the Amazon EKS cluster associated with the update.

• updateId (string) --

  [REQUIRED]

  The ID of the update to describe.

• nodegroupName (string) -- The name of the Amazon EKS node group associated with the update. This parameter is required if the update is a node group update.
• addonName (string) -- The name of the add-on. The name must match one of the names returned by ListAddons. This parameter is required if the update is an add-on update.

Return type

dict

Returns

Response Syntax

{
    'update': {
        'id': 'string',
        'status': 'InProgress'|'Failed'|'Cancelled'|'Successful',
        'type': 'VersionUpdate'|'EndpointAccessUpdate'|'LoggingUpdate'|'ConfigUpdate'|'AssociateIdentityProviderConfig'|'DisassociateIdentityProviderConfig'|'AssociateEncryptionConfig'|'AddonUpdate',
        'params': [
            {
                'type': 'Version'|'PlatformVersion'|'EndpointPrivateAccess'|'EndpointPublicAccess'|'ClusterLogging'|'DesiredSize'|'LabelsToAdd'|'LabelsToRemove'|'TaintsToAdd'|'TaintsToRemove'|'MaxSize'|'MinSize'|'ReleaseVersion'|'PublicAccessCidrs'|'LaunchTemplateName'|'LaunchTemplateVersion'|'IdentityProviderConfig'|'EncryptionConfig'|'AddonVersion'|'ServiceAccountRoleArn'|'ResolveConflicts'|'MaxUnavailable'|'MaxUnavailablePercentage',
                'value': 'string'
            },
        ],
        'createdAt': datetime(2015, 1, 1),
        'errors': [
            {
                'errorCode': 'SubnetNotFound'|'SecurityGroupNotFound'|'EniLimitReached'|'IpNotAvailable'|'AccessDenied'|'OperationNotPermitted'|'VpcIdNotFound'|'Unknown'|'NodeCreationFailure'|'PodEvictionFailure'|'InsufficientFreeAddresses'|'ClusterUnreachable'|'InsufficientNumberOfReplicas'|'ConfigurationConflict'|'AdmissionRequestDenied'|'UnsupportedAddonModification'|'K8sResourceNotFound',
                'errorMessage': 'string',
                'resourceIds': [
                    'string',
                ]
            },
        ]
    }
}

Response Structure

• (dict) --

  • update (dict) --

    The full description of the specified update.

    • id (string) --

      A UUID that is used to track the update.

    • status (string) --

      The current status of the update.

    • type (string) --

      The type of the update.

    • params (list) --

      A key-value map that contains the parameters associated with the update.

      • (dict) --

        An object representing the details of an update request.

        • type (string) --

          The keys associated with an update request.

        • value (string) --

          The value of the keys submitted as part of an update request.

    • createdAt (datetime) --

      The Unix epoch timestamp in seconds for when the update was created.

    • errors (list) --

      Any errors associated with a Failed update.

      • (dict) --

        An object representing an error when an asynchronous operation fails.

        • errorCode (string) --

          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.

        • errorMessage (string) --

          A more complete description of the error.

        • resourceIds (list) --

          An optional field that contains the resource IDs associated with the error.

          • (string) --

Exceptions

• EKS.Client.exceptions.InvalidParameterException
• EKS.Client.exceptions.ClientException
• EKS.Client.exceptions.ServerException
• EKS.Client.exceptions.ResourceNotFoundException