Atualizar regra de largura de banda

PATCH

api

bandwidth

auto-refill

{rule_id}

Atualizar regra de largura de banda

curl --request PATCH \
  --url https://api.example.com/api/v1/bandwidth/auto-refill/{rule_id} \
  --header 'Content-Type: application/json' \
  --data '
{
  "threshold_bandwidth": 123,
  "add_volume": 123,
  "duration": "<string>",
  "label": "<string>",
  "status": "<string>"
}
'

import requests

url = "https://api.example.com/api/v1/bandwidth/auto-refill/{rule_id}"

payload = {
    "threshold_bandwidth": 123,
    "add_volume": 123,
    "duration": "<string>",
    "label": "<string>",
    "status": "<string>"
}
headers = {"Content-Type": "application/json"}

response = requests.patch(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'PATCH',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({
    threshold_bandwidth: 123,
    add_volume: 123,
    duration: '<string>',
    label: '<string>',
    status: '<string>'
  })
};

fetch('https://api.example.com/api/v1/bandwidth/auto-refill/{rule_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://api.example.com/api/v1/bandwidth/auto-refill/{rule_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([
    'threshold_bandwidth' => 123,
    'add_volume' => 123,
    'duration' => '<string>',
    'label' => '<string>',
    'status' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "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://api.example.com/api/v1/bandwidth/auto-refill/{rule_id}"

	payload := strings.NewReader("{\n  \"threshold_bandwidth\": 123,\n  \"add_volume\": 123,\n  \"duration\": \"<string>\",\n  \"label\": \"<string>\",\n  \"status\": \"<string>\"\n}")

	req, _ := http.NewRequest("PATCH", url, payload)

	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://api.example.com/api/v1/bandwidth/auto-refill/{rule_id}")
  .header("Content-Type", "application/json")
  .body("{\n  \"threshold_bandwidth\": 123,\n  \"add_volume\": 123,\n  \"duration\": \"<string>\",\n  \"label\": \"<string>\",\n  \"status\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.example.com/api/v1/bandwidth/auto-refill/{rule_id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Patch.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n  \"threshold_bandwidth\": 123,\n  \"add_volume\": 123,\n  \"duration\": \"<string>\",\n  \"label\": \"<string>\",\n  \"status\": \"<string>\"\n}"

response = http.request(request)
puts response.read_body

Atualizar regra de largura de banda

Altera o limiar, o volume, a duração ou o rótulo de uma regra, ou a pausa e retoma. Envie apenas os campos que deseja alterar; os demais permanecem como estão. As alterações valem a partir da verificação seguinte. Exige o escopo buy_bandwidth. O endereço de uma regra não pode ser alterado. Para mover uma regra para outro endereço, exclua-a e crie uma nova.

Parâmetros de caminho

number

obrigatório

ID da regra — o id retornado por Criar ou Listar regras de largura de banda

Corpo da requisição

number

Novo limiar. De 1 a 1.000.000.

number

Nova quantidade de largura de banda por recarga. De 350 a 100.000.

string

Nova duração do aluguel para as próximas recargas: "1h" ou "1d". Os aluguéis já comprados mantêm a duração que tinham.

string

Novo rótulo, até 100 caracteres. Uma string vazia remove o rótulo.

string

"paused" para pausar a regra, "active" para retomá-la. Retomar também limpa stopped_reason e redefine consecutive_failures para 0. Uma regra parada por saldo é retomada sozinha após um depósito, então você não precisa fazer isso; se você a retomar enquanto o saldo ainda for insuficiente, ela para de novo na verificação seguinte. stopped_insufficient_balance não pode ser definido diretamente.

Resposta

A regra atualizada, com os mesmos campos de Listar regras de largura de banda.

Exemplo

curl -X PATCH https://api.tronrental.com/v1/bandwidth/auto-refill/15 \
  -H "X-API-Key: your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"duration": "1d"}'

import requests

resp = requests.patch(
    "https://api.tronrental.com/v1/bandwidth/auto-refill/15",
    headers={"X-API-Key": "your_api_key"},
    json={"duration": "1d"},
)
print(resp.json())

const resp = await fetch("https://api.tronrental.com/v1/bandwidth/auto-refill/15", {
  method: "PATCH",
  headers: { "X-API-Key": "your_api_key", "Content-Type": "application/json" },
  body: JSON.stringify({ duration: "1d" }),
});
console.log(await resp.json());

Response

{
  "id": 15,
  "target_address": "TYourRecipientAddress1234567890abc",
  "label": "Payouts",
  "threshold_bandwidth": 1000,
  "add_volume": 5000,
  "duration": "1d",
  "status": "active",
  "stopped_reason": null,
  "consecutive_failures": 0,
  "last_checked_at": "2026-10-14T09:41:02Z",
  "last_available_bandwidth": 3655,
  "last_read_error_at": null,
  "last_refill_at": "2026-10-14T09:12:30Z",
  "refill_count": 4,
  "total_spent_trx": "1.480000",
  "created_at": "2026-10-14T08:15:00Z",
  "estimated_cost_per_refill_trx": "0.500000",
  "volume_below_threshold": false
}

Erros

Status	Código	Quando
`403`	`FORBIDDEN`	A chave de API não tem o escopo `buy_bandwidth`
`404`	`NOT_FOUND`	Não há regra de largura de banda com este ID na sua conta (ou ela foi excluída)
`409`	`AUTOREFILL_IN_PROGRESS`	Uma recarga desta regra está sendo comprada neste momento — tente novamente em um minuto
`422`	—	Um valor está fora do intervalo, `duration` não é `"1h"` nem `"1d"`, ou `status` não é `"active"` nem `"paused"`

{
  "detail": {
    "error": {
      "code": "AUTOREFILL_IN_PROGRESS",
      "message": "A refill is in progress for this rule; try again in a minute"
    }
  }
}

Atualizar regra de largura de banda

curl --request PATCH \
  --url https://api.example.com/api/v1/bandwidth/auto-refill/{rule_id} \
  --header 'Content-Type: application/json' \
  --data '
{
  "threshold_bandwidth": 123,
  "add_volume": 123,
  "duration": "<string>",
  "label": "<string>",
  "status": "<string>"
}
'

import requests

url = "https://api.example.com/api/v1/bandwidth/auto-refill/{rule_id}"

payload = {
    "threshold_bandwidth": 123,
    "add_volume": 123,
    "duration": "<string>",
    "label": "<string>",
    "status": "<string>"
}
headers = {"Content-Type": "application/json"}

response = requests.patch(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'PATCH',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({
    threshold_bandwidth: 123,
    add_volume: 123,
    duration: '<string>',
    label: '<string>',
    status: '<string>'
  })
};

fetch('https://api.example.com/api/v1/bandwidth/auto-refill/{rule_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://api.example.com/api/v1/bandwidth/auto-refill/{rule_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([
    'threshold_bandwidth' => 123,
    'add_volume' => 123,
    'duration' => '<string>',
    'label' => '<string>',
    'status' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "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://api.example.com/api/v1/bandwidth/auto-refill/{rule_id}"

	payload := strings.NewReader("{\n  \"threshold_bandwidth\": 123,\n  \"add_volume\": 123,\n  \"duration\": \"<string>\",\n  \"label\": \"<string>\",\n  \"status\": \"<string>\"\n}")

	req, _ := http.NewRequest("PATCH", url, payload)

	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://api.example.com/api/v1/bandwidth/auto-refill/{rule_id}")
  .header("Content-Type", "application/json")
  .body("{\n  \"threshold_bandwidth\": 123,\n  \"add_volume\": 123,\n  \"duration\": \"<string>\",\n  \"label\": \"<string>\",\n  \"status\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.example.com/api/v1/bandwidth/auto-refill/{rule_id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Patch.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n  \"threshold_bandwidth\": 123,\n  \"add_volume\": 123,\n  \"duration\": \"<string>\",\n  \"label\": \"<string>\",\n  \"status\": \"<string>\"\n}"

response = http.request(request)
puts response.read_body

API Principal

Aluguéis de largura de banda

Recarga automática

Pedidos

Faturas

Smart Mode

Pacotes de transferência

Conta

Webhooks

Atualizar regra de largura de banda

Atualizar regra de largura de banda

Parâmetros de caminho

Corpo da requisição

Resposta

Exemplo

Erros

​Atualizar regra de largura de banda

​Parâmetros de caminho

​Corpo da requisição

​Resposta

​Exemplo

​Erros

Atualizar regra de largura de banda

Parâmetros de caminho

Corpo da requisição

Resposta

Exemplo

Erros