gcore 0.1.0__py3-none-any.whl

gcore/types/cloud/volume.py

@@ -0,0 +1,141 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import Dict, List, Optional
+from datetime import datetime
+from typing_extensions import Literal
+
+from pydantic import Field as FieldInfo
+
+from .tag import Tag
+from ..._models import BaseModel
+
+__all__ = ["Volume", "Attachment", "LimiterStats"]
+
+
+class Attachment(BaseModel):
+    attachment_id: str
+    """The unique identifier of the attachment object."""
+
+    volume_id: str
+    """The unique identifier of the attached volume."""
+
+    attached_at: Optional[datetime] = None
+    """The date and time when the attachment was created."""
+
+    device: Optional[str] = None
+    """The block device name inside the guest instance."""
+
+    flavor_id: Optional[str] = None
+    """The flavor ID of the instance."""
+
+    instance_name: Optional[str] = None
+    """The name of the instance if attached and the server name is known."""
+
+    server_id: Optional[str] = None
+    """The unique identifier of the instance."""
+
+
+class LimiterStats(BaseModel):
+    iops_base_limit: int
+    """The sustained IOPS (Input/Output Operations Per Second) limit."""
+
+    iops_burst_limit: int
+    """The burst IOPS limit."""
+
+    m_bps_base_limit: int = FieldInfo(alias="MBps_base_limit")
+    """The sustained bandwidth limit in megabytes per second (MBps)."""
+
+    m_bps_burst_limit: int = FieldInfo(alias="MBps_burst_limit")
+    """The burst bandwidth limit in megabytes per second (MBps)."""
+
+
+class Volume(BaseModel):
+    id: str
+    """The unique identifier of the volume."""
+
+    bootable: bool
+    """Indicates whether the volume is bootable."""
+
+    created_at: datetime
+    """The date and time when the volume was created."""
+
+    is_root_volume: bool
+    """Indicates whether this is a root volume."""
+
+    name: str
+    """The name of the volume."""
+
+    project_id: int
+    """Project ID."""
+
+    region: str
+    """The region where the volume is located."""
+
+    region_id: int
+    """The identifier of the region."""
+
+    size: int
+    """The size of the volume in gibibytes (GiB)."""
+
+    status: Literal[
+        "attaching",
+        "available",
+        "awaiting-transfer",
+        "backing-up",
+        "creating",
+        "deleting",
+        "detaching",
+        "downloading",
+        "error",
+        "error_backing-up",
+        "error_deleting",
+        "error_extending",
+        "error_restoring",
+        "extending",
+        "in-use",
+        "maintenance",
+        "reserved",
+        "restoring-backup",
+        "retyping",
+        "reverting",
+        "uploading",
+    ]
+    """The current status of the volume."""
+
+    tags: List[Tag]
+    """List of key-value tags associated with the resource.
+
+    A tag is a key-value pair that can be associated with a resource, enabling
+    efficient filtering and grouping for better organization and management. Some
+    tags are read-only and cannot be modified by the user. Tags are also integrated
+    with cost reports, allowing cost data to be filtered based on tag keys or
+    values.
+    """
+
+    volume_type: str
+    """The type of volume storage."""
+
+    attachments: Optional[List[Attachment]] = None
+    """List of attachments associated with the volume."""
+
+    creator_task_id: Optional[str] = None
+    """The ID of the task that created this volume."""
+
+    limiter_stats: Optional[LimiterStats] = None
+    """Schema representing the Quality of Service (QoS) parameters for a volume."""
+
+    snapshot_ids: Optional[List[str]] = None
+    """List of snapshot IDs associated with this volume."""
+
+    task_id: Optional[str] = None
+    """The UUID of the active task that currently holds a lock on the resource.
+
+    This lock prevents concurrent modifications to ensure consistency. If `null`,
+    the resource is not locked.
+    """
+
+    updated_at: Optional[datetime] = None
+    """The date and time when the volume was last updated."""
+
+    volume_image_metadata: Optional[Dict[str, str]] = None
+    """Image metadata for volumes created from an image."""

gcore/types/cloud/volume_attach_to_instance_params.py

@@ -0,0 +1,21 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing_extensions import Required, TypedDict
+
+__all__ = ["VolumeAttachToInstanceParams"]
+
+
+class VolumeAttachToInstanceParams(TypedDict, total=False):
+    project_id: int
+    """Project ID"""
+
+    region_id: int
+    """Region ID"""
+
+    instance_id: Required[str]
+    """Instance ID."""
+
+    attachment_tag: str
+    """Block device attachment tag (not exposed in the normal tags)."""

gcore/types/cloud/volume_change_type_params.py

@@ -0,0 +1,18 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing_extensions import Literal, Required, TypedDict
+
+__all__ = ["VolumeChangeTypeParams"]
+
+
+class VolumeChangeTypeParams(TypedDict, total=False):
+    project_id: int
+    """Project ID"""
+
+    region_id: int
+    """Region ID"""
+
+    volume_type: Required[Literal["ssd_hiiops", "standard"]]
+    """New volume type name"""

gcore/types/cloud/volume_create_params.py

@@ -0,0 +1,176 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing import Union, Iterable
+from typing_extensions import Literal, Required, TypeAlias, TypedDict
+
+from .tag_update_map_param import TagUpdateMapParam
+
+__all__ = [
+    "VolumeCreateParams",
+    "CreateVolumeFromImageSerializer",
+    "CreateVolumeFromSnapshotSerializer",
+    "CreateNewVolumeSerializer",
+]
+
+
+class CreateVolumeFromImageSerializer(TypedDict, total=False):
+    project_id: int
+    """Project ID"""
+
+    region_id: int
+    """Region ID"""
+
+    image_id: Required[str]
+    """Image ID"""
+
+    name: Required[str]
+    """Volume name"""
+
+    size: Required[int]
+    """Volume size in GiB"""
+
+    source: Required[Literal["image"]]
+    """Volume source type"""
+
+    attachment_tag: str
+    """Block device attachment tag (not exposed in the user tags).
+
+    Only used in conjunction with instance_id_to_attach_to
+    """
+
+    instance_id_to_attach_to: str
+    """instance_id to attach newly-created volume to"""
+
+    lifecycle_policy_ids: Iterable[int]
+    """
+    List of lifecycle policy IDs (snapshot creation schedules) to associate with the
+    volume
+    """
+
+    tags: TagUpdateMapParam
+    """Key-value tags to associate with the resource.
+
+    A tag is a key-value pair that can be associated with a resource, enabling
+    efficient filtering and grouping for better organization and management. Some
+    tags are read-only and cannot be modified by the user. Tags are also integrated
+    with cost reports, allowing cost data to be filtered based on tag keys or
+    values.
+    """
+
+    type_name: Literal["cold", "ssd_hiiops", "ssd_local", "ssd_lowlatency", "standard", "ultra"]
+    """Volume type.
+
+    Defaults to `standard`. If not specified for source `snapshot`, volume type will
+    be derived from the snapshot volume.
+    """
+
+
+class CreateVolumeFromSnapshotSerializer(TypedDict, total=False):
+    project_id: int
+    """Project ID"""
+
+    region_id: int
+    """Region ID"""
+
+    name: Required[str]
+    """Volume name"""
+
+    snapshot_id: Required[str]
+    """Snapshot ID"""
+
+    source: Required[Literal["snapshot"]]
+    """Volume source type"""
+
+    attachment_tag: str
+    """Block device attachment tag (not exposed in the user tags).
+
+    Only used in conjunction with instance_id_to_attach_to
+    """
+
+    instance_id_to_attach_to: str
+    """instance_id to attach newly-created volume to"""
+
+    lifecycle_policy_ids: Iterable[int]
+    """
+    List of lifecycle policy IDs (snapshot creation schedules) to associate with the
+    volume
+    """
+
+    size: int
+    """Volume size in GiB.
+
+    If specified, value must be equal to respective snapshot size
+    """
+
+    tags: TagUpdateMapParam
+    """Key-value tags to associate with the resource.
+
+    A tag is a key-value pair that can be associated with a resource, enabling
+    efficient filtering and grouping for better organization and management. Some
+    tags are read-only and cannot be modified by the user. Tags are also integrated
+    with cost reports, allowing cost data to be filtered based on tag keys or
+    values.
+    """
+
+    type_name: Literal["cold", "ssd_hiiops", "ssd_local", "ssd_lowlatency", "standard", "ultra"]
+    """Volume type.
+
+    Defaults to `standard`. If not specified for source `snapshot`, volume type will
+    be derived from the snapshot volume.
+    """
+
+
+class CreateNewVolumeSerializer(TypedDict, total=False):
+    project_id: int
+    """Project ID"""
+
+    region_id: int
+    """Region ID"""
+
+    name: Required[str]
+    """Volume name"""
+
+    size: Required[int]
+    """Volume size in GiB"""
+
+    source: Required[Literal["new-volume"]]
+    """Volume source type"""
+
+    attachment_tag: str
+    """Block device attachment tag (not exposed in the user tags).
+
+    Only used in conjunction with instance_id_to_attach_to
+    """
+
+    instance_id_to_attach_to: str
+    """instance_id to attach newly-created volume to"""
+
+    lifecycle_policy_ids: Iterable[int]
+    """
+    List of lifecycle policy IDs (snapshot creation schedules) to associate with the
+    volume
+    """
+
+    tags: TagUpdateMapParam
+    """Key-value tags to associate with the resource.
+
+    A tag is a key-value pair that can be associated with a resource, enabling
+    efficient filtering and grouping for better organization and management. Some
+    tags are read-only and cannot be modified by the user. Tags are also integrated
+    with cost reports, allowing cost data to be filtered based on tag keys or
+    values.
+    """
+
+    type_name: Literal["cold", "ssd_hiiops", "ssd_local", "ssd_lowlatency", "standard", "ultra"]
+    """Volume type.
+
+    Defaults to `standard`. If not specified for source `snapshot`, volume type will
+    be derived from the snapshot volume.
+    """
+
+
+VolumeCreateParams: TypeAlias = Union[
+    CreateVolumeFromImageSerializer, CreateVolumeFromSnapshotSerializer, CreateNewVolumeSerializer
+]

gcore/types/cloud/volume_delete_params.py

@@ -0,0 +1,18 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing_extensions import TypedDict
+
+__all__ = ["VolumeDeleteParams"]
+
+
+class VolumeDeleteParams(TypedDict, total=False):
+    project_id: int
+    """Project ID"""
+
+    region_id: int
+    """Region ID"""
+
+    snapshots: str
+    """Comma separated list of snapshot IDs to be deleted with the volume."""

gcore/types/cloud/volume_detach_from_instance_params.py

@@ -0,0 +1,18 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing_extensions import Required, TypedDict
+
+__all__ = ["VolumeDetachFromInstanceParams"]
+
+
+class VolumeDetachFromInstanceParams(TypedDict, total=False):
+    project_id: int
+    """Project ID"""
+
+    region_id: int
+    """Region ID"""
+
+    instance_id: Required[str]
+    """Instance ID"""

gcore/types/cloud/volume_list_params.py

@@ -0,0 +1,56 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing import List
+from typing_extensions import TypedDict
+
+__all__ = ["VolumeListParams"]
+
+
+class VolumeListParams(TypedDict, total=False):
+    project_id: int
+    """Project ID"""
+
+    region_id: int
+    """Region ID"""
+
+    bootable: bool
+    """Filter by bootable field"""
+
+    cluster_id: str
+    """Filter volumes by k8s cluster ID"""
+
+    has_attachments: bool
+    """Filter by the presence of attachments"""
+
+    id_part: str
+    """Filter the volume list result by the ID part of the volume"""
+
+    instance_id: str
+    """Filter volumes by instance ID"""
+
+    limit: int
+    """Optional. Limit the number of returned items"""
+
+    name_part: str
+    """
+    Filter volumes by name_part inclusion in volume name.Any substring can be used
+    and volumes will be returned with names containing the substring.
+    """
+
+    offset: int
+    """Optional.
+
+    Offset value is used to exclude the first set of records from the result
+    """
+
+    tag_key: List[str]
+    """Optional. Filter by tag keys. ?tag_key=key1&tag_key=key2"""
+
+    tag_key_value: str
+    """Optional.
+
+    Filter by tag key-value pairs. curl -G --data-urlencode "tag_key_value={"key":
+    "value"}" --url "https://example.com/cloud/v1/resource/1/1"
+    """

gcore/types/cloud/volume_resize_params.py

@@ -0,0 +1,18 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing_extensions import Required, TypedDict
+
+__all__ = ["VolumeResizeParams"]
+
+
+class VolumeResizeParams(TypedDict, total=False):
+    project_id: int
+    """Project ID"""
+
+    region_id: int
+    """Region ID"""
+
+    size: Required[int]
+    """New volume size in GiB"""

gcore/types/cloud/volume_update_params.py

@@ -0,0 +1,18 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing_extensions import Required, TypedDict
+
+__all__ = ["VolumeUpdateParams"]
+
+
+class VolumeUpdateParams(TypedDict, total=False):
+    project_id: int
+    """Project ID"""
+
+    region_id: int
+    """Region ID"""
+
+    name: Required[str]
+    """Name."""

gcore/types/waap/__init__.py

@@ -0,0 +1,12 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from .waap_api_urls import WaapAPIURLs as WaapAPIURLs
+from .domain_list_params import DomainListParams as DomainListParams
+from .waap_domain_status import WaapDomainStatus as WaapDomainStatus
+from .waap_summary_domain import WaapSummaryDomain as WaapSummaryDomain
+from .domain_update_params import DomainUpdateParams as DomainUpdateParams
+from .waap_detailed_domain import WaapDetailedDomain as WaapDetailedDomain
+from .waap_domain_settings import WaapDomainSettings as WaapDomainSettings
+from .waap_domain_ddos_settings import WaapDomainDDOSSettings as WaapDomainDDOSSettings

gcore/types/waap/domain_list_params.py

@@ -0,0 +1,30 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing import Iterable
+from typing_extensions import Literal, TypedDict
+
+from .waap_domain_status import WaapDomainStatus
+
+__all__ = ["DomainListParams"]
+
+
+class DomainListParams(TypedDict, total=False):
+    ids: Iterable[int]
+    """Filter domains based on their IDs"""
+
+    limit: int
+    """Number of items to return"""
+
+    name: str
+    """Filter domains based on the domain name. Supports '\\**' as a wildcard character"""
+
+    offset: int
+    """Number of items to skip"""
+
+    ordering: Literal["id", "name", "status", "created_at", "-id", "-name", "-status", "-created_at"]
+    """Sort the response by given field."""
+
+    status: WaapDomainStatus
+    """The different statuses a domain can have"""

gcore/types/waap/domain_update_params.py

@@ -0,0 +1,12 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing_extensions import Literal, TypedDict
+
+__all__ = ["DomainUpdateParams"]
+
+
+class DomainUpdateParams(TypedDict, total=False):
+    status: Literal["active", "monitor"]
+    """Domain statuses that can be used when updating a domain"""

gcore/types/waap/domains/__init__.py

@@ -0,0 +1,5 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from .setting_update_params import SettingUpdateParams as SettingUpdateParams

gcore/types/waap/domains/setting_update_params.py

@@ -0,0 +1,41 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing import List
+from typing_extensions import TypedDict
+
+__all__ = ["SettingUpdateParams", "API", "DDOS"]
+
+
+class SettingUpdateParams(TypedDict, total=False):
+    api: API
+    """Editable API settings of a domain"""
+
+    ddos: DDOS
+    """Editable DDoS settings for a domain."""
+
+
+class API(TypedDict, total=False):
+    api_urls: List[str]
+    """The API URLs for a domain.
+
+    If your domain has a common base URL for all API paths, it can be set here
+    """
+
+
+class DDOS(TypedDict, total=False):
+    burst_threshold: int
+    """The burst threshold detects sudden rises in traffic.
+
+    If it is met and the number of requests is at least five times the last 2-second
+    interval, DDoS protection will activate. Default is 1000.
+    """
+
+    global_threshold: int
+    """
+    The global threshold is responsible for identifying DDoS attacks with a slow
+    rise in traffic. If the threshold is met and the current number of requests is
+    at least double that of the previous 10-second window, DDoS protection will
+    activate. Default is 5000.
+    """

gcore/types/waap/waap_api_urls.py

@@ -0,0 +1,15 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import List, Optional
+
+from ..._models import BaseModel
+
+__all__ = ["WaapAPIURLs"]
+
+
+class WaapAPIURLs(BaseModel):
+    api_urls: Optional[List[str]] = None
+    """The API URLs for a domain.
+
+    If your domain has a common base URL for all API paths, it can be set here
+    """

gcore/types/waap/waap_detailed_domain.py

@@ -0,0 +1,37 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import Dict, Optional
+from datetime import datetime
+
+from ..._models import BaseModel
+from .waap_domain_status import WaapDomainStatus
+
+__all__ = ["WaapDetailedDomain", "Quotas"]
+
+
+class Quotas(BaseModel):
+    allowed: int
+    """The maximum allowed number of this resource"""
+
+    current: int
+    """The current number of this resource"""
+
+
+class WaapDetailedDomain(BaseModel):
+    id: int
+    """The domain ID"""
+
+    created_at: datetime
+    """The date and time the domain was created in ISO 8601 format"""
+
+    custom_page_set: Optional[int] = None
+    """The ID of the custom page set"""
+
+    name: str
+    """The domain name"""
+
+    status: WaapDomainStatus
+    """The different statuses a domain can have"""
+
+    quotas: Optional[Dict[str, Quotas]] = None
+    """Domain level quotas"""

gcore/types/waap/waap_domain_ddos_settings.py

@@ -0,0 +1,31 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import Optional
+
+from ..._models import BaseModel
+
+__all__ = ["WaapDomainDDOSSettings"]
+
+
+class WaapDomainDDOSSettings(BaseModel):
+    burst_threshold: Optional[int] = None
+    """The burst threshold detects sudden rises in traffic.
+
+    If it is met and the number of requests is at least five times the last 2-second
+    interval, DDoS protection will activate. Default is 1000.
+    """
+
+    global_threshold: Optional[int] = None
+    """
+    The global threshold is responsible for identifying DDoS attacks with a slow
+    rise in traffic. If the threshold is met and the current number of requests is
+    at least double that of the previous 10-second window, DDoS protection will
+    activate. Default is 5000.
+    """
+
+    sub_second_threshold: Optional[int] = None
+    """
+    The sub-second threshold protects WAAP servers against attacks from traffic
+    bursts. When this threshold is reached, the DDoS mode will activate on the
+    affected WAAP server, not the whole WAAP cluster. Default is 50.
+    """