kafka function

Managed Streaming for Kafka

Managed Streaming for Kafka

The operations for managing an Amazon MSK cluster.

kafka(config = list(), credentials = list(), endpoint = NULL, region = NULL)

Arguments

  • config: Optional configuration of credentials, endpoint, and/or region.

    • credentials :

      • creds :

        • access_key_id : AWS access key ID
        • secret_access_key : AWS secret access key
        • session_token : AWS temporary session token
      • profile : The name of a profile to use. If not given, then the default profile is used.

      • anonymous : Set anonymous credentials.

    • endpoint : The complete URL to use for the constructed client.

    • region : The AWS Region used in instantiating the client.

    • close_connection : Immediately close all HTTP connections.

    • timeout : The time in seconds till a timeout exception is thrown when attempting to make a connection. The default is 60 seconds.

    • s3_force_path_style : Set this to true to force the request to use path-style addressing, i.e. http://s3.amazonaws.com/BUCKET/KEY.

    • sts_regional_endpoint : Set sts regional endpoint resolver to regional or legacy https://docs.aws.amazon.com/sdkref/latest/guide/feature-sts-regionalized-endpoints.html

  • credentials: Optional credentials shorthand for the config parameter

    • creds :

      • access_key_id : AWS access key ID
      • secret_access_key : AWS secret access key
      • session_token : AWS temporary session token
    • profile : The name of a profile to use. If not given, then the default profile is used.

    • anonymous : Set anonymous credentials.

  • endpoint: Optional shorthand for complete URL to use for the constructed client.

  • region: Optional shorthand for AWS Region used in instantiating the client.

Returns

A client for the service. You can call the service's operations using syntax like svc$operation(...), where svc is the name you've assigned to the client. The available operations are listed in the Operations section.

Service syntax

svc <- kafka(
  config = list(
    credentials = list(
 creds = list(
   access_key_id = "string",
   secret_access_key = "string",
   session_token = "string"
 ),
 profile = "string",
 anonymous = "logical"
    ),
    endpoint = "string",
    region = "string",
    close_connection = "logical",
    timeout = "numeric",
    s3_force_path_style = "logical",
    sts_regional_endpoint = "string"
  ),
  credentials = list(
    creds = list(
 access_key_id = "string",
 secret_access_key = "string",
 session_token = "string"
    ),
    profile = "string",
    anonymous = "logical"
  ),
  endpoint = "string",
  region = "string"
)

Operations

batch_associate_scram_secretAssociates one or more Scram Secrets with an Amazon MSK cluster
batch_disassociate_scram_secretDisassociates one or more Scram Secrets from an Amazon MSK cluster
create_clusterCreates a new MSK cluster
create_cluster_v2Creates a new MSK cluster
create_configurationCreates a new MSK configuration
create_replicatorCreates the replicator
create_vpc_connectionCreates a new MSK VPC connection
delete_clusterDeletes the MSK cluster specified by the Amazon Resource Name (ARN) in the request
delete_cluster_policyDeletes the MSK cluster policy specified by the Amazon Resource Name (ARN) in the request
delete_configurationDeletes an MSK Configuration
delete_replicatorDeletes a replicator
delete_vpc_connectionDeletes a MSK VPC connection
describe_clusterReturns a description of the MSK cluster whose Amazon Resource Name (ARN) is specified in the request
describe_cluster_operationReturns a description of the cluster operation specified by the ARN
describe_cluster_operation_v2Returns a description of the cluster operation specified by the ARN
describe_cluster_v2Returns a description of the MSK cluster whose Amazon Resource Name (ARN) is specified in the request
describe_configurationReturns a description of this MSK configuration
describe_configuration_revisionReturns a description of this revision of the configuration
describe_replicatorDescribes a replicator
describe_vpc_connectionReturns a description of this MSK VPC connection
get_bootstrap_brokersA list of brokers that a client application can use to bootstrap
get_cluster_policyGet the MSK cluster policy specified by the Amazon Resource Name (ARN) in the request
get_compatible_kafka_versionsGets the Apache Kafka versions to which you can update the MSK cluster
list_client_vpc_connectionsReturns a list of all the VPC connections in this Region
list_cluster_operationsReturns a list of all the operations that have been performed on the specified MSK cluster
list_cluster_operations_v2Returns a list of all the operations that have been performed on the specified MSK cluster
list_clustersReturns a list of all the MSK clusters in the current Region
list_clusters_v2Returns a list of all the MSK clusters in the current Region
list_configuration_revisionsReturns a list of all the MSK configurations in this Region
list_configurationsReturns a list of all the MSK configurations in this Region
list_kafka_versionsReturns a list of Apache Kafka versions
list_nodesReturns a list of the broker nodes in the cluster
list_replicatorsLists the replicators
list_scram_secretsReturns a list of the Scram Secrets associated with an Amazon MSK cluster
list_tags_for_resourceReturns a list of the tags associated with the specified resource
list_vpc_connectionsReturns a list of all the VPC connections in this Region
put_cluster_policyCreates or updates the MSK cluster policy specified by the cluster Amazon Resource Name (ARN) in the request
reboot_brokerReboots brokers
reject_client_vpc_connectionReturns empty response
tag_resourceAdds tags to the specified MSK resource
untag_resourceRemoves the tags associated with the keys that are provided in the query
update_broker_countUpdates the number of broker nodes in the cluster
update_broker_storageUpdates the EBS storage associated with MSK brokers
update_broker_typeUpdates EC2 instance type
update_cluster_configurationUpdates the cluster with the configuration that is specified in the request body
update_cluster_kafka_versionUpdates the Apache Kafka version for the cluster
update_configurationUpdates an MSK configuration
update_connectivityUpdates the cluster's connectivity configuration
update_monitoringUpdates the monitoring settings for the cluster
update_replication_infoUpdates replication info of a replicator
update_securityUpdates the security settings for the cluster
update_storageUpdates cluster broker volume size (or) sets cluster storage mode to TIERED

Examples

## Not run: svc <- kafka() svc$batch_associate_scram_secret( Foo = 123 ) ## End(Not run)
  • Maintainer: Dyfan Jones
  • License: Apache License (>= 2.0)
  • Last published: 2025-03-17