oci_generative_ai_agent_data_source

This resource provides the Data Source resource in Oracle Cloud Infrastructure Generative Ai Agent service.

CreateDataSource

Creates a data source.

Example Usage

resource "oci_generative_ai_agent_data_source" "test_data_source" {
	#Required
	compartment_id = var.compartment_id
	data_source_config {
		#Required
		data_source_config_type = var.data_source_data_source_config_data_source_config_type
		object_storage_prefixes {
			#Required
			bucket = var.data_source_data_source_config_object_storage_prefixes_bucket
			namespace = var.data_source_data_source_config_object_storage_prefixes_namespace

			#Optional
			prefix = var.data_source_data_source_config_object_storage_prefixes_prefix
		}
	}
	knowledge_base_id = oci_generative_ai_agent_knowledge_base.test_knowledge_base.id

	#Optional
	defined_tags = {"Operations.CostCenter"= "42"}
	description = var.data_source_description
	display_name = var.data_source_display_name
	freeform_tags = {"Department"= "Finance"}
}

Argument Reference

The following arguments are supported:

• compartment_id - (Required) The OCID of the compartment to create the data source in.

• data_source_config - (Required) (Updatable) DataSourceConfig

  The details of data source.

  • data_source_config_type - (Required) (Updatable) The type of the tool. The allowed values are:
    • OCI_OBJECT_STORAGE: The data source is Oracle Cloud Infrastructure Object Storage.
  • object_storage_prefixes - (Required) (Updatable) The locations of data items in Object Storage, can either be an object (File) or a prefix (folder).
    • bucket - (Required) (Updatable) The bucket name of an object.
    • namespace - (Required) (Updatable) The namespace name of an object.
    • prefix - (Optional) (Updatable) The name of the object (file) or prefix (folder).

• defined_tags - (Optional) (Updatable) Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags. Example: {"Operations.CostCenter": "42"}

• description - (Optional) (Updatable) A description of the data source.

• display_name - (Optional) (Updatable) A user-friendly name. Does not have to be unique, and it’s changeable. Avoid entering confidential information.

• freeform_tags - (Optional) (Updatable) Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see Resource Tags. Example: {"Department": "Finance"}

• knowledge_base_id - (Required) The OCID of the parent KnowledgeBase.

** IMPORTANT ** Any change to a property that does not support update will force the destruction and recreation of the resource with the new property values

Attributes Reference

The following attributes are exported:

• compartment_id - The OCID of the compartment.

• data_source_config - DataSourceConfig

  The details of data source.

  • data_source_config_type - The type of the tool. The allowed values are:
    • OCI_OBJECT_STORAGE: The data source is Oracle Cloud Infrastructure Object Storage.
  • object_storage_prefixes - The locations of data items in Object Storage, can either be an object (File) or a prefix (folder).
    • bucket - The bucket name of an object.
    • namespace - The namespace name of an object.
    • prefix - The name of the object (file) or prefix (folder).

• defined_tags - Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags. Example: {"Operations.CostCenter": "42"}

• description - A description of the data source.

• display_name - A user-friendly name. Does not have to be unique, and it’s changeable.

• freeform_tags - Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see Resource Tags. Example: {"Department": "Finance"}

• id - The OCID of the data source.

• knowledge_base_id - The OCID of the parent KnowledgeBase.

• lifecycle_details - A message that describes the current state of the data source in more detail. For example, can be used to provide actionable information for a resource in the Failed state.

• state - The current state of the data source.

• system_tags - System tags for this resource. Each key is predefined and scoped to a namespace. Example: {"orcl-cloud.free-tier-retained": "true"}

• time_created - The date and time the data source was created, in the format defined by RFC 3339. Example: 2016-08-25T21:10:29.600Z

• time_updated - The date and time the data source was updated, in the format defined by RFC 3339. Example: 2016-08-25T21:10:29.600Z

Timeouts

The timeouts block allows you to specify timeouts for certain operations: * create - (Defaults to 20 minutes), when creating the Data Source * update - (Defaults to 20 minutes), when updating the Data Source * delete - (Defaults to 20 minutes), when destroying the Data Source

Import

DataSources can be imported using the id, e.g.

$ terraform import oci_generative_ai_agent_data_source.test_data_source "id"