# Przegląd

#### Mechanizmy ograniczania przepustowości (throttling) są powszechnie stosowane przez dostawców usług chmurowych w celu zapobiegania przeciążeniom API. W kontekście ochrony danych, throttling może prowadzić do przerywania zadań lub znacznego wydłużenia czasu ich trwania.

***

## Mechanizm zapobiegania throttlingowi <a href="#preparing_personal_access_token" id="preparing_personal_access_token"></a>

**Xopero ONE** implementuje system zarządzania poświadczeniami, który optymalizuje wykorzystanie limitów API poprzez rozkładanie zapytań na wiele kont lub tokenów dostępowych. Proces ten odbywa się automatycznie na dwóch poziomach.

### <mark style="background-color:blue;">Rotacja poświadczeń</mark>

Każde zadanie (backup lub przywracanie) uruchamiane w systemie otrzymuje poświadczenia z dostępnej puli. System stosuje zasadę rotacji, co oznacza, że kolejne zadania wykorzystują różne dane uwierzytelniające (np. **Zadanie A** korzysta z poświadczeń **a**, **Zadanie B** z poświadczeń **b** itd.). Dzięki temu limity API są wykorzystywane równomiernie, co znacząco zmniejsza prawdopodobieństwo wystąpienia blokad.

### <mark style="background-color:blue;">Dynamiczna wymiana poświadczeń</mark>

W przypadku wystąpienia throttlingu podczas trwania zadania, usługa **Xopero ONE Management Service** (**XMS**) podejmuje następujące kroki:

* **Dostępne dodatkowe poświadczenia** — jeśli w puli dostępne są inne poświadczenia, **XMS** przesyła nowe dane do agenta. Zadanie jest kontynuowane bez przerywania operacji.
* **Brak dodatkowych poświadczeń** — jeśli pula poświadczeń zostanie wyczerpana, **XMS** informuje agenta o braku dostępnych poświadczeń. Zadanie zostaje wtedy wstrzymane i oznaczone statusem **Throttled, czekając na odblokowanie limitów**.

{% hint style="success" %}
W podsumowaniu zadania w panelu **Xopero ONE** możesz sprawdzić listę wszystkich poświadczeń użytych do wykonania operacji oraz zweryfikować konkretne przedziały czasowe, w których wystąpił throttling.
{% endhint %}

***

## Ważne wymagania dotyczące przywracania

Aby mechanizm wymiany poświadczeń działał poprawnie podczas operacji, muszą zostać spełnione określone wymagania dotyczące uprawnień:

* [x] **Dostęp do lokalizacji** — dodatkowe poświadczenia muszą posiadać uprawnienia do zapisu w docelowej lokalizacji przywracania.
* [x] **Przywracanie do organizacji** — w przypadku platform takich jak **GitHub**, **GitLab** czy **Bitbucket**, dodatkowe poświadczenia działają tylko wtedy, gdy dane są przywracane do organizacji, do której te konta mają dostęp.
* [x] **Przywracanie na konto użytkownika** — jeśli przywracasz dane bezpośrednio na konto konkretnego użytkownika (zamiast do organizacji), dodatkowe poświadczenia zostaną zignorowane. Wynika to z polityki bezpieczeństwa — inni użytkownicy zazwyczaj nie mogą tworzyć zasobów w ramach osobistego profilu innego użytkownika.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://helpcenter.xopero.com/xopero-one-en/pl/zarzadzanie-ryzykiem-i-zgodnoscia/zapobieganie-ograniczeniom-zadan/przeglad.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.