---
title: "Enable Storage Management for a bucket"
method: PUT
path: "/api/v2/cloudinventoryservice/syncconfigs"
tags: ["Storage Management"]
---

# Enable Storage Management for a bucket

`PUT /api/v2/cloudinventoryservice/syncconfigs`

Enable Storage Management for an S3 bucket, GCS bucket, or Azure container by registering the destination that holds its inventory reports. Set `data.id` to the cloud provider (`aws`, `gcp`, or `azure`) and provide the matching settings under data.attributes. Calling this endpoint with the same provider replaces the existing configuration.

## Request body

- UpsertCloudInventorySyncConfigRequest — Request body for creating or updating a cloud inventory sync configuration.
  - `data` UpsertCloudInventorySyncConfigRequestData, required — Storage Management configuration data for the create or update request.
    - `attributes` UpsertCloudInventorySyncConfigRequestAttributes, required — Settings for the cloud provider specified in `data.id`. Include only the matching provider object (`aws`, `gcp`, or `azure`).
      - `aws` CloudInventorySyncConfigAWSRequestAttributes — AWS settings for the S3 bucket Storage Management reads inventory reports from.
        - `aws_account_id` string, required — AWS account ID that owns the inventory bucket.
        - `destination_bucket_name` string, required — Name of the S3 bucket containing inventory files.
        - `destination_bucket_region` string, required — AWS Region of the inventory bucket.
        - `destination_prefix` string — Object key prefix where inventory reports are written. Omit or set to `/` when reports are written at the bucket root.
      - `azure` CloudInventorySyncConfigAzureRequestAttributes — Azure settings for the storage account and container with inventory data.
        - `client_id` string, required — Azure AD application (client) ID used for access.
        - `container` string, required — Blob container name.
        - `resource_group` string, required — Resource group containing the storage account.
        - `storage_account` string, required — Storage account name.
        - `subscription_id` string, required — Azure subscription ID.
        - `tenant_id` string, required — Azure AD tenant ID.
      - `gcp` CloudInventorySyncConfigGCPRequestAttributes — GCP settings for buckets involved in inventory reporting.
        - `destination_bucket_name` string, required — GCS bucket name where Datadog reads inventory reports.
        - `project_id` string, required — GCP project ID for the inventory destination bucket.
        - `service_account_email` string, required — Service account email used to read the destination bucket.
        - `source_bucket_name` string, required — GCS bucket name that inventory reports are generated for.
    - `id` 'aws' | 'gcp' | 'azure', required — Cloud provider for this sync configuration (`aws`, `gcp`, or `azure`). For requests, must match the provider block supplied under `attributes`.
    - `type` 'cloud_provider', required — Always `cloud_provider`.

## Response `200`

OK

- CloudInventorySyncConfigResponse — Storage Management configuration returned after a create or update. Additional read-only fields appear on list and get responses.
  - `data` CloudInventorySyncConfigResponseData, required — Storage Management configuration data.
    - `attributes` CloudInventorySyncConfigAttributes, required — Attributes for a Storage Management configuration. Fields other than `id` may be empty in the response immediately after a create or update; subsequent reads return the full configuration.
      - `aws_account_id` string, required — AWS account ID for the inventory bucket.
      - `aws_bucket_name` string, required — AWS S3 bucket name for inventory files.
      - `aws_region` string, required — AWS Region for the inventory bucket.
      - `azure_client_id` string, required — Azure AD application (client) ID.
      - `azure_container_name` string, required — Azure blob container name.
      - `azure_storage_account_name` string, required — Azure storage account name.
      - `azure_tenant_id` string, required — Azure AD tenant ID.
      - `cloud_provider` 'aws' | 'gcp' | 'azure', required — Cloud provider for this sync configuration (`aws`, `gcp`, or `azure`). For requests, must match the provider block supplied under `attributes`.
      - `error` string, required — Human-readable error detail when sync is unhealthy.
      - `error_code` string, required — Machine-readable error code when sync is unhealthy.
      - `gcp_bucket_name` string, required — GCS bucket name for inventory files Datadog reads.
      - `gcp_project_id` string, required — GCP project ID.
      - `gcp_service_account_email` string, required — Service account email for bucket access.
      - `prefix` string, required — Object key prefix where inventory reports are written. Returns `/` when reports are written at the bucket root.
    - `id` string, required — Unique identifier for this Storage Management configuration.
    - `type` 'sync_configs', required — Always `sync_configs`.

## Other responses

- `400` — Bad Request
- `403` — Forbidden
- `429` — Too many requests

---

[API](https://skmtc.net/datadog/apis/api-v2.md) · [All operations](https://skmtc.net/datadog/apis/api-v2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/datadog/api-v2/revisions/da68bf029e4c/schema)