gcore 0.5.0__py3-none-any.whl → 0.7.0__py3-none-any.whl

gcore/resources/cloud/audit_logs.py

@@ -0,0 +1,480 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing import List, Union, Iterable
+from datetime import datetime
+from typing_extensions import Literal
+
+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 ...types.cloud import audit_log_list_params
+from ..._base_client import AsyncPaginator, make_request_options
+from ...types.cloud.audit_log_entry import AuditLogEntry
+
+__all__ = ["AuditLogsResource", "AsyncAuditLogsResource"]
+
+
+class AuditLogsResource(SyncAPIResource):
+    @cached_property
+    def with_raw_response(self) -> AuditLogsResourceWithRawResponse:
+        """
+        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 AuditLogsResourceWithRawResponse(self)
+
+    @cached_property
+    def with_streaming_response(self) -> AuditLogsResourceWithStreamingResponse:
+        """
+        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 AuditLogsResourceWithStreamingResponse(self)
+
+    def list(
+        self,
+        *,
+        action_type: List[
+            Literal[
+                "activate",
+                "attach",
+                "change_logging_resources",
+                "create",
+                "create_access_rule",
+                "deactivate",
+                "delete",
+                "delete_access_rule",
+                "delete_metadata",
+                "detach",
+                "disable_logging",
+                "disable_portsecurity",
+                "download",
+                "enable_logging",
+                "enable_portsecurity",
+                "failover",
+                "put_into_servergroup",
+                "reboot",
+                "reboot_hard",
+                "rebuild",
+                "regenerate_credentials",
+                "remove_from_servergroup",
+                "replace_metadata",
+                "resize",
+                "resume",
+                "retype",
+                "revert",
+                "scale_down",
+                "scale_up",
+                "start",
+                "stop",
+                "suspend",
+                "update",
+                "update_metadata",
+                "upgrade",
+            ]
+        ]
+        | NotGiven = NOT_GIVEN,
+        api_group: List[
+            Literal[
+                "ai_cluster",
+                "backup_service",
+                "caas_container",
+                "caas_key",
+                "caas_pull_secret",
+                "dbaas_postgres",
+                "ddos_profile",
+                "faas_function",
+                "faas_key",
+                "faas_namespace",
+                "file_shares",
+                "floating_ip",
+                "image",
+                "inference_at_the_edge",
+                "instance",
+                "instance_isolation",
+                "k8s_cluster",
+                "k8s_cluster_template",
+                "k8s_pool",
+                "laas",
+                "laas_topic",
+                "lb_health_monitor",
+                "lb_l7policy",
+                "lb_l7rule",
+                "lblistener",
+                "lbpool",
+                "lbpool_member",
+                "lifecycle_policy",
+                "lifecycle_policy_volume_member",
+                "loadbalancer",
+                "network",
+                "port",
+                "project",
+                "quota_limit_request",
+                "registry",
+                "reservation",
+                "reserved_fixed_ip",
+                "role",
+                "router",
+                "secret",
+                "securitygroup",
+                "securitygrouprule",
+                "servergroup",
+                "shared_flavor",
+                "shared_image",
+                "shared_network",
+                "snapshot",
+                "snapshot_schedule",
+                "ssh_key",
+                "subnet",
+                "user",
+                "vip_ip_addresses",
+                "volume",
+            ]
+        ]
+        | NotGiven = NOT_GIVEN,
+        from_timestamp: Union[str, datetime] | NotGiven = NOT_GIVEN,
+        limit: int | NotGiven = NOT_GIVEN,
+        offset: int | NotGiven = NOT_GIVEN,
+        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,
+        search_field: str | NotGiven = NOT_GIVEN,
+        sorting: Literal["asc", "desc"] | NotGiven = NOT_GIVEN,
+        to_timestamp: Union[str, datetime] | 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[AuditLogEntry]:
+        """
+        Retrieve user action log for one client or a set of projects
+
+        Args:
+          action_type: User action type. Several options can be specified.
+
+          api_group: API group that requested action belongs to. Several options can be specified.
+
+          from_timestamp: ISO formatted datetime string. Starting timestamp from which user actions are
+              requested
+
+          limit: Optional. Limit the number of returned items
+
+          offset: Optional. Offset value is used to exclude the first set of records from the
+              result
+
+          order_by: Sorting by timestamp. Oldest first, or most recent first
+
+          project_id: Project ID. Several options can be specified.
+
+          region_id: Region ID. Several options can be specified.
+
+          resource_id: Resource ID. Several options can be specified.
+
+          search_field: Extra search field for common object properties such as name, IP address, or
+              other, depending on the `resource_type`
+
+          sorting: (DEPRECATED Use '`order_by`' instead) Sorting by timestamp. Oldest first, or
+              most recent first
+
+          to_timestamp: ISO formatted datetime string. Ending timestamp until which user actions are
+              requested
+
+          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(
+            "/cloud/v1/user_actions",
+            page=SyncOffsetPage[AuditLogEntry],
+            options=make_request_options(
+                extra_headers=extra_headers,
+                extra_query=extra_query,
+                extra_body=extra_body,
+                timeout=timeout,
+                query=maybe_transform(
+                    {
+                        "action_type": action_type,
+                        "api_group": api_group,
+                        "from_timestamp": from_timestamp,
+                        "limit": limit,
+                        "offset": offset,
+                        "order_by": order_by,
+                        "project_id": project_id,
+                        "region_id": region_id,
+                        "resource_id": resource_id,
+                        "search_field": search_field,
+                        "sorting": sorting,
+                        "to_timestamp": to_timestamp,
+                    },
+                    audit_log_list_params.AuditLogListParams,
+                ),
+            ),
+            model=AuditLogEntry,
+        )
+
+
+class AsyncAuditLogsResource(AsyncAPIResource):
+    @cached_property
+    def with_raw_response(self) -> AsyncAuditLogsResourceWithRawResponse:
+        """
+        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 AsyncAuditLogsResourceWithRawResponse(self)
+
+    @cached_property
+    def with_streaming_response(self) -> AsyncAuditLogsResourceWithStreamingResponse:
+        """
+        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 AsyncAuditLogsResourceWithStreamingResponse(self)
+
+    def list(
+        self,
+        *,
+        action_type: List[
+            Literal[
+                "activate",
+                "attach",
+                "change_logging_resources",
+                "create",
+                "create_access_rule",
+                "deactivate",
+                "delete",
+                "delete_access_rule",
+                "delete_metadata",
+                "detach",
+                "disable_logging",
+                "disable_portsecurity",
+                "download",
+                "enable_logging",
+                "enable_portsecurity",
+                "failover",
+                "put_into_servergroup",
+                "reboot",
+                "reboot_hard",
+                "rebuild",
+                "regenerate_credentials",
+                "remove_from_servergroup",
+                "replace_metadata",
+                "resize",
+                "resume",
+                "retype",
+                "revert",
+                "scale_down",
+                "scale_up",
+                "start",
+                "stop",
+                "suspend",
+                "update",
+                "update_metadata",
+                "upgrade",
+            ]
+        ]
+        | NotGiven = NOT_GIVEN,
+        api_group: List[
+            Literal[
+                "ai_cluster",
+                "backup_service",
+                "caas_container",
+                "caas_key",
+                "caas_pull_secret",
+                "dbaas_postgres",
+                "ddos_profile",
+                "faas_function",
+                "faas_key",
+                "faas_namespace",
+                "file_shares",
+                "floating_ip",
+                "image",
+                "inference_at_the_edge",
+                "instance",
+                "instance_isolation",
+                "k8s_cluster",
+                "k8s_cluster_template",
+                "k8s_pool",
+                "laas",
+                "laas_topic",
+                "lb_health_monitor",
+                "lb_l7policy",
+                "lb_l7rule",
+                "lblistener",
+                "lbpool",
+                "lbpool_member",
+                "lifecycle_policy",
+                "lifecycle_policy_volume_member",
+                "loadbalancer",
+                "network",
+                "port",
+                "project",
+                "quota_limit_request",
+                "registry",
+                "reservation",
+                "reserved_fixed_ip",
+                "role",
+                "router",
+                "secret",
+                "securitygroup",
+                "securitygrouprule",
+                "servergroup",
+                "shared_flavor",
+                "shared_image",
+                "shared_network",
+                "snapshot",
+                "snapshot_schedule",
+                "ssh_key",
+                "subnet",
+                "user",
+                "vip_ip_addresses",
+                "volume",
+            ]
+        ]
+        | NotGiven = NOT_GIVEN,
+        from_timestamp: Union[str, datetime] | NotGiven = NOT_GIVEN,
+        limit: int | NotGiven = NOT_GIVEN,
+        offset: int | NotGiven = NOT_GIVEN,
+        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,
+        search_field: str | NotGiven = NOT_GIVEN,
+        sorting: Literal["asc", "desc"] | NotGiven = NOT_GIVEN,
+        to_timestamp: Union[str, datetime] | 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[AuditLogEntry, AsyncOffsetPage[AuditLogEntry]]:
+        """
+        Retrieve user action log for one client or a set of projects
+
+        Args:
+          action_type: User action type. Several options can be specified.
+
+          api_group: API group that requested action belongs to. Several options can be specified.
+
+          from_timestamp: ISO formatted datetime string. Starting timestamp from which user actions are
+              requested
+
+          limit: Optional. Limit the number of returned items
+
+          offset: Optional. Offset value is used to exclude the first set of records from the
+              result
+
+          order_by: Sorting by timestamp. Oldest first, or most recent first
+
+          project_id: Project ID. Several options can be specified.
+
+          region_id: Region ID. Several options can be specified.
+
+          resource_id: Resource ID. Several options can be specified.
+
+          search_field: Extra search field for common object properties such as name, IP address, or
+              other, depending on the `resource_type`
+
+          sorting: (DEPRECATED Use '`order_by`' instead) Sorting by timestamp. Oldest first, or
+              most recent first
+
+          to_timestamp: ISO formatted datetime string. Ending timestamp until which user actions are
+              requested
+
+          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(
+            "/cloud/v1/user_actions",
+            page=AsyncOffsetPage[AuditLogEntry],
+            options=make_request_options(
+                extra_headers=extra_headers,
+                extra_query=extra_query,
+                extra_body=extra_body,
+                timeout=timeout,
+                query=maybe_transform(
+                    {
+                        "action_type": action_type,
+                        "api_group": api_group,
+                        "from_timestamp": from_timestamp,
+                        "limit": limit,
+                        "offset": offset,
+                        "order_by": order_by,
+                        "project_id": project_id,
+                        "region_id": region_id,
+                        "resource_id": resource_id,
+                        "search_field": search_field,
+                        "sorting": sorting,
+                        "to_timestamp": to_timestamp,
+                    },
+                    audit_log_list_params.AuditLogListParams,
+                ),
+            ),
+            model=AuditLogEntry,
+        )
+
+
+class AuditLogsResourceWithRawResponse:
+    def __init__(self, audit_logs: AuditLogsResource) -> None:
+        self._audit_logs = audit_logs
+
+        self.list = to_raw_response_wrapper(
+            audit_logs.list,
+        )
+
+
+class AsyncAuditLogsResourceWithRawResponse:
+    def __init__(self, audit_logs: AsyncAuditLogsResource) -> None:
+        self._audit_logs = audit_logs
+
+        self.list = async_to_raw_response_wrapper(
+            audit_logs.list,
+        )
+
+
+class AuditLogsResourceWithStreamingResponse:
+    def __init__(self, audit_logs: AuditLogsResource) -> None:
+        self._audit_logs = audit_logs
+
+        self.list = to_streamed_response_wrapper(
+            audit_logs.list,
+        )
+
+
+class AsyncAuditLogsResourceWithStreamingResponse:
+    def __init__(self, audit_logs: AsyncAuditLogsResource) -> None:
+        self._audit_logs = audit_logs
+
+        self.list = async_to_streamed_response_wrapper(
+            audit_logs.list,
+        )

gcore/resources/cloud/cloud.py

@@ -59,6 +59,14 @@ from .ip_ranges import (
     IPRangesResourceWithStreamingResponse,
     AsyncIPRangesResourceWithStreamingResponse,
 )
+from .audit_logs import (
+    AuditLogsResource,
+    AsyncAuditLogsResource,
+    AuditLogsResourceWithRawResponse,
+    AsyncAuditLogsResourceWithRawResponse,
+    AuditLogsResourceWithStreamingResponse,
+    AsyncAuditLogsResourceWithStreamingResponse,
+)
 from ..._resource import SyncAPIResource, AsyncAPIResource
 from .users.users import (
     UsersResource,
@@ -68,6 +76,14 @@ from .users.users import (
     UsersResourceWithStreamingResponse,
     AsyncUsersResourceWithStreamingResponse,
 )
+from .cost_reports import (
+    CostReportsResource,
+    AsyncCostReportsResource,
+    CostReportsResourceWithRawResponse,
+    AsyncCostReportsResourceWithRawResponse,
+    CostReportsResourceWithStreamingResponse,
+    AsyncCostReportsResourceWithStreamingResponse,
+)
 from .floating_ips import (
     FloatingIPsResource,
     AsyncFloatingIPsResource,
@@ -84,6 +100,14 @@ from .quotas.quotas import (
     QuotasResourceWithStreamingResponse,
     AsyncQuotasResourceWithStreamingResponse,
 )
+from .usage_reports import (
+    UsageReportsResource,
+    AsyncUsageReportsResource,
+    UsageReportsResourceWithRawResponse,
+    AsyncUsageReportsResourceWithRawResponse,
+    UsageReportsResourceWithStreamingResponse,
+    AsyncUsageReportsResourceWithStreamingResponse,
+)
 from .placement_groups import (
     PlacementGroupsResource,
     AsyncPlacementGroupsResource,
@@ -273,6 +297,18 @@ class CloudResource(SyncAPIResource):
     def instances(self) -> InstancesResource:
         return InstancesResource(self._client)
 
+    @cached_property
+    def audit_logs(self) -> AuditLogsResource:
+        return AuditLogsResource(self._client)
+
+    @cached_property
+    def cost_reports(self) -> CostReportsResource:
+        return CostReportsResource(self._client)
+
+    @cached_property
+    def usage_reports(self) -> UsageReportsResource:
+        return UsageReportsResource(self._client)
+
     @cached_property
     def with_raw_response(self) -> CloudResourceWithRawResponse:
         """
@@ -382,6 +418,18 @@ class AsyncCloudResource(AsyncAPIResource):
     def instances(self) -> AsyncInstancesResource:
         return AsyncInstancesResource(self._client)
 
+    @cached_property
+    def audit_logs(self) -> AsyncAuditLogsResource:
+        return AsyncAuditLogsResource(self._client)
+
+    @cached_property
+    def cost_reports(self) -> AsyncCostReportsResource:
+        return AsyncCostReportsResource(self._client)
+
+    @cached_property
+    def usage_reports(self) -> AsyncUsageReportsResource:
+        return AsyncUsageReportsResource(self._client)
+
     @cached_property
     def with_raw_response(self) -> AsyncCloudResourceWithRawResponse:
         """
@@ -494,6 +542,18 @@ class CloudResourceWithRawResponse:
     def instances(self) -> InstancesResourceWithRawResponse:
         return InstancesResourceWithRawResponse(self._cloud.instances)
 
+    @cached_property
+    def audit_logs(self) -> AuditLogsResourceWithRawResponse:
+        return AuditLogsResourceWithRawResponse(self._cloud.audit_logs)
+
+    @cached_property
+    def cost_reports(self) -> CostReportsResourceWithRawResponse:
+        return CostReportsResourceWithRawResponse(self._cloud.cost_reports)
+
+    @cached_property
+    def usage_reports(self) -> UsageReportsResourceWithRawResponse:
+        return UsageReportsResourceWithRawResponse(self._cloud.usage_reports)
+
 
 class AsyncCloudResourceWithRawResponse:
     def __init__(self, cloud: AsyncCloudResource) -> None:
@@ -587,6 +647,18 @@ class AsyncCloudResourceWithRawResponse:
     def instances(self) -> AsyncInstancesResourceWithRawResponse:
         return AsyncInstancesResourceWithRawResponse(self._cloud.instances)
 
+    @cached_property
+    def audit_logs(self) -> AsyncAuditLogsResourceWithRawResponse:
+        return AsyncAuditLogsResourceWithRawResponse(self._cloud.audit_logs)
+
+    @cached_property
+    def cost_reports(self) -> AsyncCostReportsResourceWithRawResponse:
+        return AsyncCostReportsResourceWithRawResponse(self._cloud.cost_reports)
+
+    @cached_property
+    def usage_reports(self) -> AsyncUsageReportsResourceWithRawResponse:
+        return AsyncUsageReportsResourceWithRawResponse(self._cloud.usage_reports)
+
 
 class CloudResourceWithStreamingResponse:
     def __init__(self, cloud: CloudResource) -> None:
@@ -680,6 +752,18 @@ class CloudResourceWithStreamingResponse:
     def instances(self) -> InstancesResourceWithStreamingResponse:
         return InstancesResourceWithStreamingResponse(self._cloud.instances)
 
+    @cached_property
+    def audit_logs(self) -> AuditLogsResourceWithStreamingResponse:
+        return AuditLogsResourceWithStreamingResponse(self._cloud.audit_logs)
+
+    @cached_property
+    def cost_reports(self) -> CostReportsResourceWithStreamingResponse:
+        return CostReportsResourceWithStreamingResponse(self._cloud.cost_reports)
+
+    @cached_property
+    def usage_reports(self) -> UsageReportsResourceWithStreamingResponse:
+        return UsageReportsResourceWithStreamingResponse(self._cloud.usage_reports)
+
 
 class AsyncCloudResourceWithStreamingResponse:
     def __init__(self, cloud: AsyncCloudResource) -> None:
@@ -772,3 +856,15 @@ class AsyncCloudResourceWithStreamingResponse:
     @cached_property
     def instances(self) -> AsyncInstancesResourceWithStreamingResponse:
         return AsyncInstancesResourceWithStreamingResponse(self._cloud.instances)
+
+    @cached_property
+    def audit_logs(self) -> AsyncAuditLogsResourceWithStreamingResponse:
+        return AsyncAuditLogsResourceWithStreamingResponse(self._cloud.audit_logs)
+
+    @cached_property
+    def cost_reports(self) -> AsyncCostReportsResourceWithStreamingResponse:
+        return AsyncCostReportsResourceWithStreamingResponse(self._cloud.cost_reports)
+
+    @cached_property
+    def usage_reports(self) -> AsyncUsageReportsResourceWithStreamingResponse:
+        return AsyncUsageReportsResourceWithStreamingResponse(self._cloud.usage_reports)