> ## Documentation Index
> Fetch the complete documentation index at: https://docs.vantage.sh/llms.txt
> Use this file to discover all available pages before exploring further.

# vantage_custom_provider_costs_upload (Resource)

> Terraform resource reference for vantage_custom_provider_costs_upload (Resource). Auto-generated from the vantage-sh/terraform-provider-vantage repository.

<Note>
  This page is auto-generated based on the official [Terraform documentation](https://registry.terraform.io/providers/vantage-sh/vantage/latest/docs).
</Note>

## Overview

Use this resource with the [Vantage Terraform provider](/terraform). For installation and authentication, see the [Terraform provider quickstart](/terraform#quickstart). The schema below is generated directly from the provider source.

Uploads a CSV of costs for a Custom Provider integration. The CSV must conform to the [FOCUS](https://focus.finops.org/) format, or set `auto_transform = true` to let Vantage attempt an automatic conversion.

Destroying this resource deletes the upload from Vantage.

> **Note:** This resource does not support `terraform import`. There is no GET endpoint for individual uploads, so import cannot hydrate the required `integration_token` and `csv_content` fields. Manage this resource exclusively through Terraform from initial creation.

## Example Usage

```terraform theme={null}
resource "vantage_custom_provider" "example" {
  name = "My Custom Provider"
}

resource "vantage_custom_provider_costs_upload" "example" {
  integration_token = vantage_custom_provider.example.token
  csv_content       = file("${path.module}/costs.csv")
  auto_transform    = true
}
```

## Schema

### Required

* `csv_content` (String, Sensitive) CSV content to upload as costs data. Must conform to the FOCUS format unless `auto_transform` is enabled. This value is write-only and is never returned by the API; it is stored in state solely to detect changes.
* `integration_token` (String) The token of the Custom Provider integration to upload costs for.

### Optional

* `auto_transform` (Boolean) When true, Vantage attempts to automatically transform the CSV to match the FOCUS format. Defaults to false.
* `filename` (String) Filename to use when uploading the CSV. Defaults to `costs.csv`. The API records this name and returns it in the `filename` attribute after upload. Changing this value forces a new upload.

### Read-Only

* `amount` (String) The total amount of costs in the upload.
* `end_date` (String) The end date of the billing period covered by the upload.
* `filename` (String) The filename recorded by the API after upload.
* `id` (String) Same as `token`.
* `import_status` (String) The import status of the upload (e.g. `processing`, `complete`, `error`).
* `start_date` (String) The start date of the billing period covered by the upload.
* `token` (String) Unique token of the costs upload.