Skip to main content

kafka_versions

Creates, updates, deletes, gets or lists a kafka_versions resource.

Overview

Namekafka_versions
TypeResource
Idaws.kafka.kafka_versions

Fields

The following fields are returned by SELECT queries:

NameDatatypeDescription
statusstring (ACTIVE, DEPRECATED)
versionstring

Methods

The following methods are available for this resource:

NameAccessible byRequired ParamsOptional ParamsDescription
list_kafka_versionsselectregionmaxResults, nextTokenReturns a list of Apache Kafka versions.
update_cluster_kafka_versionupdatecluster_arn, region, CurrentVersion, TargetKafkaVersionUpdates the Apache Kafka version for the cluster.

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
cluster_arnstringThe Amazon Resource Name (ARN) of the cluster to be updated.
regionstringAWS region (default: us-east-1)
maxResultsintegerThe maximum number of results to return in the response. If there are more results, the response includes a NextToken parameter.
nextTokenstringThe paginated results marker. When the result of the operation is truncated, the call returns NextToken in the response. To get the next batch, provide this token in your next request.

SELECT examples

Returns a list of Apache Kafka versions.

SELECT
status,
version
FROM aws.kafka.kafka_versions
WHERE region = '{{ region }}' -- required
AND maxResults = '{{ maxResults }}'
AND nextToken = '{{ nextToken }}'
;

UPDATE examples

Updates the Apache Kafka version for the cluster.

UPDATE aws.kafka.kafka_versions
SET
ConfigurationInfo = '{{ ConfigurationInfo }}',
CurrentVersion = '{{ CurrentVersion }}',
TargetKafkaVersion = '{{ TargetKafkaVersion }}'
WHERE
cluster_arn = '{{ cluster_arn }}' --required
AND region = '{{ region }}' --required
AND CurrentVersion = '{{ CurrentVersion }}' --required
AND TargetKafkaVersion = '{{ TargetKafkaVersion }}' --required
RETURNING
cluster_arn,
cluster_operation_arn;