feat(api): aggregated API specs update

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 523
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/gcore%2Fgcore-eca22164d9482d49887776d39a5e74fb55cc36d40d3f524336aa26433514386e.yml
-openapi_spec_hash: f6aa7b95639f6eb639e408ad321f2861
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/gcore%2Fgcore-5b7d4df0da50df13bda0d0112b026c0b40e26462f8d7e0013ac3286c27a458bd.yml
+openapi_spec_hash: 2ad55753d983df577077b3ce156ac4ca
 config_hash: 53f1995f46a0e2f7e747e65bafa3d6e0

src/gcore/resources/storage/storage.py

@@ -2,6 +2,7 @@
 
 from __future__ import annotations
 
+import typing_extensions
 from typing_extensions import Literal
 
 import httpx
@@ -155,6 +156,7 @@ def create(
             cast_to=Storage,
         )
 
+    @typing_extensions.deprecated("deprecated")
     def update(
         self,
         storage_id: int,
@@ -168,12 +170,15 @@ def update(
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
     ) -> Storage:
-        """
-        Updates storage configuration such as expiration date and server alias.
+        """Updates storage configuration such as expiration date and server alias.
+
+        Note:
+        Prefer PATCH /provisioning/v2/storage/{`storage_id`} that uses correct HTTP
+        method for updating the storage.
 
         Args:
-          expires: ISO 8601 timestamp when the storage should expire. Leave empty to remove
-              expiration.
+          expires: Duration when the storage should expire in format like "2 years 6 months 2 weeks
+              3 days 5 hours 10 minutes 15 seconds". Leave empty to remove expiration.
 
           server_alias: Custom domain alias for accessing the storage. Leave empty to remove alias.
 
@@ -555,6 +560,7 @@ async def create(
             cast_to=Storage,
         )
 
+    @typing_extensions.deprecated("deprecated")
     async def update(
         self,
         storage_id: int,
@@ -568,12 +574,15 @@ async def update(
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
     ) -> Storage:
-        """
-        Updates storage configuration such as expiration date and server alias.
+        """Updates storage configuration such as expiration date and server alias.
+
+        Note:
+        Prefer PATCH /provisioning/v2/storage/{`storage_id`} that uses correct HTTP
+        method for updating the storage.
 
         Args:
-          expires: ISO 8601 timestamp when the storage should expire. Leave empty to remove
-              expiration.
+          expires: Duration when the storage should expire in format like "2 years 6 months 2 weeks
+              3 days 5 hours 10 minutes 15 seconds". Leave empty to remove expiration.
 
           server_alias: Custom domain alias for accessing the storage. Leave empty to remove alias.
 
@@ -865,8 +874,10 @@ def __init__(self, storage: StorageResource) -> None:
         self.create = to_raw_response_wrapper(
             storage.create,
         )
-        self.update = to_raw_response_wrapper(
-            storage.update,
+        self.update = (  # pyright: ignore[reportDeprecated]
+            to_raw_response_wrapper(
+                storage.update,  # pyright: ignore[reportDeprecated],
+            )
         )
         self.list = to_raw_response_wrapper(
             storage.list,
@@ -911,8 +922,10 @@ def __init__(self, storage: AsyncStorageResource) -> None:
         self.create = async_to_raw_response_wrapper(
             storage.create,
         )
-        self.update = async_to_raw_response_wrapper(
-            storage.update,
+        self.update = (  # pyright: ignore[reportDeprecated]
+            async_to_raw_response_wrapper(
+                storage.update,  # pyright: ignore[reportDeprecated],
+            )
         )
         self.list = async_to_raw_response_wrapper(
             storage.list,
@@ -957,8 +970,10 @@ def __init__(self, storage: StorageResource) -> None:
         self.create = to_streamed_response_wrapper(
             storage.create,
         )
-        self.update = to_streamed_response_wrapper(
-            storage.update,
+        self.update = (  # pyright: ignore[reportDeprecated]
+            to_streamed_response_wrapper(
+                storage.update,  # pyright: ignore[reportDeprecated],
+            )
         )
         self.list = to_streamed_response_wrapper(
             storage.list,
@@ -1003,8 +1018,10 @@ def __init__(self, storage: AsyncStorageResource) -> None:
         self.create = async_to_streamed_response_wrapper(
             storage.create,
         )
-        self.update = async_to_streamed_response_wrapper(
-            storage.update,
+        self.update = (  # pyright: ignore[reportDeprecated]
+            async_to_streamed_response_wrapper(
+                storage.update,  # pyright: ignore[reportDeprecated],
+            )
         )
         self.list = async_to_streamed_response_wrapper(
             storage.list,

src/gcore/types/storage/storage_update_params.py

@@ -9,9 +9,9 @@
 
 class StorageUpdateParams(TypedDict, total=False):
     expires: str
-    """ISO 8601 timestamp when the storage should expire.
-
-    Leave empty to remove expiration.
+    """
+    Duration when the storage should expire in format like "2 years 6 months 2 weeks
+    3 days 5 hours 10 minutes 15 seconds". Leave empty to remove expiration.
     """
 
     server_alias: str

tests/api_resources/test_storage.py

@@ -14,6 +14,8 @@
     Storage,
 )
 
+# pyright: reportDeprecated=false
+
 base_url = os.environ.get("TEST_API_BASE_URL", "http://127.0.0.1:4010")
 
 
@@ -70,25 +72,30 @@ def test_streaming_response_create(self, client: Gcore) -> None:
 
     @parametrize
     def test_method_update(self, client: Gcore) -> None:
-        storage = client.storage.update(
-            storage_id=0,
-        )
+        with pytest.warns(DeprecationWarning):
+            storage = client.storage.update(
+                storage_id=0,
+            )
+
         assert_matches_type(Storage, storage, path=["response"])
 
     @parametrize
     def test_method_update_with_all_params(self, client: Gcore) -> None:
-        storage = client.storage.update(
-            storage_id=0,
-            expires="2026-12-31 23:59:59+00:00",
-            server_alias="my-storage.company.com",
-        )
+        with pytest.warns(DeprecationWarning):
+            storage = client.storage.update(
+                storage_id=0,
+                expires="2 years 6 months 2 weeks 3 days 5 hours 10 minutes 15 seconds",
+                server_alias="my-storage.company.com",
+            )
+
         assert_matches_type(Storage, storage, path=["response"])
 
     @parametrize
     def test_raw_response_update(self, client: Gcore) -> None:
-        response = client.storage.with_raw_response.update(
-            storage_id=0,
-        )
+        with pytest.warns(DeprecationWarning):
+            response = client.storage.with_raw_response.update(
+                storage_id=0,
+            )
 
         assert response.is_closed is True
         assert response.http_request.headers.get("X-Stainless-Lang") == "python"
@@ -97,14 +104,15 @@ def test_raw_response_update(self, client: Gcore) -> None:
 
     @parametrize
     def test_streaming_response_update(self, client: Gcore) -> None:
-        with client.storage.with_streaming_response.update(
-            storage_id=0,
-        ) as response:
-            assert not response.is_closed
-            assert response.http_request.headers.get("X-Stainless-Lang") == "python"
+        with pytest.warns(DeprecationWarning):
+            with client.storage.with_streaming_response.update(
+                storage_id=0,
+            ) as response:
+                assert not response.is_closed
+                assert response.http_request.headers.get("X-Stainless-Lang") == "python"
 
-            storage = response.parse()
-            assert_matches_type(Storage, storage, path=["response"])
+                storage = response.parse()
+                assert_matches_type(Storage, storage, path=["response"])
 
         assert cast(Any, response.is_closed) is True
 
@@ -374,25 +382,30 @@ async def test_streaming_response_create(self, async_client: AsyncGcore) -> None
 
     @parametrize
     async def test_method_update(self, async_client: AsyncGcore) -> None:
-        storage = await async_client.storage.update(
-            storage_id=0,
-        )
+        with pytest.warns(DeprecationWarning):
+            storage = await async_client.storage.update(
+                storage_id=0,
+            )
+
         assert_matches_type(Storage, storage, path=["response"])
 
     @parametrize
     async def test_method_update_with_all_params(self, async_client: AsyncGcore) -> None:
-        storage = await async_client.storage.update(
-            storage_id=0,
-            expires="2026-12-31 23:59:59+00:00",
-            server_alias="my-storage.company.com",
-        )
+        with pytest.warns(DeprecationWarning):
+            storage = await async_client.storage.update(
+                storage_id=0,
+                expires="2 years 6 months 2 weeks 3 days 5 hours 10 minutes 15 seconds",
+                server_alias="my-storage.company.com",
+            )
+
         assert_matches_type(Storage, storage, path=["response"])
 
     @parametrize
     async def test_raw_response_update(self, async_client: AsyncGcore) -> None:
-        response = await async_client.storage.with_raw_response.update(
-            storage_id=0,
-        )
+        with pytest.warns(DeprecationWarning):
+            response = await async_client.storage.with_raw_response.update(
+                storage_id=0,
+            )
 
         assert response.is_closed is True
         assert response.http_request.headers.get("X-Stainless-Lang") == "python"
@@ -401,14 +414,15 @@ async def test_raw_response_update(self, async_client: AsyncGcore) -> None:
 
     @parametrize
     async def test_streaming_response_update(self, async_client: AsyncGcore) -> None:
-        async with async_client.storage.with_streaming_response.update(
-            storage_id=0,
-        ) as response:
-            assert not response.is_closed
-            assert response.http_request.headers.get("X-Stainless-Lang") == "python"
-
-            storage = await response.parse()
-            assert_matches_type(Storage, storage, path=["response"])
+        with pytest.warns(DeprecationWarning):
+            async with async_client.storage.with_streaming_response.update(
+                storage_id=0,
+            ) as response:
+                assert not response.is_closed
+                assert response.http_request.headers.get("X-Stainless-Lang") == "python"
+
+                storage = await response.parse()
+                assert_matches_type(Storage, storage, path=["response"])
 
         assert cast(Any, response.is_closed) is True