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
+47-35Lines changed: 47 additions & 35 deletions
Original file line number
Diff line number
Diff line change
@@ -4154,7 +4154,7 @@ components:
4154
4154
example: false
4155
4155
type: boolean
4156
4156
type: object
4157
-
HostTags:
4157
+
HostTagsInput:
4158
4158
description: Set of tags to associate with your host.
4159
4159
properties:
4160
4160
host:
@@ -4169,6 +4169,21 @@ components:
4169
4169
type: string
4170
4170
type: array
4171
4171
type: object
4172
+
HostTagsOutput:
4173
+
description: Set of tags to associate with your host.
4174
+
properties:
4175
+
host:
4176
+
description: Your host name.
4177
+
example: test.host
4178
+
type: string
4179
+
tags:
4180
+
description: A list of tags attached to a given host.
4181
+
items:
4182
+
description: A given tag in a list.
4183
+
example: environment:production
4184
+
type: string
4185
+
type: array
4186
+
type: object
4172
4187
HostTotals:
4173
4188
description: Total number of host currently monitored by Datadog.
4174
4189
properties:
@@ -18664,18 +18679,18 @@ components:
18664
18679
- match
18665
18680
type: object
18666
18681
TagToHosts:
18667
-
description: In this object, the key is the tag, the value is a list of host
18668
-
names that are reporting that tag.
18682
+
description: In this object, the key is the tag, and the value is a list of
18683
+
host names that are reporting that tag.
18669
18684
properties:
18670
18685
tags:
18671
18686
additionalProperties:
18672
-
description: A list of additional properties for tags.
18687
+
description: A list of host names which contain this tag
18673
18688
items:
18674
18689
description: A given tag in a list.
18675
18690
example: test.metric.host
18676
18691
type: string
18677
18692
type: array
18678
-
description: A list of tags to apply to the host.
18693
+
description: A mapping of tags
18679
18694
type: object
18680
18695
type: object
18681
18696
TargetFormatType:
@@ -35627,11 +35642,13 @@ paths:
35627
35642
- synthetics_global_variable_write
35628
35643
/api/v1/tags/hosts:
35629
35644
get:
35630
-
description: Return a mapping of tags to hosts for your whole infrastructure.
35645
+
description: Returns a mapping of tags to hosts. For each tag, the response
35646
+
returns a list of host names that contain this tag. There is a restriction
35647
+
of 10k host names from the org that can be attached to tags and returned.
35631
35648
operationId: ListHostTags
35632
35649
parameters:
35633
-
- description: When specified, filters host list to those tags with the specified
35634
-
source.
35650
+
- description: Source to filter. [Complete list of source attribute values](https://docs.datadoghq.com/integrations/faq/list-of-api-source-attribute-value).
35651
+
Use "user" source for custom-defined tags.
35635
35652
in: query
35636
35653
name: source
35637
35654
required: false
@@ -35662,7 +35679,7 @@ paths:
35662
35679
- apiKeyAuth: []
35663
35680
appKeyAuth: []
35664
35681
- AuthZ: []
35665
-
summary: Get Tags
35682
+
summary: Get All Host Tags
35666
35683
tags:
35667
35684
- Tags
35668
35685
x-permission:
@@ -35675,16 +35692,14 @@ paths:
35675
35692
for a single host.'
35676
35693
operationId: DeleteHostTags
35677
35694
parameters:
35678
-
- description: This endpoint allows you to remove all user-assigned tags for
35679
-
a single host.
35695
+
- description: Specified host name to delete tags
35680
35696
in: path
35681
35697
name: host_name
35682
35698
required: true
35683
35699
schema:
35684
35700
type: string
35685
-
- description: 'The source of the tags (for example chef, puppet).
35686
-
35687
-
[Complete list of source attribute values](https://docs.datadoghq.com/integrations/faq/list-of-api-source-attribute-value).'
35701
+
- description: Source to filter. [Complete list of source attribute values](https://docs.datadoghq.com/integrations/faq/list-of-api-source-attribute-value).
35702
+
Use "user" source for custom-defined tags.
35688
35703
in: query
35689
35704
name: source
35690
35705
required: false
@@ -35714,14 +35729,14 @@ paths:
35714
35729
description: Return the list of tags that apply to a given host.
35715
35730
operationId: GetHostTags
35716
35731
parameters:
35717
-
- description: When specified, filters list of tags to those tags with the specified
35718
-
source.
35732
+
- description: Specified host name to view tags
35719
35733
in: path
35720
35734
name: host_name
35721
35735
required: true
35722
35736
schema:
35723
35737
type: string
35724
-
- description: Source to filter.
35738
+
- 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,
35756
35771
35757
-
optionally specifying where these tags come from.'
35772
+
optionally specifying what source these tags come from.'
35758
35773
operationId: CreateHostTags
35759
35774
parameters:
35760
-
- description: This endpoint allows you to add new tags to a host, optionally
35761
-
specifying where the tags came from.
35775
+
- description: Specified host name to add new tags
35762
35776
in: path
35763
35777
name: host_name
35764
35778
required: true
35765
35779
schema:
35766
35780
type: string
35767
-
- description: 'The source of the tags.
35768
-
35769
-
[Complete list of source attribute values](https://docs.datadoghq.com/integrations/faq/list-of-api-source-attribute-value).'
35781
+
- description: Source to filter. [Complete list of source attribute values](https://docs.datadoghq.com/integrations/faq/list-of-api-source-attribute-value).
35782
+
Use "user" source for custom-defined tags.
35770
35783
example: chef
35771
35784
in: query
35772
35785
name: source
@@ -35777,15 +35790,15 @@ paths:
35777
35790
content:
35778
35791
application/json:
35779
35792
schema:
35780
-
$ref: '#/components/schemas/HostTags'
35793
+
$ref: '#/components/schemas/HostTagsInput'
35781
35794
description: Update host tags request body.
35782
35795
required: true
35783
35796
responses:
35784
35797
'201':
35785
35798
content:
35786
35799
application/json:
35787
35800
schema:
35788
-
$ref: '#/components/schemas/HostTags'
35801
+
$ref: '#/components/schemas/HostTagsOutput'
35789
35802
description: Created
35790
35803
'403':
35791
35804
content:
@@ -35811,16 +35824,14 @@ paths:
35811
35824
an integration source with those supplied in the request.'
35812
35825
operationId: UpdateHostTags
35813
35826
parameters:
35814
-
- description: This endpoint allows you to update/replace all in an integration
35815
-
source with those supplied in the request.
35827
+
- description: Specified host name to change tags
35816
35828
in: path
35817
35829
name: host_name
35818
35830
required: true
35819
35831
schema:
35820
35832
type: string
35821
-
- description: 'The source of the tags (for example chef, puppet).
35822
-
35823
-
[Complete list of source attribute values](https://docs.datadoghq.com/integrations/faq/list-of-api-source-attribute-value)'
35833
+
- description: Source to filter. [Complete list of source attribute values](https://docs.datadoghq.com/integrations/faq/list-of-api-source-attribute-value).
35834
+
Use "user" source for custom-defined tags.
35824
35835
in: query
35825
35836
name: source
35826
35837
required: false
@@ -35830,15 +35841,15 @@ paths:
35830
35841
content:
35831
35842
application/json:
35832
35843
schema:
35833
-
$ref: '#/components/schemas/HostTags'
35844
+
$ref: '#/components/schemas/HostTagsInput'
35834
35845
description: Add tags to host
35835
35846
required: true
35836
35847
responses:
35837
35848
'201':
35838
35849
content:
35839
35850
application/json:
35840
35851
schema:
35841
-
$ref: '#/components/schemas/HostTags'
35852
+
$ref: '#/components/schemas/HostTagsOutput'
35842
35853
description: OK
35843
35854
'403':
35844
35855
content:
@@ -38833,7 +38844,8 @@ tags:
38833
38844
38834
38845
by a source. For example, some valid sources include nagios, hudson, jenkins,
38835
38846
38836
-
users, feed, chef, puppet, git, bitbucket, fabric, capistrano, etc.
38847
+
users, feed, chef, puppet, git, bitbucket, fabric, capistrano, etc. [Complete
38848
+
list of source attribute values](https://docs.datadoghq.com/integrations/faq/list-of-api-source-attribute-value)
38837
38849
38838
38850
38839
38851
Read more about tags on [Getting Started with Tags](https://docs.datadoghq.com/getting_started/tagging/).'
0 commit comments