You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: .generator/schemas/v1/openapi.yaml
+33-35Lines changed: 33 additions & 35 deletions
Original file line number
Diff line number
Diff line change
@@ -4219,14 +4219,14 @@ components:
4219
4219
type: boolean
4220
4220
type: object
4221
4221
HostTags:
4222
-
description: Host name and an array of its tags
4222
+
description: Set of tags to associate with your host.
4223
4223
properties:
4224
4224
host:
4225
4225
description: Your host name.
4226
4226
example: test.host
4227
4227
type: string
4228
4228
tags:
4229
-
description: A list of tags associated with a host.
4229
+
description: A list of tags to apply to the host.
4230
4230
items:
4231
4231
description: A given tag in a list.
4232
4232
example: environment:production
@@ -18972,18 +18972,18 @@ components:
18972
18972
- match
18973
18973
type: object
18974
18974
TagToHosts:
18975
-
description: In this object, the key is the tag, and the value is a list of
18976
-
host names that are reporting that tag.
18975
+
description: In this object, the key is the tag, the value is a list of host
18976
+
names that are reporting that tag.
18977
18977
properties:
18978
18978
tags:
18979
18979
additionalProperties:
18980
-
description: A list of host names which contain this tag
18980
+
description: A list of additional properties for tags.
18981
18981
items:
18982
18982
description: A given tag in a list.
18983
18983
example: test.metric.host
18984
18984
type: string
18985
18985
type: array
18986
-
description: A mapping of tags to host names
18986
+
description: A list of tags to apply to the host.
18987
18987
type: object
18988
18988
type: object
18989
18989
TargetFormatType:
@@ -36008,13 +36008,11 @@ paths:
36008
36008
- synthetics_global_variable_write
36009
36009
/api/v1/tags/hosts:
36010
36010
get:
36011
-
description: Returns a mapping of tags to hosts. For each tag, the response
36012
-
returns a list of host names that contain this tag. There is a restriction
36013
-
of 10k total host names from the org that can be attached to tags and returned.
36011
+
description: Return a mapping of tags to hosts for your whole infrastructure.
36014
36012
operationId: ListHostTags
36015
36013
parameters:
36016
-
- description: Source to filter. [Complete list of source attribute values](https://docs.datadoghq.com/integrations/faq/list-of-api-source-attribute-value).
36017
-
Use "user" source for custom-defined tags.
36014
+
- description: When specified, filters host list to those tags with the specified
36015
+
source.
36018
36016
in: query
36019
36017
name: source
36020
36018
required: false
@@ -36045,29 +36043,29 @@ paths:
36045
36043
- apiKeyAuth: []
36046
36044
appKeyAuth: []
36047
36045
- AuthZ: []
36048
-
summary: Get All Host Tags
36046
+
summary: Get Tags
36049
36047
tags:
36050
36048
- Tags
36051
36049
x-permission:
36052
36050
operator: OPEN
36053
36051
permissions: []
36054
36052
/api/v1/tags/hosts/{host_name}:
36055
36053
delete:
36056
-
description: 'This endpoint allows you to remove all tags
36054
+
description: 'This endpoint allows you to remove all user-assigned tags
36057
36055
36058
-
for a single host. If no source is specified, only deletes from the source
36059
-
"User".'
36056
+
for a single host.'
36060
36057
operationId: DeleteHostTags
36061
36058
parameters:
36062
-
- description: Specified host name to delete tags
36059
+
- description: This endpoint allows you to remove all user-assigned tags for
36060
+
a single host.
36063
36061
in: path
36064
36062
name: host_name
36065
36063
required: true
36066
36064
schema:
36067
36065
type: string
36068
-
- description: Source of the tags to be deleted. [Complete list of source attribute
- description: 'The source of the tags (for example chef, puppet).
36067
+
36068
+
[Complete list of source attribute values](https://docs.datadoghq.com/integrations/faq/list-of-api-source-attribute-value).'
36071
36069
in: query
36072
36070
name: source
36073
36071
required: false
@@ -36097,14 +36095,14 @@ paths:
36097
36095
description: Return the list of tags that apply to a given host.
36098
36096
operationId: GetHostTags
36099
36097
parameters:
36100
-
- description: Name of the host to retrieve tags for
36098
+
- description: When specified, filters list of tags to those tags with the specified
36099
+
source.
36101
36100
in: path
36102
36101
name: host_name
36103
36102
required: true
36104
36103
schema:
36105
36104
type: string
36106
-
- description: Source to filter. [Complete list of source attribute values](https://docs.datadoghq.com/integrations/faq/list-of-api-source-attribute-value).
description: 'This endpoint allows you to add new tags to a host,
36139
36137
36140
-
optionally specifying what source these tags come from. If tags already exist,
36141
-
appends new tags to the tag list. If no source is specified, defaults to "user".'
36138
+
optionally specifying where these tags come from.'
36142
36139
operationId: CreateHostTags
36143
36140
parameters:
36144
-
- description: Specified host name to add new tags
36141
+
- description: This endpoint allows you to add new tags to a host, optionally
36142
+
specifying where the tags came from.
36145
36143
in: path
36146
36144
name: host_name
36147
36145
required: true
36148
36146
schema:
36149
36147
type: string
36150
-
- description: Source to add tags. [Complete list of source attribute values](https://docs.datadoghq.com/integrations/faq/list-of-api-source-attribute-value).
36151
-
Use "user" source for custom-defined tags. If no source is specified, defaults
36152
-
to "user".
36148
+
- description: 'The source of the tags.
36149
+
36150
+
[Complete list of source attribute values](https://docs.datadoghq.com/integrations/faq/list-of-api-source-attribute-value).'
36153
36151
example: chef
36154
36152
in: query
36155
36153
name: source
@@ -36194,15 +36192,16 @@ paths:
36194
36192
an integration source with those supplied in the request.'
36195
36193
operationId: UpdateHostTags
36196
36194
parameters:
36197
-
- description: Specified host name to change tags
36195
+
- description: This endpoint allows you to update/replace all in an integration
36196
+
source with those supplied in the request.
36198
36197
in: path
36199
36198
name: host_name
36200
36199
required: true
36201
36200
schema:
36202
36201
type: string
36203
-
- description: Source to update tags. [Complete list of source attribute values](https://docs.datadoghq.com/integrations/faq/list-of-api-source-attribute-value).
36204
-
Use "user" source for custom-defined tags. If no source specified, defaults
36205
-
to "user".
36202
+
- description: 'The source of the tags (for example chef, puppet).
36203
+
36204
+
[Complete list of source attribute values](https://docs.datadoghq.com/integrations/faq/list-of-api-source-attribute-value)'
36206
36205
in: query
36207
36206
name: source
36208
36207
required: false
@@ -39218,8 +39217,7 @@ tags:
39218
39217
39219
39218
by a source. For example, some valid sources include nagios, hudson, jenkins,
39220
39219
39221
-
users, feed, chef, puppet, git, bitbucket, fabric, capistrano, etc. Find a complete
39222
-
list of source type names under [API Source Attributes](https://docs.datadoghq.com/integrations/faq/list-of-api-source-attribute-value).
39220
+
users, feed, chef, puppet, git, bitbucket, fabric, capistrano, etc.
39223
39221
39224
39222
39225
39223
Read more about tags on [Getting Started with Tags](https://docs.datadoghq.com/getting_started/tagging/).'
0 commit comments