Información sobre la creación de plantillas de ruta

En API Gateway, es posible enrutar las solicitudes entrantes en función de las plantillas de ruta. Las plantillas de ruta tienen tres componentes principales:

• Concordancia exacta
• Coincidencia con un solo comodín
• Coincidencia con doble comodín

En las siguientes secciones se describe cada uno de estos componentes y cómo funcionan en el contexto de API Gateway.

Concordancia exacta

Una ruta con plantilla sin segmentos de comodín único o doble (* o **) se convierte en una coincidencia de ruta exacta. Por ejemplo, la especificación de OpenAPI de la configuración de la API de tu pasarela puede contener una sección como la siguiente:

...
paths:
  /shelves:
    get:
      summary: List shelves
...

En este ejemplo, la pasarela solo aceptará solicitudes a /shelves y a ninguna otra ruta.

Coincidencia con un solo comodín

Si una ruta con plantilla contiene una variable, un segmento comodín singular ({var}) o, solo en OpenAPI 2.0, un segmento comodín singular ({var=*}), la pasarela permitirá las solicitudes entrantes que cumplan lo siguiente:

• Las solicitudes no contienen una barra inclinada adicional (/), lo que significa que la variable solo coincidirá con un segmento de ruta.
• Las solicitudes contienen al menos un carácter.
• Las solicitudes pueden contener una barra inclinada adicional al final de la ruta.

Por ejemplo, la especificación de OpenAPI de la configuración de la API de tu pasarela puede contener una sección como la siguiente:

...
paths:
  /shelves/{shelf}/books/{book}:
    get:
      summary: Retrieve a book
...

En este ejemplo, la pasarela aceptará las solicitudes que coincidan con la siguiente expresión regular:

^/shelves/[^/]+/books/[^/]+/?$

Coincidencia con doble comodín

Si una ruta con plantilla contiene una variable denotada por un segmento de comodín doble (por ejemplo, {var=**}), la pasarela permitirá las solicitudes entrantes que cumplan lo siguiente:

• Las solicitudes pueden contener todos los caracteres, incluidas las barras diagonales (/).
• Las solicitudes pueden contener 0 o más caracteres.
• Las solicitudes pueden contener una barra inclinada adicional al final de la ruta.