Atualizar verificações de integridade, enquadramento ou afinidade de sessão de um grupo de destinos
curl --request PATCH \
--url https://loadbalancer.{region}.basaltic.sh/v1/target-groups/{id} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"health_check": {
"enabled": true,
"protocol": "http",
"path": "/healthz",
"port": 32767,
"interval_sec": 30,
"timeout_sec": 5,
"healthy_threshold": 3,
"unhealthy_threshold": 3,
"matcher": "200-299,301"
},
"proxy_protocol": true,
"tags": {
"environment": "production",
"team": "backend"
}
}
'import requests
url = "https://loadbalancer.{region}.basaltic.sh/v1/target-groups/{id}"
payload = {
"health_check": {
"enabled": True,
"protocol": "http",
"path": "/healthz",
"port": 32767,
"interval_sec": 30,
"timeout_sec": 5,
"healthy_threshold": 3,
"unhealthy_threshold": 3,
"matcher": "200-299,301"
},
"proxy_protocol": True,
"tags": {
"environment": "production",
"team": "backend"
}
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.patch(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PATCH',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
health_check: {
enabled: true,
protocol: 'http',
path: '/healthz',
port: 32767,
interval_sec: 30,
timeout_sec: 5,
healthy_threshold: 3,
unhealthy_threshold: 3,
matcher: '200-299,301'
},
proxy_protocol: true,
tags: {environment: 'production', team: 'backend'}
})
};
fetch('https://loadbalancer.{region}.basaltic.sh/v1/target-groups/{id}', 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/{id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PATCH",
CURLOPT_POSTFIELDS => json_encode([
'health_check' => [
'enabled' => true,
'protocol' => 'http',
'path' => '/healthz',
'port' => 32767,
'interval_sec' => 30,
'timeout_sec' => 5,
'healthy_threshold' => 3,
'unhealthy_threshold' => 3,
'matcher' => '200-299,301'
],
'proxy_protocol' => true,
'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/{id}"
payload := strings.NewReader("{\n \"health_check\": {\n \"enabled\": true,\n \"protocol\": \"http\",\n \"path\": \"/healthz\",\n \"port\": 32767,\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\": true,\n \"tags\": {\n \"environment\": \"production\",\n \"team\": \"backend\"\n }\n}")
req, _ := http.NewRequest("PATCH", 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.patch("https://loadbalancer.{region}.basaltic.sh/v1/target-groups/{id}")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"health_check\": {\n \"enabled\": true,\n \"protocol\": \"http\",\n \"path\": \"/healthz\",\n \"port\": 32767,\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\": true,\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/{id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Patch.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"health_check\": {\n \"enabled\": true,\n \"protocol\": \"http\",\n \"path\": \"/healthz\",\n \"port\": 32767,\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\": true,\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": "NOT_FOUND",
"message": "Resource not found",
"request_id": "550e8400-e29b-41d4-a716-446655440000"
}
}Grupos de destinos
Atualizar verificações de integridade, enquadramento ou afinidade de sessão de um grupo de destinos
PATCH
/
v1
/
target-groups
/
{id}
Atualizar verificações de integridade, enquadramento ou afinidade de sessão de um grupo de destinos
curl --request PATCH \
--url https://loadbalancer.{region}.basaltic.sh/v1/target-groups/{id} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"health_check": {
"enabled": true,
"protocol": "http",
"path": "/healthz",
"port": 32767,
"interval_sec": 30,
"timeout_sec": 5,
"healthy_threshold": 3,
"unhealthy_threshold": 3,
"matcher": "200-299,301"
},
"proxy_protocol": true,
"tags": {
"environment": "production",
"team": "backend"
}
}
'import requests
url = "https://loadbalancer.{region}.basaltic.sh/v1/target-groups/{id}"
payload = {
"health_check": {
"enabled": True,
"protocol": "http",
"path": "/healthz",
"port": 32767,
"interval_sec": 30,
"timeout_sec": 5,
"healthy_threshold": 3,
"unhealthy_threshold": 3,
"matcher": "200-299,301"
},
"proxy_protocol": True,
"tags": {
"environment": "production",
"team": "backend"
}
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.patch(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PATCH',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
health_check: {
enabled: true,
protocol: 'http',
path: '/healthz',
port: 32767,
interval_sec: 30,
timeout_sec: 5,
healthy_threshold: 3,
unhealthy_threshold: 3,
matcher: '200-299,301'
},
proxy_protocol: true,
tags: {environment: 'production', team: 'backend'}
})
};
fetch('https://loadbalancer.{region}.basaltic.sh/v1/target-groups/{id}', 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/{id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PATCH",
CURLOPT_POSTFIELDS => json_encode([
'health_check' => [
'enabled' => true,
'protocol' => 'http',
'path' => '/healthz',
'port' => 32767,
'interval_sec' => 30,
'timeout_sec' => 5,
'healthy_threshold' => 3,
'unhealthy_threshold' => 3,
'matcher' => '200-299,301'
],
'proxy_protocol' => true,
'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/{id}"
payload := strings.NewReader("{\n \"health_check\": {\n \"enabled\": true,\n \"protocol\": \"http\",\n \"path\": \"/healthz\",\n \"port\": 32767,\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\": true,\n \"tags\": {\n \"environment\": \"production\",\n \"team\": \"backend\"\n }\n}")
req, _ := http.NewRequest("PATCH", 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.patch("https://loadbalancer.{region}.basaltic.sh/v1/target-groups/{id}")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"health_check\": {\n \"enabled\": true,\n \"protocol\": \"http\",\n \"path\": \"/healthz\",\n \"port\": 32767,\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\": true,\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/{id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Patch.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"health_check\": {\n \"enabled\": true,\n \"protocol\": \"http\",\n \"path\": \"/healthz\",\n \"port\": 32767,\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\": true,\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": "NOT_FOUND",
"message": "Resource not found",
"request_id": "550e8400-e29b-41d4-a716-446655440000"
}
}Requer a ação do IAM
loadbalancer:UpdateTargetGroup. 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.
Parâmetros de caminho
UUID, CRN ou nome exato do escopo da conta
Exemplo:
"b8c9d0e1-f2a3-4456-b7c8-d9e0f1a2b3c4"
Corpo
application/json
Os nomes são fixos na criação porque formam o CRN usado pelas políticas do IAM. Enviar nome em uma atualização, incluindo um valor inalterado, vazio ou nulo, retorna um erro de validação.
Mesclar campos fornecidos na verificação existente. Campos omitidos são preservados; nulo ou um objeto vazio deixa a verificação inalterada. Defina enabled=false para desabilitar sondas sem limpar configurações e enabled=true para habilitar a configuração salva. Defina port=0 para usar a porta de tráfego de cada destino; zero timing/thresholds e um matcher vazio redefinirão seus padrões. Um protocolo vazio herda o protocolo do grupo de destino. Limpar o caminho de uma verificação HTTP/HTTPS explicitamente habilitada é inválido.
Show child attributes
Show child attributes
Alternar o enquadramento PROXY v2 em conexões upstream. Omitir o campo deixa a configuração atual; definir true/false o inverte explicitamente.
Substitui a configuração de aderência. Omitir o campo deixa-o sozinho; desligá-lo é um {"type": "none"} explícito.
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Exemplo:
{
"environment": "production",
"team": "backend"
}
Resposta
OK
Show child attributes
Show child attributes