Skip to main content

addon_versions

Creates, updates, deletes, gets or lists an addon_versions resource.

Overview

Nameaddon_versions
TypeResource
Idaws.eks.addon_versions

Fields

The following fields are returned by SELECT queries:

NameDatatypeDescription
addon_namestringThe name of the add-on.
addon_versionsarrayAn object representing information about available add-on versions and compatible Kubernetes versions.
default_namespacestringThe default Kubernetes namespace where this addon is typically installed if no custom namespace is specified.
marketplace_informationobjectInformation about the add-on from the Amazon Web Services Marketplace.
ownerstringThe owner of the add-on.
publisherstringThe publisher of the add-on.
type_stringThe type of the add-on.

Methods

The following methods are available for this resource:

NameAccessible byRequired ParamsOptional ParamsDescription
describe_addon_versionsselectregionkubernetesVersion, maxResults, nextToken, addonName, types, publishers, ownersDescribes the versions for an add-on. Information such as the Kubernetes versions that you can use the add-on with, the owner, publisher, and the type of the add-on are returned.

Parameters

Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.

NameDatatypeDescription
regionstringAWS region (default: us-east-1)
addonNamestringThe name of the add-on. The name must match one of the names returned by ListAddons .
kubernetesVersionstringThe Kubernetes versions that you can use the add-on with.
maxResultsintegerThe maximum number of results, returned in paginated output. You receive maxResults in a single page, along with a nextToken response element. You can see the remaining results of the initial request by sending another request with the returned nextToken value. This value can be between 1 and 100. If you don't use this parameter, 100 results and a nextToken value, if applicable, are returned.
nextTokenstringThe nextToken value returned from a previous paginated request, where maxResults was used and the results exceeded the value of that parameter. Pagination continues from the end of the previous results that returned the nextToken value. This value is null when there are no more results to return. This token should be treated as an opaque identifier that is used only to retrieve the next items in a list and not for other programmatic purposes.
ownersarrayThe owner of the add-on. For valid owners, don't specify a value for this property.
publishersarrayThe publisher of the add-on. For valid publishers, don't specify a value for this property.
typesarrayThe type of the add-on. For valid types, don't specify a value for this property.

SELECT examples

Describes the versions for an add-on. Information such as the Kubernetes versions that you can use the add-on with, the owner, publisher, and the type of the add-on are returned.

SELECT
addon_name,
addon_versions,
default_namespace,
marketplace_information,
owner,
publisher,
type_
FROM aws.eks.addon_versions
WHERE region = '{{ region }}' -- required
AND kubernetesVersion = '{{ kubernetesVersion }}'
AND maxResults = '{{ maxResults }}'
AND nextToken = '{{ nextToken }}'
AND addonName = '{{ addonName }}'
AND types = '{{ types }}'
AND publishers = '{{ publishers }}'
AND owners = '{{ owners }}'
;