Actualizar regla de ancho de banda

PATCH

api

bandwidth

auto-refill

{rule_id}

Actualizar regla de ancho 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

Actualizar regla de ancho de banda

Cambia el umbral, el volumen, la duración o la etiqueta de una regla, o la pausa y la reanuda. Envía solo los campos que quieras cambiar; los demás se quedan como están. Los cambios se aplican desde la siguiente comprobación. Requiere el alcance buy_bandwidth. La dirección de una regla no se puede cambiar. Para pasar una regla a otra dirección, elimínala y crea una nueva.

Parámetros de ruta

number

requerido

ID de la regla — el id que devuelven Crear o Listar reglas de ancho de banda

Cuerpo de la solicitud

number

Nuevo umbral. De 1 a 1,000,000.

number

Nueva cantidad de ancho de banda por recarga. De 350 a 100,000.

string

Nueva duración del alquiler para las recargas futuras: "1h" o "1d". Los alquileres ya comprados mantienen su duración.

string

Nueva etiqueta, hasta 100 caracteres. Una cadena vacía elimina la etiqueta.

string

"paused" para pausar la regla, "active" para reanudarla. Al reanudarla también se borra stopped_reason y consecutive_failures vuelve a 0. Una regla detenida por saldo se reanuda sola tras un depósito, así que no tienes que hacerlo tú; si la reanudas mientras el saldo sigue sin alcanzar, se detiene de nuevo en la siguiente comprobación. stopped_insufficient_balance no se puede establecer directamente.

Respuesta

La regla actualizada, con los mismos campos que en Listar reglas de ancho de banda.

Ejemplo

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
}

Errores

Estado	Código	Cuándo
`403`	`FORBIDDEN`	La clave API carece del alcance `buy_bandwidth`
`404`	`NOT_FOUND`	No hay ninguna regla de ancho de banda con este ID en tu cuenta (o fue eliminada)
`409`	`AUTOREFILL_IN_PROGRESS`	Se está comprando una recarga para esta regla en este momento — reintenta en un minuto
`422`	—	Un valor está fuera de rango, `duration` no es `"1h"` ni `"1d"`, o `status` no es `"active"` ni `"paused"`

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

Actualizar regla de ancho 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

Alquileres de ancho de banda

Recarga automática

Órdenes

Facturas

Smart Mode

Paquetes de transferencia

Cuenta

Webhooks

Actualizar regla de ancho de banda

Actualizar regla de ancho de banda

Parámetros de ruta

Cuerpo de la solicitud

Respuesta

Ejemplo

Errores

​Actualizar regla de ancho de banda

​Parámetros de ruta

​Cuerpo de la solicitud

​Respuesta

​Ejemplo

​Errores

Actualizar regla de ancho de banda

Parámetros de ruta

Cuerpo de la solicitud

Respuesta

Ejemplo

Errores