@@ -335,6 +335,7 @@ components:
335
335
type: string
336
336
FilterByRef:
337
337
description: Filter entities by reference
338
+ example: service:shopping-cart
338
339
explode: true
339
340
in: query
340
341
name: filter[ref]
@@ -349,6 +350,32 @@ components:
349
350
required: false
350
351
schema:
351
352
$ref: '#/components/schemas/RelationType'
353
+ FilterRelationByFromRef:
354
+ description: Filter relations by the reference of the first entity in the relation.
355
+ example: service:shopping-cart
356
+ explode: true
357
+ in: query
358
+ name: filter[from_ref]
359
+ required: false
360
+ schema:
361
+ type: string
362
+ FilterRelationByToRef:
363
+ description: Filter relations by the reference of the second entity in the relation.
364
+ example: service:shopping-cart
365
+ explode: true
366
+ in: query
367
+ name: filter[to_ref]
368
+ required: false
369
+ schema:
370
+ type: string
371
+ FilterRelationByType:
372
+ description: Filter relations by type.
373
+ explode: true
374
+ in: query
375
+ name: filter[type]
376
+ required: false
377
+ schema:
378
+ $ref: '#/components/schemas/RelationType'
352
379
GCPSTSServiceAccountID:
353
380
description: Your GCP STS enabled service account's unique ID.
354
381
in: path
@@ -659,6 +686,14 @@ components:
659
686
required: true
660
687
schema:
661
688
type: string
689
+ RelationInclude:
690
+ description: Include relationship data.
691
+ explode: true
692
+ in: query
693
+ name: include
694
+ required: false
695
+ schema:
696
+ $ref: '#/components/schemas/RelationIncludeType'
662
697
ReportID:
663
698
description: The ID of the report job.
664
699
in: path
@@ -19254,6 +19289,38 @@ components:
19254
19289
meta:
19255
19290
$ref: '#/components/schemas/PowerpacksResponseMeta'
19256
19291
type: object
19292
+ ListRelationCatalogResponse:
19293
+ description: List entity relation response.
19294
+ properties:
19295
+ data:
19296
+ $ref: '#/components/schemas/RelationResponseData'
19297
+ included:
19298
+ $ref: '#/components/schemas/ListRelationCatalogResponseIncluded'
19299
+ links:
19300
+ $ref: '#/components/schemas/ListRelationCatalogResponseLinks'
19301
+ meta:
19302
+ $ref: '#/components/schemas/RelationResponseMeta'
19303
+ type: object
19304
+ ListRelationCatalogResponseIncluded:
19305
+ description: List relation response included entities.
19306
+ items:
19307
+ $ref: '#/components/schemas/EntityData'
19308
+ type: array
19309
+ ListRelationCatalogResponseLinks:
19310
+ description: List relation response links.
19311
+ properties:
19312
+ next:
19313
+ description: Next link.
19314
+ example: /api/v2/catalog/relation?filter[from_ref]=service:service-catalog&include=entity&page[limit]=2&page[offset]=2
19315
+ type: string
19316
+ previous:
19317
+ description: Previous link.
19318
+ type: string
19319
+ self:
19320
+ description: Current link.
19321
+ example: /api/v2/catalog/relation?filter[from_ref]=service:service-catalog&include=entity&page[limit]=2&page[offset]=0
19322
+ type: string
19323
+ type: object
19257
19324
ListRulesResponse:
19258
19325
description: Scorecard rules response.
19259
19326
properties:
@@ -28556,6 +28623,114 @@ components:
28556
28623
x-enum-varnames:
28557
28624
- ANY
28558
28625
- ALL
28626
+ RelationAttributes:
28627
+ description: Relation attributes.
28628
+ properties:
28629
+ from:
28630
+ $ref: '#/components/schemas/RelationEntity'
28631
+ to:
28632
+ $ref: '#/components/schemas/RelationEntity'
28633
+ type:
28634
+ $ref: '#/components/schemas/RelationType'
28635
+ type: object
28636
+ RelationEntity:
28637
+ description: Relation entity reference.
28638
+ properties:
28639
+ kind:
28640
+ description: Entity kind.
28641
+ type: string
28642
+ name:
28643
+ description: Entity name.
28644
+ type: string
28645
+ namespace:
28646
+ description: Entity namespace.
28647
+ type: string
28648
+ type: object
28649
+ RelationIncludeType:
28650
+ description: Supported include types for relations.
28651
+ enum:
28652
+ - entity
28653
+ - schema
28654
+ type: string
28655
+ x-enum-varnames:
28656
+ - ENTITY
28657
+ - SCHEMA
28658
+ RelationMeta:
28659
+ description: Relation metadata.
28660
+ properties:
28661
+ createdAt:
28662
+ description: Relation creation time.
28663
+ format: date-time
28664
+ type: string
28665
+ definedBy:
28666
+ description: Relation defined by.
28667
+ type: string
28668
+ modifiedAt:
28669
+ description: Relation modification time.
28670
+ format: date-time
28671
+ type: string
28672
+ source:
28673
+ description: Relation source.
28674
+ type: string
28675
+ type: object
28676
+ RelationRelationships:
28677
+ description: Relation relationships.
28678
+ properties:
28679
+ fromEntity:
28680
+ $ref: '#/components/schemas/RelationToEntity'
28681
+ toEntity:
28682
+ $ref: '#/components/schemas/RelationToEntity'
28683
+ type: object
28684
+ RelationResponse:
28685
+ description: Relation response data.
28686
+ properties:
28687
+ attributes:
28688
+ $ref: '#/components/schemas/RelationAttributes'
28689
+ id:
28690
+ description: Relation ID.
28691
+ type: string
28692
+ meta:
28693
+ $ref: '#/components/schemas/RelationMeta'
28694
+ relationships:
28695
+ $ref: '#/components/schemas/RelationRelationships'
28696
+ subtype:
28697
+ description: Relation subtype.
28698
+ type: string
28699
+ type:
28700
+ $ref: '#/components/schemas/RelationResponseType'
28701
+ type: object
28702
+ RelationResponseData:
28703
+ description: Array of relation responses
28704
+ items:
28705
+ $ref: '#/components/schemas/RelationResponse'
28706
+ type: array
28707
+ RelationResponseMeta:
28708
+ description: Relation response metadata.
28709
+ properties:
28710
+ count:
28711
+ description: Total relations count.
28712
+ format: int64
28713
+ type: integer
28714
+ includeCount:
28715
+ description: Total included data count.
28716
+ format: int64
28717
+ type: integer
28718
+ type: object
28719
+ RelationResponseType:
28720
+ description: Relation type.
28721
+ enum:
28722
+ - relation
28723
+ type: string
28724
+ x-enum-varnames:
28725
+ - RELATION
28726
+ RelationToEntity:
28727
+ description: Relation to entity.
28728
+ properties:
28729
+ data:
28730
+ $ref: '#/components/schemas/RelationshipItem'
28731
+ meta:
28732
+ $ref: '#/components/schemas/EntityMeta'
28733
+ type: object
28559
28734
RelationType:
28560
28735
description: Supported relation types.
28561
28736
enum:
@@ -42634,6 +42809,48 @@ paths:
42634
42809
summary: Delete a single entity
42635
42810
tags:
42636
42811
- Software Catalog
42812
+ /api/v2/catalog/relation:
42813
+ get:
42814
+ description: Get a list of entity relations from Software Catalog.
42815
+ operationId: ListCatalogRelation
42816
+ parameters:
42817
+ - $ref: '#/components/parameters/PageOffset'
42818
+ - description: Maximum number of relations in the response.
42819
+ example: 100
42820
+ in: query
42821
+ name: page[limit]
42822
+ required: false
42823
+ schema:
42824
+ default: 100
42825
+ format: int64
42826
+ type: integer
42827
+ - $ref: '#/components/parameters/FilterRelationByType'
42828
+ - $ref: '#/components/parameters/FilterRelationByFromRef'
42829
+ - $ref: '#/components/parameters/FilterRelationByToRef'
42830
+ - $ref: '#/components/parameters/RelationInclude'
42831
+ responses:
42832
+ '200':
42833
+ content:
42834
+ application/json:
42835
+ schema:
42836
+ $ref: '#/components/schemas/ListRelationCatalogResponse'
42837
+ description: OK
42838
+ '403':
42839
+ $ref: '#/components/responses/ForbiddenResponse'
42840
+ '429':
42841
+ $ref: '#/components/responses/TooManyRequestsResponse'
42842
+ security:
42843
+ - apiKeyAuth: []
42844
+ appKeyAuth: []
42845
+ - AuthZ:
42846
+ - apm_service_catalog_read
42847
+ summary: Get a list of entity relations
42848
+ tags:
42849
+ - Software Catalog
42850
+ x-pagination:
42851
+ limitParam: page[limit]
42852
+ pageOffsetParam: page[offset]
42853
+ resultsPath: data
42637
42854
/api/v2/ci/pipeline:
42638
42855
post:
42639
42856
description: 'Send your pipeline event to your Datadog platform over HTTP. For
0 commit comments