gcore 0.16.0__py3-none-any.whl → 0.23.0__py3-none-any.whl

gcore/resources/storage/storage.py

@@ -95,7 +95,7 @@ class StorageResource(SyncAPIResource):
     def create(
         self,
         *,
-        location: Literal["s-ed1", "s-drc2", "s-sgc1", "s-nhn2", "s-darz", "s-ws1", "ams", "sin", "fra", "mia"],
+        location: str,
         name: str,
         type: Literal["sftp", "s3"],
         generate_sftp_password: bool | Omit = omit,
@@ -499,7 +499,7 @@ class AsyncStorageResource(AsyncAPIResource):
     async def create(
         self,
         *,
-        location: Literal["s-ed1", "s-drc2", "s-sgc1", "s-nhn2", "s-darz", "s-ws1", "ams", "sin", "fra", "mia"],
+        location: str,
         name: str,
         type: Literal["sftp", "s3"],
         generate_sftp_password: bool | Omit = omit,

gcore/types/cdn/__init__.py

@@ -3,6 +3,7 @@
 from __future__ import annotations
 
 from .ssl_detail import SslDetail as SslDetail
+from .aws_regions import AwsRegions as AwsRegions
 from .cdn_account import CdnAccount as CdnAccount
 from .cdn_metrics import CdnMetrics as CdnMetrics
 from .cdn_resource import CdnResource as CdnResource
@@ -12,6 +13,7 @@ from .origin_groups import OriginGroups as OriginGroups
 from .rule_template import RuleTemplate as RuleTemplate
 from .ca_certificate import CaCertificate as CaCertificate
 from .public_ip_list import PublicIPList as PublicIPList
+from .alibaba_regions import AlibabaRegions as AlibabaRegions
 from .log_list_params import LogListParams as LogListParams
 from .ssl_detail_list import SslDetailList as SslDetailList
 from .network_capacity import NetworkCapacity as NetworkCapacity
@@ -28,6 +30,7 @@ from .ca_certificate_list import CaCertificateList as CaCertificateList
 from .cdn_audit_log_entry import CdnAuditLogEntry as CdnAuditLogEntry
 from .log_download_params import LogDownloadParams as LogDownloadParams
 from .public_network_list import PublicNetworkList as PublicNetworkList
+from .ip_range_list_params import IPRangeListParams as IPRangeListParams
 from .resource_list_params import ResourceListParams as ResourceListParams
 from .resource_usage_stats import ResourceUsageStats as ResourceUsageStats
 from .shield_list_response import ShieldListResponse as ShieldListResponse
@@ -40,6 +43,7 @@ from .resource_update_params import ResourceUpdateParams as ResourceUpdateParams
 from .certificate_list_params import CertificateListParams as CertificateListParams
 from .resource_replace_params import ResourceReplaceParams as ResourceReplaceParams
 from .shield_aggregated_stats import ShieldAggregatedStats as ShieldAggregatedStats
+from .ip_range_list_ips_params import IPRangeListIPsParams as IPRangeListIPsParams
 from .logs_uploader_validation import LogsUploaderValidation as LogsUploaderValidation
 from .origin_group_list_params import OriginGroupListParams as OriginGroupListParams
 from .resource_prefetch_params import ResourcePrefetchParams as ResourcePrefetchParams
@@ -55,6 +59,7 @@ from .rule_template_update_params import RuleTemplateUpdateParams as RuleTemplat
 from .rule_template_replace_params import RuleTemplateReplaceParams as RuleTemplateReplaceParams
 from .certificate_get_status_params import CertificateGetStatusParams as CertificateGetStatusParams
 from .cdn_list_purge_statuses_params import CdnListPurgeStatusesParams as CdnListPurgeStatusesParams
+from .cdn_list_purge_statuses_response import CdnListPurgeStatusesResponse as CdnListPurgeStatusesResponse
 from .trusted_ca_certificate_list_params import TrustedCaCertificateListParams as TrustedCaCertificateListParams
 from .trusted_ca_certificate_create_params import TrustedCaCertificateCreateParams as TrustedCaCertificateCreateParams
 from .trusted_ca_certificate_replace_params import (

gcore/types/cdn/alibaba_regions.py

@@ -0,0 +1,22 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import List, Optional
+from typing_extensions import TypeAlias
+
+from ..._models import BaseModel
+
+__all__ = ["AlibabaRegions", "AlibabaRegionItem"]
+
+
+class AlibabaRegionItem(BaseModel):
+    id: Optional[int] = None
+    """Region ID."""
+
+    code: Optional[str] = None
+    """Region code."""
+
+    name: Optional[str] = None
+    """Region name."""
+
+
+AlibabaRegions: TypeAlias = List[AlibabaRegionItem]

gcore/types/cdn/audit_log_list_params.py

@@ -50,10 +50,10 @@ class AuditLogListParams(TypedDict, total=False):
     """Offset relative to the beginning of activity logs."""
 
     path: str
-    """Path that a requested URL should contain."""
+    """Exact URL path."""
 
     remote_ip_address: str
-    """IP address or part of it from which requests are sent."""
+    """Exact IP address from which requests are sent."""
 
     status_code: int
     """Status code returned in the response.

gcore/types/cdn/aws_regions.py

@@ -0,0 +1,22 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import List, Optional
+from typing_extensions import TypeAlias
+
+from ..._models import BaseModel
+
+__all__ = ["AwsRegions", "AwsRegionItem"]
+
+
+class AwsRegionItem(BaseModel):
+    id: Optional[int] = None
+    """Region ID."""
+
+    code: Optional[str] = None
+    """Region code."""
+
+    name: Optional[str] = None
+    """Region name."""
+
+
+AwsRegions: TypeAlias = List[AwsRegionItem]

gcore/types/cdn/cdn_list_purge_statuses_response.py

@@ -0,0 +1,10 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import List
+from typing_extensions import TypeAlias
+
+from .purge_status import PurgeStatus
+
+__all__ = ["CdnListPurgeStatusesResponse"]
+
+CdnListPurgeStatusesResponse: TypeAlias = List[PurgeStatus]

gcore/types/cdn/cdn_resource.py

@@ -187,7 +187,7 @@ class OptionsCors(BaseModel):
     Possible values:
 
     - **Adds \\** as the Access-Control-Allow-Origin header value** - Content will be
-      uploaded for requests from any domain. `"value": ["\\**"]`
+      uploaded for requests from any domain. `"value": ["*"]`
     - **Adds "$`http_origin`" as the Access-Control-Allow-Origin header value if the
       origin matches one of the listed domains** - Content will be uploaded only for
       requests from the domains specified in the field.
@@ -195,7 +195,7 @@ class OptionsCors(BaseModel):
     - **Adds "$`http_origin`" as the Access-Control-Allow-Origin header value** -
       Content will be uploaded for requests from any domain, and the domain from
       which the request was sent will be added to the "Access-Control-Allow-Origin"
-      header in the response. `"value": ["$`http_origin`"]`
+      header in the response. `"value": ["$http_origin"]`
     """
 
     always: Optional[bool] = None
@@ -759,7 +759,10 @@ class OptionsProxyConnectTimeout(BaseModel):
     """
 
     value: str
-    """Timeout value in seconds."""
+    """Timeout value in seconds.
+
+    Supported range: **1s - 5s**.
+    """
 
 
 class OptionsProxyReadTimeout(BaseModel):
@@ -773,7 +776,10 @@ class OptionsProxyReadTimeout(BaseModel):
     """
 
     value: str
-    """Timeout value in seconds."""
+    """Timeout value in seconds.
+
+    Supported range: **1s - 30s**.
+    """
 
 
 class OptionsQueryParamsBlacklist(BaseModel):
@@ -912,7 +918,7 @@ class OptionsReferrerACL(BaseModel):
     Examples:
 
     - `example.com`
-    - `\\**.example.com`
+    - `*.example.com`
     """
 
     policy_type: Literal["allow", "deny"]
@@ -1002,7 +1008,7 @@ class OptionsRewrite(BaseModel):
 
     Example:
 
-    - `/(.\\**) /media/$1`
+    - `/(.*) /media/$1`
     """
 
     enabled: bool
@@ -1189,7 +1195,7 @@ class OptionsStaticHeaders(BaseModel):
     - **false** - Option is disabled.
     """
 
-    value: Dict[str, str]
+    value: object
     """A MAP for static headers in a format of `header_name: header_value`.
 
     Restrictions:
@@ -1455,7 +1461,7 @@ class Options(BaseModel):
     2. `fetch_compressed` overrides `gzipON` and `brotli_compression` in rule. If
        you enable it in CDN resource and want to use `gzipON` and
        `brotli_compression` in a rule, you have to specify
-       `"`fetch_compressed`": false` in the rule.
+       `"fetch_compressed": false` in the rule.
     """
 
     follow_origin_redirect: Optional[OptionsFollowOriginRedirect] = None
@@ -1489,8 +1495,7 @@ class Options(BaseModel):
        options enabled.
     2. `fetch_compressed` option in CDN resource settings overrides `gzipON` in
        rules. If you enable `fetch_compressed` in CDN resource and want to enable
-       `gzipON` in rules, you need to specify `"`fetch_compressed`":false` for
-       rules.
+       `gzipON` in rules, you need to specify `"fetch_compressed":false` for rules.
     """
 
     host_header: Optional[OptionsHostHeader] = FieldInfo(alias="hostHeader", default=None)
@@ -1864,13 +1869,13 @@ class CdnResource(BaseModel):
     proxy_ssl_ca: Optional[int] = None
     """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: Optional[int] = None
     """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: Optional[bool] = None

gcore/types/cdn/ip_range_list_ips_params.py

@@ -0,0 +1,19 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing_extensions import Literal, Annotated, TypedDict
+
+from ..._utils import PropertyInfo
+
+__all__ = ["IPRangeListIPsParams"]
+
+
+class IPRangeListIPsParams(TypedDict, total=False):
+    format: Literal["json", "plain"]
+    """
+    Optional format override. When set, this takes precedence over the `Accept`
+    header.
+    """
+
+    accept: Annotated[Literal["application/json", "text/plain"], PropertyInfo(alias="Accept")]

gcore/types/cdn/ip_range_list_params.py

@@ -0,0 +1,19 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing_extensions import Literal, Annotated, TypedDict
+
+from ..._utils import PropertyInfo
+
+__all__ = ["IPRangeListParams"]
+
+
+class IPRangeListParams(TypedDict, total=False):
+    format: Literal["json", "plain"]
+    """
+    Optional format override. When set, this takes precedence over the `Accept`
+    header.
+    """
+
+    accept: Annotated[Literal["application/json", "text/plain"], PropertyInfo(alias="Accept")]

gcore/types/cdn/resource_create_params.py

@@ -138,13 +138,13 @@ class ResourceCreateParams(TypedDict, total=False):
     proxy_ssl_ca: Optional[int]
     """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: Optional[int]
     """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: bool
@@ -310,7 +310,7 @@ class OptionsCors(TypedDict, total=False):
     Possible values:
 
     - **Adds \\** as the Access-Control-Allow-Origin header value** - Content will be
-      uploaded for requests from any domain. `"value": ["\\**"]`
+      uploaded for requests from any domain. `"value": ["*"]`
     - **Adds "$`http_origin`" as the Access-Control-Allow-Origin header value if the
       origin matches one of the listed domains** - Content will be uploaded only for
       requests from the domains specified in the field.
@@ -318,7 +318,7 @@ class OptionsCors(TypedDict, total=False):
     - **Adds "$`http_origin`" as the Access-Control-Allow-Origin header value** -
       Content will be uploaded for requests from any domain, and the domain from
       which the request was sent will be added to the "Access-Control-Allow-Origin"
-      header in the response. `"value": ["$`http_origin`"]`
+      header in the response. `"value": ["$http_origin"]`
     """
 
     always: bool
@@ -882,7 +882,10 @@ class OptionsProxyConnectTimeout(TypedDict, total=False):
     """
 
     value: Required[str]
-    """Timeout value in seconds."""
+    """Timeout value in seconds.
+
+    Supported range: **1s - 5s**.
+    """
 
 
 class OptionsProxyReadTimeout(TypedDict, total=False):
@@ -896,7 +899,10 @@ class OptionsProxyReadTimeout(TypedDict, total=False):
     """
 
     value: Required[str]
-    """Timeout value in seconds."""
+    """Timeout value in seconds.
+
+    Supported range: **1s - 30s**.
+    """
 
 
 class OptionsQueryParamsBlacklist(TypedDict, total=False):
@@ -1035,7 +1041,7 @@ class OptionsReferrerACL(TypedDict, total=False):
     Examples:
 
     - `example.com`
-    - `\\**.example.com`
+    - `*.example.com`
     """
 
     policy_type: Required[Literal["allow", "deny"]]
@@ -1121,7 +1127,7 @@ class OptionsRewrite(TypedDict, total=False):
 
     Example:
 
-    - `/(.\\**) /media/$1`
+    - `/(.*) /media/$1`
     """
 
     enabled: Required[bool]
@@ -1310,7 +1316,7 @@ class OptionsStaticHeaders(TypedDict, total=False):
     - **false** - Option is disabled.
     """
 
-    value: Required[Dict[str, str]]
+    value: Required[object]
     """A MAP for static headers in a format of `header_name: header_value`.
 
     Restrictions:
@@ -1576,7 +1582,7 @@ class Options(TypedDict, total=False):
     2. `fetch_compressed` overrides `gzipON` and `brotli_compression` in rule. If
        you enable it in CDN resource and want to use `gzipON` and
        `brotli_compression` in a rule, you have to specify
-       `"`fetch_compressed`": false` in the rule.
+       `"fetch_compressed": false` in the rule.
     """
 
     follow_origin_redirect: Optional[OptionsFollowOriginRedirect]
@@ -1610,8 +1616,7 @@ class Options(TypedDict, total=False):
        options enabled.
     2. `fetch_compressed` option in CDN resource settings overrides `gzipON` in
        rules. If you enable `fetch_compressed` in CDN resource and want to enable
-       `gzipON` in rules, you need to specify `"`fetch_compressed`":false` for
-       rules.
+       `gzipON` in rules, you need to specify `"fetch_compressed":false` for rules.
     """
 
     host_header: Annotated[Optional[OptionsHostHeader], PropertyInfo(alias="hostHeader")]

gcore/types/cdn/resource_purge_params.py

@@ -43,16 +43,16 @@ class PurgeByPattern(TypedDict, total=False):
     paths: SequenceNotStr[str]
     """**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.
     """
 
 

gcore/types/cdn/resource_replace_params.py

@@ -116,13 +116,13 @@ class ResourceReplaceParams(TypedDict, total=False):
     proxy_ssl_ca: Optional[int]
     """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: Optional[int]
     """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: bool
@@ -288,7 +288,7 @@ class OptionsCors(TypedDict, total=False):
     Possible values:
 
     - **Adds \\** as the Access-Control-Allow-Origin header value** - Content will be
-      uploaded for requests from any domain. `"value": ["\\**"]`
+      uploaded for requests from any domain. `"value": ["*"]`
     - **Adds "$`http_origin`" as the Access-Control-Allow-Origin header value if the
       origin matches one of the listed domains** - Content will be uploaded only for
       requests from the domains specified in the field.
@@ -296,7 +296,7 @@ class OptionsCors(TypedDict, total=False):
     - **Adds "$`http_origin`" as the Access-Control-Allow-Origin header value** -
       Content will be uploaded for requests from any domain, and the domain from
       which the request was sent will be added to the "Access-Control-Allow-Origin"
-      header in the response. `"value": ["$`http_origin`"]`
+      header in the response. `"value": ["$http_origin"]`
     """
 
     always: bool
@@ -860,7 +860,10 @@ class OptionsProxyConnectTimeout(TypedDict, total=False):
     """
 
     value: Required[str]
-    """Timeout value in seconds."""
+    """Timeout value in seconds.
+
+    Supported range: **1s - 5s**.
+    """
 
 
 class OptionsProxyReadTimeout(TypedDict, total=False):
@@ -874,7 +877,10 @@ class OptionsProxyReadTimeout(TypedDict, total=False):
     """
 
     value: Required[str]
-    """Timeout value in seconds."""
+    """Timeout value in seconds.
+
+    Supported range: **1s - 30s**.
+    """
 
 
 class OptionsQueryParamsBlacklist(TypedDict, total=False):
@@ -1013,7 +1019,7 @@ class OptionsReferrerACL(TypedDict, total=False):
     Examples:
 
     - `example.com`
-    - `\\**.example.com`
+    - `*.example.com`
     """
 
     policy_type: Required[Literal["allow", "deny"]]
@@ -1099,7 +1105,7 @@ class OptionsRewrite(TypedDict, total=False):
 
     Example:
 
-    - `/(.\\**) /media/$1`
+    - `/(.*) /media/$1`
     """
 
     enabled: Required[bool]
@@ -1288,7 +1294,7 @@ class OptionsStaticHeaders(TypedDict, total=False):
     - **false** - Option is disabled.
     """
 
-    value: Required[Dict[str, str]]
+    value: Required[object]
     """A MAP for static headers in a format of `header_name: header_value`.
 
     Restrictions:
@@ -1554,7 +1560,7 @@ class Options(TypedDict, total=False):
     2. `fetch_compressed` overrides `gzipON` and `brotli_compression` in rule. If
        you enable it in CDN resource and want to use `gzipON` and
        `brotli_compression` in a rule, you have to specify
-       `"`fetch_compressed`": false` in the rule.
+       `"fetch_compressed": false` in the rule.
     """
 
     follow_origin_redirect: Optional[OptionsFollowOriginRedirect]
@@ -1588,8 +1594,7 @@ class Options(TypedDict, total=False):
        options enabled.
     2. `fetch_compressed` option in CDN resource settings overrides `gzipON` in
        rules. If you enable `fetch_compressed` in CDN resource and want to enable
-       `gzipON` in rules, you need to specify `"`fetch_compressed`":false` for
-       rules.
+       `gzipON` in rules, you need to specify `"fetch_compressed":false` for rules.
     """
 
     host_header: Annotated[Optional[OptionsHostHeader], PropertyInfo(alias="hostHeader")]

gcore/types/cdn/resource_update_params.py

@@ -116,13 +116,13 @@ class ResourceUpdateParams(TypedDict, total=False):
     proxy_ssl_ca: Optional[int]
     """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: Optional[int]
     """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: bool
@@ -279,7 +279,7 @@ class OptionsCors(TypedDict, total=False):
     Possible values:
 
     - **Adds \\** as the Access-Control-Allow-Origin header value** - Content will be
-      uploaded for requests from any domain. `"value": ["\\**"]`
+      uploaded for requests from any domain. `"value": ["*"]`
     - **Adds "$`http_origin`" as the Access-Control-Allow-Origin header value if the
       origin matches one of the listed domains** - Content will be uploaded only for
       requests from the domains specified in the field.
@@ -287,7 +287,7 @@ class OptionsCors(TypedDict, total=False):
     - **Adds "$`http_origin`" as the Access-Control-Allow-Origin header value** -
       Content will be uploaded for requests from any domain, and the domain from
       which the request was sent will be added to the "Access-Control-Allow-Origin"
-      header in the response. `"value": ["$`http_origin`"]`
+      header in the response. `"value": ["$http_origin"]`
     """
 
     always: bool
@@ -851,7 +851,10 @@ class OptionsProxyConnectTimeout(TypedDict, total=False):
     """
 
     value: Required[str]
-    """Timeout value in seconds."""
+    """Timeout value in seconds.
+
+    Supported range: **1s - 5s**.
+    """
 
 
 class OptionsProxyReadTimeout(TypedDict, total=False):
@@ -865,7 +868,10 @@ class OptionsProxyReadTimeout(TypedDict, total=False):
     """
 
     value: Required[str]
-    """Timeout value in seconds."""
+    """Timeout value in seconds.
+
+    Supported range: **1s - 30s**.
+    """
 
 
 class OptionsQueryParamsBlacklist(TypedDict, total=False):
@@ -1004,7 +1010,7 @@ class OptionsReferrerACL(TypedDict, total=False):
     Examples:
 
     - `example.com`
-    - `\\**.example.com`
+    - `*.example.com`
     """
 
     policy_type: Required[Literal["allow", "deny"]]
@@ -1090,7 +1096,7 @@ class OptionsRewrite(TypedDict, total=False):
 
     Example:
 
-    - `/(.\\**) /media/$1`
+    - `/(.*) /media/$1`
     """
 
     enabled: Required[bool]
@@ -1279,7 +1285,7 @@ class OptionsStaticHeaders(TypedDict, total=False):
     - **false** - Option is disabled.
     """
 
-    value: Required[Dict[str, str]]
+    value: Required[object]
     """A MAP for static headers in a format of `header_name: header_value`.
 
     Restrictions:
@@ -1545,7 +1551,7 @@ class Options(TypedDict, total=False):
     2. `fetch_compressed` overrides `gzipON` and `brotli_compression` in rule. If
        you enable it in CDN resource and want to use `gzipON` and
        `brotli_compression` in a rule, you have to specify
-       `"`fetch_compressed`": false` in the rule.
+       `"fetch_compressed": false` in the rule.
     """
 
     follow_origin_redirect: Optional[OptionsFollowOriginRedirect]
@@ -1579,8 +1585,7 @@ class Options(TypedDict, total=False):
        options enabled.
     2. `fetch_compressed` option in CDN resource settings overrides `gzipON` in
        rules. If you enable `fetch_compressed` in CDN resource and want to enable
-       `gzipON` in rules, you need to specify `"`fetch_compressed`":false` for
-       rules.
+       `gzipON` in rules, you need to specify `"fetch_compressed":false` for rules.
     """
 
     host_header: Annotated[Optional[OptionsHostHeader], PropertyInfo(alias="hostHeader")]

gcore/types/cdn/resource_usage_stats.py

@@ -28,7 +28,7 @@ class ResourceUsageStats(BaseModel):
     Possible values:
 
     - **`upstream_bytes`** – Traffic in bytes from an origin server to CDN servers
-      or to origin shielding, if used.
+      or to origin shielding when used.
     - **`sent_bytes`** – Traffic in bytes from CDN servers to clients.
     - **`shield_bytes`** – Traffic in bytes from origin shielding to CDN servers.
     - **`backblaze_bytes`** - Traffic in bytes from Backblaze origin.
@@ -45,39 +45,40 @@ class ResourceUsageStats(BaseModel):
     - **`response_types`** – Statistics by content type. It returns a number of
       responses for content with different MIME types.
     - **`cache_hit_traffic_ratio`** – Formula: 1 - `upstream_bytes` / `sent_bytes`.
-      We deduct the non-cached traffic from the total traffic value.
-    - **`cache_hit_requests_ratio`** – Share of sending cached content. Formula:
-      `responses_hit` / requests.
-    - **`shield_traffic_ratio`** – Origin shielding efficiency: how much more
-      traffic is sent from the origin shielding than from the origin. Formula:
-      (`shield_bytes` - `upstream_bytes`) / `shield_bytes`.
+      We deduct the non-cached traffic from the total traffic amount.
+    - **`cache_hit_requests_ratio`** – Formula: `responses_hit` / requests. The
+      share of sending cached content.
+    - **`shield_traffic_ratio`** – Formula: (`shield_bytes` - `upstream_bytes`) /
+      `shield_bytes`. The efficiency of the Origin Shielding: how much more traffic
+      is sent from the Origin Shielding than from the origin.
     - **`image_processed`** - Number of images transformed on the Image optimization
       service.
     - **`request_time`** - Time elapsed between the first bytes of a request were
       processed and logging after the last bytes were sent to a user.
     - **`upstream_response_time`** - Number of milliseconds it took to receive a
       response from an origin. If upstream `response_time_` contains several
-      indications for one request (when there is more than one origin,) we summarize
-      them. When aggregating several queries, the average is calculated.
+      indications for one request (in case of more than 1 origin), we summarize
+      them. In case of aggregating several queries, the average of this amount is
+      calculated.
 
     Metrics **`upstream_response_time`** and **`request_time`** should be requested
     separately from other metrics
     """
 
     region: Optional[object] = None
-    """Locations (regions) by which the data is grouped.
+    """Regions for which data is displayed.
 
     Possible values:
 
+    - **na** – North America
+    - **eu** – Europe
+    - **cis** – Commonwealth of Independent States
     - **asia** – Asia
     - **au** – Australia
-    - **cis** – CIS (Commonwealth of Independent States)
-    - **eu** – Europe
     - **latam** – Latin America
     - **me** – Middle East
-    - **na** – North America
-    - **africa** – Africa
-    - **sa** – South America
+    - **africa** - Africa
+    - **sa** - South America
     """
 
     resource: Optional[object] = None