Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion .release-please-manifest.json
Original file line number Diff line number Diff line change
@@ -1,3 +1,3 @@
{
".": "0.29.0"
".": "0.30.0"
}
2 changes: 1 addition & 1 deletion .stats.yml
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
configured_endpoints: 645
openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/gcore%2Fgcore-3fc43b72b82321f8d4ceea9ea44d7ab14e75872dbe66e3e698e1f59ba300ec55.yml
openapi_spec_hash: 1b1043a0ef7bcf106abf14f9187f5755
config_hash: 7085751e6bd8f3fd13cfebe04bb99fed
config_hash: da497b83ee3cacf93b7f67fc7d5b1164
16 changes: 16 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,21 @@
# Changelog

## 0.30.0 (2026-01-20)

Full Changelog: [v0.29.0...v0.30.0](https://github.com/G-Core/gcore-python/compare/v0.29.0...v0.30.0)

### ⚠ BREAKING CHANGES

* **cloud:** use create and update v2 endpoints for security groups
* **cloud:** use v2 endpoint for floating IPs updates

### Features

* **cloud:** add create_and_poll and update_and_poll methods for security groups ([a0f8a75](https://github.com/G-Core/gcore-python/commit/a0f8a759796951e084b318e91a95ba413fa3b349))
* **cloud:** add update_and_poll method for floating IPs ([26bfe18](https://github.com/G-Core/gcore-python/commit/26bfe184ecda853f88b7ba13f4eb4f2153237a7b))
* **cloud:** use create and update v2 endpoints for security groups ([31501d3](https://github.com/G-Core/gcore-python/commit/31501d36608339851da4b8982bb32bf18a7518cb))
* **cloud:** use v2 endpoint for floating IPs updates ([31ef098](https://github.com/G-Core/gcore-python/commit/31ef0984768bca7f1aa8b2fa5eb8249fca7af36f))

## 0.29.0 (2026-01-19)

Full Changelog: [v0.28.0...v0.29.0](https://github.com/G-Core/gcore-python/compare/v0.28.0...v0.29.0)
Expand Down
6 changes: 3 additions & 3 deletions api.md
Original file line number Diff line number Diff line change
Expand Up @@ -414,7 +414,7 @@ from gcore.types.cloud import FloatingIPDetailed
Methods:

- <code title="post /cloud/v1/floatingips/{project_id}/{region_id}">client.cloud.floating_ips.<a href="./src/gcore/resources/cloud/floating_ips.py">create</a>(\*, project_id, region_id, \*\*<a href="src/gcore/types/cloud/floating_ip_create_params.py">params</a>) -> <a href="./src/gcore/types/cloud/task_id_list.py">TaskIDList</a></code>
- <code title="patch /cloud/v1/floatingips/{project_id}/{region_id}/{floating_ip_id}">client.cloud.floating_ips.<a href="./src/gcore/resources/cloud/floating_ips.py">update</a>(floating_ip_id, \*, project_id, region_id, \*\*<a href="src/gcore/types/cloud/floating_ip_update_params.py">params</a>) -> <a href="./src/gcore/types/cloud/floating_ip.py">FloatingIP</a></code>
- <code title="patch /cloud/v2/floatingips/{project_id}/{region_id}/{floating_ip_id}">client.cloud.floating_ips.<a href="./src/gcore/resources/cloud/floating_ips.py">update</a>(floating_ip_id, \*, project_id, region_id, \*\*<a href="src/gcore/types/cloud/floating_ip_update_params.py">params</a>) -> <a href="./src/gcore/types/cloud/task_id_list.py">TaskIDList</a></code>
- <code title="get /cloud/v1/floatingips/{project_id}/{region_id}">client.cloud.floating_ips.<a href="./src/gcore/resources/cloud/floating_ips.py">list</a>(\*, project_id, region_id, \*\*<a href="src/gcore/types/cloud/floating_ip_list_params.py">params</a>) -> <a href="./src/gcore/types/cloud/floating_ip_detailed.py">SyncOffsetPage[FloatingIPDetailed]</a></code>
- <code title="delete /cloud/v1/floatingips/{project_id}/{region_id}/{floating_ip_id}">client.cloud.floating_ips.<a href="./src/gcore/resources/cloud/floating_ips.py">delete</a>(floating_ip_id, \*, project_id, region_id) -> <a href="./src/gcore/types/cloud/task_id_list.py">TaskIDList</a></code>
- <code title="post /cloud/v1/floatingips/{project_id}/{region_id}/{floating_ip_id}/assign">client.cloud.floating_ips.<a href="./src/gcore/resources/cloud/floating_ips.py">assign</a>(floating_ip_id, \*, project_id, region_id, \*\*<a href="src/gcore/types/cloud/floating_ip_assign_params.py">params</a>) -> <a href="./src/gcore/types/cloud/floating_ip.py">FloatingIP</a></code>
Expand All @@ -431,8 +431,8 @@ from gcore.types.cloud import SecurityGroup, SecurityGroupRule

Methods:

- <code title="post /cloud/v1/securitygroups/{project_id}/{region_id}">client.cloud.security_groups.<a href="./src/gcore/resources/cloud/security_groups/security_groups.py">create</a>(\*, project_id, region_id, \*\*<a href="src/gcore/types/cloud/security_group_create_params.py">params</a>) -> <a href="./src/gcore/types/cloud/security_group.py">SecurityGroup</a></code>
- <code title="patch /cloud/v1/securitygroups/{project_id}/{region_id}/{group_id}">client.cloud.security_groups.<a href="./src/gcore/resources/cloud/security_groups/security_groups.py">update</a>(group_id, \*, project_id, region_id, \*\*<a href="src/gcore/types/cloud/security_group_update_params.py">params</a>) -> <a href="./src/gcore/types/cloud/security_group.py">SecurityGroup</a></code>
- <code title="post /cloud/v2/security_groups/{project_id}/{region_id}">client.cloud.security_groups.<a href="./src/gcore/resources/cloud/security_groups/security_groups.py">create</a>(\*, project_id, region_id, \*\*<a href="src/gcore/types/cloud/security_group_create_params.py">params</a>) -> <a href="./src/gcore/types/cloud/task_id_list.py">TaskIDList</a></code>
- <code title="patch /cloud/v2/security_groups/{project_id}/{region_id}/{group_id}">client.cloud.security_groups.<a href="./src/gcore/resources/cloud/security_groups/security_groups.py">update</a>(group_id, \*, project_id, region_id, \*\*<a href="src/gcore/types/cloud/security_group_update_params.py">params</a>) -> <a href="./src/gcore/types/cloud/task_id_list.py">TaskIDList</a></code>
- <code title="get /cloud/v1/securitygroups/{project_id}/{region_id}">client.cloud.security_groups.<a href="./src/gcore/resources/cloud/security_groups/security_groups.py">list</a>(\*, project_id, region_id, \*\*<a href="src/gcore/types/cloud/security_group_list_params.py">params</a>) -> <a href="./src/gcore/types/cloud/security_group.py">SyncOffsetPage[SecurityGroup]</a></code>
- <code title="delete /cloud/v1/securitygroups/{project_id}/{region_id}/{group_id}">client.cloud.security_groups.<a href="./src/gcore/resources/cloud/security_groups/security_groups.py">delete</a>(group_id, \*, project_id, region_id) -> None</code>
- <code title="post /cloud/v1/securitygroups/{project_id}/{region_id}/{group_id}/copy">client.cloud.security_groups.<a href="./src/gcore/resources/cloud/security_groups/security_groups.py">copy</a>(group_id, \*, project_id, region_id, \*\*<a href="src/gcore/types/cloud/security_group_copy_params.py">params</a>) -> <a href="./src/gcore/types/cloud/security_group.py">SecurityGroup</a></code>
Expand Down
20 changes: 17 additions & 3 deletions examples/cloud/floating_ips.py
Original file line number Diff line number Diff line change
Expand Up @@ -26,14 +26,15 @@ def main() -> None:
floating_ip_id = create_floating_ip(client=gcore)
list_floating_ips(client=gcore)
get_floating_ip(client=gcore, floating_ip_id=floating_ip_id)
update_tags_floating_ip(client=gcore, floating_ip_id=floating_ip_id)
assign_floating_ip(client=gcore, floating_ip_id=floating_ip_id, port_id=cloud_port_id)
unassign_floating_ip(client=gcore, floating_ip_id=floating_ip_id)
delete_floating_ip(client=gcore, floating_ip_id=floating_ip_id)


def create_floating_ip(*, client: Gcore) -> str:
print("\n=== CREATE FLOATING IP ===")
floating_ip = client.cloud.floating_ips.create_and_poll(tags={"name": "gcore-go-example"})
floating_ip = client.cloud.floating_ips.create_and_poll(tags={"name": "gcore-gython-example"})
print(f"Created Floating IP: ID={floating_ip.id}")
print("========================")
return floating_ip.id
Expand All @@ -58,9 +59,19 @@ def get_floating_ip(*, client: Gcore, floating_ip_id: str) -> None:
print("========================")


def update_tags_floating_ip(*, client: Gcore, floating_ip_id: str) -> None:
print("\n=== UPDATE TAGS FLOATING IP ===")
floating_ip = client.cloud.floating_ips.update_and_poll(
floating_ip_id=floating_ip_id,
tags={"environment": "production", "team": "backend"},
)
print(f"Updated floating IP tags: ID={floating_ip.id}, tags={floating_ip.tags}")
print("========================")


def assign_floating_ip(*, client: Gcore, floating_ip_id: str, port_id: str) -> None:
print("\n=== ASSIGN FLOATING IP ===")
floating_ip = client.cloud.floating_ips.assign( # pyright: ignore[reportDeprecated]
floating_ip = client.cloud.floating_ips.update_and_poll(
floating_ip_id=floating_ip_id,
port_id=port_id,
)
Expand All @@ -70,7 +81,10 @@ def assign_floating_ip(*, client: Gcore, floating_ip_id: str, port_id: str) -> N

def unassign_floating_ip(*, client: Gcore, floating_ip_id: str) -> None:
print("\n=== UNASSIGN FLOATING IP ===")
floating_ip = client.cloud.floating_ips.unassign(floating_ip_id=floating_ip_id) # pyright: ignore[reportDeprecated]
floating_ip = client.cloud.floating_ips.update_and_poll(
floating_ip_id=floating_ip_id,
port_id=None,
)
print(f"Unassigned floating IP: ID={floating_ip.id}")
print("========================")

Expand Down
20 changes: 17 additions & 3 deletions examples/cloud/floating_ips_async.py
Original file line number Diff line number Diff line change
Expand Up @@ -27,14 +27,15 @@ async def main() -> None:
floating_ip_id = await create_floating_ip(client=gcore)
await list_floating_ips(client=gcore)
await get_floating_ip(client=gcore, floating_ip_id=floating_ip_id)
await update_tags_floating_ip(client=gcore, floating_ip_id=floating_ip_id)
await assign_floating_ip(client=gcore, floating_ip_id=floating_ip_id, port_id=cloud_port_id)
await unassign_floating_ip(client=gcore, floating_ip_id=floating_ip_id)
await delete_floating_ip(client=gcore, floating_ip_id=floating_ip_id)


async def create_floating_ip(*, client: AsyncGcore) -> str:
print("\n=== CREATE FLOATING IP ===")
floating_ip = await client.cloud.floating_ips.create_and_poll(tags={"name": "gcore-go-example"})
floating_ip = await client.cloud.floating_ips.create_and_poll(tags={"name": "gcore-python-example"})
print(f"Created floating IP: ID={floating_ip.id}")
print("========================")
return floating_ip.id
Expand All @@ -58,9 +59,19 @@ async def get_floating_ip(*, client: AsyncGcore, floating_ip_id: str) -> None:
print("========================")


async def update_tags_floating_ip(*, client: AsyncGcore, floating_ip_id: str) -> None:
print("\n=== UPDATE TAGS FLOATING IP ===")
floating_ip = await client.cloud.floating_ips.update_and_poll(
floating_ip_id=floating_ip_id,
tags={"environment": "production", "team": "backend"},
)
print(f"Updated floating IP tags: ID={floating_ip.id}, tags={floating_ip.tags}")
print("========================")


async def assign_floating_ip(*, client: AsyncGcore, floating_ip_id: str, port_id: str) -> None:
print("\n=== ASSIGN FLOATING IP ===")
floating_ip = await client.cloud.floating_ips.assign( # pyright: ignore[reportDeprecated]
floating_ip = await client.cloud.floating_ips.update_and_poll(
floating_ip_id=floating_ip_id,
port_id=port_id,
)
Expand All @@ -70,7 +81,10 @@ async def assign_floating_ip(*, client: AsyncGcore, floating_ip_id: str, port_id

async def unassign_floating_ip(*, client: AsyncGcore, floating_ip_id: str) -> None:
print("\n=== UNASSIGN FLOATING IP ===")
floating_ip = await client.cloud.floating_ips.unassign(floating_ip_id=floating_ip_id) # pyright: ignore[reportDeprecated]
floating_ip = await client.cloud.floating_ips.update_and_poll(
floating_ip_id=floating_ip_id,
port_id=None,
)
print(f"Unassigned floating IP: ID={floating_ip.id}")
print("========================")

Expand Down
21 changes: 17 additions & 4 deletions examples/cloud/security_groups.py
Original file line number Diff line number Diff line change
@@ -1,5 +1,4 @@
from gcore import Gcore
from gcore.types.cloud.security_group_create_params import SecurityGroup


def main() -> None:
Expand All @@ -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
Expand All @@ -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
Expand All @@ -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("========================")
Expand Down
24 changes: 18 additions & 6 deletions examples/cloud/security_groups_async.py
Original file line number Diff line number Diff line change
@@ -1,7 +1,6 @@
import asyncio

from gcore import AsyncGcore
from gcore.types.cloud.security_group_create_params import SecurityGroup


async def main() -> None:
Expand All @@ -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
Expand All @@ -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("========================")
Expand All @@ -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("========================")
Expand Down
2 changes: 1 addition & 1 deletion pyproject.toml
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
[project]
name = "gcore"
version = "0.29.0"
version = "0.30.0"
description = "The official Python library for the gcore API"
dynamic = ["readme"]
license = "Apache-2.0"
Expand Down
2 changes: 1 addition & 1 deletion src/gcore/_version.py
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.

__title__ = "gcore"
__version__ = "0.29.0" # x-release-please-version
__version__ = "0.30.0" # x-release-please-version
Loading
Loading