feat(api): api update (#2459)

Author: stainless-app[bot]

.stats.yml

@@ -1,2 +1,2 @@
 configured_endpoints: 1528
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/cloudflare%2Fcloudflare-a9e85bad713be0131dc6634e1c1e9b76c69f06887fffc104202fd7c18898dcb5.yml
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/cloudflare%2Fcloudflare-5ccb565ee8508335116b0ce9efa6068ddb775fe825726cf3fad2731c6f814f77.yml

src/cloudflare/resources/magic_transit/pcaps/pcaps.py

@@ -2,7 +2,8 @@
 
 from __future__ import annotations
 
-from typing import Any, cast
+from typing import Any, Union, cast
+from datetime import datetime
 from typing_extensions import Literal, overload
 
 import httpx
@@ -87,6 +88,7 @@ def create(
         time_limit: float,
         type: Literal["simple", "full"],
         filter_v1: PCAPFilterParam | NotGiven = NOT_GIVEN,
+        offset_time: Union[str, datetime] | NotGiven = NOT_GIVEN,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
         # The extra values given here take precedence over values defined on the client or passed to this method.
         extra_headers: Headers | None = None,
@@ -111,6 +113,9 @@ def create(
 
           filter_v1: The packet capture filter. When this field is empty, all packets are captured.
 
+          offset_time: The RFC 3339 offset timestamp from which to query backwards for packets. Must be
+              within the last 24h. When this field is empty, defaults to time of request.
+
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request
@@ -190,6 +195,7 @@ def create(
         time_limit: float,
         type: Literal["simple", "full"],
         filter_v1: PCAPFilterParam | NotGiven = NOT_GIVEN,
+        offset_time: Union[str, datetime] | NotGiven = NOT_GIVEN,
         colo_name: str | NotGiven = NOT_GIVEN,
         destination_conf: str | NotGiven = NOT_GIVEN,
         byte_limit: float | NotGiven = NOT_GIVEN,
@@ -213,6 +219,7 @@ def create(
                         "time_limit": time_limit,
                         "type": type,
                         "filter_v1": filter_v1,
+                        "offset_time": offset_time,
                         "colo_name": colo_name,
                         "destination_conf": destination_conf,
                         "byte_limit": byte_limit,
@@ -356,6 +363,7 @@ async def create(
         time_limit: float,
         type: Literal["simple", "full"],
         filter_v1: PCAPFilterParam | NotGiven = NOT_GIVEN,
+        offset_time: Union[str, datetime] | NotGiven = NOT_GIVEN,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
         # The extra values given here take precedence over values defined on the client or passed to this method.
         extra_headers: Headers | None = None,
@@ -380,6 +388,9 @@ async def create(
 
           filter_v1: The packet capture filter. When this field is empty, all packets are captured.
 
+          offset_time: The RFC 3339 offset timestamp from which to query backwards for packets. Must be
+              within the last 24h. When this field is empty, defaults to time of request.
+
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request
@@ -459,6 +470,7 @@ async def create(
         time_limit: float,
         type: Literal["simple", "full"],
         filter_v1: PCAPFilterParam | NotGiven = NOT_GIVEN,
+        offset_time: Union[str, datetime] | NotGiven = NOT_GIVEN,
         colo_name: str | NotGiven = NOT_GIVEN,
         destination_conf: str | NotGiven = NOT_GIVEN,
         byte_limit: float | NotGiven = NOT_GIVEN,
@@ -482,6 +494,7 @@ async def create(
                         "time_limit": time_limit,
                         "type": type,
                         "filter_v1": filter_v1,
+                        "offset_time": offset_time,
                         "colo_name": colo_name,
                         "destination_conf": destination_conf,
                         "byte_limit": byte_limit,

src/cloudflare/types/magic_transit/pcap.py

@@ -1,6 +1,7 @@
 # File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 from typing import Optional
+from datetime import datetime
 from typing_extensions import Literal
 
 from ..._models import BaseModel
@@ -16,6 +17,13 @@ class PCAP(BaseModel):
     filter_v1: Optional[PCAPFilter] = None
     """The packet capture filter. When this field is empty, all packets are captured."""
 
+    offset_time: Optional[datetime] = None
+    """The RFC 3339 offset timestamp from which to query backwards for packets.
+
+    Must be within the last 24h. When this field is empty, defaults to time of
+    request.
+    """
+
     status: Optional[
         Literal[
             "unknown", "success", "pending", "running", "conversion_pending", "conversion_running", "complete", "failed"

src/cloudflare/types/magic_transit/pcap_create_params.py

@@ -3,8 +3,10 @@
 from __future__ import annotations
 
 from typing import Union
-from typing_extensions import Literal, Required, TypeAlias, TypedDict
+from datetime import datetime
+from typing_extensions import Literal, Required, Annotated, TypeAlias, TypedDict
 
+from ..._utils import PropertyInfo
 from .pcap_filter_param import PCAPFilterParam
 
 __all__ = ["PCAPCreateParams", "MagicVisibilityPCAPsPCAPsRequestSimple", "MagicVisibilityPCAPsPCAPsRequestFull"]
@@ -33,6 +35,13 @@ class MagicVisibilityPCAPsPCAPsRequestSimple(TypedDict, total=False):
     filter_v1: PCAPFilterParam
     """The packet capture filter. When this field is empty, all packets are captured."""
 
+    offset_time: Annotated[Union[str, datetime], PropertyInfo(format="iso8601")]
+    """The RFC 3339 offset timestamp from which to query backwards for packets.
+
+    Must be within the last 24h. When this field is empty, defaults to time of
+    request.
+    """
+
 
 class MagicVisibilityPCAPsPCAPsRequestFull(TypedDict, total=False):
     account_id: Required[str]

tests/api_resources/magic_transit/test_pcaps.py

@@ -9,6 +9,7 @@
 
 from cloudflare import Cloudflare, AsyncCloudflare
 from tests.utils import assert_matches_type
+from cloudflare._utils import parse_datetime
 from cloudflare.pagination import SyncSinglePage, AsyncSinglePage
 from cloudflare.types.magic_transit import (
     PCAPGetResponse,
@@ -48,6 +49,7 @@ def test_method_create_with_all_params_overload_1(self, client: Cloudflare) -> N
                 "source_address": "1.2.3.4",
                 "source_port": 123,
             },
+            offset_time=parse_datetime("2020-01-01T08:00:00Z"),
         )
         assert_matches_type(PCAPCreateResponse, pcap, path=["response"])
 
@@ -289,6 +291,7 @@ async def test_method_create_with_all_params_overload_1(self, async_client: Asyn
                 "source_address": "1.2.3.4",
                 "source_port": 123,
             },
+            offset_time=parse_datetime("2020-01-01T08:00:00Z"),
         )
         assert_matches_type(PCAPCreateResponse, pcap, path=["response"])