Definir variável
APLICA-SE A: todas as camadas do Gerenciamento de API
A política set-variable declara uma variável de set-variable e atribui a ela um valor especificado por meio de uma expressão ou literal de cadeia de caracteres. Se a expressão contiver um literal ele será convertido em uma cadeia de caracteres e o tipo do valor será System.String.
Observação
Defina os elementos da política e os elementos filho na ordem fornecida na declaração da política. Saiba mais sobre como definir e editar as políticas de Gerenciamento de API.
Declaração de política
<set-variable name="variable name" value="Expression | String literal" />
Atributos
| Atributo | Descrição | Obrigatório |
|---|---|---|
| name | O nome da variável. Expressões de política não são permitidas. | Sim |
| valor | O valor da variável. Isso pode ser uma expressão ou um valor literal. Expressões de política são permitidas. | Sim |
Uso
- Seções da política: entrada, saída, back-end, em caso de erro
- Escopos de política: global, espaço de trabalho, produto, API, operação
- Gateways: clássico, v2, consumo, auto-hospedado, workspace
Tipos permitidos
As expressões usadas na política set-variable devem retornar um dos seguintes tipos básicos.
- System.Boolean
- System.SByte
- 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
- 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 política set-variable na seção de entrada. Esta política de variável de conjunto cria uma variável de contextoisMobile booliano, que é definida como true se o cabeçalho de solicitação User-Agent 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ú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