@@ -8603,7 +8603,7 @@ components:
8603
8603
format: int64
8604
8604
type: integer
8605
8605
times:
8606
- description: An array of query timestamps in EPOCH milliseconds
8606
+ description: An array of query timestamps in EPOCH milliseconds.
8607
8607
example: []
8608
8608
items:
8609
8609
description: A timestamp in EPOCH milliseconds.
@@ -9471,6 +9471,164 @@ components:
9471
9471
- formula
9472
9472
- dimension
9473
9473
type: object
9474
+ SearchSLOResponse:
9475
+ description: A search SLO response containing results from the search query.
9476
+ properties:
9477
+ data:
9478
+ $ref: '#/components/schemas/SearchSLOResponseData'
9479
+ links:
9480
+ $ref: '#/components/schemas/SearchSLOResponseLinks'
9481
+ meta:
9482
+ $ref: '#/components/schemas/SearchSLOResponseMeta'
9483
+ type: object
9484
+ SearchSLOResponseData:
9485
+ description: Data from search SLO response.
9486
+ properties:
9487
+ attributes:
9488
+ $ref: '#/components/schemas/SearchSLOResponseDataAttributes'
9489
+ type:
9490
+ description: Type of service level objective result.
9491
+ example: ''
9492
+ type: string
9493
+ type: object
9494
+ SearchSLOResponseDataAttributes:
9495
+ description: Attributes
9496
+ properties:
9497
+ facets:
9498
+ $ref: '#/components/schemas/SearchSLOResponseDataAttributesFacets'
9499
+ slo:
9500
+ description: SLOs
9501
+ items:
9502
+ $ref: '#/components/schemas/ServiceLevelObjective'
9503
+ type: array
9504
+ type: object
9505
+ SearchSLOResponseDataAttributesFacets:
9506
+ description: Facets
9507
+ properties:
9508
+ all_tags:
9509
+ description: All tags associated with an SLO.
9510
+ items:
9511
+ $ref: '#/components/schemas/SearchSLOResponseDataAttributesFacetsObjectString'
9512
+ type: array
9513
+ creator_name:
9514
+ description: Creator of an SLO.
9515
+ items:
9516
+ $ref: '#/components/schemas/SearchSLOResponseDataAttributesFacetsObjectString'
9517
+ type: array
9518
+ env_tags:
9519
+ description: Tags with the `env` tag key.
9520
+ items:
9521
+ $ref: '#/components/schemas/SearchSLOResponseDataAttributesFacetsObjectString'
9522
+ type: array
9523
+ service_tags:
9524
+ description: Tags with the `service` tag key.
9525
+ items:
9526
+ $ref: '#/components/schemas/SearchSLOResponseDataAttributesFacetsObjectString'
9527
+ type: array
9528
+ slo_type:
9529
+ description: Type of SLO.
9530
+ items:
9531
+ $ref: '#/components/schemas/SearchSLOResponseDataAttributesFacetsObjectInt'
9532
+ type: array
9533
+ target:
9534
+ description: SLO Target
9535
+ items:
9536
+ $ref: '#/components/schemas/SearchSLOResponseDataAttributesFacetsObjectInt'
9537
+ type: array
9538
+ team_tags:
9539
+ description: Tags with the `team` tag key.
9540
+ items:
9541
+ $ref: '#/components/schemas/SearchSLOResponseDataAttributesFacetsObjectString'
9542
+ type: array
9543
+ timeframe:
9544
+ description: Timeframes of SLOs.
9545
+ items:
9546
+ $ref: '#/components/schemas/SearchSLOResponseDataAttributesFacetsObjectString'
9547
+ type: array
9548
+ type: object
9549
+ SearchSLOResponseDataAttributesFacetsObjectInt:
9550
+ description: Facet
9551
+ properties:
9552
+ count:
9553
+ description: Count
9554
+ format: int64
9555
+ type: integer
9556
+ name:
9557
+ description: Facet
9558
+ format: double
9559
+ type: number
9560
+ type: object
9561
+ SearchSLOResponseDataAttributesFacetsObjectString:
9562
+ description: Facet
9563
+ properties:
9564
+ count:
9565
+ description: Count
9566
+ format: int64
9567
+ type: integer
9568
+ name:
9569
+ description: Facet
9570
+ type: string
9571
+ type: object
9572
+ SearchSLOResponseLinks:
9573
+ description: Pagination links.
9574
+ properties:
9575
+ first:
9576
+ description: Link to last page.
9577
+ type: string
9578
+ last:
9579
+ description: Link to first page.
9580
+ type: string
9581
+ next:
9582
+ description: Link to the next page.
9583
+ type: string
9584
+ prev:
9585
+ description: Link to previous page.
9586
+ type: string
9587
+ self:
9588
+ description: Link to current page.
9589
+ type: string
9590
+ type: object
9591
+ SearchSLOResponseMeta:
9592
+ description: Searches metadata returned by the API.
9593
+ properties:
9594
+ pagination:
9595
+ $ref: '#/components/schemas/SearchSLOResponseMetaPage'
9596
+ type: object
9597
+ SearchSLOResponseMetaPage:
9598
+ description: Pagination metadata returned by the API.
9599
+ properties:
9600
+ first_number:
9601
+ description: The first number.
9602
+ format: int64
9603
+ type: integer
9604
+ last_number:
9605
+ description: The last number.
9606
+ format: int64
9607
+ type: integer
9608
+ next_number:
9609
+ description: The next number.
9610
+ format: int64
9611
+ type: integer
9612
+ number:
9613
+ description: The page number.
9614
+ format: int64
9615
+ type: integer
9616
+ prev_number:
9617
+ description: The previous page number.
9618
+ format: int64
9619
+ type: integer
9620
+ size:
9621
+ description: The size of the response.
9622
+ format: int64
9623
+ type: integer
9624
+ total:
9625
+ description: The total number of SLOs in the response.
9626
+ format: int64
9627
+ type: integer
9628
+ type:
9629
+ description: Type of pagination.
9630
+ type: string
9631
+ type: object
9474
9632
Series:
9475
9633
description: 'A metric to submit to Datadog.
9476
9634
@@ -9599,7 +9757,7 @@ components:
9599
9757
nullable: true
9600
9758
type: string
9601
9759
groups:
9602
- description: 'A list of (up to 20 ) monitor groups that narrow the scope
9760
+ description: 'A list of (up to 100 ) monitor groups that narrow the scope
9603
9761
of a monitor service level objective.
9604
9762
9605
9763
@@ -9648,8 +9806,8 @@ components:
9648
9806
9649
9807
field.
9650
9808
9651
- Always included in service level objective responses for monitor service
9652
- level
9809
+ Always included in service level objective responses for monitor-based
9810
+ service level
9653
9811
9654
9812
objectives (but may be empty). Ignored in create/update requests. Does
9655
9813
not
@@ -9702,7 +9860,7 @@ components:
9702
9860
- thresholds
9703
9861
- type
9704
9862
ServiceLevelObjectiveQuery:
9705
- description: 'A metric SLI query . **Required if type is `metric`**. Note that
9863
+ description: 'A metric-based SLO . **Required if type is `metric`**. Note that
9706
9864
Datadog only allows the sum by aggregator
9707
9865
9708
9866
to be used because this will sum up all request counts instead of averaging
@@ -9738,7 +9896,7 @@ components:
9738
9896
nullable: true
9739
9897
type: string
9740
9898
groups:
9741
- description: 'A list of (up to 20 ) monitor groups that narrow the scope
9899
+ description: 'A list of (up to 100 ) monitor groups that narrow the scope
9742
9900
of a monitor service level objective.
9743
9901
9744
9902
@@ -9757,7 +9915,7 @@ components:
9757
9915
type: string
9758
9916
type: array
9759
9917
monitor_ids:
9760
- description: 'A list of monitor ids that defines the scope of a monitor
9918
+ description: 'A list of monitor IDs that defines the scope of a monitor
9761
9919
service level
9762
9920
9763
9921
objective. **Required if type is `monitor`**.'
@@ -24231,6 +24389,94 @@ paths:
24231
24389
x-menu-order: 4
24232
24390
x-undo:
24233
24391
type: idempotent
24392
+ /api/v1/slo/search:
24393
+ get:
24394
+ description: Get a list of service level objective objects for your organization.
24395
+ operationId: SearchSLO
24396
+ parameters:
24397
+ - description: The query string to filter results based on SLO names.
24398
+ in: query
24399
+ name: query
24400
+ required: false
24401
+ schema:
24402
+ type: string
24403
+ - description: The number of files to return in the response `[default=10]`.
24404
+ in: query
24405
+ name: page[size]
24406
+ required: false
24407
+ schema:
24408
+ format: int64
24409
+ type: integer
24410
+ - description: The identifier of the first page to return. This parameter is
24411
+ used for the pagination feature `[default=0]`.
24412
+ in: query
24413
+ name: page[number]
24414
+ required: false
24415
+ schema:
24416
+ format: int64
24417
+ type: integer
24418
+ responses:
24419
+ '200':
24420
+ content:
24421
+ application/json:
24422
+ schema:
24423
+ $ref: '#/components/schemas/SearchSLOResponse'
24424
+ description: OK
24425
+ '400':
24426
+ content:
24427
+ application/json:
24428
+ schema:
24429
+ $ref: '#/components/schemas/APIErrorResponse'
24430
+ description: Bad Request
24431
+ '403':
24432
+ content:
24433
+ application/json:
24434
+ schema:
24435
+ $ref: '#/components/schemas/APIErrorResponse'
24436
+ description: Forbidden
24437
+ '429':
24438
+ $ref: '#/components/responses/TooManyRequestsResponse'
24439
+ servers:
24440
+ - url: https://{subdomain}.{site}
24441
+ variables:
24442
+ site:
24443
+ default: datadoghq.com
24444
+ description: The regional site for Datadog customers.
24445
+ enum:
24446
+ - datadoghq.com
24447
+ - us3.datadoghq.com
24448
+ - us5.datadoghq.com
24449
+ - ddog-gov.com
24450
+ subdomain:
24451
+ default: api
24452
+ description: The subdomain where the API is deployed.
24453
+ - url: '{protocol}://{name}'
24454
+ variables:
24455
+ name:
24456
+ default: api.datadoghq.com
24457
+ description: Full site DNS name.
24458
+ protocol:
24459
+ default: https
24460
+ description: The protocol for accessing the API.
24461
+ - url: https://{subdomain}.{site}
24462
+ variables:
24463
+ site:
24464
+ default: datadoghq.com
24465
+ description: Any Datadog deployment.
24466
+ subdomain:
24467
+ default: api
24468
+ description: The subdomain where the API is deployed.
24469
+ summary: Search for SLOs
24470
+ tags:
24471
+ - Service Level Objectives
24472
+ x-menu-order: 1
24473
+ x-undo:
24474
+ type: safe
24475
+ x-unstable: '**Note**: Note: This endpoint is in public beta for US regions.
24476
+
24477
+ It is not currently supported in the EU region.
24478
+
24479
+ If you have any feedback, contact [Datadog support](https://docs.datadoghq.com/help/).'
24234
24480
/api/v1/slo/{slo_id}:
24235
24481
delete:
24236
24482
description: 'Permanently delete the specified service level objective object.
0 commit comments