@aws-sdk/client-eks
Version:
AWS SDK for JavaScript Eks Client for Node.js, Browser and React Native
129 lines (128 loc) • 6.74 kB
TypeScript
import { Command as $Command } from "@smithy/smithy-client";
import { MetadataBearer as __MetadataBearer } from "@smithy/types";
import { EKSClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../EKSClient";
import { UpdateAddonRequest, UpdateAddonResponse } from "../models/models_0";
/**
* @public
*/
export type { __MetadataBearer };
export { $Command };
/**
* @public
*
* The input for {@link UpdateAddonCommand}.
*/
export interface UpdateAddonCommandInput extends UpdateAddonRequest {
}
/**
* @public
*
* The output of {@link UpdateAddonCommand}.
*/
export interface UpdateAddonCommandOutput extends UpdateAddonResponse, __MetadataBearer {
}
declare const UpdateAddonCommand_base: {
new (input: UpdateAddonCommandInput): import("@smithy/smithy-client").CommandImpl<UpdateAddonCommandInput, UpdateAddonCommandOutput, EKSClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes>;
new (__0_0: UpdateAddonCommandInput): import("@smithy/smithy-client").CommandImpl<UpdateAddonCommandInput, UpdateAddonCommandOutput, EKSClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes>;
getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions;
};
/**
* <p>Updates an Amazon EKS add-on.</p>
* @example
* Use a bare-bones client and the command you need to make an API call.
* ```javascript
* import { EKSClient, UpdateAddonCommand } from "@aws-sdk/client-eks"; // ES Modules import
* // const { EKSClient, UpdateAddonCommand } = require("@aws-sdk/client-eks"); // CommonJS import
* const client = new EKSClient(config);
* const input = { // UpdateAddonRequest
* clusterName: "STRING_VALUE", // required
* addonName: "STRING_VALUE", // required
* addonVersion: "STRING_VALUE",
* serviceAccountRoleArn: "STRING_VALUE",
* resolveConflicts: "OVERWRITE" || "NONE" || "PRESERVE",
* clientRequestToken: "STRING_VALUE",
* configurationValues: "STRING_VALUE",
* podIdentityAssociations: [ // AddonPodIdentityAssociationsList
* { // AddonPodIdentityAssociations
* serviceAccount: "STRING_VALUE", // required
* roleArn: "STRING_VALUE", // required
* },
* ],
* };
* const command = new UpdateAddonCommand(input);
* const response = await client.send(command);
* // { // UpdateAddonResponse
* // update: { // Update
* // id: "STRING_VALUE",
* // status: "InProgress" || "Failed" || "Cancelled" || "Successful",
* // type: "VersionUpdate" || "EndpointAccessUpdate" || "LoggingUpdate" || "ConfigUpdate" || "AssociateIdentityProviderConfig" || "DisassociateIdentityProviderConfig" || "AssociateEncryptionConfig" || "AddonUpdate" || "VpcConfigUpdate" || "AccessConfigUpdate" || "UpgradePolicyUpdate" || "ZonalShiftConfigUpdate" || "AutoModeUpdate",
* // params: [ // UpdateParams
* // { // UpdateParam
* // 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",
* // value: "STRING_VALUE",
* // },
* // ],
* // createdAt: new Date("TIMESTAMP"),
* // errors: [ // ErrorDetails
* // { // ErrorDetail
* // errorCode: "SubnetNotFound" || "SecurityGroupNotFound" || "EniLimitReached" || "IpNotAvailable" || "AccessDenied" || "OperationNotPermitted" || "VpcIdNotFound" || "Unknown" || "NodeCreationFailure" || "PodEvictionFailure" || "InsufficientFreeAddresses" || "ClusterUnreachable" || "InsufficientNumberOfReplicas" || "ConfigurationConflict" || "AdmissionRequestDenied" || "UnsupportedAddonModification" || "K8sResourceNotFound",
* // errorMessage: "STRING_VALUE",
* // resourceIds: [ // StringList
* // "STRING_VALUE",
* // ],
* // },
* // ],
* // },
* // };
*
* ```
*
* @param UpdateAddonCommandInput - {@link UpdateAddonCommandInput}
* @returns {@link UpdateAddonCommandOutput}
* @see {@link UpdateAddonCommandInput} for command's `input` shape.
* @see {@link UpdateAddonCommandOutput} for command's `response` shape.
* @see {@link EKSClientResolvedConfig | config} for EKSClient's `config` shape.
*
* @throws {@link ClientException} (client fault)
* <p>These errors are usually caused by a client action. Actions can include using an
* action or resource on behalf of an <a href="https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_terms-and-concepts.html">IAM principal</a> that doesn't have permissions to use
* the action or resource or specifying an identifier that is not valid.</p>
*
* @throws {@link InvalidParameterException} (client fault)
* <p>The specified parameter is invalid. Review the available parameters for the API
* request.</p>
*
* @throws {@link InvalidRequestException} (client fault)
* <p>The request is invalid given the state of the cluster. Check the state of the cluster
* and the associated operations.</p>
*
* @throws {@link ResourceInUseException} (client fault)
* <p>The specified resource is in use.</p>
*
* @throws {@link ResourceNotFoundException} (client fault)
* <p>The specified resource could not be found. You can view your available clusters with
* <code>ListClusters</code>. You can view your available managed node groups with
* <code>ListNodegroups</code>. Amazon EKS clusters and node groups are Amazon Web Services Region
* specific.</p>
*
* @throws {@link ServerException} (server fault)
* <p>These errors are usually caused by a server-side issue.</p>
*
* @throws {@link EKSServiceException}
* <p>Base exception class for all service exceptions from EKS service.</p>
*
* @public
*/
export declare class UpdateAddonCommand extends UpdateAddonCommand_base {
/** @internal type navigation helper, not in runtime. */
protected static __types: {
api: {
input: UpdateAddonRequest;
output: UpdateAddonResponse;
};
sdk: {
input: UpdateAddonCommandInput;
output: UpdateAddonCommandOutput;
};
};
}