# Source: https://docs.datadoghq.com/ddsql_reference/data_directory/gcp/gcp.storageinsights_dataset_config.dataset.md

---
title: Storage Insights Dataset Config
description: Datadog, the leading service for cloud-scale monitoring.
breadcrumbs: Docs > DDSQL Reference > Data Directory > Storage Insights Dataset Config
---

# Storage Insights Dataset Config

Storage Insights Dataset Config in GCP defines the configuration for datasets used by Storage Insights. It manages how data is collected, stored, and analyzed for insights into storage usage and performance. This resource helps automate dataset creation and configuration to support reporting and monitoring of storage metrics across Google Cloud Storage environments.

```
gcp.storageinsights_dataset_config
```

## Fields

| Title                           | ID   | Type          | Data Type                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       | Description |
| ------------------------------- | ---- | ------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------- |
| _key                            | core | string        |
| ancestors                       | core | array<string> |
| cloud_storage_object_path       | core | string        | Input only. Cloud Storage object path containing a list of project or folder numbers to include in the dataset; it cannot contain a mix of project and folders. The object must be a text file where each line has one of the following entries: - Project number, formatted as `projects/{project_number}`, for example, `projects/1234567890`. - Folder identifier, formatted as `folders/{folder_number}`, for example, `folders/9876543210`. Path must be in the format `gs://{bucket_name}/{object_name}`. |
| create_time                     | core | timestamp     | Output only. The UTC time at which the dataset configuration was created. This is auto-populated.                                                                                                                                                                                                                                                                                                                                                                                                               |
| datadog_display_name            | core | string        |
| dataset_config_state            | core | string        | Output only. State of the `datasetConfig`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| description                     | core | string        | Optional. A user-provided description for the dataset configuration. Maximum length: 256 characters.                                                                                                                                                                                                                                                                                                                                                                                                            |
| exclude_cloud_storage_buckets   | core | json          |
| exclude_cloud_storage_locations | core | json          |
| gcp_status                      | core | json          | Output only. Status of the `datasetConfig`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| identity                        | core | json          | Identity used by this `datasetConfig`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| include_cloud_storage_buckets   | core | json          |
| include_cloud_storage_locations | core | json          |
| include_newly_created_buckets   | core | bool          | If set to `true`, the request includes all the newly created buckets in the dataset that meet the inclusion and exclusion rules.                                                                                                                                                                                                                                                                                                                                                                                |
| labels                          | core | array<string> | Labels as key value pairs                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| link                            | core | json          | Details of the linked dataset.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| name                            | core | string        | Identifier. name of resource                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| organization_id                 | core | string        |
| organization_number             | core | int64         | Optional. Organization resource ID that the source projects should belong to. Projects that do not belong to the provided organization are not considered when creating the dataset.                                                                                                                                                                                                                                                                                                                            |
| organization_scope              | core | bool          | Defines the options for providing a source organization for the dataset.                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| parent                          | core | string        |
| project_id                      | core | string        |
| project_number                  | core | string        |
| region_id                       | core | string        |
| resource_name                   | core | string        |
| retention_period_days           | core | int64         | Number of days of history that must be retained.                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| skip_verification_and_ingest    | core | bool          | Optional. If set to `false`, then all the permission checks must be successful before the system can start ingesting data. This field can only be updated before the system ingests data for the first time. Any attempt to modify the field after data ingestion starts results in an error.                                                                                                                                                                                                                   |
| source_folders                  | core | json          | Defines the options for providing source folders for the dataset.                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| source_projects                 | core | json          | Defines the options for providing source projects for the dataset.                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| tags                            | core | hstore_csv    |
| uid                             | core | string        | Output only. System generated unique identifier for the resource.                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| update_time                     | core | timestamp     | Output only. The UTC time at which the dataset configuration was last updated. This is auto-populated.                                                                                                                                                                                                                                                                                                                                                                                                          |
| zone_id                         | core | string        |