Document NDM device tag sources

.generator/schemas/v2/openapi.yaml

@@ -34926,6 +34926,21 @@ components:
           format: int64
           type: integer
       type: object
+    DeviceTagsBySource:
+      description: Tags associated with a device from a specific source.
+      properties:
+        source:
+          description: The source of the tags.
+          example: user
+          type: string
+        tags:
+          description: The list of tags for the source.
+          example: ["tag:test", "tag:testbis"]
+          items:
+            description: A tag string in `key:value` format.
+            type: string
+          type: array
+      type: object
     DevicesListData:
       description: The devices list data
       properties:
@@ -65303,6 +65318,12 @@ components:
     ListTagsResponseDataAttributes:
       description: The definition of ListTagsResponseDataAttributes object.
       properties:
+        by_source:
+          description: The list of device tags grouped by source.
+          items:
+            $ref: '#/components/schemas/DeviceTagsBySource'
+          readOnly: true
+          type: array
         tags:
           description: The list of tags
           example: ["tag:test", "tag:testbis"]
@@ -180091,6 +180112,20 @@ paths:
           content:
             application/json:
               examples:
+                by_source:
+                  value:
+                    data:
+                      attributes:
+                        by_source:
+                          - source: user
+                            tags:
+                              - "tag:test"
+                              - "tag:testbis"
+                          - source: snmp
+                            tags:
+                              - "device_ip:1.2.3.4"
+                      id: foiwf7rgw38fh
+                      type: tags
                 default:
                   value:
                     data:

packages/datadog-api-client-v2/index.ts

@@ -3929,6 +3929,7 @@ export { DetailedFindingType } from "./models/DetailedFindingType";
 export { DeviceAttributes } from "./models/DeviceAttributes";
 export { DeviceAttributesInterfaceStatuses } from "./models/DeviceAttributesInterfaceStatuses";
 export { DevicesListData } from "./models/DevicesListData";
+export { DeviceTagsBySource } from "./models/DeviceTagsBySource";
 export { DnsMetricKey } from "./models/DnsMetricKey";
 export { DomainAllowlist } from "./models/DomainAllowlist";
 export { DomainAllowlistAttributes } from "./models/DomainAllowlistAttributes";

packages/datadog-api-client-v2/models/DeviceTagsBySource.ts

@@ -0,0 +1,60 @@
+/**
+ * Unless explicitly stated otherwise all files in this repository are licensed under the Apache-2.0 License.
+ * This product includes software developed at Datadog (https://www.datadoghq.com/).
+ * Copyright 2020-Present Datadog, Inc.
+ */
+
+import { AttributeTypeMap } from "../../datadog-api-client-common/util";
+
+/**
+ * Tags associated with a device from a specific source.
+ */
+export class DeviceTagsBySource {
+  /**
+   * The source of the tags.
+   */
+  "source"?: string;
+  /**
+   * The list of tags for the source.
+   */
+  "tags"?: Array<string>;
+
+  /**
+   * A container for additional, undeclared properties.
+   * This is a holder for any undeclared properties as specified with
+   * the 'additionalProperties' keyword in the OAS document.
+   */
+  "additionalProperties"?: { [key: string]: any };
+
+  /**
+   * @ignore
+   */
+  "_unparsed"?: boolean;
+
+  /**
+   * @ignore
+   */
+  static readonly attributeTypeMap: AttributeTypeMap = {
+    source: {
+      baseName: "source",
+      type: "string",
+    },
+    tags: {
+      baseName: "tags",
+      type: "Array<string>",
+    },
+    additionalProperties: {
+      baseName: "additionalProperties",
+      type: "{ [key: string]: any; }",
+    },
+  };
+
+  /**
+   * @ignore
+   */
+  static getAttributeTypeMap(): AttributeTypeMap {
+    return DeviceTagsBySource.attributeTypeMap;
+  }
+
+  public constructor() {}
+}

packages/datadog-api-client-v2/models/ListTagsResponseDataAttributes.ts

@@ -3,13 +3,18 @@
  * This product includes software developed at Datadog (https://www.datadoghq.com/).
  * Copyright 2020-Present Datadog, Inc.
  */
+import { DeviceTagsBySource } from "./DeviceTagsBySource";
 
 import { AttributeTypeMap } from "../../datadog-api-client-common/util";
 
 /**
  * The definition of ListTagsResponseDataAttributes object.
  */
 export class ListTagsResponseDataAttributes {
+  /**
+   * The list of device tags grouped by source.
+   */
+  "bySource"?: Array<DeviceTagsBySource>;
   /**
    * The list of tags
    */
@@ -31,6 +36,10 @@ export class ListTagsResponseDataAttributes {
    * @ignore
    */
   static readonly attributeTypeMap: AttributeTypeMap = {
+    bySource: {
+      baseName: "by_source",
+      type: "Array<DeviceTagsBySource>",
+    },
     tags: {
       baseName: "tags",
       type: "Array<string>",

packages/datadog-api-client-v2/models/ObjectSerializer.ts

@@ -1529,6 +1529,7 @@ import { DetailedFinding } from "./DetailedFinding";
 import { DetailedFindingAttributes } from "./DetailedFindingAttributes";
 import { DeviceAttributes } from "./DeviceAttributes";
 import { DeviceAttributesInterfaceStatuses } from "./DeviceAttributesInterfaceStatuses";
+import { DeviceTagsBySource } from "./DeviceTagsBySource";
 import { DevicesListData } from "./DevicesListData";
 import { DomainAllowlist } from "./DomainAllowlist";
 import { DomainAllowlistAttributes } from "./DomainAllowlistAttributes";
@@ -11102,6 +11103,7 @@ const typeMap: { [index: string]: any } = {
   DetailedFindingAttributes: DetailedFindingAttributes,
   DeviceAttributes: DeviceAttributes,
   DeviceAttributesInterfaceStatuses: DeviceAttributesInterfaceStatuses,
+  DeviceTagsBySource: DeviceTagsBySource,
   DevicesListData: DevicesListData,
   DomainAllowlist: DomainAllowlist,
   DomainAllowlistAttributes: DomainAllowlistAttributes,