set-variable

Editar en línea

Utilice la política set-variable para establecer el valor de una variable de tiempo de ejecución o para añadir o borrar una variable de tiempo de ejecución.

Soporte de pasarela

Tabla 1. Tabla que muestra qué puertas de enlace admiten esta política y la versión correspondiente de la misma
Pasarela	Versión de política
DataPower® Gateway (v5 compatible)	1.0.0
DataPower API Gateway	2.0.0

En este tema se describe cómo configurar la política en la fuente « OpenAPI »; para obtener más información sobre cómo configurar la política en la interfaz de usuario del ensamblado, consulte «Establecer variable ».

Acerca de

La política set-variable tiene el formato siguiente:

- set-variable:
  version: version
  title: title
  description: description
  actions:
    - action_type: variable_name
      value: value
      type: data_type

Propiedades

Tabla 2. Propiedades de la política de variables de conjunto
Propiedad	Obligatorio	Descripción	Tipo de datos
version	Sí	El número de versión de la política	serie
title	Nee	Título de la política.	serie
description	Nee	Una descripción de la política.	serie
actions	Sí	Lista las acciones que debe realizar la política set-variable .	matriz
set	Sí¹	Para establecer una variable. Especifica el nombre de la variable que desea establecer. ¹ Se necesita una de las propiedades set, add o clear.	serie
add	Sí²	Para añadir una variable. Especifica el nombre de la variable que desea añadir. ² Se necesita una de las propiedades set, add o clear.	serie
clear	Sí³	Para borrar una variable. Especifica el nombre de la variable que desea borrar. ³ Se necesita una de las propiedades set, add o clear.	serie
value	Sí⁴	Asigna este valor a la variable especificada. Puede tratarse de un valor literal u otra variable. ⁴ value sólo es necesario cuando se especifica `set` o `add` como acción.	serie
type	Sí	Especifica el tipo de datos de la variable. Valores válidos: `any` `string` `number` `boolean` Para todos los valores distintos de `any`, el valor se valida con respecto al tipo de datos especificado. Si el tipo de datos se especifica como `boolean`, la propiedad value debe establecerse en `true` o `false`.	serie

Ejemplo 1

# clear a variable

set-variable:
  version: 1.0.0
  title: clear_region
  actions:
    - clear: message.headers.region

Ejemplo 2

# set a variable to the value of an API Gateway context variable

set-variable:
  version: 2.0.0
  title: set content type
  actions:
    - set: message.headers.contenttype
      value: $(message.headers.content-type)
      type: string

Ejemplo 3

# add a variable

assembly:
    execute:
      - set-variable:
          version: 2.0.0
          title: set-variable
          actions:
            - value: testing add
              add: message.headers.jja
              type: string