Prérequis pour l'interface de ligne de commande (CLI)

Avant d'utiliser l'interface de ligne de commande pour gérer les cibles, procédez comme suit :

1. Installez l'interface de ligne de commande IBM Cloud.

2. Installez l'interface de ligne de commande IBM Cloud Logs Routing.

3. Connectez-vous à IBM Cloud. Exécutez la commande suivante : ibmcloud login

Création d'une cible IBM Cloud Logs à l'aide du CLI

Cette commande permet de créer une cible 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]

Où

--region REGION | -r REGION

Nom de la région, par exemple, us-south ou eu-gb. Si cette option n'est pas spécifiée, la région à laquelle l'utilisateur est connecté ou qui est ciblée est utilisée.

Incluez ce champ si vous souhaitez créer une cible dans une région différente de celle à laquelle vous êtes connecté.

La longueur maximale est de 1000 caractères. La longueur minimale est de 3 caractères.

--name TARGET_NAME

Nom à attribuer à la cible.

Le nom ne doit pas dépasser 1000 caractères et ne peut inclure aucun caractère spécial autre que (espace), -, ., _, :.

La longueur maximale est de 1000 caractères. La longueur minimale est de 1 caractère.

N'incluez aucune information d'identification personnelle (PII) dans les noms de ressources.

--destination-crn CLOUD_LOGS_TARGET_CRN

Nom de ressource cloud de l'instance IBM Cloud Logs.

La longueur maximale est de 1000 caractères. La longueur minimale est de 3 caractères.

--managed-by MANAGED-BY

Identifie la personne qui gère cette cible.

Si elle est définie sur enterprise, la cible devient gérée par l'entreprise et ne peut être modifiée que par des identités autorisées pour les actions de l'entreprise.

Si elle est omise ou définie à account, la cible est gérée par le compte enfant.

Cette valeur est immuable après la création.

Les valeurs valides sont : enterprise, account.

--output FORMAT

Le format actuellement pris en charge est JSON. Si cette valeur est spécifiée, la sortie est renvoyée au format JSON. Si JSON n'est pas spécifié, la sortie est renvoyée au format tabulaire.

help | --help | -h

Répertorie les options disponibles pour la commande.

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

Mise à jour d'une cible IBM Cloud Logs à l'aide du CLI

Utilisez cette commande pour mettre à jour une cible IBM Cloud Logs pour une région IBM Cloud Logs Routing.

Toute valeur spécifiée différente de la date de création initiale de la cible est mise à jour à la valeur spécifiée dans la commande.

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

où

--id TARGET

L'UUID qui identifie la cible de manière unique.

La longueur maximale est de 1028 caractères. La longueur minimale est de 24 caractères.

--name TARGET_NAME

Nom à attribuer à la cible.

Le nom ne doit pas dépasser 1000 caractères et ne peut inclure aucun caractère spécial autre que (espace), -, ., _, :'.

La longueur maximale est de 1000 caractères. La longueur minimale est de 1 caractère.

N'incluez aucune information d'identification personnelle (PII) dans les noms de ressources.

--destination-crn CLOUD_LOGS_TARGET_CRN

Nom de ressource cloud de l'instance IBM Cloud Logs.

--output FORMAT

Le format actuellement pris en charge est JSON. Si cette valeur est spécifiée, la sortie est renvoyée au format JSON. Si JSON n'est pas spécifié, la sortie est renvoyée au format tabulaire.

help | --help | -h

Répertorie les options disponibles pour la commande.

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

Suppression d'une cible à l'aide de l'interface de ligne de commande

Cette commande permet de supprimer une cible.

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

où

--id TARGET

L'UUID qui identifie la cible de manière unique.

La longueur maximale est de 1028 caractères. La longueur minimale est de 24 caractères.

--force | -f

Supprime la cible sans fournir d'invite supplémentaire à l'utilisateur.

help | --help | -h

Répertorie les options disponibles pour la commande.

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.

Valider et visualiser les détails d'une cible à l'aide de la CLI

Cette commande permet d'obtenir des informations à propos d'une cible pour une région IBM Cloud Logs Routing.

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

Où

--id TARGET

L'UUID qui identifie la cible de manière unique.

La longueur maximale est de 1028 caractères. La longueur minimale est de 24 caractères.

--output FORMAT

Le format actuellement pris en charge est JSON. Si cette valeur est spécifiée, la sortie est renvoyée au format JSON. Si JSON n'est pas spécifié, la sortie est renvoyée au format tabulaire.

help | --help | -h

Répertorie les options disponibles pour la commande.

La réponse comprend des informations sur l'état de la cible dans l'objet de réponse write_status. Cet objet comprend les informations suivantes :

• Write Status Informations. Les valeurs valables sont : success ou failed.
• Last Failure la date et l'heure de la dernière défaillance.
• Reason for last failure avec une description détaillée de la cause de la défaillance.

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

Liste de toutes les cibles d'une région

Cette commande permet de répertorier les cibles configurées pour une région IBM Cloud Logs Routing.

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

Où

--output FORMAT

Le format actuellement pris en charge est JSON. Si cette valeur est spécifiée, la sortie est renvoyée au format JSON. Si JSON n'est pas spécifié, la sortie est renvoyée au format tabulaire.

help | --help | -h

Répertorie les options disponibles pour la commande.

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

Cibles et actions d'API

Le tableau suivant répertorie les actions que vous pouvez exécuter pour gérer les cibles :

Vous pouvez utiliser des noeuds finaux privés et publics pour gérer les cibles. Pour plus d'informations sur la liste des ENDPOINTS disponibles, voir Noeuds finaux.

• Vous pouvez gérer des cibles à partir du réseau privé à l'aide d'un noeud final d'API au format suivant : https://private.REGION.logs-router.cloud.ibm.com

• Vous pouvez gérer des cibles à partir du réseau public à l'aide d'un noeud final d'API au format suivant : https://REGION.logs-router.cloud.ibm.com

• Vous pouvez désactiver les noeuds finaux publics en mettant à jour les paramètres du compte. Pour plus d'informations, voir Configuration des paramètres de la cible et de la région.

Pour plus d'informations sur l'API REST, voir IBM Cloud Logs Routing REST API v3.

Prérequis d'API

Pour effectuer des appels d'API pour gérer des cibles, procédez comme suit :

1. Obtenez un jeton d'accès IAM. Pour plus d'informations, voir Extraction des jetons d'accès IAM.
2. Identifiez le nœud final d'API dans la région dans laquelle vous prévoyez de configurer ou de gérer une cible. Pour plus d'informations, voir Nœuds finaux.

Création d'une cible IBM Cloud Logs à l'aide de l'API

Vous pouvez créer une cible pour configurer une destination où vous pouvez acheminer les journaux de la plate-forme.

• Vous pouvez envoyer les journaux de votre plate-forme de toutes les régions à une seule cible, à plusieurs cibles ou à des cibles multiples.
• Vous pouvez définir jusqu'à 16 cibles par compte.
• Vous pouvez gérer les cibles au niveau de l'entreprise en définissant le paramètre managed by sur entreprise. Cette valeur est immuable et ne peut être modifiée après la création de la cible.

Vous pouvez utiliser la commande suivante cURL pour créer une cible 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"
  }'

Où

<ENDPOINT>

Endpoint est le point de terminaison de l'API dans la région où vous prévoyez de configurer ou de gérer une cible. Pour plus d'informations, voir Nœuds finaux.

TARGET_NAME

Nom à attribuer à la cible.

Le nom ne doit pas dépasser 1000 caractères et ne peut inclure aucun caractère spécial autre que (espace), -, ., _, :.

La longueur maximale est de 1000 caractères. La longueur minimale est de 1 caractère.

N'incluez aucune information d'identification personnelle (PII) dans les noms de ressources.

CLOUD_LOGS_TARGET_CRN

Nom de ressource cloud de l'instance IBM Cloud Logs.

La longueur maximale est de 1000 caractères. La longueur minimale est de 3 caractères.

REGION

Nom de la région, par exemple, us-south ou eu-gb. Si cette option n'est pas spécifiée, la région à laquelle l'utilisateur est connecté ou qui est ciblée est utilisée.

Inclure la région si vous souhaitez créer une cible dans une région différente de celle à laquelle vous êtes connecté.

La longueur maximale est de 1000 caractères. La longueur minimale est de 3 caractères.

MANAGED-BY

Identifie la personne qui gère cette cible.

Si elle est définie sur enterprise, la cible devient gérée par l'entreprise et ne peut être modifiée que par des identités autorisées pour les actions de l'entreprise.

Si elle est omise ou définie à account, la cible est gérée par le compte enfant.

Cette valeur est immuable après la création.

Les valeurs valides sont : enterprise, account.

Par exemple, vous pouvez utiliser la demande cURL suivante pour créer une cible à 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::"
  }'

Dans la réponse, vous obtenez des informations sur la cible, telles que l'id qui indique l'identificateur global unique de la cible et crn qui indique le CRN de la cible.

Mise à jour d'une cible IBM Cloud Logs à l'aide de l'API

Lorsque vous mettez à jour une cible IBM Cloud Logs, vous devez inclure les informations relatives à la cible dans la section des données de la demande.

• Vous devez passer toutes les zones.
• Mettez à jour les zones qui doivent être modifiées.

Vous pouvez utiliser la commande cURL suivante pour mettre à jour une cible :

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"
  }'

Où

<ENDPOINT>

Endpoint est le point de terminaison de l'API dans la région où vous prévoyez de configurer ou de gérer une cible. Pour plus d'informations, voir Nœuds finaux.

TARGET_ID

L'UUID v4 qui identifie la cible de manière unique.

TARGET_NAME

Nom à attribuer à la cible.

Le nom ne doit pas dépasser 1000 caractères et ne peut inclure aucun caractère spécial autre que (espace), -, ., _, :.

La longueur maximale est de 1000 caractères. La longueur minimale est de 1 caractère.

N'incluez aucune information d'identification personnelle (PII) dans les noms de ressources.

CLOUD_LOGS_TARGET_CRN

Nom de ressource cloud de l'instance IBM Cloud Logs.

La longueur maximale est de 1000 caractères. La longueur minimale est de 3 caractères.

Par exemple, vous pouvez utiliser la demande cURL suivante pour mettre à jour une cible à 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::"
  }'

Suppression d'une cible à l'aide de l'API

Vous pouvez utiliser la commande cURL suivante pour supprimer une cible :

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

Où

• <ENDPOINT> est le nœud final de l'interface de programmation de la région où vous prévoyez de configurer ou de gérer une cible. Pour plus d'informations, voir Nœuds finaux.
• <TARGET_ID> est l'UUID v4 qui identifie la cible de manière unique.

Par exemple, vous pouvez utiliser la demande cURL suivante pour supprimer une cible dans Etats-Unis Sud avec l'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""

Dans la réponse, vous obtenez un résultat vide si la suppression a abouti :

{}

Valider et visualiser les détails d'une cible en utilisant l'API

Vous pouvez utiliser la commande cURL suivante pour afficher les informations de configuration d'une cible :

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

Où

• <ENDPOINT> est le nœud final de l'interface de programmation de la région où vous prévoyez de configurer ou de gérer une cible. Pour plus d'informations, voir Nœuds finaux.
• <TARGET_ID> est l'UUID v4 qui identifie la cible de manière unique.

La réponse comprend des informations sur l'état de la cible dans l'objet de réponse write_status. Cet objet comprend les informations suivantes :

• status Informations. Les valeurs valables sont : success ou failed.
• last_failure la date et l'heure de la dernière défaillance.
• reason_for_last_failure avec une description détaillée de la cause de la défaillance.

Par exemple, vous pouvez exécuter la demande cURL suivante pour obtenir des informations sur une cible avec l'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 réponse se présente comme suit :

{
  "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"
}

Liste de toutes les cibles à l'aide de l'API

Vous pouvez utiliser la commande cURL suivante pour afficher toutes les cibles :

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

Où

• <ENDPOINT> est le nœud final de l'interface de programmation de la région où vous prévoyez de configurer ou de gérer une cible. Pour plus d'informations, voir Nœuds finaux.

Par exemple, vous pouvez exécuter la demande cURL suivante pour obtenir des informations sur les cibles définies à Dallas :

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

Codes de réponse HTTP

Lorsque vous utilisez l'API REST IBM Cloud Logs Routing, vous pouvez obtenir des codes de réponse HTTP normaux indiquant si une méthode a abouti.

• Une réponse 200 indique toujours le succès.
• Une réponse 4xx indique un incident.
• Une réponse 5xx indique généralement une erreur système interne.

Voir le tableau suivant pour certains codes de réponse HTTP :

Création d'une cible IBM Cloud Logs à l'aide de l'interface utilisateur

Seules les ressources de votre compte sont listées et sélectionnables. Pour spécifier une ressource dans un compte différent, sélectionnez Spécifier le CRN sous Choisir la destination.

Effectuez les étapes suivantes pour créer une cible :

1. Connectez-vous à votre compte IBM Cloud.

2. Cliquez sur l'icône de Menu > Observabilité.

3. Sélectionnez Logging > Routing.

4. Dans la section Cibles, cliquez sur Créer pour ouvrir le panneau de création.

5. Dans la section Choisir la destination, sélectionnez Rechercher par instance ou Spécifier le CRN.

   Sélectionnez Rechercher par instance pour choisir une instance IBM Cloud Logs dans le tableau disponible dans le compte

   Sélectionnez Spécifier le CR N pour ajouter le CRN de l'instance IBM Cloud Logs d'une instance située dans un compte différent.

   Une autorisation de service est nécessaire pour permettre à IBM Cloud Logs Routing de communiquer avec IBM Cloud Logs.

6. Dans la section Détails de la cible, effectuez les tâches suivantes :

   Saisissez le nom de la cible.

   Activez la bascule de Non défini pour définir automatiquement votre nouvelle cible comme cible par défaut dans vos paramètres IBM Cloud Logs Routing.

7. Cliquez sur Créer une cible.

Mise à jour d'une cible IBM Cloud Logs à l'aide de l'interface utilisateur

Seules les ressources de votre compte sont listées et sélectionnables. Pour spécifier une ressource dans un compte différent, sélectionnez Spécifier le CRN sous Choisir la destination.

Procédez comme suit :

1. Connectez-vous à votre compte IBM Cloud.
2. Cliquez sur l'icône de Menu > Observabilité.
3. Sélectionnez Logging > Routing.
4. Dans la section Cibles, déterminez la cible à mettre à jour et cliquez sur l'
5. Cliquez sur Modifier pour ouvrir le panneau de mise à jour.
6. Dans le panneau Mise à jour, cliquez sur Modifier pour mettre à jour le nom de votre cible, sur CRN pour modifier l'instance IBM Cloud Logs associée à votre cible, ou sur les deux. Vous pouvez également activer l'option Cible par défaut pour ajouter ou supprimer votre cible comme cible par défaut dans les paramètres de IBM Cloud Logs Routing.
7. Cliquez sur Enregistrer pour mettre à jour votre cible.

Suppression d'une cible à l'aide de l'interface utilisateur

Vous ne pouvez pas supprimer une cible IBM Cloud Logs Routing si elle est utilisée dans un itinéraire ou comme paramètre de cible par défaut.

1. Connectez-vous à votre compte IBM Cloud.
2. Cliquez sur l'icône de Menu > Observabilité.
3. Sélectionnez Logging > Routing.
4. Dans la section Cibles, déterminez la cible à mettre à jour et cliquez sur l'
5. Sélectionnez Supprimer, puis cliquez sur Supprimer dans le panneau de confirmation.

Liste de toutes les cibles d'une région à l'aide de l'interface utilisateur

1. Connectez-vous à votre compte IBM Cloud.
2. Cliquez sur l'icône de Menu > Observabilité.
3. Sélectionnez Logging > Routing.

Vous pouvez voir la liste des cibles définies dans le compte. Les informations suivantes sont incluses par objectif :

• Nom de la cible

• Type de cible

• Nom de destination

• Région de destination

• Les itinéraires définissent si la cible est utilisée dans des itinéraires.

• Statut de la cible :

  • Configuré: La cible fonctionne comme prévu.
  • Pas de réception: La cible est mal configurée et les événements ne seront pas acheminés vers la destination. Mettez à jour les détails de la cible ou la destination pour corriger la configuration de la cible ou supprimez la cible si elle n'est plus nécessaire.