gcore 0.9.0__py3-none-any.whl → 0.11.0__py3-none-any.whl

gcore/resources/storage/locations.py

@@ -0,0 +1,190 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+import httpx
+
+from ..._types import NOT_GIVEN, Body, Query, Headers, NotGiven
+from ..._utils import maybe_transform
+from ..._compat import cached_property
+from ..._resource import SyncAPIResource, AsyncAPIResource
+from ..._response import (
+    to_raw_response_wrapper,
+    to_streamed_response_wrapper,
+    async_to_raw_response_wrapper,
+    async_to_streamed_response_wrapper,
+)
+from ...pagination import SyncOffsetPage, AsyncOffsetPage
+from ..._base_client import AsyncPaginator, make_request_options
+from ...types.storage import location_list_params
+from ...types.storage.location import Location
+
+__all__ = ["LocationsResource", "AsyncLocationsResource"]
+
+
+class LocationsResource(SyncAPIResource):
+    @cached_property
+    def with_raw_response(self) -> LocationsResourceWithRawResponse:
+        """
+        This property can be used as a prefix for any HTTP method call to return
+        the raw response object instead of the parsed content.
+
+        For more information, see https://www.github.com/G-Core/gcore-python#accessing-raw-response-data-eg-headers
+        """
+        return LocationsResourceWithRawResponse(self)
+
+    @cached_property
+    def with_streaming_response(self) -> LocationsResourceWithStreamingResponse:
+        """
+        An alternative to `.with_raw_response` that doesn't eagerly read the response body.
+
+        For more information, see https://www.github.com/G-Core/gcore-python#with_streaming_response
+        """
+        return LocationsResourceWithStreamingResponse(self)
+
+    def list(
+        self,
+        *,
+        limit: int | NotGiven = NOT_GIVEN,
+        offset: int | 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,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
+    ) -> SyncOffsetPage[Location]:
+        """Returns available storage locations where you can create storages.
+
+        Each location
+        represents a geographic region with specific data center facilities.
+
+        Args:
+          extra_headers: Send extra headers
+
+          extra_query: Add additional query parameters to the request
+
+          extra_body: Add additional JSON properties to the request
+
+          timeout: Override the client-level default timeout for this request, in seconds
+        """
+        return self._get_api_list(
+            "/storage/provisioning/v2/locations",
+            page=SyncOffsetPage[Location],
+            options=make_request_options(
+                extra_headers=extra_headers,
+                extra_query=extra_query,
+                extra_body=extra_body,
+                timeout=timeout,
+                query=maybe_transform(
+                    {
+                        "limit": limit,
+                        "offset": offset,
+                    },
+                    location_list_params.LocationListParams,
+                ),
+            ),
+            model=Location,
+        )
+
+
+class AsyncLocationsResource(AsyncAPIResource):
+    @cached_property
+    def with_raw_response(self) -> AsyncLocationsResourceWithRawResponse:
+        """
+        This property can be used as a prefix for any HTTP method call to return
+        the raw response object instead of the parsed content.
+
+        For more information, see https://www.github.com/G-Core/gcore-python#accessing-raw-response-data-eg-headers
+        """
+        return AsyncLocationsResourceWithRawResponse(self)
+
+    @cached_property
+    def with_streaming_response(self) -> AsyncLocationsResourceWithStreamingResponse:
+        """
+        An alternative to `.with_raw_response` that doesn't eagerly read the response body.
+
+        For more information, see https://www.github.com/G-Core/gcore-python#with_streaming_response
+        """
+        return AsyncLocationsResourceWithStreamingResponse(self)
+
+    def list(
+        self,
+        *,
+        limit: int | NotGiven = NOT_GIVEN,
+        offset: int | 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,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
+    ) -> AsyncPaginator[Location, AsyncOffsetPage[Location]]:
+        """Returns available storage locations where you can create storages.
+
+        Each location
+        represents a geographic region with specific data center facilities.
+
+        Args:
+          extra_headers: Send extra headers
+
+          extra_query: Add additional query parameters to the request
+
+          extra_body: Add additional JSON properties to the request
+
+          timeout: Override the client-level default timeout for this request, in seconds
+        """
+        return self._get_api_list(
+            "/storage/provisioning/v2/locations",
+            page=AsyncOffsetPage[Location],
+            options=make_request_options(
+                extra_headers=extra_headers,
+                extra_query=extra_query,
+                extra_body=extra_body,
+                timeout=timeout,
+                query=maybe_transform(
+                    {
+                        "limit": limit,
+                        "offset": offset,
+                    },
+                    location_list_params.LocationListParams,
+                ),
+            ),
+            model=Location,
+        )
+
+
+class LocationsResourceWithRawResponse:
+    def __init__(self, locations: LocationsResource) -> None:
+        self._locations = locations
+
+        self.list = to_raw_response_wrapper(
+            locations.list,
+        )
+
+
+class AsyncLocationsResourceWithRawResponse:
+    def __init__(self, locations: AsyncLocationsResource) -> None:
+        self._locations = locations
+
+        self.list = async_to_raw_response_wrapper(
+            locations.list,
+        )
+
+
+class LocationsResourceWithStreamingResponse:
+    def __init__(self, locations: LocationsResource) -> None:
+        self._locations = locations
+
+        self.list = to_streamed_response_wrapper(
+            locations.list,
+        )
+
+
+class AsyncLocationsResourceWithStreamingResponse:
+    def __init__(self, locations: AsyncLocationsResource) -> None:
+        self._locations = locations
+
+        self.list = async_to_streamed_response_wrapper(
+            locations.list,
+        )

gcore/resources/storage/statistics.py

@@ -0,0 +1,364 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+import httpx
+
+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
+from ..._response import (
+    to_raw_response_wrapper,
+    to_streamed_response_wrapper,
+    async_to_raw_response_wrapper,
+    async_to_streamed_response_wrapper,
+)
+from ..._base_client import make_request_options
+from ...types.storage import statistic_get_usage_series_params, statistic_get_usage_aggregated_params
+from ...types.storage.usage_total import UsageTotal
+from ...types.storage.statistic_get_usage_series_response import StatisticGetUsageSeriesResponse
+
+__all__ = ["StatisticsResource", "AsyncStatisticsResource"]
+
+
+class StatisticsResource(SyncAPIResource):
+    @cached_property
+    def with_raw_response(self) -> StatisticsResourceWithRawResponse:
+        """
+        This property can be used as a prefix for any HTTP method call to return
+        the raw response object instead of the parsed content.
+
+        For more information, see https://www.github.com/G-Core/gcore-python#accessing-raw-response-data-eg-headers
+        """
+        return StatisticsResourceWithRawResponse(self)
+
+    @cached_property
+    def with_streaming_response(self) -> StatisticsResourceWithStreamingResponse:
+        """
+        An alternative to `.with_raw_response` that doesn't eagerly read the response body.
+
+        For more information, see https://www.github.com/G-Core/gcore-python#with_streaming_response
+        """
+        return StatisticsResourceWithStreamingResponse(self)
+
+    def get_usage_aggregated(
+        self,
+        *,
+        from_: str | NotGiven = NOT_GIVEN,
+        locations: SequenceNotStr[str] | NotGiven = NOT_GIVEN,
+        storages: SequenceNotStr[str] | NotGiven = NOT_GIVEN,
+        to: 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,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
+    ) -> UsageTotal:
+        """
+        Consumption statistics is updated in near real-time as a standard practice.
+        However, the frequency of updates can vary, but they are typically available
+        within a 60 minutes period. Exceptions, such as maintenance periods, may delay
+        data beyond 60 minutes until servers resume and backfill missing statistics.
+
+        Shows storage total usage data in filtered by storages, locations and interval.
+
+        Args:
+          from_: a From date filter
+
+          locations: a Locations list of filter
+
+          storages: a Storages list of filter
+
+          to: a To date filter
+
+          extra_headers: Send extra headers
+
+          extra_query: Add additional query parameters to the request
+
+          extra_body: Add additional JSON properties to the request
+
+          timeout: Override the client-level default timeout for this request, in seconds
+        """
+        return self._post(
+            "/storage/stats/v1/storage/usage/total",
+            body=maybe_transform(
+                {
+                    "from_": from_,
+                    "locations": locations,
+                    "storages": storages,
+                    "to": to,
+                },
+                statistic_get_usage_aggregated_params.StatisticGetUsageAggregatedParams,
+            ),
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=UsageTotal,
+        )
+
+    def get_usage_series(
+        self,
+        *,
+        from_: str | NotGiven = NOT_GIVEN,
+        granularity: str | NotGiven = NOT_GIVEN,
+        locations: SequenceNotStr[str] | NotGiven = NOT_GIVEN,
+        source: int | NotGiven = NOT_GIVEN,
+        storages: SequenceNotStr[str] | NotGiven = NOT_GIVEN,
+        to: str | NotGiven = NOT_GIVEN,
+        ts_string: bool | 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,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
+    ) -> StatisticGetUsageSeriesResponse:
+        """
+        Consumption statistics is updated in near real-time as a standard practice.
+        However, the frequency of updates can vary, but they are typically available
+        within a 60 minutes period. Exceptions, such as maintenance periods, may delay
+        data beyond 60 minutes until servers resume and backfill missing statistics.
+
+        Shows storage usage data in series format filtered by clients, storages and
+        interval.
+
+        Args:
+          from_: a From date filter
+
+          granularity: a Granularity is period of time for grouping data Valid values are: 1h, 12h, 24h
+
+          locations: a Locations list of filter
+
+          source: a Source is deprecated parameter
+
+          storages: a Storages list of filter
+
+          to: a To date filter
+
+          ts_string: a TsString is configurator of response time format switch response from unix
+              time format to RFC3339 (2006-01-02T15:04:05Z07:00)
+
+          extra_headers: Send extra headers
+
+          extra_query: Add additional query parameters to the request
+
+          extra_body: Add additional JSON properties to the request
+
+          timeout: Override the client-level default timeout for this request, in seconds
+        """
+        return self._post(
+            "/storage/stats/v1/storage/usage/series",
+            body=maybe_transform(
+                {
+                    "from_": from_,
+                    "granularity": granularity,
+                    "locations": locations,
+                    "source": source,
+                    "storages": storages,
+                    "to": to,
+                    "ts_string": ts_string,
+                },
+                statistic_get_usage_series_params.StatisticGetUsageSeriesParams,
+            ),
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=StatisticGetUsageSeriesResponse,
+        )
+
+
+class AsyncStatisticsResource(AsyncAPIResource):
+    @cached_property
+    def with_raw_response(self) -> AsyncStatisticsResourceWithRawResponse:
+        """
+        This property can be used as a prefix for any HTTP method call to return
+        the raw response object instead of the parsed content.
+
+        For more information, see https://www.github.com/G-Core/gcore-python#accessing-raw-response-data-eg-headers
+        """
+        return AsyncStatisticsResourceWithRawResponse(self)
+
+    @cached_property
+    def with_streaming_response(self) -> AsyncStatisticsResourceWithStreamingResponse:
+        """
+        An alternative to `.with_raw_response` that doesn't eagerly read the response body.
+
+        For more information, see https://www.github.com/G-Core/gcore-python#with_streaming_response
+        """
+        return AsyncStatisticsResourceWithStreamingResponse(self)
+
+    async def get_usage_aggregated(
+        self,
+        *,
+        from_: str | NotGiven = NOT_GIVEN,
+        locations: SequenceNotStr[str] | NotGiven = NOT_GIVEN,
+        storages: SequenceNotStr[str] | NotGiven = NOT_GIVEN,
+        to: 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,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
+    ) -> UsageTotal:
+        """
+        Consumption statistics is updated in near real-time as a standard practice.
+        However, the frequency of updates can vary, but they are typically available
+        within a 60 minutes period. Exceptions, such as maintenance periods, may delay
+        data beyond 60 minutes until servers resume and backfill missing statistics.
+
+        Shows storage total usage data in filtered by storages, locations and interval.
+
+        Args:
+          from_: a From date filter
+
+          locations: a Locations list of filter
+
+          storages: a Storages list of filter
+
+          to: a To date filter
+
+          extra_headers: Send extra headers
+
+          extra_query: Add additional query parameters to the request
+
+          extra_body: Add additional JSON properties to the request
+
+          timeout: Override the client-level default timeout for this request, in seconds
+        """
+        return await self._post(
+            "/storage/stats/v1/storage/usage/total",
+            body=await async_maybe_transform(
+                {
+                    "from_": from_,
+                    "locations": locations,
+                    "storages": storages,
+                    "to": to,
+                },
+                statistic_get_usage_aggregated_params.StatisticGetUsageAggregatedParams,
+            ),
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=UsageTotal,
+        )
+
+    async def get_usage_series(
+        self,
+        *,
+        from_: str | NotGiven = NOT_GIVEN,
+        granularity: str | NotGiven = NOT_GIVEN,
+        locations: SequenceNotStr[str] | NotGiven = NOT_GIVEN,
+        source: int | NotGiven = NOT_GIVEN,
+        storages: SequenceNotStr[str] | NotGiven = NOT_GIVEN,
+        to: str | NotGiven = NOT_GIVEN,
+        ts_string: bool | 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,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
+    ) -> StatisticGetUsageSeriesResponse:
+        """
+        Consumption statistics is updated in near real-time as a standard practice.
+        However, the frequency of updates can vary, but they are typically available
+        within a 60 minutes period. Exceptions, such as maintenance periods, may delay
+        data beyond 60 minutes until servers resume and backfill missing statistics.
+
+        Shows storage usage data in series format filtered by clients, storages and
+        interval.
+
+        Args:
+          from_: a From date filter
+
+          granularity: a Granularity is period of time for grouping data Valid values are: 1h, 12h, 24h
+
+          locations: a Locations list of filter
+
+          source: a Source is deprecated parameter
+
+          storages: a Storages list of filter
+
+          to: a To date filter
+
+          ts_string: a TsString is configurator of response time format switch response from unix
+              time format to RFC3339 (2006-01-02T15:04:05Z07:00)
+
+          extra_headers: Send extra headers
+
+          extra_query: Add additional query parameters to the request
+
+          extra_body: Add additional JSON properties to the request
+
+          timeout: Override the client-level default timeout for this request, in seconds
+        """
+        return await self._post(
+            "/storage/stats/v1/storage/usage/series",
+            body=await async_maybe_transform(
+                {
+                    "from_": from_,
+                    "granularity": granularity,
+                    "locations": locations,
+                    "source": source,
+                    "storages": storages,
+                    "to": to,
+                    "ts_string": ts_string,
+                },
+                statistic_get_usage_series_params.StatisticGetUsageSeriesParams,
+            ),
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=StatisticGetUsageSeriesResponse,
+        )
+
+
+class StatisticsResourceWithRawResponse:
+    def __init__(self, statistics: StatisticsResource) -> None:
+        self._statistics = statistics
+
+        self.get_usage_aggregated = to_raw_response_wrapper(
+            statistics.get_usage_aggregated,
+        )
+        self.get_usage_series = to_raw_response_wrapper(
+            statistics.get_usage_series,
+        )
+
+
+class AsyncStatisticsResourceWithRawResponse:
+    def __init__(self, statistics: AsyncStatisticsResource) -> None:
+        self._statistics = statistics
+
+        self.get_usage_aggregated = async_to_raw_response_wrapper(
+            statistics.get_usage_aggregated,
+        )
+        self.get_usage_series = async_to_raw_response_wrapper(
+            statistics.get_usage_series,
+        )
+
+
+class StatisticsResourceWithStreamingResponse:
+    def __init__(self, statistics: StatisticsResource) -> None:
+        self._statistics = statistics
+
+        self.get_usage_aggregated = to_streamed_response_wrapper(
+            statistics.get_usage_aggregated,
+        )
+        self.get_usage_series = to_streamed_response_wrapper(
+            statistics.get_usage_series,
+        )
+
+
+class AsyncStatisticsResourceWithStreamingResponse:
+    def __init__(self, statistics: AsyncStatisticsResource) -> None:
+        self._statistics = statistics
+
+        self.get_usage_aggregated = async_to_streamed_response_wrapper(
+            statistics.get_usage_aggregated,
+        )
+        self.get_usage_series = async_to_streamed_response_wrapper(
+            statistics.get_usage_series,
+        )