Skip to content

Commit 256ebc6

Browse files
author
ci.datadog-api-spec
committed
Regenerate client from commit 5275342a of spec repo
1 parent 295860c commit 256ebc6

20 files changed

+1527
-4
lines changed

‎.apigentools-info‎

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -4,13 +4,13 @@
44
"spec_versions": {
55
"v1": {
66
"apigentools_version": "1.6.6",
7-
"regenerated": "2025-06-04 12:51:42.017087",
8-
"spec_repo_commit": "35a63137"
7+
"regenerated": "2025-06-04 19:16:46.068609",
8+
"spec_repo_commit": "5275342a"
99
},
1010
"v2": {
1111
"apigentools_version": "1.6.6",
12-
"regenerated": "2025-06-04 12:51:42.033972",
13-
"spec_repo_commit": "35a63137"
12+
"regenerated": "2025-06-04 19:16:46.086480",
13+
"spec_repo_commit": "5275342a"
1414
}
1515
}
1616
}

‎.generator/schemas/v2/openapi.yaml‎

Lines changed: 212 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -563,6 +563,14 @@ components:
563563
required: true
564564
schema:
565565
type: string
566+
KindID:
567+
description: Entity kind.
568+
in: path
569+
name: kind_id
570+
required: true
571+
schema:
572+
example: my-job
573+
type: string
566574
MetricID:
567575
description: The name of the log-based metric.
568576
in: path
@@ -19277,6 +19285,90 @@ components:
1927719285
- index
1927819286
- caseIndex
1927919287
type: object
19288+
KindAttributes:
19289+
description: Kind attributes.
19290+
properties:
19291+
description:
19292+
description: Short description of the kind.
19293+
type: string
19294+
displayName:
19295+
description: User friendly name of the kind.
19296+
type: string
19297+
name:
19298+
description: The kind name.
19299+
example: my-job
19300+
minLength: 1
19301+
type: string
19302+
type: object
19303+
KindData:
19304+
description: Schema that defines the structure of a Kind object in the Software
19305+
Catalog.
19306+
properties:
19307+
attributes:
19308+
$ref: '#/components/schemas/KindAttributes'
19309+
id:
19310+
description: A read-only globally unique identifier for the entity generated
19311+
by Datadog. User supplied values are ignored.
19312+
example: 4b163705-23c0-4573-b2fb-f6cea2163fcb
19313+
minLength: 1
19314+
type: string
19315+
meta:
19316+
$ref: '#/components/schemas/KindMetadata'
19317+
type:
19318+
description: Kind.
19319+
type: string
19320+
type: object
19321+
KindMetadata:
19322+
description: Kind metadata.
19323+
properties:
19324+
createdAt:
19325+
description: The creation time.
19326+
type: string
19327+
modifiedAt:
19328+
description: The modification time.
19329+
type: string
19330+
type: object
19331+
KindObj:
19332+
description: Schema for kind.
19333+
properties:
19334+
description:
19335+
description: Short description of the kind.
19336+
type: string
19337+
displayName:
19338+
description: The display name of the kind. Automatically generated if not
19339+
provided.
19340+
type: string
19341+
kind:
19342+
description: The name of the kind to create or update. This must be in kebab-case
19343+
format.
19344+
example: my-job
19345+
type: string
19346+
required:
19347+
- kind
19348+
type: object
19349+
KindRaw:
19350+
description: Kind definition in raw JSON or YAML representation.
19351+
example: 'kind: service
19352+
19353+
displayName: Service
19354+
19355+
description: A service entity in the catalog.
19356+
19357+
'
19358+
type: string
19359+
KindResponseData:
19360+
description: List of kind responses.
19361+
items:
19362+
$ref: '#/components/schemas/KindData'
19363+
type: array
19364+
KindResponseMeta:
19365+
description: Kind response metadata.
19366+
properties:
19367+
count:
19368+
description: Total kinds count.
19369+
format: int64
19370+
type: integer
19371+
type: object
1928019372
Layer:
1928119373
description: Encapsulates a layer resource, holding attributes like rotation
1928219374
details, plus relationships to the members covering that layer.
@@ -19763,6 +19855,14 @@ components:
1976319855
meta:
1976419856
$ref: '#/components/schemas/HistoricalJobListMeta'
1976519857
type: object
19858+
ListKindCatalogResponse:
19859+
description: List kind response.
19860+
properties:
19861+
data:
19862+
$ref: '#/components/schemas/KindResponseData'
19863+
meta:
19864+
$ref: '#/components/schemas/KindResponseMeta'
19865+
type: object
1976619866
ListPipelinesResponse:
1976719867
description: Represents the response payload containing a list of pipelines
1976819868
and associated metadata.
@@ -39505,6 +39605,19 @@ components:
3950539605
description: Upsert entity response included item.
3950639606
oneOf:
3950739607
- $ref: '#/components/schemas/EntityResponseIncludedSchema'
39608+
UpsertCatalogKindRequest:
39609+
description: Create or update kind request.
39610+
oneOf:
39611+
- $ref: '#/components/schemas/KindObj'
39612+
- $ref: '#/components/schemas/KindRaw'
39613+
UpsertCatalogKindResponse:
39614+
description: Upsert kind response.
39615+
properties:
39616+
data:
39617+
$ref: '#/components/schemas/KindResponseData'
39618+
meta:
39619+
$ref: '#/components/schemas/KindResponseMeta'
39620+
type: object
3950839621
Urgency:
3950939622
description: Specifies the level of urgency for a routing rule (low, high, or
3951039623
dynamic).
@@ -43742,6 +43855,105 @@ paths:
4374243855
summary: Delete a single entity
4374343856
tags:
4374443857
- Software Catalog
43858+
/api/v2/catalog/kind:
43859+
get:
43860+
description: Get a list of entity kinds from Software Catalog.
43861+
operationId: ListCatalogKind
43862+
parameters:
43863+
- $ref: '#/components/parameters/PageOffset'
43864+
- description: Maximum number of kinds in the response.
43865+
example: 100
43866+
in: query
43867+
name: page[limit]
43868+
required: false
43869+
schema:
43870+
default: 100
43871+
format: int64
43872+
type: integer
43873+
- $ref: '#/components/parameters/FilterByID'
43874+
- $ref: '#/components/parameters/FilterByName'
43875+
responses:
43876+
'200':
43877+
content:
43878+
application/json:
43879+
schema:
43880+
$ref: '#/components/schemas/ListKindCatalogResponse'
43881+
description: OK
43882+
'400':
43883+
$ref: '#/components/responses/BadRequestResponse'
43884+
'403':
43885+
$ref: '#/components/responses/ForbiddenResponse'
43886+
'429':
43887+
$ref: '#/components/responses/TooManyRequestsResponse'
43888+
security:
43889+
- apiKeyAuth: []
43890+
appKeyAuth: []
43891+
- AuthZ:
43892+
- apm_service_catalog_read
43893+
summary: Get a list of entity kinds
43894+
tags:
43895+
- Software Catalog
43896+
x-pagination:
43897+
limitParam: page[limit]
43898+
pageOffsetParam: page[offset]
43899+
resultsPath: data
43900+
post:
43901+
description: Create or update kinds in Software Catalog.
43902+
operationId: UpsertCatalogKind
43903+
requestBody:
43904+
content:
43905+
application/json:
43906+
schema:
43907+
$ref: '#/components/schemas/UpsertCatalogKindRequest'
43908+
description: Kind YAML or JSON.
43909+
required: true
43910+
responses:
43911+
'202':
43912+
content:
43913+
application/json:
43914+
schema:
43915+
$ref: '#/components/schemas/UpsertCatalogKindResponse'
43916+
description: ACCEPTED
43917+
'400':
43918+
$ref: '#/components/responses/BadRequestResponse'
43919+
'403':
43920+
$ref: '#/components/responses/ForbiddenResponse'
43921+
'429':
43922+
$ref: '#/components/responses/TooManyRequestsResponse'
43923+
security:
43924+
- apiKeyAuth: []
43925+
appKeyAuth: []
43926+
- AuthZ:
43927+
- apm_service_catalog_write
43928+
summary: Create or update kinds
43929+
tags:
43930+
- Software Catalog
43931+
x-codegen-request-body-name: body
43932+
/api/v2/catalog/kind/{kind_id}:
43933+
delete:
43934+
description: Delete a single kind in Software Catalog.
43935+
operationId: DeleteCatalogKind
43936+
parameters:
43937+
- $ref: '#/components/parameters/KindID'
43938+
responses:
43939+
'204':
43940+
description: OK
43941+
'400':
43942+
$ref: '#/components/responses/BadRequestResponse'
43943+
'403':
43944+
$ref: '#/components/responses/ForbiddenResponse'
43945+
'404':
43946+
$ref: '#/components/responses/NotFoundResponse'
43947+
'429':
43948+
$ref: '#/components/responses/TooManyRequestsResponse'
43949+
security:
43950+
- apiKeyAuth: []
43951+
appKeyAuth: []
43952+
- AuthZ:
43953+
- apm_service_catalog_write
43954+
summary: Delete a single kind
43955+
tags:
43956+
- Software Catalog
4374543957
/api/v2/catalog/relation:
4374643958
get:
4374743959
description: Get a list of entity relations from Software Catalog.

‎examples/v2/software-catalog/DeleteCatalogKind.rb‎

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,5 @@
1+
# Delete a single kind returns "OK" response
2+
3+
require "datadog_api_client"
4+
api_instance = DatadogAPIClient::V2::SoftwareCatalogAPI.new
5+
api_instance.delete_catalog_kind("my-job")

‎examples/v2/software-catalog/ListCatalogKind.rb‎

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,5 @@
1+
# Get a list of entity kinds returns "OK" response
2+
3+
require "datadog_api_client"
4+
api_instance = DatadogAPIClient::V2::SoftwareCatalogAPI.new
5+
p api_instance.list_catalog_kind()

‎examples/v2/software-catalog/ListCatalogKind_3806205775.rb‎

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,5 @@
1+
# Get a list of entity kinds returns "OK" response with pagination
2+
3+
require "datadog_api_client"
4+
api_instance = DatadogAPIClient::V2::SoftwareCatalogAPI.new
5+
api_instance.list_catalog_kind_with_pagination() { |item| puts item }

‎examples/v2/software-catalog/UpsertCatalogKind.rb‎

Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,9 @@
1+
# Create or update kinds returns "ACCEPTED" response
2+
3+
require "datadog_api_client"
4+
api_instance = DatadogAPIClient::V2::SoftwareCatalogAPI.new
5+
6+
body = DatadogAPIClient::V2::KindObj.new({
7+
kind: "my-job",
8+
})
9+
p api_instance.upsert_catalog_kind(body)

‎features/scenarios_model_mapping.rb‎

Lines changed: 12 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1106,6 +1106,18 @@
11061106
"v2.DeleteCatalogEntity" => {
11071107
"entity_id" => "String",
11081108
},
1109+
"v2.ListCatalogKind" => {
1110+
"page_offset" => "Integer",
1111+
"page_limit" => "Integer",
1112+
"filter_id" => "String",
1113+
"filter_name" => "String",
1114+
},
1115+
"v2.UpsertCatalogKind" => {
1116+
"body" => "UpsertCatalogKindRequest",
1117+
},
1118+
"v2.DeleteCatalogKind" => {
1119+
"kind_id" => "String",
1120+
},
11091121
"v2.ListCatalogRelation" => {
11101122
"page_offset" => "Integer",
11111123
"page_limit" => "Integer",

‎features/v2/given.json‎

Lines changed: 12 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -108,6 +108,18 @@
108108
"tag": "Software Catalog",
109109
"operationId": "UpsertCatalogEntity"
110110
},
111+
{
112+
"parameters": [
113+
{
114+
"name": "body",
115+
"value": "{\n \"kind\": \"my-job\",\n \"displayName\": \"My Job\",\n \"description\": \"A job entity in the catalog.\"\n}"
116+
}
117+
],
118+
"step": "there is a valid kind",
119+
"key": "kind",
120+
"tag": "Software Catalog",
121+
"operationId": "UpsertCatalogKind"
122+
},
111123
{
112124
"parameters": [
113125
{

0 commit comments

Comments
 (0)