docs: Complete resource documentation for aws_bedrockagent_data_source

website/docs/r/bedrockagent_data_source.html.markdown

@@ -16,25 +16,80 @@ Terraform resource for managing an AWS Agents for Amazon Bedrock Data Source.
 
 ```terraform
 resource "aws_bedrockagent_data_source" "example" {
+  knowledge_base_id = aws_bedrockagent_knowledge_base.example.id
+  name              = "example"
+  data_source_configuration {
+    type = "S3"
+    s3_configuration {
+      bucket_arn              = aws_s3_bucket.example.arn
+      bucket_owner_account_id = data.aws_caller_identity.current.account_id
+    }
+  }
 }
 ```
 
 ## Argument Reference
 
 The following arguments are required:
 
-* `example_arg` - (Required) Concise argument description. Do not begin the description with "An", "The", "Defines", "Indicates", or "Specifies," as these are verbose. In other words, "Indicates the amount of storage," can be rewritten as "Amount of storage," without losing any information.
+* `data_source_configuration` - (Required) Details about how the data source is stored. See [`data_source_configuration` block](#data_source_configuration-block) for details.
+* `knowledge_base_id` - (Required) Unique identifier of the knowledge base to which the data source belongs.
+* `name` - (Required) Name of the data source.
 
 The following arguments are optional:
 
-* `optional_arg` - (Optional) Concise argument description. Do not begin the description with "An", "The", "Defines", "Indicates", or "Specifies," as these are verbose. In other words, "Indicates the amount of storage," can be rewritten as "Amount of storage," without losing any information.
+* `data_deletion_policy` - (Optional) Data deletion policy for a data source. Valid values: `RETAIN`, `DELETE`.
+* `description` - (Optional) Description of the data source.
+* `server_side_encryption_configuration` - (Optional) Details about the configuration of the server-side encryption. See [`server_side_encryption_configuration` block](#server_side_encryption_configuration-block) for details.
+* `vector_ingestion_configuration` - (Optional) Details about the configuration of the server-side encryption. See [`vector_ingestion_configuration` block](#vector_ingestion_configuration-block) for details.
+
+### `data_source_configuration` block
+
+The `data_source_configuration` configuration block supports the following arguments:
+
+* `type` - (Required) Type of storage for the data source. Valid values: `S3`.
+* `s3_configuration` - (Optional) Details about the configuration of the S3 object containing the data source. See [`s3_data_source_configuration` block](#s3_data_source_configuration-block) for details.
+
+### `s3_data_source_configuration` block
+
+The `s3_data_source_configuration` configuration block supports the following arguments:
+
+* `bucket_arn` - (Required) Amazon Resource Name (ARN) of the bucket that contains the data source.
+* `bucket_owner_account_id` - (Optional) Bucket account owner ID for the S3 bucket.
+* `inclusion_prefixes` - (Optional) List of S3 prefixes that define the object containing the data sources. For more information, see [Organizing objects using prefixes](https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-prefixes.html).
+
+### `server_side_encryption_configuration` block
+
+The `server_side_encryption_configuration` configuration block supports the following arguments:
+
+* `kms_key_arn` - (Optional) Amazon Resource Name (ARN) of the AWS KMS key used to encrypt the resource.
+
+### `vector_ingestion_configuration` block
+
+The `vector_ingestion_configuration` configuration block supports the following arguments:
+
+* `chunking_configuration` - (Optional) Details about how to chunk the documents in the data source. A chunk refers to an excerpt from a data source that is returned when the knowledge base that it belongs to is queried. See [`chunking_configuration` block](#chunking_configuration-block) for details.
+
+### `chunking_configuration` block
+
+ The `chunking_configuration` configuration block supports the following arguments:
+
+* `chunking_strategy` - (Required) Option for chunking your source data, either in fixed-sized chunks or as one chunk. Valid values: `FIX_SIZE`, `NONE`.
+* `fixed_size_chunking_configuration` - (Optional) Configurations for when you choose fixed-size chunking. If you set the chunking_strategy as `NONE`, exclude this field. See [`fixed_size_chunking_configuration`](#fixed_size_chunking_configuration-block) for details.
+
+### `fixed_size_chunking_configuration` block
+
+The `fixed_size_chunking_configuration` block supports the following arguments:
+
+* `max_tokens` - (Required) Maximum number of tokens to include in a chunk.
+* `overlap_percentage` - (Optional) Percentage of overlap between adjacent chunks of a data source.
 
 ## Attribute Reference
 
 This resource exports the following attributes in addition to the arguments above:
 
-* `arn` - ARN of the Data Source. Do not begin the description with "An", "The", "Defines", "Indicates", or "Specifies," as these are verbose. In other words, "Indicates the amount of storage," can be rewritten as "Amount of storage," without losing any information.
-* `example_attribute` - Concise description. Do not begin the description with "An", "The", "Defines", "Indicates", or "Specifies," as these are verbose. In other words, "Indicates the amount of storage," can be rewritten as "Amount of storage," without losing any information.
+* `data_source_id` -  Unique identifier of the data source.
+* `id` -  Identifier of the data source which consists of the data source ID and the knowledge base ID.
 
 ## Timeouts
 
@@ -45,17 +100,17 @@ This resource exports the following attributes in addition to the arguments abov
 
 ## Import
 
-In Terraform v1.5.0 and later, use an [`import` block](https://developer.hashicorp.com/terraform/language/import) to import Agents for Amazon Bedrock Data Source using the `example_id_arg`. For example:
+In Terraform v1.5.0 and later, use an [`import` block](https://developer.hashicorp.com/terraform/language/import) to import Agents for Amazon Bedrock Data Source using the data source ID and the knowledge base ID. For example:
 
 ```terraform
 import {
   to = aws_bedrockagent_data_source.example
-  id = "data_source-id-12345678"
+  id = "GWCMFMQF6T,EMDPPAYPZI"
 }
 ```
 
-Using `terraform import`, import Agents for Amazon Bedrock Data Source using the `example_id_arg`. For example:
+Using `terraform import`, import Agents for Amazon Bedrock Data Source using the data source ID and the knowledge base ID. For example:
 
 ```console
-% terraform import aws_bedrockagent_data_source.example data_source-id-12345678
+% terraform import aws_bedrockagent_data_source.example GWCMFMQF6T,EMDPPAYPZI
 ```