release: 0.37.0

.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-  ".": "0.36.0"
+  ".": "0.37.0"
 }

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 647
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/gcore%2Fgcore-2c5466e670c12d50bc7234acc899a0833ffc6282ccb8821ebe0c623fb82ea60d.yml
-openapi_spec_hash: a6f0c3323cf195a153b6c5fd3a0d83d4
-config_hash: ee9fe3677a3591bb2fcc219ef6448eb2
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/gcore%2Fgcore-a2485c442760c3409ac3116226ab78cf6a499cf242c2f1b88dfc85742c44d984.yml
+openapi_spec_hash: 8e7184f8d2144a6747ab5f2d07a7d22c
+config_hash: 7d1bb312a191f5cc98ba5c35759f8f7c

CHANGELOG.md

@@ -1,5 +1,14 @@
 # Changelog
 
+## 0.37.0 (2026-03-04)
+
+Full Changelog: [v0.36.0...v0.37.0](https://github.com/G-Core/gcore-python/compare/v0.36.0...v0.37.0)
+
+### Features
+
+* add descriptions for all Terraform-enabled resources ([d802ff9](https://github.com/G-Core/gcore-python/commit/d802ff9777ba4f84ec0c7119745ba16d4b3415a3))
+* **api:** aggregated API specs update ([471fef6](https://github.com/G-Core/gcore-python/commit/471fef6b01e2dac4a54482d376cdb7613b0bc8da))
+
 ## 0.36.0 (2026-03-03)
 
 Full Changelog: [v0.35.0...v0.36.0](https://github.com/G-Core/gcore-python/compare/v0.35.0...v0.36.0)

pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "gcore"
-version = "0.36.0"
+version = "0.37.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.36.0"  # x-release-please-version
+__version__ = "0.37.0"  # x-release-please-version

src/gcore/resources/cdn/cdn.py

@@ -149,6 +149,9 @@ def shields(self) -> ShieldsResource:
 
     @cached_property
     def origin_groups(self) -> OriginGroupsResource:
+        """
+        CDN origin groups aggregate one or more origin servers with failover and load balancing for content delivery.
+        """
         return OriginGroupsResource(self._client)
 
     @cached_property
@@ -157,10 +160,16 @@ def rule_templates(self) -> RuleTemplatesResource:
 
     @cached_property
     def certificates(self) -> CertificatesResource:
+        """
+        CDN SSL certificates enable HTTPS content delivery, supporting both uploaded certificates and automated Let's Encrypt provisioning.
+        """
         return CertificatesResource(self._client)
 
     @cached_property
     def trusted_ca_certificates(self) -> TrustedCaCertificatesResource:
+        """
+        Trusted CA certificates verify the authenticity of CDN origin servers during HTTPS connections.
+        """
         return TrustedCaCertificatesResource(self._client)
 
     @cached_property
@@ -482,6 +491,9 @@ def shields(self) -> AsyncShieldsResource:
 
     @cached_property
     def origin_groups(self) -> AsyncOriginGroupsResource:
+        """
+        CDN origin groups aggregate one or more origin servers with failover and load balancing for content delivery.
+        """
         return AsyncOriginGroupsResource(self._client)
 
     @cached_property
@@ -490,10 +502,16 @@ def rule_templates(self) -> AsyncRuleTemplatesResource:
 
     @cached_property
     def certificates(self) -> AsyncCertificatesResource:
+        """
+        CDN SSL certificates enable HTTPS content delivery, supporting both uploaded certificates and automated Let's Encrypt provisioning.
+        """
         return AsyncCertificatesResource(self._client)
 
     @cached_property
     def trusted_ca_certificates(self) -> AsyncTrustedCaCertificatesResource:
+        """
+        Trusted CA certificates verify the authenticity of CDN origin servers during HTTPS connections.
+        """
         return AsyncTrustedCaCertificatesResource(self._client)
 
     @cached_property
@@ -840,6 +858,9 @@ def shields(self) -> ShieldsResourceWithRawResponse:
 
     @cached_property
     def origin_groups(self) -> OriginGroupsResourceWithRawResponse:
+        """
+        CDN origin groups aggregate one or more origin servers with failover and load balancing for content delivery.
+        """
         return OriginGroupsResourceWithRawResponse(self._cdn.origin_groups)
 
     @cached_property
@@ -848,10 +869,16 @@ def rule_templates(self) -> RuleTemplatesResourceWithRawResponse:
 
     @cached_property
     def certificates(self) -> CertificatesResourceWithRawResponse:
+        """
+        CDN SSL certificates enable HTTPS content delivery, supporting both uploaded certificates and automated Let's Encrypt provisioning.
+        """
         return CertificatesResourceWithRawResponse(self._cdn.certificates)
 
     @cached_property
     def trusted_ca_certificates(self) -> TrustedCaCertificatesResourceWithRawResponse:
+        """
+        Trusted CA certificates verify the authenticity of CDN origin servers during HTTPS connections.
+        """
         return TrustedCaCertificatesResourceWithRawResponse(self._cdn.trusted_ca_certificates)
 
     @cached_property
@@ -951,6 +978,9 @@ def shields(self) -> AsyncShieldsResourceWithRawResponse:
 
     @cached_property
     def origin_groups(self) -> AsyncOriginGroupsResourceWithRawResponse:
+        """
+        CDN origin groups aggregate one or more origin servers with failover and load balancing for content delivery.
+        """
         return AsyncOriginGroupsResourceWithRawResponse(self._cdn.origin_groups)
 
     @cached_property
@@ -959,10 +989,16 @@ def rule_templates(self) -> AsyncRuleTemplatesResourceWithRawResponse:
 
     @cached_property
     def certificates(self) -> AsyncCertificatesResourceWithRawResponse:
+        """
+        CDN SSL certificates enable HTTPS content delivery, supporting both uploaded certificates and automated Let's Encrypt provisioning.
+        """
         return AsyncCertificatesResourceWithRawResponse(self._cdn.certificates)
 
     @cached_property
     def trusted_ca_certificates(self) -> AsyncTrustedCaCertificatesResourceWithRawResponse:
+        """
+        Trusted CA certificates verify the authenticity of CDN origin servers during HTTPS connections.
+        """
         return AsyncTrustedCaCertificatesResourceWithRawResponse(self._cdn.trusted_ca_certificates)
 
     @cached_property
@@ -1062,6 +1098,9 @@ def shields(self) -> ShieldsResourceWithStreamingResponse:
 
     @cached_property
     def origin_groups(self) -> OriginGroupsResourceWithStreamingResponse:
+        """
+        CDN origin groups aggregate one or more origin servers with failover and load balancing for content delivery.
+        """
         return OriginGroupsResourceWithStreamingResponse(self._cdn.origin_groups)
 
     @cached_property
@@ -1070,10 +1109,16 @@ def rule_templates(self) -> RuleTemplatesResourceWithStreamingResponse:
 
     @cached_property
     def certificates(self) -> CertificatesResourceWithStreamingResponse:
+        """
+        CDN SSL certificates enable HTTPS content delivery, supporting both uploaded certificates and automated Let's Encrypt provisioning.
+        """
         return CertificatesResourceWithStreamingResponse(self._cdn.certificates)
 
     @cached_property
     def trusted_ca_certificates(self) -> TrustedCaCertificatesResourceWithStreamingResponse:
+        """
+        Trusted CA certificates verify the authenticity of CDN origin servers during HTTPS connections.
+        """
         return TrustedCaCertificatesResourceWithStreamingResponse(self._cdn.trusted_ca_certificates)
 
     @cached_property
@@ -1173,6 +1218,9 @@ def shields(self) -> AsyncShieldsResourceWithStreamingResponse:
 
     @cached_property
     def origin_groups(self) -> AsyncOriginGroupsResourceWithStreamingResponse:
+        """
+        CDN origin groups aggregate one or more origin servers with failover and load balancing for content delivery.
+        """
         return AsyncOriginGroupsResourceWithStreamingResponse(self._cdn.origin_groups)
 
     @cached_property
@@ -1181,10 +1229,16 @@ def rule_templates(self) -> AsyncRuleTemplatesResourceWithStreamingResponse:
 
     @cached_property
     def certificates(self) -> AsyncCertificatesResourceWithStreamingResponse:
+        """
+        CDN SSL certificates enable HTTPS content delivery, supporting both uploaded certificates and automated Let's Encrypt provisioning.
+        """
         return AsyncCertificatesResourceWithStreamingResponse(self._cdn.certificates)
 
     @cached_property
     def trusted_ca_certificates(self) -> AsyncTrustedCaCertificatesResourceWithStreamingResponse:
+        """
+        Trusted CA certificates verify the authenticity of CDN origin servers during HTTPS connections.
+        """
         return AsyncTrustedCaCertificatesResourceWithStreamingResponse(self._cdn.trusted_ca_certificates)
 
     @cached_property

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

@@ -56,13 +56,7 @@ def shield(self) -> ShieldResource:
     @cached_property
     def rules(self) -> RulesResource:
         """
-        Rules allow to set up custom settings for certain file types or paths.
-        By default, the rule inherits all options values from the related CDN resource.
-
-        Each option in rule settings can be in one of the following states:
-        - **Inherit** - Option is not added to the rule. Option inherits its value from the CDN resource settings. In this case, the option value is **null**.
-        - **ON** - Option is added to the rule and enabled. Option values configured in the rule will override values from the CDN resource settings.
-        - **OFF** - Option is added to the rule and disabled. Option will be turned off.
+        CDN resource rules set custom caching, delivery, and security options for specific URL patterns or file types.
         """
         return RulesResource(self._client)
 
@@ -973,13 +967,7 @@ def shield(self) -> AsyncShieldResource:
     @cached_property
     def rules(self) -> AsyncRulesResource:
         """
-        Rules allow to set up custom settings for certain file types or paths.
-        By default, the rule inherits all options values from the related CDN resource.
-
-        Each option in rule settings can be in one of the following states:
-        - **Inherit** - Option is not added to the rule. Option inherits its value from the CDN resource settings. In this case, the option value is **null**.
-        - **ON** - Option is added to the rule and enabled. Option values configured in the rule will override values from the CDN resource settings.
-        - **OFF** - Option is added to the rule and disabled. Option will be turned off.
+        CDN resource rules set custom caching, delivery, and security options for specific URL patterns or file types.
         """
         return AsyncRulesResource(self._client)
 
@@ -1921,13 +1909,7 @@ def shield(self) -> ShieldResourceWithRawResponse:
     @cached_property
     def rules(self) -> RulesResourceWithRawResponse:
         """
-        Rules allow to set up custom settings for certain file types or paths.
-        By default, the rule inherits all options values from the related CDN resource.
-
-        Each option in rule settings can be in one of the following states:
-        - **Inherit** - Option is not added to the rule. Option inherits its value from the CDN resource settings. In this case, the option value is **null**.
-        - **ON** - Option is added to the rule and enabled. Option values configured in the rule will override values from the CDN resource settings.
-        - **OFF** - Option is added to the rule and disabled. Option will be turned off.
+        CDN resource rules set custom caching, delivery, and security options for specific URL patterns or file types.
         """
         return RulesResourceWithRawResponse(self._cdn_resources.rules)
 
@@ -1971,13 +1953,7 @@ def shield(self) -> AsyncShieldResourceWithRawResponse:
     @cached_property
     def rules(self) -> AsyncRulesResourceWithRawResponse:
         """
-        Rules allow to set up custom settings for certain file types or paths.
-        By default, the rule inherits all options values from the related CDN resource.
-
-        Each option in rule settings can be in one of the following states:
-        - **Inherit** - Option is not added to the rule. Option inherits its value from the CDN resource settings. In this case, the option value is **null**.
-        - **ON** - Option is added to the rule and enabled. Option values configured in the rule will override values from the CDN resource settings.
-        - **OFF** - Option is added to the rule and disabled. Option will be turned off.
+        CDN resource rules set custom caching, delivery, and security options for specific URL patterns or file types.
         """
         return AsyncRulesResourceWithRawResponse(self._cdn_resources.rules)
 
@@ -2021,13 +1997,7 @@ def shield(self) -> ShieldResourceWithStreamingResponse:
     @cached_property
     def rules(self) -> RulesResourceWithStreamingResponse:
         """
-        Rules allow to set up custom settings for certain file types or paths.
-        By default, the rule inherits all options values from the related CDN resource.
-
-        Each option in rule settings can be in one of the following states:
-        - **Inherit** - Option is not added to the rule. Option inherits its value from the CDN resource settings. In this case, the option value is **null**.
-        - **ON** - Option is added to the rule and enabled. Option values configured in the rule will override values from the CDN resource settings.
-        - **OFF** - Option is added to the rule and disabled. Option will be turned off.
+        CDN resource rules set custom caching, delivery, and security options for specific URL patterns or file types.
         """
         return RulesResourceWithStreamingResponse(self._cdn_resources.rules)
 
@@ -2071,12 +2041,6 @@ def shield(self) -> AsyncShieldResourceWithStreamingResponse:
     @cached_property
     def rules(self) -> AsyncRulesResourceWithStreamingResponse:
         """
-        Rules allow to set up custom settings for certain file types or paths.
-        By default, the rule inherits all options values from the related CDN resource.
-
-        Each option in rule settings can be in one of the following states:
-        - **Inherit** - Option is not added to the rule. Option inherits its value from the CDN resource settings. In this case, the option value is **null**.
-        - **ON** - Option is added to the rule and enabled. Option values configured in the rule will override values from the CDN resource settings.
-        - **OFF** - Option is added to the rule and disabled. Option will be turned off.
+        CDN resource rules set custom caching, delivery, and security options for specific URL patterns or file types.
         """
         return AsyncRulesResourceWithStreamingResponse(self._cdn_resources.rules)

src/gcore/resources/cdn/cdn_resources/rules.py

@@ -27,13 +27,7 @@
 
 class RulesResource(SyncAPIResource):
     """
-    Rules allow to set up custom settings for certain file types or paths.
-    By default, the rule inherits all options values from the related CDN resource.
-
-    Each option in rule settings can be in one of the following states:
-    - **Inherit** - Option is not added to the rule. Option inherits its value from the CDN resource settings. In this case, the option value is **null**.
-    - **ON** - Option is added to the rule and enabled. Option values configured in the rule will override values from the CDN resource settings.
-    - **OFF** - Option is added to the rule and disabled. Option will be turned off.
+    CDN resource rules set custom caching, delivery, and security options for specific URL patterns or file types.
     """
 
     @cached_property
@@ -478,13 +472,7 @@ def replace(
 
 class AsyncRulesResource(AsyncAPIResource):
     """
-    Rules allow to set up custom settings for certain file types or paths.
-    By default, the rule inherits all options values from the related CDN resource.
-
-    Each option in rule settings can be in one of the following states:
-    - **Inherit** - Option is not added to the rule. Option inherits its value from the CDN resource settings. In this case, the option value is **null**.
-    - **ON** - Option is added to the rule and enabled. Option values configured in the rule will override values from the CDN resource settings.
-    - **OFF** - Option is added to the rule and disabled. Option will be turned off.
+    CDN resource rules set custom caching, delivery, and security options for specific URL patterns or file types.
     """
 
     @cached_property

src/gcore/resources/cdn/certificates.py

@@ -31,6 +31,10 @@
 
 
 class CertificatesResource(SyncAPIResource):
+    """
+    CDN SSL certificates enable HTTPS content delivery, supporting both uploaded certificates and automated Let's Encrypt provisioning.
+    """
+
     @cached_property
     def with_raw_response(self) -> CertificatesResourceWithRawResponse:
         """
@@ -474,6 +478,10 @@ def replace(
 
 
 class AsyncCertificatesResource(AsyncAPIResource):
+    """
+    CDN SSL certificates enable HTTPS content delivery, supporting both uploaded certificates and automated Let's Encrypt provisioning.
+    """
+
     @cached_property
     def with_raw_response(self) -> AsyncCertificatesResourceWithRawResponse:
         """

src/gcore/resources/cdn/origin_groups.py

@@ -31,6 +31,10 @@
 
 
 class OriginGroupsResource(SyncAPIResource):
+    """
+    CDN origin groups aggregate one or more origin servers with failover and load balancing for content delivery.
+    """
+
     @cached_property
     def with_raw_response(self) -> OriginGroupsResourceWithRawResponse:
         """
@@ -706,6 +710,10 @@ def replace(
 
 
 class AsyncOriginGroupsResource(AsyncAPIResource):
+    """
+    CDN origin groups aggregate one or more origin servers with failover and load balancing for content delivery.
+    """
+
     @cached_property
     def with_raw_response(self) -> AsyncOriginGroupsResourceWithRawResponse:
         """

src/gcore/resources/cdn/trusted_ca_certificates.py

@@ -27,6 +27,10 @@
 
 
 class TrustedCaCertificatesResource(SyncAPIResource):
+    """
+    Trusted CA certificates verify the authenticity of CDN origin servers during HTTPS connections.
+    """
+
     @cached_property
     def with_raw_response(self) -> TrustedCaCertificatesResourceWithRawResponse:
         """
@@ -258,6 +262,10 @@ def replace(
 
 
 class AsyncTrustedCaCertificatesResource(AsyncAPIResource):
+    """
+    Trusted CA certificates verify the authenticity of CDN origin servers during HTTPS connections.
+    """
+
     @cached_property
     def with_raw_response(self) -> AsyncTrustedCaCertificatesResourceWithRawResponse:
         """