Skip to content

Commit 1bfb88b

Browse files
author
ci.datadog-api-spec
committed
Regenerate client from commit a7a55a6b of spec repo
1 parent 79cb5c0 commit 1bfb88b

20 files changed

+1524
-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-05-27 17:12:13.372089",
8-
"spec_repo_commit": "ed439f7c"
7+
"regenerated": "2025-05-29 21:34:40.882708",
8+
"spec_repo_commit": "a7a55a6b"
99
},
1010
"v2": {
1111
"apigentools_version": "1.6.6",
12-
"regenerated": "2025-05-27 17:12:13.387673",
13-
"spec_repo_commit": "ed439f7c"
12+
"regenerated": "2025-05-29 21:34:40.904046",
13+
"spec_repo_commit": "a7a55a6b"
1414
}
1515
}
1616
}

.generator/schemas/v2/openapi.yaml

Lines changed: 209 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
@@ -19121,6 +19129,87 @@ components:
1912119129
- index
1912219130
- caseIndex
1912319131
type: object
19132+
KindAttributes:
19133+
description: Kind attributes.
19134+
properties:
19135+
description:
19136+
description: The kind description.
19137+
type: string
19138+
displayName:
19139+
description: The kind display name.
19140+
type: string
19141+
name:
19142+
description: The kind name.
19143+
example: my-job
19144+
minLength: 1
19145+
type: string
19146+
type: object
19147+
KindData:
19148+
description: The definition of Kind object.
19149+
properties:
19150+
attributes:
19151+
$ref: '#/components/schemas/KindAttributes'
19152+
id:
19153+
description: Kind ID.
19154+
example: 4b163705-23c0-4573-b2fb-f6cea2163fcb
19155+
minLength: 1
19156+
type: string
19157+
meta:
19158+
$ref: '#/components/schemas/KindMetadata'
19159+
type:
19160+
description: Kind.
19161+
type: string
19162+
type: object
19163+
KindMetadata:
19164+
description: Kind metadata.
19165+
properties:
19166+
createdAt:
19167+
description: The creation time.
19168+
type: string
19169+
modifiedAt:
19170+
description: The modification time.
19171+
type: string
19172+
type: object
19173+
KindObj:
19174+
description: Schema for kind.
19175+
properties:
19176+
description:
19177+
description: The description of the kind.
19178+
type: string
19179+
displayName:
19180+
description: The display name of the kind. Automatically generated if not
19181+
provided.
19182+
type: string
19183+
kind:
19184+
description: The name of the kind to create or update.
19185+
example: my-job
19186+
type: string
19187+
required:
19188+
- kind
19189+
type: object
19190+
KindRaw:
19191+
description: Kind definition in raw JSON or YAML representation.
19192+
example: 'kind: service
19193+
19194+
displayName: Service
19195+
19196+
description: A service entity in the catalog.
19197+
19198+
'
19199+
type: string
19200+
KindResponseData:
19201+
description: List of kind responses.
19202+
items:
19203+
$ref: '#/components/schemas/KindData'
19204+
type: array
19205+
KindResponseMeta:
19206+
description: Kind response metadata.
19207+
properties:
19208+
count:
19209+
description: Total kinds count.
19210+
format: int64
19211+
type: integer
19212+
type: object
1912419213
Layer:
1912519214
description: Encapsulates a layer resource, holding attributes like rotation
1912619215
details, plus relationships to the members covering that layer.
@@ -19607,6 +19696,14 @@ components:
1960719696
meta:
1960819697
$ref: '#/components/schemas/HistoricalJobListMeta'
1960919698
type: object
19699+
ListKindCatalogResponse:
19700+
description: List kind response.
19701+
properties:
19702+
data:
19703+
$ref: '#/components/schemas/KindResponseData'
19704+
meta:
19705+
$ref: '#/components/schemas/KindResponseMeta'
19706+
type: object
1961019707
ListPipelinesResponse:
1961119708
description: Represents the response payload containing a list of pipelines
1961219709
and associated metadata.
@@ -39205,6 +39302,19 @@ components:
3920539302
description: Upsert entity response included item.
3920639303
oneOf:
3920739304
- $ref: '#/components/schemas/EntityResponseIncludedSchema'
39305+
UpsertCatalogKindRequest:
39306+
description: Create or update kind request.
39307+
oneOf:
39308+
- $ref: '#/components/schemas/KindObj'
39309+
- $ref: '#/components/schemas/KindRaw'
39310+
UpsertCatalogKindResponse:
39311+
description: Upsert kind response.
39312+
properties:
39313+
data:
39314+
$ref: '#/components/schemas/KindResponseData'
39315+
meta:
39316+
$ref: '#/components/schemas/KindResponseMeta'
39317+
type: object
3920839318
Urgency:
3920939319
description: Specifies the level of urgency for a routing rule (low, high, or
3921039320
dynamic).
@@ -43442,6 +43552,105 @@ paths:
4344243552
summary: Delete a single entity
4344343553
tags:
4344443554
- Software Catalog
43555+
/api/v2/catalog/kind:
43556+
get:
43557+
description: Get a list of entity kinds from Software Catalog.
43558+
operationId: ListCatalogKind
43559+
parameters:
43560+
- $ref: '#/components/parameters/PageOffset'
43561+
- description: Maximum number of kinds in the response.
43562+
example: 100
43563+
in: query
43564+
name: page[limit]
43565+
required: false
43566+
schema:
43567+
default: 100
43568+
format: int64
43569+
type: integer
43570+
- $ref: '#/components/parameters/FilterByID'
43571+
- $ref: '#/components/parameters/FilterByName'
43572+
responses:
43573+
'200':
43574+
content:
43575+
application/json:
43576+
schema:
43577+
$ref: '#/components/schemas/ListKindCatalogResponse'
43578+
description: OK
43579+
'400':
43580+
$ref: '#/components/responses/BadRequestResponse'
43581+
'403':
43582+
$ref: '#/components/responses/ForbiddenResponse'
43583+
'429':
43584+
$ref: '#/components/responses/TooManyRequestsResponse'
43585+
security:
43586+
- apiKeyAuth: []
43587+
appKeyAuth: []
43588+
- AuthZ:
43589+
- apm_service_catalog_read
43590+
summary: Get a list of entity kinds
43591+
tags:
43592+
- Software Catalog
43593+
x-pagination:
43594+
limitParam: page[limit]
43595+
pageOffsetParam: page[offset]
43596+
resultsPath: data
43597+
post:
43598+
description: Create or update kinds in Software Catalog.
43599+
operationId: UpsertCatalogKind
43600+
requestBody:
43601+
content:
43602+
application/json:
43603+
schema:
43604+
$ref: '#/components/schemas/UpsertCatalogKindRequest'
43605+
description: Kind YAML or JSON.
43606+
required: true
43607+
responses:
43608+
'202':
43609+
content:
43610+
application/json:
43611+
schema:
43612+
$ref: '#/components/schemas/UpsertCatalogKindResponse'
43613+
description: ACCEPTED
43614+
'400':
43615+
$ref: '#/components/responses/BadRequestResponse'
43616+
'403':
43617+
$ref: '#/components/responses/ForbiddenResponse'
43618+
'429':
43619+
$ref: '#/components/responses/TooManyRequestsResponse'
43620+
security:
43621+
- apiKeyAuth: []
43622+
appKeyAuth: []
43623+
- AuthZ:
43624+
- apm_service_catalog_write
43625+
summary: Create or update kinds
43626+
tags:
43627+
- Software Catalog
43628+
x-codegen-request-body-name: body
43629+
/api/v2/catalog/kind/{kind_id}:
43630+
delete:
43631+
description: Delete a single kind in Software Catalog.
43632+
operationId: DeleteCatalogKind
43633+
parameters:
43634+
- $ref: '#/components/parameters/KindID'
43635+
responses:
43636+
'204':
43637+
description: OK
43638+
'400':
43639+
$ref: '#/components/responses/BadRequestResponse'
43640+
'403':
43641+
$ref: '#/components/responses/ForbiddenResponse'
43642+
'404':
43643+
$ref: '#/components/responses/NotFoundResponse'
43644+
'429':
43645+
$ref: '#/components/responses/TooManyRequestsResponse'
43646+
security:
43647+
- apiKeyAuth: []
43648+
appKeyAuth: []
43649+
- AuthZ:
43650+
- apm_service_catalog_write
43651+
summary: Delete a single kind
43652+
tags:
43653+
- Software Catalog
4344543654
/api/v2/catalog/relation:
4344643655
get:
4344743656
description: Get a list of entity relations from Software Catalog.
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")
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()
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 }
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)