> For the complete documentation index, see [llms.txt](https://docs.devolutions.net/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.devolutions.net/powershell-universal/it/api/rate-limiting.md).

# Limitazione della frequenza

{% hint style="info" %}
La limitazione della frequenza richiede una [licenza](https://store.devolutions.net/package#psu).
{% endhint %}

PowerShell Universal consente di limitare la frequenza delle richieste effettuate al server web. È possibile configurare la limitazione della frequenza per endpoint e per periodo. Per impostazione predefinita, l'indirizzo IP del client limita la frequenza dei client.

I dati di configurazione dei limiti di frequenza sono memorizzati nel file `ratelimits.ps1`.

## Configurazione della limitazione della frequenza

Per configurare la limitazione della frequenza, visiti la pagina API / Limitazione della frequenza. Faccia clic sul pulsante Aggiungi e definisca una nuova regola di limitazione della frequenza.

{% hint style="warning" %}
La limitazione della frequenza interessa tutti gli URL del server. Se applica una limitazione della frequenza non configurata correttamente, può influire negativamente sull'API di gestione.
{% endhint %}

### Metodo

Il metodo è il metodo HTTP per questa regola. Se utilizza `*` , questa regola interessa tutti i metodi HTTP. È anche possibile selezionare un singolo metodo scegliendolo dal menu a discesa.

### Endpoint

L'endpoint è l'URL di cui sta limitando la frequenza. È possibile limitare la frequenza di tutti gli URL utilizzando `*`. È possibile definire URL specifici definendo il percorso relativo: `/api/user`.

### Limite

Questo è il numero di richieste nell'intervallo di tempo prima che entri in funzione la limitazione della frequenza.

### Periodo

Questo è il periodo su cui viene conteggiato il limite di frequenza. Ad esempio, se seleziona un periodo di 10 minuti e un limite di 100, è possibile effettuare fino a 100 richieste al metodo e all'endpoint selezionati.

## Elenchi di autorizzazione

Per disabilitare la limitazione della frequenza per determinati indirizzi IP, client ed endpoint, li aggiunga agli elenchi di autorizzazione della limitazione della frequenza. Li trova facendo clic sul pulsante delle impostazioni.

L'esempio seguente impedisce che l'adattatore di loopback sia soggetto a limitazione della frequenza.

```powershell
Set-PSUSetting -RateLimitIpAddressAllowList @("127.0.0.1")
```

## Esempio: limitare un'API personalizzata

Limita i chiamanti dell'endpoint `/api/users` a 100 richieste al minuto.

```powershell
New-PSURateLimit -Endpoint "GET|/api/users" -TimeSpan "00:01:00" -Limit 100
```

## Esempio: limitare l'API di gestione

Limita i chiamanti dell'API di gestione a 100 richieste al secondo.

```powershell
New-PSURateLimit -Endpoint "*|/api/v1/*" -TimeSpan "00:00:01" -Limit 100
```

## API

* [New-PSURateLimit](/powershell-universal/it/comandi-powershell/new-psuratelimit.md)
* [Set-PSUSetting](/powershell-universal/it/comandi-powershell/set-psusetting.md)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://docs.devolutions.net/powershell-universal/it/api/rate-limiting.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.