Convalidare la richiesta GraphQL
SI APPLICA A: Tutti i livelli di Gestione API
I criteri validate-odata-request convalidano l'URL della richiesta, le intestazioni e i parametri di una richiesta a un'API OData per garantire la conformità alla specifica OData.
Istruzione del criterio
<validate-odata-request error-variable-name="variable name" default-odata-version="OData version number" min-odata-version="OData version number" max-odata-version="OData version number" max-size="size in bytes" />
Attributi
| Attributo | Descrizione | Richiesto | Valore predefinito |
|---|---|---|---|
| error-variable-name | Nome della variabile in context.Variables per registrare gli errori di convalida. |
No | N/D |
| default-odata-version | Versione OData predefinita che si presuppone per la convalida dei parametri se la richiesta non contiene un'intestazione OData-Version. |
No | 4.0 |
| min-odata-version | Versione minima di OData nell'intestazione OData-Version della richiesta accettata dai criteri. |
No | N/D |
| max-odata-version | Versione massima di OData nell'intestazione OData-Version della richiesta accettata dai criteri. |
No | N/D |
| max_size | Dimensioni massime del payload della richiesta in byte. | No | N/D |
Utilizzo
- Sezioni del criterio: inbound
- Ambiti dei criteri: globale, area di lavoro, prodotto, API
- Gateway: classico, v2, consumo, self-hosted, area di lavoro
Note sull'utilizzo
- Configurare i criteri per un'API OData importata in Gestione API.
- Questo criterio può essere usato una sola volta in una sezione di criteri.
Esempio
Nell'esempio seguente viene convalidata una richiesta a un'API OData e si presuppone una versione OData predefinita 4.01 se non è presente alcuna intestazione OData-Version:
<validate-odata-request default-odata-version="4.01" />
Criteri correlati
Contenuto correlato
Per ulteriori informazioni sull'utilizzo dei criteri, vedere:
- Esercitazione: trasformare e proteggere l'API
- Informazioni di riferimento sui criteri per un elenco completo delle istruzioni dei criteri e delle relative impostazioni
- Espressioni di criteri
- Impostare o modificare criteri
- Riutilizzare le configurazioni dei criteri
- Repository dei frammenti di criteri
- Toolkit dei criteri di Azure Gestione API
- Creare criteri usando Microsoft Copilot in Azure