---
title: "Update tenancy config"
method: PATCH
path: "/api/v2/integration/oci/tenancies/{tenancy_ocid}"
tags: ["OCI Integration"]
---

# Update tenancy config

`PATCH /api/v2/integration/oci/tenancies/{tenancy_ocid}`

Update an existing tenancy config. You can modify authentication credentials, enable/disable collection types, update service filters, and change region settings. Warning: We recommend using the Datadog web UI to avoid unintended update effects.

## Path parameters

- `tenancy_ocid` string, required

## Request body

- UpdateTenancyConfigRequest — Request body for updating an existing OCI tenancy integration configuration.
  - `data` UpdateTenancyConfigData, required — The data object for updating an existing OCI tenancy integration configuration, including the tenancy ID, type, and updated attributes.
    - `attributes` UpdateTenancyConfigDataAttributes — Attributes for updating an existing OCI tenancy integration configuration, including optional credentials, region settings, and collection options.
      - `auth_credentials` UpdateTenancyConfigDataAttributesAuthCredentials — OCI API signing key credentials used to update the Datadog integration's authentication with the OCI tenancy.
        - `fingerprint` string — The fingerprint of the OCI API signing key used for authentication.
        - `private_key` string, required — The PEM-encoded private key corresponding to the OCI API signing key fingerprint.
      - `cost_collection_enabled` boolean — Whether cost data collection from OCI is enabled for the tenancy.
      - `home_region` string — The home region of the OCI tenancy (for example, us-ashburn-1).
      - `logs_config` UpdateTenancyConfigDataAttributesLogsConfig — Log collection configuration for updating an OCI tenancy, controlling which compartments and services have log collection enabled.
        - `compartment_tag_filters` string[] — List of compartment tag filters to scope log collection to specific compartments.
        - `enabled` boolean — Whether log collection is enabled for the tenancy.
        - `enabled_services` string[] — List of OCI service names for which log collection is enabled.
      - `metrics_config` UpdateTenancyConfigDataAttributesMetricsConfig — Metrics collection configuration for updating an OCI tenancy, controlling which compartments and services are included or excluded.
        - `compartment_tag_filters` string[] — List of compartment tag filters to scope metrics collection to specific compartments.
        - `enabled` boolean — Whether metrics collection is enabled for the tenancy.
        - `excluded_services` string[] — List of OCI service names to exclude from metrics collection.
      - `regions_config` UpdateTenancyConfigDataAttributesRegionsConfig — Region configuration for updating an OCI tenancy, specifying which regions are available, enabled, or disabled for data collection.
        - `available` string[] — List of OCI regions available for data collection in the tenancy.
        - `disabled` string[] — List of OCI regions explicitly disabled for data collection.
        - `enabled` string[] — List of OCI regions enabled for data collection.
      - `resource_collection_enabled` boolean — Whether resource collection from OCI is enabled for the tenancy.
      - `user_ocid` string — The OCID of the OCI user used by the Datadog integration for authentication.
    - `id` string, required — The OCID of the OCI tenancy to update.
    - `type` 'oci_tenancy', required — OCI tenancy resource type.

## Response `200`

OK

- TenancyConfig — Response containing a single OCI tenancy integration configuration.
  - `data` TenancyConfigData — A single OCI tenancy integration configuration resource object containing the tenancy ID, type, and configuration attributes.
    - `attributes` TenancyConfigDataAttributes — Attributes of an OCI tenancy integration configuration, including authentication details, region settings, and collection options.
      - `billing_plan_id` integer — The identifier of the billing plan associated with the OCI tenancy.
      - `config_version` integer — Version number of the integration the tenancy is integrated with
      - `cost_collection_enabled` boolean — Whether cost data collection from OCI is enabled for the tenancy.
      - `dd_compartment_id` string — The OCID of the OCI compartment used by the Datadog integration stack.
      - `dd_stack_id` string — The OCID of the OCI Resource Manager stack used by the Datadog integration.
      - `home_region` string — The home region of the OCI tenancy (for example, us-ashburn-1).
      - `logs_config` TenancyConfigDataAttributesLogsConfig — Log collection configuration for an OCI tenancy, indicating which compartments and services have log collection enabled.
        - `compartment_tag_filters` string[] — List of compartment tag filters scoping log collection to specific compartments.
        - `enabled` boolean — Whether log collection is enabled for the tenancy.
        - `enabled_services` string[] — List of OCI service names for which log collection is enabled.
      - `metrics_config` TenancyConfigDataAttributesMetricsConfig — Metrics collection configuration for an OCI tenancy, indicating which compartments and services are included or excluded.
        - `compartment_tag_filters` string[] — List of compartment tag filters scoping metrics collection to specific compartments.
        - `enabled` boolean — Whether metrics collection is enabled for the tenancy.
        - `excluded_services` string[] — List of OCI service names excluded from metrics collection.
      - `parent_tenancy_name` string — The name of the parent OCI tenancy, if applicable.
      - `regions_config` TenancyConfigDataAttributesRegionsConfig — Region configuration for an OCI tenancy, indicating which regions are available, enabled, or disabled for data collection.
        - `available` string[] — List of OCI regions available for data collection in the tenancy.
        - `disabled` string[] — List of OCI regions explicitly disabled for data collection.
        - `enabled` string[] — List of OCI regions enabled for data collection.
      - `resource_collection_enabled` boolean — Whether resource collection from OCI is enabled for the tenancy.
      - `tenancy_name` string — The human-readable name of the OCI tenancy.
      - `user_ocid` string — The OCID of the OCI user used by the Datadog integration for authentication.
    - `id` string — The OCID of the OCI tenancy.
    - `type` 'oci_tenancy', required — OCI tenancy resource type.

## Other responses

- `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)