gcore 0.3.0__py3-none-any.whl → 0.5.0__py3-none-any.whl

gcore/resources/cloud/networks/subnets.py

@@ -2,7 +2,7 @@
 
 from __future__ import annotations
 
-from typing import List, Iterable, Optional
+from typing import Dict, List, Iterable, Optional
 from typing_extensions import Literal
 
 import httpx
@@ -64,7 +64,7 @@ class SubnetsResource(SyncAPIResource):
         host_routes: Optional[Iterable[subnet_create_params.HostRoute]] | NotGiven = NOT_GIVEN,
         ip_version: IPVersion | NotGiven = NOT_GIVEN,
         router_id_to_connect: Optional[str] | NotGiven = NOT_GIVEN,
-        tags: TagUpdateMapParam | NotGiven = NOT_GIVEN,
+        tags: Dict[str, str] | 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,
@@ -159,6 +159,7 @@ class SubnetsResource(SyncAPIResource):
         gateway_ip: Optional[str] | NotGiven = NOT_GIVEN,
         host_routes: Optional[Iterable[subnet_update_params.HostRoute]] | NotGiven = NOT_GIVEN,
         name: Optional[str] | NotGiven = NOT_GIVEN,
+        tags: Optional[TagUpdateMapParam] | 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,
@@ -167,7 +168,7 @@ class SubnetsResource(SyncAPIResource):
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
     ) -> Subnet:
         """
-        Change subnet properties
+        Update subnet
 
         Args:
           project_id: Project ID
@@ -189,6 +190,26 @@ class SubnetsResource(SyncAPIResource):
 
           name: Name
 
+          tags: Update key-value tags using JSON Merge Patch semantics (RFC 7386). Provide
+              key-value pairs to add or update tags. Set tag values to `null` to remove tags.
+              Unspecified tags remain unchanged. Read-only tags are always preserved and
+              cannot be modified. **Examples:**
+
+              - **Add/update tags:**
+                `{'tags': {'environment': 'production', 'team': 'backend'}}` adds new tags or
+                updates existing ones.
+              - **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}}`
+                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.
+
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request
@@ -212,6 +233,7 @@ class SubnetsResource(SyncAPIResource):
                     "gateway_ip": gateway_ip,
                     "host_routes": host_routes,
                     "name": name,
+                    "tags": tags,
                 },
                 subnet_update_params.SubnetUpdateParams,
             ),
@@ -274,9 +296,7 @@ class SubnetsResource(SyncAPIResource):
 
           tag_key: Optional. Filter by tag keys. ?`tag_key`=key1&`tag_key`=key2
 
-          tag_key_value: Optional. Filter by tag key-value pairs. curl -G --data-urlencode
-              "`tag_key_value`={"key": "value"}" --url
-              "https://example.com/cloud/v1/resource/1/1"
+          tag_key_value: Optional. Filter by tag key-value pairs.
 
           extra_headers: Send extra headers
 
@@ -440,7 +460,7 @@ class AsyncSubnetsResource(AsyncAPIResource):
         host_routes: Optional[Iterable[subnet_create_params.HostRoute]] | NotGiven = NOT_GIVEN,
         ip_version: IPVersion | NotGiven = NOT_GIVEN,
         router_id_to_connect: Optional[str] | NotGiven = NOT_GIVEN,
-        tags: TagUpdateMapParam | NotGiven = NOT_GIVEN,
+        tags: Dict[str, str] | 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,
@@ -535,6 +555,7 @@ class AsyncSubnetsResource(AsyncAPIResource):
         gateway_ip: Optional[str] | NotGiven = NOT_GIVEN,
         host_routes: Optional[Iterable[subnet_update_params.HostRoute]] | NotGiven = NOT_GIVEN,
         name: Optional[str] | NotGiven = NOT_GIVEN,
+        tags: Optional[TagUpdateMapParam] | 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,
@@ -543,7 +564,7 @@ class AsyncSubnetsResource(AsyncAPIResource):
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
     ) -> Subnet:
         """
-        Change subnet properties
+        Update subnet
 
         Args:
           project_id: Project ID
@@ -565,6 +586,26 @@ class AsyncSubnetsResource(AsyncAPIResource):
 
           name: Name
 
+          tags: Update key-value tags using JSON Merge Patch semantics (RFC 7386). Provide
+              key-value pairs to add or update tags. Set tag values to `null` to remove tags.
+              Unspecified tags remain unchanged. Read-only tags are always preserved and
+              cannot be modified. **Examples:**
+
+              - **Add/update tags:**
+                `{'tags': {'environment': 'production', 'team': 'backend'}}` adds new tags or
+                updates existing ones.
+              - **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}}`
+                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.
+
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request
@@ -588,6 +629,7 @@ class AsyncSubnetsResource(AsyncAPIResource):
                     "gateway_ip": gateway_ip,
                     "host_routes": host_routes,
                     "name": name,
+                    "tags": tags,
                 },
                 subnet_update_params.SubnetUpdateParams,
             ),
@@ -650,9 +692,7 @@ class AsyncSubnetsResource(AsyncAPIResource):
 
           tag_key: Optional. Filter by tag keys. ?`tag_key`=key1&`tag_key`=key2
 
-          tag_key_value: Optional. Filter by tag key-value pairs. curl -G --data-urlencode
-              "`tag_key_value`={"key": "value"}" --url
-              "https://example.com/cloud/v1/resource/1/1"
+          tag_key_value: Optional. Filter by tag key-value pairs.
 
           extra_headers: Send extra headers
 

gcore/resources/cloud/projects.py

@@ -60,12 +60,13 @@ class ProjectsResource(SyncAPIResource):
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
     ) -> Project:
-        """Create project
+        """Create a new project for a client.
 
-        Args:
-          name: Unique project name for a client.
+        Project management must be enabled to perform
+        this operation.
 
-        Each client always has one "default" project.
+        Args:
+          name: Unique project name for a client. Each client always has one "default" project.
 
           client_id: ID associated with the client.
 
@@ -114,8 +115,10 @@ class ProjectsResource(SyncAPIResource):
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
     ) -> SyncOffsetPage[Project]:
-        """
-        List projects
+        """Retrieve a list of projects for a client.
+
+        Results can be filtered by name and
+        ordered by various fields.
 
         Args:
           client_id: Client ID filter for administrators.
@@ -172,9 +175,11 @@ class ProjectsResource(SyncAPIResource):
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
     ) -> TaskIDList:
-        """
-        All cloud resources in all regions that belong to the project will be deleted
-        and will not be recoverable
+        """Delete a project and all its associated cloud resources across all regions.
+
+        This
+        operation is irreversible and cannot be undone. Default projects cannot be
+        deleted.
 
         Args:
           extra_headers: Send extra headers
@@ -207,7 +212,7 @@ class ProjectsResource(SyncAPIResource):
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
     ) -> Project:
         """
-        Get Project
+        Retrieve detailed information about a specific project.
 
         Args:
           extra_headers: Send extra headers
@@ -241,8 +246,10 @@ class ProjectsResource(SyncAPIResource):
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
     ) -> Project:
-        """
-        Update 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.
@@ -309,12 +316,13 @@ class AsyncProjectsResource(AsyncAPIResource):
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
     ) -> Project:
-        """Create project
+        """Create a new project for a client.
 
-        Args:
-          name: Unique project name for a client.
+        Project management must be enabled to perform
+        this operation.
 
-        Each client always has one "default" project.
+        Args:
+          name: Unique project name for a client. Each client always has one "default" project.
 
           client_id: ID associated with the client.
 
@@ -363,8 +371,10 @@ class AsyncProjectsResource(AsyncAPIResource):
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
     ) -> AsyncPaginator[Project, AsyncOffsetPage[Project]]:
-        """
-        List projects
+        """Retrieve a list of projects for a client.
+
+        Results can be filtered by name and
+        ordered by various fields.
 
         Args:
           client_id: Client ID filter for administrators.
@@ -421,9 +431,11 @@ class AsyncProjectsResource(AsyncAPIResource):
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
     ) -> TaskIDList:
-        """
-        All cloud resources in all regions that belong to the project will be deleted
-        and will not be recoverable
+        """Delete a project and all its associated cloud resources across all regions.
+
+        This
+        operation is irreversible and cannot be undone. Default projects cannot be
+        deleted.
 
         Args:
           extra_headers: Send extra headers
@@ -456,7 +468,7 @@ class AsyncProjectsResource(AsyncAPIResource):
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
     ) -> Project:
         """
-        Get Project
+        Retrieve detailed information about a specific project.
 
         Args:
           extra_headers: Send extra headers
@@ -490,8 +502,10 @@ class AsyncProjectsResource(AsyncAPIResource):
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
     ) -> Project:
-        """
-        Update 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.

gcore/resources/cloud/quotas/quotas.py

@@ -63,7 +63,7 @@ class QuotasResource(SyncAPIResource):
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
     ) -> QuotaGetAllResponse:
-        """Get combined client quotas, regional and global."""
+        """Get combined client quotas, including both regional and global quotas."""
         return self._get(
             "/cloud/v2/client_quotas",
             options=make_request_options(
@@ -85,7 +85,7 @@ class QuotasResource(SyncAPIResource):
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
     ) -> QuotaGetByRegionResponse:
         """
-        Get a quota by region
+        Get quotas for a specific region and client.
 
         Args:
           client_id: Client ID
@@ -122,7 +122,7 @@ class QuotasResource(SyncAPIResource):
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
     ) -> QuotaGetGlobalResponse:
         """
-        Get global quota
+        Get global quotas for a specific client.
 
         Args:
           client_id: Client ID
@@ -178,7 +178,7 @@ class AsyncQuotasResource(AsyncAPIResource):
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
     ) -> QuotaGetAllResponse:
-        """Get combined client quotas, regional and global."""
+        """Get combined client quotas, including both regional and global quotas."""
         return await self._get(
             "/cloud/v2/client_quotas",
             options=make_request_options(
@@ -200,7 +200,7 @@ class AsyncQuotasResource(AsyncAPIResource):
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
     ) -> QuotaGetByRegionResponse:
         """
-        Get a quota by region
+        Get quotas for a specific region and client.
 
         Args:
           client_id: Client ID
@@ -237,7 +237,7 @@ class AsyncQuotasResource(AsyncAPIResource):
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
     ) -> QuotaGetGlobalResponse:
         """
-        Get global quota
+        Get global quotas for a specific client.
 
         Args:
           client_id: Client ID

gcore/resources/cloud/quotas/requests.py

@@ -60,7 +60,7 @@ class RequestsResource(SyncAPIResource):
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
     ) -> None:
         """
-        Create request to change quotas
+        Create a request to change current quotas.
 
         Args:
           description: Describe the reason, in general terms.
@@ -108,7 +108,7 @@ class RequestsResource(SyncAPIResource):
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
     ) -> SyncOffsetPage[RequestListResponse]:
         """
-        Returns a list of sent requests to change current quotas and their statuses
+        Get a list of sent requests to change current quotas and their statuses.
 
         Args:
           limit: Optional. Limit the number of returned items
@@ -158,7 +158,7 @@ class RequestsResource(SyncAPIResource):
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
     ) -> None:
         """
-        Delete request to change quotas
+        Delete a specific quota limit request.
 
         Args:
           request_id: LimitRequest ID
@@ -194,7 +194,7 @@ class RequestsResource(SyncAPIResource):
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
     ) -> RequestGetResponse:
         """
-        Get request to change quota limits.
+        Get detailed information about a specific quota limit request.
 
         Args:
           request_id: LimitRequest ID
@@ -252,7 +252,7 @@ class AsyncRequestsResource(AsyncAPIResource):
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
     ) -> None:
         """
-        Create request to change quotas
+        Create a request to change current quotas.
 
         Args:
           description: Describe the reason, in general terms.
@@ -300,7 +300,7 @@ class AsyncRequestsResource(AsyncAPIResource):
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
     ) -> AsyncPaginator[RequestListResponse, AsyncOffsetPage[RequestListResponse]]:
         """
-        Returns a list of sent requests to change current quotas and their statuses
+        Get a list of sent requests to change current quotas and their statuses.
 
         Args:
           limit: Optional. Limit the number of returned items
@@ -350,7 +350,7 @@ class AsyncRequestsResource(AsyncAPIResource):
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
     ) -> None:
         """
-        Delete request to change quotas
+        Delete a specific quota limit request.
 
         Args:
           request_id: LimitRequest ID
@@ -386,7 +386,7 @@ class AsyncRequestsResource(AsyncAPIResource):
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
     ) -> RequestGetResponse:
         """
-        Get request to change quota limits.
+        Get detailed information about a specific quota limit request.
 
         Args:
           request_id: LimitRequest ID

gcore/resources/cloud/registries/artifacts.py

@@ -54,7 +54,7 @@ class ArtifactsResource(SyncAPIResource):
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
     ) -> RegistryArtifactList:
         """
-        List artifacts
+        List all artifacts in a specific repository.
 
         Args:
           extra_headers: Send extra headers
@@ -95,7 +95,7 @@ class ArtifactsResource(SyncAPIResource):
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
     ) -> None:
         """
-        Delete an artifact
+        Delete a specific artifact from a repository.
 
         Args:
           extra_headers: Send extra headers
@@ -159,7 +159,7 @@ class AsyncArtifactsResource(AsyncAPIResource):
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
     ) -> RegistryArtifactList:
         """
-        List artifacts
+        List all artifacts in a specific repository.
 
         Args:
           extra_headers: Send extra headers
@@ -200,7 +200,7 @@ class AsyncArtifactsResource(AsyncAPIResource):
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
     ) -> None:
         """
-        Delete an artifact
+        Delete a specific artifact from a repository.
 
         Args:
           extra_headers: Send extra headers

gcore/resources/cloud/registries/registries.py

@@ -104,12 +104,11 @@ class RegistriesResource(SyncAPIResource):
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
     ) -> Registry:
-        """Create a registry
+        """
+        Create a new container registry with the specified configuration.
 
         Args:
-          name: A name for the container registry.
-
-        Should be in lowercase, consisting only of
+          name: A name for the container registry. Should be in lowercase, consisting only of
               numbers, letters and -, with maximum length of 24 characters
 
           storage_limit: Registry storage limit, GiB
@@ -154,7 +153,7 @@ class RegistriesResource(SyncAPIResource):
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
     ) -> RegistryList:
         """
-        Get registry list
+        List all container registries in the specified project and region.
 
         Args:
           extra_headers: Send extra headers
@@ -191,7 +190,7 @@ class RegistriesResource(SyncAPIResource):
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
     ) -> None:
         """
-        Delete a registry
+        Delete a specific container registry and all its associated resources.
 
         Args:
           extra_headers: Send extra headers
@@ -229,7 +228,7 @@ class RegistriesResource(SyncAPIResource):
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
     ) -> Registry:
         """
-        Get a registry
+        Get detailed information about a specific container registry.
 
         Args:
           extra_headers: Send extra headers
@@ -267,7 +266,7 @@ class RegistriesResource(SyncAPIResource):
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
     ) -> Registry:
         """
-        Resize a registry
+        Update the size of a container registry.
 
         Args:
           storage_limit: Registry storage limit, GiB
@@ -344,12 +343,11 @@ class AsyncRegistriesResource(AsyncAPIResource):
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
     ) -> Registry:
-        """Create a registry
+        """
+        Create a new container registry with the specified configuration.
 
         Args:
-          name: A name for the container registry.
-
-        Should be in lowercase, consisting only of
+          name: A name for the container registry. Should be in lowercase, consisting only of
               numbers, letters and -, with maximum length of 24 characters
 
           storage_limit: Registry storage limit, GiB
@@ -394,7 +392,7 @@ class AsyncRegistriesResource(AsyncAPIResource):
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
     ) -> RegistryList:
         """
-        Get registry list
+        List all container registries in the specified project and region.
 
         Args:
           extra_headers: Send extra headers
@@ -431,7 +429,7 @@ class AsyncRegistriesResource(AsyncAPIResource):
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
     ) -> None:
         """
-        Delete a registry
+        Delete a specific container registry and all its associated resources.
 
         Args:
           extra_headers: Send extra headers
@@ -469,7 +467,7 @@ class AsyncRegistriesResource(AsyncAPIResource):
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
     ) -> Registry:
         """
-        Get a registry
+        Get detailed information about a specific container registry.
 
         Args:
           extra_headers: Send extra headers
@@ -507,7 +505,7 @@ class AsyncRegistriesResource(AsyncAPIResource):
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
     ) -> Registry:
         """
-        Resize a registry
+        Update the size of a container registry.
 
         Args:
           storage_limit: Registry storage limit, GiB

gcore/resources/cloud/registries/repositories.py

@@ -53,7 +53,7 @@ class RepositoriesResource(SyncAPIResource):
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
     ) -> RegistryRepositoryList:
         """
-        List repositories
+        List all repositories in the container registry.
 
         Args:
           extra_headers: Send extra headers
@@ -91,7 +91,7 @@ class RepositoriesResource(SyncAPIResource):
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
     ) -> None:
         """
-        Delete a repository
+        Delete a specific repository from the container registry.
 
         Args:
           extra_headers: Send extra headers
@@ -152,7 +152,7 @@ class AsyncRepositoriesResource(AsyncAPIResource):
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
     ) -> RegistryRepositoryList:
         """
-        List repositories
+        List all repositories in the container registry.
 
         Args:
           extra_headers: Send extra headers
@@ -190,7 +190,7 @@ class AsyncRepositoriesResource(AsyncAPIResource):
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
     ) -> None:
         """
-        Delete a repository
+        Delete a specific repository from the container registry.
 
         Args:
           extra_headers: Send extra headers

gcore/resources/cloud/registries/tags.py

@@ -55,7 +55,7 @@ class TagsResource(SyncAPIResource):
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
     ) -> None:
         """
-        Delete a tag
+        Delete a specific tag from an artifact.
 
         Args:
           extra_headers: Send extra headers
@@ -123,7 +123,7 @@ class AsyncTagsResource(AsyncAPIResource):
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
     ) -> None:
         """
-        Delete a tag
+        Delete a specific tag from an artifact.
 
         Args:
           extra_headers: Send extra headers