`s3vector_delete_bucket`

Delete an Amazon S3 Vector bucket.

This operation requires the s3vectors:DeleteVectorBucket IAM permission. The service rejects deletion while the bucket contains an index or has an operation in progress, so delete every index first.

Parameters

vector_bucket_namestringrequired*: Explicit bucket name to delete.
bucketstringdefault no: Alias for vector_bucket_name.
vector_bucket_arnstringrequired*: Explicit alternative bucket ARN.
regionstringdefault AWS region chain: Override S3VECTORS_REGION, S3_REGION, AWS_REGION, or AWS_DEFAULT_REGION.
endpoint_urlstringdefault AWS_ENDPOINT_URL env var: Override the S3 Vectors service endpoint.
output_keystringdefault s3vector: Prefix for context output keys.

Target Resolution and Safety

Use exactly one explicit configured target after interpolation: vector_bucket_name/bucket or vector_bucket_arn. Resource identifier environment variables are deliberately never consulted for bucket deletion; region, endpoint, and AWS credentials may still come from the environment. Conflicting forms and non-string or blank targets fail before the AWS client is built.

Context Output

{output_key}_bucket_name — Deleted bucket name when deletion used a name.
{output_key}_bucket_arn — Deleted bucket ARN when deletion used an ARN.
{output_key}_success — true after the service accepts the deletion.

The service returns no resource body; the identifier field above echoes the validated request target.

Example

flow:step("delete_bucket", nodes.s3vector_delete_bucket({
    vector_bucket_name = "${ctx.bucket_bucket_name}",
    output_key = "deleted_bucket"
})):depends_on("delete_index")

See the runnable s3vector_vector_workflow.lua for the complete vectors → index → bucket teardown order.