Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
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 |
Important
El acceso vinculado no se comprueba cuando se referencia un fragmento de política usando fragment-id. Un usuario que tenga permiso para escribir una política puede referenciar cualquier fragmento de política disponible y hacer que la Administración de la API ejecute sus declaraciones de política, incluso si el usuario no tiene acceso de lectura al recurso fragmento de política. Esto no otorga acceso para ver o modificar la definición del fragmento de política.
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
- repositorio de ejemplos Policy
- Kit de herramientas de directivas de Azure API Management
- Obtener ayuda de Copilot para crear, explicar y solucionar problemas de directivas