@@ -575,6 +575,14 @@ components:
575
575
required: true
576
576
schema:
577
577
type: string
578
+ KindID:
579
+ description: Entity kind.
580
+ in: path
581
+ name: kind_id
582
+ required: true
583
+ schema:
584
+ example: my-job
585
+ type: string
578
586
MetricID:
579
587
description: The name of the log-based metric.
580
588
in: path
@@ -19412,6 +19420,90 @@ components:
19412
19420
- index
19413
19421
- caseIndex
19414
19422
type: object
19423
+ KindAttributes:
19424
+ description: Kind attributes.
19425
+ properties:
19426
+ description:
19427
+ description: Short description of the kind.
19428
+ type: string
19429
+ displayName:
19430
+ description: User friendly name of the kind.
19431
+ type: string
19432
+ name:
19433
+ description: The kind name.
19434
+ example: my-job
19435
+ minLength: 1
19436
+ type: string
19437
+ type: object
19438
+ KindData:
19439
+ description: Schema that defines the structure of a Kind object in the Software
19440
+ Catalog.
19441
+ properties:
19442
+ attributes:
19443
+ $ref: '#/components/schemas/KindAttributes'
19444
+ id:
19445
+ description: A read-only globally unique identifier for the entity generated
19446
+ by Datadog. User supplied values are ignored.
19447
+ example: 4b163705-23c0-4573-b2fb-f6cea2163fcb
19448
+ minLength: 1
19449
+ type: string
19450
+ meta:
19451
+ $ref: '#/components/schemas/KindMetadata'
19452
+ type:
19453
+ description: Kind.
19454
+ type: string
19455
+ type: object
19456
+ KindMetadata:
19457
+ description: Kind metadata.
19458
+ properties:
19459
+ createdAt:
19460
+ description: The creation time.
19461
+ type: string
19462
+ modifiedAt:
19463
+ description: The modification time.
19464
+ type: string
19465
+ type: object
19466
+ KindObj:
19467
+ description: Schema for kind.
19468
+ properties:
19469
+ description:
19470
+ description: Short description of the kind.
19471
+ type: string
19472
+ displayName:
19473
+ description: The display name of the kind. Automatically generated if not
19474
+ provided.
19475
+ type: string
19476
+ kind:
19477
+ description: The name of the kind to create or update. This must be in kebab-case
19478
+ format.
19479
+ example: my-job
19480
+ type: string
19481
+ required:
19482
+ - kind
19483
+ type: object
19484
+ KindRaw:
19485
+ description: Kind definition in raw JSON or YAML representation.
19486
+ example: 'kind: service
19487
+
19488
+ displayName: Service
19489
+
19490
+ description: A service entity in the catalog.
19491
+
19492
+ '
19493
+ type: string
19494
+ KindResponseData:
19495
+ description: List of kind responses.
19496
+ items:
19497
+ $ref: '#/components/schemas/KindData'
19498
+ type: array
19499
+ KindResponseMeta:
19500
+ description: Kind response metadata.
19501
+ properties:
19502
+ count:
19503
+ description: Total kinds count.
19504
+ format: int64
19505
+ type: integer
19506
+ type: object
19415
19507
Layer:
19416
19508
description: Encapsulates a layer resource, holding attributes like rotation
19417
19509
details, plus relationships to the members covering that layer.
@@ -19898,6 +19990,14 @@ components:
19898
19990
meta:
19899
19991
$ref: '#/components/schemas/HistoricalJobListMeta'
19900
19992
type: object
19993
+ ListKindCatalogResponse:
19994
+ description: List kind response.
19995
+ properties:
19996
+ data:
19997
+ $ref: '#/components/schemas/KindResponseData'
19998
+ meta:
19999
+ $ref: '#/components/schemas/KindResponseMeta'
20000
+ type: object
19901
20001
ListPipelinesResponse:
19902
20002
description: Represents the response payload containing a list of pipelines
19903
20003
and associated metadata.
@@ -39762,6 +39862,19 @@ components:
39762
39862
description: Upsert entity response included item.
39763
39863
oneOf:
39764
39864
- $ref: '#/components/schemas/EntityResponseIncludedSchema'
39865
+ UpsertCatalogKindRequest:
39866
+ description: Create or update kind request.
39867
+ oneOf:
39868
+ - $ref: '#/components/schemas/KindObj'
39869
+ - $ref: '#/components/schemas/KindRaw'
39870
+ UpsertCatalogKindResponse:
39871
+ description: Upsert kind response.
39872
+ properties:
39873
+ data:
39874
+ $ref: '#/components/schemas/KindResponseData'
39875
+ meta:
39876
+ $ref: '#/components/schemas/KindResponseMeta'
39877
+ type: object
39765
39878
Urgency:
39766
39879
description: Specifies the level of urgency for a routing rule (low, high, or
39767
39880
dynamic).
@@ -44407,6 +44520,125 @@ paths:
44407
44520
x-menu-order: 3
44408
44521
x-undo:
44409
44522
type: idempotent
44523
+ /api/v2/catalog/kind:
44524
+ get:
44525
+ description: Get a list of entity kinds from Software Catalog.
44526
+ operationId: ListCatalogKind
44527
+ parameters:
44528
+ - $ref: '#/components/parameters/PageOffset'
44529
+ - description: Maximum number of kinds in the response.
44530
+ example: 100
44531
+ in: query
44532
+ name: page[limit]
44533
+ required: false
44534
+ schema:
44535
+ default: 100
44536
+ format: int64
44537
+ type: integer
44538
+ - $ref: '#/components/parameters/FilterByID'
44539
+ - $ref: '#/components/parameters/FilterByName'
44540
+ responses:
44541
+ '200':
44542
+ content:
44543
+ application/json:
44544
+ schema:
44545
+ $ref: '#/components/schemas/ListKindCatalogResponse'
44546
+ description: OK
44547
+ '400':
44548
+ $ref: '#/components/responses/BadRequestResponse'
44549
+ '403':
44550
+ $ref: '#/components/responses/ForbiddenResponse'
44551
+ '429':
44552
+ $ref: '#/components/responses/TooManyRequestsResponse'
44553
+ security:
44554
+ - apiKeyAuth: []
44555
+ appKeyAuth: []
44556
+ - AuthZ:
44557
+ - apm_service_catalog_read
44558
+ summary: Get a list of entity kinds
44559
+ tags:
44560
+ - Software Catalog
44561
+ x-menu-order: 4
44562
+ x-pagination:
44563
+ limitParam: page[limit]
44564
+ pageOffsetParam: page[offset]
44565
+ resultsPath: data
44566
+ x-undo:
44567
+ type: safe
44568
+ post:
44569
+ description: Create or update kinds in Software Catalog.
44570
+ operationId: UpsertCatalogKind
44571
+ requestBody:
44572
+ content:
44573
+ application/json:
44574
+ schema:
44575
+ $ref: '#/components/schemas/UpsertCatalogKindRequest'
44576
+ description: Kind YAML or JSON.
44577
+ required: true
44578
+ responses:
44579
+ '202':
44580
+ content:
44581
+ application/json:
44582
+ schema:
44583
+ $ref: '#/components/schemas/UpsertCatalogKindResponse'
44584
+ description: ACCEPTED
44585
+ '400':
44586
+ $ref: '#/components/responses/BadRequestResponse'
44587
+ '403':
44588
+ $ref: '#/components/responses/ForbiddenResponse'
44589
+ '429':
44590
+ $ref: '#/components/responses/TooManyRequestsResponse'
44591
+ security:
44592
+ - apiKeyAuth: []
44593
+ appKeyAuth: []
44594
+ - AuthZ:
44595
+ - apm_service_catalog_write
44596
+ summary: Create or update kinds
44597
+ tags:
44598
+ - Software Catalog
44599
+ x-codegen-request-body-name: body
44600
+ x-given:
44601
+ kind:
44602
+ parameters:
44603
+ - name: body
44604
+ value: "{\n \"kind\": \"my-job\",\n \"displayName\": \"My Job\",\n \"description\":
44605
+ \"A job entity in the catalog.\"\n}"
44606
+ step: there is a valid kind
44607
+ x-menu-order: 5
44608
+ x-undo:
44609
+ operationId: DeleteCatalogKind
44610
+ parameters:
44611
+ - name: kind_id
44612
+ source: data[0].id
44613
+ type: unsafe
44614
+ /api/v2/catalog/kind/{kind_id}:
44615
+ delete:
44616
+ description: Delete a single kind in Software Catalog.
44617
+ operationId: DeleteCatalogKind
44618
+ parameters:
44619
+ - $ref: '#/components/parameters/KindID'
44620
+ responses:
44621
+ '204':
44622
+ description: OK
44623
+ '400':
44624
+ $ref: '#/components/responses/BadRequestResponse'
44625
+ '403':
44626
+ $ref: '#/components/responses/ForbiddenResponse'
44627
+ '404':
44628
+ $ref: '#/components/responses/NotFoundResponse'
44629
+ '429':
44630
+ $ref: '#/components/responses/TooManyRequestsResponse'
44631
+ security:
44632
+ - apiKeyAuth: []
44633
+ appKeyAuth: []
44634
+ - AuthZ:
44635
+ - apm_service_catalog_write
44636
+ summary: Delete a single kind
44637
+ tags:
44638
+ - Software Catalog
44639
+ x-menu-order: 6
44640
+ x-undo:
44641
+ type: idempotent
44410
44642
/api/v2/catalog/relation:
44411
44643
get:
44412
44644
description: Get a list of entity relations from Software Catalog.
@@ -46042,9 +46274,10 @@ paths:
46042
46274
- Usage Metering
46043
46275
x-menu-order: 5
46044
46276
x-permission:
46045
- operator: OR
46277
+ operator: AND
46046
46278
permissions:
46047
46279
- usage_read
46280
+ - billing_read
46048
46281
x-undo:
46049
46282
type: safe
46050
46283
/api/v2/csm/onboarding/agents:
@@ -64202,9 +64435,10 @@ paths:
64202
64435
- Usage Metering
64203
64436
x-menu-order: 45
64204
64437
x-permission:
64205
- operator: OR
64438
+ operator: AND
64206
64439
permissions:
64207
64440
- usage_read
64441
+ - billing_read
64208
64442
x-undo:
64209
64443
type: safe
64210
64444
/api/v2/usage/estimated_cost:
@@ -64309,9 +64543,10 @@ paths:
64309
64543
- Usage Metering
64310
64544
x-menu-order: 6
64311
64545
x-permission:
64312
- operator: OR
64546
+ operator: AND
64313
64547
permissions:
64314
64548
- usage_read
64549
+ - billing_read
64315
64550
x-undo:
64316
64551
type: safe
64317
64552
/api/v2/usage/historical_cost:
@@ -64393,9 +64628,10 @@ paths:
64393
64628
- Usage Metering
64394
64629
x-menu-order: 5
64395
64630
x-permission:
64396
- operator: OR
64631
+ operator: AND
64397
64632
permissions:
64398
64633
- usage_read
64634
+ - billing_read
64399
64635
x-undo:
64400
64636
type: safe
64401
64637
/api/v2/usage/hourly_usage:
@@ -64739,9 +64975,10 @@ paths:
64739
64975
- Usage Metering
64740
64976
x-menu-order: 7
64741
64977
x-permission:
64742
- operator: OR
64978
+ operator: AND
64743
64979
permissions:
64744
64980
- usage_read
64981
+ - billing_read
64745
64982
x-undo:
64746
64983
type: safe
64747
64984
/api/v2/user_invitations:
0 commit comments