Criar um grupo de destinos
curl --request POST \
--url https://loadbalancer.{region}.basaltic.sh/v1/target-groups \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"name": "web-targets",
"protocol": "http",
"port": 8080,
"target_type": "instance",
"health_check": {
"enabled": true,
"protocol": "http",
"path": "/healthz",
"port": 8080,
"interval_sec": 30,
"timeout_sec": 5,
"healthy_threshold": 3,
"unhealthy_threshold": 3,
"matcher": "200-299,301"
},
"proxy_protocol": false,
"target_mode": "static",
"instance_pool": "a1b2c3d4-e5f6-4789-a0b1-c2d3e4f5a6b7",
"tags": {
"environment": "production",
"team": "backend"
}
}
'import requests
url = "https://loadbalancer.{region}.basaltic.sh/v1/target-groups"
payload = {
"name": "web-targets",
"protocol": "http",
"port": 8080,
"target_type": "instance",
"health_check": {
"enabled": True,
"protocol": "http",
"path": "/healthz",
"port": 8080,
"interval_sec": 30,
"timeout_sec": 5,
"healthy_threshold": 3,
"unhealthy_threshold": 3,
"matcher": "200-299,301"
},
"proxy_protocol": False,
"target_mode": "static",
"instance_pool": "a1b2c3d4-e5f6-4789-a0b1-c2d3e4f5a6b7",
"tags": {
"environment": "production",
"team": "backend"
}
}
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({
name: 'web-targets',
protocol: 'http',
port: 8080,
target_type: 'instance',
health_check: {
enabled: true,
protocol: 'http',
path: '/healthz',
port: 8080,
interval_sec: 30,
timeout_sec: 5,
healthy_threshold: 3,
unhealthy_threshold: 3,
matcher: '200-299,301'
},
proxy_protocol: false,
target_mode: 'static',
instance_pool: 'a1b2c3d4-e5f6-4789-a0b1-c2d3e4f5a6b7',
tags: {environment: 'production', team: 'backend'}
})
};
fetch('https://loadbalancer.{region}.basaltic.sh/v1/target-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://loadbalancer.{region}.basaltic.sh/v1/target-groups",
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([
'name' => 'web-targets',
'protocol' => 'http',
'port' => 8080,
'target_type' => 'instance',
'health_check' => [
'enabled' => true,
'protocol' => 'http',
'path' => '/healthz',
'port' => 8080,
'interval_sec' => 30,
'timeout_sec' => 5,
'healthy_threshold' => 3,
'unhealthy_threshold' => 3,
'matcher' => '200-299,301'
],
'proxy_protocol' => false,
'target_mode' => 'static',
'instance_pool' => 'a1b2c3d4-e5f6-4789-a0b1-c2d3e4f5a6b7',
'tags' => [
'environment' => 'production',
'team' => 'backend'
]
]),
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://loadbalancer.{region}.basaltic.sh/v1/target-groups"
payload := strings.NewReader("{\n \"name\": \"web-targets\",\n \"protocol\": \"http\",\n \"port\": 8080,\n \"target_type\": \"instance\",\n \"health_check\": {\n \"enabled\": true,\n \"protocol\": \"http\",\n \"path\": \"/healthz\",\n \"port\": 8080,\n \"interval_sec\": 30,\n \"timeout_sec\": 5,\n \"healthy_threshold\": 3,\n \"unhealthy_threshold\": 3,\n \"matcher\": \"200-299,301\"\n },\n \"proxy_protocol\": false,\n \"target_mode\": \"static\",\n \"instance_pool\": \"a1b2c3d4-e5f6-4789-a0b1-c2d3e4f5a6b7\",\n \"tags\": {\n \"environment\": \"production\",\n \"team\": \"backend\"\n }\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://loadbalancer.{region}.basaltic.sh/v1/target-groups")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"name\": \"web-targets\",\n \"protocol\": \"http\",\n \"port\": 8080,\n \"target_type\": \"instance\",\n \"health_check\": {\n \"enabled\": true,\n \"protocol\": \"http\",\n \"path\": \"/healthz\",\n \"port\": 8080,\n \"interval_sec\": 30,\n \"timeout_sec\": 5,\n \"healthy_threshold\": 3,\n \"unhealthy_threshold\": 3,\n \"matcher\": \"200-299,301\"\n },\n \"proxy_protocol\": false,\n \"target_mode\": \"static\",\n \"instance_pool\": \"a1b2c3d4-e5f6-4789-a0b1-c2d3e4f5a6b7\",\n \"tags\": {\n \"environment\": \"production\",\n \"team\": \"backend\"\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://loadbalancer.{region}.basaltic.sh/v1/target-groups")
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 \"name\": \"web-targets\",\n \"protocol\": \"http\",\n \"port\": 8080,\n \"target_type\": \"instance\",\n \"health_check\": {\n \"enabled\": true,\n \"protocol\": \"http\",\n \"path\": \"/healthz\",\n \"port\": 8080,\n \"interval_sec\": 30,\n \"timeout_sec\": 5,\n \"healthy_threshold\": 3,\n \"unhealthy_threshold\": 3,\n \"matcher\": \"200-299,301\"\n },\n \"proxy_protocol\": false,\n \"target_mode\": \"static\",\n \"instance_pool\": \"a1b2c3d4-e5f6-4789-a0b1-c2d3e4f5a6b7\",\n \"tags\": {\n \"environment\": \"production\",\n \"team\": \"backend\"\n }\n}"
response = http.request(request)
puts response.read_body{
"target_group": {
"id": "b8c9d0e1-f2a3-4456-b7c8-d9e0f1a2b3c4",
"crn": "crn:loadbalancer:sa-saopaulo-1:my-account:target-group/web-backends",
"account_id": "6f9619ff-8b86-4d01-b42d-00cf4fc964ff",
"name": "web-targets",
"protocol": "http",
"target_type": "instance",
"port": 8080,
"health_check": {
"enabled": true,
"protocol": "http",
"path": "/healthz",
"port": 8080,
"interval_sec": 30,
"timeout_sec": 5,
"healthy_threshold": 3,
"unhealthy_threshold": 3,
"matcher": "200-299,301"
},
"proxy_protocol": false,
"session_affinity": {
"type": "cookie",
"cookie_name": "BASALTICLB",
"duration_sec": 86400
},
"target_mode": "static",
"tags": {
"environment": "production",
"team": "backend"
},
"created_at": "2026-01-15T09:30:00Z",
"updated_at": "2026-01-15T09:30:00Z",
"instance_pool_id": "a1b2c3d4-e5f6-4789-a0b1-c2d3e4f5a6b7"
}
}{
"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": "CONFLICT",
"message": "Resource with this name already exists",
"request_id": "550e8400-e29b-41d4-a716-446655440000"
}
}{
"error": {
"code": "IDEMPOTENCY_KEY_REUSED",
"message": "This Idempotency-Key was already used with a different request payload",
"request_id": "550e8400-e29b-41d4-a716-446655440000"
}
}Grupos de destinos
Criar um grupo de destinos
POST
/
v1
/
target-groups
Criar um grupo de destinos
curl --request POST \
--url https://loadbalancer.{region}.basaltic.sh/v1/target-groups \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"name": "web-targets",
"protocol": "http",
"port": 8080,
"target_type": "instance",
"health_check": {
"enabled": true,
"protocol": "http",
"path": "/healthz",
"port": 8080,
"interval_sec": 30,
"timeout_sec": 5,
"healthy_threshold": 3,
"unhealthy_threshold": 3,
"matcher": "200-299,301"
},
"proxy_protocol": false,
"target_mode": "static",
"instance_pool": "a1b2c3d4-e5f6-4789-a0b1-c2d3e4f5a6b7",
"tags": {
"environment": "production",
"team": "backend"
}
}
'import requests
url = "https://loadbalancer.{region}.basaltic.sh/v1/target-groups"
payload = {
"name": "web-targets",
"protocol": "http",
"port": 8080,
"target_type": "instance",
"health_check": {
"enabled": True,
"protocol": "http",
"path": "/healthz",
"port": 8080,
"interval_sec": 30,
"timeout_sec": 5,
"healthy_threshold": 3,
"unhealthy_threshold": 3,
"matcher": "200-299,301"
},
"proxy_protocol": False,
"target_mode": "static",
"instance_pool": "a1b2c3d4-e5f6-4789-a0b1-c2d3e4f5a6b7",
"tags": {
"environment": "production",
"team": "backend"
}
}
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({
name: 'web-targets',
protocol: 'http',
port: 8080,
target_type: 'instance',
health_check: {
enabled: true,
protocol: 'http',
path: '/healthz',
port: 8080,
interval_sec: 30,
timeout_sec: 5,
healthy_threshold: 3,
unhealthy_threshold: 3,
matcher: '200-299,301'
},
proxy_protocol: false,
target_mode: 'static',
instance_pool: 'a1b2c3d4-e5f6-4789-a0b1-c2d3e4f5a6b7',
tags: {environment: 'production', team: 'backend'}
})
};
fetch('https://loadbalancer.{region}.basaltic.sh/v1/target-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://loadbalancer.{region}.basaltic.sh/v1/target-groups",
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([
'name' => 'web-targets',
'protocol' => 'http',
'port' => 8080,
'target_type' => 'instance',
'health_check' => [
'enabled' => true,
'protocol' => 'http',
'path' => '/healthz',
'port' => 8080,
'interval_sec' => 30,
'timeout_sec' => 5,
'healthy_threshold' => 3,
'unhealthy_threshold' => 3,
'matcher' => '200-299,301'
],
'proxy_protocol' => false,
'target_mode' => 'static',
'instance_pool' => 'a1b2c3d4-e5f6-4789-a0b1-c2d3e4f5a6b7',
'tags' => [
'environment' => 'production',
'team' => 'backend'
]
]),
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://loadbalancer.{region}.basaltic.sh/v1/target-groups"
payload := strings.NewReader("{\n \"name\": \"web-targets\",\n \"protocol\": \"http\",\n \"port\": 8080,\n \"target_type\": \"instance\",\n \"health_check\": {\n \"enabled\": true,\n \"protocol\": \"http\",\n \"path\": \"/healthz\",\n \"port\": 8080,\n \"interval_sec\": 30,\n \"timeout_sec\": 5,\n \"healthy_threshold\": 3,\n \"unhealthy_threshold\": 3,\n \"matcher\": \"200-299,301\"\n },\n \"proxy_protocol\": false,\n \"target_mode\": \"static\",\n \"instance_pool\": \"a1b2c3d4-e5f6-4789-a0b1-c2d3e4f5a6b7\",\n \"tags\": {\n \"environment\": \"production\",\n \"team\": \"backend\"\n }\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://loadbalancer.{region}.basaltic.sh/v1/target-groups")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"name\": \"web-targets\",\n \"protocol\": \"http\",\n \"port\": 8080,\n \"target_type\": \"instance\",\n \"health_check\": {\n \"enabled\": true,\n \"protocol\": \"http\",\n \"path\": \"/healthz\",\n \"port\": 8080,\n \"interval_sec\": 30,\n \"timeout_sec\": 5,\n \"healthy_threshold\": 3,\n \"unhealthy_threshold\": 3,\n \"matcher\": \"200-299,301\"\n },\n \"proxy_protocol\": false,\n \"target_mode\": \"static\",\n \"instance_pool\": \"a1b2c3d4-e5f6-4789-a0b1-c2d3e4f5a6b7\",\n \"tags\": {\n \"environment\": \"production\",\n \"team\": \"backend\"\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://loadbalancer.{region}.basaltic.sh/v1/target-groups")
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 \"name\": \"web-targets\",\n \"protocol\": \"http\",\n \"port\": 8080,\n \"target_type\": \"instance\",\n \"health_check\": {\n \"enabled\": true,\n \"protocol\": \"http\",\n \"path\": \"/healthz\",\n \"port\": 8080,\n \"interval_sec\": 30,\n \"timeout_sec\": 5,\n \"healthy_threshold\": 3,\n \"unhealthy_threshold\": 3,\n \"matcher\": \"200-299,301\"\n },\n \"proxy_protocol\": false,\n \"target_mode\": \"static\",\n \"instance_pool\": \"a1b2c3d4-e5f6-4789-a0b1-c2d3e4f5a6b7\",\n \"tags\": {\n \"environment\": \"production\",\n \"team\": \"backend\"\n }\n}"
response = http.request(request)
puts response.read_body{
"target_group": {
"id": "b8c9d0e1-f2a3-4456-b7c8-d9e0f1a2b3c4",
"crn": "crn:loadbalancer:sa-saopaulo-1:my-account:target-group/web-backends",
"account_id": "6f9619ff-8b86-4d01-b42d-00cf4fc964ff",
"name": "web-targets",
"protocol": "http",
"target_type": "instance",
"port": 8080,
"health_check": {
"enabled": true,
"protocol": "http",
"path": "/healthz",
"port": 8080,
"interval_sec": 30,
"timeout_sec": 5,
"healthy_threshold": 3,
"unhealthy_threshold": 3,
"matcher": "200-299,301"
},
"proxy_protocol": false,
"session_affinity": {
"type": "cookie",
"cookie_name": "BASALTICLB",
"duration_sec": 86400
},
"target_mode": "static",
"tags": {
"environment": "production",
"team": "backend"
},
"created_at": "2026-01-15T09:30:00Z",
"updated_at": "2026-01-15T09:30:00Z",
"instance_pool_id": "a1b2c3d4-e5f6-4789-a0b1-c2d3e4f5a6b7"
}
}{
"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": "CONFLICT",
"message": "Resource with this name already exists",
"request_id": "550e8400-e29b-41d4-a716-446655440000"
}
}{
"error": {
"code": "IDEMPOTENCY_KEY_REUSED",
"message": "This Idempotency-Key was already used with a different request payload",
"request_id": "550e8400-e29b-41d4-a716-446655440000"
}
}Requer a ação do IAM
loadbalancer:CreateTargetGroup. Consulte permissões de balanceadores de carga 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.
Maximum string length:
255Corpo
application/json
instance_pool aceita um UUID, CRN ou nome exato de escopo de conta nessa região e requer o modo de destino de pool.
Os nomes de recursos não devem começar com o prefixo literal crn: ou ser UUIDs (formas canônicas, compactas, entre colchetes ou urn:uuid:, em qualquer caso).
Exemplo:
"web-targets"
Opções disponíveis:
http, https, tcp, udp Exemplo:
"http"
Intervalo obrigatório:
1 <= x <= 65535Exemplo:
8080
Opções disponíveis:
ip, instance, function Exemplo:
"instance"
As sondas ativas são habilitadas por padrão. Defina enabled=false para parar as sondas enquanto mantém sua configuração. Uma verificação HTTP/HTTPS explicitamente habilitada requer um caminho não vazio começando com /. As verificações TCP conectam-se à porta de verificação sem um caminho HTTP. Os grupos UDP são padrão para sondas de conexão TCP.
Show child attributes
Show child attributes
Exemplo:
false
Sessões fixas: fixe um cliente a um backend no grupo em vez de balancear cada solicitação de forma independente. Desligado a menos que você peça.
O plano de dados faz o hash da chave de forma consistente, portanto, adicionar ou perder um backend move apenas os clientes que esse backend estava servindo.
Show child attributes
Show child attributes
static (o padrão) leva os backends que você anexar como alvos. pool os pega de um pool de instâncias de computação e requer instance_pool; o grupo é forçado a target_type=instância, e anexar alvos a ele é rejeitado.
Opções disponíveis:
static, pool Exemplo:
"static"
Compute o pool de instâncias para desenhar backends. Obrigatório quando target_mode=pool e deve pertencer à conta de chamada; ignorado caso contrário.
Exemplo:
"a1b2c3d4-e5f6-4789-a0b1-c2d3e4f5a6b7"
Show child attributes
Show child attributes
Exemplo:
{
"environment": "production",
"team": "backend"
}
Resposta
Criado
Show child attributes
Show child attributes