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

gcore/types/cloud/gpu_virtual_cluster.py

@@ -0,0 +1,189 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import List, Union, Optional
+from datetime import datetime
+from typing_extensions import Literal, Annotated, TypeAlias
+
+from .tag import Tag
+from ..._utils import PropertyInfo
+from ..._models import BaseModel
+
+__all__ = [
+    "GPUVirtualCluster",
+    "ServersSettings",
+    "ServersSettingsFileShare",
+    "ServersSettingsInterface",
+    "ServersSettingsInterfaceExternalInterfaceOutputSerializer",
+    "ServersSettingsInterfaceSubnetInterfaceOutputSerializer",
+    "ServersSettingsInterfaceSubnetInterfaceOutputSerializerFloatingIP",
+    "ServersSettingsInterfaceAnySubnetInterfaceOutputSerializer",
+    "ServersSettingsInterfaceAnySubnetInterfaceOutputSerializerFloatingIP",
+    "ServersSettingsSecurityGroup",
+    "ServersSettingsVolume",
+]
+
+
+class ServersSettingsFileShare(BaseModel):
+    id: str
+    """Unique identifier of the file share in UUID format."""
+
+    mount_path: str
+    """Absolute mount path inside the system where the file share will be mounted."""
+
+
+class ServersSettingsInterfaceExternalInterfaceOutputSerializer(BaseModel):
+    ip_family: Literal["dual", "ipv4", "ipv6"]
+    """Which subnets should be selected: IPv4, IPv6, or use dual stack."""
+
+    name: Optional[str] = None
+    """Interface name"""
+
+    type: Literal["external"]
+
+
+class ServersSettingsInterfaceSubnetInterfaceOutputSerializerFloatingIP(BaseModel):
+    source: Literal["new"]
+
+
+class ServersSettingsInterfaceSubnetInterfaceOutputSerializer(BaseModel):
+    floating_ip: Optional[ServersSettingsInterfaceSubnetInterfaceOutputSerializerFloatingIP] = None
+    """Floating IP config for this subnet attachment"""
+
+    name: Optional[str] = None
+    """Interface name"""
+
+    network_id: str
+    """Network ID the subnet belongs to. Port will be plugged in this network"""
+
+    subnet_id: str
+    """Port is assigned an IP address from this subnet"""
+
+    type: Literal["subnet"]
+
+
+class ServersSettingsInterfaceAnySubnetInterfaceOutputSerializerFloatingIP(BaseModel):
+    source: Literal["new"]
+
+
+class ServersSettingsInterfaceAnySubnetInterfaceOutputSerializer(BaseModel):
+    floating_ip: Optional[ServersSettingsInterfaceAnySubnetInterfaceOutputSerializerFloatingIP] = None
+    """Floating IP config for this subnet attachment"""
+
+    ip_address: Optional[str] = None
+    """Fixed IP address"""
+
+    ip_family: Literal["dual", "ipv4", "ipv6"]
+    """Which subnets should be selected: IPv4, IPv6, or use dual stack"""
+
+    name: Optional[str] = None
+    """Interface name"""
+
+    network_id: str
+    """Network ID the subnet belongs to. Port will be plugged in this network"""
+
+    type: Literal["any_subnet"]
+
+
+ServersSettingsInterface: TypeAlias = Annotated[
+    Union[
+        ServersSettingsInterfaceExternalInterfaceOutputSerializer,
+        ServersSettingsInterfaceSubnetInterfaceOutputSerializer,
+        ServersSettingsInterfaceAnySubnetInterfaceOutputSerializer,
+    ],
+    PropertyInfo(discriminator="type"),
+]
+
+
+class ServersSettingsSecurityGroup(BaseModel):
+    id: str
+    """Security group ID"""
+
+    name: str
+    """Security group name"""
+
+
+class ServersSettingsVolume(BaseModel):
+    boot_index: Optional[int] = None
+    """Boot index of the volume"""
+
+    delete_on_termination: bool
+    """Flag indicating whether the volume is deleted on instance termination"""
+
+    image_id: Optional[str] = None
+    """Image ID for the volume"""
+
+    name: str
+    """Volume name"""
+
+    size: int
+    """Volume size in GiB"""
+
+    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.
+    """
+
+    type: Literal["cold", "ssd_hiiops", "ssd_local", "ssd_lowlatency", "standard", "ultra"]
+    """Volume type"""
+
+
+class ServersSettings(BaseModel):
+    file_shares: List[ServersSettingsFileShare]
+    """List of file shares mounted across the cluster."""
+
+    interfaces: List[ServersSettingsInterface]
+
+    security_groups: List[ServersSettingsSecurityGroup]
+    """Security groups"""
+
+    ssh_key_name: Optional[str] = None
+    """SSH key name"""
+
+    user_data: Optional[str] = None
+    """Optional custom user data"""
+
+    volumes: List[ServersSettingsVolume]
+    """List of volumes"""
+
+
+class GPUVirtualCluster(BaseModel):
+    id: str
+    """Cluster unique identifier"""
+
+    created_at: datetime
+    """Cluster creation date time"""
+
+    flavor: str
+    """Cluster flavor name"""
+
+    name: str
+    """Cluster name"""
+
+    servers_count: int
+    """Cluster servers count"""
+
+    servers_ids: List[str]
+    """List of cluster nodes"""
+
+    servers_settings: ServersSettings
+
+    status: Literal["active", "deleting", "error", "new", "resizing"]
+    """Cluster status"""
+
+    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.
+    """
+
+    updated_at: Optional[datetime] = None
+    """Cluster update date time"""

gcore/types/cloud/gpu_virtual_cluster_action_params.py

@@ -0,0 +1,127 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing import Union, Optional
+from typing_extensions import Literal, Required, TypeAlias, TypedDict
+
+from .tag_update_map_param import TagUpdateMapParam
+
+__all__ = [
+    "GPUVirtualClusterActionParams",
+    "StartVirtualGPUClusterSerializer",
+    "StopVirtualGPUClusterSerializer",
+    "SoftRebootVirtualGPUClusterSerializer",
+    "HardRebootVirtualGPUClusterSerializer",
+    "UpdateTagsGPUClusterSerializer",
+    "ResizeVirtualGPUClusterSerializer",
+]
+
+
+class StartVirtualGPUClusterSerializer(TypedDict, total=False):
+    project_id: int
+    """Project ID"""
+
+    region_id: int
+    """Region ID"""
+
+    action: Required[Literal["start"]]
+    """Action name"""
+
+
+class StopVirtualGPUClusterSerializer(TypedDict, total=False):
+    project_id: int
+    """Project ID"""
+
+    region_id: int
+    """Region ID"""
+
+    action: Required[Literal["stop"]]
+    """Action name"""
+
+
+class SoftRebootVirtualGPUClusterSerializer(TypedDict, total=False):
+    project_id: int
+    """Project ID"""
+
+    region_id: int
+    """Region ID"""
+
+    action: Required[Literal["soft_reboot"]]
+    """Action name"""
+
+
+class HardRebootVirtualGPUClusterSerializer(TypedDict, total=False):
+    project_id: int
+    """Project ID"""
+
+    region_id: int
+    """Region ID"""
+
+    action: Required[Literal["hard_reboot"]]
+    """Action name"""
+
+
+class UpdateTagsGPUClusterSerializer(TypedDict, total=False):
+    project_id: int
+    """Project ID"""
+
+    region_id: int
+    """Region ID"""
+
+    action: Required[Literal["update_tags"]]
+    """Action name"""
+
+    tags: Required[Optional[TagUpdateMapParam]]
+    """Update key-value tags using JSON Merge Patch semantics (RFC 7386).
+
+    Provide key-value pairs to add or update tags. Set tag values to `null` to
+    remove tags. Unspecified tags remain unchanged. Read-only tags are always
+    preserved and cannot be modified.
+
+    **Examples:**
+
+    - **Add/update tags:**
+      `{'tags': {'environment': 'production', 'team': 'backend'}}` adds new tags or
+      updates existing ones.
+
+    - **Delete tags:** `{'tags': {'old_tag': null}}` removes specific tags.
+
+    - **Remove all tags:** `{'tags': null}` removes all user-managed tags (read-only
+      tags are preserved).
+
+    - **Partial update:** `{'tags': {'environment': 'staging'}}` only updates
+      specified tags.
+
+    - **Mixed operations:**
+      `{'tags': {'environment': 'production', 'cost_center': 'engineering', 'deprecated_tag': null}}`
+      adds/updates 'environment' and '`cost_center`' while removing
+      '`deprecated_tag`', preserving other existing tags.
+
+    - **Replace all:** first delete existing tags with null values, then add new
+      ones in the same request.
+    """
+
+
+class ResizeVirtualGPUClusterSerializer(TypedDict, total=False):
+    project_id: int
+    """Project ID"""
+
+    region_id: int
+    """Region ID"""
+
+    action: Required[Literal["resize"]]
+    """Action name"""
+
+    servers_count: Required[int]
+    """Requested servers count"""
+
+
+GPUVirtualClusterActionParams: TypeAlias = Union[
+    StartVirtualGPUClusterSerializer,
+    StopVirtualGPUClusterSerializer,
+    SoftRebootVirtualGPUClusterSerializer,
+    HardRebootVirtualGPUClusterSerializer,
+    UpdateTagsGPUClusterSerializer,
+    ResizeVirtualGPUClusterSerializer,
+]

gcore/types/cloud/gpu_virtual_cluster_create_params.py

@@ -0,0 +1,213 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing import Dict, Union, Iterable
+from typing_extensions import Literal, Required, TypeAlias, TypedDict
+
+__all__ = [
+    "GPUVirtualClusterCreateParams",
+    "ServersSettings",
+    "ServersSettingsInterface",
+    "ServersSettingsInterfaceExternalInterfaceInputSerializer",
+    "ServersSettingsInterfaceSubnetInterfaceInputSerializer",
+    "ServersSettingsInterfaceSubnetInterfaceInputSerializerFloatingIP",
+    "ServersSettingsInterfaceAnySubnetInterfaceInputSerializer",
+    "ServersSettingsInterfaceAnySubnetInterfaceInputSerializerFloatingIP",
+    "ServersSettingsVolume",
+    "ServersSettingsVolumeNewVolumeInputSerializer",
+    "ServersSettingsVolumeImageVolumeInputSerializer",
+    "ServersSettingsCredentials",
+    "ServersSettingsFileShare",
+    "ServersSettingsSecurityGroup",
+]
+
+
+class GPUVirtualClusterCreateParams(TypedDict, total=False):
+    project_id: int
+    """Project ID"""
+
+    region_id: int
+    """Region ID"""
+
+    flavor: Required[str]
+    """Cluster flavor ID"""
+
+    name: Required[str]
+    """Cluster name"""
+
+    servers_count: Required[int]
+    """Number of servers in the cluster"""
+
+    servers_settings: Required[ServersSettings]
+    """Configuration settings for the servers in the cluster"""
+
+    tags: Dict[str, str]
+    """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. Both
+    tag keys and values have a maximum length of 255 characters. 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.
+    """
+
+
+class ServersSettingsInterfaceExternalInterfaceInputSerializer(TypedDict, total=False):
+    type: Required[Literal["external"]]
+
+    ip_family: Literal["dual", "ipv4", "ipv6"]
+    """Which subnets should be selected: IPv4, IPv6, or use dual stack."""
+
+    name: str
+    """Interface name"""
+
+
+class ServersSettingsInterfaceSubnetInterfaceInputSerializerFloatingIP(TypedDict, total=False):
+    source: Required[Literal["new"]]
+
+
+class ServersSettingsInterfaceSubnetInterfaceInputSerializer(TypedDict, total=False):
+    network_id: Required[str]
+    """Network ID the subnet belongs to. Port will be plugged in this network"""
+
+    subnet_id: Required[str]
+    """Port is assigned an IP address from this subnet"""
+
+    type: Required[Literal["subnet"]]
+
+    floating_ip: ServersSettingsInterfaceSubnetInterfaceInputSerializerFloatingIP
+    """Floating IP config for this subnet attachment"""
+
+    name: str
+    """Interface name"""
+
+
+class ServersSettingsInterfaceAnySubnetInterfaceInputSerializerFloatingIP(TypedDict, total=False):
+    source: Required[Literal["new"]]
+
+
+class ServersSettingsInterfaceAnySubnetInterfaceInputSerializer(TypedDict, total=False):
+    network_id: Required[str]
+    """Network ID the subnet belongs to. Port will be plugged in this network"""
+
+    type: Required[Literal["any_subnet"]]
+
+    floating_ip: ServersSettingsInterfaceAnySubnetInterfaceInputSerializerFloatingIP
+    """Floating IP config for this subnet attachment"""
+
+    ip_family: Literal["dual", "ipv4", "ipv6"]
+    """Which subnets should be selected: IPv4, IPv6, or use dual stack"""
+
+    name: str
+    """Interface name"""
+
+
+ServersSettingsInterface: TypeAlias = Union[
+    ServersSettingsInterfaceExternalInterfaceInputSerializer,
+    ServersSettingsInterfaceSubnetInterfaceInputSerializer,
+    ServersSettingsInterfaceAnySubnetInterfaceInputSerializer,
+]
+
+
+class ServersSettingsVolumeNewVolumeInputSerializer(TypedDict, total=False):
+    boot_index: Required[int]
+    """Boot index of the volume"""
+
+    name: Required[str]
+    """Volume name"""
+
+    size: Required[int]
+    """Volume size in GiB"""
+
+    source: Required[Literal["new"]]
+
+    type: Required[Literal["cold", "ssd_hiiops", "ssd_local", "ssd_lowlatency", "standard", "ultra"]]
+    """Volume type"""
+
+    delete_on_termination: bool
+    """Flag indicating whether the volume is deleted on instance termination"""
+
+    tags: Dict[str, str]
+    """Tags associated with the volume"""
+
+
+class ServersSettingsVolumeImageVolumeInputSerializer(TypedDict, total=False):
+    boot_index: Required[int]
+    """Boot index of the volume"""
+
+    image_id: Required[str]
+    """Image ID for the volume"""
+
+    name: Required[str]
+    """Volume name"""
+
+    size: Required[int]
+    """Volume size in GiB"""
+
+    source: Required[Literal["image"]]
+
+    type: Required[Literal["cold", "ssd_hiiops", "ssd_local", "ssd_lowlatency", "standard", "ultra"]]
+    """Volume type"""
+
+    delete_on_termination: bool
+    """Flag indicating whether the volume is deleted on instance termination"""
+
+    tags: Dict[str, str]
+    """Tags associated with the volume"""
+
+
+ServersSettingsVolume: TypeAlias = Union[
+    ServersSettingsVolumeNewVolumeInputSerializer, ServersSettingsVolumeImageVolumeInputSerializer
+]
+
+
+class ServersSettingsCredentials(TypedDict, total=False):
+    password: str
+    """Used to set the password for the specified 'username' on Linux instances.
+
+    If 'username' is not provided, the password is applied to the default user of
+    the image. Mutually exclusive with '`user_data`' - only one can be specified.
+    """
+
+    ssh_key_name: str
+    """
+    Specifies the name of the SSH keypair, created via the
+    [/v1/`ssh_keys` endpoint](/docs/api-reference/cloud/ssh-keys/add-or-generate-ssh-key).
+    """
+
+    username: str
+    """The 'username' and 'password' fields create a new user on the system"""
+
+
+class ServersSettingsFileShare(TypedDict, total=False):
+    id: Required[str]
+    """Unique identifier of the file share in UUID format."""
+
+    mount_path: Required[str]
+    """Absolute mount path inside the system where the file share will be mounted."""
+
+
+class ServersSettingsSecurityGroup(TypedDict, total=False):
+    id: Required[str]
+    """Resource ID"""
+
+
+class ServersSettings(TypedDict, total=False):
+    interfaces: Required[Iterable[ServersSettingsInterface]]
+    """Subnet IPs and floating IPs"""
+
+    volumes: Required[Iterable[ServersSettingsVolume]]
+    """List of volumes"""
+
+    credentials: ServersSettingsCredentials
+    """Optional server access credentials"""
+
+    file_shares: Iterable[ServersSettingsFileShare]
+    """List of file shares to be mounted across the cluster."""
+
+    security_groups: Iterable[ServersSettingsSecurityGroup]
+    """List of security groups UUIDs"""
+
+    user_data: str
+    """Optional custom user data (Base64-encoded)"""

gcore/types/cloud/gpu_virtual_cluster_delete_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_extensions import TypedDict
+
+from ..._types import SequenceNotStr
+
+__all__ = ["GPUVirtualClusterDeleteParams"]
+
+
+class GPUVirtualClusterDeleteParams(TypedDict, total=False):
+    project_id: int
+    """Project ID"""
+
+    region_id: int
+    """Region ID"""
+
+    all_floating_ips: bool
+    """
+    Flag indicating whether the floating ips associated with server / cluster are
+    deleted
+    """
+
+    all_reserved_fixed_ips: bool
+    """
+    Flag indicating whether the reserved fixed ips associated with server / cluster
+    are deleted
+    """
+
+    all_volumes: bool
+    """Flag indicating whether all attached volumes are deleted"""
+
+    floating_ip_ids: SequenceNotStr[str]
+    """Optional list of floating ips to be deleted"""
+
+    reserved_fixed_ip_ids: SequenceNotStr[str]
+    """Optional list of reserved fixed ips to be deleted"""
+
+    volume_ids: SequenceNotStr[str]
+    """Optional list of volumes to be deleted"""

gcore/types/cloud/gpu_virtual_cluster_list_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 TypedDict
+
+__all__ = ["GPUVirtualClusterListParams"]
+
+
+class GPUVirtualClusterListParams(TypedDict, total=False):
+    project_id: int
+    """Project ID"""
+
+    region_id: int
+    """Region ID"""
+
+    limit: int
+    """Limit of items on a single page"""
+
+    offset: int
+    """Offset in results list"""

gcore/types/cloud/gpu_virtual_cluster_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__ = ["GPUVirtualClusterUpdateParams"]
+
+
+class GPUVirtualClusterUpdateParams(TypedDict, total=False):
+    project_id: int
+    """Project ID"""
+
+    region_id: int
+    """Region ID"""
+
+    name: Required[str]
+    """Cluster name"""

gcore/types/cloud/gpu_virtual_clusters/__init__.py

@@ -0,0 +1,16 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from .flavor_list_params import FlavorListParams as FlavorListParams
+from .gpu_virtual_flavor import GPUVirtualFlavor as GPUVirtualFlavor
+from .server_list_params import ServerListParams as ServerListParams
+from .image_upload_params import ImageUploadParams as ImageUploadParams
+from .server_delete_params import ServerDeleteParams as ServerDeleteParams
+from .gpu_virtual_interface import GPUVirtualInterface as GPUVirtualInterface
+from .gpu_virtual_flavor_list import GPUVirtualFlavorList as GPUVirtualFlavorList
+from .gpu_virtual_cluster_server import GPUVirtualClusterServer as GPUVirtualClusterServer
+from .gpu_virtual_cluster_volume import GPUVirtualClusterVolume as GPUVirtualClusterVolume
+from .gpu_virtual_interface_list import GPUVirtualInterfaceList as GPUVirtualInterfaceList
+from .gpu_virtual_cluster_server_list import GPUVirtualClusterServerList as GPUVirtualClusterServerList
+from .gpu_virtual_cluster_volume_list import GPUVirtualClusterVolumeList as GPUVirtualClusterVolumeList

gcore/types/cloud/gpu_virtual_clusters/flavor_list_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 TypedDict
+
+__all__ = ["FlavorListParams"]
+
+
+class FlavorListParams(TypedDict, total=False):
+    project_id: int
+    """Project ID"""
+
+    region_id: int
+    """Region ID"""
+
+    hide_disabled: bool
+    """Set to `true` to remove the disabled flavors from the response."""
+
+    include_prices: bool
+    """Set to `true` if the response should include flavor prices."""