Creación de una ruta mediante la interfaz de usuario

Complete los siguientes pasos para crear una ruta utilizando la interfaz de usuario.

1. Conéctese a su cuenta IBM Cloud.

2. Pulse el icono Menú > Observabilidad.

3. Haga clic en Registro > Enrutamiento.

4. En la pestaña Rutas, haga clic en Crear.

5. En la sección Reglas de enrutamiento, modifique la Acción de la Regla 1:

   Seleccione una Acción para la Regla 1:

   • Seleccione Enviar registros desde para que la regla dirija los registros de la plataforma a los objetivos asociados.

   • Seleccione Drop logs from para que la regla elimine los registros de la plataforma que coincidan con esta regla.

   Añada los filtros de inclusión para determinar los registros de plataforma enrutados a los objetivos especificados en la regla.

   • Seleccione una condición y especifique los valores de ubicación que deben coincidir con el filtro de inclusión.

   • Para añadir varios filtros de inclusión, haga clic en Añadir filtro para añadir filtros adicionales.

   Añada los objetivos que desea asociar a la regla seleccionando un objetivo de la lista. Si no tiene ningún objetivo definido, haga clic en Añadir objetivo para crear uno nuevo.

6. Haga clic en Añadir regla para añadir reglas adicionales a la ruta.

   El orden de las reglas de ruta afecta al comportamiento del enrutamiento. Las reglas se procesan en orden y una vez que una regla coincide, las reglas siguientes no se procesan.

   El orden de las reglas de enrutamiento puede modificarse haciendo clic en las flechas arriba y abajo situadas a la derecha de cada definición de regla.

   Si necesita eliminar una regla o filtro, haga clic en el icono Eliminar asociado a la regla o filtro.

   Puede configurar hasta 10 reglas por ruta.

7. Pulse Siguiente.

8. Introduzca un nombre para la ruta.

9. Revise la definición de la ruta asegurándose de que el orden de las reglas es el previsto.

   Para obtener más información, consulte Comprender la precedencia de enrutamiento.

10. Pulse Crear.

Actualizar una ruta mediante la interfaz de usuario

Complete los siguientes pasos para actualizar una ruta utilizando la interfaz de usuario.

1. Conéctese a su cuenta IBM Cloud.

2. Pulse el icono Menú > Observabilidad.

3. Haga clic en Registro > Enrutamiento.

4. En la pestaña Rutas, determine qué ruta desea actualizar y haga clic en el .

5. Haga clic en Renombrar para cambiar el nombre de la ruta.

6. Haga clic en Editar para actualizar las reglas de ruta.

   En Reglas de enrutamiento, modifique la Acción de la regla:

   • Seleccione Send para que la regla dirija los registros de la plataforma a los destinos asociados.

   • Seleccione Drop para que la regla elimine los registros de la plataforma que coincidan con esta regla.

   Añada o modifique los filtros de inclusión para determinar los registros de plataforma enrutados a los objetivos especificados en la regla.

   Seleccione el filtro y la condición deseados y especifique el valor que debe coincidir con el filtro de inclusión.

   Para añadir varios filtros de inclusión, haga clic en Añadir filtro para añadir filtros adicionales.

7. Modifique el objetivo a asociar a la regla seleccionando un objetivo de la lista. Si no tiene ningún objetivo definido, haga clic en Añadir objetivo para crear uno nuevo.

8. Haga clic en Añadir regla para añadir reglas adicionales a la ruta.

   El orden de las reglas de ruta afecta al comportamiento del enrutamiento. Las reglas se procesan en orden y una vez que una regla coincide, las reglas siguientes no se procesan.

   El orden de las reglas de enrutamiento puede modificarse haciendo clic en las flechas arriba y abajo situadas a la derecha de cada definición de regla.

   Si necesita eliminar una regla o filtro, haga clic en el icono Eliminar asociado a la regla o filtro.

   Puede configurar hasta 10 reglas por ruta.

9. Haga clic en Actualizar para realizar cambios en su ruta.

Visualización de una ruta mediante la interfaz de usuario

Realice los siguientes pasos para ver una ruta utilizando la interfaz de usuario.

1. Conéctese a su cuenta IBM Cloud.

2. Pulse el icono Menú > Observabilidad.

3. Haga clic en Registro > Enrutamiento.

4. En la pestaña Rutas, puede ver la lista de rutas configuradas.

   El orden de las rutas no afecta al comportamiento del enrutamiento, ya que se procesan de forma independiente.

   Cada ruta muestra el nombre de la ruta y las reglas.

   La página de rutas también muestra la Guía de enrutamiento con información adicional sobre la configuración del enrutamiento.

Supresión de una ruta mediante la interfaz de usuario

Realice los siguientes pasos para eliminar una ruta utilizando la interfaz de usuario.

1. Conéctese a su cuenta IBM Cloud.

2. Pulse el icono Menú > Observabilidad.

3. Haga clic en Registro > Enrutamiento.

4. En la pestaña Rutas, determine qué ruta desea eliminar y haga clic en el .

5. Haga clic en Eliminar para borrar toda la ruta. Debe introducir el nombre de la ruta antes de borrarla.

Requisitos previos de la CLI

Antes de utilizar la CLI para gestionar rutas, complete los siguientes pasos:

1. Instale la CLI de IBM Cloud.

2. Instale la CLI de IBM Cloud Logs Routing.

3. Inicie sesión en IBM Cloud. Ejecute el siguiente mandato: ibmcloud login

Creación de una ruta con la CLI

Utilice este comando para crear una ruta.

Los nombres de las rutas son únicos en la cuenta.

ibmcloud logs-router route create --name NAME --rules RULES | @RULES-FILE [--output FORMAT] [--force]

ibmcloud logs-router route create --name route3 --rules '[{"action": "send", "targets":[{"id":"0b4e6aa9-257c-4a3a-ae42-9a36a5b3adc7"},{"id":"6f9137b3-2bb9-4724-851b-153e23c82d80"}],"inclusion_filters": [{"operand": "location", "operator": "in", "values": ["us-south","eu-de"]}]}]'

Id           cfa2be32-979d-4e99-a2a2-e68e65e9b8cc
Name         route3
Rules
             action              send
             inclusion_filters
                                 operand    location
                                 operator   in
                                 values     [us-south, eu-de]

             targets
                                 id            0b4e6aa9-257c-4a3a-ae42-9a36a5b3adc7
                                 name          cl-target2
                                 target_type   cloud-logs

                                 id            6f9137b3-2bb9-4724-851b-153e23c82d80
                                 name          cl-platform-logs-sydney-113
                                 target_type   cloud-logs


Created At   2026-04-29T12:59:25.764Z
Updated At   2026-04-29T12:59:25.764Z
Managed By   account

ibmcloud logs-router route create --name route4 --rules '[{"action": "send", "targets":[{"id":"0b4e6aa9-257c-4a3a-ae42-9a36a5b3adc7"},{"id":"6f9137b3-2bb9-4724-851b-153e23c82d80"}],"inclusion_filters": [{"operand": "location", "operator": "in", "values": ["us-south","eu-de"]}]},{"action": "send", "targets":[{"id":"0b4e6aa9-257c-4a3a-ae42-9a36a5b3adc7"},{"id":"6f9137b3-2bb9-4724-851b-153e23c82d80"}],"inclusion_filters": [{"operand": "location", "operator": "is", "values": ["us-east"]}]}]'

Id           6bb85c44-7187-4e45-b850-c912ddd2d0bf
Name         route4
Rules
             action              send
             inclusion_filters
                                 operand    location
                                 operator   in
                                 values     [us-south, eu-de]

             targets
                                 id            0b4e6aa9-257c-4a3a-ae42-9a36a5b3adc7
                                 name          cl-target2
                                 target_type   cloud-logs

                                 id            6f9137b3-2bb9-4724-851b-153e23c82d80
                                 name          cl-platform-logs-sydney-113
                                 target_type   cloud-logs


             action              send
             inclusion_filters
                                 operand    location
                                 operator   is
                                 values     [us-east]

             targets
                                 id            0b4e6aa9-257c-4a3a-ae42-9a36a5b3adc7
                                 name          cl-target2
                                 target_type   cloud-logs

                                 id            6f9137b3-2bb9-4724-851b-153e23c82d80
                                 name          cl-platform-logs-sydney-113
                                 target_type   cloud-logs


Created At   2026-04-29T13:01:11.685Z
Updated At   2026-04-29T13:01:11.685Z
Managed By   account

Actualización de una ruta utilizando la CLI

Utilice este comando para actualizar una ruta. Cualquier valor especificado que sea distinto de cuando se creó originalmente la ruta se actualizará al valor especificado en el mandato.

ibmcloud logs-router route update --id ROUTE [--name NAME] [--rules RULES | @RULES-FILE] [--output FORMAT] [--force]

Id           6bb85c44-7187-4e45-b850-c912ddd2d0bf
Name         my-new-route-name
Rules
             action              send
             inclusion_filters
                                 operand    location
                                 operator   in
                                 values     [us-south, eu-de]

             targets
                                 id            0b4e6aa9-257c-4a3a-ae42-9a36a5b3adc7
                                 name          cl-target2
                                 target_type   cloud-logs

                                 id            6f9137b3-2bb9-4724-851b-153e23c82d80
                                 name          cl-platform-logs-sydney-113
                                 target_type   cloud-logs


             action              send
             inclusion_filters
                                 operand    location
                                 operator   is
                                 values     [us-east]

             targets
                                 id            0b4e6aa9-257c-4a3a-ae42-9a36a5b3adc7
                                 name          cl-target2
                                 target_type   cloud-logs

                                 id            6f9137b3-2bb9-4724-851b-153e23c82d80
                                 name          cl-platform-logs-sydney-113
                                 target_type   cloud-logs


Created At   2026-04-29T13:01:11.685Z
Updated At   2026-04-29T13:07:32.677Z
Managed By   account

Supresión de una ruta mediante la CLI

Utilice este comando para eliminar una ruta.

ibmcloud logs-router route delete --id route [--force]

Are you sure you want to delete? [y/n]> y
OK

Obtener información sobre una ruta utilizando la CLI

Utilice este mandato para obtener información sobre una ruta para una región de IBM Cloud Logs Routing.

ibmcloud logs-router route get --id route [--output FORMAT]

Id           2a4739ee-7cd6-4e05-b60d-9b2e7b0b7981
Name         route2
Rules
             action    send
             targets
                       id            0b4e6aa9-257c-4a3a-ae42-9a36a5b3adc7
                       name          cl-target2
                       target_type   cloud-logs

                       id            6f9137b3-2bb9-4724-851b-153e23c82d80
                       name          cl-platform-logs-sydney-113
                       target_type   cloud-logs


Created At   2026-04-29T12:55:23.106Z
Updated At   2026-04-29T12:55:23.106Z
Managed By   account

Listado de todas las rutas de una región

Utilice este comando para listar las rutas configuradas para una región IBM Cloud Logs Routing.

ibmcloud logs-router route list [--output FORMAT]

Rutas y acciones de la API

En la tabla siguiente se listan las acciones que puede ejecutar para gestionar rutas:

Puede utilizar puntos finales públicos y privados para gestionar rutas. Para obtener más información sobre la lista de ENDPOINTS que están disponibles, consulte Puntos finales.

• Puede gestionar rutas desde la red privada utilizando un punto final de API con el siguiente formato: https://api.private.REGION.logs-router.cloud.ibm.com
• Puede gestionar rutas desde la red pública utilizando un punto final de API con el siguiente formato: https://api.REGION.logs-router.cloud.ibm.com

Puede inhabilitar los puntos finales públicos actualizando los valores de la cuenta. Para más información, consulte Configurar los ajustes de ruta y región.

Para más información sobre la API REST, consulte rutas.

Requisitos previos de la API

Para realizar llamadas de API con el fin de gestionar rutas, realice los pasos siguientes:

1. Obtenga una señal de acceso IAM. Para obtener más información, consulte Recuperación de señales de acceso de IAM.
2. Identifique el punto final de API en la región en la que tiene previsto configurar o gestionar una ruta. Para obtener más información, consulte Puntos finales.

Creación de una ruta mediante la API

Puede utilizar el siguiente mandato cURL para crear una ruta:

Los nombres de las rutas son únicos en la cuenta. No se puede reutilizar un nombre de ruta para configurar varios destinos.

curl -X POST <ENDPOINT>/v3/routes -H "Authorization: $ACCESS_TOKEN" -H "content-type: application/json" -d '{
    "name": "ROUTE_NAME",
    "rules": [
      {
        "action": "send",
        "targets": [
          {
            "id": "50375218-7cff-4234-bbb4-171bebab8408"
          },
          {
            "id": "c7519d8a-5f97-498b-a229-8542f60955cd"
          }
        ],
        "inclusion_filters": [
          {
            "operand": "location",
            "operator": "is",
            "values": ["us-east"]
          }
        ]
      }
    ]
  }'

Donde

<ENDPOINT>

En la región en la que tiene previsto configurar o gestionar una ruta. Para obtener más información, consulte Puntos finales.

ROUTE_NAME

El nombre que se le dará a la ruta.

El nombre que se le dará a la ruta.

La longitud máxima es de 1000 caracteres.

La longitud mínima es de 1 carácter.

El nombre no puede incluir caracteres especiales distintos de espacios en blanco, -, ., _, :.

No incluya información de identificación personal en ningún nombre de recurso.

RULES

Cadena JSON o una ruta a un prefijo de archivo JSON con @ que define cómo se enrutan los registros de la plataforma.

Las reglas se evalúan en el orden en que están configuradas.

La longitud máxima es de 10 reglas.

Para más información, consulte Definición de reglas de enrutamiento.

Por ejemplo, puede utilizar la siguiente solicitud cURL para crear una ruta:

curl -X POST https://api.us-south.logs-router.cloud.ibm.com/v3/routes -H "Authorization: $ACCESS_TOKEN" -H "content-type: application/json" -d '{
    "name": "My-route",
    "rules": [
      {
        "action": "send",
        "targets": [
          {
            "id": "0b4e6aa9-257c-4a3a-ae42-9a36a5b3adc7"
          },
          {
            "id": "6f9137b3-2bb9-4724-851b-153e23c82d80"
          }
        ],
        "inclusion_filters": [
          {
            "operand": "location",
            "operator": "is",
            "values": ["us-east"]
          },
          {
            "operand": "service_name",
            "operator": "in",
            "values": ["codeengine","container-registry"]
          }
        ]
      }
    ]
  }'

La salida tiene el aspecto siguiente:

{"id":"c7673f63-1260-4f86-bc1a-aaedb89391d8","name":"route5","crn":"crn:v1:bluemix:public:logs-router:global:a/xxxxxxx::route:c7673f63-1260-4f86-bc1a-aaedb89391d8","rules":[{"action":"send","targets":[{"id":"0b4e6aa9-257c-4a3a-ae42-9a36a5b3adc7","name":"cl-target2","crn":"crn:v1:bluemix:public:logs-router:eu-gb:a/xxxxxxx::target:0b4e6aa9-257c-4a3a-ae42-9a36a5b3adc7","target_type":"cloud-logs"},{"id":"6f9137b3-2bb9-4724-851b-153e23c82d80","name":"cl-platform-logs-sydney-113","crn":"crn:v1:bluemix:public:logs-router:eu-gb:a/xxxxxxx::target:6f9137b3-2bb9-4724-851b-153e23c82d80","target_type":"cloud-logs"}],"inclusion_filters":[{"operand":"location","operator":"is","values":["us-east"]}]}],"managed_by":"account","created_at":"2026-04-29T13:26:34.237Z","updated_at":"2026-04-29T13:26:34.237Z"}

Actualización de una ruta utilizando la API

Puede modificar el nombre de una ruta y de las reglas. Cualquier valor especificado que sea diferente de cuando se creó originalmente la ruta se actualizará al valor especificado en la solicitud.

Al actualizar una ruta, debe incluir la información de ruta en la sección de datos de la solicitud.

• Debe pasar todos los campos.
• Actualice los campos que deben cambiarse.

Los nombres de las rutas son únicos en la cuenta. No se puede reutilizar un nombre de ruta para configurar varios destinos.

Puede utilizar el mandato cURL siguiente para actualizar una ruta:

curl -X PATCH <ENDPOINT>/v3/routes/ROUTE_ID -H "Authorization: $ACCESS_TOKEN" -H "content-type: application/json" -d '{
    "name": "ROUTE_NAME",
    "rules": [
      {
        "action": "send",
        "targets": [
          {
            "id": "d3ebcda8-953d-45ea-a4a7-b47f8c4a9742"
          }
        ],
        "inclusion_filters": [
          {
            "operand": "location",
            "operator": "is",
            "values": ["eu-de"]
          }
        ]
      }
    ]
  }'

Donde

<ENDPOINT>

En la región en la que tiene previsto configurar o gestionar una ruta. Para obtener más información, consulte Puntos finales.

ROUTE_ID

ID de la ruta.

ROUTE_NAME

El nombre que se le dará a la ruta.

El nombre que se le dará a la ruta.

La longitud máxima es de 1000 caracteres.

La longitud mínima es de 1 carácter.

El nombre no puede incluir caracteres especiales distintos de espacios en blanco, -, ., _, :.

No incluya información de identificación personal en ningún nombre de recurso.

RULES

Cadena JSON o una ruta a un prefijo de archivo JSON con @ que define cómo se enrutan los registros de la plataforma.

Las reglas se evalúan en el orden en que están configuradas.

La longitud máxima es de 10 reglas.

Para más información, consulte Definición de reglas de enrutamiento.

Por ejemplo, puede utilizar la siguiente solicitud cURL para crear una ruta en Dallas:

curl -X PATCH https://api.us-south.logs-router.cloud.ibm.com/v3/routes/c7673f63-1260-4f86-bc1a-aaedb89391d8 -H "Authorization: $ACCESS_TOKEN" -H "content-type: application/json" -d '{
    "name": "My new route name",
    "rules": [
      {
        "action": "send",
        "targets": [
          {
            "id": "0b4e6aa9-257c-4a3a-ae42-9a36a5b3adc7"
          },
          {
            "id": "6f9137b3-2bb9-4724-851b-153e23c82d80"
          }
        ],
        "inclusion_filters": [
          {
            "operand": "location",
            "operator": "is",
            "values": ["us-east"]
          }
        ]
      }
    ]
    }
  }'

Supresión de una ruta mediante la API

Puede utilizar el mandato de cURL siguiente para suprimir una ruta:

curl -X DELETE <ENDPOINT>/v3/routes/<route_ID> -H "Authorization: $ACCESS_TOKEN" -H "content-type: application/json"

Donde

<ENDPOINT>

En la región en la que tiene previsto configurar o gestionar una ruta. Para obtener más información, consulte Puntos finales.

<route_ID>

ID de la ruta.

Por ejemplo, puede utilizar la siguiente solicitud cURL para eliminar una ruta con el ID c7673f63-1260-4f86-bc1a-aaedb89391d8:

curl -X DELETE https://api.us-south.logs-router.cloud.ibm.com/v3/routes/c7673f63-1260-4f86-bc1a-aaedb89391d8 -H "Authorization: $ACCESS_TOKEN" -H "content-type: application/json"

Visualización de una ruta utilizando la API

Puede utilizar el siguiente comando cURL para ver los detalles de configuración de 1 ruta:

curl -X GET <ENDPOINT>/v3/routes/<route_ID> -H "Authorization: $ACCESS_TOKEN" -H "content-type: application/json"

Donde

<ENDPOINT>

En la región en la que tiene previsto configurar o gestionar una ruta. Para obtener más información, consulte Puntos finales.

<route_ID>

ID de la ruta.

Por ejemplo, puede ejecutar la siguiente solicitud cURL para obtener información sobre una ruta con el ID 00000000-0000-0000-0000-000000000000:

curl -X GET https://api.us-south.logs-router.cloud.ibm.com/v3/routes/c7673f63-1260-4f86-bc1a-aaedb89391d8 -H "Authorization: $ACCESS_TOKEN" -H "content-type: application/json"

Listado de todas las rutas que utilizan la API

Puede utilizar el mandato de cURL siguiente para ver todas las rutas:

curl -X GET <ENDPOINT>/v3/routes -H "Authorization: $ACCESS_TOKEN" -H "content-type: application/json"

Donde

• <ENDPOINT> es el punto final de la API en la región donde tiene previsto configurar o gestionar una ruta. Para obtener más información, consulte Puntos finales.

Por ejemplo, puede ejecutar la siguiente petición cURL para obtener información sobre las rutas definidas en Dallas:

curl -X GET https://api.us-south.logs-router.cloud.ibm.com/v3/routes -H "Authorization: $ACCESS_TOKEN" -H "content-type: application/json"

Códigos de respuesta de HTTP

Cuando se utiliza la API REST de IBM Cloud Logs Routing, es posible obtener códigos de respuesta HTTP estándar para indicar si un método se ha completado satisfactoriamente.

• Una respuesta de 200 siempre indica éxito.
• Una respuesta 4xx indica una anomalía.
• Una respuesta 5xx indica un error interno del sistema.

Consulte la tabla siguiente para ver algunos códigos de respuesta HTTP: