confluentcloud.Schema
Explore with Pulumi AI
Example Usage
Create Schema Resource
Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.
Constructor syntax
new Schema(name: string, args: SchemaArgs, opts?: CustomResourceOptions);
@overload
def Schema(resource_name: str,
args: SchemaArgs,
opts: Optional[ResourceOptions] = None)
@overload
def Schema(resource_name: str,
opts: Optional[ResourceOptions] = None,
format: Optional[str] = None,
subject_name: Optional[str] = None,
credentials: Optional[SchemaCredentialsArgs] = None,
hard_delete: Optional[bool] = None,
metadata: Optional[SchemaMetadataArgs] = None,
recreate_on_update: Optional[bool] = None,
rest_endpoint: Optional[str] = None,
ruleset: Optional[SchemaRulesetArgs] = None,
schema: Optional[str] = None,
schema_references: Optional[Sequence[SchemaSchemaReferenceArgs]] = None,
schema_registry_cluster: Optional[SchemaSchemaRegistryClusterArgs] = None,
skip_validation_during_plan: Optional[bool] = None)
func NewSchema(ctx *Context, name string, args SchemaArgs, opts ...ResourceOption) (*Schema, error)
public Schema(string name, SchemaArgs args, CustomResourceOptions? opts = null)
public Schema(String name, SchemaArgs args)
public Schema(String name, SchemaArgs args, CustomResourceOptions options)
type: confluentcloud:Schema
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 SchemaArgs
- 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 SchemaArgs
- 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 SchemaArgs
- The arguments to resource properties.
- opts ResourceOption
- Bag of options to control resource's behavior.
- name string
- The unique name of the resource.
- args SchemaArgs
- The arguments to resource properties.
- opts CustomResourceOptions
- Bag of options to control resource's behavior.
- name String
- The unique name of the resource.
- args SchemaArgs
- The arguments to resource properties.
- options CustomResourceOptions
- Bag of options to control resource's behavior.
Constructor example
The following reference example uses placeholder values for all input properties.
var schemaResource = new ConfluentCloud.Schema("schemaResource", new()
{
Format = "string",
SubjectName = "string",
Credentials = new ConfluentCloud.Inputs.SchemaCredentialsArgs
{
Key = "string",
Secret = "string",
},
HardDelete = false,
Metadata = new ConfluentCloud.Inputs.SchemaMetadataArgs
{
Properties =
{
{ "string", "string" },
},
Sensitives = new[]
{
"string",
},
Tags = new[]
{
new ConfluentCloud.Inputs.SchemaMetadataTagArgs
{
Key = "string",
Values = new[]
{
"string",
},
},
},
},
RecreateOnUpdate = false,
RestEndpoint = "string",
Ruleset = new ConfluentCloud.Inputs.SchemaRulesetArgs
{
DomainRules = new[]
{
new ConfluentCloud.Inputs.SchemaRulesetDomainRuleArgs
{
Kind = "string",
Mode = "string",
Name = "string",
Type = "string",
Disabled = false,
Doc = "string",
Expr = "string",
OnFailure = "string",
OnSuccess = "string",
Params =
{
{ "string", "string" },
},
Tags = new[]
{
"string",
},
},
},
MigrationRules = new[]
{
new ConfluentCloud.Inputs.SchemaRulesetMigrationRuleArgs
{
Kind = "string",
Mode = "string",
Name = "string",
Type = "string",
Disabled = false,
Doc = "string",
Expr = "string",
OnFailure = "string",
OnSuccess = "string",
Params =
{
{ "string", "string" },
},
Tags = new[]
{
"string",
},
},
},
},
SchemaDetails = "string",
SchemaReferences = new[]
{
new ConfluentCloud.Inputs.SchemaSchemaReferenceArgs
{
Name = "string",
SubjectName = "string",
Version = 0,
},
},
SchemaRegistryCluster = new ConfluentCloud.Inputs.SchemaSchemaRegistryClusterArgs
{
Id = "string",
},
SkipValidationDuringPlan = false,
});
example, err := confluentcloud.NewSchema(ctx, "schemaResource", &confluentcloud.SchemaArgs{
Format: pulumi.String("string"),
SubjectName: pulumi.String("string"),
Credentials: &confluentcloud.SchemaCredentialsArgs{
Key: pulumi.String("string"),
Secret: pulumi.String("string"),
},
HardDelete: pulumi.Bool(false),
Metadata: &confluentcloud.SchemaMetadataArgs{
Properties: pulumi.StringMap{
"string": pulumi.String("string"),
},
Sensitives: pulumi.StringArray{
pulumi.String("string"),
},
Tags: confluentcloud.SchemaMetadataTagArray{
&confluentcloud.SchemaMetadataTagArgs{
Key: pulumi.String("string"),
Values: pulumi.StringArray{
pulumi.String("string"),
},
},
},
},
RecreateOnUpdate: pulumi.Bool(false),
RestEndpoint: pulumi.String("string"),
Ruleset: &confluentcloud.SchemaRulesetArgs{
DomainRules: confluentcloud.SchemaRulesetDomainRuleArray{
&confluentcloud.SchemaRulesetDomainRuleArgs{
Kind: pulumi.String("string"),
Mode: pulumi.String("string"),
Name: pulumi.String("string"),
Type: pulumi.String("string"),
Disabled: pulumi.Bool(false),
Doc: pulumi.String("string"),
Expr: pulumi.String("string"),
OnFailure: pulumi.String("string"),
OnSuccess: pulumi.String("string"),
Params: pulumi.StringMap{
"string": pulumi.String("string"),
},
Tags: pulumi.StringArray{
pulumi.String("string"),
},
},
},
MigrationRules: confluentcloud.SchemaRulesetMigrationRuleArray{
&confluentcloud.SchemaRulesetMigrationRuleArgs{
Kind: pulumi.String("string"),
Mode: pulumi.String("string"),
Name: pulumi.String("string"),
Type: pulumi.String("string"),
Disabled: pulumi.Bool(false),
Doc: pulumi.String("string"),
Expr: pulumi.String("string"),
OnFailure: pulumi.String("string"),
OnSuccess: pulumi.String("string"),
Params: pulumi.StringMap{
"string": pulumi.String("string"),
},
Tags: pulumi.StringArray{
pulumi.String("string"),
},
},
},
},
Schema: pulumi.String("string"),
SchemaReferences: confluentcloud.SchemaSchemaReferenceArray{
&confluentcloud.SchemaSchemaReferenceArgs{
Name: pulumi.String("string"),
SubjectName: pulumi.String("string"),
Version: pulumi.Int(0),
},
},
SchemaRegistryCluster: &confluentcloud.SchemaSchemaRegistryClusterArgs{
Id: pulumi.String("string"),
},
SkipValidationDuringPlan: pulumi.Bool(false),
})
var schemaResource = new Schema("schemaResource", SchemaArgs.builder()
.format("string")
.subjectName("string")
.credentials(SchemaCredentialsArgs.builder()
.key("string")
.secret("string")
.build())
.hardDelete(false)
.metadata(SchemaMetadataArgs.builder()
.properties(Map.of("string", "string"))
.sensitives("string")
.tags(SchemaMetadataTagArgs.builder()
.key("string")
.values("string")
.build())
.build())
.recreateOnUpdate(false)
.restEndpoint("string")
.ruleset(SchemaRulesetArgs.builder()
.domainRules(SchemaRulesetDomainRuleArgs.builder()
.kind("string")
.mode("string")
.name("string")
.type("string")
.disabled(false)
.doc("string")
.expr("string")
.onFailure("string")
.onSuccess("string")
.params(Map.of("string", "string"))
.tags("string")
.build())
.migrationRules(SchemaRulesetMigrationRuleArgs.builder()
.kind("string")
.mode("string")
.name("string")
.type("string")
.disabled(false)
.doc("string")
.expr("string")
.onFailure("string")
.onSuccess("string")
.params(Map.of("string", "string"))
.tags("string")
.build())
.build())
.schema("string")
.schemaReferences(SchemaSchemaReferenceArgs.builder()
.name("string")
.subjectName("string")
.version(0)
.build())
.schemaRegistryCluster(SchemaSchemaRegistryClusterArgs.builder()
.id("string")
.build())
.skipValidationDuringPlan(false)
.build());
schema_resource = confluentcloud.Schema("schemaResource",
format="string",
subject_name="string",
credentials={
"key": "string",
"secret": "string",
},
hard_delete=False,
metadata={
"properties": {
"string": "string",
},
"sensitives": ["string"],
"tags": [{
"key": "string",
"values": ["string"],
}],
},
recreate_on_update=False,
rest_endpoint="string",
ruleset={
"domain_rules": [{
"kind": "string",
"mode": "string",
"name": "string",
"type": "string",
"disabled": False,
"doc": "string",
"expr": "string",
"on_failure": "string",
"on_success": "string",
"params": {
"string": "string",
},
"tags": ["string"],
}],
"migration_rules": [{
"kind": "string",
"mode": "string",
"name": "string",
"type": "string",
"disabled": False,
"doc": "string",
"expr": "string",
"on_failure": "string",
"on_success": "string",
"params": {
"string": "string",
},
"tags": ["string"],
}],
},
schema="string",
schema_references=[{
"name": "string",
"subject_name": "string",
"version": 0,
}],
schema_registry_cluster={
"id": "string",
},
skip_validation_during_plan=False)
const schemaResource = new confluentcloud.Schema("schemaResource", {
format: "string",
subjectName: "string",
credentials: {
key: "string",
secret: "string",
},
hardDelete: false,
metadata: {
properties: {
string: "string",
},
sensitives: ["string"],
tags: [{
key: "string",
values: ["string"],
}],
},
recreateOnUpdate: false,
restEndpoint: "string",
ruleset: {
domainRules: [{
kind: "string",
mode: "string",
name: "string",
type: "string",
disabled: false,
doc: "string",
expr: "string",
onFailure: "string",
onSuccess: "string",
params: {
string: "string",
},
tags: ["string"],
}],
migrationRules: [{
kind: "string",
mode: "string",
name: "string",
type: "string",
disabled: false,
doc: "string",
expr: "string",
onFailure: "string",
onSuccess: "string",
params: {
string: "string",
},
tags: ["string"],
}],
},
schema: "string",
schemaReferences: [{
name: "string",
subjectName: "string",
version: 0,
}],
schemaRegistryCluster: {
id: "string",
},
skipValidationDuringPlan: false,
});
type: confluentcloud:Schema
properties:
credentials:
key: string
secret: string
format: string
hardDelete: false
metadata:
properties:
string: string
sensitives:
- string
tags:
- key: string
values:
- string
recreateOnUpdate: false
restEndpoint: string
ruleset:
domainRules:
- disabled: false
doc: string
expr: string
kind: string
mode: string
name: string
onFailure: string
onSuccess: string
params:
string: string
tags:
- string
type: string
migrationRules:
- disabled: false
doc: string
expr: string
kind: string
mode: string
name: string
onFailure: string
onSuccess: string
params:
string: string
tags:
- string
type: string
schema: string
schemaReferences:
- name: string
subjectName: string
version: 0
schemaRegistryCluster:
id: string
skipValidationDuringPlan: false
subjectName: string
Schema 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 Schema resource accepts the following input properties:
- Format string
- The format of the Schema.
- Subject
Name string - The name of the subject (in other words, the namespace), representing the subject under which the schema will be registered, for example,
test-subject
. Schemas evolve safely, following a compatibility mode defined, under a subject name. - Credentials
Pulumi.
Confluent Cloud. Inputs. Schema Credentials - The Cluster API Credentials.
- Hard
Delete bool - Controls whether a schema should be soft or hard deleted. Set it to
true
if you want to hard delete a schema on destroy. Defaults tofalse
(soft delete). - Metadata
Pulumi.
Confluent Cloud. Inputs. Schema Metadata - Recreate
On boolUpdate - Controls whether a schema should be recreated on update.
- Rest
Endpoint string - The REST endpoint of the Schema Registry cluster. For example, for public networking:
https://psrc-00000.us-central1.gcp.confluent.cloud
. In the case of private networking, the endpoint might look likehttps://lsrc-abc123.pr1jy6.us-east-2.aws.confluent.cloud
. You can construct it using either:data.confluent_schema_registry_cluster.essentials.private_regional_rest_endpoints["us-east-2"]
, orhttps://${data.confluent_schema_registry_cluster.essentials.id}${data.confluent_network.main.endpoint_suffix}
- Ruleset
Pulumi.
Confluent Cloud. Inputs. Schema Ruleset - Schema
Details string - The definition of the Schema.
- Schema
References List<Pulumi.Confluent Cloud. Inputs. Schema Schema Reference> - The list of references to other Schemas.
- Schema
Registry Pulumi.Cluster Confluent Cloud. Inputs. Schema Schema Registry Cluster - Skip
Validation boolDuring Plan
- Format string
- The format of the Schema.
- Subject
Name string - The name of the subject (in other words, the namespace), representing the subject under which the schema will be registered, for example,
test-subject
. Schemas evolve safely, following a compatibility mode defined, under a subject name. - Credentials
Schema
Credentials Args - The Cluster API Credentials.
- Hard
Delete bool - Controls whether a schema should be soft or hard deleted. Set it to
true
if you want to hard delete a schema on destroy. Defaults tofalse
(soft delete). - Metadata
Schema
Metadata Args - Recreate
On boolUpdate - Controls whether a schema should be recreated on update.
- Rest
Endpoint string - The REST endpoint of the Schema Registry cluster. For example, for public networking:
https://psrc-00000.us-central1.gcp.confluent.cloud
. In the case of private networking, the endpoint might look likehttps://lsrc-abc123.pr1jy6.us-east-2.aws.confluent.cloud
. You can construct it using either:data.confluent_schema_registry_cluster.essentials.private_regional_rest_endpoints["us-east-2"]
, orhttps://${data.confluent_schema_registry_cluster.essentials.id}${data.confluent_network.main.endpoint_suffix}
- Ruleset
Schema
Ruleset Args - Schema string
- The definition of the Schema.
- Schema
References []SchemaSchema Reference Args - The list of references to other Schemas.
- Schema
Registry SchemaCluster Schema Registry Cluster Args - Skip
Validation boolDuring Plan
- format String
- The format of the Schema.
- subject
Name String - The name of the subject (in other words, the namespace), representing the subject under which the schema will be registered, for example,
test-subject
. Schemas evolve safely, following a compatibility mode defined, under a subject name. - credentials
Schema
Credentials - The Cluster API Credentials.
- hard
Delete Boolean - Controls whether a schema should be soft or hard deleted. Set it to
true
if you want to hard delete a schema on destroy. Defaults tofalse
(soft delete). - metadata
Schema
Metadata - recreate
On BooleanUpdate - Controls whether a schema should be recreated on update.
- rest
Endpoint String - The REST endpoint of the Schema Registry cluster. For example, for public networking:
https://psrc-00000.us-central1.gcp.confluent.cloud
. In the case of private networking, the endpoint might look likehttps://lsrc-abc123.pr1jy6.us-east-2.aws.confluent.cloud
. You can construct it using either:data.confluent_schema_registry_cluster.essentials.private_regional_rest_endpoints["us-east-2"]
, orhttps://${data.confluent_schema_registry_cluster.essentials.id}${data.confluent_network.main.endpoint_suffix}
- ruleset
Schema
Ruleset - schema String
- The definition of the Schema.
- schema
References List<SchemaSchema Reference> - The list of references to other Schemas.
- schema
Registry SchemaCluster Schema Registry Cluster - skip
Validation BooleanDuring Plan
- format string
- The format of the Schema.
- subject
Name string - The name of the subject (in other words, the namespace), representing the subject under which the schema will be registered, for example,
test-subject
. Schemas evolve safely, following a compatibility mode defined, under a subject name. - credentials
Schema
Credentials - The Cluster API Credentials.
- hard
Delete boolean - Controls whether a schema should be soft or hard deleted. Set it to
true
if you want to hard delete a schema on destroy. Defaults tofalse
(soft delete). - metadata
Schema
Metadata - recreate
On booleanUpdate - Controls whether a schema should be recreated on update.
- rest
Endpoint string - The REST endpoint of the Schema Registry cluster. For example, for public networking:
https://psrc-00000.us-central1.gcp.confluent.cloud
. In the case of private networking, the endpoint might look likehttps://lsrc-abc123.pr1jy6.us-east-2.aws.confluent.cloud
. You can construct it using either:data.confluent_schema_registry_cluster.essentials.private_regional_rest_endpoints["us-east-2"]
, orhttps://${data.confluent_schema_registry_cluster.essentials.id}${data.confluent_network.main.endpoint_suffix}
- ruleset
Schema
Ruleset - schema string
- The definition of the Schema.
- schema
References SchemaSchema Reference[] - The list of references to other Schemas.
- schema
Registry SchemaCluster Schema Registry Cluster - skip
Validation booleanDuring Plan
- format str
- The format of the Schema.
- subject_
name str - The name of the subject (in other words, the namespace), representing the subject under which the schema will be registered, for example,
test-subject
. Schemas evolve safely, following a compatibility mode defined, under a subject name. - credentials
Schema
Credentials Args - The Cluster API Credentials.
- hard_
delete bool - Controls whether a schema should be soft or hard deleted. Set it to
true
if you want to hard delete a schema on destroy. Defaults tofalse
(soft delete). - metadata
Schema
Metadata Args - recreate_
on_ boolupdate - Controls whether a schema should be recreated on update.
- rest_
endpoint str - The REST endpoint of the Schema Registry cluster. For example, for public networking:
https://psrc-00000.us-central1.gcp.confluent.cloud
. In the case of private networking, the endpoint might look likehttps://lsrc-abc123.pr1jy6.us-east-2.aws.confluent.cloud
. You can construct it using either:data.confluent_schema_registry_cluster.essentials.private_regional_rest_endpoints["us-east-2"]
, orhttps://${data.confluent_schema_registry_cluster.essentials.id}${data.confluent_network.main.endpoint_suffix}
- ruleset
Schema
Ruleset Args - schema str
- The definition of the Schema.
- schema_
references Sequence[SchemaSchema Reference Args] - The list of references to other Schemas.
- schema_
registry_ Schemacluster Schema Registry Cluster Args - skip_
validation_ boolduring_ plan
- format String
- The format of the Schema.
- subject
Name String - The name of the subject (in other words, the namespace), representing the subject under which the schema will be registered, for example,
test-subject
. Schemas evolve safely, following a compatibility mode defined, under a subject name. - credentials Property Map
- The Cluster API Credentials.
- hard
Delete Boolean - Controls whether a schema should be soft or hard deleted. Set it to
true
if you want to hard delete a schema on destroy. Defaults tofalse
(soft delete). - metadata Property Map
- recreate
On BooleanUpdate - Controls whether a schema should be recreated on update.
- rest
Endpoint String - The REST endpoint of the Schema Registry cluster. For example, for public networking:
https://psrc-00000.us-central1.gcp.confluent.cloud
. In the case of private networking, the endpoint might look likehttps://lsrc-abc123.pr1jy6.us-east-2.aws.confluent.cloud
. You can construct it using either:data.confluent_schema_registry_cluster.essentials.private_regional_rest_endpoints["us-east-2"]
, orhttps://${data.confluent_schema_registry_cluster.essentials.id}${data.confluent_network.main.endpoint_suffix}
- ruleset Property Map
- schema String
- The definition of the Schema.
- schema
References List<Property Map> - The list of references to other Schemas.
- schema
Registry Property MapCluster - skip
Validation BooleanDuring Plan
Outputs
All input properties are implicitly available as output properties. Additionally, the Schema resource produces the following output properties:
- Id string
- The provider-assigned unique ID for this managed resource.
- Schema
Identifier int - (Required Integer) The globally unique ID of the Schema, for example,
100003
. If the same schema is registered under a different subject, the same identifier will be returned. However, theversion
of the schema may be different under different subjects. - Version int
- (Required Integer) The version of the Schema, for example,
4
.
- Id string
- The provider-assigned unique ID for this managed resource.
- Schema
Identifier int - (Required Integer) The globally unique ID of the Schema, for example,
100003
. If the same schema is registered under a different subject, the same identifier will be returned. However, theversion
of the schema may be different under different subjects. - Version int
- (Required Integer) The version of the Schema, for example,
4
.
- id String
- The provider-assigned unique ID for this managed resource.
- schema
Identifier Integer - (Required Integer) The globally unique ID of the Schema, for example,
100003
. If the same schema is registered under a different subject, the same identifier will be returned. However, theversion
of the schema may be different under different subjects. - version Integer
- (Required Integer) The version of the Schema, for example,
4
.
- id string
- The provider-assigned unique ID for this managed resource.
- schema
Identifier number - (Required Integer) The globally unique ID of the Schema, for example,
100003
. If the same schema is registered under a different subject, the same identifier will be returned. However, theversion
of the schema may be different under different subjects. - version number
- (Required Integer) The version of the Schema, for example,
4
.
- id str
- The provider-assigned unique ID for this managed resource.
- schema_
identifier int - (Required Integer) The globally unique ID of the Schema, for example,
100003
. If the same schema is registered under a different subject, the same identifier will be returned. However, theversion
of the schema may be different under different subjects. - version int
- (Required Integer) The version of the Schema, for example,
4
.
- id String
- The provider-assigned unique ID for this managed resource.
- schema
Identifier Number - (Required Integer) The globally unique ID of the Schema, for example,
100003
. If the same schema is registered under a different subject, the same identifier will be returned. However, theversion
of the schema may be different under different subjects. - version Number
- (Required Integer) The version of the Schema, for example,
4
.
Look up Existing Schema Resource
Get an existing Schema resource’s state with the given name, ID, and optional extra properties used to qualify the lookup.
public static get(name: string, id: Input<ID>, state?: SchemaState, opts?: CustomResourceOptions): Schema
@staticmethod
def get(resource_name: str,
id: str,
opts: Optional[ResourceOptions] = None,
credentials: Optional[SchemaCredentialsArgs] = None,
format: Optional[str] = None,
hard_delete: Optional[bool] = None,
metadata: Optional[SchemaMetadataArgs] = None,
recreate_on_update: Optional[bool] = None,
rest_endpoint: Optional[str] = None,
ruleset: Optional[SchemaRulesetArgs] = None,
schema: Optional[str] = None,
schema_identifier: Optional[int] = None,
schema_references: Optional[Sequence[SchemaSchemaReferenceArgs]] = None,
schema_registry_cluster: Optional[SchemaSchemaRegistryClusterArgs] = None,
skip_validation_during_plan: Optional[bool] = None,
subject_name: Optional[str] = None,
version: Optional[int] = None) -> Schema
func GetSchema(ctx *Context, name string, id IDInput, state *SchemaState, opts ...ResourceOption) (*Schema, error)
public static Schema Get(string name, Input<string> id, SchemaState? state, CustomResourceOptions? opts = null)
public static Schema get(String name, Output<String> id, SchemaState state, CustomResourceOptions options)
resources: _: type: confluentcloud:Schema get: id: ${id}
- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- resource_name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- Credentials
Pulumi.
Confluent Cloud. Inputs. Schema Credentials - The Cluster API Credentials.
- Format string
- The format of the Schema.
- Hard
Delete bool - Controls whether a schema should be soft or hard deleted. Set it to
true
if you want to hard delete a schema on destroy. Defaults tofalse
(soft delete). - Metadata
Pulumi.
Confluent Cloud. Inputs. Schema Metadata - Recreate
On boolUpdate - Controls whether a schema should be recreated on update.
- Rest
Endpoint string - The REST endpoint of the Schema Registry cluster. For example, for public networking:
https://psrc-00000.us-central1.gcp.confluent.cloud
. In the case of private networking, the endpoint might look likehttps://lsrc-abc123.pr1jy6.us-east-2.aws.confluent.cloud
. You can construct it using either:data.confluent_schema_registry_cluster.essentials.private_regional_rest_endpoints["us-east-2"]
, orhttps://${data.confluent_schema_registry_cluster.essentials.id}${data.confluent_network.main.endpoint_suffix}
- Ruleset
Pulumi.
Confluent Cloud. Inputs. Schema Ruleset - Schema
Details string - The definition of the Schema.
- Schema
Identifier int - (Required Integer) The globally unique ID of the Schema, for example,
100003
. If the same schema is registered under a different subject, the same identifier will be returned. However, theversion
of the schema may be different under different subjects. - Schema
References List<Pulumi.Confluent Cloud. Inputs. Schema Schema Reference> - The list of references to other Schemas.
- Schema
Registry Pulumi.Cluster Confluent Cloud. Inputs. Schema Schema Registry Cluster - Skip
Validation boolDuring Plan - Subject
Name string - The name of the subject (in other words, the namespace), representing the subject under which the schema will be registered, for example,
test-subject
. Schemas evolve safely, following a compatibility mode defined, under a subject name. - Version int
- (Required Integer) The version of the Schema, for example,
4
.
- Credentials
Schema
Credentials Args - The Cluster API Credentials.
- Format string
- The format of the Schema.
- Hard
Delete bool - Controls whether a schema should be soft or hard deleted. Set it to
true
if you want to hard delete a schema on destroy. Defaults tofalse
(soft delete). - Metadata
Schema
Metadata Args - Recreate
On boolUpdate - Controls whether a schema should be recreated on update.
- Rest
Endpoint string - The REST endpoint of the Schema Registry cluster. For example, for public networking:
https://psrc-00000.us-central1.gcp.confluent.cloud
. In the case of private networking, the endpoint might look likehttps://lsrc-abc123.pr1jy6.us-east-2.aws.confluent.cloud
. You can construct it using either:data.confluent_schema_registry_cluster.essentials.private_regional_rest_endpoints["us-east-2"]
, orhttps://${data.confluent_schema_registry_cluster.essentials.id}${data.confluent_network.main.endpoint_suffix}
- Ruleset
Schema
Ruleset Args - Schema string
- The definition of the Schema.
- Schema
Identifier int - (Required Integer) The globally unique ID of the Schema, for example,
100003
. If the same schema is registered under a different subject, the same identifier will be returned. However, theversion
of the schema may be different under different subjects. - Schema
References []SchemaSchema Reference Args - The list of references to other Schemas.
- Schema
Registry SchemaCluster Schema Registry Cluster Args - Skip
Validation boolDuring Plan - Subject
Name string - The name of the subject (in other words, the namespace), representing the subject under which the schema will be registered, for example,
test-subject
. Schemas evolve safely, following a compatibility mode defined, under a subject name. - Version int
- (Required Integer) The version of the Schema, for example,
4
.
- credentials
Schema
Credentials - The Cluster API Credentials.
- format String
- The format of the Schema.
- hard
Delete Boolean - Controls whether a schema should be soft or hard deleted. Set it to
true
if you want to hard delete a schema on destroy. Defaults tofalse
(soft delete). - metadata
Schema
Metadata - recreate
On BooleanUpdate - Controls whether a schema should be recreated on update.
- rest
Endpoint String - The REST endpoint of the Schema Registry cluster. For example, for public networking:
https://psrc-00000.us-central1.gcp.confluent.cloud
. In the case of private networking, the endpoint might look likehttps://lsrc-abc123.pr1jy6.us-east-2.aws.confluent.cloud
. You can construct it using either:data.confluent_schema_registry_cluster.essentials.private_regional_rest_endpoints["us-east-2"]
, orhttps://${data.confluent_schema_registry_cluster.essentials.id}${data.confluent_network.main.endpoint_suffix}
- ruleset
Schema
Ruleset - schema String
- The definition of the Schema.
- schema
Identifier Integer - (Required Integer) The globally unique ID of the Schema, for example,
100003
. If the same schema is registered under a different subject, the same identifier will be returned. However, theversion
of the schema may be different under different subjects. - schema
References List<SchemaSchema Reference> - The list of references to other Schemas.
- schema
Registry SchemaCluster Schema Registry Cluster - skip
Validation BooleanDuring Plan - subject
Name String - The name of the subject (in other words, the namespace), representing the subject under which the schema will be registered, for example,
test-subject
. Schemas evolve safely, following a compatibility mode defined, under a subject name. - version Integer
- (Required Integer) The version of the Schema, for example,
4
.
- credentials
Schema
Credentials - The Cluster API Credentials.
- format string
- The format of the Schema.
- hard
Delete boolean - Controls whether a schema should be soft or hard deleted. Set it to
true
if you want to hard delete a schema on destroy. Defaults tofalse
(soft delete). - metadata
Schema
Metadata - recreate
On booleanUpdate - Controls whether a schema should be recreated on update.
- rest
Endpoint string - The REST endpoint of the Schema Registry cluster. For example, for public networking:
https://psrc-00000.us-central1.gcp.confluent.cloud
. In the case of private networking, the endpoint might look likehttps://lsrc-abc123.pr1jy6.us-east-2.aws.confluent.cloud
. You can construct it using either:data.confluent_schema_registry_cluster.essentials.private_regional_rest_endpoints["us-east-2"]
, orhttps://${data.confluent_schema_registry_cluster.essentials.id}${data.confluent_network.main.endpoint_suffix}
- ruleset
Schema
Ruleset - schema string
- The definition of the Schema.
- schema
Identifier number - (Required Integer) The globally unique ID of the Schema, for example,
100003
. If the same schema is registered under a different subject, the same identifier will be returned. However, theversion
of the schema may be different under different subjects. - schema
References SchemaSchema Reference[] - The list of references to other Schemas.
- schema
Registry SchemaCluster Schema Registry Cluster - skip
Validation booleanDuring Plan - subject
Name string - The name of the subject (in other words, the namespace), representing the subject under which the schema will be registered, for example,
test-subject
. Schemas evolve safely, following a compatibility mode defined, under a subject name. - version number
- (Required Integer) The version of the Schema, for example,
4
.
- credentials
Schema
Credentials Args - The Cluster API Credentials.
- format str
- The format of the Schema.
- hard_
delete bool - Controls whether a schema should be soft or hard deleted. Set it to
true
if you want to hard delete a schema on destroy. Defaults tofalse
(soft delete). - metadata
Schema
Metadata Args - recreate_
on_ boolupdate - Controls whether a schema should be recreated on update.
- rest_
endpoint str - The REST endpoint of the Schema Registry cluster. For example, for public networking:
https://psrc-00000.us-central1.gcp.confluent.cloud
. In the case of private networking, the endpoint might look likehttps://lsrc-abc123.pr1jy6.us-east-2.aws.confluent.cloud
. You can construct it using either:data.confluent_schema_registry_cluster.essentials.private_regional_rest_endpoints["us-east-2"]
, orhttps://${data.confluent_schema_registry_cluster.essentials.id}${data.confluent_network.main.endpoint_suffix}
- ruleset
Schema
Ruleset Args - schema str
- The definition of the Schema.
- schema_
identifier int - (Required Integer) The globally unique ID of the Schema, for example,
100003
. If the same schema is registered under a different subject, the same identifier will be returned. However, theversion
of the schema may be different under different subjects. - schema_
references Sequence[SchemaSchema Reference Args] - The list of references to other Schemas.
- schema_
registry_ Schemacluster Schema Registry Cluster Args - skip_
validation_ boolduring_ plan - subject_
name str - The name of the subject (in other words, the namespace), representing the subject under which the schema will be registered, for example,
test-subject
. Schemas evolve safely, following a compatibility mode defined, under a subject name. - version int
- (Required Integer) The version of the Schema, for example,
4
.
- credentials Property Map
- The Cluster API Credentials.
- format String
- The format of the Schema.
- hard
Delete Boolean - Controls whether a schema should be soft or hard deleted. Set it to
true
if you want to hard delete a schema on destroy. Defaults tofalse
(soft delete). - metadata Property Map
- recreate
On BooleanUpdate - Controls whether a schema should be recreated on update.
- rest
Endpoint String - The REST endpoint of the Schema Registry cluster. For example, for public networking:
https://psrc-00000.us-central1.gcp.confluent.cloud
. In the case of private networking, the endpoint might look likehttps://lsrc-abc123.pr1jy6.us-east-2.aws.confluent.cloud
. You can construct it using either:data.confluent_schema_registry_cluster.essentials.private_regional_rest_endpoints["us-east-2"]
, orhttps://${data.confluent_schema_registry_cluster.essentials.id}${data.confluent_network.main.endpoint_suffix}
- ruleset Property Map
- schema String
- The definition of the Schema.
- schema
Identifier Number - (Required Integer) The globally unique ID of the Schema, for example,
100003
. If the same schema is registered under a different subject, the same identifier will be returned. However, theversion
of the schema may be different under different subjects. - schema
References List<Property Map> - The list of references to other Schemas.
- schema
Registry Property MapCluster - skip
Validation BooleanDuring Plan - subject
Name String - The name of the subject (in other words, the namespace), representing the subject under which the schema will be registered, for example,
test-subject
. Schemas evolve safely, following a compatibility mode defined, under a subject name. - version Number
- (Required Integer) The version of the Schema, for example,
4
.
Supporting Types
SchemaCredentials, SchemaCredentialsArgs
SchemaMetadata, SchemaMetadataArgs
- Properties Dictionary<string, string>
- The custom properties to set:
- Sensitives List<string>
- A list of metadata properties to be encrypted.
- List<Pulumi.
Confluent Cloud. Inputs. Schema Metadata Tag>
- Properties map[string]string
- The custom properties to set:
- Sensitives []string
- A list of metadata properties to be encrypted.
- []Schema
Metadata Tag
- properties Map<String,String>
- The custom properties to set:
- sensitives List<String>
- A list of metadata properties to be encrypted.
- List<Schema
Metadata Tag>
- properties {[key: string]: string}
- The custom properties to set:
- sensitives string[]
- A list of metadata properties to be encrypted.
- Schema
Metadata Tag[]
- properties Mapping[str, str]
- The custom properties to set:
- sensitives Sequence[str]
- A list of metadata properties to be encrypted.
- Sequence[Schema
Metadata Tag]
- properties Map<String>
- The custom properties to set:
- sensitives List<String>
- A list of metadata properties to be encrypted.
- List<Property Map>
SchemaMetadataTag, SchemaMetadataTagArgs
SchemaRuleset, SchemaRulesetArgs
- Domain
Rules List<Pulumi.Confluent Cloud. Inputs. Schema Ruleset Domain Rule> - supports the following:
- Migration
Rules List<Pulumi.Confluent Cloud. Inputs. Schema Ruleset Migration Rule> - supports the following:
- Domain
Rules []SchemaRuleset Domain Rule - supports the following:
- Migration
Rules []SchemaRuleset Migration Rule - supports the following:
- domain
Rules List<SchemaRuleset Domain Rule> - supports the following:
- migration
Rules List<SchemaRuleset Migration Rule> - supports the following:
- domain
Rules SchemaRuleset Domain Rule[] - supports the following:
- migration
Rules SchemaRuleset Migration Rule[] - supports the following:
- domain_
rules Sequence[SchemaRuleset Domain Rule] - supports the following:
- migration_
rules Sequence[SchemaRuleset Migration Rule] - supports the following:
- domain
Rules List<Property Map> - supports the following:
- migration
Rules List<Property Map> - supports the following:
SchemaRulesetDomainRule, SchemaRulesetDomainRuleArgs
- kind str
- mode str
- name str
- type str
- disabled bool
- doc str
- expr str
- on_
failure str - on_
success str - params Mapping[str, str]
- Sequence[str]
SchemaRulesetMigrationRule, SchemaRulesetMigrationRuleArgs
- kind str
- mode str
- name str
- type str
- disabled bool
- doc str
- expr str
- on_
failure str - on_
success str - params Mapping[str, str]
- Sequence[str]
SchemaSchemaReference, SchemaSchemaReferenceArgs
- Name string
- The name of the Schema references (for example, "io.confluent.kafka.example.User"). For Avro, the reference name is the fully qualified schema name, for JSON Schema it is a URL, and for Protobuf, it is the name of another Protobuf file.
- Subject
Name string - The name of the subject (in other words, the namespace), representing the subject under which the schema will be registered, for example,
test-subject
. Schemas evolve safely, following a compatibility mode defined, under a subject name. - Version int
- (Required Integer) The version of the Schema, for example,
4
.
- Name string
- The name of the Schema references (for example, "io.confluent.kafka.example.User"). For Avro, the reference name is the fully qualified schema name, for JSON Schema it is a URL, and for Protobuf, it is the name of another Protobuf file.
- Subject
Name string - The name of the subject (in other words, the namespace), representing the subject under which the schema will be registered, for example,
test-subject
. Schemas evolve safely, following a compatibility mode defined, under a subject name. - Version int
- (Required Integer) The version of the Schema, for example,
4
.
- name String
- The name of the Schema references (for example, "io.confluent.kafka.example.User"). For Avro, the reference name is the fully qualified schema name, for JSON Schema it is a URL, and for Protobuf, it is the name of another Protobuf file.
- subject
Name String - The name of the subject (in other words, the namespace), representing the subject under which the schema will be registered, for example,
test-subject
. Schemas evolve safely, following a compatibility mode defined, under a subject name. - version Integer
- (Required Integer) The version of the Schema, for example,
4
.
- name string
- The name of the Schema references (for example, "io.confluent.kafka.example.User"). For Avro, the reference name is the fully qualified schema name, for JSON Schema it is a URL, and for Protobuf, it is the name of another Protobuf file.
- subject
Name string - The name of the subject (in other words, the namespace), representing the subject under which the schema will be registered, for example,
test-subject
. Schemas evolve safely, following a compatibility mode defined, under a subject name. - version number
- (Required Integer) The version of the Schema, for example,
4
.
- name str
- The name of the Schema references (for example, "io.confluent.kafka.example.User"). For Avro, the reference name is the fully qualified schema name, for JSON Schema it is a URL, and for Protobuf, it is the name of another Protobuf file.
- subject_
name str - The name of the subject (in other words, the namespace), representing the subject under which the schema will be registered, for example,
test-subject
. Schemas evolve safely, following a compatibility mode defined, under a subject name. - version int
- (Required Integer) The version of the Schema, for example,
4
.
- name String
- The name of the Schema references (for example, "io.confluent.kafka.example.User"). For Avro, the reference name is the fully qualified schema name, for JSON Schema it is a URL, and for Protobuf, it is the name of another Protobuf file.
- subject
Name String - The name of the subject (in other words, the namespace), representing the subject under which the schema will be registered, for example,
test-subject
. Schemas evolve safely, following a compatibility mode defined, under a subject name. - version Number
- (Required Integer) The version of the Schema, for example,
4
.
SchemaSchemaRegistryCluster, SchemaSchemaRegistryClusterArgs
- Id string
- The ID of the Schema Registry cluster, for example,
lsrc-abc123
.
- Id string
- The ID of the Schema Registry cluster, for example,
lsrc-abc123
.
- id String
- The ID of the Schema Registry cluster, for example,
lsrc-abc123
.
- id string
- The ID of the Schema Registry cluster, for example,
lsrc-abc123
.
- id str
- The ID of the Schema Registry cluster, for example,
lsrc-abc123
.
- id String
- The ID of the Schema Registry cluster, for example,
lsrc-abc123
.
Import
You can import a Schema by using the Schema Registry cluster ID, Subject name, and unique identifier (or latest
when recreate_on_update = false
) of the Schema in the format <Schema Registry cluster ID>/<Subject name>/<Schema identifier>
, for example:
Option A: recreate_on_update = false (by default)
$ export IMPORT_SCHEMA_REGISTRY_API_KEY="<schema_registry_api_key>"
$ export IMPORT_SCHEMA_REGISTRY_API_SECRET="<schema_registry_api_secret>"
$ export IMPORT_SCHEMA_REGISTRY_REST_ENDPOINT="<schema_registry_rest_endpoint>"
$ pulumi import confluentcloud:index/schema:Schema my_schema_1 lsrc-abc123/test-subject/latest
Option B: recreate_on_update = true
$ export IMPORT_SCHEMA_REGISTRY_API_KEY="<schema_registry_api_key>"
$ export IMPORT_SCHEMA_REGISTRY_API_SECRET="<schema_registry_api_secret>"
$ export IMPORT_SCHEMA_REGISTRY_REST_ENDPOINT="<schema_registry_rest_endpoint>"
$ pulumi import confluentcloud:index/schema:Schema my_schema_1 lsrc-abc123/test-subject/100003
!> Warning: Do not forget to delete terminal command history afterwards for security purposes.
To learn more about importing existing cloud resources, see Importing resources.
Package Details
- Repository
- Confluent Cloud pulumi/pulumi-confluentcloud
- License
- Apache-2.0
- Notes
- This Pulumi package is based on the
confluent
Terraform Provider.