---
title: "Create tenancy config"
method: POST
path: "/api/v2/integration/oci/tenancies"
tags: ["OCI Integration"]
---

# Create tenancy config

`POST /api/v2/integration/oci/tenancies`

## Request

- Base URL: `https://api.datadoghq.com`
- URL: `https://api.datadoghq.com/api/v2/integration/oci/tenancies`
- Auth: API key in header `DD-API-KEY` and API key in header `DD-APPLICATION-KEY`

Create a new tenancy config to establish monitoring and data collection from your OCI environment. Requires OCI authentication credentials and tenancy details. Warning: Datadog recommends interacting with this endpoint only through the Datadog web UI to ensure all necessary OCI resources have been created and configured properly.

## Request body

- CreateTenancyConfigRequest: Request body for creating a new OCI tenancy integration configuration.
  - `data` CreateTenancyConfigData, required: The data object for creating a new OCI tenancy integration configuration, including the tenancy ID, type, and configuration attributes.
    - `attributes` CreateTenancyConfigDataAttributes: Attributes for creating a new OCI tenancy integration configuration, including credentials, region settings, and collection options.
      - `auth_credentials` CreateTenancyConfigDataAttributesAuthCredentials, required: OCI API signing key credentials used to authenticate the Datadog integration 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.
      - `config_version` integer, nullable: 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, required: The home region of the OCI tenancy (for example, us-ashburn-1).
      - `logs_config` CreateTenancyConfigDataAttributesLogsConfig: Log collection configuration for 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` CreateTenancyConfigDataAttributesMetricsConfig: Metrics collection configuration for 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` CreateTenancyConfigDataAttributesRegionsConfig: Region configuration for 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, required: The OCID of the OCI user used by the Datadog integration for authentication.
    - `id` string, required: The OCID of the OCI tenancy to configure.
    - `type` 'oci_tenancy', required: OCI tenancy resource type.

## Response `201`

Created

- 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.dev/datadog/apis/datadog-api-v2-collection.md) - [All operations](https://skmtc.dev/datadog/apis/datadog-api-v2-collection/llms.txt) - [OpenAPI document](https://skmtc.dev/datadog/apis/datadog-api-v2-collection/revisions/da68bf029e4c?raw)