Regenerate client from commit 45ed7ff of spec repo

Author: ci.datadog-api-spec

.generator/schemas/v1/openapi.yaml

@@ -4180,14 +4180,14 @@ components:
           type: boolean
       type: object
     HostTags:
-      description: Set of tags to associate with your host.
+      description: Host name and an array of its tags
       properties:
         host:
           description: Your host name.
           example: test.host
           type: string
         tags:
-          description: A list of tags to apply to the host.
+          description: A list of tags associated with a host.
           items:
             description: A given tag in a list.
             example: environment:production
@@ -18703,18 +18703,18 @@ components:
       - match
       type: object
     TagToHosts:
-      description: In this object, the key is the tag, the value is a list of host
-        names that are reporting that tag.
+      description: In this object, the key is the tag, and the value is a list of
+        host names that are reporting that tag.
       properties:
         tags:
           additionalProperties:
-            description: A list of additional properties for tags.
+            description: A list of host names which contain this tag
             items:
               description: A given tag in a list.
               example: test.metric.host
               type: string
             type: array
-          description: A list of tags to apply to the host.
+          description: A mapping of tags to host names
           type: object
       type: object
     TargetFormatType:
@@ -35726,11 +35726,13 @@ paths:
         - synthetics_global_variable_write
   /api/v1/tags/hosts:
     get:
-      description: Return a mapping of tags to hosts for your whole infrastructure.
+      description: Returns a mapping of tags to hosts. For each tag, the response
+        returns a list of host names that contain this tag. There is a restriction
+        of 10k total host names from the org that can be attached to tags and returned.
       operationId: ListHostTags
       parameters:
-      - description: When specified, filters host list to those tags with the specified
-          source.
+      - description: Source to filter. [Complete list of source attribute values](https://docs.datadoghq.com/integrations/faq/list-of-api-source-attribute-value).
+          Use "user" source for custom-defined tags.
         in: query
         name: source
         required: false
@@ -35761,29 +35763,29 @@ paths:
       - apiKeyAuth: []
         appKeyAuth: []
       - AuthZ: []
-      summary: Get Tags
+      summary: Get All Host Tags
       tags:
       - Tags
       x-permission:
         operator: OPEN
         permissions: []
   /api/v1/tags/hosts/{host_name}:
     delete:
-      description: 'This endpoint allows you to remove all user-assigned tags
+      description: 'This endpoint allows you to remove all tags
 
-        for a single host.'
+        for a single host. If no source is specified, only deletes from the source
+        "User".'
       operationId: DeleteHostTags
       parameters:
-      - description: This endpoint allows you to remove all user-assigned tags for
-          a single host.
+      - description: Specified host name to delete tags
         in: path
         name: host_name
         required: true
         schema:
           type: string
-      - description: 'The source of the tags (for example chef, puppet).
-
-          [Complete list of source attribute values](https://docs.datadoghq.com/integrations/faq/list-of-api-source-attribute-value).'
+      - description: Source of the tags to be deleted. [Complete list of source attribute
+          values](https://docs.datadoghq.com/integrations/faq/list-of-api-source-attribute-value).
+          Use "user" source for custom-defined tags.
         in: query
         name: source
         required: false
@@ -35813,14 +35815,14 @@ paths:
       description: Return the list of tags that apply to a given host.
       operationId: GetHostTags
       parameters:
-      - description: When specified, filters list of tags to those tags with the specified
-          source.
+      - description: Name of the host to retrieve tags for
         in: path
         name: host_name
         required: true
         schema:
           type: string
-      - description: Source to filter.
+      - description: Source to filter. [Complete list of source attribute values](https://docs.datadoghq.com/integrations/faq/list-of-api-source-attribute-value).
+          Use "user" source for custom-defined tags.
         in: query
         name: source
         required: false
@@ -35847,25 +35849,25 @@ paths:
           description: Not Found
         '429':
           $ref: '#/components/responses/TooManyRequestsResponse'
-      summary: Get host tags
+      summary: Get Host Tags
       tags:
       - Tags
     post:
       description: 'This endpoint allows you to add new tags to a host,
 
-        optionally specifying where these tags come from.'
+        optionally specifying what source these tags come from. If tags exist, appends
+        tags to the end of the existing tag list'
       operationId: CreateHostTags
       parameters:
-      - description: This endpoint allows you to add new tags to a host, optionally
-          specifying where the tags came from.
+      - description: Specified host name to add new tags
         in: path
         name: host_name
         required: true
         schema:
           type: string
-      - description: 'The source of the tags.
-
-          [Complete list of source attribute values](https://docs.datadoghq.com/integrations/faq/list-of-api-source-attribute-value).'
+      - description: Source to add tags. [Complete list of source attribute values](https://docs.datadoghq.com/integrations/faq/list-of-api-source-attribute-value).
+          Use "user" source for custom-defined tags. If no source is specified, defaults
+          to "user".
         example: chef
         in: query
         name: source
@@ -35910,16 +35912,15 @@ paths:
         an integration source with those supplied in the request.'
       operationId: UpdateHostTags
       parameters:
-      - description: This endpoint allows you to update/replace all in an integration
-          source with those supplied in the request.
+      - description: Specified host name to change tags
         in: path
         name: host_name
         required: true
         schema:
           type: string
-      - description: 'The source of the tags (for example chef, puppet).
-
-          [Complete list of source attribute values](https://docs.datadoghq.com/integrations/faq/list-of-api-source-attribute-value)'
+      - description: Source to update tags. [Complete list of source attribute values](https://docs.datadoghq.com/integrations/faq/list-of-api-source-attribute-value).
+          Use "user" source for custom-defined tags. If no source specified, defaults
+          to "user".
         in: query
         name: source
         required: false
@@ -38935,7 +38936,8 @@ tags:
 
     by a source. For example, some valid sources include nagios, hudson, jenkins,
 
-    users, feed, chef, puppet, git, bitbucket, fabric, capistrano, etc.
+    users, feed, chef, puppet, git, bitbucket, fabric, capistrano, etc. Find a complete
+    list of source type names under [API Source Attributes](https://docs.datadoghq.com/integrations/faq/list-of-api-source-attribute-value).
 
 
     Read more about tags on [Getting Started with Tags](https://docs.datadoghq.com/getting_started/tagging/).'

examples/v1_tags_GetHostTags.rs

@@ -1,4 +1,4 @@
-// Get host tags returns "OK" response
+// Get Host Tags returns "OK" response
 use datadog_api_client::datadog;
 use datadog_api_client::datadogV1::api_tags::GetHostTagsOptionalParams;
 use datadog_api_client::datadogV1::api_tags::TagsAPI;

examples/v1_tags_ListHostTags.rs

@@ -1,4 +1,4 @@
-// Get Tags returns "OK" response
+// Get All Host Tags returns "OK" response
 use datadog_api_client::datadog;
 use datadog_api_client::datadogV1::api_tags::ListHostTagsOptionalParams;
 use datadog_api_client::datadogV1::api_tags::TagsAPI;

src/datadogV1/api/api_tags.rs

@@ -14,14 +14,12 @@ use std::io::Write;
 #[non_exhaustive]
 #[derive(Clone, Default, Debug)]
 pub struct CreateHostTagsOptionalParams {
-    /// The source of the tags.
-    /// [Complete list of source attribute values](<https://docs.datadoghq.com/integrations/faq/list-of-api-source-attribute-value>).
+    /// Source to add tags. [Complete list of source attribute values](<https://docs.datadoghq.com/integrations/faq/list-of-api-source-attribute-value>). Use "user" source for custom-defined tags. If no source is specified, defaults to "user".
     pub source: Option<String>,
 }
 
 impl CreateHostTagsOptionalParams {
-    /// The source of the tags.
-    /// [Complete list of source attribute values](<https://docs.datadoghq.com/integrations/faq/list-of-api-source-attribute-value>).
+    /// Source to add tags. [Complete list of source attribute values](<https://docs.datadoghq.com/integrations/faq/list-of-api-source-attribute-value>). Use "user" source for custom-defined tags. If no source is specified, defaults to "user".
     pub fn source(mut self, value: String) -> Self {
         self.source = Some(value);
         self
@@ -32,14 +30,12 @@ impl CreateHostTagsOptionalParams {
 #[non_exhaustive]
 #[derive(Clone, Default, Debug)]
 pub struct DeleteHostTagsOptionalParams {
-    /// The source of the tags (for example chef, puppet).
-    /// [Complete list of source attribute values](<https://docs.datadoghq.com/integrations/faq/list-of-api-source-attribute-value>).
+    /// Source of the tags to be deleted. [Complete list of source attribute values](<https://docs.datadoghq.com/integrations/faq/list-of-api-source-attribute-value>). Use "user" source for custom-defined tags.
     pub source: Option<String>,
 }
 
 impl DeleteHostTagsOptionalParams {
-    /// The source of the tags (for example chef, puppet).
-    /// [Complete list of source attribute values](<https://docs.datadoghq.com/integrations/faq/list-of-api-source-attribute-value>).
+    /// Source of the tags to be deleted. [Complete list of source attribute values](<https://docs.datadoghq.com/integrations/faq/list-of-api-source-attribute-value>). Use "user" source for custom-defined tags.
     pub fn source(mut self, value: String) -> Self {
         self.source = Some(value);
         self
@@ -50,12 +46,12 @@ impl DeleteHostTagsOptionalParams {
 #[non_exhaustive]
 #[derive(Clone, Default, Debug)]
 pub struct GetHostTagsOptionalParams {
-    /// Source to filter.
+    /// Source to filter. [Complete list of source attribute values](<https://docs.datadoghq.com/integrations/faq/list-of-api-source-attribute-value>). Use "user" source for custom-defined tags.
     pub source: Option<String>,
 }
 
 impl GetHostTagsOptionalParams {
-    /// Source to filter.
+    /// Source to filter. [Complete list of source attribute values](<https://docs.datadoghq.com/integrations/faq/list-of-api-source-attribute-value>). Use "user" source for custom-defined tags.
     pub fn source(mut self, value: String) -> Self {
         self.source = Some(value);
         self
@@ -66,12 +62,12 @@ impl GetHostTagsOptionalParams {
 #[non_exhaustive]
 #[derive(Clone, Default, Debug)]
 pub struct ListHostTagsOptionalParams {
-    /// When specified, filters host list to those tags with the specified source.
+    /// Source to filter. [Complete list of source attribute values](<https://docs.datadoghq.com/integrations/faq/list-of-api-source-attribute-value>). Use "user" source for custom-defined tags.
     pub source: Option<String>,
 }
 
 impl ListHostTagsOptionalParams {
-    /// When specified, filters host list to those tags with the specified source.
+    /// Source to filter. [Complete list of source attribute values](<https://docs.datadoghq.com/integrations/faq/list-of-api-source-attribute-value>). Use "user" source for custom-defined tags.
     pub fn source(mut self, value: String) -> Self {
         self.source = Some(value);
         self
@@ -82,14 +78,12 @@ impl ListHostTagsOptionalParams {
 #[non_exhaustive]
 #[derive(Clone, Default, Debug)]
 pub struct UpdateHostTagsOptionalParams {
-    /// The source of the tags (for example chef, puppet).
-    /// [Complete list of source attribute values](<https://docs.datadoghq.com/integrations/faq/list-of-api-source-attribute-value>)
+    /// Source to update tags. [Complete list of source attribute values](<https://docs.datadoghq.com/integrations/faq/list-of-api-source-attribute-value>). Use "user" source for custom-defined tags. If no source specified, defaults to "user".
     pub source: Option<String>,
 }
 
 impl UpdateHostTagsOptionalParams {
-    /// The source of the tags (for example chef, puppet).
-    /// [Complete list of source attribute values](<https://docs.datadoghq.com/integrations/faq/list-of-api-source-attribute-value>)
+    /// Source to update tags. [Complete list of source attribute values](<https://docs.datadoghq.com/integrations/faq/list-of-api-source-attribute-value>). Use "user" source for custom-defined tags. If no source specified, defaults to "user".
     pub fn source(mut self, value: String) -> Self {
         self.source = Some(value);
         self
@@ -144,7 +138,7 @@ pub enum UpdateHostTagsError {
 ///
 /// The component of your infrastructure responsible for a tag is identified
 /// by a source. For example, some valid sources include nagios, hudson, jenkins,
-/// users, feed, chef, puppet, git, bitbucket, fabric, capistrano, etc.
+/// users, feed, chef, puppet, git, bitbucket, fabric, capistrano, etc. Find a complete list of source type names under [API Source Attributes](<https://docs.datadoghq.com/integrations/faq/list-of-api-source-attribute-value>).
 ///
 /// Read more about tags on [Getting Started with Tags](<https://docs.datadoghq.com/getting_started/tagging/>).
 #[derive(Debug, Clone)]
@@ -212,7 +206,7 @@ impl TagsAPI {
     }
 
     /// This endpoint allows you to add new tags to a host,
-    /// optionally specifying where these tags come from.
+    /// optionally specifying what source these tags come from. If tags exist, appends tags to the end of the existing tag list
     pub async fn create_host_tags(
         &self,
         host_name: String,
@@ -237,7 +231,7 @@ impl TagsAPI {
     }
 
     /// This endpoint allows you to add new tags to a host,
-    /// optionally specifying where these tags come from.
+    /// optionally specifying what source these tags come from. If tags exist, appends tags to the end of the existing tag list
     pub async fn create_host_tags_with_http_info(
         &self,
         host_name: String,
@@ -378,8 +372,8 @@ impl TagsAPI {
         }
     }
 
-    /// This endpoint allows you to remove all user-assigned tags
-    /// for a single host.
+    /// This endpoint allows you to remove all tags
+    /// for a single host. If no source is specified, only deletes from the source "User".
     pub async fn delete_host_tags(
         &self,
         host_name: String,
@@ -394,8 +388,8 @@ impl TagsAPI {
         }
     }
 
-    /// This endpoint allows you to remove all user-assigned tags
-    /// for a single host.
+    /// This endpoint allows you to remove all tags
+    /// for a single host. If no source is specified, only deletes from the source "User".
     pub async fn delete_host_tags_with_http_info(
         &self,
         host_name: String,
@@ -594,7 +588,7 @@ impl TagsAPI {
         }
     }
 
-    /// Return a mapping of tags to hosts for your whole infrastructure.
+    /// Returns a mapping of tags to hosts. For each tag, the response returns a list of host names that contain this tag. There is a restriction of 10k total host names from the org that can be attached to tags and returned.
     pub async fn list_host_tags(
         &self,
         params: ListHostTagsOptionalParams,
@@ -613,7 +607,7 @@ impl TagsAPI {
         }
     }
 
-    /// Return a mapping of tags to hosts for your whole infrastructure.
+    /// Returns a mapping of tags to hosts. For each tag, the response returns a list of host names that contain this tag. There is a restriction of 10k total host names from the org that can be attached to tags and returned.
     pub async fn list_host_tags_with_http_info(
         &self,
         params: ListHostTagsOptionalParams,

src/datadogV1/model/model_host_tags.rs

@@ -6,15 +6,15 @@ use serde::{Deserialize, Deserializer, Serialize};
 use serde_with::skip_serializing_none;
 use std::fmt::{self, Formatter};
 
-/// Set of tags to associate with your host.
+/// Host name and an array of its tags
 #[non_exhaustive]
 #[skip_serializing_none]
 #[derive(Clone, Debug, PartialEq, Serialize)]
 pub struct HostTags {
     /// Your host name.
     #[serde(rename = "host")]
     pub host: Option<String>,
-    /// A list of tags to apply to the host.
+    /// A list of tags associated with a host.
     #[serde(rename = "tags")]
     pub tags: Option<Vec<String>>,
     #[serde(flatten)]

src/datadogV1/model/model_tag_to_hosts.rs

@@ -6,12 +6,12 @@ use serde::{Deserialize, Deserializer, Serialize};
 use serde_with::skip_serializing_none;
 use std::fmt::{self, Formatter};
 
-/// In this object, the key is the tag, the value is a list of host names that are reporting that tag.
+/// In this object, the key is the tag, and the value is a list of host names that are reporting that tag.
 #[non_exhaustive]
 #[skip_serializing_none]
 #[derive(Clone, Debug, PartialEq, Serialize)]
 pub struct TagToHosts {
-    /// A list of tags to apply to the host.
+    /// A mapping of tags to host names
     #[serde(rename = "tags")]
     pub tags: Option<std::collections::BTreeMap<String, Vec<String>>>,
     #[serde(flatten)]