> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tronrental.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Bant Genişliği Kuralını Güncelle

> Bir bant genişliği Otomatik Dolum kuralını değiştirin, duraklatın veya devam ettirin

## Bant Genişliği Kuralını Güncelle

Bir kuralın eşiğini, miktarını, süresini veya etiketini değiştirir ya da kuralı duraklatır ve devam ettirir. Yalnızca değiştirmek istediğiniz alanları gönderin; diğerleri olduğu gibi kalır. Değişiklikler bir sonraki kontrolden itibaren geçerli olur. `buy_bandwidth` kapsamını gerektirir.

Bir kuralın adresi değiştirilemez. Bir kuralı başka bir adrese taşımak için onu silin ve yeni bir kural oluşturun.

### Yol parametreleri

**rule\_id** `number` *required*

Kural kimliği — Bant Genişliği Kuralı Oluştur veya Bant Genişliği Kurallarını Listele yanıtındaki `id`

### İstek gövdesi

**threshold\_bandwidth** `number`

Yeni eşik. 1 ile 1.000.000 arasında.

**add\_volume** `number`

Dolum başına yeni bant genişliği miktarı. 350 ile 100.000 arasında.

**duration** `string`

Sonraki dolumlar için yeni kiralama süresi: `"1h"` veya `"1d"`. Zaten satın alınmış kiralamalar kendi sürelerini korur.

**label** `string`

Yeni etiket, en fazla 100 karakter. Boş bir dize etiketi kaldırır.

**status** `string`

Kuralı duraklatmak için `"paused"`, devam ettirmek için `"active"`. Devam ettirmek ayrıca `stopped_reason` alanını temizler ve `consecutive_failures` değerini 0'a sıfırlar. Bakiye nedeniyle durdurulmuş bir kural para yatırıldıktan sonra kendiliğinden devam eder, bu yüzden bunu sizin yapmanız gerekmez; bakiye hâlâ yetersizken devam ettirirseniz kural bir sonraki kontrolde yeniden durur. `stopped_insufficient_balance` doğrudan ayarlanamaz.

### Yanıt

Güncellenmiş kural; alanları [Bant Genişliği Kurallarını Listele](/tr/api-reference/auto-refill/list-bandwidth-rules) ile aynıdır.

### Örnek

```bash cURL theme={null}
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"}'
```

```python Python theme={null}
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())
```

```javascript JavaScript theme={null}
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());
```

```json Response theme={null}
{
  "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
}
```

### Hatalar

| Durum | Kod | Ne zaman |
| - | - | - |
| `403` | `FORBIDDEN` | API anahtarında `buy_bandwidth` kapsamı yok |
| `404` | `NOT_FOUND` | Hesabınızda bu kimliğe sahip bir bant genişliği kuralı yok (veya kural silinmiş) |
| `409` | `AUTOREFILL_IN_PROGRESS` | Bu kural için şu anda bir dolum satın alınıyor — bir dakika sonra yeniden deneyin |
| `422` | — | Bir değer aralık dışında, `duration` değeri `"1h"` veya `"1d"` değil ya da `status` değeri `"active"` veya `"paused"` değil |

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


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.