@@ -575,6 +575,14 @@ components:
575575 required: true
576576 schema:
577577 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
578586 MetricID:
579587 description: The name of the log-based metric.
580588 in: path
@@ -19412,6 +19420,90 @@ components:
1941219420 - index
1941319421 - caseIndex
1941419422 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
1941519507 Layer:
1941619508 description: Encapsulates a layer resource, holding attributes like rotation
1941719509 details, plus relationships to the members covering that layer.
@@ -19898,6 +19990,14 @@ components:
1989819990 meta:
1989919991 $ref: '#/components/schemas/HistoricalJobListMeta'
1990019992 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
1990120001 ListPipelinesResponse:
1990220002 description: Represents the response payload containing a list of pipelines
1990320003 and associated metadata.
@@ -39762,6 +39862,19 @@ components:
3976239862 description: Upsert entity response included item.
3976339863 oneOf:
3976439864 - $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
3976539878 Urgency:
3976639879 description: Specifies the level of urgency for a routing rule (low, high, or
3976739880 dynamic).
@@ -44407,6 +44520,125 @@ paths:
4440744520 x-menu-order: 3
4440844521 x-undo:
4440944522 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
4441044642 /api/v2/catalog/relation:
4441144643 get:
4441244644 description: Get a list of entity relations from Software Catalog.
@@ -46042,9 +46274,10 @@ paths:
4604246274 - Usage Metering
4604346275 x-menu-order: 5
4604446276 x-permission:
46045- operator: OR
46277+ operator: AND
4604646278 permissions:
4604746279 - usage_read
46280+ - billing_read
4604846281 x-undo:
4604946282 type: safe
4605046283 /api/v2/csm/onboarding/agents:
@@ -64202,9 +64435,10 @@ paths:
6420264435 - Usage Metering
6420364436 x-menu-order: 45
6420464437 x-permission:
64205- operator: OR
64438+ operator: AND
6420664439 permissions:
6420764440 - usage_read
64441+ - billing_read
6420864442 x-undo:
6420964443 type: safe
6421064444 /api/v2/usage/estimated_cost:
@@ -64309,9 +64543,10 @@ paths:
6430964543 - Usage Metering
6431064544 x-menu-order: 6
6431164545 x-permission:
64312- operator: OR
64546+ operator: AND
6431364547 permissions:
6431464548 - usage_read
64549+ - billing_read
6431564550 x-undo:
6431664551 type: safe
6431764552 /api/v2/usage/historical_cost:
@@ -64393,9 +64628,10 @@ paths:
6439364628 - Usage Metering
6439464629 x-menu-order: 5
6439564630 x-permission:
64396- operator: OR
64631+ operator: AND
6439764632 permissions:
6439864633 - usage_read
64634+ - billing_read
6439964635 x-undo:
6440064636 type: safe
6440164637 /api/v2/usage/hourly_usage:
@@ -64739,9 +64975,10 @@ paths:
6473964975 - Usage Metering
6474064976 x-menu-order: 7
6474164977 x-permission:
64742- operator: OR
64978+ operator: AND
6474364979 permissions:
6474464980 - usage_read
64981+ - billing_read
6474564982 x-undo:
6474664983 type: safe
6474764984 /api/v2/user_invitations:
0 commit comments