curl --request PUT \
--url https://network.{region}.basaltic.sh/v1/interfaces/{interface_id}/security-groups \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"security_groups": [
"d1b6f3a8-4c2e-4a9d-8f7b-1e5c3a2d9b4f"
]
}
'import requests
url = "https://network.{region}.basaltic.sh/v1/interfaces/{interface_id}/security-groups"
payload = { "security_groups": ["d1b6f3a8-4c2e-4a9d-8f7b-1e5c3a2d9b4f"] }
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.put(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PUT',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({security_groups: ['d1b6f3a8-4c2e-4a9d-8f7b-1e5c3a2d9b4f']})
};
fetch('https://network.{region}.basaltic.sh/v1/interfaces/{interface_id}/security-groups', 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://network.{region}.basaltic.sh/v1/interfaces/{interface_id}/security-groups",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PUT",
CURLOPT_POSTFIELDS => json_encode([
'security_groups' => [
'd1b6f3a8-4c2e-4a9d-8f7b-1e5c3a2d9b4f'
]
]),
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://network.{region}.basaltic.sh/v1/interfaces/{interface_id}/security-groups"
payload := strings.NewReader("{\n \"security_groups\": [\n \"d1b6f3a8-4c2e-4a9d-8f7b-1e5c3a2d9b4f\"\n ]\n}")
req, _ := http.NewRequest("PUT", 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.put("https://network.{region}.basaltic.sh/v1/interfaces/{interface_id}/security-groups")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"security_groups\": [\n \"d1b6f3a8-4c2e-4a9d-8f7b-1e5c3a2d9b4f\"\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://network.{region}.basaltic.sh/v1/interfaces/{interface_id}/security-groups")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Put.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"security_groups\": [\n \"d1b6f3a8-4c2e-4a9d-8f7b-1e5c3a2d9b4f\"\n ]\n}"
response = http.request(request)
puts response.read_body{
"security_group_ids": [
"d1b6f3a8-4c2e-4a9d-8f7b-1e5c3a2d9b4f"
]
}{
"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": "INTERNAL_ERROR",
"message": "An internal error occurred",
"request_id": "550e8400-e29b-41d4-a716-446655440000"
}
}Definir grupos de segurança associados à interface
Substitui atomicamente a associação SG da interface com a lista fornecida. Adições e remoções são comparadas com o estado atual. Cada ID deve fazer referência a um SG de propriedade do chamador.
curl --request PUT \
--url https://network.{region}.basaltic.sh/v1/interfaces/{interface_id}/security-groups \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"security_groups": [
"d1b6f3a8-4c2e-4a9d-8f7b-1e5c3a2d9b4f"
]
}
'import requests
url = "https://network.{region}.basaltic.sh/v1/interfaces/{interface_id}/security-groups"
payload = { "security_groups": ["d1b6f3a8-4c2e-4a9d-8f7b-1e5c3a2d9b4f"] }
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.put(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PUT',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({security_groups: ['d1b6f3a8-4c2e-4a9d-8f7b-1e5c3a2d9b4f']})
};
fetch('https://network.{region}.basaltic.sh/v1/interfaces/{interface_id}/security-groups', 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://network.{region}.basaltic.sh/v1/interfaces/{interface_id}/security-groups",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PUT",
CURLOPT_POSTFIELDS => json_encode([
'security_groups' => [
'd1b6f3a8-4c2e-4a9d-8f7b-1e5c3a2d9b4f'
]
]),
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://network.{region}.basaltic.sh/v1/interfaces/{interface_id}/security-groups"
payload := strings.NewReader("{\n \"security_groups\": [\n \"d1b6f3a8-4c2e-4a9d-8f7b-1e5c3a2d9b4f\"\n ]\n}")
req, _ := http.NewRequest("PUT", 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.put("https://network.{region}.basaltic.sh/v1/interfaces/{interface_id}/security-groups")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"security_groups\": [\n \"d1b6f3a8-4c2e-4a9d-8f7b-1e5c3a2d9b4f\"\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://network.{region}.basaltic.sh/v1/interfaces/{interface_id}/security-groups")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Put.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"security_groups\": [\n \"d1b6f3a8-4c2e-4a9d-8f7b-1e5c3a2d9b4f\"\n ]\n}"
response = http.request(request)
puts response.read_body{
"security_group_ids": [
"d1b6f3a8-4c2e-4a9d-8f7b-1e5c3a2d9b4f"
]
}{
"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": "INTERNAL_ERROR",
"message": "An internal error occurred",
"request_id": "550e8400-e29b-41d4-a716-446655440000"
}
}network:SetInterfaceSecurityGroups. Consulte permissões de redes 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.
Parâmetros de caminho
Interface ID
Corpo
UUIDs de grupo de segurança, CRNs ou nomes de escopo de conta. Todas as entradas são resolvidas antes da substituição; IDs canônicos duplicados são recolhidos para uma associação. Um array vazio remove todos os grupos.
Resposta
Nova adesão ao SG

