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

gcore/resources/cloud/secrets.py

@@ -2,10 +2,8 @@
 
 from __future__ import annotations
 
-import typing_extensions
-from typing import Union, Optional
+from typing import Union
 from datetime import datetime
-from typing_extensions import Literal
 
 import httpx
 
@@ -19,11 +17,11 @@ from ..._response import (
     async_to_raw_response_wrapper,
     async_to_streamed_response_wrapper,
 )
-from ...types.cloud import secret_list_params, secret_create_params, secret_upload_tls_certificate_params
-from ..._base_client import make_request_options
+from ...pagination import SyncOffsetPage, AsyncOffsetPage
+from ...types.cloud import secret_list_params, secret_upload_tls_certificate_params
+from ..._base_client import AsyncPaginator, make_request_options
 from ...types.cloud.secret import Secret
 from ...types.cloud.task_id_list import TaskIDList
-from ...types.cloud.secret_list_response import SecretListResponse
 
 __all__ = ["SecretsResource", "AsyncSecretsResource"]
 
@@ -48,101 +46,6 @@ class SecretsResource(SyncAPIResource):
         """
         return SecretsResourceWithStreamingResponse(self)
 
-    @typing_extensions.deprecated("deprecated")
-    def create(
-        self,
-        *,
-        project_id: int | None = None,
-        region_id: int | None = None,
-        name: str,
-        payload: str,
-        payload_content_encoding: Literal["base64"],
-        payload_content_type: str,
-        secret_type: Literal["certificate", "opaque", "passphrase", "private", "public", "symmetric"],
-        algorithm: Optional[str] | NotGiven = NOT_GIVEN,
-        bit_length: Optional[int] | NotGiven = NOT_GIVEN,
-        expiration: Optional[str] | NotGiven = NOT_GIVEN,
-        mode: Optional[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,
-        extra_query: Query | None = None,
-        extra_body: Body | None = None,
-        timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
-    ) -> TaskIDList:
-        """
-        Create secret
-
-        Args:
-          project_id: Project ID
-
-          region_id: Region ID
-
-          name: Secret name
-
-          payload: Secret payload. For HTTPS-terminated load balancing, provide base64 encoded
-              conents of a PKCS12 file. The PKCS12 file is the combined TLS certificate, key,
-              and intermediate certificate chain obtained from an external certificate
-              authority. The file can be created via openssl, e.g.'openssl pkcs12 -export
-              -inkey server.key -in server.crt -certfile ca-chain.crt -passout pass: -out
-              server.p12'The key and certificate should be PEM-encoded, and the intermediate
-              certificate chain should be multiple PEM-encoded certs concatenated together
-
-          payload_content_encoding: The encoding used for the payload to be able to include it in the JSON request.
-              Currently only base64 is supported
-
-          payload_content_type: The media type for the content of the payload
-
-          secret_type: Secret type. symmetric - Used for storing byte arrays such as keys suitable for
-              symmetric encryption; public - Used for storing the public key of an asymmetric
-              keypair; private - Used for storing the private key of an asymmetric keypair;
-              passphrase - Used for storing plain text passphrases; certificate - Used for
-              storing cryptographic certificates such as X.509 certificates; opaque - Used for
-              backwards compatibility with previous versions of the API
-
-          algorithm: Metadata provided by a user or system for informational purposes.
-
-          bit_length: Metadata provided by a user or system for informational purposes. Value must be
-              greater than zero.
-
-          expiration: Datetime when the secret will expire.
-
-          mode: Metadata provided by a user or system for informational purposes.
-
-          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()
-        if region_id is None:
-            region_id = self._client._get_cloud_region_id_path_param()
-        return self._post(
-            f"/cloud/v1/secrets/{project_id}/{region_id}",
-            body=maybe_transform(
-                {
-                    "name": name,
-                    "payload": payload,
-                    "payload_content_encoding": payload_content_encoding,
-                    "payload_content_type": payload_content_type,
-                    "secret_type": secret_type,
-                    "algorithm": algorithm,
-                    "bit_length": bit_length,
-                    "expiration": expiration,
-                    "mode": mode,
-                },
-                secret_create_params.SecretCreateParams,
-            ),
-            options=make_request_options(
-                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
-            ),
-            cast_to=TaskIDList,
-        )
-
     def list(
         self,
         *,
@@ -156,7 +59,7 @@ class SecretsResource(SyncAPIResource):
         extra_query: Query | None = None,
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
-    ) -> SecretListResponse:
+    ) -> SyncOffsetPage[Secret]:
         """
         List secrets
 
@@ -182,8 +85,9 @@ class SecretsResource(SyncAPIResource):
             project_id = self._client._get_cloud_project_id_path_param()
         if region_id is None:
             region_id = self._client._get_cloud_region_id_path_param()
-        return self._get(
+        return self._get_api_list(
             f"/cloud/v1/secrets/{project_id}/{region_id}",
+            page=SyncOffsetPage[Secret],
             options=make_request_options(
                 extra_headers=extra_headers,
                 extra_query=extra_query,
@@ -197,7 +101,7 @@ class SecretsResource(SyncAPIResource):
                     secret_list_params.SecretListParams,
                 ),
             ),
-            cast_to=SecretListResponse,
+            model=Secret,
         )
 
     def delete(
@@ -409,102 +313,7 @@ class AsyncSecretsResource(AsyncAPIResource):
         """
         return AsyncSecretsResourceWithStreamingResponse(self)
 
-    @typing_extensions.deprecated("deprecated")
-    async def create(
-        self,
-        *,
-        project_id: int | None = None,
-        region_id: int | None = None,
-        name: str,
-        payload: str,
-        payload_content_encoding: Literal["base64"],
-        payload_content_type: str,
-        secret_type: Literal["certificate", "opaque", "passphrase", "private", "public", "symmetric"],
-        algorithm: Optional[str] | NotGiven = NOT_GIVEN,
-        bit_length: Optional[int] | NotGiven = NOT_GIVEN,
-        expiration: Optional[str] | NotGiven = NOT_GIVEN,
-        mode: Optional[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,
-        extra_query: Query | None = None,
-        extra_body: Body | None = None,
-        timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
-    ) -> TaskIDList:
-        """
-        Create secret
-
-        Args:
-          project_id: Project ID
-
-          region_id: Region ID
-
-          name: Secret name
-
-          payload: Secret payload. For HTTPS-terminated load balancing, provide base64 encoded
-              conents of a PKCS12 file. The PKCS12 file is the combined TLS certificate, key,
-              and intermediate certificate chain obtained from an external certificate
-              authority. The file can be created via openssl, e.g.'openssl pkcs12 -export
-              -inkey server.key -in server.crt -certfile ca-chain.crt -passout pass: -out
-              server.p12'The key and certificate should be PEM-encoded, and the intermediate
-              certificate chain should be multiple PEM-encoded certs concatenated together
-
-          payload_content_encoding: The encoding used for the payload to be able to include it in the JSON request.
-              Currently only base64 is supported
-
-          payload_content_type: The media type for the content of the payload
-
-          secret_type: Secret type. symmetric - Used for storing byte arrays such as keys suitable for
-              symmetric encryption; public - Used for storing the public key of an asymmetric
-              keypair; private - Used for storing the private key of an asymmetric keypair;
-              passphrase - Used for storing plain text passphrases; certificate - Used for
-              storing cryptographic certificates such as X.509 certificates; opaque - Used for
-              backwards compatibility with previous versions of the API
-
-          algorithm: Metadata provided by a user or system for informational purposes.
-
-          bit_length: Metadata provided by a user or system for informational purposes. Value must be
-              greater than zero.
-
-          expiration: Datetime when the secret will expire.
-
-          mode: Metadata provided by a user or system for informational purposes.
-
-          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()
-        if region_id is None:
-            region_id = self._client._get_cloud_region_id_path_param()
-        return await self._post(
-            f"/cloud/v1/secrets/{project_id}/{region_id}",
-            body=await async_maybe_transform(
-                {
-                    "name": name,
-                    "payload": payload,
-                    "payload_content_encoding": payload_content_encoding,
-                    "payload_content_type": payload_content_type,
-                    "secret_type": secret_type,
-                    "algorithm": algorithm,
-                    "bit_length": bit_length,
-                    "expiration": expiration,
-                    "mode": mode,
-                },
-                secret_create_params.SecretCreateParams,
-            ),
-            options=make_request_options(
-                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
-            ),
-            cast_to=TaskIDList,
-        )
-
-    async def list(
+    def list(
         self,
         *,
         project_id: int | None = None,
@@ -517,7 +326,7 @@ class AsyncSecretsResource(AsyncAPIResource):
         extra_query: Query | None = None,
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
-    ) -> SecretListResponse:
+    ) -> AsyncPaginator[Secret, AsyncOffsetPage[Secret]]:
         """
         List secrets
 
@@ -543,14 +352,15 @@ class AsyncSecretsResource(AsyncAPIResource):
             project_id = self._client._get_cloud_project_id_path_param()
         if region_id is None:
             region_id = self._client._get_cloud_region_id_path_param()
-        return await self._get(
+        return self._get_api_list(
             f"/cloud/v1/secrets/{project_id}/{region_id}",
+            page=AsyncOffsetPage[Secret],
             options=make_request_options(
                 extra_headers=extra_headers,
                 extra_query=extra_query,
                 extra_body=extra_body,
                 timeout=timeout,
-                query=await async_maybe_transform(
+                query=maybe_transform(
                     {
                         "limit": limit,
                         "offset": offset,
@@ -558,7 +368,7 @@ class AsyncSecretsResource(AsyncAPIResource):
                     secret_list_params.SecretListParams,
                 ),
             ),
-            cast_to=SecretListResponse,
+            model=Secret,
         )
 
     async def delete(
@@ -754,11 +564,6 @@ class SecretsResourceWithRawResponse:
     def __init__(self, secrets: SecretsResource) -> None:
         self._secrets = secrets
 
-        self.create = (  # pyright: ignore[reportDeprecated]
-            to_raw_response_wrapper(
-                secrets.create  # pyright: ignore[reportDeprecated],
-            )
-        )
         self.list = to_raw_response_wrapper(
             secrets.list,
         )
@@ -777,11 +582,6 @@ class AsyncSecretsResourceWithRawResponse:
     def __init__(self, secrets: AsyncSecretsResource) -> None:
         self._secrets = secrets
 
-        self.create = (  # pyright: ignore[reportDeprecated]
-            async_to_raw_response_wrapper(
-                secrets.create  # pyright: ignore[reportDeprecated],
-            )
-        )
         self.list = async_to_raw_response_wrapper(
             secrets.list,
         )
@@ -800,11 +600,6 @@ class SecretsResourceWithStreamingResponse:
     def __init__(self, secrets: SecretsResource) -> None:
         self._secrets = secrets
 
-        self.create = (  # pyright: ignore[reportDeprecated]
-            to_streamed_response_wrapper(
-                secrets.create  # pyright: ignore[reportDeprecated],
-            )
-        )
         self.list = to_streamed_response_wrapper(
             secrets.list,
         )
@@ -823,11 +618,6 @@ class AsyncSecretsResourceWithStreamingResponse:
     def __init__(self, secrets: AsyncSecretsResource) -> None:
         self._secrets = secrets
 
-        self.create = (  # pyright: ignore[reportDeprecated]
-            async_to_streamed_response_wrapper(
-                secrets.create  # pyright: ignore[reportDeprecated],
-            )
-        )
         self.list = async_to_streamed_response_wrapper(
             secrets.list,
         )

gcore/resources/cloud/security_groups/rules.py

@@ -92,7 +92,7 @@ class RulesResource(SyncAPIResource):
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
     ) -> SecurityGroupRule:
         """
-        Add new rule to security group
+        Add a new rule to an existing security group.
 
         Args:
           description: Rule description
@@ -160,7 +160,7 @@ class RulesResource(SyncAPIResource):
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
     ) -> None:
         """
-        Delete security group rule
+        Delete a specific rule from a security group.
 
         Args:
           extra_headers: Send extra headers
@@ -235,7 +235,7 @@ class RulesResource(SyncAPIResource):
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
     ) -> SecurityGroupRule:
         """
-        Edit the security group rule: delete old and create new rule
+        Update the configuration of an existing security group rule.
 
         Args:
           direction: Ingress or egress, which is the direction in which the security group rule is
@@ -363,7 +363,7 @@ class AsyncRulesResource(AsyncAPIResource):
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
     ) -> SecurityGroupRule:
         """
-        Add new rule to security group
+        Add a new rule to an existing security group.
 
         Args:
           description: Rule description
@@ -431,7 +431,7 @@ class AsyncRulesResource(AsyncAPIResource):
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
     ) -> None:
         """
-        Delete security group rule
+        Delete a specific rule from a security group.
 
         Args:
           extra_headers: Send extra headers
@@ -506,7 +506,7 @@ class AsyncRulesResource(AsyncAPIResource):
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
     ) -> SecurityGroupRule:
         """
-        Edit the security group rule: delete old and create new rule
+        Update the configuration of an existing security group rule.
 
         Args:
           direction: Ingress or egress, which is the direction in which the security group rule is

gcore/resources/cloud/security_groups/security_groups.py

@@ -2,7 +2,7 @@
 
 from __future__ import annotations
 
-from typing import List, Iterable
+from typing import List, Iterable, Optional
 
 import httpx
 
@@ -33,6 +33,7 @@ from ....types.cloud import (
 )
 from ...._base_client import AsyncPaginator, make_request_options
 from ....types.cloud.security_group import SecurityGroup
+from ....types.cloud.tag_update_map_param import TagUpdateMapParam
 
 __all__ = ["SecurityGroupsResource", "AsyncSecurityGroupsResource"]
 
@@ -76,7 +77,7 @@ class SecurityGroupsResource(SyncAPIResource):
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
     ) -> SecurityGroup:
         """
-        Create security group
+        Create a new security group with the specified configuration.
 
         Args:
           security_group: Security group
@@ -118,6 +119,7 @@ class SecurityGroupsResource(SyncAPIResource):
         region_id: int | None = None,
         changed_rules: Iterable[security_group_update_params.ChangedRule] | NotGiven = NOT_GIVEN,
         name: 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,
@@ -126,13 +128,33 @@ class SecurityGroupsResource(SyncAPIResource):
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
     ) -> SecurityGroup:
         """
-        Change security group
+        Update the configuration of an existing security group.
 
         Args:
           changed_rules: List of rules to create or delete
 
           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
@@ -153,6 +175,7 @@ class SecurityGroupsResource(SyncAPIResource):
                 {
                     "changed_rules": changed_rules,
                     "name": name,
+                    "tags": tags,
                 },
                 security_group_update_params.SecurityGroupUpdateParams,
             ),
@@ -179,18 +202,16 @@ class SecurityGroupsResource(SyncAPIResource):
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
     ) -> SyncOffsetPage[SecurityGroup]:
         """
-        Get security groups
+        List all security groups in the specified project and region.
 
         Args:
-          limit: Limit the number of returned limit request entities.
+          limit: Limit the number of returned security groups
 
-          offset: Offset value is used to exclude the first set of records from the result.
+          offset: Offset value is used to exclude the first set of records from the result
 
           tag_key: Filter by tag keys.
 
-          tag_key_value: Filter by tag key-value pairs. Must be a valid JSON string. curl -G
-              --data-urlencode "`tag_key_value`={"key": "value"}" --url
-              "http://localhost:1111/v1/securitygroups/1/1"
+          tag_key_value: Filter by tag key-value pairs. Must be a valid JSON string.
 
           extra_headers: Send extra headers
 
@@ -239,7 +260,7 @@ class SecurityGroupsResource(SyncAPIResource):
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
     ) -> None:
         """
-        Delete security group
+        Delete a specific security group and all its associated rules.
 
         Args:
           extra_headers: Send extra headers
@@ -278,9 +299,9 @@ class SecurityGroupsResource(SyncAPIResource):
         extra_query: Query | None = None,
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
-    ) -> None:
+    ) -> SecurityGroup:
         """
-        Create a deep copy of security group
+        Create a deep copy of an existing security group.
 
         Args:
           name: Name.
@@ -299,14 +320,13 @@ class SecurityGroupsResource(SyncAPIResource):
             region_id = self._client._get_cloud_region_id_path_param()
         if not group_id:
             raise ValueError(f"Expected a non-empty value for `group_id` but received {group_id!r}")
-        extra_headers = {"Accept": "*/*", **(extra_headers or {})}
         return self._post(
             f"/cloud/v1/securitygroups/{project_id}/{region_id}/{group_id}/copy",
             body=maybe_transform({"name": name}, security_group_copy_params.SecurityGroupCopyParams),
             options=make_request_options(
                 extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
             ),
-            cast_to=NoneType,
+            cast_to=SecurityGroup,
         )
 
     def get(
@@ -323,7 +343,7 @@ class SecurityGroupsResource(SyncAPIResource):
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
     ) -> SecurityGroup:
         """
-        Get security group
+        Get detailed information about a specific security group.
 
         Args:
           extra_headers: Send extra headers
@@ -362,7 +382,7 @@ class SecurityGroupsResource(SyncAPIResource):
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
     ) -> SecurityGroup:
         """
-        Revert security group
+        Revert a security group to its previous state.
 
         Args:
           extra_headers: Send extra headers
@@ -427,7 +447,7 @@ class AsyncSecurityGroupsResource(AsyncAPIResource):
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
     ) -> SecurityGroup:
         """
-        Create security group
+        Create a new security group with the specified configuration.
 
         Args:
           security_group: Security group
@@ -469,6 +489,7 @@ class AsyncSecurityGroupsResource(AsyncAPIResource):
         region_id: int | None = None,
         changed_rules: Iterable[security_group_update_params.ChangedRule] | NotGiven = NOT_GIVEN,
         name: 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,
@@ -477,13 +498,33 @@ class AsyncSecurityGroupsResource(AsyncAPIResource):
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
     ) -> SecurityGroup:
         """
-        Change security group
+        Update the configuration of an existing security group.
 
         Args:
           changed_rules: List of rules to create or delete
 
           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
@@ -504,6 +545,7 @@ class AsyncSecurityGroupsResource(AsyncAPIResource):
                 {
                     "changed_rules": changed_rules,
                     "name": name,
+                    "tags": tags,
                 },
                 security_group_update_params.SecurityGroupUpdateParams,
             ),
@@ -530,18 +572,16 @@ class AsyncSecurityGroupsResource(AsyncAPIResource):
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
     ) -> AsyncPaginator[SecurityGroup, AsyncOffsetPage[SecurityGroup]]:
         """
-        Get security groups
+        List all security groups in the specified project and region.
 
         Args:
-          limit: Limit the number of returned limit request entities.
+          limit: Limit the number of returned security groups
 
-          offset: Offset value is used to exclude the first set of records from the result.
+          offset: Offset value is used to exclude the first set of records from the result
 
           tag_key: Filter by tag keys.
 
-          tag_key_value: Filter by tag key-value pairs. Must be a valid JSON string. curl -G
-              --data-urlencode "`tag_key_value`={"key": "value"}" --url
-              "http://localhost:1111/v1/securitygroups/1/1"
+          tag_key_value: Filter by tag key-value pairs. Must be a valid JSON string.
 
           extra_headers: Send extra headers
 
@@ -590,7 +630,7 @@ class AsyncSecurityGroupsResource(AsyncAPIResource):
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
     ) -> None:
         """
-        Delete security group
+        Delete a specific security group and all its associated rules.
 
         Args:
           extra_headers: Send extra headers
@@ -629,9 +669,9 @@ class AsyncSecurityGroupsResource(AsyncAPIResource):
         extra_query: Query | None = None,
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
-    ) -> None:
+    ) -> SecurityGroup:
         """
-        Create a deep copy of security group
+        Create a deep copy of an existing security group.
 
         Args:
           name: Name.
@@ -650,14 +690,13 @@ class AsyncSecurityGroupsResource(AsyncAPIResource):
             region_id = self._client._get_cloud_region_id_path_param()
         if not group_id:
             raise ValueError(f"Expected a non-empty value for `group_id` but received {group_id!r}")
-        extra_headers = {"Accept": "*/*", **(extra_headers or {})}
         return await self._post(
             f"/cloud/v1/securitygroups/{project_id}/{region_id}/{group_id}/copy",
             body=await async_maybe_transform({"name": name}, security_group_copy_params.SecurityGroupCopyParams),
             options=make_request_options(
                 extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
             ),
-            cast_to=NoneType,
+            cast_to=SecurityGroup,
         )
 
     async def get(
@@ -674,7 +713,7 @@ class AsyncSecurityGroupsResource(AsyncAPIResource):
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
     ) -> SecurityGroup:
         """
-        Get security group
+        Get detailed information about a specific security group.
 
         Args:
           extra_headers: Send extra headers
@@ -713,7 +752,7 @@ class AsyncSecurityGroupsResource(AsyncAPIResource):
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
     ) -> SecurityGroup:
         """
-        Revert security group
+        Revert a security group to its previous state.
 
         Args:
           extra_headers: Send extra headers