Skip to main content
POST
/
cloud
/
v1
/
instances
/
{project_id}
/
{region_id}
/
{instance_id}
/
attach_interface
Python
import os
from gcore import Gcore

client = Gcore(
    api_key=os.environ.get("GCORE_API_KEY"),  # This is the default and can be omitted
)
task_id_list = client.cloud.instances.interfaces.attach(
    instance_id="instance_id",
    project_id=0,
    region_id=0,
)
print(task_id_list.tasks)
{
  "tasks": [
    "<string>"
  ]
}

Authorizations

​
Authorization
string
header
required

API key for authentication. Make sure to include the word apikey, followed by a single space and then your token. Example: apikey 1234$abcdef

Path Parameters

​
project_id
integer
required

Project ID

​
region_id
integer
required

Region ID

​
instance_id
string
required

Instance ID

Body

application/json
  • Option 1
  • Option 2
  • Option 3
  • Option 4

Instance will be attached to default external network

​
ddos_profile
object

Advanced DDoS protection.

Example:
{ "profile_template": 29, "fields": [] }
​
interface_name
string

Interface name

Maximum string length: 37
​
ip_family
enum<string>

Which subnets should be selected: IPv4, IPv6 or use dual stack.

Available options:
dual,
ipv4,
ipv6
​
port_group
integer

Each group will be added to the separate trunk.

Required range: 0 <= x <= 3
​
security_groups
object[]

List of security group IDs

​
type
string
default:external

Must be 'external'. Union tag

Response

200 - application/json

Created task

​
tasks
string[]
required

List of task IDs representing asynchronous operations. Use these IDs to monitor operation progress:

  • GET /v1/tasks/{task_id} - Check individual task status and details Poll task status until completion (FINISHED/ERROR) before proceeding with dependent operations.