Validar solicitação OData
APLICA-SE A: todas as camadas do Gerenciamento de API
A política validate-odata-request valida a URL de solicitação, os cabeçalhos e os parâmetros de uma solicitação a uma API OData para garantir a conformidade com a especificação OData.
Declaração de política
<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" />
Atributos
| Atributo | Descrição | Obrigatório | Padrão |
|---|---|---|---|
| error-variable-name | Nome da variável em context.Variables para o qual registrar erros de validação. |
Não | N/D |
| default-odata-version | A versão padrão do OData assumida para validação de parâmetro se a solicitação não contiver um cabeçalho OData-Version. |
Não | 4,0 |
| min-odata-version | A versão mínima do OData no cabeçalho OData-Version da solicitação que a política aceita. |
No | N/D |
| max-odata-version | A versão máxima de OData no cabeçalho OData-Version da solicitação que a política aceita. |
No | N/D |
| max-size | Tamanho máximo da carga da solicitação em bytes. | No | N/D |
Uso
- Seções de política: entrada
- Escopos de política: global, workspace, produto, API
- Gateways: clássico, v2, consumo, auto-hospedado, workspace
Observações de uso
- Configure a política para uma API OData que foi importada para o Gerenciamento de API.
- Essa política só pode ser usada uma vez em uma seção de política.
Exemplo
O exemplo a seguir valida uma solicitação para uma API OData e assume uma versão OData padrão de 4.01 se nenhum cabeçalho OData-Version estiver presente:
<validate-odata-request default-odata-version="4.01" />
Políticas relacionadas
Conteúdo relacionado
Para obter mais informações sobre como trabalhar com políticas, consulte:
- Tutorial: Transformar e proteger sua API
- Referência de Política para uma lista completa das instruções de política e suas configurações
- Expressões de política
- Definir ou editar políticas
- Reutilizar configurações de política
- Repositório de snippets de política
- Kit de ferramentas de políticas do Gerenciamento de API do Azure
- Criar políticas usando o Microsoft Copilot no Azure