kafka.Provider
Explore with Pulumi AI
The provider type for the kafka package. By default, resources use package-wide configuration
settings, however an explicit Provider instance may be created and passed during resource
construction to achieve fine-grained programmatic control over provider settings. See the
documentation for more information.
Create Provider Resource
Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.
Constructor syntax
new Provider(name: string, args: ProviderArgs, opts?: CustomResourceOptions);@overload
def Provider(resource_name: str,
             args: ProviderArgs,
             opts: Optional[ResourceOptions] = None)
@overload
def Provider(resource_name: str,
             opts: Optional[ResourceOptions] = None,
             bootstrap_servers: Optional[Sequence[str]] = None,
             ca_cert: Optional[str] = None,
             ca_cert_file: Optional[str] = None,
             client_cert: Optional[str] = None,
             client_cert_file: Optional[str] = None,
             client_key: Optional[str] = None,
             client_key_file: Optional[str] = None,
             client_key_passphrase: Optional[str] = None,
             kafka_version: Optional[str] = None,
             sasl_aws_access_key: Optional[str] = None,
             sasl_aws_container_authorization_token_file: Optional[str] = None,
             sasl_aws_container_credentials_full_uri: Optional[str] = None,
             sasl_aws_creds_debug: Optional[bool] = None,
             sasl_aws_profile: Optional[str] = None,
             sasl_aws_region: Optional[str] = None,
             sasl_aws_role_arn: Optional[str] = None,
             sasl_aws_secret_key: Optional[str] = None,
             sasl_aws_token: Optional[str] = None,
             sasl_mechanism: Optional[str] = None,
             sasl_password: Optional[str] = None,
             sasl_token_url: Optional[str] = None,
             sasl_username: Optional[str] = None,
             skip_tls_verify: Optional[bool] = None,
             timeout: Optional[int] = None,
             tls_enabled: Optional[bool] = None)func NewProvider(ctx *Context, name string, args ProviderArgs, opts ...ResourceOption) (*Provider, error)public Provider(string name, ProviderArgs args, CustomResourceOptions? opts = null)
public Provider(String name, ProviderArgs args)
public Provider(String name, ProviderArgs args, CustomResourceOptions options)
type: pulumi:providers:kafka
properties: # The arguments to resource properties.
options: # Bag of options to control resource's behavior.
Parameters
- name string
- The unique name of the resource.
- args ProviderArgs
- The arguments to resource properties.
- opts CustomResourceOptions
- Bag of options to control resource's behavior.
- resource_name str
- The unique name of the resource.
- args ProviderArgs
- The arguments to resource properties.
- opts ResourceOptions
- Bag of options to control resource's behavior.
- ctx Context
- Context object for the current deployment.
- name string
- The unique name of the resource.
- args ProviderArgs
- The arguments to resource properties.
- opts ResourceOption
- Bag of options to control resource's behavior.
- name string
- The unique name of the resource.
- args ProviderArgs
- The arguments to resource properties.
- opts CustomResourceOptions
- Bag of options to control resource's behavior.
- name String
- The unique name of the resource.
- args ProviderArgs
- The arguments to resource properties.
- options CustomResourceOptions
- Bag of options to control resource's behavior.
Provider Resource Properties
To learn more about resource properties and how to use them, see Inputs and Outputs in the Architecture and Concepts docs.
Inputs
In Python, inputs that are objects can be passed either as argument classes or as dictionary literals.
The Provider resource accepts the following input properties:
- BootstrapServers List<string>
- A list of kafka brokers
- CaCert string
- CA certificate file to validate the server's certificate.
- CaCert stringFile 
- Path to a CA certificate file to validate the server's certificate.
- ClientCert string
- The client certificate.
- ClientCert stringFile 
- Path to a file containing the client certificate.
- ClientKey string
- The private key that the certificate was issued for.
- ClientKey stringFile 
- Path to a file containing the private key that the certificate was issued for.
- ClientKey stringPassphrase 
- The passphrase for the private key that the certificate was issued for.
- KafkaVersion string
- The version of Kafka protocol to use in $MAJOR.$MINOR.$PATCHformat. Some features may not be available on older versions. Default is 2.7.0.
- SaslAws stringAccess Key 
- The AWS access key.
- string
- Path to a file containing the AWS pod identity authorization token
- SaslAws stringContainer Credentials Full Uri 
- URI to retrieve AWS credentials from
- SaslAws boolCreds Debug 
- Set this to true to turn AWS credentials debug.
- SaslAws stringProfile 
- AWS profile name to use
- SaslAws stringRegion 
- AWS region where MSK is deployed.
- SaslAws stringRole Arn 
- Arn of an AWS IAM role to assume
- SaslAws stringSecret Key 
- The AWS secret key.
- SaslAws stringToken 
- The AWS session token. Only required if you are using temporary security credentials.
- SaslMechanism string
- SASL mechanism, can be plain, scram-sha512, scram-sha256, aws-iam
It can also be sourced from the following environment variable: KAFKA_SASL_MECHANISM
- SaslPassword string
- Password for SASL authentication.
- SaslToken stringUrl 
- The url to retrieve oauth2 tokens from, when using sasl mechanism oauthbearer
- SaslUsername string
- Username for SASL authentication.
- SkipTls boolVerify 
- Set this to true only if the target Kafka server is an insecure development instance.
It can also be sourced from the following environment variable: KAFKA_SKIP_VERIFY
- Timeout int
- Timeout in seconds
- TlsEnabled bool
- Enable communication with the Kafka Cluster over TLS.
It can also be sourced from the following environment variable: KAFKA_ENABLE_TLS
- BootstrapServers []string
- A list of kafka brokers
- CaCert string
- CA certificate file to validate the server's certificate.
- CaCert stringFile 
- Path to a CA certificate file to validate the server's certificate.
- ClientCert string
- The client certificate.
- ClientCert stringFile 
- Path to a file containing the client certificate.
- ClientKey string
- The private key that the certificate was issued for.
- ClientKey stringFile 
- Path to a file containing the private key that the certificate was issued for.
- ClientKey stringPassphrase 
- The passphrase for the private key that the certificate was issued for.
- KafkaVersion string
- The version of Kafka protocol to use in $MAJOR.$MINOR.$PATCHformat. Some features may not be available on older versions. Default is 2.7.0.
- SaslAws stringAccess Key 
- The AWS access key.
- string
- Path to a file containing the AWS pod identity authorization token
- SaslAws stringContainer Credentials Full Uri 
- URI to retrieve AWS credentials from
- SaslAws boolCreds Debug 
- Set this to true to turn AWS credentials debug.
- SaslAws stringProfile 
- AWS profile name to use
- SaslAws stringRegion 
- AWS region where MSK is deployed.
- SaslAws stringRole Arn 
- Arn of an AWS IAM role to assume
- SaslAws stringSecret Key 
- The AWS secret key.
- SaslAws stringToken 
- The AWS session token. Only required if you are using temporary security credentials.
- SaslMechanism string
- SASL mechanism, can be plain, scram-sha512, scram-sha256, aws-iam
It can also be sourced from the following environment variable: KAFKA_SASL_MECHANISM
- SaslPassword string
- Password for SASL authentication.
- SaslToken stringUrl 
- The url to retrieve oauth2 tokens from, when using sasl mechanism oauthbearer
- SaslUsername string
- Username for SASL authentication.
- SkipTls boolVerify 
- Set this to true only if the target Kafka server is an insecure development instance.
It can also be sourced from the following environment variable: KAFKA_SKIP_VERIFY
- Timeout int
- Timeout in seconds
- TlsEnabled bool
- Enable communication with the Kafka Cluster over TLS.
It can also be sourced from the following environment variable: KAFKA_ENABLE_TLS
- bootstrapServers List<String>
- A list of kafka brokers
- caCert String
- CA certificate file to validate the server's certificate.
- caCert StringFile 
- Path to a CA certificate file to validate the server's certificate.
- clientCert String
- The client certificate.
- clientCert StringFile 
- Path to a file containing the client certificate.
- clientKey String
- The private key that the certificate was issued for.
- clientKey StringFile 
- Path to a file containing the private key that the certificate was issued for.
- clientKey StringPassphrase 
- The passphrase for the private key that the certificate was issued for.
- kafkaVersion String
- The version of Kafka protocol to use in $MAJOR.$MINOR.$PATCHformat. Some features may not be available on older versions. Default is 2.7.0.
- saslAws StringAccess Key 
- The AWS access key.
- String
- Path to a file containing the AWS pod identity authorization token
- saslAws StringContainer Credentials Full Uri 
- URI to retrieve AWS credentials from
- saslAws BooleanCreds Debug 
- Set this to true to turn AWS credentials debug.
- saslAws StringProfile 
- AWS profile name to use
- saslAws StringRegion 
- AWS region where MSK is deployed.
- saslAws StringRole Arn 
- Arn of an AWS IAM role to assume
- saslAws StringSecret Key 
- The AWS secret key.
- saslAws StringToken 
- The AWS session token. Only required if you are using temporary security credentials.
- saslMechanism String
- SASL mechanism, can be plain, scram-sha512, scram-sha256, aws-iam
It can also be sourced from the following environment variable: KAFKA_SASL_MECHANISM
- saslPassword String
- Password for SASL authentication.
- saslToken StringUrl 
- The url to retrieve oauth2 tokens from, when using sasl mechanism oauthbearer
- saslUsername String
- Username for SASL authentication.
- skipTls BooleanVerify 
- Set this to true only if the target Kafka server is an insecure development instance.
It can also be sourced from the following environment variable: KAFKA_SKIP_VERIFY
- timeout Integer
- Timeout in seconds
- tlsEnabled Boolean
- Enable communication with the Kafka Cluster over TLS.
It can also be sourced from the following environment variable: KAFKA_ENABLE_TLS
- bootstrapServers string[]
- A list of kafka brokers
- caCert string
- CA certificate file to validate the server's certificate.
- caCert stringFile 
- Path to a CA certificate file to validate the server's certificate.
- clientCert string
- The client certificate.
- clientCert stringFile 
- Path to a file containing the client certificate.
- clientKey string
- The private key that the certificate was issued for.
- clientKey stringFile 
- Path to a file containing the private key that the certificate was issued for.
- clientKey stringPassphrase 
- The passphrase for the private key that the certificate was issued for.
- kafkaVersion string
- The version of Kafka protocol to use in $MAJOR.$MINOR.$PATCHformat. Some features may not be available on older versions. Default is 2.7.0.
- saslAws stringAccess Key 
- The AWS access key.
- string
- Path to a file containing the AWS pod identity authorization token
- saslAws stringContainer Credentials Full Uri 
- URI to retrieve AWS credentials from
- saslAws booleanCreds Debug 
- Set this to true to turn AWS credentials debug.
- saslAws stringProfile 
- AWS profile name to use
- saslAws stringRegion 
- AWS region where MSK is deployed.
- saslAws stringRole Arn 
- Arn of an AWS IAM role to assume
- saslAws stringSecret Key 
- The AWS secret key.
- saslAws stringToken 
- The AWS session token. Only required if you are using temporary security credentials.
- saslMechanism string
- SASL mechanism, can be plain, scram-sha512, scram-sha256, aws-iam
It can also be sourced from the following environment variable: KAFKA_SASL_MECHANISM
- saslPassword string
- Password for SASL authentication.
- saslToken stringUrl 
- The url to retrieve oauth2 tokens from, when using sasl mechanism oauthbearer
- saslUsername string
- Username for SASL authentication.
- skipTls booleanVerify 
- Set this to true only if the target Kafka server is an insecure development instance.
It can also be sourced from the following environment variable: KAFKA_SKIP_VERIFY
- timeout number
- Timeout in seconds
- tlsEnabled boolean
- Enable communication with the Kafka Cluster over TLS.
It can also be sourced from the following environment variable: KAFKA_ENABLE_TLS
- bootstrap_servers Sequence[str]
- A list of kafka brokers
- ca_cert str
- CA certificate file to validate the server's certificate.
- ca_cert_ strfile 
- Path to a CA certificate file to validate the server's certificate.
- client_cert str
- The client certificate.
- client_cert_ strfile 
- Path to a file containing the client certificate.
- client_key str
- The private key that the certificate was issued for.
- client_key_ strfile 
- Path to a file containing the private key that the certificate was issued for.
- client_key_ strpassphrase 
- The passphrase for the private key that the certificate was issued for.
- kafka_version str
- The version of Kafka protocol to use in $MAJOR.$MINOR.$PATCHformat. Some features may not be available on older versions. Default is 2.7.0.
- sasl_aws_ straccess_ key 
- The AWS access key.
- str
- Path to a file containing the AWS pod identity authorization token
- sasl_aws_ strcontainer_ credentials_ full_ uri 
- URI to retrieve AWS credentials from
- sasl_aws_ boolcreds_ debug 
- Set this to true to turn AWS credentials debug.
- sasl_aws_ strprofile 
- AWS profile name to use
- sasl_aws_ strregion 
- AWS region where MSK is deployed.
- sasl_aws_ strrole_ arn 
- Arn of an AWS IAM role to assume
- sasl_aws_ strsecret_ key 
- The AWS secret key.
- sasl_aws_ strtoken 
- The AWS session token. Only required if you are using temporary security credentials.
- sasl_mechanism str
- SASL mechanism, can be plain, scram-sha512, scram-sha256, aws-iam
It can also be sourced from the following environment variable: KAFKA_SASL_MECHANISM
- sasl_password str
- Password for SASL authentication.
- sasl_token_ strurl 
- The url to retrieve oauth2 tokens from, when using sasl mechanism oauthbearer
- sasl_username str
- Username for SASL authentication.
- skip_tls_ boolverify 
- Set this to true only if the target Kafka server is an insecure development instance.
It can also be sourced from the following environment variable: KAFKA_SKIP_VERIFY
- timeout int
- Timeout in seconds
- tls_enabled bool
- Enable communication with the Kafka Cluster over TLS.
It can also be sourced from the following environment variable: KAFKA_ENABLE_TLS
- bootstrapServers List<String>
- A list of kafka brokers
- caCert String
- CA certificate file to validate the server's certificate.
- caCert StringFile 
- Path to a CA certificate file to validate the server's certificate.
- clientCert String
- The client certificate.
- clientCert StringFile 
- Path to a file containing the client certificate.
- clientKey String
- The private key that the certificate was issued for.
- clientKey StringFile 
- Path to a file containing the private key that the certificate was issued for.
- clientKey StringPassphrase 
- The passphrase for the private key that the certificate was issued for.
- kafkaVersion String
- The version of Kafka protocol to use in $MAJOR.$MINOR.$PATCHformat. Some features may not be available on older versions. Default is 2.7.0.
- saslAws StringAccess Key 
- The AWS access key.
- String
- Path to a file containing the AWS pod identity authorization token
- saslAws StringContainer Credentials Full Uri 
- URI to retrieve AWS credentials from
- saslAws BooleanCreds Debug 
- Set this to true to turn AWS credentials debug.
- saslAws StringProfile 
- AWS profile name to use
- saslAws StringRegion 
- AWS region where MSK is deployed.
- saslAws StringRole Arn 
- Arn of an AWS IAM role to assume
- saslAws StringSecret Key 
- The AWS secret key.
- saslAws StringToken 
- The AWS session token. Only required if you are using temporary security credentials.
- saslMechanism String
- SASL mechanism, can be plain, scram-sha512, scram-sha256, aws-iam
It can also be sourced from the following environment variable: KAFKA_SASL_MECHANISM
- saslPassword String
- Password for SASL authentication.
- saslToken StringUrl 
- The url to retrieve oauth2 tokens from, when using sasl mechanism oauthbearer
- saslUsername String
- Username for SASL authentication.
- skipTls BooleanVerify 
- Set this to true only if the target Kafka server is an insecure development instance.
It can also be sourced from the following environment variable: KAFKA_SKIP_VERIFY
- timeout Number
- Timeout in seconds
- tlsEnabled Boolean
- Enable communication with the Kafka Cluster over TLS.
It can also be sourced from the following environment variable: KAFKA_ENABLE_TLS
Outputs
All input properties are implicitly available as output properties. Additionally, the Provider resource produces the following output properties:
- Id string
- The provider-assigned unique ID for this managed resource.
- Id string
- The provider-assigned unique ID for this managed resource.
- id String
- The provider-assigned unique ID for this managed resource.
- id string
- The provider-assigned unique ID for this managed resource.
- id str
- The provider-assigned unique ID for this managed resource.
- id String
- The provider-assigned unique ID for this managed resource.
Package Details
- Repository
- Kafka pulumi/pulumi-kafka
- License
- Apache-2.0
- Notes
- This Pulumi package is based on the kafkaTerraform Provider.