release: 0.21.0

.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-  ".": "0.20.0"
+  ".": "0.21.0"
 }

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 633
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/gcore%2Fgcore-cf3ae8749ead0412e761136b7c81a9ca98dd46ca9ef76c1f700cb1ecc814630d.yml
-openapi_spec_hash: d5b2b66116339bbe16ec0bbff5b6366f
-config_hash: e759f29c457a9e3ac5031e760c36594a
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/gcore%2Fgcore-9377b474dea790cb05261b341252967ecb7791d5aa9b102f2241a8b8826c11ab.yml
+openapi_spec_hash: c6a8c5e78604079deb242a0dd3d48cba
+config_hash: 814c5f622b6b26a5556a87031051c797

CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## 0.21.0 (2025-11-17)
+
+Full Changelog: [v0.20.0...v0.21.0](https://github.com/G-Core/gcore-python/compare/v0.20.0...v0.21.0)
+
+### Features
+
+* **api:** aggregated API specs update ([0d13f58](https://github.com/G-Core/gcore-python/commit/0d13f58d129067316254f9907aebf3057495ca8d))
+
 ## 0.20.0 (2025-11-11)
 
 Full Changelog: [v0.19.0...v0.20.0](https://github.com/G-Core/gcore-python/compare/v0.19.0...v0.20.0)

pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "gcore"
-version = "0.20.0"
+version = "0.21.0"
 description = "The official Python library for the gcore API"
 dynamic = ["readme"]
 license = "Apache-2.0"

src/gcore/_version.py

@@ -1,4 +1,4 @@
 # File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 __title__ = "gcore"
-__version__ = "0.20.0"  # x-release-please-version
+__version__ = "0.21.0"  # x-release-please-version

src/gcore/resources/cdn/resources/resources.py

@@ -154,11 +154,11 @@ def create(
 
           proxy_ssl_ca: ID of the trusted CA certificate used to verify an origin.
 
-              It can be used only with `"`proxy_ssl_enabled`": true`.
+              It can be used only with `"proxy_ssl_enabled": true`.
 
           proxy_ssl_data: ID of the SSL certificate used to verify an origin.
 
-              It can be used only with `"`proxy_ssl_enabled`": true`.
+              It can be used only with `"proxy_ssl_enabled": true`.
 
           proxy_ssl_enabled: Enables or disables SSL certificate validation of the origin server before
               completing any connection.
@@ -288,11 +288,11 @@ def update(
 
           proxy_ssl_ca: ID of the trusted CA certificate used to verify an origin.
 
-              It can be used only with `"`proxy_ssl_enabled`": true`.
+              It can be used only with `"proxy_ssl_enabled": true`.
 
           proxy_ssl_data: ID of the SSL certificate used to verify an origin.
 
-              It can be used only with `"`proxy_ssl_enabled`": true`.
+              It can be used only with `"proxy_ssl_enabled": true`.
 
           proxy_ssl_enabled: Enables or disables SSL certificate validation of the origin server before
               completing any connection.
@@ -731,16 +731,16 @@ def purge(
         Args:
           paths: **Purge by pattern** clears the cache that matches the pattern.
 
-              Use \\** operator, which replaces any number of symbols in your path. It's
-              important to note that wildcard usage (\\**) is permitted only at the end of a
+              Use _ operator, which replaces any number of symbols in your path. It's
+              important to note that wildcard usage (_) is permitted only at the end of a
               pattern.
 
               Query string added to any patterns will be ignored, and purge request will be
               processed as if there weren't any parameters.
 
-              Purge by pattern is recursive. Both /path and /path\\** will result in recursive
+              Purge by pattern is recursive. Both /path and /path* will result in recursive
               purging, meaning all content under the specified path will be affected. As such,
-              using the pattern /path\\** is functionally equivalent to simply using /path.
+              using the pattern /path* is functionally equivalent to simply using /path.
 
           extra_headers: Send extra headers
 
@@ -886,11 +886,11 @@ def replace(
 
           proxy_ssl_ca: ID of the trusted CA certificate used to verify an origin.
 
-              It can be used only with `"`proxy_ssl_enabled`": true`.
+              It can be used only with `"proxy_ssl_enabled": true`.
 
           proxy_ssl_data: ID of the SSL certificate used to verify an origin.
 
-              It can be used only with `"`proxy_ssl_enabled`": true`.
+              It can be used only with `"proxy_ssl_enabled": true`.
 
           proxy_ssl_enabled: Enables or disables SSL certificate validation of the origin server before
               completing any connection.
@@ -1064,11 +1064,11 @@ async def create(
 
           proxy_ssl_ca: ID of the trusted CA certificate used to verify an origin.
 
-              It can be used only with `"`proxy_ssl_enabled`": true`.
+              It can be used only with `"proxy_ssl_enabled": true`.
 
           proxy_ssl_data: ID of the SSL certificate used to verify an origin.
 
-              It can be used only with `"`proxy_ssl_enabled`": true`.
+              It can be used only with `"proxy_ssl_enabled": true`.
 
           proxy_ssl_enabled: Enables or disables SSL certificate validation of the origin server before
               completing any connection.
@@ -1198,11 +1198,11 @@ async def update(
 
           proxy_ssl_ca: ID of the trusted CA certificate used to verify an origin.
 
-              It can be used only with `"`proxy_ssl_enabled`": true`.
+              It can be used only with `"proxy_ssl_enabled": true`.
 
           proxy_ssl_data: ID of the SSL certificate used to verify an origin.
 
-              It can be used only with `"`proxy_ssl_enabled`": true`.
+              It can be used only with `"proxy_ssl_enabled": true`.
 
           proxy_ssl_enabled: Enables or disables SSL certificate validation of the origin server before
               completing any connection.
@@ -1641,16 +1641,16 @@ async def purge(
         Args:
           paths: **Purge by pattern** clears the cache that matches the pattern.
 
-              Use \\** operator, which replaces any number of symbols in your path. It's
-              important to note that wildcard usage (\\**) is permitted only at the end of a
+              Use _ operator, which replaces any number of symbols in your path. It's
+              important to note that wildcard usage (_) is permitted only at the end of a
               pattern.
 
               Query string added to any patterns will be ignored, and purge request will be
               processed as if there weren't any parameters.
 
-              Purge by pattern is recursive. Both /path and /path\\** will result in recursive
+              Purge by pattern is recursive. Both /path and /path* will result in recursive
               purging, meaning all content under the specified path will be affected. As such,
-              using the pattern /path\\** is functionally equivalent to simply using /path.
+              using the pattern /path* is functionally equivalent to simply using /path.
 
           extra_headers: Send extra headers
 
@@ -1796,11 +1796,11 @@ async def replace(
 
           proxy_ssl_ca: ID of the trusted CA certificate used to verify an origin.
 
-              It can be used only with `"`proxy_ssl_enabled`": true`.
+              It can be used only with `"proxy_ssl_enabled": true`.
 
           proxy_ssl_data: ID of the SSL certificate used to verify an origin.
 
-              It can be used only with `"`proxy_ssl_enabled`": true`.
+              It can be used only with `"proxy_ssl_enabled": true`.
 
           proxy_ssl_enabled: Enables or disables SSL certificate validation of the origin server before
               completing any connection.

src/gcore/resources/cloud/audit_logs.py

@@ -156,7 +156,9 @@ def list(
         resource_id: SequenceNotStr[str] | Omit = omit,
         search_field: str | Omit = omit,
         sorting: Literal["asc", "desc"] | Omit = omit,
+        source_user_ips: SequenceNotStr[str] | Omit = omit,
         to_timestamp: Union[str, datetime] | Omit = omit,
+        user_agents: SequenceNotStr[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,
@@ -194,9 +196,15 @@ def list(
           sorting: (DEPRECATED Use '`order_by`' instead) Sorting by timestamp. Oldest first, or
               most recent first
 
+          source_user_ips: Originating IP address of the client making the request. Several options can be
+              specified.
+
           to_timestamp: ISO formatted datetime string. Ending timestamp until which user actions are
               requested
 
+          user_agents: User-Agent string identifying the client making the request. Several options can
+              be specified.
+
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request
@@ -226,7 +234,9 @@ def list(
                         "resource_id": resource_id,
                         "search_field": search_field,
                         "sorting": sorting,
+                        "source_user_ips": source_user_ips,
                         "to_timestamp": to_timestamp,
+                        "user_agents": user_agents,
                     },
                     audit_log_list_params.AuditLogListParams,
                 ),
@@ -365,7 +375,9 @@ def list(
         resource_id: SequenceNotStr[str] | Omit = omit,
         search_field: str | Omit = omit,
         sorting: Literal["asc", "desc"] | Omit = omit,
+        source_user_ips: SequenceNotStr[str] | Omit = omit,
         to_timestamp: Union[str, datetime] | Omit = omit,
+        user_agents: SequenceNotStr[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,
@@ -403,9 +415,15 @@ def list(
           sorting: (DEPRECATED Use '`order_by`' instead) Sorting by timestamp. Oldest first, or
               most recent first
 
+          source_user_ips: Originating IP address of the client making the request. Several options can be
+              specified.
+
           to_timestamp: ISO formatted datetime string. Ending timestamp until which user actions are
               requested
 
+          user_agents: User-Agent string identifying the client making the request. Several options can
+              be specified.
+
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request
@@ -435,7 +453,9 @@ def list(
                         "resource_id": resource_id,
                         "search_field": search_field,
                         "sorting": sorting,
+                        "source_user_ips": source_user_ips,
                         "to_timestamp": to_timestamp,
+                        "user_agents": user_agents,
                     },
                     audit_log_list_params.AuditLogListParams,
                 ),

src/gcore/resources/cloud/baremetal/servers.py

@@ -120,8 +120,8 @@ def create(
           name_template: If you want server names to be automatically generated based on IP addresses,
               you can provide a name template instead of specifying the name manually. The
               template should include a placeholder that will be replaced during provisioning.
-              Supported placeholders are: `{`ip_octets`}` (last 3 octets of the IP),
-              `{`two_ip_octets`}`, and `{`one_ip_octet`}`.
+              Supported placeholders are: `{ip_octets}` (last 3 octets of the IP),
+              `{two_ip_octets}`, and `{one_ip_octet}`.
 
           password: For Linux instances, 'username' and 'password' are used to create a new user.
               When only 'password' is provided, it is set as the password for the default user
@@ -611,8 +611,8 @@ async def create(
           name_template: If you want server names to be automatically generated based on IP addresses,
               you can provide a name template instead of specifying the name manually. The
               template should include a placeholder that will be replaced during provisioning.
-              Supported placeholders are: `{`ip_octets`}` (last 3 octets of the IP),
-              `{`two_ip_octets`}`, and `{`one_ip_octet`}`.
+              Supported placeholders are: `{ip_octets}` (last 3 octets of the IP),
+              `{two_ip_octets}`, and `{one_ip_octet}`.
 
           password: For Linux instances, 'username' and 'password' are used to create a new user.
               When only 'password' is provided, it is set as the password for the default user

src/gcore/resources/cloud/file_shares/file_shares.py

@@ -267,15 +267,20 @@ def update(
               - **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.
 
@@ -790,15 +795,20 @@ async def update(
               - **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.