gcore 0.1.0__py3-none-any.whl

gcore/types/cloud/gpu_baremetal_cluster_create_params.py

@@ -0,0 +1,155 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing import Union, Iterable, Optional
+from typing_extensions import Literal, Required, TypeAlias, TypedDict
+
+from .interface_ip_family import InterfaceIPFamily
+from .tag_update_map_param import TagUpdateMapParam
+
+__all__ = [
+    "GPUBaremetalClusterCreateParams",
+    "Interface",
+    "InterfaceCreateGPUClusterExternalInterfaceSerializer",
+    "InterfaceCreateGPUClusterSubnetInterfaceSerializer",
+    "InterfaceCreateGPUClusterSubnetInterfaceSerializerFloatingIP",
+    "InterfaceCreateGPUClusterAnySubnetInterfaceSerializer",
+    "InterfaceCreateGPUClusterAnySubnetInterfaceSerializerFloatingIP",
+]
+
+
+class GPUBaremetalClusterCreateParams(TypedDict, total=False):
+    project_id: int
+
+    region_id: int
+
+    flavor: Required[str]
+    """Flavor name"""
+
+    image_id: Required[str]
+    """Image ID"""
+
+    interfaces: Required[Iterable[Interface]]
+    """A list of network interfaces for the server.
+
+    You can create one or more interfaces - private, public, or both.
+    """
+
+    name: Required[str]
+    """GPU Cluster name"""
+
+    instances_count: int
+    """Number of servers to create"""
+
+    password: str
+    """A password for a bare metal server.
+
+    This parameter is used to set a password for the "Admin" user on a Windows
+    instance, a default user or a new user on a Linux instance
+    """
+
+    ssh_key_name: str
+    """
+    Specifies the name of the SSH keypair, created via the
+    <a href="#operation/SSHKeyCollectionViewSet.post">/v1/ssh_keys endpoint</a>.
+    """
+
+    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.
+    """
+
+    user_data: str
+    """String in base64 format.
+
+    Must not be passed together with 'username' or 'password'. Examples of the
+    user_data: https://cloudinit.readthedocs.io/en/latest/topics/examples.html
+    """
+
+    username: str
+    """A name of a new user in the Linux instance.
+
+    It may be passed with a 'password' parameter
+    """
+
+
+class InterfaceCreateGPUClusterExternalInterfaceSerializer(TypedDict, total=False):
+    type: Required[Literal["external"]]
+    """A public IP address will be assigned to the server."""
+
+    interface_name: str
+    """Interface name.
+
+    Defaults to `null` and is returned as `null` in the API response if not set.
+    """
+
+    ip_family: Optional[InterfaceIPFamily]
+    """Specify `ipv4`, `ipv6`, or `dual` to enable both."""
+
+
+class InterfaceCreateGPUClusterSubnetInterfaceSerializerFloatingIP(TypedDict, total=False):
+    source: Required[Literal["new"]]
+
+
+class InterfaceCreateGPUClusterSubnetInterfaceSerializer(TypedDict, total=False):
+    network_id: Required[str]
+    """The network where the server will be connected."""
+
+    subnet_id: Required[str]
+    """The server will get an IP address from this subnet."""
+
+    type: Required[Literal["subnet"]]
+    """The instance will get an IP address from the selected network.
+
+    If you choose to add a floating IP, the instance will be reachable from the
+    internet. Otherwise, it will only have a private IP within the network.
+    """
+
+    floating_ip: InterfaceCreateGPUClusterSubnetInterfaceSerializerFloatingIP
+    """Floating IP config for this subnet attachment"""
+
+    interface_name: str
+    """Interface name.
+
+    Defaults to `null` and is returned as `null` in the API response if not set.
+    """
+
+
+class InterfaceCreateGPUClusterAnySubnetInterfaceSerializerFloatingIP(TypedDict, total=False):
+    source: Required[Literal["new"]]
+
+
+class InterfaceCreateGPUClusterAnySubnetInterfaceSerializer(TypedDict, total=False):
+    network_id: Required[str]
+    """The network where the server will be connected."""
+
+    type: Required[Literal["any_subnet"]]
+    """Server will be attached to a subnet with the largest count of free IPs."""
+
+    floating_ip: InterfaceCreateGPUClusterAnySubnetInterfaceSerializerFloatingIP
+    """Allows the server to have a public IP that can be reached from the internet."""
+
+    interface_name: str
+    """Interface name.
+
+    Defaults to `null` and is returned as `null` in the API response if not set.
+    """
+
+    ip_address: str
+    """You can specify a specific IP address from your subnet."""
+
+    ip_family: InterfaceIPFamily
+    """Specify `ipv4`, `ipv6`, or `dual` to enable both."""
+
+
+Interface: TypeAlias = Union[
+    InterfaceCreateGPUClusterExternalInterfaceSerializer,
+    InterfaceCreateGPUClusterSubnetInterfaceSerializer,
+    InterfaceCreateGPUClusterAnySubnetInterfaceSerializer,
+]

gcore/types/cloud/gpu_baremetal_cluster_delete_params.py

@@ -0,0 +1,28 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing_extensions import TypedDict
+
+__all__ = ["GPUBaremetalClusterDeleteParams"]
+
+
+class GPUBaremetalClusterDeleteParams(TypedDict, total=False):
+    project_id: int
+
+    region_id: int
+
+    delete_floatings: bool
+    """True if it is required to delete floating IPs assigned to the servers.
+
+    Can't be used with floatings.
+    """
+
+    floatings: str
+    """Comma separated list of floating ids that should be deleted.
+
+    Can't be used with delete_floatings.
+    """
+
+    reserved_fixed_ips: str
+    """Comma separated list of port IDs to be deleted with the servers"""

gcore/types/cloud/gpu_baremetal_cluster_list_params.py

@@ -0,0 +1,19 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing_extensions import TypedDict
+
+__all__ = ["GPUBaremetalClusterListParams"]
+
+
+class GPUBaremetalClusterListParams(TypedDict, total=False):
+    project_id: int
+
+    region_id: int
+
+    limit: int
+    """Limit the number of returned clusters"""
+
+    offset: int
+    """Offset value is used to exclude the first set of records from the result"""

gcore/types/cloud/gpu_baremetal_cluster_rebuild_params.py

@@ -0,0 +1,26 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing import List, Optional
+from typing_extensions import Required, TypedDict
+
+__all__ = ["GPUBaremetalClusterRebuildParams"]
+
+
+class GPUBaremetalClusterRebuildParams(TypedDict, total=False):
+    project_id: int
+
+    region_id: int
+
+    nodes: Required[List[str]]
+    """List of nodes uuids to be rebuild"""
+
+    image_id: Optional[str]
+    """AI GPU image ID"""
+
+    user_data: Optional[str]
+    """
+    String in base64 format.Examples of the user_data:
+    https://cloudinit.readthedocs.io/en/latest/topics/examples.html
+    """

gcore/types/cloud/gpu_baremetal_cluster_resize_params.py

@@ -0,0 +1,16 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing_extensions import Required, TypedDict
+
+__all__ = ["GPUBaremetalClusterResizeParams"]
+
+
+class GPUBaremetalClusterResizeParams(TypedDict, total=False):
+    project_id: int
+
+    region_id: int
+
+    instances_count: Required[int]
+    """Resized (total) number of instances"""

gcore/types/cloud/gpu_baremetal_cluster_server.py

@@ -0,0 +1,200 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import Dict, List, Union, Optional
+from datetime import datetime
+from typing_extensions import Literal, TypeAlias
+
+from .tag import Tag
+from ..._models import BaseModel
+from .ddos_profile import DDOSProfile
+from .fixed_address import FixedAddress
+from .blackhole_port import BlackholePort
+from .floating_address import FloatingAddress
+from .instance_isolation import InstanceIsolation
+from .fixed_address_short import FixedAddressShort
+
+__all__ = [
+    "GPUBaremetalClusterServer",
+    "Address",
+    "FixedIPAssignment",
+    "Flavor",
+    "FlavorHardwareDescription",
+    "SecurityGroup",
+]
+
+Address: TypeAlias = Union[FloatingAddress, FixedAddressShort, FixedAddress]
+
+
+class FixedIPAssignment(BaseModel):
+    external: bool
+    """Is network external"""
+
+    ip_address: str
+    """Ip address"""
+
+    subnet_id: str
+    """Interface subnet id"""
+
+
+class FlavorHardwareDescription(BaseModel):
+    cpu: str
+    """Human-readable CPU description"""
+
+    disk: str
+    """Human-readable disk description"""
+
+    gpu: str
+    """Human-readable GPU description"""
+
+    license: str
+    """If the flavor is licensed, this field contains the license type"""
+
+    network: str
+    """Human-readable NIC description"""
+
+    ram: str
+    """Human-readable RAM description"""
+
+
+class Flavor(BaseModel):
+    architecture: str
+    """CPU architecture"""
+
+    flavor_id: str
+    """Flavor ID is the same as name"""
+
+    flavor_name: str
+    """Flavor name"""
+
+    hardware_description: FlavorHardwareDescription
+    """Additional hardware description"""
+
+    os_type: str
+    """Operating system"""
+
+    ram: int
+    """RAM size in MiB"""
+
+    resource_class: str
+    """Flavor resource class for mapping to hardware capacity"""
+
+    vcpus: int
+    """Virtual CPU count. For bare metal flavors, it's a physical CPU count"""
+
+
+class SecurityGroup(BaseModel):
+    name: str
+    """Name."""
+
+
+class GPUBaremetalClusterServer(BaseModel):
+    id: str
+    """GPU server ID"""
+
+    addresses: Dict[str, List[Address]]
+    """Map of network_name to list of addresses in that network"""
+
+    blackhole_ports: List[BlackholePort]
+    """IP addresses of the instances that are blackholed by DDoS mitigation system"""
+
+    created_at: datetime
+    """Datetime when GPU server was created"""
+
+    creator_task_id: Optional[str] = None
+    """Task that created this entity"""
+
+    ddos_profile: Optional[DDOSProfile] = None
+    """Advanced DDoS protection profile.
+
+    It is always `null` if query parameter `with_ddos=true` is not set.
+    """
+
+    fixed_ip_assignments: Optional[List[FixedIPAssignment]] = None
+    """Fixed IP assigned to instance"""
+
+    flavor: Flavor
+    """Flavor"""
+
+    instance_description: Optional[str] = None
+    """Instance description"""
+
+    instance_isolation: Optional[InstanceIsolation] = None
+    """Instance isolation information"""
+
+    name: str
+    """GPU server name"""
+
+    project_id: int
+    """Project ID"""
+
+    region: str
+    """Region name"""
+
+    region_id: int
+    """Region ID"""
+
+    security_groups: List[SecurityGroup]
+    """Security groups"""
+
+    ssh_key_name: Optional[str] = None
+    """SSH key name assigned to instance"""
+
+    status: Literal[
+        "ACTIVE",
+        "BUILD",
+        "DELETED",
+        "ERROR",
+        "HARD_REBOOT",
+        "MIGRATING",
+        "PASSWORD",
+        "PAUSED",
+        "REBOOT",
+        "REBUILD",
+        "RESCUE",
+        "RESIZE",
+        "REVERT_RESIZE",
+        "SHELVED",
+        "SHELVED_OFFLOADED",
+        "SHUTOFF",
+        "SOFT_DELETED",
+        "SUSPENDED",
+        "UNKNOWN",
+        "VERIFY_RESIZE",
+    ]
+    """Instance 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.
+    """
+
+    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.
+    """
+
+    task_state: Optional[str] = None
+    """Task state"""
+
+    vm_state: Literal[
+        "active",
+        "building",
+        "deleted",
+        "error",
+        "paused",
+        "rescued",
+        "resized",
+        "shelved",
+        "shelved_offloaded",
+        "soft-deleted",
+        "stopped",
+        "suspended",
+    ]
+    """Virtual machine state (active)"""

gcore/types/cloud/gpu_baremetal_cluster_server_list.py

@@ -0,0 +1,16 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import List
+
+from ..._models import BaseModel
+from .gpu_baremetal_cluster_server import GPUBaremetalClusterServer
+
+__all__ = ["GPUBaremetalClusterServerList"]
+
+
+class GPUBaremetalClusterServerList(BaseModel):
+    count: int
+    """Number of objects"""
+
+    results: List[GPUBaremetalClusterServer]
+    """Objects"""

gcore/types/cloud/gpu_baremetal_clusters/__init__.py

@@ -0,0 +1,9 @@
+# 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 .image_upload_params import ImageUploadParams as ImageUploadParams
+from .server_delete_params import ServerDeleteParams as ServerDeleteParams
+from .server_attach_interface_params import ServerAttachInterfaceParams as ServerAttachInterfaceParams
+from .server_detach_interface_params import ServerDetachInterfaceParams as ServerDetachInterfaceParams

gcore/types/cloud/gpu_baremetal_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."""

gcore/types/cloud/gpu_baremetal_clusters/image_upload_params.py

@@ -0,0 +1,58 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing import Optional
+from typing_extensions import Literal, Required, TypedDict
+
+from ..tag_update_map_param import TagUpdateMapParam
+
+__all__ = ["ImageUploadParams"]
+
+
+class ImageUploadParams(TypedDict, total=False):
+    project_id: int
+    """Project ID"""
+
+    region_id: int
+    """Region ID"""
+
+    name: Required[str]
+    """Image name"""
+
+    url: Required[str]
+    """Image URL"""
+
+    architecture: Optional[Literal["aarch64", "x86_64"]]
+    """Image architecture type: aarch64, x86_64"""
+
+    cow_format: bool
+    """
+    When True, image cannot be deleted unless all volumes, created from it, are
+    deleted.
+    """
+
+    hw_firmware_type: Optional[Literal["bios", "uefi"]]
+    """Specifies the type of firmware with which to boot the guest."""
+
+    os_distro: Optional[str]
+    """OS Distribution, i.e. Debian, CentOS, Ubuntu, CoreOS etc."""
+
+    os_type: Optional[Literal["linux", "windows"]]
+    """The operating system installed on the image. Linux by default"""
+
+    os_version: Optional[str]
+    """OS version, i.e. 19.04 (for Ubuntu) or 9.4 for Debian"""
+
+    ssh_key: Literal["allow", "deny", "required"]
+    """Permission to use a ssh key in instances"""
+
+    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.
+    """