Spans API docs update (#1553)

Co-authored-by: ci.datadog-api-spec <[email protected]>

Author: api-clients-generation-pipeline[bot]

.apigentools-info

@@ -4,13 +4,13 @@
     "spec_versions": {
         "v1": {
             "apigentools_version": "1.6.5",
-            "regenerated": "2023-07-03 06:07:19.450806",
-            "spec_repo_commit": "832b2752"
+            "regenerated": "2023-07-03 09:29:29.728054",
+            "spec_repo_commit": "29891cab"
         },
         "v2": {
             "apigentools_version": "1.6.5",
-            "regenerated": "2023-07-03 06:07:19.468637",
-            "spec_repo_commit": "832b2752"
+            "regenerated": "2023-07-03 09:29:29.740678",
+            "spec_repo_commit": "29891cab"
         }
     }
 }

.generator/schemas/v2/openapi.yaml

@@ -24437,8 +24437,10 @@ paths:
         If you have any feedback, contact [Datadog support](https://docs.datadoghq.com/help/).'
   /api/v2/spans/analytics/aggregate:
     post:
-      description: The API endpoint to aggregate spans into buckets and compute metrics
+      description: 'The API endpoint to aggregate spans into buckets and compute metrics
         and timeseries.
+
+        This endpoint is rate limited to `300` requests per hour.'
       operationId: AggregateSpans
       requestBody:
         content:
@@ -24470,7 +24472,12 @@ paths:
         [Results are paginated][1].
 
 
-        Use this endpoint to see your latest spans.'
+        Use this endpoint to see your latest spans.
+
+        This endpoint is rate limited to `300` requests per hour.
+
+
+        [1]: /logs/guide/collect-multiple-logs-with-pagination'
       operationId: ListSpansGet
       parameters:
       - description: Search query following spans syntax.
@@ -24550,7 +24557,12 @@ paths:
         [Results are paginated][1].
 
 
-        Use this endpoint to build complex spans filtering and search.'
+        Use this endpoint to build complex spans filtering and search.
+
+        This endpoint is rate limited to `300` requests per hour.
+
+
+        [1]: /logs/guide/collect-multiple-logs-with-pagination'
       operationId: ListSpans
       requestBody:
         content:

src/datadog_api_client/v2/api/spans_api.py

@@ -129,6 +129,7 @@ def aggregate_spans(
         """Aggregate spans.
 
         The API endpoint to aggregate spans into buckets and compute metrics and timeseries.
+        This endpoint is rate limited to ``300`` requests per hour.
 
         :type body: SpansAggregateRequest
         :rtype: SpansAggregateResponse
@@ -145,9 +146,10 @@ def list_spans(
         """Search spans.
 
         List endpoint returns spans that match a span search query.
-        [Results are paginated][1].
+        `Results are paginated </logs/guide/collect-multiple-logs-with-pagination>`_.
 
         Use this endpoint to build complex spans filtering and search.
+        This endpoint is rate limited to ``300`` requests per hour.
 
         :type body: SpansListRequest
         :rtype: SpansListResponse
@@ -202,9 +204,10 @@ def list_spans_get(
         """Get a list of spans.
 
         List endpoint returns spans that match a span search query.
-        [Results are paginated][1].
+        `Results are paginated </logs/guide/collect-multiple-logs-with-pagination>`_.
 
         Use this endpoint to see your latest spans.
+        This endpoint is rate limited to ``300`` requests per hour.
 
         :param filter_query: Search query following spans syntax.
         :type filter_query: str, optional