Incluir fragmento
SE APLICA A: todos los niveles de API Management
La include-fragment directiva inserta el contenido de un fragmento de directiva creado anteriormente en la definición de directiva. Un fragmento de directiva es un fragmento de directiva XML reutilizable y administrado centralmente que se puede incluir en las definiciones de directiva de la instancia de API Management.
La directiva inserta el fragmento de directiva tal y como está en la ubicación que seleccione en la definición de directiva.
Nota
Establezca los elementos de la directiva y los elementos secundarios en el orden proporcionado en la instrucción de directiva. Obtenga más información sobre el establecimiento o modificación de directivas de API Management.
Instrucción de la directiva
<include-fragment fragment-id="fragment" />
Atributos
| Atributo | Descripción | Necesario | Valor predeterminado |
|---|---|---|---|
| fragment-id | Una cadena. Especifica el identificador (nombre) de un fragmento de directiva creado en la instancia de API Management. No se permiten expresiones de directiva. | Sí | N/D |
Uso
- Secciones de directiva: entrante, saliente, back-end, on-error
- Ámbitos de la directiva: global, área de trabajo, producto, API, operación
- Puertas de enlace: clásica, v2, consumo, autohospedada y área de trabajo
Ejemplo
En el ejemplo siguiente, el fragmento de directiva denominado myFragment se agrega en la sección de entrada de una definición de directiva.
<inbound>
<include-fragment fragment-id="myFragment" />
<base />
</inbound>
[...]
Directivas relacionadas
Contenido relacionado
Para más información sobre el trabajo con directivas, vea:
- Tutorial: Transformación y protección de una API
- Referencia de directivas para una lista completa de instrucciones de directivas y su configuración
- Expresiones de directiva
- Establecimiento o edición de directivas
- Reutilización de configuraciones de directivas
- Repositorio de fragmentos de código de directiva
- Kit de herramientas de directivas de Azure API Management
- Creación de directivas mediante Microsoft Copilot en Azure