Requisitos previos de la CLI

Antes de utilizar la CLI para gestionar destinos, lleve a cabo los pasos siguientes:

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 un destino IBM Cloud Logs mediante la CLI

Utilice este comando para crear un destino IBM Cloud Logs:

 ibmcloud logs-router target create --name TARGET_NAME  --destination-crn CLOUD_LOGS_TARGET_CRN [--region REGION] [--managed-by MANAGED-BY] [--output FORMAT]

Donde

--region REGION | -r REGION

Nombre de la región, por ejemplo, us-south o eu-gb. Si no se especifica, se utilizará la región en la que se ha iniciado sesión o la de destino.

Incluya este campo si desea crear un objetivo en una región diferente a la que está conectado.

La longitud máxima es de 1000 caracteres. La longitud mínima es de 3 caracteres.

--name TARGET_NAME

El nombre que debe darse al destino.

El nombre debe tener 1000 caracteres o menos, y no puede incluir ningún carácter especial que no sea (espacio), -, ., _, :.

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

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

--destination-crn CLOUD_LOGS_TARGET_CRN

El CRN de la instancia de IBM Cloud Logs.

La longitud máxima es de 1000 caracteres. La longitud mínima es de 3 caracteres.

--managed-by MANAGED-BY

Identifica quién gestiona este objetivo.

Si se establece en enterprise, el objetivo se convierte en gestionado por la empresa y sólo puede ser modificado por identidades autorizadas para las acciones de la empresa.

Si se omite o se establece en account, el objetivo es gestionado por la cuenta secundaria.

Este valor es inmutable después de la creación.

Los valores válidos son: enterprise, account.

--output FORMAT

El formato soportado actualmente es JSON. Si se especifica, la salida se devolverá en formato JSON. Si no se ha especificado JSON, la salida se devolverá en un formato tabular.

help | --help | -h

Listar las opciones disponibles para el mandato.

Id                6f9137b3-2bb9-4724-851b-153e23c82d80
Name              my-target
Destination Crn   crn:v1:bluemix:public:logs:au-syd:a/xxxxxxxxxx:619801ea-7cd8-4792-80cf-49a8359b4357::
Target Type       cloud_logs
Region            eu-gb
Write Status
                  status   success

Created At        2026-04-28T21:33:18.632Z
Updated At        2026-04-28T21:33:18.632Z
Managed By        account

Actualización de un destino IBM Cloud Logs mediante la CLI

Utilice este comando para actualizar un destino IBM Cloud Logs para una región IBM Cloud Logs Routing.

Cualquier valor especificado que sea distinto de cuando se creó originalmente el destino se actualizará al valor especificado en el mandato.

ibmcloud logs-router target update --id TARGET [--name TARGET_NAME] --destination-crn CLOUD_LOGS_TARGET_CRN]]] [--output FORMAT]

donde

--id TARGET

El UUID 4 que identifica de forma única el objetivo.

La longitud máxima es de 1028 caracteres. La longitud mínima es de 24 caracteres.

--name TARGET_NAME

El nombre que debe darse al destino.

El nombre debe tener 1000 caracteres o menos, y no puede incluir ningún carácter especial que no sea (espacio), -, ., _, :'.

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

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

--destination-crn CLOUD_LOGS_TARGET_CRN

El CRN de la instancia de IBM Cloud Logs.

--output FORMAT

El formato soportado actualmente es JSON. Si se especifica, la salida se devolverá en formato JSON. Si no se ha especificado JSON, la salida se devolverá en un formato tabular.

help | --help | -h

Listar las opciones disponibles para el mandato.

Id                6f9137b3-2bb9-4724-851b-153e23c82d80
Name              cl-platform-logs-sydney-113
Destination Crn   crn:v1:bluemix:public:logs:au-syd:a/xxxxxxxxxx:619801ea-7cd8-4792-80cf-49a8359b4357::
Target Type       cloud_logs
Region            eu-gb
Write Status
                  status   success

Created At        2026-04-28T21:33:18.632Z
Updated At        2026-04-28T21:35:22.184Z
Managed By        account

Supresión de un destino utilizando la CLI

Utilice este mandato para suprimir un destino.

ibmcloud logs-router target delete --id TARGET [--force]

donde

--id TARGET

El UUID 4 que identifica de forma única el objetivo.

La longitud máxima es de 1028 caracteres. La longitud mínima es de 24 caracteres.

--force | -f

Suprimirá el destino sin proporcionar al usuario ningún mensaje adicional.

help | --help | -h

Listar las opciones disponibles para el mandato.

Are you sure you want to remove the target with target ID xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx? [y/N]>y
OK
Target with target ID xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx was successfully removed.

Are you sure you want to remove the Target bearing Target ID 33333333-3333-3333-3333-333333333333? [y/N]> y
FAILED
Something went wrong. Error:
 Status Code:  404
 Incident ID:  67a33257-d5a4-46ec-94d9-14eb70e94f3d
 Code:         not_found
 Message:      The target id specified in `target_id` field is not found.

Validación y visualización de los detalles de un objetivo mediante la CLI

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

ibmcloud logs-router target get --id TARGET [--output FORMAT]

Donde

--id TARGET

El UUID 4 que identifica de forma única el objetivo.

La longitud máxima es de 1028 caracteres. La longitud mínima es de 24 caracteres.

--output FORMAT

El formato soportado actualmente es JSON. Si se especifica, la salida se devolverá en formato JSON. Si no se ha especificado JSON, la salida se devolverá en un formato tabular.

help | --help | -h

Listar las opciones disponibles para el mandato.

La respuesta incluye información sobre el estado del objetivo en el objeto de respuesta write_status. Este objeto incluye la siguiente información:

• Write Status información. Los valores válidos son: success o failed.
• Last Failure información de fecha-hora de la marca de tiempo del último fallo.
• Reason for last failure información con una descripción detallada de la causa del fallo.

Target
Name:                       new-target-name
ID:                         xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
CRN:                        crn:v1:bluemix:public:atracker:us-south:a/xxxxxxxxxx
Type:                       cloud_logs
Cloud Logs Target CRN:      crn:v1:bluemix:public:logs:global:a/xxxxxxxxxx:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxx:
Service to Service Enabled: true
Write Status:               success
Created:                    2024-06-02T16:04:15.174Z
Updated:                    2024-06-05T17:49:56.452Z

Listado de todos los destinos de una región

Utilice este mandato para generar una lista de los destinos configurados para una región de IBM Cloud Logs Routing.

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

Donde

--output FORMAT

El formato soportado actualmente es JSON. Si se especifica, la salida se devolverá en formato JSON. Si no se ha especificado JSON, la salida se devolverá en un formato tabular.

help | --help | -h

Listar las opciones disponibles para el mandato.

Name                       ID                                     Region     Type                Created
target-01                  xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx   us-south   cloud_logs          2020-11-18T03:52:08.603Z

Destinos y acciones de la API

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

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

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

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

• Puede inhabilitar los puntos finales públicos actualizando los valores de la cuenta. Para obtener más información, consulte Configuración de los valores de destino y región.

Para más información sobre la API REST, consulte IBM Cloud Logs Routing REST API v3.

Requisitos previos de la API

Para realizar llamadas de API para gestionar destinos, complete 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 un destino. Para obtener más información, consulte Puntos finales.

Creación de un objetivo IBM Cloud Logs mediante la API

Puede crear un objetivo para configurar un destino al que dirigir los registros de la plataforma.

• Puede enviar los registros de su plataforma desde todas las regiones a un único objetivo, a distintos objetivos o a varios objetivos.
• Puede definir hasta 16 objetivos por cuenta.
• Puede gestionar objetivos a nivel de empresa configurando el parámetro managed by como empresa. Este valor es inmutable y no puede modificarse una vez creado el objetivo.

Puede utilizar el siguiente comando cURL para crear un destino IBM Cloud Logs:

curl -X POST  <ENDPOINT>/v3/targets   -H "Authorization:  $ACCESS_TOKEN"   -H "content-type: application/json"   -d '{
    "name": "TARGET_NAME",
    "destination_crn": "CLOUD_LOGS_CRN",
    "region": "eu-gb",
    "managed_by": "account"
  }'

Donde

<ENDPOINT>

Endpoint es el endpoint de la API en la región en la que tiene previsto configurar o gestionar un objetivo. Para obtener más información, consulte Puntos finales.

TARGET_NAME

El nombre que debe darse al destino.

El nombre debe tener 1000 caracteres o menos, y no puede incluir ningún carácter especial que no sea (espacio), -, ., _, :.

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

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

CLOUD_LOGS_TARGET_CRN

El CRN de la instancia de IBM Cloud Logs.

La longitud máxima es de 1000 caracteres. La longitud mínima es de 3 caracteres.

REGION

Nombre de la región, por ejemplo, us-south o eu-gb. Si no se especifica, se utilizará la región en la que se ha iniciado sesión o la de destino.

Incluir región si desea crear un objetivo en una región diferente a la que está conectado.

La longitud máxima es de 1000 caracteres. La longitud mínima es de 3 caracteres.

MANAGED-BY

Identifica quién gestiona este objetivo.

Si se establece en enterprise, el objetivo se convierte en gestionado por la empresa y sólo puede ser modificado por identidades autorizadas para las acciones de la empresa.

Si se omite o se establece en account, el objetivo es gestionado por la cuenta secundaria.

Este valor es inmutable después de la creación.

Los valores válidos son: enterprise, account.

Por ejemplo, puede utilizar la siguiente solicitud de cURL para crear un destino en Dallas:

curl -X POST   https://api.us-south.logs-router.cloud.ibm.com/v3/targets   -H "Authorization: $ACCESS_TOKEN"   -H "content-type: application/json"   -d '{
    "name": "a-cloud-logs-target-us-south",
    "destination_crn": "crn:v1:bluemix:public:logs:us-south:a/0be5ad401ae913d8ff665d92680664ed:22222222-2222-2222-2222-222222222222::"
  }'

En la respuesta, obtiene información sobre el destino como, por ejemplo, el id, que indica el GUID del destino y el crn, que indica el CRN del destino.

Actualización de un destino IBM Cloud Logs mediante la API

Cuando actualice un destino IBM Cloud Logs, debe incluir la información del destino en la sección de datos de la solicitud.

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

Puede utilizar el siguiente mandato cURL para actualizar un destino:

curl -X PATCH  <ENDPOINT>/v3/targets/TARGET_ID  -H "Authorization:  $ACCESS_TOKEN"   -H "content-type: application/json"   -d '{
    "name": "TARGET_NAME",
    "destination_crn": "CLOUD_LOGS_CRN"
  }'

Donde

<ENDPOINT>

Endpoint es el endpoint de la API en la región en la que tiene previsto configurar o gestionar un objetivo. Para obtener más información, consulte Puntos finales.

TARGET_ID

El UUID de v4 que identifica de forma exclusiva el objetivo.

TARGET_NAME

El nombre que debe darse al destino.

El nombre debe tener 1000 caracteres o menos, y no puede incluir ningún carácter especial que no sea (espacio), -, ., _, :.

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

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

CLOUD_LOGS_TARGET_CRN

El CRN de la instancia de IBM Cloud Logs.

La longitud máxima es de 1000 caracteres. La longitud mínima es de 3 caracteres.

Por ejemplo, puede utilizar la siguiente solicitud de cURL para actualizar un destino en Dallas:

curl -X PATCH   https://api.us-south.logs-router.cloud.ibm.com/v3/targets/TARGET_ID   -H "Authorization: $ACCESS_TOKEN"   -H "content-type: application/json"   -d '{
    "name": "a-cloud-logs-target-modified",
    "destination_crn": "crn:v1:bluemix:public:logs:us-south:a/0be5ad401ae913d8ff665d92680664ed:33333333-3333-3333-3333-333333333333::"
  }'

Supresión de un destino utilizando la API

Puede utilizar el siguiente mandato de cURL para suprimir un destino:

curl -X DELETE <ENDPOINT>/v3/targets/<TARGET_ID> -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 un destino. Para obtener más información, consulte Puntos finales.
• <TARGET_ID> es el UUID de v4 que identifica de forma única al objetivo.

Por ejemplo, puede utilizar la siguiente solicitud de cURL para suprimir un destino en EE.UU. sur con el ID 00000000-0000-0000-0000-000000000000:

curl -X DELETE https://api.us-south.logs-router.cloud.ibm.com/v3/targets/00000000-0000-0000-0000-000000000000 -H "Authorization: Bearer <IAM_TOKEN> -H "content-type: application/json""

En la respuesta, obtendrá un resultado vacío si la supresión se ha realizado correctamente:

{}

Validación y visualización de los detalles de un objetivo mediante la API

Puede utilizar el siguiente mandato de cURL para ver los detalles de configuración de 1 destino:

curl -X GET <ENDPOINT>/v3/targets/<TARGET_ID> -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 un destino. Para obtener más información, consulte Puntos finales.
• <TARGET_ID> es el UUID de v4 que identifica de forma única al objetivo.

La respuesta incluye información sobre el estado del objetivo en el objeto de respuesta write_status. Este objeto incluye la siguiente información:

• status información. Los valores válidos son: success o failed.
• last_failure información de fecha-hora de la marca de tiempo del último fallo.
• reason_for_last_failure información con una descripción detallada de la causa del fallo.

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

curl -X GET https://api.us-south.logs-router.cloud.ibm.com/v3/targets/00000000-0000-0000-0000-000000000000 -H "Authorization: Bearer <IAM_TOKEN> -H "content-type: application/json""

La respuesta es la siguiente:

{
  "name": "cloud-logs-target",
  "id": "00000000-0000-0000-0000-000000000000",
  "crn": "crn:v1:bluemix:public:logs-router:us-south:a/4329073d16d2f3663f74bfa955259139::target:00000000-0000-0000-0000-000000000000",
  "destination_crn": "crn:v1:bluemix:public:logs:us-south:a/0be5ad401ae913d8ff665d92680664ed:22222222-2222-2222-2222-222222222222::",
  "target_type": "cloud_logs",
  "write_status": {
    "status": "success"
  },
  "created_at": "2026-02-01T19:39:38.174Z",
  "updated_at": "2026-02-01T19:39:38.174Z",
  "managed_by": "enterprise"
}

Listar todos los destinos utilizando la API

Puede utilizar el siguiente mandato cURL para ver todos los destinos:

curl -X GET <ENDPOINT>/v3/targets -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 un destino. Para obtener más información, consulte Puntos finales.

Por ejemplo, puede ejecutar la siguiente solicitud cURL para obtener información sobre los destinos definidos en Dallas:

curl -X GET https://private.us-south.logs-router.cloud.ibm.com/v3/targets -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 normalmente indica un error interno del sistema.

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

Creación de un objetivo IBM Cloud Logs mediante la interfaz de usuario

Sólo aparecen y pueden seleccionarse los recursos de su cuenta. Para especificar un recurso en una cuenta diferente, seleccione Especificar CRN en Elegir destino.

Complete los siguientes pasos para crear un objetivo:

1. Conéctese a su cuenta IBM Cloud.

2. Pulse el icono Menú > Observabilidad.

3. Seleccione Registro > Enrutamiento.

4. En la sección Objetivos, haga clic en Crear para abrir el panel de creación.

5. En Elegir destino, seleccione Buscar por instancia o Especificar CRN.

   Seleccione Buscar por instancia para elegir una instancia de IBM Cloud Logs de la tabla disponible en la cuenta

   Seleccione Especificar CRN para añadir el CRN de instancia IBM Cloud Logs de una instancia que se encuentra en una cuenta diferente.

   Se necesita una autorización de servicio para que IBM Cloud Logs Routing pueda comunicarse con IBM Cloud Logs.

6. En la sección de detalles del objetivo, complete las siguientes tareas:

   Introduzca el nombre del objetivo.

   Habilite la opción No establecido para establecer automáticamente su nuevo objetivo como objetivo predeterminado en la configuración de IBM Cloud Logs Routing.

7. Haga clic en Crear objetivo.

Actualización de un destino IBM Cloud Logs mediante la interfaz de usuario

Sólo aparecen y pueden seleccionarse los recursos de su cuenta. Para especificar un recurso en una cuenta diferente, seleccione Especificar CRN en Elegir destino.

Complete los pasossiguientes:

1. Conéctese a su cuenta IBM Cloud.
2. Pulse el icono Menú > Observabilidad.
3. Seleccione Registro > Enrutamiento.
4. En la sección Objetivos, determine qué objetivo desea actualizar y haga clic en el .
5. Haga clic en Editar para abrir el panel de actualización.
6. En el panel Actualizar, haga clic en Editar para actualizar el nombre del destino, en CRN para cambiar la instancia de IBM Cloud Logs asociada al destino, o en ambos. También puede activar la opción Objetivo predeterminado para añadir o eliminar su objetivo como objetivo predeterminado en la configuración de IBM Cloud Logs Routing.
7. Haz clic en Guardar para actualizar tu objetivo.

Eliminar un objetivo mediante la interfaz de usuario

No se puede eliminar un destino IBM Cloud Logs Routing si se utiliza en una ruta o como configuración de destino por defecto.

1. Conéctese a su cuenta IBM Cloud.
2. Pulse el icono Menú > Observabilidad.
3. Seleccione Registro > Enrutamiento.
4. En la sección Objetivos, determine qué objetivo desea actualizar y haga clic en el .
5. Seleccione Eliminar y, a continuación, haga clic en Eliminar en el panel de confirmación.

Listado de todos los objetivos de una región mediante la interfaz de usuario

1. Conéctese a su cuenta IBM Cloud.
2. Pulse el icono Menú > Observabilidad.
3. Seleccione Registro > Enrutamiento.

Puede ver la lista de objetivos definidos en la cuenta. Se incluye la siguiente información por objetivo:

• Nombre de destino

• Tipo de destino

• Nombre de destino

• Región de destino

• Las rutas definen si el objetivo se utiliza en alguna ruta.

• Estado del objetivo:

  • Configurado: El objetivo funciona como se espera.
  • No se recibe: El objetivo está mal configurado y los eventos no se enrutarán al destino. Actualice los detalles de su objetivo o destino para arreglar la configuración del objetivo o elimínelo si ya no es necesario.