Definir variável
APLICA-SE A: Todas as camadas de gerenciamento de API
A set-variable política declara uma variável de contexto e atribui-lhe um valor especificado por meio de uma expressão ou um literal de cadeia de caracteres. Se a expressão contiver um literal, ela será convertida em uma cadeia de caracteres e o tipo do valor será System.String.
Nota
Defina os elementos da política e os elementos filho na ordem fornecida na declaração de política. Saiba mais sobre como definir ou editar políticas de Gerenciamento de API.
Declaração de política
<set-variable name="variable name" value="Expression | String literal" />
Atributos
| Atributo | Description | Obrigatório |
|---|---|---|
| nome | O nome da variável. Expressões de política não são permitidas. | Sim |
| valor | O valor da variável. Pode ser uma expressão ou um valor literal. São permitidas expressões de política. | Sim |
Utilização
- Seções de política: entrada, saída, back-end, no erro
- Âmbitos de política: global, área de trabalho, produto, API, operação
- Gateways: clássico, v2, consumo, auto-hospedado, espaço de trabalho
Tipos permitidos
As expressões usadas na set-variable política devem retornar um dos seguintes tipos básicos.
- System.Boolean
- System.SByte
- System.Byte
- Sistema.UInt16
- Sistema.UInt32
- System.UInt64
- Sistema.Int16
- Sistema.Int32
- Sistema.Int64
- System.Decimal
- Sistema.Single
- Sistema.Duplo
- System.Guid
- System.String
- System.Char
- System.DateTime
- System.TimeSpan
- System.Byte?
- System.UInt16?
- System.UInt32?
- System.UInt64?
- System.Int16?
- System.Int32?
- System.Int64?
- System.Decimal?
- System.Single?
- System.Double?
- System.Guid?
- System.String?
- System.Char?
- System.DateTime?
Exemplo
O exemplo a seguir demonstra uma set-variable política na seção de entrada. Essa política de variável definida cria uma isMobile variável de contexto booleana que é definida como true se o cabeçalho da User-Agent solicitação contiver o texto iPad ou iPhone.
<set-variable name="IsMobile" value="@(context.Request.Headers.GetValueOrDefault("User-Agent","").Contains("iPad") || context.Request.Headers.GetValueOrDefault("User-Agent","").Contains("iPhone"))" />
Políticas relacionadas
Conteúdos relacionados
Para obter mais informações sobre como trabalhar com políticas, consulte:
- Tutorial: Transforme e proteja sua API
- Referência de política para uma lista completa de declarações de política e suas configurações
- Expressões de política
- Definir ou editar políticas
- Reutilizar configurações de política
- Recompra de trechos de política
- Kit de ferramentas de política de Gerenciamento de API do Azure
- Criar políticas usando o Microsoft Copilot no Azure