@@ -8603,7 +8603,7 @@ components:
86038603 format: int64
86048604 type: integer
86058605 times:
8606- description: An array of query timestamps in EPOCH milliseconds
8606+ description: An array of query timestamps in EPOCH milliseconds.
86078607 example: []
86088608 items:
86098609 description: A timestamp in EPOCH milliseconds.
@@ -9471,6 +9471,164 @@ components:
94719471 - formula
94729472 - dimension
94739473 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
94749632 Series:
94759633 description: 'A metric to submit to Datadog.
94769634
@@ -9599,7 +9757,7 @@ components:
95999757 nullable: true
96009758 type: string
96019759 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
96039761 of a monitor service level objective.
96049762
96059763
@@ -9648,8 +9806,8 @@ components:
96489806
96499807 field.
96509808
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
96539811
96549812 objectives (but may be empty). Ignored in create/update requests. Does
96559813 not
@@ -9702,7 +9860,7 @@ components:
97029860 - thresholds
97039861 - type
97049862 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
97069864 Datadog only allows the sum by aggregator
97079865
97089866 to be used because this will sum up all request counts instead of averaging
@@ -9738,7 +9896,7 @@ components:
97389896 nullable: true
97399897 type: string
97409898 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
97429900 of a monitor service level objective.
97439901
97449902
@@ -9757,7 +9915,7 @@ components:
97579915 type: string
97589916 type: array
97599917 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
97619919 service level
97629920
97639921 objective. **Required if type is `monitor`**.'
@@ -24231,6 +24389,94 @@ paths:
2423124389 x-menu-order: 4
2423224390 x-undo:
2423324391 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/).'
2423424480 /api/v1/slo/{slo_id}:
2423524481 delete:
2423624482 description: 'Permanently delete the specified service level objective object.
0 commit comments