gcore 0.10.0__py3-none-any.whl → 0.12.0__py3-none-any.whl

gcore/_utils/_datetime_parse.py

@@ -0,0 +1,136 @@
+"""
+This file contains code from https://github.com/pydantic/pydantic/blob/main/pydantic/v1/datetime_parse.py
+without the Pydantic v1 specific errors.
+"""
+
+from __future__ import annotations
+
+import re
+from typing import Dict, Union, Optional
+from datetime import date, datetime, timezone, timedelta
+
+from .._types import StrBytesIntFloat
+
+date_expr = r"(?P<year>\d{4})-(?P<month>\d{1,2})-(?P<day>\d{1,2})"
+time_expr = (
+    r"(?P<hour>\d{1,2}):(?P<minute>\d{1,2})"
+    r"(?::(?P<second>\d{1,2})(?:\.(?P<microsecond>\d{1,6})\d{0,6})?)?"
+    r"(?P<tzinfo>Z|[+-]\d{2}(?::?\d{2})?)?$"
+)
+
+date_re = re.compile(f"{date_expr}$")
+datetime_re = re.compile(f"{date_expr}[T ]{time_expr}")
+
+
+EPOCH = datetime(1970, 1, 1)
+# if greater than this, the number is in ms, if less than or equal it's in seconds
+# (in seconds this is 11th October 2603, in ms it's 20th August 1970)
+MS_WATERSHED = int(2e10)
+# slightly more than datetime.max in ns - (datetime.max - EPOCH).total_seconds() * 1e9
+MAX_NUMBER = int(3e20)
+
+
+def _get_numeric(value: StrBytesIntFloat, native_expected_type: str) -> Union[None, int, float]:
+    if isinstance(value, (int, float)):
+        return value
+    try:
+        return float(value)
+    except ValueError:
+        return None
+    except TypeError:
+        raise TypeError(f"invalid type; expected {native_expected_type}, string, bytes, int or float") from None
+
+
+def _from_unix_seconds(seconds: Union[int, float]) -> datetime:
+    if seconds > MAX_NUMBER:
+        return datetime.max
+    elif seconds < -MAX_NUMBER:
+        return datetime.min
+
+    while abs(seconds) > MS_WATERSHED:
+        seconds /= 1000
+    dt = EPOCH + timedelta(seconds=seconds)
+    return dt.replace(tzinfo=timezone.utc)
+
+
+def _parse_timezone(value: Optional[str]) -> Union[None, int, timezone]:
+    if value == "Z":
+        return timezone.utc
+    elif value is not None:
+        offset_mins = int(value[-2:]) if len(value) > 3 else 0
+        offset = 60 * int(value[1:3]) + offset_mins
+        if value[0] == "-":
+            offset = -offset
+        return timezone(timedelta(minutes=offset))
+    else:
+        return None
+
+
+def parse_datetime(value: Union[datetime, StrBytesIntFloat]) -> datetime:
+    """
+    Parse a datetime/int/float/string and return a datetime.datetime.
+
+    This function supports time zone offsets. When the input contains one,
+    the output uses a timezone with a fixed offset from UTC.
+
+    Raise ValueError if the input is well formatted but not a valid datetime.
+    Raise ValueError if the input isn't well formatted.
+    """
+    if isinstance(value, datetime):
+        return value
+
+    number = _get_numeric(value, "datetime")
+    if number is not None:
+        return _from_unix_seconds(number)
+
+    if isinstance(value, bytes):
+        value = value.decode()
+
+    assert not isinstance(value, (float, int))
+
+    match = datetime_re.match(value)
+    if match is None:
+        raise ValueError("invalid datetime format")
+
+    kw = match.groupdict()
+    if kw["microsecond"]:
+        kw["microsecond"] = kw["microsecond"].ljust(6, "0")
+
+    tzinfo = _parse_timezone(kw.pop("tzinfo"))
+    kw_: Dict[str, Union[None, int, timezone]] = {k: int(v) for k, v in kw.items() if v is not None}
+    kw_["tzinfo"] = tzinfo
+
+    return datetime(**kw_)  # type: ignore
+
+
+def parse_date(value: Union[date, StrBytesIntFloat]) -> date:
+    """
+    Parse a date/int/float/string and return a datetime.date.
+
+    Raise ValueError if the input is well formatted but not a valid date.
+    Raise ValueError if the input isn't well formatted.
+    """
+    if isinstance(value, date):
+        if isinstance(value, datetime):
+            return value.date()
+        else:
+            return value
+
+    number = _get_numeric(value, "date")
+    if number is not None:
+        return _from_unix_seconds(number).date()
+
+    if isinstance(value, bytes):
+        value = value.decode()
+
+    assert not isinstance(value, (float, int))
+    match = date_re.match(value)
+    if match is None:
+        raise ValueError("invalid date format")
+
+    kw = {k: int(v) for k, v in match.groupdict().items()}
+
+    try:
+        return date(**kw)
+    except ValueError:
+        raise ValueError("invalid date format") from None

gcore/_utils/_transform.py

@@ -16,18 +16,20 @@ from ._utils import (
     lru_cache,
     is_mapping,
     is_iterable,
+    is_sequence,
 )
 from .._files import is_base64_file_input
+from ._compat import get_origin, is_typeddict
 from ._typing import (
     is_list_type,
     is_union_type,
     extract_type_arg,
     is_iterable_type,
     is_required_type,
+    is_sequence_type,
     is_annotated_type,
     strip_annotated_type,
 )
-from .._compat import get_origin, model_dump, is_typeddict
 
 _T = TypeVar("_T")
 
@@ -167,6 +169,8 @@ def _transform_recursive(
 
             Defaults to the same value as the `annotation` argument.
     """
+    from .._compat import model_dump
+
     if inner_type is None:
         inner_type = annotation
 
@@ -184,6 +188,8 @@ def _transform_recursive(
         (is_list_type(stripped_type) and is_list(data))
         # Iterable[T]
         or (is_iterable_type(stripped_type) and is_iterable(data) and not isinstance(data, str))
+        # Sequence[T]
+        or (is_sequence_type(stripped_type) and is_sequence(data) and not isinstance(data, str))
     ):
         # dicts are technically iterable, but it is an iterable on the keys of the dict and is not usually
         # intended as an iterable, so we don't transform it.
@@ -329,6 +335,8 @@ async def _async_transform_recursive(
 
             Defaults to the same value as the `annotation` argument.
     """
+    from .._compat import model_dump
+
     if inner_type is None:
         inner_type = annotation
 
@@ -346,6 +354,8 @@ async def _async_transform_recursive(
         (is_list_type(stripped_type) and is_list(data))
         # Iterable[T]
         or (is_iterable_type(stripped_type) and is_iterable(data) and not isinstance(data, str))
+        # Sequence[T]
+        or (is_sequence_type(stripped_type) and is_sequence(data) and not isinstance(data, str))
     ):
         # dicts are technically iterable, but it is an iterable on the keys of the dict and is not usually
         # intended as an iterable, so we don't transform it.

gcore/_utils/_typing.py

@@ -15,7 +15,7 @@ from typing_extensions import (
 
 from ._utils import lru_cache
 from .._types import InheritsGeneric
-from .._compat import is_union as _is_union
+from ._compat import is_union as _is_union
 
 
 def is_annotated_type(typ: type) -> bool:
@@ -26,6 +26,11 @@ def is_list_type(typ: type) -> bool:
     return (get_origin(typ) or typ) == list
 
 
+def is_sequence_type(typ: type) -> bool:
+    origin = get_origin(typ) or typ
+    return origin == typing_extensions.Sequence or origin == typing.Sequence or origin == _c_abc.Sequence
+
+
 def is_iterable_type(typ: type) -> bool:
     """If the given type is `typing.Iterable[T]`"""
     origin = get_origin(typ) or typ

gcore/_utils/_utils.py

@@ -22,7 +22,6 @@ from typing_extensions import TypeGuard
 import sniffio
 
 from .._types import NotGiven, FileTypes, NotGivenOr, HeadersLike
-from .._compat import parse_date as parse_date, parse_datetime as parse_datetime
 
 _T = TypeVar("_T")
 _TupleT = TypeVar("_TupleT", bound=Tuple[object, ...])

gcore/_version.py

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

gcore/resources/__init__.py

@@ -1,5 +1,13 @@
 # File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
+from .dns import (
+    DNSResource,
+    AsyncDNSResource,
+    DNSResourceWithRawResponse,
+    AsyncDNSResourceWithRawResponse,
+    DNSResourceWithStreamingResponse,
+    AsyncDNSResourceWithStreamingResponse,
+)
 from .iam import (
     IamResource,
     AsyncIamResource,
@@ -24,6 +32,14 @@ from .cloud import (
     CloudResourceWithStreamingResponse,
     AsyncCloudResourceWithStreamingResponse,
 )
+from .storage import (
+    StorageResource,
+    AsyncStorageResource,
+    StorageResourceWithRawResponse,
+    AsyncStorageResourceWithRawResponse,
+    StorageResourceWithStreamingResponse,
+    AsyncStorageResourceWithStreamingResponse,
+)
 from .fastedge import (
     FastedgeResource,
     AsyncFastedgeResource,
@@ -86,4 +102,16 @@ __all__ = [
     "AsyncSecurityResourceWithRawResponse",
     "SecurityResourceWithStreamingResponse",
     "AsyncSecurityResourceWithStreamingResponse",
+    "DNSResource",
+    "AsyncDNSResource",
+    "DNSResourceWithRawResponse",
+    "AsyncDNSResourceWithRawResponse",
+    "DNSResourceWithStreamingResponse",
+    "AsyncDNSResourceWithStreamingResponse",
+    "StorageResource",
+    "AsyncStorageResource",
+    "StorageResourceWithRawResponse",
+    "AsyncStorageResourceWithRawResponse",
+    "StorageResourceWithStreamingResponse",
+    "AsyncStorageResourceWithStreamingResponse",
 ]

gcore/resources/cloud/__init__.py

@@ -1,5 +1,13 @@
 # File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
+from .k8s import (
+    K8sResource,
+    AsyncK8sResource,
+    K8sResourceWithRawResponse,
+    AsyncK8sResourceWithRawResponse,
+    K8sResourceWithStreamingResponse,
+    AsyncK8sResourceWithStreamingResponse,
+)
 from .cloud import (
     CloudResource,
     AsyncCloudResource,
@@ -342,6 +350,12 @@ __all__ = [
     "AsyncInstancesResourceWithRawResponse",
     "InstancesResourceWithStreamingResponse",
     "AsyncInstancesResourceWithStreamingResponse",
+    "K8sResource",
+    "AsyncK8sResource",
+    "K8sResourceWithRawResponse",
+    "AsyncK8sResourceWithRawResponse",
+    "K8sResourceWithStreamingResponse",
+    "AsyncK8sResourceWithStreamingResponse",
     "AuditLogsResource",
     "AsyncAuditLogsResource",
     "AuditLogsResourceWithRawResponse",

gcore/resources/cloud/audit_logs.py

@@ -8,7 +8,7 @@ from typing_extensions import Literal
 
 import httpx
 
-from ..._types import NOT_GIVEN, Body, Query, Headers, NotGiven
+from ..._types import NOT_GIVEN, Body, Query, Headers, NotGiven, SequenceNotStr
 from ..._utils import maybe_transform
 from ..._compat import cached_property
 from ..._resource import SyncAPIResource, AsyncAPIResource
@@ -153,7 +153,7 @@ class AuditLogsResource(SyncAPIResource):
         order_by: Literal["asc", "desc"] | NotGiven = NOT_GIVEN,
         project_id: Iterable[int] | NotGiven = NOT_GIVEN,
         region_id: Iterable[int] | NotGiven = NOT_GIVEN,
-        resource_id: List[str] | NotGiven = NOT_GIVEN,
+        resource_id: SequenceNotStr[str] | NotGiven = NOT_GIVEN,
         search_field: str | NotGiven = NOT_GIVEN,
         sorting: Literal["asc", "desc"] | NotGiven = NOT_GIVEN,
         to_timestamp: Union[str, datetime] | NotGiven = NOT_GIVEN,
@@ -362,7 +362,7 @@ class AsyncAuditLogsResource(AsyncAPIResource):
         order_by: Literal["asc", "desc"] | NotGiven = NOT_GIVEN,
         project_id: Iterable[int] | NotGiven = NOT_GIVEN,
         region_id: Iterable[int] | NotGiven = NOT_GIVEN,
-        resource_id: List[str] | NotGiven = NOT_GIVEN,
+        resource_id: SequenceNotStr[str] | NotGiven = NOT_GIVEN,
         search_field: str | NotGiven = NOT_GIVEN,
         sorting: Literal["asc", "desc"] | NotGiven = NOT_GIVEN,
         to_timestamp: Union[str, datetime] | NotGiven = NOT_GIVEN,

gcore/resources/cloud/baremetal/images.py

@@ -2,12 +2,11 @@
 
 from __future__ import annotations
 
-from typing import List
 from typing_extensions import Literal
 
 import httpx
 
-from ...._types import NOT_GIVEN, Body, Query, Headers, NotGiven
+from ...._types import NOT_GIVEN, Body, Query, Headers, NotGiven, SequenceNotStr
 from ...._utils import maybe_transform, async_maybe_transform
 from ...._compat import cached_property
 from ...._resource import SyncAPIResource, AsyncAPIResource
@@ -51,7 +50,7 @@ class ImagesResource(SyncAPIResource):
         region_id: int | None = None,
         include_prices: bool | NotGiven = NOT_GIVEN,
         private: str | NotGiven = NOT_GIVEN,
-        tag_key: List[str] | NotGiven = NOT_GIVEN,
+        tag_key: SequenceNotStr[str] | NotGiven = NOT_GIVEN,
         tag_key_value: str | NotGiven = NOT_GIVEN,
         visibility: Literal["private", "public", "shared"] | NotGiven = NOT_GIVEN,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
@@ -139,7 +138,7 @@ class AsyncImagesResource(AsyncAPIResource):
         region_id: int | None = None,
         include_prices: bool | NotGiven = NOT_GIVEN,
         private: str | NotGiven = NOT_GIVEN,
-        tag_key: List[str] | NotGiven = NOT_GIVEN,
+        tag_key: SequenceNotStr[str] | NotGiven = NOT_GIVEN,
         tag_key_value: str | NotGiven = NOT_GIVEN,
         visibility: Literal["private", "public", "shared"] | NotGiven = NOT_GIVEN,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.

gcore/resources/cloud/baremetal/servers.py

@@ -2,13 +2,13 @@
 
 from __future__ import annotations
 
-from typing import Dict, List, Union, Iterable, Optional
+from typing import Dict, Union, Iterable, Optional
 from datetime import datetime
 from typing_extensions import Literal
 
 import httpx
 
-from ...._types import NOT_GIVEN, Body, Query, Headers, NotGiven
+from ...._types import NOT_GIVEN, Body, Query, Headers, NotGiven, SequenceNotStr
 from ...._utils import maybe_transform, async_maybe_transform
 from ...._compat import cached_property
 from ...._resource import SyncAPIResource, AsyncAPIResource
@@ -206,7 +206,7 @@ class ServersResource(SyncAPIResource):
         ]
         | NotGiven = NOT_GIVEN,
         tag_key_value: str | NotGiven = NOT_GIVEN,
-        tag_value: List[str] | NotGiven = NOT_GIVEN,
+        tag_value: SequenceNotStr[str] | NotGiven = NOT_GIVEN,
         type_ddos_profile: Literal["basic", "advanced"] | NotGiven = NOT_GIVEN,
         uuid: str | NotGiven = NOT_GIVEN,
         with_ddos: bool | NotGiven = NOT_GIVEN,
@@ -350,6 +350,12 @@ class ServersResource(SyncAPIResource):
         Rebuild a bare metal server with a new image while preserving its configuration.
 
         Args:
+          project_id: Project ID
+
+          region_id: Region ID
+
+          server_id: Server ID
+
           image_id: Image ID
 
           user_data: String in base64 format. Must not be passed together with 'username' or
@@ -682,7 +688,7 @@ class AsyncServersResource(AsyncAPIResource):
         ]
         | NotGiven = NOT_GIVEN,
         tag_key_value: str | NotGiven = NOT_GIVEN,
-        tag_value: List[str] | NotGiven = NOT_GIVEN,
+        tag_value: SequenceNotStr[str] | NotGiven = NOT_GIVEN,
         type_ddos_profile: Literal["basic", "advanced"] | NotGiven = NOT_GIVEN,
         uuid: str | NotGiven = NOT_GIVEN,
         with_ddos: bool | NotGiven = NOT_GIVEN,
@@ -826,6 +832,12 @@ class AsyncServersResource(AsyncAPIResource):
         Rebuild a bare metal server with a new image while preserving its configuration.
 
         Args:
+          project_id: Project ID
+
+          region_id: Region ID
+
+          server_id: Server ID
+
           image_id: Image ID
 
           user_data: String in base64 format. Must not be passed together with 'username' or

gcore/resources/cloud/cloud.py

@@ -10,6 +10,14 @@ from .tasks import (
     TasksResourceWithStreamingResponse,
     AsyncTasksResourceWithStreamingResponse,
 )
+from .k8s.k8s import (
+    K8sResource,
+    AsyncK8sResource,
+    K8sResourceWithRawResponse,
+    AsyncK8sResourceWithRawResponse,
+    K8sResourceWithStreamingResponse,
+    AsyncK8sResourceWithStreamingResponse,
+)
 from .regions import (
     RegionsResource,
     AsyncRegionsResource,
@@ -297,6 +305,10 @@ class CloudResource(SyncAPIResource):
     def instances(self) -> InstancesResource:
         return InstancesResource(self._client)
 
+    @cached_property
+    def k8s(self) -> K8sResource:
+        return K8sResource(self._client)
+
     @cached_property
     def audit_logs(self) -> AuditLogsResource:
         return AuditLogsResource(self._client)
@@ -418,6 +430,10 @@ class AsyncCloudResource(AsyncAPIResource):
     def instances(self) -> AsyncInstancesResource:
         return AsyncInstancesResource(self._client)
 
+    @cached_property
+    def k8s(self) -> AsyncK8sResource:
+        return AsyncK8sResource(self._client)
+
     @cached_property
     def audit_logs(self) -> AsyncAuditLogsResource:
         return AsyncAuditLogsResource(self._client)
@@ -542,6 +558,10 @@ class CloudResourceWithRawResponse:
     def instances(self) -> InstancesResourceWithRawResponse:
         return InstancesResourceWithRawResponse(self._cloud.instances)
 
+    @cached_property
+    def k8s(self) -> K8sResourceWithRawResponse:
+        return K8sResourceWithRawResponse(self._cloud.k8s)
+
     @cached_property
     def audit_logs(self) -> AuditLogsResourceWithRawResponse:
         return AuditLogsResourceWithRawResponse(self._cloud.audit_logs)
@@ -647,6 +667,10 @@ class AsyncCloudResourceWithRawResponse:
     def instances(self) -> AsyncInstancesResourceWithRawResponse:
         return AsyncInstancesResourceWithRawResponse(self._cloud.instances)
 
+    @cached_property
+    def k8s(self) -> AsyncK8sResourceWithRawResponse:
+        return AsyncK8sResourceWithRawResponse(self._cloud.k8s)
+
     @cached_property
     def audit_logs(self) -> AsyncAuditLogsResourceWithRawResponse:
         return AsyncAuditLogsResourceWithRawResponse(self._cloud.audit_logs)
@@ -752,6 +776,10 @@ class CloudResourceWithStreamingResponse:
     def instances(self) -> InstancesResourceWithStreamingResponse:
         return InstancesResourceWithStreamingResponse(self._cloud.instances)
 
+    @cached_property
+    def k8s(self) -> K8sResourceWithStreamingResponse:
+        return K8sResourceWithStreamingResponse(self._cloud.k8s)
+
     @cached_property
     def audit_logs(self) -> AuditLogsResourceWithStreamingResponse:
         return AuditLogsResourceWithStreamingResponse(self._cloud.audit_logs)
@@ -857,6 +885,10 @@ class AsyncCloudResourceWithStreamingResponse:
     def instances(self) -> AsyncInstancesResourceWithStreamingResponse:
         return AsyncInstancesResourceWithStreamingResponse(self._cloud.instances)
 
+    @cached_property
+    def k8s(self) -> AsyncK8sResourceWithStreamingResponse:
+        return AsyncK8sResourceWithStreamingResponse(self._cloud.k8s)
+
     @cached_property
     def audit_logs(self) -> AsyncAuditLogsResourceWithStreamingResponse:
         return AsyncAuditLogsResourceWithStreamingResponse(self._cloud.audit_logs)

gcore/resources/cloud/cost_reports.py

@@ -171,13 +171,13 @@ class CostReportsResource(SyncAPIResource):
     def get_aggregated_monthly(
         self,
         *,
-        time_from: Union[str, datetime],
-        time_to: Union[str, datetime],
         regions: Iterable[int] | NotGiven = NOT_GIVEN,
         response_format: Literal["csv_totals", "json"] | NotGiven = NOT_GIVEN,
         rounding: bool | NotGiven = NOT_GIVEN,
         schema_filter: cost_report_get_aggregated_monthly_params.SchemaFilter | NotGiven = NOT_GIVEN,
         tags: cost_report_get_aggregated_monthly_params.Tags | NotGiven = NOT_GIVEN,
+        time_from: Union[str, datetime] | NotGiven = NOT_GIVEN,
+        time_to: Union[str, datetime] | NotGiven = NOT_GIVEN,
         types: List[
             Literal[
                 "ai_cluster",
@@ -208,6 +208,7 @@ class CostReportsResource(SyncAPIResource):
             ]
         ]
         | NotGiven = NOT_GIVEN,
+        year_month: str | NotGiven = NOT_GIVEN,
         # 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,
@@ -227,10 +228,6 @@ class CostReportsResource(SyncAPIResource):
         hours until the servers are back online and the missing data is filled in.
 
         Args:
-          time_from: Beginning of the period: YYYY-mm
-
-          time_to: End of the period: YYYY-mm
-
           regions: List of region IDs.
 
           response_format: Format of the response (`csv_totals` or json).
@@ -241,8 +238,14 @@ class CostReportsResource(SyncAPIResource):
 
           tags: Filter by tags
 
+          time_from: Deprecated. Use `year_month` instead. Beginning of the period: YYYY-mm
+
+          time_to: Deprecated. Use `year_month` instead. End of the period: YYYY-mm
+
           types: List of resource types to be filtered in the report.
 
+          year_month: Year and month in the format YYYY-MM
+
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request
@@ -255,14 +258,15 @@ class CostReportsResource(SyncAPIResource):
             "/cloud/v1/reservation_cost_report/totals",
             body=maybe_transform(
                 {
-                    "time_from": time_from,
-                    "time_to": time_to,
                     "regions": regions,
                     "response_format": response_format,
                     "rounding": rounding,
                     "schema_filter": schema_filter,
                     "tags": tags,
+                    "time_from": time_from,
+                    "time_to": time_to,
                     "types": types,
+                    "year_month": year_month,
                 },
                 cost_report_get_aggregated_monthly_params.CostReportGetAggregatedMonthlyParams,
             ),
@@ -543,13 +547,13 @@ class AsyncCostReportsResource(AsyncAPIResource):
     async def get_aggregated_monthly(
         self,
         *,
-        time_from: Union[str, datetime],
-        time_to: Union[str, datetime],
         regions: Iterable[int] | NotGiven = NOT_GIVEN,
         response_format: Literal["csv_totals", "json"] | NotGiven = NOT_GIVEN,
         rounding: bool | NotGiven = NOT_GIVEN,
         schema_filter: cost_report_get_aggregated_monthly_params.SchemaFilter | NotGiven = NOT_GIVEN,
         tags: cost_report_get_aggregated_monthly_params.Tags | NotGiven = NOT_GIVEN,
+        time_from: Union[str, datetime] | NotGiven = NOT_GIVEN,
+        time_to: Union[str, datetime] | NotGiven = NOT_GIVEN,
         types: List[
             Literal[
                 "ai_cluster",
@@ -580,6 +584,7 @@ class AsyncCostReportsResource(AsyncAPIResource):
             ]
         ]
         | NotGiven = NOT_GIVEN,
+        year_month: str | NotGiven = NOT_GIVEN,
         # 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,
@@ -599,10 +604,6 @@ class AsyncCostReportsResource(AsyncAPIResource):
         hours until the servers are back online and the missing data is filled in.
 
         Args:
-          time_from: Beginning of the period: YYYY-mm
-
-          time_to: End of the period: YYYY-mm
-
           regions: List of region IDs.
 
           response_format: Format of the response (`csv_totals` or json).
@@ -613,8 +614,14 @@ class AsyncCostReportsResource(AsyncAPIResource):
 
           tags: Filter by tags
 
+          time_from: Deprecated. Use `year_month` instead. Beginning of the period: YYYY-mm
+
+          time_to: Deprecated. Use `year_month` instead. End of the period: YYYY-mm
+
           types: List of resource types to be filtered in the report.
 
+          year_month: Year and month in the format YYYY-MM
+
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request
@@ -627,14 +634,15 @@ class AsyncCostReportsResource(AsyncAPIResource):
             "/cloud/v1/reservation_cost_report/totals",
             body=await async_maybe_transform(
                 {
-                    "time_from": time_from,
-                    "time_to": time_to,
                     "regions": regions,
                     "response_format": response_format,
                     "rounding": rounding,
                     "schema_filter": schema_filter,
                     "tags": tags,
+                    "time_from": time_from,
+                    "time_to": time_to,
                     "types": types,
+                    "year_month": year_month,
                 },
                 cost_report_get_aggregated_monthly_params.CostReportGetAggregatedMonthlyParams,
             ),

gcore/resources/cloud/file_shares/access_rules.py

@@ -116,7 +116,7 @@ class AccessRulesResource(SyncAPIResource):
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
     ) -> AccessRuleList:
         """
-        Get file share access rules
+        List file share access rules
 
         Args:
           project_id: Project ID
@@ -291,7 +291,7 @@ class AsyncAccessRulesResource(AsyncAPIResource):
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
     ) -> AccessRuleList:
         """
-        Get file share access rules
+        List file share access rules
 
         Args:
           project_id: Project ID