gcore 0.16.0__py3-none-any.whl → 0.23.0__py3-none-any.whl

gcore/resources/cloud/networks/subnets.py

@@ -108,9 +108,10 @@ class SubnetsResource(SyncAPIResource):
 
           tags: Key-value tags to associate with the resource. A tag is a key-value pair that
               can be associated with a resource, enabling efficient filtering and grouping for
-              better organization and management. Some tags are read-only and cannot be
-              modified by the user. Tags are also integrated with cost reports, allowing cost
-              data to be filtered based on tag keys or values.
+              better organization and management. Both tag keys and values have a maximum
+              length of 255 characters. Some tags are read-only and cannot be modified by the
+              user. Tags are also integrated with cost reports, allowing cost data to be
+              filtered based on tag keys or values.
 
           extra_headers: Send extra headers
 
@@ -165,6 +166,7 @@ class SubnetsResource(SyncAPIResource):
         router_id_to_connect: Optional[str] | Omit = omit,
         tags: Dict[str, str] | Omit = omit,
         polling_interval_seconds: int | Omit = omit,
+        polling_timeout_seconds: int | Omit = omit,
         # 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,
@@ -198,6 +200,7 @@ class SubnetsResource(SyncAPIResource):
             task_id=response.tasks[0],
             extra_headers=extra_headers,
             polling_interval_seconds=polling_interval_seconds,
+            polling_timeout_seconds=polling_timeout_seconds,
         )
         if not task.created_resources or not task.created_resources.subnets or len(task.created_resources.subnets) != 1:
             raise ValueError(f"Expected exactly one resource to be created in a task")
@@ -260,15 +263,20 @@ class SubnetsResource(SyncAPIResource):
               - **Add/update tags:**
                 `{'tags': {'environment': 'production', 'team': 'backend'}}` adds new tags or
                 updates existing ones.
-              - **Delete tags:** `{'tags': {'`old_tag`': null}}` removes specific tags.
+
+              - **Delete tags:** `{'tags': {'old_tag': null}}` removes specific tags.
+
               - **Remove all tags:** `{'tags': null}` removes all user-managed tags (read-only
                 tags are preserved).
+
               - **Partial update:** `{'tags': {'environment': 'staging'}}` only updates
                 specified tags.
+
               - **Mixed operations:**
-                `{'tags': {'environment': 'production', '`cost_center`': 'engineering', '`deprecated_tag`': null}}`
+                `{'tags': {'environment': 'production', 'cost_center': 'engineering', 'deprecated_tag': null}}`
                 adds/updates 'environment' and '`cost_center`' while removing
                 '`deprecated_tag`', preserving other existing tags.
+
               - **Replace all:** first delete existing tags with null values, then add new
                 ones in the same request.
 
@@ -565,9 +573,10 @@ class AsyncSubnetsResource(AsyncAPIResource):
 
           tags: Key-value tags to associate with the resource. A tag is a key-value pair that
               can be associated with a resource, enabling efficient filtering and grouping for
-              better organization and management. Some tags are read-only and cannot be
-              modified by the user. Tags are also integrated with cost reports, allowing cost
-              data to be filtered based on tag keys or values.
+              better organization and management. Both tag keys and values have a maximum
+              length of 255 characters. Some tags are read-only and cannot be modified by the
+              user. Tags are also integrated with cost reports, allowing cost data to be
+              filtered based on tag keys or values.
 
           extra_headers: Send extra headers
 
@@ -622,6 +631,7 @@ class AsyncSubnetsResource(AsyncAPIResource):
         router_id_to_connect: Optional[str] | Omit = omit,
         tags: Dict[str, str] | Omit = omit,
         polling_interval_seconds: int | Omit = omit,
+        polling_timeout_seconds: int | Omit = omit,
         # 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,
@@ -655,6 +665,7 @@ class AsyncSubnetsResource(AsyncAPIResource):
             task_id=response.tasks[0],
             extra_headers=extra_headers,
             polling_interval_seconds=polling_interval_seconds,
+            polling_timeout_seconds=polling_timeout_seconds,
         )
         if not task.created_resources or not task.created_resources.subnets or len(task.created_resources.subnets) != 1:
             raise ValueError(f"Expected exactly one resource to be created in a task")
@@ -717,15 +728,20 @@ class AsyncSubnetsResource(AsyncAPIResource):
               - **Add/update tags:**
                 `{'tags': {'environment': 'production', 'team': 'backend'}}` adds new tags or
                 updates existing ones.
-              - **Delete tags:** `{'tags': {'`old_tag`': null}}` removes specific tags.
+
+              - **Delete tags:** `{'tags': {'old_tag': null}}` removes specific tags.
+
               - **Remove all tags:** `{'tags': null}` removes all user-managed tags (read-only
                 tags are preserved).
+
               - **Partial update:** `{'tags': {'environment': 'staging'}}` only updates
                 specified tags.
+
               - **Mixed operations:**
-                `{'tags': {'environment': 'production', '`cost_center`': 'engineering', '`deprecated_tag`': null}}`
+                `{'tags': {'environment': 'production', 'cost_center': 'engineering', 'deprecated_tag': null}}`
                 adds/updates 'environment' and '`cost_center`' while removing
                 '`deprecated_tag`', preserving other existing tags.
+
               - **Replace all:** first delete existing tags with null values, then add new
                 ones in the same request.
 

gcore/resources/cloud/placement_groups.py

@@ -26,6 +26,10 @@ __all__ = ["PlacementGroupsResource", "AsyncPlacementGroupsResource"]
 
 
 class PlacementGroupsResource(SyncAPIResource):
+    """
+    Placement Groups allow you to specific a policy that determines whether Virtual Machines will be hosted on the same physical server or on different ones.
+    """
+
     @cached_property
     def with_raw_response(self) -> PlacementGroupsResourceWithRawResponse:
         """
@@ -210,6 +214,10 @@ class PlacementGroupsResource(SyncAPIResource):
 
 
 class AsyncPlacementGroupsResource(AsyncAPIResource):
+    """
+    Placement Groups allow you to specific a policy that determines whether Virtual Machines will be hosted on the same physical server or on different ones.
+    """
+
     @cached_property
     def with_raw_response(self) -> AsyncPlacementGroupsResourceWithRawResponse:
         """

gcore/resources/cloud/projects.py

@@ -18,7 +18,7 @@ from ..._response import (
     async_to_streamed_response_wrapper,
 )
 from ...pagination import SyncOffsetPage, AsyncOffsetPage
-from ...types.cloud import project_list_params, project_create_params, project_replace_params
+from ...types.cloud import project_list_params, project_create_params, project_update_params
 from ..._base_client import AsyncPaginator, make_request_options
 from ...types.cloud.project import Project
 from ...types.cloud.task_id_list import TaskIDList
@@ -50,9 +50,7 @@ class ProjectsResource(SyncAPIResource):
         self,
         *,
         name: str,
-        client_id: Optional[int] | Omit = omit,
         description: Optional[str] | Omit = omit,
-        state: Optional[str] | Omit = omit,
         # 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,
@@ -68,12 +66,8 @@ class ProjectsResource(SyncAPIResource):
         Args:
           name: Unique project name for a client. Each client always has one "default" project.
 
-          client_id: ID associated with the client.
-
           description: Description of the project.
 
-          state: State of the project.
-
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request
@@ -87,9 +81,7 @@ class ProjectsResource(SyncAPIResource):
             body=maybe_transform(
                 {
                     "name": name,
-                    "client_id": client_id,
                     "description": description,
-                    "state": state,
                 },
                 project_create_params.ProjectCreateParams,
             ),
@@ -99,6 +91,52 @@ class ProjectsResource(SyncAPIResource):
             cast_to=Project,
         )
 
+    def update(
+        self,
+        *,
+        project_id: int | None = None,
+        name: str,
+        description: Optional[str] | Omit = omit,
+        # 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,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
+    ) -> Project:
+        """
+        Update project name and description.
+
+        Args:
+          name: Name of the entity, following a specific format.
+
+          description: Description of the project.
+
+          extra_headers: Send extra headers
+
+          extra_query: Add additional query parameters to the request
+
+          extra_body: Add additional JSON properties to the request
+
+          timeout: Override the client-level default timeout for this request, in seconds
+        """
+        if project_id is None:
+            project_id = self._client._get_cloud_project_id_path_param()
+        return self._put(
+            f"/cloud/v1/projects/{project_id}",
+            body=maybe_transform(
+                {
+                    "name": name,
+                    "description": description,
+                },
+                project_update_params.ProjectUpdateParams,
+            ),
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=Project,
+        )
+
     def list(
         self,
         *,
@@ -233,10 +271,30 @@ class ProjectsResource(SyncAPIResource):
             cast_to=Project,
         )
 
-    def replace(
+
+class AsyncProjectsResource(AsyncAPIResource):
+    @cached_property
+    def with_raw_response(self) -> AsyncProjectsResourceWithRawResponse:
+        """
+        This property can be used as a prefix for any HTTP method call to return
+        the raw response object instead of the parsed content.
+
+        For more information, see https://www.github.com/G-Core/gcore-python#accessing-raw-response-data-eg-headers
+        """
+        return AsyncProjectsResourceWithRawResponse(self)
+
+    @cached_property
+    def with_streaming_response(self) -> AsyncProjectsResourceWithStreamingResponse:
+        """
+        An alternative to `.with_raw_response` that doesn't eagerly read the response body.
+
+        For more information, see https://www.github.com/G-Core/gcore-python#with_streaming_response
+        """
+        return AsyncProjectsResourceWithStreamingResponse(self)
+
+    async def create(
         self,
         *,
-        project_id: int | None = None,
         name: str,
         description: Optional[str] | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
@@ -246,13 +304,13 @@ class ProjectsResource(SyncAPIResource):
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> Project:
-        """Update project name and description.
+        """Create a new project for a client.
 
-        Project management must be enabled to
-        perform this operation.
+        Project management must be enabled to perform
+        this operation.
 
         Args:
-          name: Name of the entity, following a specific format.
+          name: Unique project name for a client. Each client always has one "default" project.
 
           description: Description of the project.
 
@@ -264,16 +322,14 @@ class ProjectsResource(SyncAPIResource):
 
           timeout: Override the client-level default timeout for this request, in seconds
         """
-        if project_id is None:
-            project_id = self._client._get_cloud_project_id_path_param()
-        return self._put(
-            f"/cloud/v1/projects/{project_id}",
-            body=maybe_transform(
+        return await self._post(
+            "/cloud/v1/projects",
+            body=await async_maybe_transform(
                 {
                     "name": name,
                     "description": description,
                 },
-                project_replace_params.ProjectReplaceParams,
+                project_create_params.ProjectCreateParams,
             ),
             options=make_request_options(
                 extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
@@ -281,34 +337,12 @@ class ProjectsResource(SyncAPIResource):
             cast_to=Project,
         )
 
-
-class AsyncProjectsResource(AsyncAPIResource):
-    @cached_property
-    def with_raw_response(self) -> AsyncProjectsResourceWithRawResponse:
-        """
-        This property can be used as a prefix for any HTTP method call to return
-        the raw response object instead of the parsed content.
-
-        For more information, see https://www.github.com/G-Core/gcore-python#accessing-raw-response-data-eg-headers
-        """
-        return AsyncProjectsResourceWithRawResponse(self)
-
-    @cached_property
-    def with_streaming_response(self) -> AsyncProjectsResourceWithStreamingResponse:
-        """
-        An alternative to `.with_raw_response` that doesn't eagerly read the response body.
-
-        For more information, see https://www.github.com/G-Core/gcore-python#with_streaming_response
-        """
-        return AsyncProjectsResourceWithStreamingResponse(self)
-
-    async def create(
+    async def update(
         self,
         *,
+        project_id: int | None = None,
         name: str,
-        client_id: Optional[int] | Omit = omit,
         description: Optional[str] | Omit = omit,
-        state: Optional[str] | Omit = omit,
         # 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,
@@ -316,20 +350,14 @@ class AsyncProjectsResource(AsyncAPIResource):
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> Project:
-        """Create a new project for a client.
-
-        Project management must be enabled to perform
-        this operation.
+        """
+        Update project name and description.
 
         Args:
-          name: Unique project name for a client. Each client always has one "default" project.
-
-          client_id: ID associated with the client.
+          name: Name of the entity, following a specific format.
 
           description: Description of the project.
 
-          state: State of the project.
-
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request
@@ -338,16 +366,16 @@ class AsyncProjectsResource(AsyncAPIResource):
 
           timeout: Override the client-level default timeout for this request, in seconds
         """
-        return await self._post(
-            "/cloud/v1/projects",
+        if project_id is None:
+            project_id = self._client._get_cloud_project_id_path_param()
+        return await self._put(
+            f"/cloud/v1/projects/{project_id}",
             body=await async_maybe_transform(
                 {
                     "name": name,
-                    "client_id": client_id,
                     "description": description,
-                    "state": state,
                 },
-                project_create_params.ProjectCreateParams,
+                project_update_params.ProjectUpdateParams,
             ),
             options=make_request_options(
                 extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
@@ -489,54 +517,6 @@ class AsyncProjectsResource(AsyncAPIResource):
             cast_to=Project,
         )
 
-    async def replace(
-        self,
-        *,
-        project_id: int | None = None,
-        name: str,
-        description: Optional[str] | Omit = omit,
-        # 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,
-        extra_query: Query | None = None,
-        extra_body: Body | None = None,
-        timeout: float | httpx.Timeout | None | NotGiven = not_given,
-    ) -> Project:
-        """Update project name and description.
-
-        Project management must be enabled to
-        perform this operation.
-
-        Args:
-          name: Name of the entity, following a specific format.
-
-          description: Description of the project.
-
-          extra_headers: Send extra headers
-
-          extra_query: Add additional query parameters to the request
-
-          extra_body: Add additional JSON properties to the request
-
-          timeout: Override the client-level default timeout for this request, in seconds
-        """
-        if project_id is None:
-            project_id = self._client._get_cloud_project_id_path_param()
-        return await self._put(
-            f"/cloud/v1/projects/{project_id}",
-            body=await async_maybe_transform(
-                {
-                    "name": name,
-                    "description": description,
-                },
-                project_replace_params.ProjectReplaceParams,
-            ),
-            options=make_request_options(
-                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
-            ),
-            cast_to=Project,
-        )
-
 
 class ProjectsResourceWithRawResponse:
     def __init__(self, projects: ProjectsResource) -> None:
@@ -545,6 +525,9 @@ class ProjectsResourceWithRawResponse:
         self.create = to_raw_response_wrapper(
             projects.create,
         )
+        self.update = to_raw_response_wrapper(
+            projects.update,
+        )
         self.list = to_raw_response_wrapper(
             projects.list,
         )
@@ -554,9 +537,6 @@ class ProjectsResourceWithRawResponse:
         self.get = to_raw_response_wrapper(
             projects.get,
         )
-        self.replace = to_raw_response_wrapper(
-            projects.replace,
-        )
 
 
 class AsyncProjectsResourceWithRawResponse:
@@ -566,6 +546,9 @@ class AsyncProjectsResourceWithRawResponse:
         self.create = async_to_raw_response_wrapper(
             projects.create,
         )
+        self.update = async_to_raw_response_wrapper(
+            projects.update,
+        )
         self.list = async_to_raw_response_wrapper(
             projects.list,
         )
@@ -575,9 +558,6 @@ class AsyncProjectsResourceWithRawResponse:
         self.get = async_to_raw_response_wrapper(
             projects.get,
         )
-        self.replace = async_to_raw_response_wrapper(
-            projects.replace,
-        )
 
 
 class ProjectsResourceWithStreamingResponse:
@@ -587,6 +567,9 @@ class ProjectsResourceWithStreamingResponse:
         self.create = to_streamed_response_wrapper(
             projects.create,
         )
+        self.update = to_streamed_response_wrapper(
+            projects.update,
+        )
         self.list = to_streamed_response_wrapper(
             projects.list,
         )
@@ -596,9 +579,6 @@ class ProjectsResourceWithStreamingResponse:
         self.get = to_streamed_response_wrapper(
             projects.get,
         )
-        self.replace = to_streamed_response_wrapper(
-            projects.replace,
-        )
 
 
 class AsyncProjectsResourceWithStreamingResponse:
@@ -608,6 +588,9 @@ class AsyncProjectsResourceWithStreamingResponse:
         self.create = async_to_streamed_response_wrapper(
             projects.create,
         )
+        self.update = async_to_streamed_response_wrapper(
+            projects.update,
+        )
         self.list = async_to_streamed_response_wrapper(
             projects.list,
         )
@@ -617,6 +600,3 @@ class AsyncProjectsResourceWithStreamingResponse:
         self.get = async_to_streamed_response_wrapper(
             projects.get,
         )
-        self.replace = async_to_streamed_response_wrapper(
-            projects.replace,
-        )

gcore/resources/cloud/quotas/requests.py

@@ -51,7 +51,6 @@ class RequestsResource(SyncAPIResource):
         *,
         description: str,
         requested_limits: request_create_params.RequestedLimits,
-        client_id: int | Omit = omit,
         # 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,
@@ -67,8 +66,6 @@ class RequestsResource(SyncAPIResource):
 
           requested_limits: Limits you want to increase.
 
-          client_id: Client ID that requests the limit increase.
-
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request
@@ -84,7 +81,6 @@ class RequestsResource(SyncAPIResource):
                 {
                     "description": description,
                     "requested_limits": requested_limits,
-                    "client_id": client_id,
                 },
                 request_create_params.RequestCreateParams,
             ),
@@ -239,7 +235,6 @@ class AsyncRequestsResource(AsyncAPIResource):
         *,
         description: str,
         requested_limits: request_create_params.RequestedLimits,
-        client_id: int | Omit = omit,
         # 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,
@@ -255,8 +250,6 @@ class AsyncRequestsResource(AsyncAPIResource):
 
           requested_limits: Limits you want to increase.
 
-          client_id: Client ID that requests the limit increase.
-
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request
@@ -272,7 +265,6 @@ class AsyncRequestsResource(AsyncAPIResource):
                 {
                     "description": description,
                     "requested_limits": requested_limits,
-                    "client_id": client_id,
                 },
                 request_create_params.RequestCreateParams,
             ),