feat(cloud): add create_and_poll and update_and_poll methods for security groups

Adds new `create_and_poll` and `update_and_poll` methods to both sync and async
SecurityGroupsResource classes that combine creating/updating a security group with
task polling. This follows the same pattern as existing polling methods in other
resources.

The methods:
- Accept all parameters from the `create`/`update` methods plus polling parameters
- Handle idempotent updates where no task is created
- Poll the task if one is returned
- Return the created/updated SecurityGroup object

Updates the security groups examples to demonstrate:
- Using create_and_poll to create security groups with tags
- Using update_and_poll to update tags
- Using update_and_poll to update security group properties

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>

---------

Co-authored-by: stainless-app[bot] <142633134+stainless-app[bot]@users.noreply.github.com>
Co-authored-by: Claude Sonnet 4.5 <noreply@anthropic.com>

Author: 3 people

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 645
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/gcore%2Fgcore-deca3f038598c9e7614c191a88510b5e50b6a1e482ddeb6e33ce3a226dc05c39.yml
-openapi_spec_hash: 2ee17c1f251ec32cf95b91fb2e643657
-config_hash: e9e5b750687e9071d8b606963f0ffd6d
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/gcore%2Fgcore-3fc43b72b82321f8d4ceea9ea44d7ab14e75872dbe66e3e698e1f59ba300ec55.yml
+openapi_spec_hash: 1b1043a0ef7bcf106abf14f9187f5755
+config_hash: 87d6d4b4ff43a53e634d01c4ba23b393

examples/cloud/security_groups.py

@@ -1,5 +1,4 @@
 from gcore import Gcore
-from gcore.types.cloud.security_group_create_params import SecurityGroup
 
 
 def main() -> None:
@@ -20,6 +19,7 @@ def main() -> None:
     security_group_id = create_security_group(client=gcore)
     list_security_groups(client=gcore)
     get_security_group(client=gcore, security_group_id=security_group_id)
+    update_tags_security_group(client=gcore, security_group_id=security_group_id)
     update_security_group(client=gcore, security_group_id=security_group_id)
 
     # Rules
@@ -32,7 +32,10 @@ def main() -> None:
 
 def create_security_group(*, client: Gcore) -> str:
     print("\n=== CREATE SECURITY GROUP ===")
-    security_group = client.cloud.security_groups.create(security_group=SecurityGroup(name="gcore-go-example"))  # pyright: ignore[reportDeprecated]
+    security_group = client.cloud.security_groups.create_and_poll(
+        name="gcore-python-example",
+        tags={"environment": "development"},
+    )
     print(f"Created security group: ID={security_group.id}, name={security_group.name}")
     print("========================")
     return security_group.id
@@ -55,11 +58,21 @@ def get_security_group(*, client: Gcore, security_group_id: str) -> None:
     print("========================")
 
 
+def update_tags_security_group(*, client: Gcore, security_group_id: str) -> None:
+    print("\n=== UPDATE TAGS SECURITY GROUP ===")
+    security_group = client.cloud.security_groups.update_and_poll(
+        group_id=security_group_id,
+        tags={"environment": "production", "team": "backend"},
+    )
+    print(f"Updated security group tags: ID={security_group.id}, tags={security_group.tags_v2}")
+    print("========================")
+
+
 def update_security_group(*, client: Gcore, security_group_id: str) -> None:
     print("\n=== UPDATE SECURITY GROUP ===")
-    security_group = client.cloud.security_groups.update(  # pyright: ignore[reportDeprecated]
+    security_group = client.cloud.security_groups.update_and_poll(
         group_id=security_group_id,
-        name="gcore-go-example-updated",
+        name="gcore-python-example-updated",
     )
     print(f"Updated security group: ID={security_group.id}, name={security_group.name}")
     print("========================")

examples/cloud/security_groups_async.py

@@ -1,7 +1,6 @@
 import asyncio
 
 from gcore import AsyncGcore
-from gcore.types.cloud.security_group_create_params import SecurityGroup
 
 
 async def main() -> None:
@@ -22,6 +21,7 @@ async def main() -> None:
     security_group_id = await create_security_group(client=gcore)
     await list_security_groups(client=gcore)
     await get_security_group(client=gcore, security_group_id=security_group_id)
+    await update_tags_security_group(client=gcore, security_group_id=security_group_id)
     await update_security_group(client=gcore, security_group_id=security_group_id)
 
     # Rules
@@ -34,17 +34,19 @@ async def main() -> None:
 
 async def create_security_group(client: AsyncGcore) -> str:
     print("\n=== CREATE SECURITY GROUP ===")
-    security_group = await client.cloud.security_groups.create(security_group=SecurityGroup(name="gcore-go-example"))  # pyright: ignore[reportDeprecated]
+    security_group = await client.cloud.security_groups.create_and_poll(
+        name="gcore-python-example",
+        tags={"environment": "development"},
+    )
     print(f"Created security group: ID={security_group.id}, name={security_group.name}")
     print("========================")
     return security_group.id
 
 
 async def list_security_groups(*, client: AsyncGcore) -> None:
     print("\n=== LIST SECURITY GROUPS ===")
-    security_groups = await client.cloud.security_groups.list()
     count = 0
-    async for security_group in security_groups:
+    async for security_group in client.cloud.security_groups.list():
         count += 1
         print(f"{count}. Security group: ID={security_group.id}, name={security_group.name}")
     print("========================")
@@ -59,11 +61,21 @@ async def get_security_group(*, client: AsyncGcore, security_group_id: str) -> N
     print("========================")
 
 
+async def update_tags_security_group(*, client: AsyncGcore, security_group_id: str) -> None:
+    print("\n=== UPDATE TAGS SECURITY GROUP ===")
+    security_group = await client.cloud.security_groups.update_and_poll(
+        group_id=security_group_id,
+        tags={"environment": "production", "team": "backend"},
+    )
+    print(f"Updated security group tags: ID={security_group.id}, tags={security_group.tags_v2}")
+    print("========================")
+
+
 async def update_security_group(*, client: AsyncGcore, security_group_id: str) -> None:
     print("\n=== UPDATE SECURITY GROUP ===")
-    security_group = await client.cloud.security_groups.update(  # pyright: ignore[reportDeprecated]
+    security_group = await client.cloud.security_groups.update_and_poll(
         group_id=security_group_id,
-        name="gcore-go-example-updated",
+        name="gcore-python-example-updated",
     )
     print(f"Updated security group: ID={security_group.id}, name={security_group.name}")
     print("========================")