curl --request POST \
--url https://compute.{region}.basaltic.sh/v1/instances/{instance_id}/nics \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"interface": "e8a1c2d3-4b5f-4a6e-9c0d-1e2f3a4b5c6d"
}
'import requests
url = "https://compute.{region}.basaltic.sh/v1/instances/{instance_id}/nics"
payload = { "interface": "e8a1c2d3-4b5f-4a6e-9c0d-1e2f3a4b5c6d" }
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({interface: 'e8a1c2d3-4b5f-4a6e-9c0d-1e2f3a4b5c6d'})
};
fetch('https://compute.{region}.basaltic.sh/v1/instances/{instance_id}/nics', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://compute.{region}.basaltic.sh/v1/instances/{instance_id}/nics",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'interface' => 'e8a1c2d3-4b5f-4a6e-9c0d-1e2f3a4b5c6d'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://compute.{region}.basaltic.sh/v1/instances/{instance_id}/nics"
payload := strings.NewReader("{\n \"interface\": \"e8a1c2d3-4b5f-4a6e-9c0d-1e2f3a4b5c6d\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://compute.{region}.basaltic.sh/v1/instances/{instance_id}/nics")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"interface\": \"e8a1c2d3-4b5f-4a6e-9c0d-1e2f3a4b5c6d\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://compute.{region}.basaltic.sh/v1/instances/{instance_id}/nics")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"interface\": \"e8a1c2d3-4b5f-4a6e-9c0d-1e2f3a4b5c6d\"\n}"
response = http.request(request)
puts response.read_body{
"attachment": {
"interface_id": "e8a1c2d3-4b5f-4a6e-9c0d-1e2f3a4b5c6d",
"mac": "02:1a:2b:3c:4d:5e",
"boot_index": 0,
"external": false,
"restart_required": true,
"addresses": [
{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"family": "ipv4",
"address": "<string>",
"prefix": "<string>",
"primary": true,
"floating_ips": [
{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"crn": "<string>",
"visibility": "public",
"address": "<string>"
}
]
}
]
}
}{
"error": {
"code": "INVALID_INPUT",
"message": "Invalid request parameters",
"request_id": "550e8400-e29b-41d4-a716-446655440000"
}
}{
"error": {
"code": "UNAUTHORIZED",
"message": "Authentication required",
"request_id": "550e8400-e29b-41d4-a716-446655440000"
}
}{
"error": {
"code": "ACCESS_DENIED",
"message": "You don't have permission to perform this action",
"request_id": "550e8400-e29b-41d4-a716-446655440000"
}
}{
"error": {
"code": "NOT_FOUND",
"message": "Resource not found",
"request_id": "550e8400-e29b-41d4-a716-446655440000"
}
}{
"error": {
"code": "INVALID_INPUT",
"message": "Invalid request parameters",
"request_id": "550e8400-e29b-41d4-a716-446655440000",
"params": {
"instances": 2,
"pools": 0
}
}
}{
"error": {
"code": "IDEMPOTENCY_KEY_REUSED",
"message": "This Idempotency-Key was already used with a different request payload",
"request_id": "550e8400-e29b-41d4-a716-446655440000"
}
}Anexar uma NIC existente a uma instância
Anexa uma interface de rede autônoma existente. A instância deve estar em execução ou parada. Para criar uma interface, use POST /v1/interfaces na API de rede antes de anexá-la. Esta operação nunca provisiona uma interface.
O anexo é durável no momento em que ele retorna: ele faz parte da especificação da instância e sobrevive a reinicializações. A entrega ao hóspede é assíncrona e a resposta diz o que é preciso.
Uma instância parada aparece com o dispositivo, e restart_required está ausente. Uma instância em execução é dada ao dispositivo enquanto ele está em execução onde a região suporta que: a chamada retorna antes que o convidado tenha, restart_required está ausente, e a interface aparece no convidado momentos depois — poll GET /v1/instances/{instance_id}/nics, ou observe o convidado para um link que carrega o MAC nesta resposta. Onde a região não o faz, a resposta define restart_required: reiniciar a instância com {"hard": true} para entregá-lo. Uma reinicialização suave é ACPI dentro do mesmo lançador e não vai.
O endereço é DHCP de qualquer maneira. Nada configura a nova interface dentro do convidado, então uma imagem que não traz um dispositivo de rede quando aparece (cloud-init hotplug, NetworkManager, systemd-networkd com uma correspondência de curinga) mantém o link sem um endereço até que algo no convidado peça o lease.
curl --request POST \
--url https://compute.{region}.basaltic.sh/v1/instances/{instance_id}/nics \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"interface": "e8a1c2d3-4b5f-4a6e-9c0d-1e2f3a4b5c6d"
}
'import requests
url = "https://compute.{region}.basaltic.sh/v1/instances/{instance_id}/nics"
payload = { "interface": "e8a1c2d3-4b5f-4a6e-9c0d-1e2f3a4b5c6d" }
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({interface: 'e8a1c2d3-4b5f-4a6e-9c0d-1e2f3a4b5c6d'})
};
fetch('https://compute.{region}.basaltic.sh/v1/instances/{instance_id}/nics', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://compute.{region}.basaltic.sh/v1/instances/{instance_id}/nics",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'interface' => 'e8a1c2d3-4b5f-4a6e-9c0d-1e2f3a4b5c6d'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://compute.{region}.basaltic.sh/v1/instances/{instance_id}/nics"
payload := strings.NewReader("{\n \"interface\": \"e8a1c2d3-4b5f-4a6e-9c0d-1e2f3a4b5c6d\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://compute.{region}.basaltic.sh/v1/instances/{instance_id}/nics")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"interface\": \"e8a1c2d3-4b5f-4a6e-9c0d-1e2f3a4b5c6d\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://compute.{region}.basaltic.sh/v1/instances/{instance_id}/nics")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"interface\": \"e8a1c2d3-4b5f-4a6e-9c0d-1e2f3a4b5c6d\"\n}"
response = http.request(request)
puts response.read_body{
"attachment": {
"interface_id": "e8a1c2d3-4b5f-4a6e-9c0d-1e2f3a4b5c6d",
"mac": "02:1a:2b:3c:4d:5e",
"boot_index": 0,
"external": false,
"restart_required": true,
"addresses": [
{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"family": "ipv4",
"address": "<string>",
"prefix": "<string>",
"primary": true,
"floating_ips": [
{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"crn": "<string>",
"visibility": "public",
"address": "<string>"
}
]
}
]
}
}{
"error": {
"code": "INVALID_INPUT",
"message": "Invalid request parameters",
"request_id": "550e8400-e29b-41d4-a716-446655440000"
}
}{
"error": {
"code": "UNAUTHORIZED",
"message": "Authentication required",
"request_id": "550e8400-e29b-41d4-a716-446655440000"
}
}{
"error": {
"code": "ACCESS_DENIED",
"message": "You don't have permission to perform this action",
"request_id": "550e8400-e29b-41d4-a716-446655440000"
}
}{
"error": {
"code": "NOT_FOUND",
"message": "Resource not found",
"request_id": "550e8400-e29b-41d4-a716-446655440000"
}
}{
"error": {
"code": "INVALID_INPUT",
"message": "Invalid request parameters",
"request_id": "550e8400-e29b-41d4-a716-446655440000",
"params": {
"instances": 2,
"pools": 0
}
}
}{
"error": {
"code": "IDEMPOTENCY_KEY_REUSED",
"message": "This Idempotency-Key was already used with a different request payload",
"request_id": "550e8400-e29b-41d4-a716-446655440000"
}
}compute:AttachNIC. Consulte permissões de computação para obter a lista completa, o que cada uma abrange e um exemplo de política.Autorizações
Um token bearer OAuth 2.0, enviado como Authorization: Bearer <token>. Esta é a forma recomendada de autenticação.
Obtenha o token trocando o par de chaves de acesso de uma conta de serviço em POST /v1/oauth/token com grant_type=client_credentials. Esse é o fluxo padrão de credenciais de cliente; bibliotecas compatíveis com OAuth podem obter e renovar o token para você.
curl -s -u "$KEY_ID:$SECRET" -d grant_type=client_credentials \
https://iam.basaltic.sh/v1/oauth/token
Os tokens duram uma hora por padrão. O mesmo par de chaves de acesso também serve como credencial AWS SigV4 para o endpoint de objetos compatível com S3, que aceita somente esse método de autenticação.
Cabeçalhos
Chave opcional gerada pelo cliente que torna uma criação segura para reprodução. A reintentar uma solicitação com a mesma chave retorna o resultado original literalmente em vez de criar um recurso duplicado. A reutilização de uma chave com um corpo de solicitação diferente é rejeitada (422); uma solicitação cuja chave ainda está sendo processada retorna 409. Os registros são honrados por 24 horas. Use um UUID ou token exclusivo semelhante.
255Parâmetros de caminho
ID da instância
Corpo
UUID de interface autônoma existente ou VPC/sub-rede/CRN de interface completo. Os nomes nulos não têm o pai da sub-rede e são rejeitados. Ele mantém seu endereço, MAC e grupos de segurança; detach retorna-o para standalone em vez de destruí-lo.
1"e8a1c2d3-4b5f-4a6e-9c0d-1e2f3a4b5c6d"
Resposta
Anexo aceito
Show child attributes
Show child attributes

