gcore 0.1.0a1__py3-none-any.whl

gcore/types/cloud/floating_ip.py

@@ -0,0 +1,77 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import List, Optional
+from datetime import datetime
+
+from .tag import Tag
+from ..._models import BaseModel
+from .floating_ip_status import FloatingIPStatus
+
+__all__ = ["FloatingIP"]
+
+
+class FloatingIP(BaseModel):
+    id: Optional[str] = None
+    """Floating IP ID"""
+
+    created_at: datetime
+    """Datetime when the floating IP was created"""
+
+    creator_task_id: Optional[str] = None
+    """Task that created this entity"""
+
+    dns_domain: Optional[str] = None
+    """This field is deprecated and can be ignored"""
+
+    dns_name: Optional[str] = None
+    """This field is deprecated and can be ignored"""
+
+    fixed_ip_address: Optional[str] = None
+    """IP address of the port the floating IP is attached to"""
+
+    floating_ip_address: Optional[str] = None
+    """IP Address of the floating IP"""
+
+    port_id: Optional[str] = None
+    """Port ID the floating IP is attached to.
+
+    The `fixed_ip_address` is the IP address of the port.
+    """
+
+    project_id: int
+    """Project ID"""
+
+    region: str
+    """Region name"""
+
+    region_id: int
+    """Region ID"""
+
+    router_id: Optional[str] = None
+    """Router ID"""
+
+    status: Optional[FloatingIPStatus] = None
+    """Floating IP status"""
+
+    subnet_id: Optional[str] = None
+    """This field is deprecated and can be ignored"""
+
+    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.
+    """
+
+    updated_at: datetime
+    """Datetime when the floating IP was last updated"""

gcore/types/cloud/floating_ip_assign_params.py

@@ -0,0 +1,20 @@
+# 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 Required, TypedDict
+
+__all__ = ["FloatingIPAssignParams"]
+
+
+class FloatingIPAssignParams(TypedDict, total=False):
+    project_id: int
+
+    region_id: int
+
+    port_id: Required[str]
+    """Port ID"""
+
+    fixed_ip_address: Optional[str]
+    """Fixed IP address"""

gcore/types/cloud/floating_ip_create_params.py

@@ -0,0 +1,40 @@
+# 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 TypedDict
+
+from .tag_update_map_param import TagUpdateMapParam
+
+__all__ = ["FloatingIPCreateParams"]
+
+
+class FloatingIPCreateParams(TypedDict, total=False):
+    project_id: int
+    """Project ID"""
+
+    region_id: int
+    """Region ID"""
+
+    fixed_ip_address: Optional[str]
+    """
+    If the port has multiple IP addresses, a specific one can be selected using this
+    field. If not specified, the first IP in the port's list will be used by
+    default.
+    """
+
+    port_id: Optional[str]
+    """
+    If provided, the floating IP will be immediately attached to the specified port.
+    """
+
+    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.
+    """

gcore/types/cloud/floating_ip_detailed.py

@@ -0,0 +1,222 @@
+# 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 .fixed_address import FixedAddress
+from .load_balancer import LoadBalancer
+from .floating_address import FloatingAddress
+from .floating_ip_status import FloatingIPStatus
+from .fixed_address_short import FixedAddressShort
+
+__all__ = [
+    "FloatingIPDetailed",
+    "Instance",
+    "InstanceAddress",
+    "InstanceFlavor",
+    "InstanceSecurityGroup",
+    "InstanceVolume",
+]
+
+InstanceAddress: TypeAlias = Union[FloatingAddress, FixedAddressShort, FixedAddress]
+
+
+class InstanceFlavor(BaseModel):
+    flavor_id: str
+    """Flavor ID is the same as name"""
+
+    flavor_name: str
+    """Flavor name"""
+
+    ram: int
+    """RAM size in MiB"""
+
+    vcpus: int
+    """Virtual CPU count. For bare metal flavors, it's a physical CPU count"""
+
+
+class InstanceSecurityGroup(BaseModel):
+    name: str
+    """Name."""
+
+
+class InstanceVolume(BaseModel):
+    id: str
+    """Volume ID"""
+
+    delete_on_termination: bool
+    """Whether the volume is deleted together with the VM"""
+
+
+class Instance(BaseModel):
+    id: str
+    """Instance ID"""
+
+    addresses: Dict[str, List[InstanceAddress]]
+    """Map of network_name to list of addresses in that network"""
+
+    created_at: datetime
+    """Datetime when instance was created"""
+
+    creator_task_id: str
+    """Task that created this entity"""
+
+    flavor: InstanceFlavor
+    """Flavor"""
+
+    instance_description: Optional[str] = None
+    """Instance description"""
+
+    name: str
+    """Instance name"""
+
+    project_id: int
+    """Project ID"""
+
+    region: str
+    """Region name"""
+
+    region_id: int
+    """Region ID"""
+
+    security_groups: List[InstanceSecurityGroup]
+    """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)"""
+
+    volumes: List[InstanceVolume]
+    """List of volumes"""
+
+
+class FloatingIPDetailed(BaseModel):
+    id: Optional[str] = None
+    """Floating IP ID"""
+
+    created_at: datetime
+    """Datetime when the floating IP was created"""
+
+    creator_task_id: Optional[str] = None
+    """Task that created this entity"""
+
+    dns_domain: Optional[str] = None
+    """This field is deprecated and can be ignored"""
+
+    dns_name: Optional[str] = None
+    """This field is deprecated and can be ignored"""
+
+    fixed_ip_address: Optional[str] = None
+    """IP address of the port the floating IP is attached to"""
+
+    floating_ip_address: Optional[str] = None
+    """IP Address of the floating IP"""
+
+    instance: Optional[Instance] = None
+    """Instance the floating IP is attached to"""
+
+    loadbalancer: Optional[LoadBalancer] = None
+    """Load balancer the floating IP is attached to"""
+
+    port_id: Optional[str] = None
+    """Port ID"""
+
+    project_id: int
+    """Project ID"""
+
+    region: str
+    """Region name"""
+
+    region_id: int
+    """Region ID"""
+
+    router_id: Optional[str] = None
+    """Router ID"""
+
+    status: Optional[FloatingIPStatus] = None
+    """Floating IP status"""
+
+    subnet_id: Optional[str] = None
+    """This field is deprecated and can be ignored"""
+
+    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.
+    """
+
+    updated_at: datetime
+    """Datetime when the floating IP was last updated"""

gcore/types/cloud/floating_ip_list_params.py

@@ -0,0 +1,35 @@
+# 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__ = ["FloatingIPListParams"]
+
+
+class FloatingIPListParams(TypedDict, total=False):
+    project_id: int
+    """Project ID"""
+
+    region_id: int
+    """Region ID"""
+
+    limit: int
+    """Optional. Limit the number of returned items"""
+
+    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/floating_ip_status.py

@@ -0,0 +1,7 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing_extensions import Literal, TypeAlias
+
+__all__ = ["FloatingIPStatus"]
+
+FloatingIPStatus: TypeAlias = Literal["ACTIVE", "DOWN", "ERROR"]

gcore/types/cloud/gpu_baremetal_cluster.py

@@ -0,0 +1,116 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import List, Optional
+from typing_extensions import Literal
+
+from .tag import Tag
+from ..._models import BaseModel
+from .gpu_baremetal_cluster_server import GPUBaremetalClusterServer
+
+__all__ = ["GPUBaremetalCluster", "Interface"]
+
+
+class Interface(BaseModel):
+    network_id: str
+    """Network ID"""
+
+    port_id: str
+    """Network ID the subnet belongs to. Port will be plugged in this network"""
+
+    subnet_id: str
+    """Port is assigned to IP address from the subnet"""
+
+    type: str
+    """Network type"""
+
+
+class GPUBaremetalCluster(BaseModel):
+    cluster_id: str
+    """GPU Cluster ID"""
+
+    cluster_name: str
+    """GPU Cluster Name"""
+
+    cluster_status: Literal["ACTIVE", "ERROR", "PENDING", "SUSPENDED"]
+    """GPU Cluster status"""
+
+    created_at: Optional[str] = None
+    """Datetime when the cluster was created"""
+
+    creator_task_id: str
+    """Task that created this entity"""
+
+    flavor: str
+    """Flavor ID is the same as the name"""
+
+    image_id: str
+    """Image ID"""
+
+    image_name: str
+    """Image name"""
+
+    interfaces: Optional[List[Interface]] = None
+    """Networks managed by user and associated with the cluster"""
+
+    password: Optional[str] = None
+    """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
+    """
+
+    project_id: int
+    """Project ID"""
+
+    region: str
+    """Region name"""
+
+    region_id: int
+    """Region ID"""
+
+    servers: List[GPUBaremetalClusterServer]
+    """GPU cluster servers"""
+
+    ssh_key_name: Optional[str] = None
+    """Keypair name to inject into new cluster(s)"""
+
+    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
+    """Task ID associated with the cluster"""
+
+    task_status: Literal[
+        "CLUSTER_CLEAN_UP",
+        "CLUSTER_RESIZE",
+        "CLUSTER_RESUME",
+        "CLUSTER_SUSPEND",
+        "ERROR",
+        "FINISHED",
+        "IPU_SERVERS",
+        "NETWORK",
+        "POPLAR_SERVERS",
+        "POST_DEPLOY_SETUP",
+        "VIPU_CONTROLLER",
+    ]
+    """Task status"""
+
+    user_data: Optional[str] = None
+    """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: Optional[str] = None
+    """A name of a new user in the Linux instance.
+
+    It may be passed with a 'password' parameter
+    """

gcore/types/cloud/gpu_baremetal_cluster_create_params.py

@@ -0,0 +1,135 @@
+# 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"""
+
+    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.
+    """
+
+
+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"""